@google/genai 0.14.1 → 1.0.0

package/dist/genai.d.ts

@@ -1,3 +1,4 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { GoogleAuthOptions } from 'google-auth-library';
 
 /** Marks the end of user activity.
@@ -10,8 +11,17 @@ export declare interface ActivityEnd {
 
 /** The different ways of handling user activity. */
 export declare enum ActivityHandling {
+    /**
+     * If unspecified, the default behavior is `START_OF_ACTIVITY_INTERRUPTS`.
+     */
     ACTIVITY_HANDLING_UNSPECIFIED = "ACTIVITY_HANDLING_UNSPECIFIED",
+    /**
+     * If true, start of activity will interrupt the model's response (also called "barge in"). The model's current response will be cut-off in the moment of the interruption. This is the default behavior.
+     */
     START_OF_ACTIVITY_INTERRUPTS = "START_OF_ACTIVITY_INTERRUPTS",
+    /**
+     * The model's response will not be interrupted.
+     */
     NO_INTERRUPTION = "NO_INTERRUPTION"
 }
 
@@ -25,12 +35,33 @@ export declare interface ActivityStart {
 
 /** Optional. Adapter size for tuning. */
 export declare enum AdapterSize {
+    /**
+     * Adapter size is unspecified.
+     */
     ADAPTER_SIZE_UNSPECIFIED = "ADAPTER_SIZE_UNSPECIFIED",
+    /**
+     * Adapter size 1.
+     */
     ADAPTER_SIZE_ONE = "ADAPTER_SIZE_ONE",
+    /**
+     * Adapter size 2.
+     */
     ADAPTER_SIZE_TWO = "ADAPTER_SIZE_TWO",
+    /**
+     * Adapter size 4.
+     */
     ADAPTER_SIZE_FOUR = "ADAPTER_SIZE_FOUR",
+    /**
+     * Adapter size 8.
+     */
     ADAPTER_SIZE_EIGHT = "ADAPTER_SIZE_EIGHT",
+    /**
+     * Adapter size 16.
+     */
     ADAPTER_SIZE_SIXTEEN = "ADAPTER_SIZE_SIXTEEN",
+    /**
+     * Adapter size 32.
+     */
     ADAPTER_SIZE_THIRTY_TWO = "ADAPTER_SIZE_THIRTY_TWO"
 }
 
@@ -166,6 +197,16 @@ export declare interface ApiKeyConfig {
     apiKeyString?: string;
 }
 
+/** Representation of an audio chunk. */
+export declare interface AudioChunk {
+    /** Raw byets of audio data. */
+    data?: string;
+    /** MIME type of the audio chunk. */
+    mimeType?: string;
+    /** Prompts and config used for generating this audio chunk. */
+    sourceMetadata?: LiveMusicSourceMetadata;
+}
+
 /** The audio transcription configuration in Setup. */
 export declare interface AudioTranscriptionConfig {
 }
@@ -234,11 +275,29 @@ export declare interface AuthConfigOidcConfig {
 /** Type of auth scheme. */
 export declare enum AuthType {
     AUTH_TYPE_UNSPECIFIED = "AUTH_TYPE_UNSPECIFIED",
+    /**
+     * No Auth.
+     */
     NO_AUTH = "NO_AUTH",
+    /**
+     * API Key Auth.
+     */
     API_KEY_AUTH = "API_KEY_AUTH",
+    /**
+     * HTTP Basic Auth.
+     */
     HTTP_BASIC_AUTH = "HTTP_BASIC_AUTH",
+    /**
+     * Google Service Account Auth.
+     */
     GOOGLE_SERVICE_ACCOUNT_AUTH = "GOOGLE_SERVICE_ACCOUNT_AUTH",
+    /**
+     * OAuth auth.
+     */
     OAUTH = "OAUTH",
+    /**
+     * OpenID Connect (OIDC) Auth.
+     */
     OIDC_AUTH = "OIDC_AUTH"
 }
 
@@ -256,6 +315,28 @@ export declare interface AutomaticActivityDetection {
     silenceDurationMs?: number;
 }
 
+/** The configuration for automatic function calling. */
+export declare interface AutomaticFunctionCallingConfig {
+    /** Whether to disable automatic function calling.
+     If not set or set to False, will enable automatic function calling.
+     If set to True, will disable automatic function calling.
+     */
+    disable?: boolean;
+    /** If automatic function calling is enabled,
+     maximum number of remote calls for automatic function calling.
+     This number should be a positive integer.
+     If not set, SDK will set maximum number of remote calls to 10.
+     */
+    maximumRemoteCalls?: number;
+    /** If automatic function calling is enabled,
+     whether to ignore call history to the response.
+     If not set, SDK will set ignore_call_history to false,
+     and will append the call history to
+     GenerateContentResponse.automatic_function_calling_history.
+     */
+    ignoreCallHistory?: boolean;
+}
+
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -272,6 +353,22 @@ export declare interface BaseUrlParameters {
     vertexUrl?: string;
 }
 
+/** Defines the function behavior. Defaults to `BLOCKING`. */
+export declare enum Behavior {
+    /**
+     * This value is unused.
+     */
+    UNSPECIFIED = "UNSPECIFIED",
+    /**
+     * If set, the system will wait to receive the function response before continuing the conversation.
+     */
+    BLOCKING = "BLOCKING",
+    /**
+     * If set, the system will not wait to receive the function response. Instead, it will attempt to handle function responses as they become available while maintaining the conversation between the user and the model.
+     */
+    NON_BLOCKING = "NON_BLOCKING"
+}
+
 /** Content blob. */
 declare interface Blob_2 {
     /** Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is not currently used in the Gemini GenerateContent calls. */
@@ -287,10 +384,25 @@ export declare type BlobImageUnion = Blob_2;
 
 /** Output only. Blocked reason. */
 export declare enum BlockedReason {
+    /**
+     * Unspecified blocked reason.
+     */
     BLOCKED_REASON_UNSPECIFIED = "BLOCKED_REASON_UNSPECIFIED",
+    /**
+     * Candidates blocked due to safety.
+     */
     SAFETY = "SAFETY",
+    /**
+     * Candidates blocked due to other reason.
+     */
     OTHER = "OTHER",
+    /**
+     * Candidates blocked due to the terms which are included from the terminology blocklist.
+     */
     BLOCKLIST = "BLOCKLIST",
+    /**
+     * Candidates blocked due to prohibited content.
+     */
     PROHIBITED_CONTENT = "PROHIBITED_CONTENT"
 }
 
@@ -413,6 +525,33 @@ export declare class Caches extends BaseModule {
     private listInternal;
 }
 
+/**
+ * CallableTool is an invokable tool that can be executed with external
+ * application (e.g., via Model Context Protocol) or local functions with
+ * function calling.
+ */
+export declare interface CallableTool {
+    /**
+     * Returns tool that can be called by Gemini.
+     */
+    tool(): Promise<Tool>;
+    /**
+     * Executes the callable tool with the given function call arguments and
+     * returns the response parts from the tool execution.
+     */
+    callTool(functionCalls: FunctionCall[]): Promise<Part[]>;
+}
+
+/**
+ * CallableToolConfig is the configuration for a callable tool.
+ */
+export declare interface CallableToolConfig {
+    /**
+     * Specifies the model's behavior after invoking this tool.
+     */
+    behavior?: Behavior;
+}
+
 /** A response candidate generated from the model. */
 export declare interface Candidate {
     /** Contains the multi-part content of the response.
@@ -431,6 +570,8 @@ export declare interface Candidate {
      If empty, the model has not stopped generating the tokens.
      */
     finishReason?: FinishReason;
+    /** Metadata related to url context retrieval tool. */
+    urlContextMetadata?: UrlContextMetadata;
     /** Output only. Average log probability score of the candidate. */
     avgLogprobs?: number;
     /** Output only. Metadata specifies sources used to ground generated content. */
@@ -768,6 +909,40 @@ export declare class CountTokensResponse {
     cachedContentTokenCount?: number;
 }
 
+/** Optional parameters. */
+export declare interface CreateAuthTokenConfig {
+    /** 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;
+    /** An optional time after which, when using the resulting token,
+     messages in Live API sessions will be rejected. (Gemini may
+     preemptively close the session after this time.)
+
+     If not set then this defaults to 30 minutes in the future. If set, this
+     value must be less than 20 hours in the future. */
+    expireTime?: string;
+    /** The time after which new Live API sessions using the token
+     resulting from this request will be rejected.
+
+     If not set this defaults to 60 seconds in the future. If set, this value
+     must be less than 20 hours in the future. */
+    newSessionExpireTime?: string;
+    /** The number of times the token can be used. If this value is zero
+     then no limit is applied. Default is 1. Resuming a Live API session does
+     not count as a use. */
+    uses?: number;
+    /** Configuration specific to Live API connections created using this token. */
+    liveEphemeralParameters?: LiveEphemeralParameters;
+    /** Additional fields to lock in the effective LiveConnectParameters. */
+    lockAdditionalFields?: string[];
+}
+
 /** Optional configuration for cached content creation. */
 export declare interface CreateCachedContentConfig {
     /** Used to override HTTP request options. */
@@ -798,6 +973,16 @@ export declare interface CreateCachedContentConfig {
     /** Configuration for the tools to use. This config is shared for all tools.
      */
     toolConfig?: ToolConfig;
+    /** The Cloud KMS resource identifier of the customer managed
+     encryption key used to protect a resource.
+     The key needs to be in the same region as where the compute resource is
+     created. See
+     https://cloud.google.com/vertex-ai/docs/general/cmek for more
+     details. If this is set, then all created CachedContent objects
+     will be encrypted with the provided encryption key.
+     Allowed formats: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}
+     */
+    kmsKeyName?: string;
 }
 
 /** Parameters for caches.create method. */
@@ -1159,7 +1344,13 @@ export declare interface DynamicRetrievalConfig {
 
 /** Config for the dynamic retrieval config mode. */
 export declare enum DynamicRetrievalConfigMode {
+    /**
+     * Always trigger retrieval.
+     */
     MODE_UNSPECIFIED = "MODE_UNSPECIFIED",
+    /**
+     * Run retrieval only when system decides it is necessary.
+     */
     MODE_DYNAMIC = "MODE_DYNAMIC"
 }
 
@@ -1338,8 +1529,17 @@ export declare interface Endpoint {
 
 /** End of speech sensitivity. */
 export declare enum EndSensitivity {
+    /**
+     * The default is END_SENSITIVITY_LOW.
+     */
     END_SENSITIVITY_UNSPECIFIED = "END_SENSITIVITY_UNSPECIFIED",
+    /**
+     * Automatic detection ends speech more often.
+     */
     END_SENSITIVITY_HIGH = "END_SENSITIVITY_HIGH",
+    /**
+     * Automatic detection ends speech less often.
+     */
     END_SENSITIVITY_LOW = "END_SENSITIVITY_LOW"
 }
 
@@ -1588,17 +1788,53 @@ export declare interface FileStatus {
  If empty, the model has not stopped generating the tokens.
  */
 export declare enum FinishReason {
+    /**
+     * The finish reason is unspecified.
+     */
     FINISH_REASON_UNSPECIFIED = "FINISH_REASON_UNSPECIFIED",
+    /**
+     * Token generation reached a natural stopping point or a configured stop sequence.
+     */
     STOP = "STOP",
+    /**
+     * Token generation reached the configured maximum output tokens.
+     */
     MAX_TOKENS = "MAX_TOKENS",
+    /**
+     * Token generation stopped because the content potentially contains safety violations. NOTE: When streaming, [content][] is empty if content filters blocks the output.
+     */
     SAFETY = "SAFETY",
+    /**
+     * The token generation stopped because of potential recitation.
+     */
     RECITATION = "RECITATION",
+    /**
+     * The token generation stopped because of using an unsupported language.
+     */
     LANGUAGE = "LANGUAGE",
+    /**
+     * All other reasons that stopped the token generation.
+     */
     OTHER = "OTHER",
+    /**
+     * Token generation stopped because the content contains forbidden terms.
+     */
     BLOCKLIST = "BLOCKLIST",
+    /**
+     * Token generation stopped for potentially containing prohibited content.
+     */
     PROHIBITED_CONTENT = "PROHIBITED_CONTENT",
+    /**
+     * Token generation stopped because the content potentially contains Sensitive Personally Identifiable Information (SPII).
+     */
     SPII = "SPII",
+    /**
+     * The function call generated by the model is invalid.
+     */
     MALFORMED_FUNCTION_CALL = "MALFORMED_FUNCTION_CALL",
+    /**
+     * Token generation stopped because generated images have safety violations.
+     */
     IMAGE_SAFETY = "IMAGE_SAFETY"
 }
 
@@ -1623,14 +1859,32 @@ export declare interface FunctionCallingConfig {
 
 /** Config for the function calling config mode. */
 export declare enum FunctionCallingConfigMode {
+    /**
+     * The function calling config mode is unspecified. Should not be used.
+     */
     MODE_UNSPECIFIED = "MODE_UNSPECIFIED",
+    /**
+     * Default model behavior, model decides to predict either function calls or natural language response.
+     */
     AUTO = "AUTO",
+    /**
+     * Model is constrained to always predicting function calls only. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
+     */
     ANY = "ANY",
+    /**
+     * Model will not predict any function calls. Model behavior is same as when not passing any function declarations.
+     */
     NONE = "NONE"
 }
 
-/** Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name, description, parameters and response type. 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. */
+/** Defines a function that the model can generate JSON inputs for.
+
+ The inputs are based on `OpenAPI 3.0 specifications
+ <https://spec.openapis.org/oas/v3.0.3>`_.
+ */
 export declare interface FunctionDeclaration {
+    /** Defines the function behavior. */
+    behavior?: Behavior;
     /** Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function. */
     description?: string;
     /** Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots and dashes, with a maximum length of 64. */
@@ -1643,8 +1897,11 @@ export declare interface FunctionDeclaration {
 
 /** A function response. */
 export declare class FunctionResponse {
-    /** The id of the function call this response is for. Populated by the client
-     to match the corresponding function call `id`. */
+    /** 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. */
+    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. */
+    scheduling?: FunctionResponseScheduling;
+    /** Optional. The id of the function call this response is for. Populated by the client to match the corresponding function call `id`. */
     id?: string;
     /** Required. The name of the function to call. Matches [FunctionDeclaration.name] and [FunctionCall.name]. */
     name?: string;
@@ -1652,6 +1909,26 @@ export declare class FunctionResponse {
     response?: Record<string, unknown>;
 }
 
+/** Specifies how the response should be scheduled in the conversation. */
+export declare enum FunctionResponseScheduling {
+    /**
+     * This value is unused.
+     */
+    SCHEDULING_UNSPECIFIED = "SCHEDULING_UNSPECIFIED",
+    /**
+     * Only add the result to the conversation context, do not interrupt or trigger generation.
+     */
+    SILENT = "SILENT",
+    /**
+     * Add the result to the conversation context, and prompt to generate output without interrupting ongoing generation.
+     */
+    WHEN_IDLE = "WHEN_IDLE",
+    /**
+     * Add the result to the conversation context, interrupt ongoing generation and prompt to generate output.
+     */
+    INTERRUPT = "INTERRUPT"
+}
+
 /** Optional model configuration parameters.
 
  For more information, see `Content generation parameters
@@ -1777,6 +2054,9 @@ export declare interface GenerateContentConfig {
      model.
      */
     audioTimestamp?: boolean;
+    /** The configuration for automatic function calling.
+     */
+    automaticFunctionCalling?: AutomaticFunctionCallingConfig;
     /** The thinking features configuration.
      */
     thinkingConfig?: ThinkingConfig;
@@ -1806,6 +2086,9 @@ export declare class GenerateContentResponse {
     /** Identifier for each response.
      */
     responseId?: string;
+    /** The history of automatic function calling.
+     */
+    automaticFunctionCallingHistory?: Content[];
     /** Output only. The model version used to generate the response. */
     modelVersion?: string;
     /** Output only. Content filter results for a prompt sent in the request. Note: Sent only in the first stream chunk. Only happens when no candidates were generated due to content violations. */
@@ -2449,6 +2732,10 @@ export declare interface GoogleRpcStatus {
 
 /** Tool to support Google Search in Model. Powered by Google. */
 export declare interface GoogleSearch {
+    /** 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;
 }
 
 /** Tool to retrieve public web data for grounding, powered by Google. */
@@ -2523,46 +2810,121 @@ export declare interface GroundingSupport {
 
 /** Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score. */
 export declare enum HarmBlockMethod {
+    /**
+     * The harm block method is unspecified.
+     */
     HARM_BLOCK_METHOD_UNSPECIFIED = "HARM_BLOCK_METHOD_UNSPECIFIED",
+    /**
+     * The harm block method uses both probability and severity scores.
+     */
     SEVERITY = "SEVERITY",
+    /**
+     * The harm block method uses the probability score.
+     */
     PROBABILITY = "PROBABILITY"
 }
 
 /** Required. The harm block threshold. */
 export declare enum HarmBlockThreshold {
+    /**
+     * Unspecified harm block threshold.
+     */
     HARM_BLOCK_THRESHOLD_UNSPECIFIED = "HARM_BLOCK_THRESHOLD_UNSPECIFIED",
+    /**
+     * Block low threshold and above (i.e. block more).
+     */
     BLOCK_LOW_AND_ABOVE = "BLOCK_LOW_AND_ABOVE",
+    /**
+     * Block medium threshold and above.
+     */
     BLOCK_MEDIUM_AND_ABOVE = "BLOCK_MEDIUM_AND_ABOVE",
+    /**
+     * Block only high threshold (i.e. block less).
+     */
     BLOCK_ONLY_HIGH = "BLOCK_ONLY_HIGH",
+    /**
+     * Block none.
+     */
     BLOCK_NONE = "BLOCK_NONE",
+    /**
+     * Turn off the safety filter.
+     */
     OFF = "OFF"
 }
 
 /** Required. Harm category. */
 export declare enum HarmCategory {
+    /**
+     * The harm category is unspecified.
+     */
     HARM_CATEGORY_UNSPECIFIED = "HARM_CATEGORY_UNSPECIFIED",
+    /**
+     * The harm category is hate speech.
+     */
     HARM_CATEGORY_HATE_SPEECH = "HARM_CATEGORY_HATE_SPEECH",
+    /**
+     * The harm category is dangerous content.
+     */
     HARM_CATEGORY_DANGEROUS_CONTENT = "HARM_CATEGORY_DANGEROUS_CONTENT",
+    /**
+     * The harm category is harassment.
+     */
     HARM_CATEGORY_HARASSMENT = "HARM_CATEGORY_HARASSMENT",
+    /**
+     * The harm category is sexually explicit content.
+     */
     HARM_CATEGORY_SEXUALLY_EXPLICIT = "HARM_CATEGORY_SEXUALLY_EXPLICIT",
+    /**
+     * The harm category is civic integrity.
+     */
     HARM_CATEGORY_CIVIC_INTEGRITY = "HARM_CATEGORY_CIVIC_INTEGRITY"
 }
 
 /** Output only. Harm probability levels in the content. */
 export declare enum HarmProbability {
+    /**
+     * Harm probability unspecified.
+     */
     HARM_PROBABILITY_UNSPECIFIED = "HARM_PROBABILITY_UNSPECIFIED",
+    /**
+     * Negligible level of harm.
+     */
     NEGLIGIBLE = "NEGLIGIBLE",
+    /**
+     * Low level of harm.
+     */
     LOW = "LOW",
+    /**
+     * Medium level of harm.
+     */
     MEDIUM = "MEDIUM",
+    /**
+     * High level of harm.
+     */
     HIGH = "HIGH"
 }
 
 /** Output only. Harm severity levels in the content. */
 export declare enum HarmSeverity {
+    /**
+     * Harm severity unspecified.
+     */
     HARM_SEVERITY_UNSPECIFIED = "HARM_SEVERITY_UNSPECIFIED",
+    /**
+     * Negligible level of harm severity.
+     */
     HARM_SEVERITY_NEGLIGIBLE = "HARM_SEVERITY_NEGLIGIBLE",
+    /**
+     * Low level of harm severity.
+     */
     HARM_SEVERITY_LOW = "HARM_SEVERITY_LOW",
+    /**
+     * Medium level of harm severity.
+     */
     HARM_SEVERITY_MEDIUM = "HARM_SEVERITY_MEDIUM",
+    /**
+     * High level of harm severity.
+     */
     HARM_SEVERITY_HIGH = "HARM_SEVERITY_HIGH"
 }
 
@@ -2663,25 +3025,81 @@ export declare enum ImagePromptLanguage {
     hi = "hi"
 }
 
+/** Represents a time interval, encoded as a start time (inclusive) and an end time (exclusive).
+
+ The start time must be less than or equal to the end time.
+ When the start equals the end time, the interval is an empty interval.
+ (matches no time)
+ When both start and end are unspecified, the interval matches any time.
+ */
+export declare interface Interval {
+    /** The start time of the interval. */
+    startTime?: string;
+    /** The end time of the interval. */
+    endTime?: string;
+}
+
 /** Output only. The detailed state of the job. */
 export declare enum JobState {
+    /**
+     * The job state is unspecified.
+     */
     JOB_STATE_UNSPECIFIED = "JOB_STATE_UNSPECIFIED",
+    /**
+     * The job has been just created or resumed and processing has not yet begun.
+     */
     JOB_STATE_QUEUED = "JOB_STATE_QUEUED",
+    /**
+     * The service is preparing to run the job.
+     */
     JOB_STATE_PENDING = "JOB_STATE_PENDING",
+    /**
+     * The job is in progress.
+     */
     JOB_STATE_RUNNING = "JOB_STATE_RUNNING",
+    /**
+     * The job completed successfully.
+     */
     JOB_STATE_SUCCEEDED = "JOB_STATE_SUCCEEDED",
+    /**
+     * The job failed.
+     */
     JOB_STATE_FAILED = "JOB_STATE_FAILED",
+    /**
+     * The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.
+     */
     JOB_STATE_CANCELLING = "JOB_STATE_CANCELLING",
+    /**
+     * The job has been cancelled.
+     */
     JOB_STATE_CANCELLED = "JOB_STATE_CANCELLED",
+    /**
+     * The job has been stopped, and can be resumed.
+     */
     JOB_STATE_PAUSED = "JOB_STATE_PAUSED",
+    /**
+     * The job has expired.
+     */
     JOB_STATE_EXPIRED = "JOB_STATE_EXPIRED",
+    /**
+     * The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.
+     */
     JOB_STATE_UPDATING = "JOB_STATE_UPDATING",
+    /**
+     * The job is partially succeeded, some results may be missing due to errors.
+     */
     JOB_STATE_PARTIALLY_SUCCEEDED = "JOB_STATE_PARTIALLY_SUCCEEDED"
 }
 
 /** Required. Programming language of the `code`. */
 export declare enum Language {
+    /**
+     * Unspecified language. This value should not be used.
+     */
     LANGUAGE_UNSPECIFIED = "LANGUAGE_UNSPECIFIED",
+    /**
+     * Python >= 3.10, with numpy and simpy available.
+     */
     PYTHON = "PYTHON"
 }
 
@@ -2822,12 +3240,14 @@ export declare class Live {
     private readonly apiClient;
     private readonly auth;
     private readonly webSocketFactory;
+    readonly music: LiveMusic;
     constructor(apiClient: ApiClient, auth: Auth, webSocketFactory: WebSocketFactory);
     /**
      Establishes a connection to the specified model with the given
      configuration and returns a Session object representing that connection.
 
-     @experimental
+     @experimental Built-in MCP support is an experimental feature, may change in
+     future versions.
 
      @remarks
 
@@ -2865,6 +3285,7 @@ export declare class Live {
      ```
      */
     connect(params: types.LiveConnectParameters): Promise<Session>;
+    private isCallableTool;
 }
 
 /** Callbacks for the live API. */
@@ -2998,6 +3419,9 @@ export declare interface LiveClientSetup {
      specified for the output audio.
      */
     outputAudioTranscription?: AudioTranscriptionConfig;
+    /** Configures the proactivity of the model. This allows the model to respond proactively to
+     the input and to ignore irrelevant input. */
+    proactivity?: ProactivityConfig;
 }
 
 /** Client generated response to a `ToolCall` received from the server.
@@ -3017,6 +3441,15 @@ export declare class LiveClientToolResponse {
 
 /** Session config for the API connection. */
 export declare interface LiveConnectConfig {
+    /** 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;
     /** The generation configuration for the session. */
     generationConfig?: GenerationConfig;
     /** The requested modalities of the response. Represents the set of
@@ -3055,6 +3488,8 @@ export declare interface LiveConnectConfig {
     /** The speech generation configuration.
      */
     speechConfig?: SpeechConfig;
+    /** If enabled, the model will detect emotions and adapt its responses accordingly. */
+    enableAffectiveDialog?: boolean;
     /** The user provided system instructions for the model.
      Note: only text should be used in parts and content in each part will be
      in a separate paragraph. */
@@ -3082,6 +3517,9 @@ export declare interface LiveConnectConfig {
 
      If included, server will compress context window to fit into given length. */
     contextWindowCompression?: ContextWindowCompressionConfig;
+    /** Configures the proactivity of the model. This allows the model to respond proactively to
+     the input and to ignore irrelevant input. */
+    proactivity?: ProactivityConfig;
 }
 
 /** Parameters for connecting to the live API. */
@@ -3096,23 +3534,315 @@ export declare interface LiveConnectParameters {
     config?: LiveConnectConfig;
 }
 
-/** Parameters for sending client content to the live API. */
-export declare interface LiveSendClientContentParameters {
-    /** Client content to send to the session. */
-    turns?: ContentListUnion;
-    /** If true, indicates that the server content generation should start with
-     the currently accumulated prompt. Otherwise, the server will await
-     additional messages before starting generation. */
-    turnComplete?: boolean;
+/** Config for LiveEphemeralParameters for Auth Token creation. */
+export declare interface LiveEphemeralParameters {
+    /** ID of the model to configure in the ephemeral token for Live API.
+     For a list of models, see `Gemini models
+     <https://ai.google.dev/gemini-api/docs/models>`. */
+    model?: string;
+    /** Configuration specific to Live API connections created using this token. */
+    config?: LiveConnectConfig;
 }
 
-/** Parameters for sending realtime input to the live API. */
-export declare interface LiveSendRealtimeInputParameters {
-    /** Realtime input to send to the session. */
-    media?: BlobImageUnion;
-    /** The realtime audio input stream. */
-    audio?: Blob_2;
-    /**
+/**
+ LiveMusic class encapsulates the configuration for live music
+ generation via Lyria Live models.
+
+ @experimental
+ */
+declare class LiveMusic {
+    private readonly apiClient;
+    private readonly auth;
+    private readonly webSocketFactory;
+    constructor(apiClient: ApiClient, auth: Auth, webSocketFactory: WebSocketFactory);
+    /**
+     Establishes a connection to the specified model and returns a
+     LiveMusicSession object representing that connection.
+
+     @experimental
+
+     @remarks
+
+     @param params - The parameters for establishing a connection to the model.
+     @return A live session.
+
+     @example
+     ```ts
+     let model = 'models/lyria-realtime-exp';
+     const session = await ai.live.music.connect({
+     model: model,
+     callbacks: {
+     onmessage: (e: MessageEvent) => {
+     console.log('Received message from the server: %s\n', debug(e.data));
+     },
+     onerror: (e: ErrorEvent) => {
+     console.log('Error occurred: %s\n', debug(e.error));
+     },
+     onclose: (e: CloseEvent) => {
+     console.log('Connection closed.');
+     },
+     },
+     });
+     ```
+     */
+    connect(params: types.LiveMusicConnectParameters): Promise<LiveMusicSession>;
+}
+
+/** Callbacks for the realtime music API. */
+export declare interface LiveMusicCallbacks {
+    /**
+     * Called when a message is received from the server.
+     */
+    onmessage: (e: LiveMusicServerMessage) => void;
+    /**
+     * Called when an error occurs.
+     */
+    onerror?: ((e: ErrorEvent) => void) | null;
+    /**
+     * Called when the websocket connection is closed.
+     */
+    onclose?: ((e: CloseEvent) => void) | null;
+}
+
+/** User input to start or steer the music. */
+export declare interface LiveMusicClientContent {
+    /** Weighted prompts as the model input. */
+    weightedPrompts?: WeightedPrompt[];
+}
+
+/** Messages sent by the client in the LiveMusicClientMessage call. */
+export declare interface LiveMusicClientMessage {
+    /** Message to be sent in the first (and only in the first) `LiveMusicClientMessage`.
+     Clients should wait for a `LiveMusicSetupComplete` message before
+     sending any additional messages. */
+    setup?: LiveMusicClientSetup;
+    /** User input to influence music generation. */
+    clientContent?: LiveMusicClientContent;
+    /** Configuration for music generation. */
+    musicGenerationConfig?: LiveMusicGenerationConfig;
+    /** Playback control signal for the music generation. */
+    playbackControl?: LiveMusicPlaybackControl;
+}
+
+/** Message to be sent by the system when connecting to the API. */
+export declare interface LiveMusicClientSetup {
+    /** The model's resource name. Format: `models/{model}`. */
+    model?: string;
+}
+
+/** Parameters for connecting to the live API. */
+export declare interface LiveMusicConnectParameters {
+    /** The model's resource name. */
+    model: string;
+    /** Callbacks invoked on server events. */
+    callbacks: LiveMusicCallbacks;
+}
+
+/** A prompt that was filtered with the reason. */
+export declare interface LiveMusicFilteredPrompt {
+    /** The text prompt that was filtered. */
+    text?: string;
+    /** The reason the prompt was filtered. */
+    filteredReason?: string;
+}
+
+/** Configuration for music generation. */
+export declare interface LiveMusicGenerationConfig {
+    /** Controls the variance in audio generation. Higher values produce
+     higher variance. Range is [0.0, 3.0]. */
+    temperature?: number;
+    /** Controls how the model selects tokens for output. Samples the topK
+     tokens with the highest probabilities. Range is [1, 1000]. */
+    topK?: number;
+    /** Seeds audio generation. If not set, the request uses a randomly
+     generated seed. */
+    seed?: number;
+    /** Controls how closely the model follows prompts.
+     Higher guidance follows more closely, but will make transitions more
+     abrupt. Range is [0.0, 6.0]. */
+    guidance?: number;
+    /** Beats per minute. Range is [60, 200]. */
+    bpm?: number;
+    /** Density of sounds. Range is [0.0, 1.0]. */
+    density?: number;
+    /** Brightness of the music. Range is [0.0, 1.0]. */
+    brightness?: number;
+    /** Scale of the generated music. */
+    scale?: Scale;
+    /** Whether the audio output should contain bass. */
+    muteBass?: boolean;
+    /** Whether the audio output should contain drums. */
+    muteDrums?: boolean;
+    /** Whether the audio output should contain only bass and drums. */
+    onlyBassAndDrums?: boolean;
+    /** The mode of music generation. Default mode is QUALITY. */
+    musicGenerationMode?: MusicGenerationMode;
+}
+
+/** The playback control signal to apply to the music generation. */
+export declare enum LiveMusicPlaybackControl {
+    /**
+     * This value is unused.
+     */
+    PLAYBACK_CONTROL_UNSPECIFIED = "PLAYBACK_CONTROL_UNSPECIFIED",
+    /**
+     * Start generating the music.
+     */
+    PLAY = "PLAY",
+    /**
+     * Hold the music generation. Use PLAY to resume from the current position.
+     */
+    PAUSE = "PAUSE",
+    /**
+     * Stop the music generation and reset the context (prompts retained).
+     Use PLAY to restart the music generation.
+     */
+    STOP = "STOP",
+    /**
+     * Reset the context of the music generation without stopping it.
+     Retains the current prompts and config.
+     */
+    RESET_CONTEXT = "RESET_CONTEXT"
+}
+
+/** Server update generated by the model in response to client messages.
+
+ Content is generated as quickly as possible, and not in real time.
+ Clients may choose to buffer and play it out in real time.
+ */
+export declare interface LiveMusicServerContent {
+    /** The audio chunks that the model has generated. */
+    audioChunks?: AudioChunk[];
+}
+
+/** Response message for the LiveMusicClientMessage call. */
+export declare class LiveMusicServerMessage {
+    /** Message sent in response to a `LiveMusicClientSetup` message from the client.
+     Clients should wait for this message before sending any additional messages. */
+    setupComplete?: LiveMusicServerSetupComplete;
+    /** Content generated by the model in response to client messages. */
+    serverContent?: LiveMusicServerContent;
+    /** A prompt that was filtered with the reason. */
+    filteredPrompt?: LiveMusicFilteredPrompt;
+    /**
+     * Returns the first audio chunk from the server content, if present.
+     *
+     * @remarks
+     * If there are no audio chunks in the response, undefined will be returned.
+     */
+    get audioChunk(): AudioChunk | undefined;
+}
+
+/** Sent in response to a `LiveMusicClientSetup` message from the client. */
+export declare interface LiveMusicServerSetupComplete {
+}
+
+/**
+ Represents a connection to the API.
+
+ @experimental
+ */
+export declare class LiveMusicSession {
+    readonly conn: WebSocket_2;
+    private readonly apiClient;
+    constructor(conn: WebSocket_2, apiClient: ApiClient);
+    /**
+     Sets inputs to steer music generation. Updates the session's current
+     weighted prompts.
+
+     @param params - Contains one property, `weightedPrompts`.
+
+     - `weightedPrompts` to send to the model; weights are normalized to
+     sum to 1.0.
+
+     @experimental
+     */
+    setWeightedPrompts(params: types.LiveMusicSetWeightedPromptsParameters): Promise<void>;
+    /**
+     Sets a configuration to the model. Updates the session's current
+     music generation config.
+
+     @param params - Contains one property, `musicGenerationConfig`.
+
+     - `musicGenerationConfig` to set in the model. Passing an empty or
+     undefined config to the model will reset the config to defaults.
+
+     @experimental
+     */
+    setMusicGenerationConfig(params: types.LiveMusicSetConfigParameters): Promise<void>;
+    private sendPlaybackControl;
+    /**
+     * Start the music stream.
+     *
+     * @experimental
+     */
+    play(): void;
+    /**
+     * Temporarily halt the music stream. Use `play` to resume from the current
+     * position.
+     *
+     * @experimental
+     */
+    pause(): void;
+    /**
+     * Stop the music stream and reset the state. Retains the current prompts
+     * and config.
+     *
+     * @experimental
+     */
+    stop(): void;
+    /**
+     * Resets the context of the music generation without stopping it.
+     * Retains the current prompts and config.
+     *
+     * @experimental
+     */
+    resetContext(): void;
+    /**
+     Terminates the WebSocket connection.
+
+     @experimental
+     */
+    close(): void;
+}
+
+/** Parameters for setting config for the live music API. */
+export declare interface LiveMusicSetConfigParameters {
+    /** Configuration for music generation. */
+    musicGenerationConfig: LiveMusicGenerationConfig;
+}
+
+/** Parameters for setting weighted prompts for the live music API. */
+export declare interface LiveMusicSetWeightedPromptsParameters {
+    /** A map of text prompts to weights to use for the generation request. */
+    weightedPrompts: WeightedPrompt[];
+}
+
+/** Prompts and config used for generating this audio chunk. */
+export declare interface LiveMusicSourceMetadata {
+    /** Weighted prompts for generating this audio chunk. */
+    clientContent?: LiveMusicClientContent;
+    /** Music generation config for generating this audio chunk. */
+    musicGenerationConfig?: LiveMusicGenerationConfig;
+}
+
+/** Parameters for sending client content to the live API. */
+export declare interface LiveSendClientContentParameters {
+    /** Client content to send to the session. */
+    turns?: ContentListUnion;
+    /** If true, indicates that the server content generation should start with
+     the currently accumulated prompt. Otherwise, the server will await
+     additional messages before starting generation. */
+    turnComplete?: boolean;
+}
+
+/** Parameters for sending realtime input to the live API. */
+export declare interface LiveSendRealtimeInputParameters {
+    /** Realtime input to send to the session. */
+    media?: BlobImageUnion;
+    /** The realtime audio input stream. */
+    audio?: Blob_2;
+    /**
      Indicates that the audio stream has ended, e.g. because the microphone was
      turned off.
 
@@ -3170,6 +3900,8 @@ export declare interface LiveServerContent {
      model turn.
      */
     outputTranscription?: Transcription;
+    /** Metadata related to url context retrieval tool. */
+    urlContextMetadata?: UrlContextMetadata;
 }
 
 /** Server will not be able to service client soon. */
@@ -3319,29 +4051,83 @@ export declare enum MaskReferenceMode {
     MASK_MODE_SEMANTIC = "MASK_MODE_SEMANTIC"
 }
 
+/**
+ * Creates a McpCallableTool from MCP clients and an optional config.
+ *
+ * The callable tool can invoke the MCP clients with given function call
+ * arguments. (often for automatic function calling).
+ * Use the config to modify tool parameters such as behavior.
+ *
+ * @experimental Built-in MCP support is an experimental feature, may change in future
+ * versions.
+ */
+export declare function mcpToTool(...args: [...Client[], CallableToolConfig | Client]): CallableTool;
+
 /** Server content modalities. */
 export declare enum MediaModality {
+    /**
+     * The modality is unspecified.
+     */
     MODALITY_UNSPECIFIED = "MODALITY_UNSPECIFIED",
+    /**
+     * Plain text.
+     */
     TEXT = "TEXT",
+    /**
+     * Images.
+     */
     IMAGE = "IMAGE",
+    /**
+     * Video.
+     */
     VIDEO = "VIDEO",
+    /**
+     * Audio.
+     */
     AUDIO = "AUDIO",
+    /**
+     * Document, e.g. PDF.
+     */
     DOCUMENT = "DOCUMENT"
 }
 
 /** The media resolution to use. */
 export declare enum MediaResolution {
+    /**
+     * Media resolution has not been set
+     */
     MEDIA_RESOLUTION_UNSPECIFIED = "MEDIA_RESOLUTION_UNSPECIFIED",
+    /**
+     * Media resolution set to low (64 tokens).
+     */
     MEDIA_RESOLUTION_LOW = "MEDIA_RESOLUTION_LOW",
+    /**
+     * Media resolution set to medium (256 tokens).
+     */
     MEDIA_RESOLUTION_MEDIUM = "MEDIA_RESOLUTION_MEDIUM",
+    /**
+     * Media resolution set to high (zoomed reframing with 256 tokens).
+     */
     MEDIA_RESOLUTION_HIGH = "MEDIA_RESOLUTION_HIGH"
 }
 
 /** Server content modalities. */
 export declare enum Modality {
+    /**
+     * The modality is unspecified.
+     */
     MODALITY_UNSPECIFIED = "MODALITY_UNSPECIFIED",
+    /**
+     * Indicates the model should return text
+     */
     TEXT = "TEXT",
+    /**
+     * Indicates the model should return images.
+     */
     IMAGE = "IMAGE",
+    /**
+     * Indicates the model should return images.
+     */
     AUDIO = "AUDIO"
 }
 
@@ -3355,7 +4141,13 @@ export declare interface ModalityTokenCount {
 
 /** The mode of the predictor to be used in dynamic retrieval. */
 export declare enum Mode {
+    /**
+     * Always trigger retrieval.
+     */
     MODE_UNSPECIFIED = "MODE_UNSPECIFIED",
+    /**
+     * Run retrieval only when system decides it is necessary.
+     */
     MODE_DYNAMIC = "MODE_DYNAMIC"
 }
 
@@ -3476,6 +4268,15 @@ export declare class Models extends BaseModule {
      * ```
      */
     generateContentStream: (params: types.GenerateContentParameters) => Promise<AsyncGenerator<types.GenerateContentResponse>>;
+    /**
+     * Transforms the CallableTools in the parameters to be simply Tools, it
+     * copies the params into a new object and replaces the tools, it does not
+     * modify the original params. Also sets the MCP usage header if there are
+     * MCP tools in the parameters.
+     */
+    private processParamsForMcpUsage;
+    private initAfcToolsMap;
+    private processAfcStream;
     /**
      * Generates an image based on a text description and configuration.
      *
@@ -3693,6 +4494,30 @@ export declare interface ModelSelectionConfig {
     featureSelectionPreference?: FeatureSelectionPreference;
 }
 
+/** The configuration for the multi-speaker setup. */
+export declare interface MultiSpeakerVoiceConfig {
+    /** The configuration for the speaker to use. */
+    speakerVoiceConfigs?: SpeakerVoiceConfig[];
+}
+
+/** The mode of music generation. */
+export declare enum MusicGenerationMode {
+    /**
+     * This value is unused.
+     */
+    MUSIC_GENERATION_MODE_UNSPECIFIED = "MUSIC_GENERATION_MODE_UNSPECIFIED",
+    /**
+     * Steer text prompts to regions of latent space with higher quality
+     music.
+     */
+    QUALITY = "QUALITY",
+    /**
+     * Steer text prompts to regions of latent space with a larger diversity
+     of music.
+     */
+    DIVERSITY = "DIVERSITY"
+}
+
 /** A long-running operation. */
 export declare interface Operation {
     /** 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}`. */
@@ -3734,9 +4559,21 @@ export declare class Operations extends BaseModule {
  */
 /** Required. Outcome of the code execution. */
 export declare enum Outcome {
+    /**
+     * Unspecified status. This value should not be used.
+     */
     OUTCOME_UNSPECIFIED = "OUTCOME_UNSPECIFIED",
+    /**
+     * Code execution completed successfully.
+     */
     OUTCOME_OK = "OUTCOME_OK",
+    /**
+     * Code execution finished but with a failure. `stderr` should contain the reason.
+     */
     OUTCOME_FAILED = "OUTCOME_FAILED",
+    /**
+     * Code execution ran for too long, and was cancelled. There may or may not be a partial output present.
+     */
     OUTCOME_DEADLINE_EXCEEDED = "OUTCOME_DEADLINE_EXCEEDED"
 }
 
@@ -3917,11 +4754,18 @@ export declare enum PersonGeneration {
 
 /** The configuration for the prebuilt speaker to use. */
 export declare interface PrebuiltVoiceConfig {
-    /** The name of the prebuilt voice to use.
-     */
+    /** The name of the prebuilt voice to use. */
     voiceName?: string;
 }
 
+/** Config for proactivity features. */
+export declare interface ProactivityConfig {
+    /** If enabled, the model can reject responding to the last prompt. For
+     example, this allows the model to ignore out of context speech or to stay
+     silent if the user did not make a request, yet. */
+    proactiveAudio?: boolean;
+}
+
 /** Specifies the context retrieval config. */
 export declare interface RagRetrievalConfig {
     /** Optional. Config for filters. */
@@ -4102,6 +4946,62 @@ export declare interface SafetySetting {
     threshold?: HarmBlockThreshold;
 }
 
+/** Scale of the generated music. */
+export declare enum Scale {
+    /**
+     * Default value. This value is unused.
+     */
+    SCALE_UNSPECIFIED = "SCALE_UNSPECIFIED",
+    /**
+     * C major or A minor.
+     */
+    C_MAJOR_A_MINOR = "C_MAJOR_A_MINOR",
+    /**
+     * Db major or Bb minor.
+     */
+    D_FLAT_MAJOR_B_FLAT_MINOR = "D_FLAT_MAJOR_B_FLAT_MINOR",
+    /**
+     * D major or B minor.
+     */
+    D_MAJOR_B_MINOR = "D_MAJOR_B_MINOR",
+    /**
+     * Eb major or C minor
+     */
+    E_FLAT_MAJOR_C_MINOR = "E_FLAT_MAJOR_C_MINOR",
+    /**
+     * E major or Db minor.
+     */
+    E_MAJOR_D_FLAT_MINOR = "E_MAJOR_D_FLAT_MINOR",
+    /**
+     * F major or D minor.
+     */
+    F_MAJOR_D_MINOR = "F_MAJOR_D_MINOR",
+    /**
+     * Gb major or Eb minor.
+     */
+    G_FLAT_MAJOR_E_FLAT_MINOR = "G_FLAT_MAJOR_E_FLAT_MINOR",
+    /**
+     * G major or E minor.
+     */
+    G_MAJOR_E_MINOR = "G_MAJOR_E_MINOR",
+    /**
+     * Ab major or F minor.
+     */
+    A_FLAT_MAJOR_F_MINOR = "A_FLAT_MAJOR_F_MINOR",
+    /**
+     * A major or Gb minor.
+     */
+    A_MAJOR_G_FLAT_MINOR = "A_MAJOR_G_FLAT_MINOR",
+    /**
+     * Bb major or G minor.
+     */
+    B_FLAT_MAJOR_G_MINOR = "B_FLAT_MAJOR_G_MINOR",
+    /**
+     * B major or Ab minor.
+     */
+    B_MAJOR_A_FLAT_MINOR = "B_MAJOR_A_FLAT_MINOR"
+}
+
 /** Schema is used to define the format of input/output data. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema-object). More fields may be added in the future as needed. */
 export declare interface Schema {
     /** Optional. The value should be validated against any (one or more) of the subschemas in the list. */
@@ -4150,7 +5050,7 @@ export declare interface Schema {
     type?: Type;
 }
 
-export declare type SchemaUnion = Schema;
+export declare type SchemaUnion = Schema | unknown;
 
 /** Google search entry point. */
 export declare interface SearchEntryPoint {
@@ -4366,11 +5266,24 @@ export declare interface SlidingWindow {
     targetTokens?: string;
 }
 
+/** The configuration for the speaker to use. */
+export declare interface SpeakerVoiceConfig {
+    /** The name of the speaker to use. Should be the same as in the
+     prompt. */
+    speaker?: string;
+    /** The configuration for the voice to use. */
+    voiceConfig?: VoiceConfig;
+}
+
 /** The speech generation configuration. */
 export declare interface SpeechConfig {
     /** The configuration for the speaker to use.
      */
     voiceConfig?: VoiceConfig;
+    /** The configuration for the multi-speaker setup.
+     It is mutually exclusive with the voice_config field.
+     */
+    multiSpeakerVoiceConfig?: MultiSpeakerVoiceConfig;
     /** Language code (ISO 639. e.g. en-US) for the speech synthesization.
      Only available for Live API.
      */
@@ -4381,8 +5294,17 @@ export declare type SpeechConfigUnion = SpeechConfig | string;
 
 /** Start of speech sensitivity. */
 export declare enum StartSensitivity {
+    /**
+     * The default is START_SENSITIVITY_LOW.
+     */
     START_SENSITIVITY_UNSPECIFIED = "START_SENSITIVITY_UNSPECIFIED",
+    /**
+     * Automatic detection will detect the start of speech more often.
+     */
     START_SENSITIVITY_HIGH = "START_SENSITIVITY_HIGH",
+    /**
+     * Automatic detection will detect the start of speech less often.
+     */
     START_SENSITIVITY_LOW = "START_SENSITIVITY_LOW"
 }
 
@@ -4577,6 +5499,8 @@ export declare interface TokensInfo {
 
 /** Tool details of a tool that the model may use to generate a response. */
 export declare interface Tool {
+    /** List of function declarations that the tool supports. */
+    functionDeclarations?: FunctionDeclaration[];
     /** Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. */
     retrieval?: Retrieval;
     /** Optional. Google Search tool type. Specialized retrieval tool
@@ -4590,10 +5514,10 @@ export declare interface Tool {
     /** Optional. Google Maps tool type. Specialized retrieval tool
      that is powered by Google Maps. */
     googleMaps?: GoogleMaps;
+    /** Optional. Tool to support URL context retrieval. */
+    urlContext?: UrlContext;
     /** Optional. CodeExecution tool type. Enables the model to execute code as part of generation. This field is only used by the Gemini Developer API services. */
     codeExecution?: ToolCodeExecution;
-    /** Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided. */
-    functionDeclarations?: FunctionDeclaration[];
 }
 
 /** Tool that executes code generated by the model, and automatically returns the result to the model. See also [ExecutableCode]and [CodeExecutionResult] which are input and output to this tool. */
@@ -4611,12 +5535,23 @@ export declare interface ToolConfig {
     retrievalConfig?: RetrievalConfig;
 }
 
-export declare type ToolListUnion = Tool[];
+export declare type ToolListUnion = ToolUnion[];
+
+export declare type ToolUnion = Tool | CallableTool;
 
 /** Output only. Traffic type. This shows whether a request consumes Pay-As-You-Go or Provisioned Throughput quota. */
 export declare enum TrafficType {
+    /**
+     * Unspecified request traffic type.
+     */
     TRAFFIC_TYPE_UNSPECIFIED = "TRAFFIC_TYPE_UNSPECIFIED",
+    /**
+     * Type for Pay-As-You-Go traffic.
+     */
     ON_DEMAND = "ON_DEMAND",
+    /**
+     * Type for Provisioned Throughput traffic.
+     */
     PROVISIONED_THROUGHPUT = "PROVISIONED_THROUGHPUT"
 }
 
@@ -4779,19 +5714,49 @@ export declare interface TuningValidationDataset {
 
 /** Options about which input is included in the user's turn. */
 export declare enum TurnCoverage {
+    /**
+     * If unspecified, the default behavior is `TURN_INCLUDES_ONLY_ACTIVITY`.
+     */
     TURN_COVERAGE_UNSPECIFIED = "TURN_COVERAGE_UNSPECIFIED",
+    /**
+     * The users turn only includes activity since the last turn, excluding inactivity (e.g. silence on the audio stream). This is the default behavior.
+     */
     TURN_INCLUDES_ONLY_ACTIVITY = "TURN_INCLUDES_ONLY_ACTIVITY",
+    /**
+     * The users turn includes all realtime input since the last turn, including inactivity (e.g. silence on the audio stream).
+     */
     TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT"
 }
 
 /** Optional. The type of the data. */
 export declare enum Type {
+    /**
+     * Not specified, should not be used.
+     */
     TYPE_UNSPECIFIED = "TYPE_UNSPECIFIED",
+    /**
+     * OpenAPI string type
+     */
     STRING = "STRING",
+    /**
+     * OpenAPI number type
+     */
     NUMBER = "NUMBER",
+    /**
+     * OpenAPI integer type
+     */
     INTEGER = "INTEGER",
+    /**
+     * OpenAPI boolean type
+     */
     BOOLEAN = "BOOLEAN",
+    /**
+     * OpenAPI array type
+     */
     ARRAY = "ARRAY",
+    /**
+     * OpenAPI object type
+     */
     OBJECT = "OBJECT"
 }
 
@@ -4811,9 +5776,9 @@ declare namespace types {
         HarmCategory,
         HarmBlockMethod,
         HarmBlockThreshold,
+        Type,
         Mode,
         AuthType,
-        Type,
         FinishReason,
         HarmProbability,
         HarmSeverity,
@@ -4824,8 +5789,10 @@ declare namespace types {
         JobState,
         AdapterSize,
         FeatureSelectionPreference,
+        Behavior,
         DynamicRetrievalConfigMode,
         FunctionCallingConfigMode,
+        UrlRetrievalStatus,
         SafetyFilterLevel,
         PersonGeneration,
         ImagePromptLanguage,
@@ -4840,8 +5807,12 @@ declare namespace types {
         EndSensitivity,
         ActivityHandling,
         TurnCoverage,
-        Blob_2 as Blob,
+        FunctionResponseScheduling,
+        Scale,
+        MusicGenerationMode,
+        LiveMusicPlaybackControl,
         VideoMetadata,
+        Blob_2 as Blob,
         CodeExecutionResult,
         ExecutableCode,
         FileData,
@@ -4852,6 +5823,9 @@ declare namespace types {
         HttpOptions,
         ModelSelectionConfig,
         SafetySetting,
+        Schema,
+        FunctionDeclaration,
+        Interval,
         GoogleSearch,
         DynamicRetrievalConfig,
         GoogleSearchRetrieval,
@@ -4863,6 +5837,7 @@ declare namespace types {
         AuthConfigOidcConfig,
         AuthConfig,
         GoogleMaps,
+        UrlContext,
         VertexAISearch,
         VertexRagStoreRagResource,
         RagRetrievalConfigFilter,
@@ -4874,8 +5849,6 @@ declare namespace types {
         VertexRagStore,
         Retrieval,
         ToolCodeExecution,
-        Schema,
-        FunctionDeclaration,
         Tool,
         FunctionCallingConfig,
         LatLng,
@@ -4883,7 +5856,10 @@ declare namespace types {
         ToolConfig,
         PrebuiltVoiceConfig,
         VoiceConfig,
+        SpeakerVoiceConfig,
+        MultiSpeakerVoiceConfig,
         SpeechConfig,
+        AutomaticFunctionCallingConfig,
         ThinkingConfig,
         GenerationConfigRoutingConfigAutoRoutingMode,
         GenerationConfigRoutingConfigManualRoutingMode,
@@ -4893,6 +5869,8 @@ declare namespace types {
         GoogleTypeDate,
         Citation,
         CitationMetadata,
+        UrlMetadata,
+        UrlContextMetadata,
         GroundingChunkRetrievedContext,
         GroundingChunkWeb,
         GroundingChunk,
@@ -5011,7 +5989,6 @@ declare namespace types {
         CreateFileParameters,
         HttpResponse,
         LiveCallbacks,
-        UploadFileParameters,
         CreateFileResponse,
         GetFileConfig,
         GetFileParameters,
@@ -5053,6 +6030,7 @@ declare namespace types {
         SlidingWindow,
         ContextWindowCompressionConfig,
         AudioTranscriptionConfig,
+        ProactivityConfig,
         LiveClientSetup,
         LiveClientContent,
         ActivityStart,
@@ -5067,6 +6045,26 @@ declare namespace types {
         SendMessageParameters,
         LiveSendClientContentParameters,
         LiveSendToolResponseParameters,
+        LiveMusicClientSetup,
+        WeightedPrompt,
+        LiveMusicClientContent,
+        LiveMusicGenerationConfig,
+        LiveMusicClientMessage,
+        LiveMusicServerSetupComplete,
+        LiveMusicSourceMetadata,
+        AudioChunk,
+        LiveMusicServerContent,
+        LiveMusicFilteredPrompt,
+        LiveMusicServerMessage,
+        LiveMusicCallbacks,
+        UploadFileParameters,
+        CallableTool,
+        CallableToolConfig,
+        LiveMusicConnectParameters,
+        LiveMusicSetConfigParameters,
+        LiveMusicSetWeightedPromptsParameters,
+        LiveEphemeralParameters,
+        CreateAuthTokenConfig,
         OperationGetParameters,
         BlobImageUnion,
         PartUnion,
@@ -5075,6 +6073,7 @@ declare namespace types {
         ContentListUnion,
         SchemaUnion,
         SpeechConfigUnion,
+        ToolUnion,
         ToolListUnion,
         DownloadableFileUnion
     }
@@ -5221,6 +6220,40 @@ export declare class UpscaleImageResponse {
     generatedImages?: GeneratedImage[];
 }
 
+/** Tool to support URL context retrieval. */
+export declare interface UrlContext {
+}
+
+/** Metadata related to url context retrieval tool. */
+export declare interface UrlContextMetadata {
+    /** List of url context. */
+    urlMetadata?: UrlMetadata[];
+}
+
+/** Context for a single url retrieval. */
+export declare interface UrlMetadata {
+    /** The URL retrieved by the tool. */
+    retrievedUrl?: string;
+    /** Status of the url retrieval. */
+    urlRetrievalStatus?: UrlRetrievalStatus;
+}
+
+/** Status of the url retrieval. */
+export declare enum UrlRetrievalStatus {
+    /**
+     * Default value. This value is unused
+     */
+    URL_RETRIEVAL_STATUS_UNSPECIFIED = "URL_RETRIEVAL_STATUS_UNSPECIFIED",
+    /**
+     * Url retrieval is successful.
+     */
+    URL_RETRIEVAL_STATUS_SUCCESS = "URL_RETRIEVAL_STATUS_SUCCESS",
+    /**
+     * Url retrieval is failed due to error.
+     */
+    URL_RETRIEVAL_STATUS_ERROR = "URL_RETRIEVAL_STATUS_ERROR"
+}
+
 /** Usage metadata about response(s). */
 export declare interface UsageMetadata {
     /** 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. */
@@ -5288,8 +6321,11 @@ export declare interface Video {
     mimeType?: string;
 }
 
-/** Metadata describes the input video content. */
+/** Describes how the video in the Part should be used by the model. */
 export declare interface VideoMetadata {
+    /** 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. */
@@ -5337,4 +6373,17 @@ declare interface WebSocketFactory {
     create(url: string, headers: Record<string, string>, callbacks: WebSocketCallbacks): WebSocket_2;
 }
 
+/** Maps a prompt to a relative weight to steer music generation. */
+export declare interface WeightedPrompt {
+    /** Text prompt. */
+    text?: string;
+    /** Weight of the prompt. The weight is used to control the relative
+     importance of the prompt. Higher weights are more important than lower
+     weights.
+
+     Weight must not be 0. Weights of all weighted_prompts in this
+     LiveMusicClientContent message will be normalized. */
+    weight?: number;
+}
+
 export { }