@bodhiapp/ts-client 0.1.27 → 0.1.28

package/dist/types-gemini/types.gen.ts

@@ -0,0 +1,4849 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+/**
+ * A response from `CountTextTokens`.
+ *
+ * It returns the model's `token_count` for the `prompt`.
+ */
+export type CountTextTokensResponse = {
+    /**
+     * The number of tokens that the `model` tokenizes the `prompt` into.
+     *
+     * Always non-negative.
+     */
+    tokenCount?: number;
+};
+
+/**
+ * Config for thinking features.
+ */
+export type ThinkingConfig = {
+    /**
+     * Optional. Controls the maximum depth of the model's internal reasoning process before
+     * it produces a response. If not specified, the default is HIGH. Recommended
+     * for Gemini 3 or later models. Use with earlier models results in an error.
+     */
+    thinkingLevel?: 'THINKING_LEVEL_UNSPECIFIED' | 'MINIMAL' | 'LOW' | 'MEDIUM' | 'HIGH';
+    /**
+     * The number of thoughts tokens that the model should generate.
+     */
+    thinkingBudget?: number;
+    /**
+     * Indicates whether to include thoughts in the response.
+     * If true, thoughts are returned only when available.
+     */
+    includeThoughts?: boolean;
+};
+
+/**
+ * Structured representation of a function declaration as defined by the
+ * [OpenAPI 3.03 specification](https://spec.openapis.org/oas/v3.0.3). Included
+ * in this declaration are the function name and parameters. This
+ * FunctionDeclaration is a representation of a block of code that can be used
+ * as a `Tool` by the model and executed by the client.
+ */
+export type FunctionDeclaration = {
+    /**
+     * Optional. Describes the output from this function in JSON Schema format. Reflects the
+     * Open API 3.03 Response Object. The Schema defines the type used for the
+     * response value of the function.
+     */
+    response?: Schema;
+    /**
+     * Optional. Describes the output from this function in JSON Schema format. The value
+     * specified by the schema is the response value of the function.
+     *
+     * This field is mutually exclusive with `response`.
+     */
+    responseJsonSchema?: unknown;
+    /**
+     * Required. A brief description of the function.
+     */
+    description: string;
+    /**
+     * Optional. Describes the parameters to the function in JSON Schema format. The schema
+     * must describe an object where the properties are the parameters to the
+     * function. For example:
+     *
+     * ```
+     * {
+     * "type": "object",
+     * "properties": {
+     * "name": { "type": "string" },
+     * "age": { "type": "integer" }
+     * },
+     * "additionalProperties": false,
+     * "required": ["name", "age"],
+     * "propertyOrdering": ["name", "age"]
+     * }
+     * ```
+     *
+     * This field is mutually exclusive with `parameters`.
+     */
+    parametersJsonSchema?: unknown;
+    /**
+     * Required. The name of the function.
+     * Must be a-z, A-Z, 0-9, or contain underscores, colons, dots, and dashes,
+     * with a maximum length of 128.
+     */
+    name: string;
+    /**
+     * Optional. Describes the parameters to this function. Reflects the Open API 3.03
+     * Parameter Object string Key: the name of the parameter. Parameter names are
+     * case sensitive. Schema Value: the Schema defining the type used for the
+     * parameter.
+     */
+    parameters?: Schema;
+    /**
+     * Optional. Specifies the function Behavior.
+     * Currently only supported by the BidiGenerateContent method.
+     */
+    behavior?: 'UNSPECIFIED' | 'BLOCKING' | 'NON_BLOCKING';
+};
+
+/**
+ * Response for `ImportFile` to import a File API file with a `FileSearchStore`.
+ */
+export type ImportFileResponse = {
+    /**
+     * The name of the `FileSearchStore` containing `Document`s.
+     * Example: `fileSearchStores/my-file-search-store-123`
+     */
+    parent?: string;
+    /**
+     * Immutable. Identifier. The identifier for the `Document` imported.
+     * Example:
+     * `fileSearchStores/my-file-search-store-123/documents/my-awesome-doc-123a456b789c`
+     */
+    documentName?: string;
+};
+
+/**
+ * Veo response.
+ */
+export type PredictLongRunningGeneratedVideoResponse = {
+    /**
+     * The generated samples.
+     */
+    generatedSamples?: Array<Media>;
+    /**
+     * Returns if any videos were filtered due to RAI policies.
+     */
+    raiMediaFilteredCount?: number;
+    /**
+     * Returns rai failure reasons if any.
+     */
+    raiMediaFilteredReasons?: Array<string>;
+};
+
+/**
+ * Counts the number of tokens in the `prompt` sent to a model.
+ *
+ * Models may tokenize text differently, so each model may return a different
+ * `token_count`.
+ */
+export type CountTextTokensRequest = {
+    /**
+     * Required. The free-form input text given to the model as a prompt.
+     */
+    prompt: TextPrompt;
+};
+
+/**
+ * A `FileSearchStore` is a collection of `Document`s.
+ */
+export type FileSearchStore = {
+    /**
+     * Output only. The Timestamp of when the `FileSearchStore` was created.
+     */
+    readonly createTime?: string;
+    /**
+     * Output only. The number of documents in the `FileSearchStore` that have failed
+     * processing.
+     */
+    readonly failedDocumentsCount?: string;
+    /**
+     * Output only. The number of documents in the `FileSearchStore` that are being processed.
+     */
+    readonly pendingDocumentsCount?: string;
+    /**
+     * Output only. Immutable. Identifier. The `FileSearchStore` resource name. It is an ID (name excluding the
+     * "fileSearchStores/" prefix) that can contain up to 40 characters that are
+     * lowercase alphanumeric or dashes
+     * (-). It is output only. The unique name will be derived from
+     * `display_name` along with a 12 character random suffix. Example:
+     * `fileSearchStores/my-awesome-file-search-store-123a456b789c`
+     * If `display_name` is not provided, the name will be randomly generated.
+     */
+    readonly name?: string;
+    /**
+     * Optional. The human-readable display name for the `FileSearchStore`. The display name
+     * must be no more than 512 characters in length, including spaces. Example:
+     * "Docs on Semantic Retriever"
+     */
+    displayName?: string;
+    /**
+     * Output only. The number of documents in the `FileSearchStore` that are active and ready
+     * for retrieval.
+     */
+    readonly activeDocumentsCount?: string;
+    /**
+     * Output only. The Timestamp of when the `FileSearchStore` was last updated.
+     */
+    readonly updateTime?: string;
+    /**
+     * Output only. The size of raw bytes ingested into the `FileSearchStore`. This is the
+     * total size of all the documents in the `FileSearchStore`.
+     */
+    readonly sizeBytes?: string;
+};
+
+/**
+ * Record for a single tuning step.
+ */
+export type TuningSnapshot = {
+    /**
+     * Output only. The timestamp when this metric was computed.
+     */
+    readonly computeTime?: string;
+    /**
+     * Output only. The epoch this step was part of.
+     */
+    readonly epoch?: number;
+    /**
+     * Output only. The mean loss of the training examples for this step.
+     */
+    readonly meanLoss?: number;
+    /**
+     * Output only. The tuning step.
+     */
+    readonly step?: number;
+};
+
+/**
+ * The request to be processed in the batch.
+ */
+export type InlinedEmbedContentRequest = {
+    /**
+     * Required. The request to be processed in the batch.
+     */
+    request: EmbedContentRequest;
+    /**
+     * Optional. The metadata to be associated with the request.
+     */
+    metadata?: {};
+};
+
+/**
+ * An input/output example used to instruct the Model.
+ *
+ * It demonstrates how the model should respond or format its response.
+ */
+export type Example = {
+    /**
+     * Required. An example of an input `Message` from the user.
+     */
+    input: Message;
+    /**
+     * Required. An example of what the model should output given the input.
+     */
+    output: Message;
+};
+
+/**
+ * Request message for PredictionService.Predict.
+ */
+export type PredictRequest = {
+    /**
+     * Required. The instances that are the input to the prediction call.
+     */
+    instances: Array<unknown>;
+    /**
+     * Optional. The parameters that govern the prediction call.
+     */
+    parameters?: unknown;
+};
+
+/**
+ * Raw media bytes.
+ *
+ * Text should not be sent as raw bytes, use the 'text' field.
+ */
+export type Blob = {
+    /**
+     * The IANA standard MIME type of the source data.
+     * Examples:
+     * - image/png
+     * - image/jpeg
+     * If an unsupported MIME type is provided, an error will be returned. For a
+     * complete list of supported types, see [Supported file
+     * formats](https://ai.google.dev/gemini-api/docs/prompting_with_media#supported_file_formats).
+     */
+    mimeType?: string;
+    /**
+     * Raw bytes for media formats.
+     */
+    data?: string;
+};
+
+export type GenerativeLanguageModality = 'MODALITY_UNSPECIFIED' | 'TEXT' | 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT';
+
+/**
+ * Metadata on the generation request's token usage.
+ */
+export type UsageMetadata = {
+    /**
+     * Total token count for the generation request (prompt + response
+     * candidates).
+     */
+    totalTokenCount?: number;
+    /**
+     * Output only. Number of tokens present in tool-use prompt(s).
+     */
+    readonly toolUsePromptTokenCount?: number;
+    /**
+     * Output only. List of modalities of the cached content in the request input.
+     */
+    readonly cacheTokensDetails?: Array<ModalityTokenCount>;
+    /**
+     * Number of tokens in the prompt. When `cached_content` is set, this is
+     * still the total effective prompt size meaning this includes the number of
+     * tokens in the cached content.
+     */
+    promptTokenCount?: number;
+    /**
+     * Output only. List of modalities that were returned in the response.
+     */
+    readonly candidatesTokensDetails?: Array<ModalityTokenCount>;
+    /**
+     * Output only. List of modalities that were processed for tool-use request inputs.
+     */
+    readonly toolUsePromptTokensDetails?: Array<ModalityTokenCount>;
+    /**
+     * Number of tokens in the cached part of the prompt (the cached content)
+     */
+    cachedContentTokenCount?: number;
+    /**
+     * Output only. Number of tokens of thoughts for thinking models.
+     */
+    readonly thoughtsTokenCount?: number;
+    /**
+     * Output only. List of modalities that were processed in the request input.
+     */
+    readonly promptTokensDetails?: Array<ModalityTokenCount>;
+    /**
+     * Total number of tokens across all the generated response candidates.
+     */
+    candidatesTokenCount?: number;
+};
+
+/**
+ * Response from the model for a grounded answer.
+ */
+export type GenerateAnswerResponse = {
+    /**
+     * Candidate answer from the model.
+     *
+     * Note: The model *always* attempts to provide a grounded answer, even when
+     * the answer is unlikely to be answerable from the given passages.
+     * In that case, a low-quality or ungrounded answer may be provided, along
+     * with a low `answerable_probability`.
+     */
+    answer?: Candidate;
+    /**
+     * Output only. The model's estimate of the probability that its answer is correct and
+     * grounded in the input passages.
+     *
+     * A low `answerable_probability` indicates that the answer might not be
+     * grounded in the sources.
+     *
+     * When `answerable_probability` is low, you may want to:
+     *
+     * * Display a message to the effect of "We couldn’t answer that question" to
+     * the user.
+     * * Fall back to a general-purpose LLM that answers the question from world
+     * knowledge. The threshold and nature of such fallbacks will depend on
+     * individual use cases. `0.5` is a good starting threshold.
+     */
+    readonly answerableProbability?: number;
+    /**
+     * Output only. Feedback related to the input data used to answer the question, as opposed
+     * to the model-generated response to the question.
+     *
+     * The input data can be one or more of the following:
+     *
+     * - Question specified by the last entry in `GenerateAnswerRequest.content`
+     * - Conversation history specified by the other entries in
+     * `GenerateAnswerRequest.content`
+     * - Grounding sources (`GenerateAnswerRequest.semantic_retriever` or
+     * `GenerateAnswerRequest.inline_passages`)
+     */
+    inputFeedback?: InputFeedback;
+};
+
+/**
+ * Stats about the batch.
+ */
+export type EmbedContentBatchStats = {
+    /**
+     * Output only. The number of requests in the batch.
+     */
+    readonly requestCount?: string;
+    /**
+     * Output only. The number of requests that were successfully processed.
+     */
+    readonly successfulRequestCount?: string;
+    /**
+     * Output only. The number of requests that are still pending processing.
+     */
+    readonly pendingRequestCount?: string;
+    /**
+     * Output only. The number of requests that failed to be processed.
+     */
+    readonly failedRequestCount?: string;
+};
+
+/**
+ * A fine-tuned model created using ModelService.CreateTunedModel.
+ */
+export type TunedModel = {
+    /**
+     * Optional. A short description of this model.
+     */
+    description?: string;
+    /**
+     * Optional. Controls the randomness of the output.
+     *
+     * Values can range over `[0.0,1.0]`, inclusive. A value closer to `1.0` will
+     * produce responses that are more varied, while a value closer to `0.0` will
+     * typically result in less surprising responses from the model.
+     *
+     * This value specifies default to be the one used by the base model while
+     * creating the model.
+     */
+    temperature?: number;
+    /**
+     * Optional. The name to display for this model in user interfaces.
+     * The display name must be up to 40 characters including spaces.
+     */
+    displayName?: string;
+    /**
+     * Optional. List of project numbers that have read access to the tuned model.
+     */
+    readerProjectNumbers?: Array<string>;
+    /**
+     * Output only. The timestamp when this model was created.
+     */
+    readonly createTime?: string;
+    /**
+     * Optional. For Nucleus sampling.
+     *
+     * Nucleus sampling considers the smallest set of tokens whose probability
+     * sum is at least `top_p`.
+     *
+     * This value specifies default to be the one used by the base model while
+     * creating the model.
+     */
+    topP?: number;
+    /**
+     * Required. The tuning task that creates the tuned model.
+     */
+    tuningTask: TuningTask;
+    /**
+     * Output only. The timestamp when this model was updated.
+     */
+    readonly updateTime?: string;
+    /**
+     * Output only. The tuned model name. A unique name will be generated on create.
+     * Example: `tunedModels/az2mb0bpw6i`
+     * If display_name is set on create, the id portion of the name will be set
+     * by concatenating the words of the display_name with hyphens and adding a
+     * random portion for uniqueness.
+     *
+     * Example:
+     *
+     * * display_name = `Sentence Translator`
+     * * name = `tunedModels/sentence-translator-u3b7m`
+     */
+    readonly name?: string;
+    /**
+     * Output only. The state of the tuned model.
+     */
+    state?: 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'FAILED';
+    /**
+     * Immutable. The name of the `Model` to tune.
+     * Example: `models/gemini-1.5-flash-001`
+     */
+    baseModel?: string;
+    /**
+     * Optional. For Top-k sampling.
+     *
+     * Top-k sampling considers the set of `top_k` most probable tokens.
+     * This value specifies default to be used by the backend while making the
+     * call to the model.
+     *
+     * This value specifies default to be the one used by the base model while
+     * creating the model.
+     */
+    topK?: number;
+    /**
+     * Optional. TunedModel to use as the starting point for training the new model.
+     */
+    tunedModelSource?: TunedModelSource;
+};
+
+/**
+ * Tuning tasks that create tuned models.
+ */
+export type TuningTask = {
+    /**
+     * Output only. The timestamp when tuning this model started.
+     */
+    readonly startTime?: string;
+    /**
+     * Output only. The timestamp when tuning this model completed.
+     */
+    readonly completeTime?: string;
+    /**
+     * Required. Input only. Immutable. The model training data.
+     */
+    trainingData: Dataset;
+    /**
+     * Output only. Metrics collected during tuning.
+     */
+    readonly snapshots?: Array<TuningSnapshot>;
+    /**
+     * Immutable. Hyperparameters controlling the tuning process. If not provided, default
+     * values will be used.
+     */
+    hyperparameters?: Hyperparameters;
+};
+
+/**
+ * A response from `CountMessageTokens`.
+ *
+ * It returns the model's `token_count` for the `prompt`.
+ */
+export type CountMessageTokensResponse = {
+    /**
+     * The number of tokens that the `model` tokenizes the `prompt` into.
+     *
+     * Always non-negative.
+     */
+    tokenCount?: number;
+};
+
+/**
+ * The status of the underlying model. This is used to indicate the stage of the
+ * underlying model and the retirement time if applicable.
+ */
+export type ModelStatus = {
+    /**
+     * The time at which the model will be retired.
+     */
+    retirementTime?: string;
+    /**
+     * The stage of the underlying model.
+     */
+    modelStage?: ModelStage;
+    /**
+     * A message explaining the model status.
+     */
+    message?: string;
+};
+
+/**
+ * Response for `DownloadFile`.
+ */
+export type DownloadFileResponse = {
+    [key: string]: unknown;
+};
+
+/**
+ * Metadata about the state and progress of creating a tuned model returned from
+ * the long-running operation
+ */
+export type CreateTunedModelMetadata = {
+    /**
+     * The total number of tuning steps.
+     */
+    totalSteps?: number;
+    /**
+     * The number of steps completed.
+     */
+    completedSteps?: number;
+    /**
+     * The completed percentage for the tuning operation.
+     */
+    completedPercent?: number;
+    /**
+     * Metrics collected during tuning.
+     */
+    snapshots?: Array<TuningSnapshot>;
+    /**
+     * Name of the tuned model associated with the tuning operation.
+     */
+    tunedModel?: string;
+};
+
+/**
+ * Metadata for LongRunning UploadToFileSearchStore Operations.
+ */
+export type UploadToFileSearchStoreMetadata = {
+    [key: string]: unknown;
+};
+
+/**
+ * A predicted `FunctionCall` returned from the model that contains
+ * a string representing the `FunctionDeclaration.name` with the
+ * arguments and their values.
+ */
+export type FunctionCall = {
+    /**
+     * Optional. The function parameters and values in JSON object format.
+     */
+    args?: {};
+    /**
+     * Optional. Unique identifier of the function call. If populated, the client to
+     * execute the `function_call` and return the response with the matching `id`.
+     */
+    id?: string;
+    /**
+     * Required. The name of the function to call.
+     * Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum
+     * length of 128.
+     */
+    name: string;
+};
+
+/**
+ * This resource represents a long-running operation where metadata and response fields are strongly typed.
+ */
+export type PredictLongRunningOperation = BaseOperation & {
+    metadata?: PredictLongRunningMetadata;
+    response?: PredictLongRunningResponse;
+};
+
+/**
+ * Chunk from context retrieved by the file search tool.
+ */
+export type RetrievedContext = {
+    /**
+     * Optional. Title of the document.
+     */
+    title?: string;
+    /**
+     * Optional. Name of the `FileSearchStore` containing the document.
+     * Example: `fileSearchStores/123`
+     */
+    fileSearchStore?: string;
+    /**
+     * Optional. URI reference of the semantic retrieval document.
+     */
+    uri?: string;
+    /**
+     * Optional. Text of the chunk.
+     */
+    text?: string;
+    /**
+     * Optional. User-provided metadata about the retrieved context.
+     */
+    customMetadata?: Array<GroundingChunkCustomMetadata>;
+};
+
+/**
+ * Candidates with top log probabilities at each decoding step.
+ */
+export type TopCandidates = {
+    /**
+     * Sorted by log probability in descending order.
+     */
+    candidates?: Array<LogprobsResultCandidate>;
+};
+
+/**
+ * Identifier for the source contributing to this attribution.
+ */
+export type AttributionSourceId = {
+    /**
+     * Identifier for an inline passage.
+     */
+    groundingPassage?: GroundingPassageId;
+    /**
+     * Identifier for a `Chunk` fetched via Semantic Retriever.
+     */
+    semanticRetrieverChunk?: SemanticRetrieverChunk;
+};
+
+/**
+ * Response from `TransferOwnership`.
+ */
+export type TransferOwnershipResponse = {
+    [key: string]: unknown;
+};
+
+/**
+ * A resource representing a batch of `EmbedContent` requests.
+ */
+export type EmbedContentBatch = {
+    /**
+     * Required. The name of the `Model` to use for generating the completion.
+     *
+     * Format: `models/{model}`.
+     */
+    model: string;
+    /**
+     * Required. The user-defined name of this batch.
+     */
+    displayName: string;
+    /**
+     * Output only. Identifier. Resource name of the batch.
+     *
+     * Format: `batches/{batch_id}`.
+     */
+    readonly name?: string;
+    /**
+     * Output only. The output of the batch request.
+     */
+    output?: EmbedContentBatchOutput;
+    /**
+     * Output only. The time at which the batch was last updated.
+     */
+    readonly updateTime?: string;
+    /**
+     * Output only. Stats about the batch.
+     */
+    batchStats?: EmbedContentBatchStats;
+    /**
+     * Output only. The time at which the batch was created.
+     */
+    readonly createTime?: string;
+    /**
+     * Output only. The time at which the batch processing completed.
+     */
+    readonly endTime?: string;
+    /**
+     * Output only. The state of the batch.
+     */
+    state?: BatchState;
+    /**
+     * Optional. The priority of the batch. Batches with a higher priority value will be
+     * processed before batches with a lower priority value. Negative values are
+     * allowed. Default is 0.
+     */
+    priority?: string;
+    /**
+     * Required. Input configuration of the instances on which batch processing
+     * are performed.
+     */
+    inputConfig: InputEmbedContentConfig;
+};
+
+/**
+ * Text given to the model as a prompt.
+ *
+ * The Model will use this TextPrompt to Generate a text completion.
+ */
+export type TextPrompt = {
+    /**
+     * Required. The prompt text.
+     */
+    text: string;
+};
+
+/**
+ * The output from a server-side `ToolCall` execution. This message contains
+ * the results of a tool invocation that was initiated by a `ToolCall`
+ * from the model. The client should pass this `ToolResponse` back to the API
+ * in a subsequent turn within a `Content` message, along with the corresponding
+ * `ToolCall`.
+ */
+export type ToolResponse = {
+    /**
+     * Optional. The identifier of the tool call this response is for.
+     */
+    id?: string;
+    /**
+     * Required. The type of tool that was called, matching the `tool_type` in the
+     * corresponding `ToolCall`.
+     */
+    toolType: ToolType;
+    /**
+     * Optional. The tool response.
+     */
+    response?: {};
+};
+
+/**
+ * Configuration for retrieving grounding content from a `Corpus` or
+ * `Document` created using the Semantic Retriever API.
+ */
+export type SemanticRetrieverConfig = {
+    /**
+     * Optional. Filters for selecting `Document`s and/or `Chunk`s from the resource.
+     */
+    metadataFilters?: Array<MetadataFilter>;
+    /**
+     * Required. Query to use for matching `Chunk`s in the given resource by similarity.
+     */
+    query: Content;
+    /**
+     * Required. Name of the resource for retrieval. Example: `corpora/123` or
+     * `corpora/123/documents/abc`.
+     */
+    source: string;
+    /**
+     * Optional. Maximum number of relevant `Chunk`s to retrieve.
+     */
+    maxChunksCount?: number;
+    /**
+     * Optional. Minimum relevance score for retrieved relevant `Chunk`s.
+     */
+    minimumRelevanceScore?: number;
+};
+
+/**
+ * Response for `RegisterFiles`.
+ */
+export type RegisterFilesResponse = {
+    /**
+     * The registered files to be used when calling GenerateContent.
+     */
+    files?: Array<File>;
+};
+
+/**
+ * Logprobs Result
+ */
+export type LogprobsResult = {
+    /**
+     * Length = total number of decoding steps.
+     */
+    topCandidates?: Array<TopCandidates>;
+    /**
+     * Length = total number of decoding steps.
+     * The chosen candidates may or may not be in top_candidates.
+     */
+    chosenCandidates?: Array<LogprobsResultCandidate>;
+    /**
+     * Sum of log probabilities for all tokens.
+     */
+    logProbabilitySum?: number;
+};
+
+/**
+ * Configures the input to the batch request.
+ */
+export type InputEmbedContentConfig = {
+    /**
+     * The requests to be processed in the batch.
+     */
+    requests?: InlinedEmbedContentRequests;
+    /**
+     * The name of the `File` containing the input requests.
+     */
+    fileName?: string;
+};
+
+/**
+ * The configuration for a single speaker in a multi speaker setup.
+ */
+export type SpeakerVoiceConfig = {
+    /**
+     * Required. The name of the speaker to use. Should be the same as in the prompt.
+     */
+    speaker: string;
+    /**
+     * Required. The configuration for the voice to use.
+     */
+    voiceConfig: VoiceConfig;
+};
+
+/**
+ * The response to an `EmbedContentRequest`.
+ */
+export type EmbedContentResponse = {
+    /**
+     * Output only. The embedding generated from the input content.
+     */
+    embedding?: ContentEmbedding;
+    /**
+     * Output only. The usage metadata for the request.
+     */
+    usageMetadata?: EmbeddingUsageMetadata;
+};
+
+/**
+ * A datatype containing media that is part of a multi-part `Content` message.
+ *
+ * A `Part` consists of data which has an associated datatype. A `Part` can only
+ * contain one of the accepted types in `Part.data`.
+ *
+ * A `Part` must have a fixed IANA MIME type identifying the type and subtype
+ * of the media if the `inline_data` field is filled with raw bytes.
+ */
+export type Part = {
+    /**
+     * Optional. An opaque signature for the thought so it can be reused in subsequent
+     * requests.
+     */
+    thoughtSignature?: string;
+    /**
+     * Inline text.
+     */
+    text?: string;
+    /**
+     * Optional. Video metadata. The metadata should only be specified while the video
+     * data is presented in inline_data or file_data.
+     */
+    videoMetadata?: VideoMetadata;
+    /**
+     * Optional. Indicates if the part is thought from the model.
+     */
+    thought?: boolean;
+    /**
+     * A predicted `FunctionCall` returned from the model that contains
+     * a string representing the `FunctionDeclaration.name` with the
+     * arguments and their values.
+     */
+    functionCall?: FunctionCall;
+    /**
+     * URI based data.
+     */
+    fileData?: FileData;
+    /**
+     * The result output of a `FunctionCall` that contains a string
+     * representing the `FunctionDeclaration.name` and a structured JSON
+     * object containing any output from the function is used as context to
+     * the model.
+     */
+    functionResponse?: FunctionResponse;
+    /**
+     * Result of executing the `ExecutableCode`.
+     */
+    codeExecutionResult?: CodeExecutionResult;
+    /**
+     * Code generated by the model that is meant to be executed.
+     */
+    executableCode?: ExecutableCode;
+    /**
+     * Custom metadata associated with the Part.
+     * Agents using genai.Part as content representation may need to keep track
+     * of the additional information. For example it can be name of a file/source
+     * from which the Part originates or a way to multiplex multiple Part streams.
+     */
+    partMetadata?: {};
+    /**
+     * Optional. Media resolution for the input media.
+     */
+    mediaResolution?: MediaResolution;
+    /**
+     * Server-side tool call. This field is populated when the model
+     * predicts a tool invocation that should be executed on the server.
+     * The client is expected to echo this message back to the API.
+     */
+    toolCall?: ToolCall;
+    /**
+     * The output from a server-side `ToolCall` execution. This field is
+     * populated by the client with the results of executing the
+     * corresponding `ToolCall`.
+     */
+    toolResponse?: ToolResponse;
+    /**
+     * Inline media bytes.
+     */
+    inlineData?: Blob;
+};
+
+/**
+ * Response message for [PredictionService.PredictLongRunning]
+ */
+export type PredictLongRunningResponse = {
+    /**
+     * The response of the video generation prediction.
+     */
+    generateVideoResponse?: PredictLongRunningGeneratedVideoResponse;
+};
+
+/**
+ * A response candidate generated from the model.
+ */
+export type Candidate = {
+    /**
+     * Optional. Output only. Details the reason why the model stopped generating tokens.
+     * This is populated only when `finish_reason` is set.
+     */
+    readonly finishMessage?: string;
+    /**
+     * Output only. Generated content returned from the model.
+     */
+    content?: Content;
+    /**
+     * Output only. Index of the candidate in the list of response candidates.
+     */
+    readonly index?: number;
+    /**
+     * Optional. Output only. The reason why the model stopped generating tokens.
+     *
+     * If empty, the model has not stopped generating tokens.
+     */
+    finishReason?: 'FINISH_REASON_UNSPECIFIED' | 'STOP' | 'MAX_TOKENS' | 'SAFETY' | 'RECITATION' | 'LANGUAGE' | 'OTHER' | 'BLOCKLIST' | 'PROHIBITED_CONTENT' | 'SPII' | 'MALFORMED_FUNCTION_CALL' | 'IMAGE_SAFETY' | 'IMAGE_PROHIBITED_CONTENT' | 'IMAGE_OTHER' | 'NO_IMAGE' | 'IMAGE_RECITATION' | 'UNEXPECTED_TOOL_CALL' | 'TOO_MANY_TOOL_CALLS' | 'MISSING_THOUGHT_SIGNATURE' | 'MALFORMED_RESPONSE';
+    /**
+     * List of ratings for the safety of a response candidate.
+     *
+     * There is at most one rating per category.
+     */
+    safetyRatings?: Array<SafetyRating>;
+    /**
+     * Output only. Attribution information for sources that contributed to a grounded answer.
+     *
+     * This field is populated for `GenerateAnswer` calls.
+     */
+    readonly groundingAttributions?: Array<GroundingAttribution>;
+    /**
+     * Output only. Citation information for model-generated candidate.
+     *
+     * This field may be populated with recitation information for any text
+     * included in the `content`. These are passages that are "recited" from
+     * copyrighted material in the foundational LLM's training data.
+     */
+    citationMetadata?: CitationMetadata;
+    /**
+     * Output only. Grounding metadata for the candidate.
+     *
+     * This field is populated for `GenerateContent` calls.
+     */
+    groundingMetadata?: GroundingMetadata;
+    /**
+     * Output only. Average log probability score of the candidate.
+     */
+    readonly avgLogprobs?: number;
+    /**
+     * Output only. Metadata related to url context retrieval tool.
+     */
+    urlContextMetadata?: UrlContextMetadata;
+    /**
+     * Output only. Log-likelihood scores for the response tokens and top tokens
+     */
+    logprobsResult?: LogprobsResult;
+    /**
+     * Output only. Token count for this candidate.
+     */
+    readonly tokenCount?: number;
+};
+
+/**
+ * A datatype containing media that is part of a `FunctionResponse` message.
+ *
+ * A `FunctionResponsePart` consists of data which has an associated datatype. A
+ * `FunctionResponsePart` can only contain one of the accepted types in
+ * `FunctionResponsePart.data`.
+ *
+ * A `FunctionResponsePart` must have a fixed IANA MIME type identifying the
+ * type and subtype of the media if the `inline_data` field is filled with raw
+ * bytes.
+ */
+export type FunctionResponsePart = {
+    /**
+     * Inline media bytes.
+     */
+    inlineData?: FunctionResponseBlob;
+};
+
+/**
+ * Content that has been preprocessed and can be used in subsequent request
+ * to GenerativeService.
+ *
+ * Cached content can be only used with model it was created for.
+ */
+export type CachedContent = {
+    /**
+     * Optional. Input only. Immutable. Developer set system instruction. Currently text only.
+     */
+    systemInstruction?: Content;
+    /**
+     * Output only. Metadata on the usage of the cached content.
+     */
+    usageMetadata?: CachedContentUsageMetadata;
+    /**
+     * Output only. Creation time of the cache entry.
+     */
+    readonly createTime?: string;
+    /**
+     * Timestamp in UTC of when this resource is considered expired.
+     * This is *always* provided on output, regardless of what was sent
+     * on input.
+     */
+    expireTime?: string;
+    /**
+     * Optional. Input only. Immutable. The content to cache.
+     */
+    contents?: Array<Content>;
+    /**
+     * Output only. When the cache entry was last updated in UTC time.
+     */
+    readonly updateTime?: string;
+    /**
+     * Input only. New TTL for this resource, input only.
+     */
+    ttl?: string;
+    /**
+     * Optional. Input only. Immutable. A list of `Tools` the model may use to generate the next response
+     */
+    tools?: Array<Tool>;
+    /**
+     * Output only. Identifier. The resource name referring to the cached content.
+     * Format: `cachedContents/{id}`
+     */
+    readonly name?: string;
+    /**
+     * Optional. Immutable. The user-generated meaningful display name of the cached content. Maximum
+     * 128 Unicode characters.
+     */
+    displayName?: string;
+    /**
+     * Required. Immutable. The name of the `Model` to use for cached content
+     * Format: `models/{model}`
+     */
+    model: string;
+    /**
+     * Optional. Input only. Immutable. Tool config. This config is shared for all tools.
+     */
+    toolConfig?: ToolConfig;
+};
+
+/**
+ * Identifier for a part within a `GroundingPassage`.
+ */
+export type GroundingPassageId = {
+    /**
+     * Output only. ID of the passage matching the `GenerateAnswerRequest`'s
+     * `GroundingPassage.id`.
+     */
+    readonly passageId?: string;
+    /**
+     * Output only. Index of the part within the `GenerateAnswerRequest`'s
+     * `GroundingPassage.content`.
+     */
+    readonly partIndex?: number;
+};
+
+/**
+ * Different types of search that can be enabled on the GoogleSearch tool.
+ */
+export type SearchTypes = {
+    /**
+     * Optional. Enables web search. Only text results are returned.
+     */
+    webSearch?: WebSearch;
+    /**
+     * Optional. Enables image search. Image bytes are returned.
+     */
+    imageSearch?: ImageSearch;
+};
+
+/**
+ * A proto encapsulate various type of media.
+ */
+export type Media = {
+    /**
+     * Video as the only one for now.  This is mimicking Vertex proto.
+     */
+    video?: Video;
+};
+
+/**
+ * Request to generate a completion from the model.
+ */
+export type GenerateContentRequest = {
+    /**
+     * Required. The name of the `Model` to use for generating the completion.
+     *
+     * Format: `models/{model}`.
+     */
+    model: string;
+    /**
+     * Optional. Tool configuration for any `Tool` specified in the request. Refer to the
+     * [Function calling
+     * guide](https://ai.google.dev/gemini-api/docs/function-calling#function_calling_mode)
+     * for a usage example.
+     */
+    toolConfig?: ToolConfig;
+    /**
+     * Optional. Configuration options for model generation and outputs.
+     */
+    generationConfig?: GenerationConfig;
+    /**
+     * Optional. A list of `Tools` the `Model` may use to generate the next response.
+     *
+     * A `Tool` is a piece of code that enables the system to interact with
+     * external systems to perform an action, or set of actions, outside of
+     * knowledge and scope of the `Model`. Supported `Tool`s are `Function` and
+     * `code_execution`. Refer to the [Function
+     * calling](https://ai.google.dev/gemini-api/docs/function-calling) and the
+     * [Code execution](https://ai.google.dev/gemini-api/docs/code-execution)
+     * guides to learn more.
+     */
+    tools?: Array<Tool>;
+    /**
+     * Required. The content of the current conversation with the model.
+     *
+     * For single-turn queries, this is a single instance. For multi-turn queries
+     * like [chat](https://ai.google.dev/gemini-api/docs/text-generation#chat),
+     * this is a repeated field that contains the conversation history and the
+     * latest request.
+     */
+    contents: Array<Content>;
+    /**
+     * Optional. The name of the content
+     * [cached](https://ai.google.dev/gemini-api/docs/caching) to use as context
+     * to serve the prediction. Format: `cachedContents/{cachedContent}`
+     */
+    cachedContent?: string;
+    /**
+     * Optional. A list of unique `SafetySetting` instances for blocking unsafe content.
+     *
+     * This will be enforced on the `GenerateContentRequest.contents` and
+     * `GenerateContentResponse.candidates`. There should not be more than one
+     * setting for each `SafetyCategory` type. The API will block any contents and
+     * responses that fail to meet the thresholds set by these settings. This list
+     * overrides the default settings for each `SafetyCategory` specified in the
+     * safety_settings. If there is no `SafetySetting` for a given
+     * `SafetyCategory` provided in the list, the API will use the default safety
+     * setting for that category. Harm categories HARM_CATEGORY_HATE_SPEECH,
+     * HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT,
+     * HARM_CATEGORY_HARASSMENT, HARM_CATEGORY_CIVIC_INTEGRITY are supported.
+     * Refer to the [guide](https://ai.google.dev/gemini-api/docs/safety-settings)
+     * for detailed information on available safety settings. Also refer to the
+     * [Safety guidance](https://ai.google.dev/gemini-api/docs/safety-guidance) to
+     * learn how to incorporate safety considerations in your AI applications.
+     */
+    safetySettings?: Array<SafetySetting>;
+    /**
+     * Optional. The service tier of the request.
+     */
+    serviceTier?: ServiceTier;
+    /**
+     * Optional. Developer set [system
+     * instruction(s)](https://ai.google.dev/gemini-api/docs/system-instructions).
+     * Currently, text only.
+     */
+    systemInstruction?: Content;
+    /**
+     * Optional. Configures the logging behavior for a given request. If set, it takes
+     * precedence over the project-level logging config.
+     */
+    store?: boolean;
+};
+
+/**
+ * Counts the number of tokens in the `prompt` sent to a model.
+ *
+ * Models may tokenize text differently, so each model may return a different
+ * `token_count`.
+ */
+export type CountMessageTokensRequest = {
+    /**
+     * Required. The prompt, whose token count is to be returned.
+     */
+    prompt: MessagePrompt;
+};
+
+export type ServiceTier = 'unspecified' | 'standard' | 'flex' | 'priority';
+
+/**
+ * This resource represents a long-running operation that is the result of a
+ * network API call.
+ */
+export type BaseOperation = {
+    /**
+     * If the value is `false`, it means the operation is still in progress.
+     * If `true`, the operation is completed, and either `error` or `response` is
+     * available.
+     */
+    done?: boolean;
+    /**
+     * The error result of the operation in case of failure or cancellation.
+     */
+    error?: Status;
+    /**
+     * The server-assigned name, which is only unique within the same service that
+     * originally returns it. If you use the default HTTP mapping, the
+     * `name` should be a resource name ending with `operations/{unique_id}`.
+     */
+    name?: string;
+};
+
+/**
+ * Collection of sources that provide answers about the features of a given
+ * place in Google Maps. Each PlaceAnswerSources message corresponds to a
+ * specific place in Google Maps. The Google Maps tool used these sources in
+ * order to answer questions about features of the place (e.g: "does Bar Foo
+ * have Wifi" or "is Foo Bar wheelchair accessible?"). Currently we only
+ * support review snippets as sources.
+ */
+export type PlaceAnswerSources = {
+    /**
+     * Snippets of reviews that are used to generate answers about the
+     * features of a given place in Google Maps.
+     */
+    reviewSnippets?: Array<ReviewSnippet>;
+};
+
+/**
+ * Metadata related to retrieval in the grounding flow.
+ */
+export type RetrievalMetadata = {
+    /**
+     * Optional. Score indicating how likely information from google search could help
+     * answer the prompt. The score is in the range [0, 1], where 0 is the least
+     * likely and 1 is the most likely. This score is only populated when
+     * google search grounding and dynamic retrieval is enabled. It will be
+     * compared to the threshold to determine whether to trigger google search.
+     */
+    googleSearchDynamicRetrievalScore?: number;
+};
+
+/**
+ * Attribution for a source that contributed to an answer.
+ */
+export type GroundingAttribution = {
+    /**
+     * Output only. Identifier for the source contributing to this attribution.
+     */
+    sourceId?: AttributionSourceId;
+    /**
+     * Grounding source content that makes up this attribution.
+     */
+    content?: Content;
+};
+
+/**
+ * Parameters for telling the service how to chunk the file.
+ * inspired by
+ * google3/cloud/ai/platform/extension/lib/retrieval/config/chunker_config.proto
+ */
+export type ChunkingConfig = {
+    /**
+     * White space chunking configuration.
+     */
+    whiteSpaceConfig?: WhiteSpaceConfig;
+};
+
+/**
+ * This resource represents a long-running operation where metadata and response fields are strongly typed.
+ */
+export type BatchGenerateContentOperation = BaseOperation & {
+    metadata?: GenerateContentBatch;
+    response?: BatchGenerateContentResponse;
+};
+
+/**
+ * Response from `ListModel` containing a paginated list of Models.
+ */
+export type ListModelsResponse = {
+    /**
+     * A token, which can be sent as `page_token` to retrieve the next page.
+     *
+     * If this field is omitted, there are no more pages.
+     */
+    nextPageToken?: string;
+    /**
+     * The returned Models.
+     */
+    models?: Array<Model>;
+};
+
+/**
+ * Response from `ListCorpora` containing a paginated list of `Corpora`.
+ * The results are sorted by ascending `corpus.create_time`.
+ */
+export type ListCorporaResponse = {
+    /**
+     * The returned corpora.
+     */
+    corpora?: Array<Corpus>;
+    /**
+     * A token, which can be sent as `page_token` to retrieve the next page.
+     * If this field is omitted, there are no more pages.
+     */
+    nextPageToken?: string;
+};
+
+/**
+ * The response to a EmbedTextRequest.
+ */
+export type BatchEmbedTextResponse = {
+    /**
+     * Output only. The embeddings generated from the input text.
+     */
+    readonly embeddings?: Array<Embedding>;
+};
+
+export type Type = 'TYPE_UNSPECIFIED' | 'STRING' | 'NUMBER' | 'INTEGER' | 'BOOLEAN' | 'ARRAY' | 'OBJECT' | 'NULL';
+
+/**
+ * Stats about the batch.
+ */
+export type BatchStats = {
+    /**
+     * Output only. The number of requests that were successfully processed.
+     */
+    readonly successfulRequestCount?: string;
+    /**
+     * Output only. The number of requests that are still pending processing.
+     */
+    readonly pendingRequestCount?: string;
+    /**
+     * Output only. The number of requests that failed to be processed.
+     */
+    readonly failedRequestCount?: string;
+    /**
+     * Output only. The number of requests in the batch.
+     */
+    readonly requestCount?: string;
+};
+
+/**
+ * Request for `CreateFile`.
+ */
+export type CreateFileRequest = {
+    /**
+     * Optional. Metadata for the file to create.
+     */
+    file?: File;
+};
+
+/**
+ * Request to transfer the ownership of the tuned model.
+ */
+export type TransferOwnershipRequest = {
+    /**
+     * Required. The email address of the user to whom the tuned model is being transferred
+     * to.
+     */
+    emailAddress: string;
+};
+
+/**
+ * Config for image generation features.
+ */
+export type ImageConfig = {
+    /**
+     * Optional. The aspect ratio of the image to generate. Supported aspect ratios: `1:1`,
+     * `1:4`, `4:1`, `1:8`, `8:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`,
+     * `9:16`, `16:9`, or `21:9`.
+     *
+     * If not specified, the model will choose a default aspect ratio based on any
+     * reference images provided.
+     */
+    aspectRatio?: string;
+    /**
+     * Optional. Specifies the size of generated images. Supported values are `512`, `1K`,
+     * `2K`, `4K`. If not specified, the model will use default value `1K`.
+     */
+    imageSize?: string;
+};
+
+/**
+ * Hyperparameters controlling the tuning process. Read more at
+ * https://ai.google.dev/docs/model_tuning_guidance
+ */
+export type Hyperparameters = {
+    /**
+     * Immutable. The batch size hyperparameter for tuning.
+     * If not set, a default of 4 or 16 will be used based on the number of
+     * training examples.
+     */
+    batchSize?: number;
+    /**
+     * Optional. Immutable. The learning rate hyperparameter for tuning.
+     * If not set, a default of 0.001 or 0.0002 will be calculated based on the
+     * number of training examples.
+     */
+    learningRate?: number;
+    /**
+     * Optional. Immutable. The learning rate multiplier is used to calculate a final learning_rate
+     * based on the default (recommended) value.
+     * Actual learning rate := learning_rate_multiplier * default learning rate
+     * Default learning rate is dependent on base model and dataset size.
+     * If not set, a default of 1.0 will be used.
+     */
+    learningRateMultiplier?: number;
+    /**
+     * Immutable. The number of training epochs. An epoch is one pass through the training
+     * data.
+     * If not set, a default of 5 will be used.
+     */
+    epochCount?: number;
+};
+
+/**
+ * Response from `ListFileSearchStores` containing a paginated list of
+ * `FileSearchStores`. The results are sorted by ascending
+ * `file_search_store.create_time`.
+ */
+export type ListFileSearchStoresResponse = {
+    /**
+     * The returned rag_stores.
+     */
+    fileSearchStores?: Array<FileSearchStore>;
+    /**
+     * A token, which can be sent as `page_token` to retrieve the next page.
+     * If this field is omitted, there are no more pages.
+     */
+    nextPageToken?: string;
+};
+
+/**
+ * The Tool configuration containing parameters for specifying `Tool` use
+ * in the request.
+ */
+export type ToolConfig = {
+    /**
+     * Optional. Function calling config.
+     */
+    functionCallingConfig?: FunctionCallingConfig;
+    /**
+     * Optional. Retrieval config.
+     */
+    retrievalConfig?: RetrievalConfig;
+    /**
+     * Optional. If true, the API response will include the server-side tool calls and
+     * responses within the `Content` message. This allows clients to
+     * observe the server's tool interactions.
+     */
+    includeServerSideToolInvocations?: boolean;
+};
+
+/**
+ * Request for `ImportFile` to import a File API file with a `FileSearchStore`.
+ */
+export type ImportFileRequest = {
+    /**
+     * Optional. Config for telling the service how to chunk the file.
+     * If not provided, the service will use default parameters.
+     */
+    chunkingConfig?: ChunkingConfig;
+    /**
+     * Required. The name of the `File` to import.
+     * Example: `files/abc-123`
+     */
+    fileName: string;
+    /**
+     * Custom metadata to be associated with the file.
+     */
+    customMetadata?: Array<CustomMetadata>;
+};
+
+/**
+ * Response from the model supporting multiple candidate responses.
+ *
+ * Safety ratings and content filtering are reported for both
+ * prompt in `GenerateContentResponse.prompt_feedback` and for each candidate
+ * in `finish_reason` and in `safety_ratings`. The API:
+ * - Returns either all requested candidates or none of them
+ * - Returns no candidates at all only if there was something wrong with the
+ * prompt (check `prompt_feedback`)
+ * - Reports feedback on each candidate in `finish_reason` and
+ * `safety_ratings`.
+ */
+export type GenerateContentResponse = {
+    /**
+     * Candidate responses from the model.
+     */
+    candidates?: Array<Candidate>;
+    /**
+     * Output only. The model version used to generate the response.
+     */
+    readonly modelVersion?: string;
+    /**
+     * Output only. Metadata on the generation requests' token usage.
+     */
+    usageMetadata?: UsageMetadata;
+    /**
+     * Returns the prompt's feedback related to the content filters.
+     */
+    promptFeedback?: PromptFeedback;
+    /**
+     * Output only. The current model status of this model.
+     */
+    modelStatus?: ModelStatus;
+    /**
+     * Output only. response_id is used to identify each response.
+     */
+    readonly responseId?: string;
+};
+
+/**
+ * Google search entry point.
+ */
+export type SearchEntryPoint = {
+    /**
+     * Optional. Web content snippet that can be embedded in a web page or an app webview.
+     */
+    renderedContent?: string;
+    /**
+     * Optional. Base64 encoded JSON representing array of  tuple.
+     */
+    sdkBlob?: string;
+};
+
+/**
+ * An object that represents a latitude/longitude pair. This is expressed as a
+ * pair of doubles to represent degrees latitude and degrees longitude. Unless
+ * specified otherwise, this object must conform to the
+ * WGS84 standard. Values must be within normalized ranges.
+ */
+export type LatLng = {
+    /**
+     * The latitude in degrees. It must be in the range [-90.0, +90.0].
+     */
+    latitude?: number;
+    /**
+     * The longitude in degrees. It must be in the range [-180.0, +180.0].
+     */
+    longitude?: number;
+};
+
+/**
+ * A file uploaded to the API.
+ * Next ID: 15
+ */
+export type File = {
+    /**
+     * Output only. The uri of the `File`.
+     */
+    readonly uri?: string;
+    /**
+     * Output only. Processing state of the File.
+     */
+    state?: 'STATE_UNSPECIFIED' | 'PROCESSING' | 'ACTIVE' | 'FAILED';
+    /**
+     * Output only. The download uri of the `File`.
+     */
+    readonly downloadUri?: string;
+    /**
+     * Immutable. Identifier. The `File` resource name. The ID (name excluding the "files/" prefix) can
+     * contain up to 40 characters that are lowercase alphanumeric or dashes (-).
+     * The ID cannot start or end with a dash. If the name is empty on create, a
+     * unique name will be generated.
+     * Example: `files/123-456`
+     */
+    name?: string;
+    /**
+     * Output only. MIME type of the file.
+     */
+    readonly mimeType?: string;
+    /**
+     * Source of the File.
+     */
+    source?: 'SOURCE_UNSPECIFIED' | 'UPLOADED' | 'GENERATED' | 'REGISTERED';
+    /**
+     * Output only. The timestamp of when the `File` was last updated.
+     */
+    readonly updateTime?: string;
+    /**
+     * Output only. The timestamp of when the `File` was created.
+     */
+    readonly createTime?: string;
+    /**
+     * Output only. Size of the file in bytes.
+     */
+    readonly sizeBytes?: string;
+    /**
+     * Output only. SHA-256 hash of the uploaded bytes.
+     */
+    readonly sha256Hash?: string;
+    /**
+     * Output only. The timestamp of when the `File` will be deleted. Only set if the `File` is
+     * scheduled to expire.
+     */
+    readonly expirationTime?: string;
+    /**
+     * Output only. Metadata for a video.
+     */
+    videoMetadata?: VideoFileMetadata;
+    /**
+     * Optional. The human-readable display name for the `File`. The display name must be
+     * no more than 512 characters in length, including spaces.
+     * Example: "Welcome Image"
+     */
+    displayName?: string;
+    /**
+     * Output only. Error status if File processing failed.
+     */
+    error?: Status;
+};
+
+/**
+ * Feedback related to the input data used to answer the question, as opposed
+ * to the model-generated response to the question.
+ */
+export type InputFeedback = {
+    /**
+     * Ratings for safety of the input.
+     * There is at most one rating per category.
+     */
+    safetyRatings?: Array<SafetyRating>;
+    /**
+     * Optional. If set, the input was blocked and no candidates are returned.
+     * Rephrase the input.
+     */
+    blockReason?: 'BLOCK_REASON_UNSPECIFIED' | 'SAFETY' | 'OTHER';
+};
+
+/**
+ * Response from `ListTunedModels` containing a paginated list of Models.
+ */
+export type ListTunedModelsResponse = {
+    /**
+     * The returned Models.
+     */
+    tunedModels?: Array<TunedModel>;
+    /**
+     * A token, which can be sent as `page_token` to retrieve the next page.
+     *
+     * If this field is omitted, there are no more pages.
+     */
+    nextPageToken?: string;
+};
+
+export type ModelStage = 'MODEL_STAGE_UNSPECIFIED' | 'UNSTABLE_EXPERIMENTAL' | 'EXPERIMENTAL' | 'PREVIEW' | 'STABLE' | 'LEGACY' | 'DEPRECATED' | 'RETIRED';
+
+/**
+ * A repeated list of passages.
+ */
+export type GroundingPassages = {
+    /**
+     * List of passages.
+     */
+    passages?: Array<GroundingPassage>;
+};
+
+/**
+ * GoogleSearch tool type.
+ * Tool to support Google Search in Model. Powered by Google.
+ */
+export type GoogleSearch = {
+    /**
+     * Optional. The set of search types to enable. If not set, web search is
+     * enabled by default.
+     */
+    searchTypes?: SearchTypes;
+    /**
+     * Optional. Filter search results to a specific time range.
+     * If customers set a start time, they must set an end time (and vice
+     * versa).
+     */
+    timeRangeFilter?: Interval;
+};
+
+/**
+ * A set of the feedback metadata the prompt specified in
+ * `GenerateContentRequest.content`.
+ */
+export type PromptFeedback = {
+    /**
+     * Ratings for safety of the prompt.
+     * There is at most one rating per category.
+     */
+    safetyRatings?: Array<SafetyRating>;
+    /**
+     * Optional. If set, the prompt was blocked and no candidates are returned.
+     * Rephrase the prompt.
+     */
+    blockReason?: 'BLOCK_REASON_UNSPECIFIED' | 'SAFETY' | 'OTHER' | 'BLOCKLIST' | 'PROHIBITED_CONTENT' | 'IMAGE_SAFETY';
+};
+
+/**
+ * This resource represents a long-running operation where metadata and response fields are strongly typed.
+ */
+export type UploadToFileSearchStoreOperation = BaseOperation & {
+    metadata?: UploadToFileSearchStoreMetadata;
+    response?: UploadToFileSearchStoreResponse;
+};
+
+/**
+ * Batch request to get a text embedding from the model.
+ */
+export type BatchEmbedTextRequest = {
+    /**
+     * Optional. Embed requests for the batch. Only one of `texts` or `requests` can be set.
+     */
+    requests?: Array<EmbedTextRequest>;
+    /**
+     * Optional. The free-form input texts that the model will turn into an embedding. The
+     * current limit is 100 texts, over which an error will be thrown.
+     */
+    texts?: Array<string>;
+};
+
+/**
+ * A `GroundingChunk` represents a segment of supporting evidence that grounds
+ * the model's response. It can be a chunk from the web, a retrieved context
+ * from a file, or information from Google Maps.
+ */
+export type GroundingChunk = {
+    /**
+     * Grounding chunk from the web.
+     */
+    web?: Web;
+    /**
+     * Optional. Grounding chunk from context retrieved by the file search tool.
+     */
+    retrievedContext?: RetrievedContext;
+    /**
+     * Optional. Grounding chunk from image search.
+     */
+    image?: Image;
+    /**
+     * Optional. Grounding chunk from Google Maps.
+     */
+    maps?: Maps;
+};
+
+/**
+ * User provided filter to limit retrieval based on `Chunk` or `Document` level
+ * metadata values.
+ * Example (genre = drama OR genre = action):
+ * key = "document.custom_metadata.genre"
+ * conditions = [{string_value = "drama", operation = EQUAL},
+ * {string_value = "action", operation = EQUAL}]
+ */
+export type MetadataFilter = {
+    /**
+     * Required. The key of the metadata to filter on.
+     */
+    key: string;
+    /**
+     * Required. The `Condition`s for the given key that will trigger this filter. Multiple
+     * `Condition`s are joined by logical ORs.
+     */
+    conditions: Array<Condition>;
+};
+
+/**
+ * The response to a single request in the batch.
+ */
+export type InlinedResponse = {
+    /**
+     * Output only. The response to the request.
+     */
+    response?: GenerateContentResponse;
+    /**
+     * Output only. The metadata associated with the request.
+     */
+    readonly metadata?: {};
+    /**
+     * Output only. The error encountered while processing the request.
+     */
+    error?: Status;
+};
+
+/**
+ * The request to be processed in the batch.
+ */
+export type InlinedRequest = {
+    /**
+     * Optional. The metadata to be associated with the request.
+     */
+    metadata?: {};
+    /**
+     * Required. The request to be processed in the batch.
+     */
+    request: GenerateContentRequest;
+};
+
+/**
+ * A response from `CountTokens`.
+ *
+ * It returns the model's `token_count` for the `prompt`.
+ */
+export type CountTokensResponse = {
+    /**
+     * Output only. List of modalities that were processed in the request input.
+     */
+    readonly promptTokensDetails?: Array<ModalityTokenCount>;
+    /**
+     * The number of tokens that the `Model` tokenizes the `prompt` into. Always
+     * non-negative.
+     */
+    totalTokens?: number;
+    /**
+     * Output only. List of modalities that were processed in the cached content.
+     */
+    readonly cacheTokensDetails?: Array<ModalityTokenCount>;
+    /**
+     * Number of tokens in the cached part of the prompt (the cached content).
+     */
+    cachedContentTokenCount?: number;
+};
+
+/**
+ * Content filtering metadata associated with processing a single request.
+ *
+ * ContentFilter contains a reason and an optional supporting string. The reason
+ * may be unspecified.
+ */
+export type ContentFilter = {
+    /**
+     * The reason content was blocked during request processing.
+     */
+    reason?: 'BLOCKED_REASON_UNSPECIFIED' | 'SAFETY' | 'OTHER';
+    /**
+     * A string that describes the filtering behavior in more detail.
+     */
+    message?: string;
+};
+
+/**
+ * A collection of source attributions for a piece of content.
+ */
+export type CitationMetadata = {
+    /**
+     * Citations to sources for a specific response.
+     */
+    citationSources?: Array<CitationSource>;
+};
+
+/**
+ * Tool details that the model may use to generate response.
+ *
+ * A `Tool` is a piece of code that enables the system to interact with
+ * external systems to perform an action, or set of actions, outside of
+ * knowledge and scope of the model.
+ *
+ * Next ID: 16
+ */
+export type Tool = {
+    /**
+     * Optional. MCP Servers to connect to.
+     */
+    mcpServers?: Array<McpServer>;
+    /**
+     * Optional. GoogleSearch tool type.
+     * Tool to support Google Search in Model. Powered by Google.
+     */
+    googleSearch?: GoogleSearch;
+    /**
+     * Optional. A list of `FunctionDeclarations` available to the model that can be used
+     * for function calling.
+     *
+     * The model or system does not execute the function. Instead the defined
+     * function may be returned as a FunctionCall
+     * with arguments to the client side for execution. The model may decide to
+     * call a subset of these functions by populating
+     * FunctionCall in the response. The next
+     * conversation turn may contain a
+     * FunctionResponse
+     * with the Content.role "function" generation context for the next model
+     * turn.
+     */
+    functionDeclarations?: Array<FunctionDeclaration>;
+    /**
+     * Optional. Retrieval tool that is powered by Google search.
+     */
+    googleSearchRetrieval?: GoogleSearchRetrieval;
+    /**
+     * Optional. Tool that allows grounding the model's response with geospatial context
+     * related to the user's query.
+     */
+    googleMaps?: GoogleMaps;
+    /**
+     * Optional. Tool to support the model interacting directly with the computer.
+     * If enabled, it automatically populates computer-use specific Function
+     * Declarations.
+     */
+    computerUse?: ComputerUse;
+    /**
+     * Optional. Tool to support URL context retrieval.
+     */
+    urlContext?: UrlContext;
+    /**
+     * Optional. Enables the model to execute code as part of generation.
+     */
+    codeExecution?: CodeExecution;
+    /**
+     * Optional. FileSearch tool type.
+     * Tool to retrieve knowledge from Semantic Retrieval corpora.
+     */
+    fileSearch?: FileSearch;
+};
+
+/**
+ * The `Schema` object allows the definition of input and output data types.
+ * These types can be objects, but also primitives and arrays.
+ * Represents a select subset of an [OpenAPI 3.0 schema
+ * object](https://spec.openapis.org/oas/v3.0.3#schema).
+ */
+export type Schema = {
+    /**
+     * Optional. The title of the schema.
+     */
+    title?: string;
+    /**
+     * Optional. Schema of the elements of Type.ARRAY.
+     */
+    items?: Schema;
+    /**
+     * Optional. Properties of Type.OBJECT.
+     */
+    properties?: {
+        [key: string]: Schema;
+    };
+    /**
+     * Optional. Maximum number of the properties for Type.OBJECT.
+     */
+    maxProperties?: string;
+    /**
+     * Optional. Maximum length of the Type.STRING
+     */
+    maxLength?: string;
+    /**
+     * Optional. Possible values of the element of Type.STRING with enum format.
+     * For example we can define an Enum Direction as :
+     * {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}
+     */
+    enum?: Array<string>;
+    /**
+     * Optional. The value should be validated against any (one or more) of the subschemas
+     * in the list.
+     */
+    anyOf?: Array<Schema>;
+    /**
+     * Optional. Required properties of Type.OBJECT.
+     */
+    required?: Array<string>;
+    /**
+     * Optional. The format of the data. Any value is allowed, but most do not trigger any
+     * special functionality.
+     */
+    format?: string;
+    /**
+     * Optional. Minimum number of the properties for Type.OBJECT.
+     */
+    minProperties?: string;
+    /**
+     * Optional. Maximum number of the elements for Type.ARRAY.
+     */
+    maxItems?: string;
+    /**
+     * Optional. Indicates if the value may be null.
+     */
+    nullable?: boolean;
+    /**
+     * Optional. Maximum value of the Type.INTEGER and Type.NUMBER
+     */
+    maximum?: number;
+    /**
+     * Optional. The order of the properties.
+     * Not a standard field in open api spec. Used to determine the order of the
+     * properties in the response.
+     */
+    propertyOrdering?: Array<string>;
+    /**
+     * Optional. Default value of the field. Per JSON Schema, this field is intended for
+     * documentation generators and doesn't affect validation. Thus it's included
+     * here and ignored so that developers who send schemas with a `default` field
+     * don't get unknown-field errors.
+     */
+    default?: unknown;
+    /**
+     * Optional. Minimum number of the elements for Type.ARRAY.
+     */
+    minItems?: string;
+    /**
+     * Optional. SCHEMA FIELDS FOR TYPE STRING
+     * Minimum length of the Type.STRING
+     */
+    minLength?: string;
+    /**
+     * Required. Data type.
+     */
+    type: Type;
+    /**
+     * Optional. Pattern of the Type.STRING to restrict a string to a regular expression.
+     */
+    pattern?: string;
+    /**
+     * Optional. Example of the object. Will only populated when the object is the root.
+     */
+    example?: unknown;
+    /**
+     * Optional. A brief description of the parameter. This could contain examples of use.
+     * Parameter description may be formatted as Markdown.
+     */
+    description?: string;
+    /**
+     * Optional. SCHEMA FIELDS FOR TYPE INTEGER and NUMBER
+     * Minimum value of the Type.INTEGER and Type.NUMBER
+     */
+    minimum?: number;
+};
+
+/**
+ * The FileSearch tool that retrieves knowledge from Semantic Retrieval corpora.
+ * Files are imported to Semantic Retrieval corpora using the ImportFile API.
+ */
+export type FileSearch = {
+    /**
+     * Required. The names of the file_search_stores to retrieve from.
+     * Example: `fileSearchStores/my-file-search-store-123`
+     */
+    fileSearchStoreNames: Array<string>;
+    /**
+     * Optional. The number of semantic retrieval chunks to retrieve.
+     */
+    topK?: number;
+    /**
+     * Optional. Metadata filter to apply to the semantic retrieval documents and chunks.
+     */
+    metadataFilter?: string;
+};
+
+/**
+ * A file generated on behalf of a user.
+ */
+export type GeneratedFile = {
+    /**
+     * Identifier. The name of the generated file.
+     * Example: `generatedFiles/abc-123`
+     */
+    name?: string;
+    /**
+     * MIME type of the generatedFile.
+     */
+    mimeType?: string;
+    /**
+     * Error details if the GeneratedFile ends up in the STATE_FAILED state.
+     */
+    error?: Status;
+    /**
+     * Output only. The state of the GeneratedFile.
+     */
+    state?: 'STATE_UNSPECIFIED' | 'GENERATING' | 'GENERATED' | 'FAILED';
+};
+
+/**
+ * The response from the model.
+ *
+ * This includes candidate messages and
+ * conversation history in the form of chronologically-ordered messages.
+ */
+export type GenerateMessageResponse = {
+    /**
+     * A set of content filtering metadata for the prompt and response
+     * text.
+     *
+     * This indicates which `SafetyCategory`(s) blocked a
+     * candidate from this response, the lowest `HarmProbability`
+     * that triggered a block, and the HarmThreshold setting for that category.
+     */
+    filters?: Array<ContentFilter>;
+    /**
+     * Candidate response messages from the model.
+     */
+    candidates?: Array<Message>;
+    /**
+     * The conversation history used by the model.
+     */
+    messages?: Array<Message>;
+};
+
+/**
+ * Represents token counting info for a single modality.
+ */
+export type ModalityTokenCount = {
+    /**
+     * The modality associated with this token count.
+     */
+    modality?: GenerativeLanguageModality;
+    /**
+     * Number of tokens.
+     */
+    tokenCount?: number;
+};
+
+/**
+ * Retrieval config.
+ */
+export type RetrievalConfig = {
+    /**
+     * Optional. The location of the user.
+     */
+    latLng?: LatLng;
+    /**
+     * Optional. The language code of the user.
+     * Language code for content. Use language tags defined by
+     * [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt).
+     */
+    languageCode?: string;
+};
+
+/**
+ * Request for `UploadToFileSearchStore`.
+ */
+export type UploadToFileSearchStoreRequest = {
+    /**
+     * Custom metadata to be associated with the data.
+     */
+    customMetadata?: Array<CustomMetadata>;
+    /**
+     * Optional. Display name of the created document.
+     */
+    displayName?: string;
+    /**
+     * Optional. Config for telling the service how to chunk the data.
+     * If not provided, the service will use default parameters.
+     */
+    chunkingConfig?: ChunkingConfig;
+    /**
+     * Optional. MIME type of the data. If not provided, it will be inferred from the
+     * uploaded content.
+     */
+    mimeType?: string;
+};
+
+/**
+ * Dataset for training or validation.
+ */
+export type Dataset = {
+    /**
+     * Optional. Inline examples with simple input/output text.
+     */
+    examples?: TuningExamples;
+};
+
+/**
+ * The response from the model, including candidate completions.
+ */
+export type GenerateTextResponse = {
+    /**
+     * A set of content filtering metadata for the prompt and response
+     * text.
+     *
+     * This indicates which `SafetyCategory`(s) blocked a
+     * candidate from this response, the lowest `HarmProbability`
+     * that triggered a block, and the HarmThreshold setting for that category.
+     * This indicates the smallest change to the `SafetySettings` that would be
+     * necessary to unblock at least 1 response.
+     *
+     * The blocking is configured by the `SafetySettings` in the request (or the
+     * default `SafetySettings` of the API).
+     */
+    filters?: Array<ContentFilter>;
+    /**
+     * Candidate responses from the model.
+     */
+    candidates?: Array<TextCompletion>;
+    /**
+     * Returns any safety feedback related to content filtering.
+     */
+    safetyFeedback?: Array<SafetyFeedback>;
+};
+
+/**
+ * Identifier for a `Chunk` retrieved via Semantic Retriever specified in the
+ * `GenerateAnswerRequest` using `SemanticRetrieverConfig`.
+ */
+export type SemanticRetrieverChunk = {
+    /**
+     * Output only. Name of the `Chunk` containing the attributed text.
+     * Example: `corpora/123/documents/abc/chunks/xyz`
+     */
+    readonly chunk?: string;
+    /**
+     * Output only. Name of the source matching the request's
+     * `SemanticRetrieverConfig.source`. Example: `corpora/123` or
+     * `corpora/123/documents/abc`
+     */
+    readonly source?: string;
+};
+
+/**
+ * The response to a EmbedTextRequest.
+ */
+export type EmbedTextResponse = {
+    /**
+     * Output only. The embedding generated from the input text.
+     */
+    embedding?: Embedding;
+};
+
+/**
+ * Computer Use tool type.
+ */
+export type ComputerUse = {
+    /**
+     * Required. The environment being operated.
+     */
+    environment: 'ENVIRONMENT_UNSPECIFIED' | 'ENVIRONMENT_BROWSER';
+    /**
+     * Optional. By default, predefined functions are included in the final model
+     * call.
+     * Some of them can be explicitly excluded from being automatically
+     * included. This can serve two purposes:
+     * 1. Using a more restricted / different action space.
+     * 2. Improving the definitions / instructions of predefined functions.
+     */
+    excludedPredefinedFunctions?: Array<string>;
+};
+
+/**
+ * A set of tuning examples. Can be training or validation data.
+ */
+export type TuningExamples = {
+    /**
+     * The examples. Example input can be for text or discuss, but all examples
+     * in a set must be of the same type.
+     */
+    examples?: Array<TuningExample>;
+};
+
+/**
+ * The `Status` type defines a logical error model that is suitable for
+ * different programming environments, including REST APIs and RPC APIs. It is
+ * used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ * three pieces of data: error code, error message, and error details.
+ *
+ * You can find out more about this error model and how to work with it in the
+ * [API Design Guide](https://cloud.google.com/apis/design/errors).
+ */
+export type Status = {
+    /**
+     * A developer-facing error message, which should be in English. Any
+     * user-facing error message should be localized and sent in the
+     * google.rpc.Status.details field, or localized by the client.
+     */
+    message?: string;
+    /**
+     * The status code, which should be an enum value of google.rpc.Code.
+     */
+    code?: number;
+    /**
+     * A list of messages that carry the error details.  There is a common set of
+     * message types for APIs to use.
+     */
+    details?: Array<{}>;
+};
+
+/**
+ * Permission resource grants user, group or the rest of the world access to the
+ * PaLM API resource (e.g. a tuned model, corpus).
+ *
+ * A role is a collection of permitted operations that allows users to perform
+ * specific actions on PaLM API resources. To make them available to users,
+ * groups, or service accounts, you assign roles. When you assign a role, you
+ * grant permissions that the role contains.
+ *
+ * There are three concentric roles. Each role is a superset of the previous
+ * role's permitted operations:
+ *
+ * - reader can use the resource (e.g. tuned model, corpus) for inference
+ * - writer has reader's permissions and additionally can edit and share
+ * - owner has writer's permissions and additionally can delete
+ */
+export type Permission = {
+    /**
+     * Optional. Immutable. The email address of the user of group which this permission refers.
+     * Field is not set when permission's grantee type is EVERYONE.
+     */
+    emailAddress?: string;
+    /**
+     * Required. The role granted by this permission.
+     */
+    role: 'ROLE_UNSPECIFIED' | 'OWNER' | 'WRITER' | 'READER';
+    /**
+     * Output only. Identifier. The permission name. A unique name will be generated on create.
+     * Examples:
+     * tunedModels/{tuned_model}/permissions/{permission}
+     * corpora/{corpus}/permissions/{permission}
+     * Output only.
+     */
+    readonly name?: string;
+    /**
+     * Optional. Immutable. The type of the grantee.
+     */
+    granteeType?: 'GRANTEE_TYPE_UNSPECIFIED' | 'USER' | 'GROUP' | 'EVERYONE';
+};
+
+/**
+ * The configuration for the voice to use.
+ */
+export type VoiceConfig = {
+    /**
+     * The configuration for the prebuilt voice to use.
+     */
+    prebuiltVoiceConfig?: PrebuiltVoiceConfig;
+};
+
+/**
+ * Encapsulates a snippet of a user review that answers a question about
+ * the features of a specific place in Google Maps.
+ */
+export type ReviewSnippet = {
+    /**
+     * A link that corresponds to the user review on Google Maps.
+     */
+    googleMapsUri?: string;
+    /**
+     * The ID of the review snippet.
+     */
+    reviewId?: string;
+    /**
+     * Title of the review.
+     */
+    title?: string;
+};
+
+/**
+ * A predicted server-side `ToolCall` returned from the model. This message
+ * contains information about a tool that the model wants to invoke.
+ * The client is NOT expected to execute this `ToolCall`. Instead, the
+ * client should pass this `ToolCall` back to the API in a subsequent turn
+ * within a `Content` message, along with the corresponding `ToolResponse`.
+ */
+export type ToolCall = {
+    /**
+     * Optional. The tool call arguments.
+     * Example: {"arg1" : "value1", "arg2" : "value2" , ...}
+     */
+    args?: {};
+    /**
+     * Required. The type of tool that was called.
+     */
+    toolType: ToolType;
+    /**
+     * Optional. Unique identifier of the tool call.
+     * The server returns the tool response with the matching `id`.
+     */
+    id?: string;
+};
+
+/**
+ * A resource representing a batch of `GenerateContent` requests.
+ */
+export type GenerateContentBatch = {
+    /**
+     * Required. Input configuration of the instances on which batch processing
+     * are performed.
+     */
+    inputConfig: InputConfig;
+    /**
+     * Optional. The priority of the batch. Batches with a higher priority value will be
+     * processed before batches with a lower priority value. Negative values are
+     * allowed. Default is 0.
+     */
+    priority?: string;
+    /**
+     * Output only. The state of the batch.
+     */
+    state?: BatchState;
+    /**
+     * Output only. The time at which the batch processing completed.
+     */
+    readonly endTime?: string;
+    /**
+     * Output only. The time at which the batch was created.
+     */
+    readonly createTime?: string;
+    /**
+     * Output only. The output of the batch request.
+     */
+    output?: GenerateContentBatchOutput;
+    /**
+     * Output only. The time at which the batch was last updated.
+     */
+    readonly updateTime?: string;
+    /**
+     * Output only. Stats about the batch.
+     */
+    batchStats?: BatchStats;
+    /**
+     * Output only. Identifier. Resource name of the batch.
+     *
+     * Format: `batches/{batch_id}`.
+     */
+    readonly name?: string;
+    /**
+     * Required. The name of the `Model` to use for generating the completion.
+     *
+     * Format: `models/{model}`.
+     */
+    model: string;
+    /**
+     * Required. The user-defined name of this batch.
+     */
+    displayName: string;
+};
+
+/**
+ * A single example for tuning.
+ */
+export type TuningExample = {
+    /**
+     * Optional. Text model input.
+     */
+    textInput?: string;
+    /**
+     * Required. The expected model output.
+     */
+    output: string;
+};
+
+/**
+ * The GoogleMaps Tool that provides geospatial context for the user's query.
+ */
+export type GoogleMaps = {
+    /**
+     * Optional. Whether to return a widget context token in the GroundingMetadata of the
+     * response. Developers can use the widget context token to render a Google
+     * Maps widget with geospatial context related to the places that the model
+     * references in the response.
+     */
+    enableWidget?: boolean;
+};
+
+/**
+ * Request message for [PredictionService.PredictLongRunning].
+ */
+export type PredictLongRunningRequest = {
+    /**
+     * Required. The instances that are the input to the prediction call.
+     */
+    instances: Array<unknown>;
+    /**
+     * Optional. The parameters that govern the prediction call.
+     */
+    parameters?: unknown;
+};
+
+/**
+ * Metadata on the usage of the cached content.
+ */
+export type CachedContentUsageMetadata = {
+    /**
+     * Total number of tokens that the cached content consumes.
+     */
+    totalTokenCount?: number;
+};
+
+/**
+ * All of the structured input text passed to the model as a prompt.
+ *
+ * A `MessagePrompt` contains a structured set of fields that provide context
+ * for the conversation, examples of user input/model output message pairs that
+ * prime the model to respond in different ways, and the conversation history
+ * or list of messages representing the alternating turns of the conversation
+ * between the user and the model.
+ */
+export type MessagePrompt = {
+    /**
+     * Optional. Text that should be provided to the model first to ground the response.
+     *
+     * If not empty, this `context` will be given to the model first before the
+     * `examples` and `messages`. When using a `context` be sure to provide it
+     * with every request to maintain continuity.
+     *
+     * This field can be a description of your prompt to the model to help provide
+     * context and guide the responses. Examples: "Translate the phrase from
+     * English to French." or "Given a statement, classify the sentiment as happy,
+     * sad or neutral."
+     *
+     * Anything included in this field will take precedence over message history
+     * if the total input size exceeds the model's `input_token_limit` and the
+     * input request is truncated.
+     */
+    context?: string;
+    /**
+     * Optional. Examples of what the model should generate.
+     *
+     * This includes both user input and the response that the model should
+     * emulate.
+     *
+     * These `examples` are treated identically to conversation messages except
+     * that they take precedence over the history in `messages`:
+     * If the total input size exceeds the model's `input_token_limit` the input
+     * will be truncated. Items will be dropped from `messages` before `examples`.
+     */
+    examples?: Array<Example>;
+    /**
+     * Required. A snapshot of the recent conversation history sorted chronologically.
+     *
+     * Turns alternate between two authors.
+     *
+     * If the total input size exceeds the model's `input_token_limit` the input
+     * will be truncated: The oldest items will be dropped from `messages`.
+     */
+    messages: Array<Message>;
+};
+
+/**
+ * Response for a `BatchGenerateContent` operation.
+ */
+export type AsyncBatchEmbedContentResponse = {
+    /**
+     * Output only. The output of the batch request.
+     */
+    output?: EmbedContentBatchOutput;
+};
+
+/**
+ * Safety setting, affecting the safety-blocking behavior.
+ *
+ * Passing a safety setting for a category changes the allowed probability that
+ * content is blocked.
+ */
+export type SafetySetting = {
+    /**
+     * Required. The category for this setting.
+     */
+    category: HarmCategory;
+    /**
+     * Required. Controls the probability threshold at which harm is blocked.
+     */
+    threshold: 'HARM_BLOCK_THRESHOLD_UNSPECIFIED' | 'BLOCK_LOW_AND_ABOVE' | 'BLOCK_MEDIUM_AND_ABOVE' | 'BLOCK_ONLY_HIGH' | 'BLOCK_NONE' | 'OFF';
+};
+
+/**
+ * Describes the options to customize dynamic retrieval.
+ */
+export type DynamicRetrievalConfig = {
+    /**
+     * The mode of the predictor to be used in dynamic retrieval.
+     */
+    mode?: 'MODE_UNSPECIFIED' | 'MODE_DYNAMIC';
+    /**
+     * The threshold to be used in dynamic retrieval.
+     * If not set, a system default value is used.
+     */
+    dynamicThreshold?: number;
+};
+
+/**
+ * Representation of a video.
+ */
+export type Video = {
+    /**
+     * Raw bytes.
+     */
+    video?: string;
+    /**
+     * Path to another storage.
+     */
+    uri?: string;
+};
+
+/**
+ * A generic empty message that you can re-use to avoid defining duplicated
+ * empty messages in your APIs. A typical example is to use it as the request
+ * or the response type of an API method. For instance:
+ *
+ * service Foo {
+ * rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+ * }
+ */
+export type Empty = {
+    [key: string]: unknown;
+};
+
+/**
+ * This resource represents a long-running operation where metadata and response fields are strongly typed.
+ */
+export type CreateTunedModelOperation = BaseOperation & {
+    metadata?: CreateTunedModelMetadata;
+    response?: TunedModel;
+};
+
+/**
+ * A list of floats representing an embedding.
+ */
+export type ContentEmbedding = {
+    /**
+     * The embedding values. This is for 3P users only and will not be populated
+     * for 1P calls.
+     */
+    values?: Array<number>;
+    /**
+     * This field stores the soft tokens tensor frame shape
+     * (e.g. [1, 1, 256, 2048]).
+     */
+    shape?: Array<number>;
+};
+
+/**
+ * Response message for [PredictionService.Predict].
+ */
+export type PredictResponse = {
+    /**
+     * The outputs of the prediction call.
+     */
+    predictions?: Array<unknown>;
+};
+
+/**
+ * Chunk from the web.
+ */
+export type Web = {
+    /**
+     * Output only. URI reference of the chunk.
+     */
+    readonly uri?: string;
+    /**
+     * Output only. Title of the chunk.
+     */
+    readonly title?: string;
+};
+
+/**
+ * Grounding support.
+ */
+export type GoogleAiGenerativelanguageV1BetaGroundingSupport = {
+    /**
+     * Segment of the content this support belongs to.
+     */
+    segment?: GoogleAiGenerativelanguageV1BetaSegment;
+    /**
+     * Optional. A list of indices (into 'grounding_chunk' in
+     * `response.candidate.grounding_metadata`) specifying the citations
+     * associated with the claim. For instance [1,3,4] means that
+     * grounding_chunk[1], grounding_chunk[3], grounding_chunk[4] are the
+     * retrieved content attributed to the claim. If the response is streaming,
+     * the grounding_chunk_indices refer to the indices across all responses.
+     * It is the client's responsibility to accumulate the grounding chunks from
+     * all responses (while maintaining the same order).
+     */
+    groundingChunkIndices?: Array<number>;
+    /**
+     * Optional. Confidence score of the support references. Ranges from 0 to 1. 1 is the
+     * most confident. This list must have the same size as the
+     * grounding_chunk_indices.
+     */
+    confidenceScores?: Array<number>;
+    /**
+     * Output only. Indices into the `parts` field of the candidate's content. These indices
+     * specify which rendered parts are associated with this support source.
+     */
+    readonly renderedParts?: Array<number>;
+};
+
+/**
+ * This resource represents a long-running operation where metadata and response fields are strongly typed.
+ */
+export type ImportFileOperation = BaseOperation & {
+    metadata?: ImportFileMetadata;
+    response?: ImportFileResponse;
+};
+
+/**
+ * Safety feedback for an entire request.
+ *
+ * This field is populated if content in the input and/or response is blocked
+ * due to safety settings. SafetyFeedback may not exist for every HarmCategory.
+ * Each SafetyFeedback will return the safety settings used by the request as
+ * well as the lowest HarmProbability that should be allowed in order to return
+ * a result.
+ */
+export type SafetyFeedback = {
+    /**
+     * Safety rating evaluated from content.
+     */
+    rating?: SafetyRating;
+    /**
+     * Safety settings applied to the request.
+     */
+    setting?: SafetySetting;
+};
+
+/**
+ * Filter condition applicable to a single key.
+ */
+export type Condition = {
+    /**
+     * The string value to filter the metadata on.
+     */
+    stringValue?: string;
+    /**
+     * The numeric value to filter the metadata on.
+     */
+    numericValue?: number;
+    /**
+     * Required. Operator applied to the given key-value pair to trigger the condition.
+     */
+    operation: 'OPERATOR_UNSPECIFIED' | 'LESS' | 'LESS_EQUAL' | 'EQUAL' | 'GREATER_EQUAL' | 'GREATER' | 'NOT_EQUAL' | 'INCLUDES' | 'EXCLUDES';
+};
+
+/**
+ * A `Corpus` is a collection of `Document`s.
+ * A project can create up to 10 corpora.
+ */
+export type Corpus = {
+    /**
+     * Output only. The Timestamp of when the `Corpus` was last updated.
+     */
+    readonly updateTime?: string;
+    /**
+     * Output only. Immutable. Identifier. The `Corpus` resource name. The ID (name excluding the "corpora/" prefix)
+     * can contain up to 40 characters that are lowercase alphanumeric or dashes
+     * (-). The ID cannot start or end with a dash. If the name is empty on
+     * create, a unique name will be derived from `display_name` along with a 12
+     * character random suffix.
+     * Example: `corpora/my-awesome-corpora-123a456b789c`
+     */
+    readonly name?: string;
+    /**
+     * Output only. The Timestamp of when the `Corpus` was created.
+     */
+    readonly createTime?: string;
+    /**
+     * Optional. The human-readable display name for the `Corpus`. The display name must be
+     * no more than 512 characters in length, including spaces.
+     * Example: "Docs on Semantic Retriever"
+     */
+    displayName?: string;
+};
+
+/**
+ * Configuration for specifying function calling behavior.
+ */
+export type FunctionCallingConfig = {
+    /**
+     * Optional. Specifies the mode in which function calling should execute. If
+     * unspecified, the default value will be set to AUTO.
+     */
+    mode?: 'MODE_UNSPECIFIED' | 'AUTO' | 'ANY' | 'NONE' | 'VALIDATED';
+    /**
+     * Optional. A set of function names that, when provided, limits the functions the model
+     * will call.
+     *
+     * This should only be set when the Mode is ANY or VALIDATED. Function names
+     * should match [FunctionDeclaration.name]. When set, model will
+     * predict a function call from only allowed function names.
+     */
+    allowedFunctionNames?: Array<string>;
+};
+
+/**
+ * Response from `ListPermissions` containing a paginated list of
+ * permissions.
+ */
+export type ListPermissionsResponse = {
+    /**
+     * A token, which can be sent as `page_token` to retrieve the next page.
+     *
+     * If this field is omitted, there are no more pages.
+     */
+    nextPageToken?: string;
+    /**
+     * Returned permissions.
+     */
+    permissions?: Array<Permission>;
+};
+
+/**
+ * The requests to be processed in the batch if provided as part of the
+ * batch creation request.
+ */
+export type InlinedRequests = {
+    /**
+     * Required. The requests to be processed in the batch.
+     */
+    requests: Array<InlinedRequest>;
+};
+
+/**
+ * Metadata on the usage of the embedding request.
+ */
+export type EmbeddingUsageMetadata = {
+    /**
+     * Output only. Number of tokens in the prompt.
+     */
+    readonly promptTokenCount?: number;
+    /**
+     * Output only. List of modalities that were processed in the request input.
+     */
+    readonly promptTokenDetails?: Array<ModalityTokenCount>;
+};
+
+/**
+ * The requests to be processed in the batch if provided as part of the
+ * batch creation request.
+ */
+export type InlinedEmbedContentRequests = {
+    /**
+     * Required. The requests to be processed in the batch.
+     */
+    requests: Array<InlinedEmbedContentRequest>;
+};
+
+/**
+ * Response from `ListDocuments` containing a paginated list of `Document`s.
+ * The `Document`s are sorted by ascending `document.create_time`.
+ */
+export type ListDocumentsResponse = {
+    /**
+     * The returned `Document`s.
+     */
+    documents?: Array<Document>;
+    /**
+     * A token, which can be sent as `page_token` to retrieve the next page.
+     * If this field is omitted, there are no more pages.
+     */
+    nextPageToken?: string;
+};
+
+export type HarmCategory = 'HARM_CATEGORY_UNSPECIFIED' | 'HARM_CATEGORY_DEROGATORY' | 'HARM_CATEGORY_TOXICITY' | 'HARM_CATEGORY_VIOLENCE' | 'HARM_CATEGORY_SEXUAL' | 'HARM_CATEGORY_MEDICAL' | 'HARM_CATEGORY_DANGEROUS' | 'HARM_CATEGORY_HARASSMENT' | 'HARM_CATEGORY_HATE_SPEECH' | 'HARM_CATEGORY_SEXUALLY_EXPLICIT' | 'HARM_CATEGORY_DANGEROUS_CONTENT' | 'HARM_CATEGORY_CIVIC_INTEGRITY';
+
+/**
+ * The output of a batch request. This is returned in the
+ * `BatchGenerateContentResponse` or the `GenerateContentBatch.output` field.
+ */
+export type GenerateContentBatchOutput = {
+    /**
+     * Output only. The file ID of the file containing the responses.
+     * The file will be a JSONL file with a single response per line.
+     * The responses will be `GenerateContentResponse` messages formatted as
+     * JSON.
+     * The responses will be written in the same order as the input requests.
+     */
+    readonly responsesFile?: string;
+    /**
+     * Output only. The responses to the requests in the batch. Returned when the batch was
+     * built using inlined requests. The responses will be in the same order as
+     * the input requests.
+     */
+    inlinedResponses?: InlinedResponses;
+};
+
+/**
+ * Request to generate a message response from the model.
+ */
+export type GenerateMessageRequest = {
+    /**
+     * Required. The structured textual input given to the model as a prompt.
+     *
+     * Given a
+     * prompt, the model will return what it predicts is the next message in the
+     * discussion.
+     */
+    prompt: MessagePrompt;
+    /**
+     * Optional. Controls the randomness of the output.
+     *
+     * Values can range over `[0.0,1.0]`,
+     * inclusive. A value closer to `1.0` will produce responses that are more
+     * varied, while a value closer to `0.0` will typically result in
+     * less surprising responses from the model.
+     */
+    temperature?: number;
+    /**
+     * Optional. The number of generated response messages to return.
+     *
+     * This value must be between
+     * `[1, 8]`, inclusive. If unset, this will default to `1`.
+     */
+    candidateCount?: number;
+    /**
+     * Optional. The maximum cumulative probability of tokens to consider when sampling.
+     *
+     * The model uses combined Top-k and nucleus sampling.
+     *
+     * Nucleus sampling considers the smallest set of tokens whose probability
+     * sum is at least `top_p`.
+     */
+    topP?: number;
+    /**
+     * Optional. The maximum number of tokens to consider when sampling.
+     *
+     * The model uses combined Top-k and nucleus sampling.
+     *
+     * Top-k sampling considers the set of `top_k` most probable tokens.
+     */
+    topK?: number;
+};
+
+/**
+ * Response for `ListGeneratedFiles`.
+ */
+export type ListGeneratedFilesResponse = {
+    /**
+     * The list of `GeneratedFile`s.
+     */
+    generatedFiles?: Array<GeneratedFile>;
+    /**
+     * A token that can be sent as a `page_token` into a subsequent
+     * `ListGeneratedFiles` call.
+     */
+    nextPageToken?: string;
+};
+
+export type BatchState = 'BATCH_STATE_UNSPECIFIED' | 'BATCH_STATE_PENDING' | 'BATCH_STATE_RUNNING' | 'BATCH_STATE_SUCCEEDED' | 'BATCH_STATE_FAILED' | 'BATCH_STATE_CANCELLED' | 'BATCH_STATE_EXPIRED';
+
+/**
+ * A list of string values.
+ */
+export type GroundingChunkStringList = {
+    /**
+     * The string values of the list.
+     */
+    values?: Array<string>;
+};
+
+/**
+ * The response to a single request in the batch.
+ */
+export type InlinedEmbedContentResponse = {
+    /**
+     * Output only. The error encountered while processing the request.
+     */
+    error?: Status;
+    /**
+     * Output only. The metadata associated with the request.
+     */
+    readonly metadata?: {};
+    /**
+     * Output only. The response to the request.
+     */
+    response?: EmbedContentResponse;
+};
+
+/**
+ * A transport that can stream HTTP requests and responses.
+ * Next ID: 6
+ */
+export type StreamableHttpTransport = {
+    /**
+     * Optional: Fields for authentication headers, timeouts, etc., if needed.
+     */
+    headers?: {
+        [key: string]: string;
+    };
+    /**
+     * Timeout for SSE read operations.
+     */
+    sseReadTimeout?: string;
+    /**
+     * The full URL for the MCPServer endpoint.
+     * Example: "https://api.example.com/mcp"
+     */
+    url?: string;
+    /**
+     * HTTP timeout for regular operations.
+     */
+    timeout?: string;
+    /**
+     * Whether to close the client session when the transport closes.
+     */
+    terminateOnClose?: boolean;
+};
+
+/**
+ * A citation to a source for a portion of a specific response.
+ */
+export type CitationSource = {
+    /**
+     * Optional. End of the attributed segment, exclusive.
+     */
+    endIndex?: number;
+    /**
+     * Optional. URI that is attributed as a source for a portion of the text.
+     */
+    uri?: string;
+    /**
+     * Optional. License for the GitHub project that is attributed as a source for segment.
+     *
+     * License info is required for code citations.
+     */
+    license?: string;
+    /**
+     * Optional. Start of segment of the response that is attributed to this source.
+     *
+     * Index indicates the start of the segment, measured in bytes.
+     */
+    startIndex?: number;
+};
+
+/**
+ * The response to a `BatchEmbedContentsRequest`.
+ */
+export type BatchEmbedContentsResponse = {
+    /**
+     * Output only. The usage metadata for the request.
+     */
+    usageMetadata?: EmbeddingUsageMetadata;
+    /**
+     * Output only. The embeddings for each request, in the same order as provided in the batch
+     * request.
+     */
+    readonly embeddings?: Array<ContentEmbedding>;
+};
+
+/**
+ * Response with CachedContents list.
+ */
+export type ListCachedContentsResponse = {
+    /**
+     * List of cached contents.
+     */
+    cachedContents?: Array<CachedContent>;
+    /**
+     * A token, which can be sent as `page_token` to retrieve the next page.
+     * If this field is omitted, there are no subsequent pages.
+     */
+    nextPageToken?: string;
+};
+
+/**
+ * Request to generate a text completion response from the model.
+ */
+export type GenerateTextRequest = {
+    /**
+     * Optional. The maximum number of tokens to include in a candidate.
+     *
+     * If unset, this will default to output_token_limit specified in the `Model`
+     * specification.
+     */
+    maxOutputTokens?: number;
+    /**
+     * Optional. The maximum cumulative probability of tokens to consider when sampling.
+     *
+     * The model uses combined Top-k and nucleus sampling.
+     *
+     * Tokens are sorted based on their assigned probabilities so that only the
+     * most likely tokens are considered. Top-k sampling directly limits the
+     * maximum number of tokens to consider, while Nucleus sampling limits number
+     * of tokens based on the cumulative probability.
+     *
+     * Note: The default value varies by model, see the `Model.top_p`
+     * attribute of the `Model` returned the `getModel` function.
+     */
+    topP?: number;
+    /**
+     * Required. The free-form input text given to the model as a prompt.
+     *
+     * Given a prompt, the model will generate a TextCompletion response it
+     * predicts as the completion of the input text.
+     */
+    prompt: TextPrompt;
+    /**
+     * Optional. Controls the randomness of the output.
+     * Note: The default value varies by model, see the `Model.temperature`
+     * attribute of the `Model` returned the `getModel` function.
+     *
+     * Values can range from [0.0,1.0],
+     * inclusive. A value closer to 1.0 will produce responses that are more
+     * varied and creative, while a value closer to 0.0 will typically result in
+     * more straightforward responses from the model.
+     */
+    temperature?: number;
+    /**
+     * Optional. Number of generated responses to return.
+     *
+     * This value must be between [1, 8], inclusive. If unset, this will default
+     * to 1.
+     */
+    candidateCount?: number;
+    /**
+     * Optional. A list of unique `SafetySetting` instances for blocking unsafe content.
+     *
+     * that will be enforced on the `GenerateTextRequest.prompt` and
+     * `GenerateTextResponse.candidates`. There should not be more than one
+     * setting for each `SafetyCategory` type. The API will block any prompts and
+     * responses that fail to meet the thresholds set by these settings. This list
+     * overrides the default settings for each `SafetyCategory` specified in the
+     * safety_settings. If there is no `SafetySetting` for a given
+     * `SafetyCategory` provided in the list, the API will use the default safety
+     * setting for that category. Harm categories HARM_CATEGORY_DEROGATORY,
+     * HARM_CATEGORY_TOXICITY, HARM_CATEGORY_VIOLENCE, HARM_CATEGORY_SEXUAL,
+     * HARM_CATEGORY_MEDICAL, HARM_CATEGORY_DANGEROUS are supported in text
+     * service.
+     */
+    safetySettings?: Array<SafetySetting>;
+    /**
+     * Optional. The maximum number of tokens to consider when sampling.
+     *
+     * The model uses combined Top-k and nucleus sampling.
+     *
+     * Top-k sampling considers the set of `top_k` most probable tokens.
+     * Defaults to 40.
+     *
+     * Note: The default value varies by model, see the `Model.top_k`
+     * attribute of the `Model` returned the `getModel` function.
+     */
+    topK?: number;
+    /**
+     * The set of character sequences (up to 5) that will stop output generation.
+     * If specified, the API will stop at the first appearance of a stop
+     * sequence. The stop sequence will not be included as part of the response.
+     */
+    stopSequences?: Array<string>;
+};
+
+/**
+ * Batch request to get embeddings from the model for a list of prompts.
+ */
+export type BatchEmbedContentsRequest = {
+    /**
+     * Required. Embed requests for the batch. The model in each of these requests must
+     * match the model specified `BatchEmbedContentsRequest.model`.
+     */
+    requests: Array<EmbedContentRequest>;
+};
+
+/**
+ * User provided string values assigned to a single metadata key.
+ */
+export type StringList = {
+    /**
+     * The string values of the metadata to store.
+     */
+    values?: Array<string>;
+};
+
+/**
+ * Request for a `BatchGenerateContent` operation.
+ */
+export type BatchGenerateContentRequest = {
+    /**
+     * Required. The batch to create.
+     */
+    batch: GenerateContentBatch;
+};
+
+export type CustomLongRunningOperation = {
+    /**
+     * The normal, successful response of the operation.  If the original
+     * method returns no data on success, such as `Delete`, the response is
+     * `google.protobuf.Empty`.  If the original method is standard
+     * `Get`/`Create`/`Update`, the response should be the resource.  For other
+     * methods, the response should have the type `XxxResponse`, where `Xxx`
+     * is the original method name.  For example, if the original method name
+     * is `TakeSnapshot()`, the inferred response type is
+     * `TakeSnapshotResponse`.
+     */
+    response?: {};
+    /**
+     * Service-specific metadata associated with the operation.  It typically
+     * contains progress information and common metadata such as create time.
+     * Some services might not provide such metadata.  Any method that returns a
+     * long-running operation should document the metadata type, if any.
+     */
+    metadata?: {};
+    /**
+     * The server-assigned name, which is only unique within the same service that
+     * originally returns it. If you use the default HTTP mapping, the
+     * `name` should be a resource name ending with `operations/{unique_id}`.
+     */
+    name?: string;
+    /**
+     * The error result of the operation in case of failure or cancellation.
+     */
+    error?: Status;
+    /**
+     * If the value is `false`, it means the operation is still in progress.
+     * If `true`, the operation is completed, and either `error` or `response` is
+     * available.
+     */
+    done?: boolean;
+};
+
+/**
+ * This resource represents a long-running operation where metadata and response fields are strongly typed.
+ */
+export type AsyncBatchEmbedContentOperation = BaseOperation & {
+    metadata?: EmbedContentBatch;
+    response?: AsyncBatchEmbedContentResponse;
+};
+
+/**
+ * Tool that executes code generated by the model, and automatically returns
+ * the result to the model.
+ *
+ * See also `ExecutableCode` and `CodeExecutionResult` which are only generated
+ * when using this tool.
+ */
+export type CodeExecution = {
+    [key: string]: unknown;
+};
+
+/**
+ * Metadata for PredictLongRunning long running operations.
+ */
+export type PredictLongRunningMetadata = {
+    [key: string]: unknown;
+};
+
+/**
+ * Configuration for a white space chunking algorithm [white space delimited].
+ */
+export type WhiteSpaceConfig = {
+    /**
+     * Maximum number of overlapping tokens between two adjacent chunks.
+     */
+    maxOverlapTokens?: number;
+    /**
+     * Maximum number of tokens per chunk.
+     * Tokens are defined as words for this chunking algorithm.
+     * Note: we are defining tokens as words split by whitespace as opposed to
+     * the output of a tokenizer. The context window of the latest gemini
+     * embedding model as of 2025-04-17 is currently 8192 tokens. We assume that
+     * the average word is 5 characters. Therefore, we set the upper limit to
+     * 2**9, which is 512 words, or 2560 tokens, assuming worst case a
+     * character per token. This is a conservative estimate meant to prevent
+     * context window overflow.
+     */
+    maxTokensPerChunk?: number;
+};
+
+/**
+ * Safety rating for a piece of content.
+ *
+ * The safety rating contains the category of harm and the
+ * harm probability level in that category for a piece of content.
+ * Content is classified for safety across a number of
+ * harm categories and the probability of the harm classification is included
+ * here.
+ */
+export type SafetyRating = {
+    /**
+     * Required. The probability of harm for this content.
+     */
+    probability: 'HARM_PROBABILITY_UNSPECIFIED' | 'NEGLIGIBLE' | 'LOW' | 'MEDIUM' | 'HIGH';
+    /**
+     * Required. The category for this rating.
+     */
+    category: HarmCategory;
+    /**
+     * Was this content blocked because of this rating?
+     */
+    blocked?: boolean;
+};
+
+/**
+ * URI based data.
+ */
+export type FileData = {
+    /**
+     * Optional. The IANA standard MIME type of the source data.
+     */
+    mimeType?: string;
+    /**
+     * Required. URI.
+     */
+    fileUri: string;
+};
+
+/**
+ * Tool to support URL context retrieval.
+ */
+export type UrlContext = {
+    [key: string]: unknown;
+};
+
+/**
+ * The configuration for the prebuilt speaker to use.
+ */
+export type PrebuiltVoiceConfig = {
+    /**
+     * The name of the preset voice to use.
+     */
+    voiceName?: string;
+};
+
+/**
+ * Response from UploadToFileSearchStore.
+ */
+export type UploadToFileSearchStoreResponse = {
+    /**
+     * The name of the `FileSearchStore` containing `Document`s.
+     * Example: `fileSearchStores/my-file-search-store-123`
+     */
+    parent?: string;
+    /**
+     * Immutable. Identifier. The identifier for the `Document` imported.
+     * Example: `fileSearchStores/my-file-search-store-123a456b789c`
+     */
+    documentName?: string;
+    /**
+     * MIME type of the file.
+     */
+    mimeType?: string;
+    /**
+     * Size of the file in bytes.
+     */
+    sizeBytes?: string;
+};
+
+/**
+ * Metadata returned to client when grounding is enabled.
+ */
+export type GroundingMetadata = {
+    /**
+     * Optional. Google search entry for the following-up web searches.
+     */
+    searchEntryPoint?: SearchEntryPoint;
+    /**
+     * Web search queries for the following-up web search.
+     */
+    webSearchQueries?: Array<string>;
+    /**
+     * List of supporting references retrieved from specified grounding source.
+     * When streaming, this only contains the grounding chunks that have not been
+     * included in the grounding metadata of previous responses.
+     */
+    groundingChunks?: Array<GroundingChunk>;
+    /**
+     * Image search queries used for grounding.
+     */
+    imageSearchQueries?: Array<string>;
+    /**
+     * List of grounding support.
+     */
+    groundingSupports?: Array<GoogleAiGenerativelanguageV1BetaGroundingSupport>;
+    /**
+     * Metadata related to retrieval in the grounding flow.
+     */
+    retrievalMetadata?: RetrievalMetadata;
+    /**
+     * Optional. Resource name of the Google Maps widget context token that can be used
+     * with the PlacesContextElement widget in order to render contextual data.
+     * Only populated in the case that grounding with Google Maps is enabled.
+     */
+    googleMapsWidgetContextToken?: string;
+};
+
+/**
+ * Output text returned from a model.
+ */
+export type TextCompletion = {
+    /**
+     * Output only. The generated text returned from the model.
+     */
+    readonly output?: string;
+    /**
+     * Output only. Citation information for model-generated `output` in this
+     * `TextCompletion`.
+     *
+     * This field may be populated with attribution information for any text
+     * included in the `output`.
+     */
+    citationMetadata?: CitationMetadata;
+    /**
+     * Ratings for the safety of a response.
+     *
+     * There is at most one rating per category.
+     */
+    safetyRatings?: Array<SafetyRating>;
+};
+
+/**
+ * Request containing the `Content` for the model to embed.
+ */
+export type EmbedContentRequest = {
+    /**
+     * Required. The content to embed. Only the `parts.text` fields will be counted.
+     */
+    content: Content;
+    /**
+     * Optional. Optional task type for which the embeddings will be used. Not supported on
+     * earlier models (`models/embedding-001`).
+     */
+    taskType?: TaskType;
+    /**
+     * Optional. An optional title for the text. Only applicable when TaskType is
+     * `RETRIEVAL_DOCUMENT`.
+     *
+     * Note: Specifying a `title` for `RETRIEVAL_DOCUMENT` provides better quality
+     * embeddings for retrieval.
+     */
+    title?: string;
+    /**
+     * Required. The model's resource name. This serves as an ID for the Model to use.
+     *
+     * This name should match a model name returned by the `ListModels` method.
+     *
+     * Format: `models/{model}`
+     */
+    model: string;
+    /**
+     * Optional. Optional reduced dimension for the output embedding. If set, excessive
+     * values in the output embedding are truncated from the end. Supported by
+     * newer models since 2024 only. You cannot set this value if using the
+     * earlier model (`models/embedding-001`).
+     */
+    outputDimensionality?: number;
+};
+
+/**
+ * User provided metadata stored as key-value pairs.
+ */
+export type CustomMetadata = {
+    /**
+     * The string value of the metadata to store.
+     */
+    stringValue?: string;
+    /**
+     * The StringList value of the metadata to store.
+     */
+    stringListValue?: StringList;
+    /**
+     * The numeric value of the metadata to store.
+     */
+    numericValue?: number;
+    /**
+     * Required. The key of the metadata to store.
+     */
+    key: string;
+};
+
+/**
+ * Standard web search for grounding and related configurations.
+ */
+export type WebSearch = {
+    [key: string]: unknown;
+};
+
+/**
+ * Chunk from image search.
+ */
+export type Image = {
+    /**
+     * The title of the web page that the image is from.
+     */
+    title?: string;
+    /**
+     * The root domain of the web page that the image is from, e.g.
+     * "example.com".
+     */
+    domain?: string;
+    /**
+     * The web page URI for attribution.
+     */
+    sourceUri?: string;
+    /**
+     * The image asset URL.
+     */
+    imageUri?: string;
+};
+
+/**
+ * The response message for Operations.ListOperations.
+ */
+export type ListOperationsResponse = {
+    /**
+     * A list of operations that matches the specified filter in the request.
+     */
+    operations?: Array<Operation>;
+    /**
+     * The standard List next-page token.
+     */
+    nextPageToken?: string;
+    /**
+     * Unordered list. Unreachable resources. Populated when the request sets
+     * `ListOperationsRequest.return_partial_success` and reads across
+     * collections. For example, when attempting to list all resources across all
+     * supported locations.
+     */
+    unreachable?: Array<string>;
+};
+
+/**
+ * The responses to the requests in the batch.
+ */
+export type InlinedEmbedContentResponses = {
+    /**
+     * Output only. The responses to the requests in the batch.
+     */
+    readonly inlinedResponses?: Array<InlinedEmbedContentResponse>;
+};
+
+/**
+ * Request to generate a grounded answer from the `Model`.
+ */
+export type GenerateAnswerRequest = {
+    /**
+     * Required. The content of the current conversation with the `Model`. For single-turn
+     * queries, this is a single question to answer. For multi-turn queries, this
+     * is a repeated field that contains conversation history and the last
+     * `Content` in the list containing the question.
+     *
+     * Note: `GenerateAnswer` only supports queries in English.
+     */
+    contents: Array<Content>;
+    /**
+     * Content retrieved from resources created via the Semantic Retriever
+     * API.
+     */
+    semanticRetriever?: SemanticRetrieverConfig;
+    /**
+     * Optional. A list of unique `SafetySetting` instances for blocking unsafe content.
+     *
+     * This will be enforced on the `GenerateAnswerRequest.contents` and
+     * `GenerateAnswerResponse.candidate`. There should not be more than one
+     * setting for each `SafetyCategory` type. The API will block any contents and
+     * responses that fail to meet the thresholds set by these settings. This list
+     * overrides the default settings for each `SafetyCategory` specified in the
+     * safety_settings. If there is no `SafetySetting` for a given
+     * `SafetyCategory` provided in the list, the API will use the default safety
+     * setting for that category. Harm categories HARM_CATEGORY_HATE_SPEECH,
+     * HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT,
+     * HARM_CATEGORY_HARASSMENT are supported.
+     * Refer to the
+     * [guide](https://ai.google.dev/gemini-api/docs/safety-settings)
+     * for detailed information on available safety settings. Also refer to the
+     * [Safety guidance](https://ai.google.dev/gemini-api/docs/safety-guidance) to
+     * learn how to incorporate safety considerations in your AI applications.
+     */
+    safetySettings?: Array<SafetySetting>;
+    /**
+     * Optional. Controls the randomness of the output.
+     *
+     * Values can range from [0.0,1.0], inclusive. A value closer to 1.0 will
+     * produce responses that are more varied and creative, while a value closer
+     * to 0.0 will typically result in more straightforward responses from the
+     * model. A low temperature (~0.2) is usually recommended for
+     * Attributed-Question-Answering use cases.
+     */
+    temperature?: number;
+    /**
+     * Required. Style in which answers should be returned.
+     */
+    answerStyle: 'ANSWER_STYLE_UNSPECIFIED' | 'ABSTRACTIVE' | 'EXTRACTIVE' | 'VERBOSE';
+    /**
+     * Passages provided inline with the request.
+     */
+    inlinePassages?: GroundingPassages;
+};
+
+/**
+ * Deprecated: Use `GenerateContentRequest.processing_options` instead. Metadata
+ * describes the input video content.
+ * @deprecated
+ */
+export type VideoMetadata = {
+    /**
+     * Optional. The frame rate of the video sent to the model. If not specified, the
+     * default value will be 1.0.
+     * The fps range is (0.0, 24.0].
+     */
+    fps?: number;
+    /**
+     * Optional. The end offset of the video.
+     */
+    endOffset?: string;
+    /**
+     * Optional. The start offset of the video.
+     */
+    startOffset?: string;
+};
+
+/**
+ * The configuration for the multi-speaker setup.
+ */
+export type MultiSpeakerVoiceConfig = {
+    /**
+     * Required. All the enabled speaker voices.
+     */
+    speakerVoiceConfigs: Array<SpeakerVoiceConfig>;
+};
+
+/**
+ * Represents a time interval, encoded as a Timestamp start (inclusive) and a
+ * Timestamp end (exclusive).
+ *
+ * The start must be less than or equal to the end.
+ * When the start equals the end, the interval is empty (matches no time).
+ * When both start and end are unspecified, the interval matches any time.
+ */
+export type Interval = {
+    /**
+     * Optional. Inclusive start of the interval.
+     *
+     * If specified, a Timestamp matching this interval will have to be the same
+     * or after the start.
+     */
+    startTime?: string;
+    /**
+     * Optional. Exclusive end of the interval.
+     *
+     * If specified, a Timestamp matching this interval will have to be before the
+     * end.
+     */
+    endTime?: string;
+};
+
+/**
+ * The output of a batch request. This is returned in the
+ * `AsyncBatchEmbedContentResponse` or the `EmbedContentBatch.output` field.
+ */
+export type EmbedContentBatchOutput = {
+    /**
+     * Output only. The file ID of the file containing the responses.
+     * The file will be a JSONL file with a single response per line.
+     * The responses will be `EmbedContentResponse` messages formatted as JSON.
+     * The responses will be written in the same order as the input requests.
+     */
+    readonly responsesFile?: string;
+    /**
+     * Output only. The responses to the requests in the batch. Returned when the batch was
+     * built using inlined requests. The responses will be in the same order as
+     * the input requests.
+     */
+    inlinedResponses?: InlinedEmbedContentResponses;
+};
+
+/**
+ * Response for `CreateFile`.
+ */
+export type CreateFileResponse = {
+    /**
+     * Metadata for the created file.
+     */
+    file?: File;
+};
+
+/**
+ * The responses to the requests in the batch.
+ */
+export type InlinedResponses = {
+    /**
+     * Output only. The responses to the requests in the batch.
+     */
+    readonly inlinedResponses?: Array<InlinedResponse>;
+};
+
+/**
+ * A MCPServer is a server that can be called by the model to perform actions.
+ * It is a server that implements the MCP protocol.
+ * Next ID: 5
+ */
+export type McpServer = {
+    /**
+     * A transport that can stream HTTP requests and responses.
+     */
+    streamableHttpTransport?: StreamableHttpTransport;
+    /**
+     * The name of the MCPServer.
+     */
+    name?: string;
+};
+
+/**
+ * Result of executing the `ExecutableCode`.
+ *
+ * Generated only when the `CodeExecution` tool is used.
+ */
+export type CodeExecutionResult = {
+    /**
+     * Optional. The identifier of the `ExecutableCode` part this result is for.
+     * Only populated if the corresponding `ExecutableCode` has an id.
+     */
+    id?: string;
+    /**
+     * Required. Outcome of the code execution.
+     */
+    outcome: 'OUTCOME_UNSPECIFIED' | 'OUTCOME_OK' | 'OUTCOME_FAILED' | 'OUTCOME_DEADLINE_EXCEEDED';
+    /**
+     * Optional. Contains stdout when code execution is successful, stderr or other
+     * description otherwise.
+     */
+    output?: string;
+};
+
+/**
+ * Metadata related to url context retrieval tool.
+ */
+export type UrlContextMetadata = {
+    /**
+     * List of url context.
+     */
+    urlMetadata?: Array<UrlMetadata>;
+};
+
+/**
+ * Segment of the content.
+ */
+export type GoogleAiGenerativelanguageV1BetaSegment = {
+    /**
+     * The index of a Part object within its parent Content object.
+     */
+    partIndex?: number;
+    /**
+     * End index in the given Part, measured in bytes. Offset from the start of
+     * the Part, exclusive, starting at zero.
+     */
+    endIndex?: number;
+    /**
+     * Start index in the given Part, measured in bytes. Offset from the start of
+     * the Part, inclusive, starting at zero.
+     */
+    startIndex?: number;
+    /**
+     * The text corresponding to the segment from the response.
+     */
+    text?: string;
+};
+
+/**
+ * Configuration options for model generation and outputs. Not all parameters
+ * are configurable for every model.
+ */
+export type GenerationConfig = {
+    /**
+     * Optional. If true, export the logprobs results in response.
+     */
+    responseLogprobs?: boolean;
+    /**
+     * Optional. The maximum number of tokens to include in a response candidate.
+     *
+     * Note: The default value varies by model, see the `Model.output_token_limit`
+     * attribute of the `Model` returned from the `getModel` function.
+     */
+    maxOutputTokens?: number;
+    /**
+     * Optional. The maximum cumulative probability of tokens to consider when sampling.
+     *
+     * The model uses combined Top-k and Top-p (nucleus) sampling.
+     *
+     * Tokens are sorted based on their assigned probabilities so that only the
+     * most likely tokens are considered. Top-k sampling directly limits the
+     * maximum number of tokens to consider, while Nucleus sampling limits the
+     * number of tokens based on the cumulative probability.
+     *
+     * Note: The default value varies by `Model` and is specified by
+     * the`Model.top_p` attribute returned from the `getModel` function. An empty
+     * `top_k` attribute indicates that the model doesn't apply top-k sampling
+     * and doesn't allow setting `top_k` on requests.
+     */
+    topP?: number;
+    /**
+     * Optional. Seed used in decoding. If not set, the request uses a randomly generated
+     * seed.
+     */
+    seed?: number;
+    /**
+     * Optional. Frequency penalty applied to the next token's logprobs, multiplied by the
+     * number of times each token has been seen in the respponse so far.
+     *
+     * A positive penalty will discourage the use of tokens that have already
+     * been used, proportional to the number of times the token has been used:
+     * The more a token is used, the more difficult it is for the model to use
+     * that token again increasing the vocabulary of responses.
+     *
+     * Caution: A _negative_ penalty will encourage the model to reuse tokens
+     * proportional to the number of times the token has been used. Small
+     * negative values will reduce the vocabulary of a response. Larger negative
+     * values will cause the model to start repeating a common token  until it
+     * hits the max_output_tokens
+     * limit.
+     */
+    frequencyPenalty?: number;
+    /**
+     * Optional. The speech generation config.
+     */
+    speechConfig?: SpeechConfig;
+    /**
+     * Optional. Controls the randomness of the output.
+     *
+     * Note: The default value varies by model, see the `Model.temperature`
+     * attribute of the `Model` returned from the `getModel` function.
+     *
+     * Values can range from [0.0, 2.0].
+     */
+    temperature?: number;
+    /**
+     * Optional. MIME type of the generated candidate text.
+     * Supported MIME types are:
+     * `text/plain`: (default) Text output.
+     * `application/json`: JSON response in the response candidates.
+     * `text/x.enum`: ENUM as a string response in the response candidates.
+     * Refer to the
+     * [docs](https://ai.google.dev/gemini-api/docs/prompting_with_media#plain_text_formats)
+     * for a list of all supported text MIME types.
+     */
+    responseMimeType?: string;
+    /**
+     * Optional. An internal detail. Use `responseJsonSchema` rather than this field.
+     */
+    responseJsonSchema?: unknown;
+    /**
+     * Optional. Enables enhanced civic answers. It may not be available for all models.
+     */
+    enableEnhancedCivicAnswers?: boolean;
+    /**
+     * Optional. The maximum number of tokens to consider when sampling.
+     *
+     * Gemini models use Top-p (nucleus) sampling or a combination of Top-k and
+     * nucleus sampling. Top-k sampling considers the set of `top_k` most probable
+     * tokens. Models running with nucleus sampling don't allow top_k setting.
+     *
+     * Note: The default value varies by `Model` and is specified by
+     * the`Model.top_p` attribute returned from the `getModel` function. An empty
+     * `top_k` attribute indicates that the model doesn't apply top-k sampling
+     * and doesn't allow setting `top_k` on requests.
+     */
+    topK?: number;
+    /**
+     * Optional. If specified, the media resolution specified will be used.
+     */
+    mediaResolution?: 'MEDIA_RESOLUTION_UNSPECIFIED' | 'MEDIA_RESOLUTION_LOW' | 'MEDIA_RESOLUTION_MEDIUM' | 'MEDIA_RESOLUTION_HIGH';
+    /**
+     * Optional. Presence penalty applied to the next token's logprobs if the token has
+     * already been seen in the response.
+     *
+     * This penalty is binary on/off and not dependant on the number of times the
+     * token is used (after the first). Use
+     * frequency_penalty
+     * for a penalty that increases with each use.
+     *
+     * A positive penalty will discourage the use of tokens that have already
+     * been used in the response, increasing the vocabulary.
+     *
+     * A negative penalty will encourage the use of tokens that have already been
+     * used in the response, decreasing the vocabulary.
+     */
+    presencePenalty?: number;
+    /**
+     * Optional. Only valid if response_logprobs=True.
+     * This sets the number of top logprobs, including the chosen candidate, to
+     * return at each decoding step in the Candidate.logprobs_result. The
+     * number must be in the range of [0, 20].
+     */
+    logprobs?: number;
+    /**
+     * Optional. Config for image generation.
+     * An error will be returned if this field is set for models that don't
+     * support these config options.
+     */
+    imageConfig?: ImageConfig;
+    /**
+     * Optional. Output schema of the generated response. This is an alternative to
+     * `response_schema` that accepts [JSON Schema](https://json-schema.org/).
+     *
+     * If set, `response_schema` must be omitted, but `response_mime_type` is
+     * required.
+     *
+     * While the full JSON Schema may be sent, not all features are supported.
+     * Specifically, only the following properties are supported:
+     *
+     * - `$id`
+     * - `$defs`
+     * - `$ref`
+     * - `$anchor`
+     * - `type`
+     * - `format`
+     * - `title`
+     * - `description`
+     * - `enum` (for strings and numbers)
+     * - `items`
+     * - `prefixItems`
+     * - `minItems`
+     * - `maxItems`
+     * - `minimum`
+     * - `maximum`
+     * - `anyOf`
+     * - `oneOf` (interpreted the same as `anyOf`)
+     * - `properties`
+     * - `additionalProperties`
+     * - `required`
+     *
+     * The non-standard `propertyOrdering` property may also be set.
+     *
+     * Cyclic references are unrolled to a limited degree and, as such, may only
+     * be used within non-required properties. (Nullable properties are not
+     * sufficient.) If `$ref` is set on a sub-schema, no other properties, except
+     * for than those starting as a `$`, may be set.
+     */
+    _responseJsonSchema?: unknown;
+    /**
+     * Optional. Number of generated responses to return. If unset, this will default
+     * to 1. Please note that this doesn't work for previous generation
+     * models (Gemini 1.0 family)
+     */
+    candidateCount?: number;
+    /**
+     * Optional. The requested modalities of the response. Represents the set of modalities
+     * that the model can return, and should be expected in the response. This is
+     * an exact match to the modalities of the response.
+     *
+     * A model may have multiple combinations of supported modalities. If the
+     * requested modalities do not match any of the supported combinations, an
+     * error will be returned.
+     *
+     * An empty list is equivalent to requesting only text.
+     */
+    responseModalities?: Array<'MODALITY_UNSPECIFIED' | 'TEXT' | 'IMAGE' | 'AUDIO'>;
+    /**
+     * Optional. Config for thinking features.
+     * An error will be returned if this field is set for models that don't
+     * support thinking.
+     */
+    thinkingConfig?: ThinkingConfig;
+    /**
+     * Optional. Output schema of the generated candidate text. Schemas must be a
+     * subset of the [OpenAPI schema](https://spec.openapis.org/oas/v3.0.3#schema)
+     * and can be objects, primitives or arrays.
+     *
+     * If set, a compatible `response_mime_type` must also be set.
+     * Compatible MIME types:
+     * `application/json`: Schema for JSON response.
+     * Refer to the [JSON text generation
+     * guide](https://ai.google.dev/gemini-api/docs/json-mode) for more details.
+     */
+    responseSchema?: Schema;
+    /**
+     * Optional. The set of character sequences (up to 5) that will stop output generation.
+     * If specified, the API will stop at the first appearance of a
+     * `stop_sequence`. The stop sequence will not be included as part of the
+     * response.
+     */
+    stopSequences?: Array<string>;
+};
+
+/**
+ * A `Document` is a collection of `Chunk`s.
+ */
+export type Document = {
+    /**
+     * Immutable. Identifier. The `Document` resource name. The ID (name excluding the
+     * "fileSearchStores*documents/" prefix) can contain up to 40 characters
+     * that are lowercase alphanumeric or dashes (-). The ID cannot start or end
+     * with a dash. If the name is empty on create, a unique name will be derived
+     * from `display_name` along with a 12 character random suffix. Example:
+     * `fileSearchStores/{file_search_store_id}/documents/my-awesome-doc-123a456b789c`
+     */
+    name?: string;
+    /**
+     * Optional. The human-readable display name for the `Document`. The display name must
+     * be no more than 512 characters in length, including spaces.
+     * Example: "Semantic Retriever Documentation"
+     */
+    displayName?: string;
+    /**
+     * Output only. The Timestamp of when the `Document` was last updated.
+     */
+    readonly updateTime?: string;
+    /**
+     * Output only. The size of raw bytes ingested into the Document.
+     */
+    readonly sizeBytes?: string;
+    /**
+     * Output only. The mime type of the Document.
+     */
+    readonly mimeType?: string;
+    /**
+     * Optional. User provided custom metadata stored as key-value pairs used for querying.
+     * A `Document` can have a maximum of 20 `CustomMetadata`.
+     */
+    customMetadata?: Array<CustomMetadata>;
+    /**
+     * Output only. The Timestamp of when the `Document` was created.
+     */
+    readonly createTime?: string;
+    /**
+     * Output only. Current state of the `Document`.
+     */
+    state?: 'STATE_UNSPECIFIED' | 'STATE_PENDING' | 'STATE_ACTIVE' | 'STATE_FAILED';
+};
+
+/**
+ * Candidate for the logprobs token and score.
+ */
+export type LogprobsResultCandidate = {
+    /**
+     * The candidate's log probability.
+     */
+    logProbability?: number;
+    /**
+     * The candidate’s token string value.
+     */
+    token?: string;
+    /**
+     * The candidate’s token id value.
+     */
+    tokenId?: number;
+};
+
+/**
+ * Metadata for a video `File`.
+ */
+export type VideoFileMetadata = {
+    /**
+     * Duration of the video.
+     */
+    videoDuration?: string;
+};
+
+/**
+ * Response for `ListFiles`.
+ */
+export type ListFilesResponse = {
+    /**
+     * The list of `File`s.
+     */
+    files?: Array<File>;
+    /**
+     * A token that can be sent as a `page_token` into a subsequent `ListFiles`
+     * call.
+     */
+    nextPageToken?: string;
+};
+
+/**
+ * Counts the number of tokens in the `prompt` sent to a model.
+ *
+ * Models may tokenize text differently, so each model may return a different
+ * `token_count`.
+ */
+export type CountTokensRequest = {
+    /**
+     * Optional. The input given to the model as a prompt. This field is ignored when
+     * `generate_content_request` is set.
+     */
+    contents?: Array<Content>;
+    /**
+     * Optional. The overall input given to the `Model`. This includes the prompt as well as
+     * other model steering information like [system
+     * instructions](https://ai.google.dev/gemini-api/docs/system-instructions),
+     * and/or function declarations for [function
+     * calling](https://ai.google.dev/gemini-api/docs/function-calling).
+     * `Model`s/`Content`s and `generate_content_request`s are mutually
+     * exclusive. You can either send `Model` + `Content`s or a
+     * `generate_content_request`, but never both.
+     */
+    generateContentRequest?: GenerateContentRequest;
+};
+
+export type TaskType = 'TASK_TYPE_UNSPECIFIED' | 'RETRIEVAL_QUERY' | 'RETRIEVAL_DOCUMENT' | 'SEMANTIC_SIMILARITY' | 'CLASSIFICATION' | 'CLUSTERING' | 'QUESTION_ANSWERING' | 'FACT_VERIFICATION' | 'CODE_RETRIEVAL_QUERY';
+
+/**
+ * Passage included inline with a grounding configuration.
+ */
+export type GroundingPassage = {
+    /**
+     * Identifier for the passage for attributing this passage in grounded
+     * answers.
+     */
+    id?: string;
+    /**
+     * Content of the passage.
+     */
+    content?: Content;
+};
+
+/**
+ * A grounding chunk from Google Maps. A Maps chunk corresponds to a single
+ * place.
+ */
+export type Maps = {
+    /**
+     * Title of the place.
+     */
+    title?: string;
+    /**
+     * The ID of the place, in `places/{place_id}` format. A user can use this
+     * ID to look up that place.
+     */
+    placeId?: string;
+    /**
+     * Text description of the place answer.
+     */
+    text?: string;
+    /**
+     * URI reference of the place.
+     */
+    uri?: string;
+    /**
+     * Sources that provide answers about the features of a given place in
+     * Google Maps.
+     */
+    placeAnswerSources?: PlaceAnswerSources;
+};
+
+/**
+ * Information about a Generative Language Model.
+ */
+export type Model = {
+    /**
+     * Required. The resource name of the `Model`. Refer to [Model
+     * variants](https://ai.google.dev/gemini-api/docs/models/gemini#model-variations)
+     * for all allowed values.
+     *
+     * Format: `models/{model}` with a `{model}` naming convention of:
+     *
+     * * "{base_model_id}-{version}"
+     *
+     * Examples:
+     *
+     * * `models/gemini-1.5-flash-001`
+     */
+    name: string;
+    /**
+     * Required. The version number of the model.
+     *
+     * This represents the major version (`1.0` or `1.5`)
+     */
+    version: string;
+    /**
+     * The model's supported generation methods.
+     *
+     * The corresponding API method names are defined as Pascal case
+     * strings, such as `generateMessage` and `generateContent`.
+     */
+    supportedGenerationMethods?: Array<string>;
+    /**
+     * The maximum temperature this model can use.
+     */
+    maxTemperature?: number;
+    /**
+     * For Top-k sampling.
+     *
+     * Top-k sampling considers the set of `top_k` most probable tokens.
+     * This value specifies default to be used by the backend while making the
+     * call to the model.
+     * If empty, indicates the model doesn't use top-k sampling, and `top_k` isn't
+     * allowed as a generation parameter.
+     */
+    topK?: number;
+    /**
+     * Maximum number of input tokens allowed for this model.
+     */
+    inputTokenLimit?: number;
+    /**
+     * Whether the model supports thinking.
+     */
+    thinking?: boolean;
+    /**
+     * The human-readable name of the model. E.g. "Gemini 1.5 Flash".
+     *
+     * The name can be up to 128 characters long and can consist of any UTF-8
+     * characters.
+     */
+    displayName?: string;
+    /**
+     * Controls the randomness of the output.
+     *
+     * Values can range over `[0.0,max_temperature]`, inclusive. A higher value
+     * will produce responses that are more varied, while a value closer to `0.0`
+     * will typically result in less surprising responses from the model.
+     * This value specifies default to be used by the backend while making the
+     * call to the model.
+     */
+    temperature?: number;
+    /**
+     * A short description of the model.
+     */
+    description?: string;
+    /**
+     * For [Nucleus
+     * sampling](https://ai.google.dev/gemini-api/docs/prompting-strategies#top-p).
+     *
+     * Nucleus sampling considers the smallest set of tokens whose probability
+     * sum is at least `top_p`.
+     * This value specifies default to be used by the backend while making the
+     * call to the model.
+     */
+    topP?: number;
+    /**
+     * Maximum number of output tokens available for this model.
+     */
+    outputTokenLimit?: number;
+};
+
+/**
+ * User provided metadata about the GroundingFact.
+ */
+export type GroundingChunkCustomMetadata = {
+    /**
+     * Optional. A list of string values for the metadata.
+     */
+    stringListValue?: GroundingChunkStringList;
+    /**
+     * Optional. The numeric value of the metadata.
+     * The expected range for this value depends on the specific `key` used.
+     */
+    numericValue?: number;
+    /**
+     * The key of the metadata.
+     */
+    key?: string;
+    /**
+     * Optional. The string value of the metadata.
+     */
+    stringValue?: string;
+};
+
+/**
+ * Tuned model as a source for training a new model.
+ */
+export type TunedModelSource = {
+    /**
+     * Immutable. The name of the `TunedModel` to use as the starting point for
+     * training the new model.
+     * Example: `tunedModels/my-tuned-model`
+     */
+    tunedModel?: string;
+    /**
+     * Output only. The name of the base `Model` this `TunedModel` was tuned from.
+     * Example: `models/gemini-1.5-flash-001`
+     */
+    readonly baseModel?: string;
+};
+
+/**
+ * A list of floats representing the embedding.
+ */
+export type Embedding = {
+    /**
+     * The embedding values.
+     */
+    value?: Array<number>;
+};
+
+/**
+ * Request for an `AsyncBatchEmbedContent` operation.
+ */
+export type AsyncBatchEmbedContentRequest = {
+    /**
+     * Required. The batch to create.
+     */
+    batch: EmbedContentBatch;
+};
+
+/**
+ * Request to get a text embedding from the model.
+ */
+export type EmbedTextRequest = {
+    /**
+     * Required. The model name to use with the format model=models/{model}.
+     */
+    model: string;
+    /**
+     * Optional. The free-form input text that the model will turn into an embedding.
+     */
+    text?: string;
+};
+
+/**
+ * Context of the a single url retrieval.
+ */
+export type UrlMetadata = {
+    /**
+     * Retrieved url by the tool.
+     */
+    retrievedUrl?: string;
+    /**
+     * Status of the url retrieval.
+     */
+    urlRetrievalStatus?: 'URL_RETRIEVAL_STATUS_UNSPECIFIED' | 'URL_RETRIEVAL_STATUS_SUCCESS' | 'URL_RETRIEVAL_STATUS_ERROR' | 'URL_RETRIEVAL_STATUS_PAYWALL' | 'URL_RETRIEVAL_STATUS_UNSAFE';
+};
+
+/**
+ * Image search for grounding and related configurations.
+ */
+export type ImageSearch = {
+    [key: string]: unknown;
+};
+
+/**
+ * Metadata for LongRunning ImportFile Operations.
+ */
+export type ImportFileMetadata = {
+    [key: string]: unknown;
+};
+
+/**
+ * Response for a `BatchGenerateContent` operation.
+ */
+export type BatchGenerateContentResponse = {
+    /**
+     * Output only. The output of the batch request.
+     */
+    output?: GenerateContentBatchOutput;
+};
+
+/**
+ * The base unit of structured text.
+ *
+ * A `Message` includes an `author` and the `content` of
+ * the `Message`.
+ *
+ * The `author` is used to tag messages when they are fed to the
+ * model as text.
+ */
+export type Message = {
+    /**
+     * Output only. Citation information for model-generated `content` in this `Message`.
+     *
+     * If this `Message` was generated as output from the model, this field may be
+     * populated with attribution information for any text included in the
+     * `content`. This field is used only on output.
+     */
+    citationMetadata?: CitationMetadata;
+    /**
+     * Optional. The author of this Message.
+     *
+     * This serves as a key for tagging
+     * the content of this Message when it is fed to the model as text.
+     *
+     * The author can be any alphanumeric string.
+     */
+    author?: string;
+    /**
+     * Required. The text content of the structured `Message`.
+     */
+    content: string;
+};
+
+/**
+ * This resource represents a long-running operation that is the result of a
+ * network API call.
+ */
+export type Operation = BaseOperation & {
+    /**
+     * Service-specific metadata associated with the operation.  It typically
+     * contains progress information and common metadata such as create time.
+     * Some services might not provide such metadata.  Any method that returns a
+     * long-running operation should document the metadata type, if any.
+     */
+    metadata?: {};
+    /**
+     * The normal, successful response of the operation.  If the original
+     * method returns no data on success, such as `Delete`, the response is
+     * `google.protobuf.Empty`.  If the original method is standard
+     * `Get`/`Create`/`Update`, the response should be the resource.  For other
+     * methods, the response should have the type `XxxResponse`, where `Xxx`
+     * is the original method name.  For example, if the original method name
+     * is `TakeSnapshot()`, the inferred response type is
+     * `TakeSnapshotResponse`.
+     */
+    response?: {};
+};
+
+/**
+ * Tool to retrieve public web data for grounding, powered by Google.
+ */
+export type GoogleSearchRetrieval = {
+    /**
+     * Specifies the dynamic retrieval configuration for the given source.
+     */
+    dynamicRetrievalConfig?: DynamicRetrievalConfig;
+};
+
+/**
+ * Config for speech generation and transcription.
+ */
+export type SpeechConfig = {
+    /**
+     * Optional. The IETF [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language
+     * code that the user configured the app to use. Used for speech recognition
+     * and synthesis.
+     *
+     * Valid values are: `de-DE`, `en-AU`, `en-GB`, `en-IN`, `en-US`, `es-US`,
+     * `fr-FR`, `hi-IN`, `pt-BR`, `ar-XA`, `es-ES`, `fr-CA`, `id-ID`, `it-IT`,
+     * `ja-JP`, `tr-TR`, `vi-VN`, `bn-IN`, `gu-IN`, `kn-IN`, `ml-IN`, `mr-IN`,
+     * `ta-IN`, `te-IN`, `nl-NL`, `ko-KR`, `cmn-CN`, `pl-PL`, `ru-RU`, and
+     * `th-TH`.
+     */
+    languageCode?: string;
+    /**
+     * Optional. The configuration for the multi-speaker setup.
+     * It is mutually exclusive with the voice_config field.
+     */
+    multiSpeakerVoiceConfig?: MultiSpeakerVoiceConfig;
+    /**
+     * The configuration in case of single-voice output.
+     */
+    voiceConfig?: VoiceConfig;
+};
+
+/**
+ * Request for `RegisterFiles`.
+ */
+export type RegisterFilesRequest = {
+    /**
+     * Required. The Google Cloud Storage URIs to register. Example: `gs://bucket/object`.
+     */
+    uris: Array<string>;
+};
+
+/**
+ * The result output from a `FunctionCall` that contains a string
+ * representing the `FunctionDeclaration.name` and a structured JSON
+ * object containing any output from the function is used as context to
+ * the model. This should contain the result of a`FunctionCall` made
+ * based on model prediction.
+ */
+export type FunctionResponse = {
+    /**
+     * Required. The function response in JSON object format.
+     * Callers can use any keys of their choice that fit the function's syntax
+     * to return the function output, e.g. "output", "result", etc.
+     * In particular, if the function call failed to execute, the response can
+     * have an "error" key to return error details to the model.
+     */
+    response: {};
+    /**
+     * Optional. The identifier of the function call this response is for. Populated by the
+     * client to match the corresponding function call `id`.
+     */
+    id?: string;
+    /**
+     * Optional. Ordered `Parts` that constitute a function response. Parts may have
+     * different IANA MIME types.
+     */
+    parts?: Array<FunctionResponsePart>;
+    /**
+     * Optional. Specifies how the response should be scheduled in the conversation.
+     * Only applicable to NON_BLOCKING function calls, is ignored otherwise.
+     * Defaults to WHEN_IDLE.
+     */
+    scheduling?: 'SCHEDULING_UNSPECIFIED' | 'SILENT' | 'WHEN_IDLE' | 'INTERRUPT';
+    /**
+     * Required. The name of the function to call.
+     * Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum
+     * length of 128.
+     */
+    name: string;
+    /**
+     * Optional. Signals that function call continues, and more responses will be
+     * returned, turning the function call into a generator.
+     * Is only applicable to NON_BLOCKING function calls, is ignored otherwise.
+     * If set to false, future responses will not be considered.
+     * It is allowed to return empty `response` with `will_continue=False` to
+     * signal that the function call is finished. This may still trigger the model
+     * generation. To avoid triggering the generation and finish the function
+     * call, additionally set `scheduling` to `SILENT`.
+     */
+    willContinue?: boolean;
+};
+
+/**
+ * Code generated by the model that is meant to be executed, and the result
+ * returned to the model.
+ *
+ * Only generated when using the `CodeExecution` tool, in which the code will
+ * be automatically executed, and a corresponding `CodeExecutionResult` will
+ * also be generated.
+ */
+export type ExecutableCode = {
+    /**
+     * Required. Programming language of the `code`.
+     */
+    language: 'LANGUAGE_UNSPECIFIED' | 'PYTHON';
+    /**
+     * Required. The code to be executed.
+     */
+    code: string;
+    /**
+     * Optional. Unique identifier of the `ExecutableCode` part.
+     * The server returns the `CodeExecutionResult` with the matching `id`.
+     */
+    id?: string;
+};
+
+/**
+ * Configures the input to the batch request.
+ */
+export type InputConfig = {
+    /**
+     * The name of the `File` containing the input requests.
+     */
+    fileName?: string;
+    /**
+     * The requests to be processed in the batch.
+     */
+    requests?: InlinedRequests;
+};
+
+/**
+ * The base structured datatype containing multi-part content of a message.
+ *
+ * A `Content` includes a `role` field designating the producer of the `Content`
+ * and a `parts` field containing multi-part data that contains the content of
+ * the message turn.
+ */
+export type Content = {
+    /**
+     * Ordered `Parts` that constitute a single message. Parts may have different
+     * MIME types.
+     */
+    parts?: Array<Part>;
+    /**
+     * Optional. The producer of the content. Must be either 'user' or 'model'.
+     *
+     * Useful to set for multi-turn conversations, otherwise can be left blank
+     * or unset.
+     */
+    role?: string;
+};
+
+/**
+ * Raw media bytes for function response.
+ *
+ * Text should not be sent as raw bytes, use the 'FunctionResponse.response'
+ * field.
+ */
+export type FunctionResponseBlob = {
+    /**
+     * The IANA standard MIME type of the source data.
+     * Examples:
+     * - image/png
+     * - image/jpeg
+     * If an unsupported MIME type is provided, an error will be returned. For a
+     * complete list of supported types, see [Supported file
+     * formats](https://ai.google.dev/gemini-api/docs/prompting_with_media#supported_file_formats).
+     */
+    mimeType?: string;
+    /**
+     * Raw bytes for media formats.
+     */
+    data?: string;
+};
+
+/**
+ * Stub for ToolType (missing in upstream spec)
+ */
+export type ToolType = string;
+
+/**
+ * Stub for MediaResolution (missing in upstream spec)
+ */
+export type MediaResolution = string;
+
+/**
+ * V1 error format.
+ */
+export type Xgafv = '1' | '2';
+
+/**
+ * Data format for response.
+ */
+export type Alt = 'json' | 'media' | 'proto';
+
+/**
+ * JSONP
+ */
+export type Callback = string;
+
+/**
+ * Returns response with indentations and line breaks.
+ */
+export type PrettyPrint = boolean;
+
+export type ListModelsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Data format for response.
+         */
+        $alt?: 'json' | 'media' | 'proto';
+        /**
+         * JSONP
+         */
+        $callback?: string;
+        /**
+         * Returns response with indentations and line breaks.
+         */
+        $prettyPrint?: boolean;
+        /**
+         * V1 error format.
+         */
+        '$.xgafv'?: '1' | '2';
+        /**
+         * The maximum number of `Models` to return (per page).
+         *
+         * If unspecified, 50 models will be returned per page.
+         * This method returns at most 1000 models per page, even if you pass a larger
+         * page_size.
+         */
+        pageSize?: number;
+        /**
+         * A page token, received from a previous `ListModels` call.
+         *
+         * Provide the `page_token` returned by one request as an argument to the next
+         * request to retrieve the next page.
+         *
+         * When paginating, all other parameters provided to `ListModels` must match
+         * the call that provided the page token.
+         */
+        pageToken?: string;
+    };
+    url: '/v1beta/models';
+};
+
+export type ListModelsResponses = {
+    /**
+     * Successful operation
+     */
+    default: ListModelsResponse;
+};
+
+export type ListModelsResponse2 = ListModelsResponses[keyof ListModelsResponses];
+
+export type GenerateContentData = {
+    /**
+     * The request body.
+     */
+    body?: GenerateContentRequest;
+    path: {
+        /**
+         * Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.
+         */
+        model: string;
+    };
+    query?: {
+        /**
+         * Data format for response.
+         */
+        $alt?: 'json' | 'media' | 'proto';
+        /**
+         * JSONP
+         */
+        $callback?: string;
+        /**
+         * Returns response with indentations and line breaks.
+         */
+        $prettyPrint?: boolean;
+        /**
+         * V1 error format.
+         */
+        '$.xgafv'?: '1' | '2';
+    };
+    url: '/v1beta/models/{model}:generateContent';
+};
+
+export type GenerateContentResponses = {
+    /**
+     * Successful operation
+     */
+    default: GenerateContentResponse;
+};
+
+export type GenerateContentResponse2 = GenerateContentResponses[keyof GenerateContentResponses];
+
+export type EmbedContentData = {
+    /**
+     * The request body.
+     */
+    body?: EmbedContentRequest;
+    path: {
+        /**
+         * Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.
+         */
+        model: string;
+    };
+    query?: {
+        /**
+         * Data format for response.
+         */
+        $alt?: 'json' | 'media' | 'proto';
+        /**
+         * JSONP
+         */
+        $callback?: string;
+        /**
+         * Returns response with indentations and line breaks.
+         */
+        $prettyPrint?: boolean;
+        /**
+         * V1 error format.
+         */
+        '$.xgafv'?: '1' | '2';
+    };
+    url: '/v1beta/models/{model}:embedContent';
+};
+
+export type EmbedContentResponses = {
+    /**
+     * Successful operation
+     */
+    default: EmbedContentResponse;
+};
+
+export type EmbedContentResponse2 = EmbedContentResponses[keyof EmbedContentResponses];
+
+export type StreamGenerateContentData = {
+    /**
+     * The request body.
+     */
+    body?: GenerateContentRequest;
+    path: {
+        /**
+         * Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.
+         */
+        model: string;
+    };
+    query?: {
+        /**
+         * Data format for response.
+         */
+        $alt?: 'json' | 'media' | 'proto';
+        /**
+         * JSONP
+         */
+        $callback?: string;
+        /**
+         * Returns response with indentations and line breaks.
+         */
+        $prettyPrint?: boolean;
+        /**
+         * V1 error format.
+         */
+        '$.xgafv'?: '1' | '2';
+    };
+    url: '/v1beta/models/{model}:streamGenerateContent';
+};
+
+export type StreamGenerateContentResponses = {
+    /**
+     * Successful operation
+     */
+    default: GenerateContentResponse;
+};
+
+export type StreamGenerateContentResponse = StreamGenerateContentResponses[keyof StreamGenerateContentResponses];
+
+export type GetModelData = {
+    body?: never;
+    path: {
+        /**
+         * Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.
+         */
+        model: string;
+    };
+    query?: {
+        /**
+         * Data format for response.
+         */
+        $alt?: 'json' | 'media' | 'proto';
+        /**
+         * JSONP
+         */
+        $callback?: string;
+        /**
+         * Returns response with indentations and line breaks.
+         */
+        $prettyPrint?: boolean;
+        /**
+         * V1 error format.
+         */
+        '$.xgafv'?: '1' | '2';
+    };
+    url: '/v1beta/models/{model}';
+};
+
+export type GetModelResponses = {
+    /**
+     * Successful operation
+     */
+    default: Model;
+};
+
+export type GetModelResponse = GetModelResponses[keyof GetModelResponses];
+
+export type ClientOptions = {
+    baseUrl: 'https://generativelanguage.googleapis.com' | (string & {});
+};