@google/genai 2.6.0 → 2.8.0

package/dist/genai.d.ts

@@ -875,6 +875,32 @@ export declare interface AutomaticFunctionCallingConfig {
     ignoreCallHistory?: boolean;
 }
 
+/** Autorater config used for evaluation. */
+export declare interface AutoraterConfig {
+    /** Number of samples for each instance in the dataset.
+     If not specified, the default is 4. Minimum value is 1, maximum value
+     is 32. */
+    samplingCount?: number;
+    /** Optional. Default is true. Whether to flip the candidate and baseline
+     responses. This is only applicable to the pairwise metric. If enabled, also
+     provide PairwiseMetricSpec.candidate_response_field_name and
+     PairwiseMetricSpec.baseline_response_field_name. When rendering
+     PairwiseMetricSpec.metric_prompt_template, the candidate and baseline
+     fields will be flipped for half of the samples to reduce bias. */
+    flipEnabled?: boolean;
+    /** The fully qualified name of the publisher model or tuned autorater
+     endpoint to use.
+
+     Publisher model format:
+     `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`
+
+     Tuned model endpoint format:
+     `projects/{project}/locations/{location}/endpoints/{endpoint}` */
+    autoraterModel?: string;
+    /** Configuration options for model generation and outputs. */
+    generationConfig?: GenerationConfig;
+}
+
 /** Configures the avatar to be used in the session. */
 export declare interface AvatarConfig {
     /** Pre-built avatar id. */
@@ -2124,6 +2150,18 @@ export declare interface CompletionStats {
     successfulForecastPointCount?: string;
 }
 
+/** Composite reinforcement tuning reward config. */
+export declare interface CompositeReinforcementTuningRewardConfig {
+    weightedRewardConfigs?: CompositeReinforcementTuningRewardConfigWeightedRewardConfig[];
+}
+
+/** Composite reinforcement tuning reward config weighted reward config. */
+export declare interface CompositeReinforcementTuningRewardConfigWeightedRewardConfig {
+    rewardConfig?: SingleReinforcementTuningRewardConfig;
+    /** How much this single reward contributes to the total overall reward. */
+    weight?: number;
+}
+
 /** Tool to support computer use. */
 export declare interface ComputerUse {
     /** Required. The environment being operated. */
@@ -2672,7 +2710,7 @@ export declare interface CreateTuningJobConfig {
      be charged usage for any applicable operations.
      */
     abortSignal?: AbortSignal;
-    /** The method to use for tuning (SUPERVISED_FINE_TUNING or PREFERENCE_TUNING or DISTILLATION). If not set, the default method (SFT) will be used. */
+    /** The method to use for tuning (SUPERVISED_FINE_TUNING or PREFERENCE_TUNING or DISTILLATION or REINFORCEMENT_TUNING). If not set, the default method (SFT) will be used. */
     method?: TuningMethod;
     /** Validation dataset for tuning. The dataset must be formatted as a JSONL file. */
     validationDataset?: TuningValidationDataset;
@@ -2712,6 +2750,22 @@ export declare interface CreateTuningJobConfig {
     outputUri?: string;
     /** The encryption spec of the tuning job. Customer-managed encryption key options for a TuningJob. If this is set, then all resources created by the TuningJob will be encrypted with provided encryption key. */
     encryptionSpec?: EncryptionSpec;
+    /** Reward function configuration for reinforcement tuning. Reinforcement tuning only. */
+    rewardConfig?: SingleReinforcementTuningRewardConfig;
+    /** Composite reward function configuration for reinforcement tuning. Reinforcement tuning only. */
+    compositeRewardConfig?: CompositeReinforcementTuningRewardConfig;
+    /** Number of different responses to generate per prompt during tuning. Reinforcement tuning only. */
+    samplesPerPrompt?: number;
+    /** How often at steps to evaluate the tuning job during training. Reinforcement tuning only. */
+    evaluateInterval?: number;
+    /** How often at steps to save checkpoints during training. Reinforcement tuning only. */
+    checkpointInterval?: number;
+    /** The maximum number of tokens to generate per prompt. Reinforcement tuning only. */
+    maxOutputTokens?: number;
+    /** Indicates the maximum thinking depth. Use with earlier models shall result in error. Reinforcement tuning only. */
+    thinkingLevel?: ReinforcementTuningThinkingLevel;
+    /** Cloud Storage path to file containing validation dataset for tuning. The dataset must be formatted as a JSONL file. If no validation dataset is provided, by default the API splits 25% of the training dataset or 50 examples, whichever is larger, as the validation dataset. Reinforcement tuning only. */
+    validationDatasetUri?: string;
 }
 
 /** Fine-tuning job creation parameters - optional fields. */
@@ -2840,6 +2894,10 @@ declare interface DeepResearchAgentConfig {
      * will then proceed only if the user confirms the plan in the next turn.
      */
     collaborative_planning?: boolean;
+    /**
+     * Enables bigquery tool for the Deep Research agent.
+     */
+    enable_bigquery_tool?: boolean;
     /**
      * Whether to include thought summaries in the response.
      */
@@ -3119,7 +3177,7 @@ declare interface DocumentContent {
     /**
      * The mime type of the document.
      */
-    mime_type?: 'application/pdf';
+    mime_type?: 'application/pdf' | 'text/csv';
     /**
      * The URI of the document.
      */
@@ -3621,6 +3679,10 @@ declare interface ErrorEvent_2 {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: ErrorEvent_2.Metadata;
 }
 
 declare namespace ErrorEvent_2 {
@@ -3637,6 +3699,15 @@ declare namespace ErrorEvent_2 {
          */
         message?: string;
     }
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare namespace Errors {
@@ -4293,10 +4364,9 @@ declare interface Function_2 {
     parameters?: unknown;
 }
 
-/** A function call. */
+/** A predicted FunctionCall returned from the model that contains a string representing the FunctionDeclaration.name and a structured JSON object containing the parameters and their values. */
 export declare interface FunctionCall {
-    /** The unique id of the function call. If populated, the client to execute the
-     `function_call` and return the response with the matching `id`. */
+    /** Optional. The unique id of the function call. If populated, the client to execute the `function_call` and return the response with the matching `id`. */
     id?: string;
     /** Optional. The function parameters and values in JSON object format. See FunctionDeclaration.parameters for parameter details. */
     args?: Record<string, unknown>;
@@ -4385,14 +4455,13 @@ export declare interface FunctionDeclaration {
     behavior?: Behavior;
 }
 
-/** A function response. */
+/** 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 declare class FunctionResponse {
-    /** 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 (see FunctionDeclaration.behavior for details), ignored otherwise. If false, the default, future responses will not be considered. 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. */
+    /** 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`. This field is not supported in Vertex AI. */
     willContinue?: boolean;
-    /** Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. */
+    /** 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?: FunctionResponseScheduling;
-    /** List of parts that constitute a function response. Each part may
-     have a different IANA MIME type. */
+    /** Optional. Ordered `Parts` that constitute a function response. Parts may have different IANA MIME types. */
     parts?: FunctionResponsePart[];
     /** Optional. The id of the function call this response is for. Populated by the client to match the corresponding function call `id`. */
     id?: string;
@@ -4402,49 +4471,36 @@ export declare class FunctionResponse {
     response?: Record<string, unknown>;
 }
 
-/** Raw media bytes for function response.
-
- Text should not be sent as raw bytes, use the FunctionResponse.response
- field. */
+/** Raw media bytes for function response. Text should not be sent as raw bytes, use the 'text' field. */
 export declare class FunctionResponseBlob {
     /** Required. The IANA standard MIME type of the source data. */
     mimeType?: string;
-    /** Required. Inline media bytes.
+    /** Required. Raw bytes.
      * @remarks Encoded as base64 string. */
     data?: string;
-    /** Optional. Display name of the blob.
-     Used to provide a label or filename to distinguish blobs. */
+    /** Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. This field is not supported in Gemini API. */
     displayName?: string;
 }
 
-/** URI based data for function response. */
+/** URI based data for function response. This data type is not supported in Gemini API. */
 export declare class FunctionResponseFileData {
     /** Required. URI. */
     fileUri?: string;
     /** Required. The IANA standard MIME type of the source data. */
     mimeType?: string;
-    /** Optional. Display name of the file.
-     Used to provide a label or filename to distinguish files. */
+    /** Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. */
     displayName?: string;
 }
 
-/** 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. */
+/** 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 declare class FunctionResponsePart {
-    /** Optional. Inline media bytes. */
+    /** Inline media bytes. */
     inlineData?: FunctionResponseBlob;
-    /** Optional. URI based data. */
+    /** URI based data. This field is not supported in Gemini API. */
     fileData?: FunctionResponseFileData;
 }
 
-/** Specifies how the response should be scheduled in the conversation. */
+/** Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. */
 export declare enum FunctionResponseScheduling {
     /**
      * This value is unused.
@@ -5569,7 +5625,7 @@ export declare interface GoogleGenAIOptions {
 export declare interface GoogleMaps {
     /** The authentication config to access the API. Only API key is supported. This field is not supported in Gemini API. */
     authConfig?: AuthConfig;
-    /** 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. */
+    /** Deprecated. The Google Maps contextual widget behavior in Grounding with Google Maps is being deprecated; this field is planned for removal and no longer has any effect once removed. Optional. Whether to return a widget context token in the GroundingMetadata of the response. */
     enableWidget?: boolean;
 }
 
@@ -6713,6 +6769,22 @@ declare interface InteractionCompletedEvent {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: InteractionCompletedEvent.Metadata;
+}
+
+declare namespace InteractionCompletedEvent {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare interface InteractionCreatedEvent {
@@ -6725,6 +6797,22 @@ declare interface InteractionCreatedEvent {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: InteractionCreatedEvent.Metadata;
+}
+
+declare namespace InteractionCreatedEvent {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare type InteractionCreateParams = CreateModelInteractionParamsNonStreaming | CreateModelInteractionParamsStreaming | CreateAgentInteractionParamsNonStreaming | CreateAgentInteractionParamsStreaming;
@@ -6883,6 +6971,22 @@ declare interface InteractionStatusUpdate {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: InteractionStatusUpdate.Metadata;
+}
+
+declare namespace InteractionStatusUpdate {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 /** Parameters for the private _Register method. */
@@ -6978,16 +7082,11 @@ export declare enum Language {
     PYTHON = "PYTHON"
 }
 
-/** 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
- <a href="https://en.wikipedia.org/wiki/World_Geodetic_System#1984_version">
- WGS84 standard</a>. Values must be within normalized ranges. */
+/** 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 declare interface 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] */
+    /** The longitude in degrees. It must be in the range [-180.0, +180.0]. */
     longitude?: number;
 }
 
@@ -7515,8 +7614,8 @@ export declare interface LiveConnectConfig {
      response.
      */
     safetySettings?: SafetySetting[];
-    /** Config for stream translation. */
-    streamTranslationConfig?: StreamTranslationConfig;
+    /** Config for translation. */
+    translationConfig?: TranslationConfig;
 }
 
 /** Config for LiveConnectConstraints for Auth Token creation. */
@@ -8069,6 +8168,26 @@ export declare enum MaskReferenceMode {
     MASK_MODE_SEMANTIC = "MASK_MODE_SEMANTIC"
 }
 
+/** Match operation to use for evaluation. */
+export declare enum MatchOperation {
+    /**
+     * Default value. This value is unused.
+     */
+    MATCH_OPERATION_UNSPECIFIED = "MATCH_OPERATION_UNSPECIFIED",
+    /**
+     * Equivalent to GoogleSQL `REGEX_CONTAINS(target, expression)`.
+     */
+    REGEX_CONTAINS = "REGEX_CONTAINS",
+    /**
+     * `expression` is a substring of target.
+     */
+    PARTIAL_MATCH = "PARTIAL_MATCH",
+    /**
+     * `expression` is an exact match of target.
+     */
+    EXACT_MATCH = "EXACT_MATCH"
+}
+
 /** 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: 6. This data type is not supported in Vertex AI. */
 export declare interface McpServer {
     /** The name of the MCPServer. */
@@ -8914,7 +9033,8 @@ export declare enum PagedItem {
     PAGED_ITEM_FILES = "files",
     PAGED_ITEM_CACHED_CONTENTS = "cachedContents",
     PAGED_ITEM_FILE_SEARCH_STORES = "fileSearchStores",
-    PAGED_ITEM_DOCUMENTS = "documents"
+    PAGED_ITEM_DOCUMENTS = "documents",
+    PAGED_ITEM_SKILLS = "skills"
 }
 
 declare interface PagedItemConfig {
@@ -8935,6 +9055,7 @@ declare interface PagedItemResponse<T> {
     cachedContents?: T[];
     fileSearchStores?: T[];
     documents?: T[];
+    skills?: T[];
 }
 
 /**
@@ -9616,6 +9737,151 @@ export declare class RegisterFilesResponse {
     files?: File_2[];
 }
 
+/** Reinforcement tuning autorater scorer. */
+export declare interface ReinforcementTuningAutoraterScorer {
+    /** Autorater config for evaluation. */
+    autoraterConfig?: AutoraterConfig;
+    /** Allows substituting `prompt`, `response`, `system_instruction` and `references.reference` (each wrapped in double curly braces) into the autorater prompt. */
+    autoraterPrompt?: string;
+    /** Parses autorater returned response. */
+    autoraterResponseParseConfig?: ReinforcementTuningParseResponseConfig;
+    /** Scores autorater responses by directly converting parsed autorater response to float reward. */
+    parsedResponseConversionScorer?: ReinforcementTuningAutoraterScorerParsedResponseConversionScorer;
+    /** Scores autorater responses by using exact string match reward scorer. */
+    exactMatchScorer?: ReinforcementTuningAutoraterScorerExactMatchScorer;
+}
+
+/** Scores autorater responses by using exact string match reward scorer. */
+export declare interface ReinforcementTuningAutoraterScorerExactMatchScorer {
+    /** Assigns this reward score if parsed response string equals the expression. */
+    correctAnswerReward?: number;
+    /** Assigns this reward score if parsed reward value does not equal the expression. */
+    wrongAnswerReward?: number;
+    /** The string expression to match against. Supports substitution in the format of `references.reference` (wrapped in double curly braces) before matching. No regex support. */
+    expression?: string;
+}
+
+/** Scores responses by directly converting parsed autorater response to float reward (reward is clipped to be within [-1, 1]). */
+export declare class ReinforcementTuningAutoraterScorerParsedResponseConversionScorer {
+}
+
+/** Scores parsed responses by calling a Cloud Run service. */
+export declare interface ReinforcementTuningCloudRunRewardScorer {
+    /** URI of the Cloud Run service that will be used to compute the reward. The Vertex AI Secure Fine Tuning Service Agent (`service-PROJECT_NUMBER@gcp-sa-vertex-tune.iam.gserviceaccount.com`, where `PROJECT_NUMBER` is the numeric project number) must be granted the permission (e.g. by granting `roles/run.invoker` in IAM) to invoke the Cloud Run service. */
+    cloudRunUri?: string;
+}
+
+/** Scores parsed responses for code execution use cases. */
+export declare interface ReinforcementTuningCodeExecutionRewardScorer {
+    /** Example python code snippet which assigns reward of 1 to answer matching user provided reference answer in per prompt references map. */
+    pythonCodeSnippet?: string;
+}
+
+/** User-facing format for Gemini Reinforcement Tuning examples on Vertex. */
+export declare interface ReinforcementTuningExample {
+    /** Multi-turn contents that represents the Prompt. */
+    contents?: Content[];
+    /** References for the given prompt. The key is the name of the reference, and the value is the reference itself. */
+    references?: Record<string, string>;
+    /** Corresponds to `system_instruction` in user-facing GenerateContentRequest. */
+    systemInstruction?: Content;
+}
+
+/** Hyperparameters for Reinforcement Tuning. */
+export declare interface ReinforcementTuningHyperParameters {
+    /** Number of training epochs for the tuning job. */
+    epochCount?: string;
+    /** Learning rate multiplier for Reinforcement Learning. */
+    learningRateMultiplier?: number;
+    /** Adapter size for Reinforcement Tuning. */
+    adapterSize?: AdapterSize;
+    /** Number of different responses to generate per prompt during tuning. */
+    samplesPerPrompt?: number;
+    /** Batch size for the tuning job. How many prompts to process at a train step. If not set, the batch size will be determined automatically. */
+    batchSize?: number;
+    /** How often (in steps) to evaluate the tuning job during training. If not set, evaluation will run per epoch. */
+    evaluateInterval?: number;
+    /** How often (in steps) to save checkpoints during training. If not set, one checkpoint per epoch will be saved. */
+    checkpointInterval?: number;
+    /** The maximum number of tokens to generate per prompt. If not set, defaults to 32768. */
+    maxOutputTokens?: number;
+    /** Indicates the maximum thinking depth. Use with earlier models shall result in error. */
+    thinkingLevel?: ReinforcementTuningThinkingLevel;
+}
+
+/** Defines how to parse sample response for reinforcement tuning. */
+export declare class ReinforcementTuningParseResponseConfig {
+    /** Defines how to parse sample response. */
+    parseType?: ResponseParseType;
+    /** Defines the regex to extract the important part of sample response. This field is only used when `parse_type` is `REGEX_EXTRACT`. */
+    regexExtractExpression?: string;
+}
+
+/** The reward info for a reward function. */
+export declare interface ReinforcementTuningRewardInfo {
+    /** Output only. The calculated reward for the reward function. */
+    reward?: number;
+    /** Output only. The user-requested auxiliary info for the reward function. */
+    userRequestedAuxInfo?: string;
+}
+
+/** Reinforcement tuning spec for tuning. */
+export declare interface ReinforcementTuningSpec {
+    compositeRewardConfig?: CompositeReinforcementTuningRewardConfig;
+    /** Cloud Storage path to file containing training dataset for tuning. The dataset must be formatted as a JSONL file. */
+    trainingDatasetUri?: string;
+    /** Cloud Storage path to file containing validation dataset for tuning. The dataset must be formatted as a JSONL file. If no validation dataset is provided, by default the API splits 25% of the training dataset or 50 examples, whichever is larger, as the validation dataset. */
+    validationDatasetUri?: string;
+    /** Additional hyper-parameters to use during tuning. */
+    hyperParameters?: ReinforcementTuningHyperParameters;
+    /** Single reward function configuration for reinforcement tuning. */
+    singleRewardConfig?: SingleReinforcementTuningRewardConfig;
+}
+
+/** Scores parsed responses for string matching use cases. */
+export declare interface ReinforcementTuningStringMatchRewardScorer {
+    /** Wrong answer reward is returned if evaluator evaluates to `false`. All wrong answers get the same reward. */
+    wrongAnswerReward?: number;
+    /** Correct answer reward is returned if evaluator evaluates to `true`. All correct answers get the same reward. */
+    correctAnswerReward?: number;
+    /** Uses string match expression to evaluate parsed response. */
+    stringMatchExpression?: ReinforcementTuningStringMatchRewardScorerStringMatchExpression;
+    /** Uses json match expression to evaluate parsed response. */
+    jsonMatchExpression?: ReinforcementTuningStringMatchRewardScorerJsonMatchExpression;
+}
+
+/** Converts parsed responses to JSON format, finds the first-level matching key, then performs StringMatchExpression on the value. */
+export declare interface ReinforcementTuningStringMatchRewardScorerJsonMatchExpression {
+    /** Json key name to find the value to match against. */
+    keyName?: string;
+    /** String match expression to match against the value of json key. */
+    valueStringMatchExpression?: ReinforcementTuningStringMatchRewardScorerStringMatchExpression;
+}
+
+/** Evaluates parsed response using match type against expression. */
+export declare interface ReinforcementTuningStringMatchRewardScorerStringMatchExpression {
+    /** Match operation to use for evaluation. */
+    matchOperation?: MatchOperation;
+    /** String or regular expression to match against. Customer can also provide a references map (key/value pairs) whose value will be substituted into the expression by referencing `references.key_name` (wrapped in double curly braces). */
+    expression?: string;
+}
+
+/** Represents how much to think for the tuning job. */
+export declare enum ReinforcementTuningThinkingLevel {
+    /**
+     * Unspecified thinking level.
+     */
+    REINFORCEMENT_TUNING_THINKING_LEVEL_UNSPECIFIED = "REINFORCEMENT_TUNING_THINKING_LEVEL_UNSPECIFIED",
+    /**
+     * Little to no thinking.
+     */
+    MINIMAL = "MINIMAL",
+    /**
+     * High thinking level.
+     */
+    HIGH = "HIGH"
+}
+
 /** Represents a recorded session. */
 export declare interface ReplayFile {
     replayId?: string;
@@ -9745,6 +10011,22 @@ export declare enum ResourceScope {
     COLLECTION = "COLLECTION"
 }
 
+/** Defines how to parse sample response. */
+export declare enum ResponseParseType {
+    /**
+     * Default value. This value is unused.
+     */
+    RESPONSE_PARSE_TYPE_UNSPECIFIED = "RESPONSE_PARSE_TYPE_UNSPECIFIED",
+    /**
+     * Use the sample response as is.
+     */
+    IDENTITY = "IDENTITY",
+    /**
+     * Use regex to extract the important part of sample response.
+     */
+    REGEX_EXTRACT = "REGEX_EXTRACT"
+}
+
 /** Defines a retrieval tool that model can call to access external knowledge. This data type is not supported in Gemini API. */
 export declare interface Retrieval {
     /** Optional. Deprecated. This option is no longer supported. */
@@ -9757,10 +10039,9 @@ export declare interface Retrieval {
     vertexRagStore?: VertexRagStore;
 }
 
-/** Retrieval config.
- */
+/** Retrieval config. */
 export declare interface RetrievalConfig {
-    /** Optional. The location of the user. */
+    /** The location of the user. */
     latLng?: LatLng;
     /** The language code of the user. */
     languageCode?: string;
@@ -10276,6 +10557,22 @@ export declare class SingleEmbedContentResponse {
     tokenCount?: string;
 }
 
+/** Single reinforcement tuning reward config. */
+export declare interface SingleReinforcementTuningRewardConfig {
+    /** Scores parsed responses for autorater use cases by using a model to compute the reward. */
+    autoraterScorer?: ReinforcementTuningAutoraterScorer;
+    /** A unique reward name used to identify each single reinforcement tuning reward. */
+    rewardName?: string;
+    /** Defines how to parse sample response. */
+    parseResponseConfig?: ReinforcementTuningParseResponseConfig;
+    /** Scores parsed responses for code execution use cases. */
+    codeExecutionRewardScorer?: ReinforcementTuningCodeExecutionRewardScorer;
+    /** Scores parsed responses for simple string matching use cases against reference answer without writing python code. */
+    stringMatchRewardScorer?: ReinforcementTuningStringMatchRewardScorer;
+    /** Scores parsed responses by calling a Cloud Run service. */
+    cloudRunRewardScorer?: ReinforcementTuningCloudRunRewardScorer;
+}
+
 /** Context window will be truncated by keeping only suffix of it.
 
  Context window will always be cut at start of USER role turn. System
@@ -10354,6 +10651,10 @@ declare interface StepDelta {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: StepDelta.Metadata;
 }
 
 declare namespace StepDelta {
@@ -10392,7 +10693,7 @@ declare namespace StepDelta {
     interface Document {
         type: 'document';
         data?: string;
-        mime_type?: 'application/pdf';
+        mime_type?: 'application/pdf' | 'text/csv';
         uri?: string;
     }
     interface Video {
@@ -10559,6 +10860,15 @@ declare namespace StepDelta {
         is_error?: boolean;
         name?: string;
     }
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare interface StepStart {
@@ -10572,6 +10882,22 @@ declare interface StepStart {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: StepStart.Metadata;
+}
+
+declare namespace StepStart {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare interface StepStop {
@@ -10581,6 +10907,22 @@ declare interface StepStop {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: StepStop.Metadata;
+}
+
+declare namespace StepStop {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare class Stream<Item> implements AsyncIterable<Item> {
@@ -10622,17 +10964,6 @@ export declare interface StreamableHttpTransport {
     url?: string;
 }
 
-/** Config for stream translation. */
-export declare interface StreamTranslationConfig {
-    /** If true, the model will generate audio when the target language is
-     spoken, essentially it will parrot the input. If false, we will not produce
-     audio for the target language. */
-    echoTargetLanguage?: boolean;
-    /** The target language for translation. Supported values are BCP-47
-     language codes (e.g. "en", "es", "fr"). */
-    targetLanguageCode?: string;
-}
-
 /** User provided string values assigned to a single metadata key. This data type is not supported in Vertex AI. */
 export declare interface StringList {
     /** The string values of the metadata to store. */
@@ -11196,15 +11527,13 @@ declare type ToolChoiceType = 'auto' | 'any' | 'none' | 'validated';
 export declare interface ToolCodeExecution {
 }
 
-/** Tool config.
-
- This config is shared for all tools provided in the request. */
+/** Tool config. This config is shared for all tools provided in the request. */
 export declare interface ToolConfig {
     /** Optional. Retrieval config. */
     retrievalConfig?: RetrievalConfig;
     /** Optional. Function calling config. */
     functionCallingConfig?: FunctionCallingConfig;
-    /** 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 invocations. */
+    /** 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. This field is not supported in Vertex AI. */
     includeServerSideToolInvocations?: boolean;
 }
 
@@ -11293,6 +11622,19 @@ export declare interface Transcription {
     text?: string;
     /** Optional. The bool indicates the end of the transcription. */
     finished?: boolean;
+    /** The BCP-47 language code of the transcription. */
+    languageCode?: string;
+}
+
+/** Config for stream translation. */
+export declare interface TranslationConfig {
+    /** If true, the model will generate audio when the target language is
+     spoken, essentially it will parrot the input. If false, we will not produce
+     audio for the target language. */
+    echoTargetLanguage?: boolean;
+    /** The target language for translation. Supported values are BCP-47
+     language codes (e.g. "en", "es", "fr"). */
+    targetLanguageCode?: string;
 }
 
 /** TunedModel for the Tuned Model of a Tuning Job. */
@@ -11401,6 +11743,7 @@ export declare interface TuningJob {
     preferenceOptimizationSpec?: PreferenceOptimizationSpec;
     /** Tuning Spec for Distillation. */
     distillationSpec?: DistillationSpec;
+    reinforcementTuningSpec?: ReinforcementTuningSpec;
     /** Output only. The tuning data statistics associated with this TuningJob. */
     tuningDataStats?: TuningDataStats;
     /** Customer-managed encryption key options for a TuningJob. If this is set, then all resources created by the TuningJob will be encrypted with the provided encryption key. */
@@ -11485,7 +11828,11 @@ export declare enum TuningMethod {
     /**
      * Distillation tuning.
      */
-    DISTILLATION = "DISTILLATION"
+    DISTILLATION = "DISTILLATION",
+    /**
+     * Reinforcement tuning.
+     */
+    REINFORCEMENT_TUNING = "REINFORCEMENT_TUNING"
 }
 
 /** Tuning mode. This enum is not supported in Gemini API. */
@@ -11572,6 +11919,7 @@ declare class Tunings extends BaseModule {
     cancel(params: types.CancelTuningJobParameters): Promise<types.CancelTuningJobResponse>;
     private tuneInternal;
     private tuneMldevInternal;
+    validateReward(params: types.ValidateRewardParameters): Promise<types.ValidateRewardResponse>;
 }
 
 /** The speed of the tuning job. Only supported for Veo 3.0 models. This enum is not supported in Gemini API. */
@@ -11813,13 +12161,13 @@ declare namespace types {
         PhishBlockThreshold,
         Behavior,
         DynamicRetrievalConfigMode,
-        FunctionCallingConfigMode,
         ThinkingLevel,
         PersonGeneration,
         ProminentPeople,
         HarmCategory,
         HarmBlockMethod,
         HarmBlockThreshold,
+        FunctionCallingConfigMode,
         FinishReason,
         HarmProbability,
         HarmSeverity,
@@ -11856,6 +12204,9 @@ declare namespace types {
         VideoGenerationMaskMode,
         VideoCompressionQuality,
         ImageResizeMode,
+        ResponseParseType,
+        MatchOperation,
+        ReinforcementTuningThinkingLevel,
         TuningMethod,
         FileState,
         FileSource,
@@ -11930,10 +12281,6 @@ declare namespace types {
         StreamableHttpTransport,
         McpServer,
         Tool,
-        LatLng,
-        RetrievalConfig,
-        FunctionCallingConfig,
-        ToolConfig,
         ReplicatedVoiceConfig,
         PrebuiltVoiceConfig,
         VoiceConfig,
@@ -11948,6 +12295,10 @@ declare namespace types {
         GenerationConfigRoutingConfigManualRoutingMode,
         GenerationConfigRoutingConfig,
         SafetySetting,
+        LatLng,
+        RetrievalConfig,
+        FunctionCallingConfig,
+        ToolConfig,
         ModelArmorConfig,
         GenerateContentConfig,
         GenerateContentParameters,
@@ -12064,6 +12415,21 @@ declare namespace types {
         DistillationHyperParameters,
         DistillationSamplingSpec,
         DistillationSpec,
+        AutoraterConfig,
+        ReinforcementTuningParseResponseConfig,
+        ReinforcementTuningAutoraterScorerParsedResponseConversionScorer,
+        ReinforcementTuningAutoraterScorerExactMatchScorer,
+        ReinforcementTuningAutoraterScorer,
+        ReinforcementTuningCodeExecutionRewardScorer,
+        ReinforcementTuningStringMatchRewardScorerStringMatchExpression,
+        ReinforcementTuningStringMatchRewardScorerJsonMatchExpression,
+        ReinforcementTuningStringMatchRewardScorer,
+        ReinforcementTuningCloudRunRewardScorer,
+        SingleReinforcementTuningRewardConfig,
+        CompositeReinforcementTuningRewardConfigWeightedRewardConfig,
+        CompositeReinforcementTuningRewardConfig,
+        ReinforcementTuningHyperParameters,
+        ReinforcementTuningSpec,
         GoogleRpcStatus,
         PreTunedModel,
         DatasetDistributionDistributionBucket,
@@ -12113,6 +12479,11 @@ declare namespace types {
         CreateTuningJobConfig,
         CreateTuningJobParametersPrivate,
         TuningOperation,
+        ReinforcementTuningExample,
+        ValidateRewardConfig,
+        ValidateRewardParameters,
+        ReinforcementTuningRewardInfo,
+        ValidateRewardResponse,
         CreateCachedContentConfig,
         CreateCachedContentParameters,
         CachedContentUsageMetadata,
@@ -12250,7 +12621,7 @@ declare namespace types {
         LiveClientRealtimeInput,
         LiveClientToolResponse,
         LiveClientMessage,
-        StreamTranslationConfig,
+        TranslationConfig,
         LiveConnectConfig,
         LiveConnectParameters,
         CreateChatParameters,
@@ -12911,6 +13282,53 @@ export declare enum VadSignalType {
     VAD_SIGNAL_TYPE_EOS = "VAD_SIGNAL_TYPE_EOS"
 }
 
+/** Optional parameters for tunings.validate_reward. */
+export declare interface ValidateRewardConfig {
+    /** Used to override HTTP request options. */
+    httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
+}
+
+/** Parameters for the validate_reward method.
+
+ Validates a reinforcement tuning reward configuration against a sample
+ response and example before creating a reinforcement tuning job. */
+export declare interface ValidateRewardParameters {
+    /** Required. The resource name of the Location to validate the reward in, e.g. `projects/{project}/locations/{location}`. */
+    parent: string;
+    /** Required. The sample response for validating the reward configuration. */
+    sampleResponse: Content;
+    /** Required. The example to validate the reward configuration. */
+    example: ReinforcementTuningExample;
+    /** Single reward function configuration for reinforcement tuning. Mutually exclusive with composite_reward_config. */
+    singleRewardConfig?: SingleReinforcementTuningRewardConfig;
+    /** Composite reward function configuration for reinforcement tuning. Mutually exclusive with single_reward_config. */
+    compositeRewardConfig?: CompositeReinforcementTuningRewardConfig;
+    /** Optional parameters for the request. */
+    config?: ValidateRewardConfig;
+}
+
+/** Response for the validate_reward method.
+
+ Contains the computed reward for a reinforcement tuning reward
+ configuration. */
+export declare class ValidateRewardResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
+    /** Output only. The overall weighted reward. For a `CompositeReinforcementTuningRewardConfig`, this is the weighted average of all rewards. For a `SingleReinforcementTuningRewardConfig`, this will be the value of the single reward. */
+    overallReward?: number;
+    /** Output only. In case of an error, this field will be populated with a detailed error message to help with debugging. */
+    error?: string;
+    /** A map from reward name to reward info. */
+    rewardInfoDetails?: Record<string, ReinforcementTuningRewardInfo>;
+}
+
 /** Hyperparameters for Veo. This data type is not supported in Gemini API. */
 export declare interface VeoHyperParameters {
     /** Optional. Number of complete passes the model makes over the entire training dataset during training. */