@google/genai 2.6.0 → 2.7.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,18 @@ 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;
 }
 
 /** Fine-tuning job creation parameters - optional fields. */
@@ -2840,6 +2890,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 +3173,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 +3675,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 +3695,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 +4360,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>;
@@ -6713,6 +6779,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 +6807,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 +6981,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 +7092,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;
 }
 
@@ -8914,7 +9023,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 +9045,7 @@ declare interface PagedItemResponse<T> {
     cachedContents?: T[];
     fileSearchStores?: T[];
     documents?: T[];
+    skills?: T[];
 }
 
 /**
@@ -9616,6 +9727,12 @@ export declare class RegisterFilesResponse {
     files?: File_2[];
 }
 
+/** Reinforcement tuning autorater scorer. */
+export declare interface ReinforcementTuningAutoraterScorer {
+    /** Autorater config for evaluation. */
+    autoraterConfig?: AutoraterConfig;
+}
+
 /** Represents a recorded session. */
 export declare interface ReplayFile {
     replayId?: string;
@@ -9757,10 +9874,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 +10392,11 @@ export declare class SingleEmbedContentResponse {
     tokenCount?: string;
 }
 
+/** Single reinforcement tuning reward config. */
+export declare interface SingleReinforcementTuningRewardConfig {
+    autoraterScorer?: ReinforcementTuningAutoraterScorer;
+}
+
 /** 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 +10475,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 +10517,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 +10684,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 +10706,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 +10731,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> {
@@ -11196,15 +11362,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;
 }
 
@@ -11485,7 +11649,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. */
@@ -11813,13 +11981,13 @@ declare namespace types {
         PhishBlockThreshold,
         Behavior,
         DynamicRetrievalConfigMode,
-        FunctionCallingConfigMode,
         ThinkingLevel,
         PersonGeneration,
         ProminentPeople,
         HarmCategory,
         HarmBlockMethod,
         HarmBlockThreshold,
+        FunctionCallingConfigMode,
         FinishReason,
         HarmProbability,
         HarmSeverity,
@@ -11930,10 +12098,6 @@ declare namespace types {
         StreamableHttpTransport,
         McpServer,
         Tool,
-        LatLng,
-        RetrievalConfig,
-        FunctionCallingConfig,
-        ToolConfig,
         ReplicatedVoiceConfig,
         PrebuiltVoiceConfig,
         VoiceConfig,
@@ -11948,6 +12112,10 @@ declare namespace types {
         GenerationConfigRoutingConfigManualRoutingMode,
         GenerationConfigRoutingConfig,
         SafetySetting,
+        LatLng,
+        RetrievalConfig,
+        FunctionCallingConfig,
+        ToolConfig,
         ModelArmorConfig,
         GenerateContentConfig,
         GenerateContentParameters,
@@ -12110,6 +12278,11 @@ declare namespace types {
         TuningExample,
         TuningDataset,
         TuningValidationDataset,
+        AutoraterConfig,
+        ReinforcementTuningAutoraterScorer,
+        SingleReinforcementTuningRewardConfig,
+        CompositeReinforcementTuningRewardConfigWeightedRewardConfig,
+        CompositeReinforcementTuningRewardConfig,
         CreateTuningJobConfig,
         CreateTuningJobParametersPrivate,
         TuningOperation,