@google/genai 1.46.0 → 1.47.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/web/web.d.ts CHANGED
@@ -472,7 +472,7 @@ declare interface AudioContent {
472
472
  /**
473
473
  * The mime type of the audio.
474
474
  */
475
- mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac';
475
+ mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a';
476
476
  /**
477
477
  * The URI of the audio.
478
478
  */
@@ -639,7 +639,7 @@ declare interface BaseCreateAgentInteractionParams {
639
639
  /**
640
640
  * Body param: The input for the interaction.
641
641
  */
642
- input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent | GoogleMapsCallContent | GoogleMapsResultContent;
642
+ input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | CodeExecutionCallContent | URLContextCallContent | MCPServerToolCallContent | GoogleSearchCallContent | FileSearchCallContent | GoogleMapsCallContent | FunctionResultContent | CodeExecutionResultContent | URLContextResultContent | GoogleSearchResultContent | MCPServerToolResultContent | FileSearchResultContent | GoogleMapsResultContent;
643
643
  /**
644
644
  * Body param: Configuration parameters for the agent interaction.
645
645
  */
@@ -665,6 +665,10 @@ declare interface BaseCreateAgentInteractionParams {
665
665
  * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
666
666
  */
667
667
  response_modalities?: Array<'text' | 'image' | 'audio'>;
668
+ /**
669
+ * Body param: The service tier for the interaction.
670
+ */
671
+ service_tier?: 'flex' | 'standard' | 'priority';
668
672
  /**
669
673
  * Body param: Input only. Whether to store the response and request for later retrieval.
670
674
  */
@@ -691,7 +695,7 @@ declare interface BaseCreateModelInteractionParams {
691
695
  /**
692
696
  * Body param: The input for the interaction.
693
697
  */
694
- input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent | GoogleMapsCallContent | GoogleMapsResultContent;
698
+ input: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | CodeExecutionCallContent | URLContextCallContent | MCPServerToolCallContent | GoogleSearchCallContent | FileSearchCallContent | GoogleMapsCallContent | FunctionResultContent | CodeExecutionResultContent | URLContextResultContent | GoogleSearchResultContent | MCPServerToolResultContent | FileSearchResultContent | GoogleMapsResultContent;
695
699
  /**
696
700
  * Body param: The name of the `Model` used for generating the interaction.
697
701
  */
@@ -721,6 +725,10 @@ declare interface BaseCreateModelInteractionParams {
721
725
  * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
722
726
  */
723
727
  response_modalities?: Array<'text' | 'image' | 'audio'>;
728
+ /**
729
+ * Body param: The service tier for the interaction.
730
+ */
731
+ service_tier?: 'flex' | 'standard' | 'priority';
724
732
  /**
725
733
  * Body param: Input only. Whether to store the response and request for later retrieval.
726
734
  */
@@ -839,7 +847,7 @@ declare class BaseInteractions extends APIResource {
839
847
  * const interaction = await client.interactions.create({
840
848
  * api_version: 'api_version',
841
849
  * input: [{ text: 'text', type: 'text' }],
842
- * model: 'gemini-2.5-flash',
850
+ * model: 'gemini-2.5-computer-use-preview-10-2025',
843
851
  * });
844
852
  * ```
845
853
  */
@@ -1679,11 +1687,11 @@ declare interface CodeExecutionCallArguments {
1679
1687
  */
1680
1688
  declare interface CodeExecutionCallContent {
1681
1689
  /**
1682
- * A unique ID for this specific tool call.
1690
+ * Required. A unique ID for this specific tool call.
1683
1691
  */
1684
1692
  id: string;
1685
1693
  /**
1686
- * The arguments to pass to the code execution.
1694
+ * Required. The arguments to pass to the code execution.
1687
1695
  */
1688
1696
  arguments: CodeExecutionCallArguments;
1689
1697
  type: 'code_execution_call';
@@ -1710,11 +1718,11 @@ export declare interface CodeExecutionResult {
1710
1718
  */
1711
1719
  declare interface CodeExecutionResultContent {
1712
1720
  /**
1713
- * ID to match the ID from the code execution call block.
1721
+ * Required. ID to match the ID from the function call block.
1714
1722
  */
1715
1723
  call_id: string;
1716
1724
  /**
1717
- * The output of the code execution.
1725
+ * Required. The output of the code execution.
1718
1726
  */
1719
1727
  result: string;
1720
1728
  type: 'code_execution_result';
@@ -1810,14 +1818,18 @@ export declare interface Content {
1810
1818
  /**
1811
1819
  * The content of the response.
1812
1820
  */
1813
- declare type Content_2 = TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent | GoogleMapsCallContent | GoogleMapsResultContent;
1821
+ declare type Content_2 = TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | CodeExecutionCallContent | URLContextCallContent | MCPServerToolCallContent | GoogleSearchCallContent | FileSearchCallContent | GoogleMapsCallContent | FunctionResultContent | CodeExecutionResultContent | URLContextResultContent | GoogleSearchResultContent | MCPServerToolResultContent | FileSearchResultContent | GoogleMapsResultContent;
1814
1822
 
1815
1823
  declare interface ContentDelta {
1816
- delta: ContentDelta.Text | ContentDelta.Image | ContentDelta.Audio | ContentDelta.Document | ContentDelta.Video | ContentDelta.ThoughtSummary | ContentDelta.ThoughtSignature | ContentDelta.FunctionCall | ContentDelta.FunctionResult | ContentDelta.CodeExecutionCall | ContentDelta.CodeExecutionResult | ContentDelta.URLContextCall | ContentDelta.URLContextResult | ContentDelta.GoogleSearchCall | ContentDelta.GoogleSearchResult | ContentDelta.MCPServerToolCall | ContentDelta.MCPServerToolResult | ContentDelta.FileSearchCall | ContentDelta.FileSearchResult | ContentDelta.GoogleMapsCall | ContentDelta.GoogleMapsResult;
1824
+ /**
1825
+ * The delta content data for a content block.
1826
+ */
1827
+ delta: ContentDelta.Text | ContentDelta.Image | ContentDelta.Audio | ContentDelta.Document | ContentDelta.Video | ContentDelta.ThoughtSummary | ContentDelta.ThoughtSignature | ContentDelta.FunctionCall | ContentDelta.CodeExecutionCall | ContentDelta.URLContextCall | ContentDelta.GoogleSearchCall | ContentDelta.MCPServerToolCall | ContentDelta.FileSearchCall | ContentDelta.GoogleMapsCall | ContentDelta.FunctionResult | ContentDelta.CodeExecutionResult | ContentDelta.URLContextResult | ContentDelta.GoogleSearchResult | ContentDelta.MCPServerToolResult | ContentDelta.FileSearchResult | ContentDelta.GoogleMapsResult;
1817
1828
  event_type: 'content.delta';
1818
1829
  index: number;
1819
1830
  /**
1820
- * The event_id token to be used to resume the interaction stream, from this event.
1831
+ * The event_id token to be used to resume the interaction stream, from
1832
+ * this event.
1821
1833
  */
1822
1834
  event_id?: string;
1823
1835
  }
@@ -1834,7 +1846,7 @@ declare namespace ContentDelta {
1834
1846
  interface Image {
1835
1847
  type: 'image';
1836
1848
  data?: string;
1837
- mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
1849
+ mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif' | 'image/gif' | 'image/bmp' | 'image/tiff';
1838
1850
  /**
1839
1851
  * The resolution of the media.
1840
1852
  */
@@ -1844,7 +1856,7 @@ declare namespace ContentDelta {
1844
1856
  interface Audio {
1845
1857
  type: 'audio';
1846
1858
  data?: string;
1847
- mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac';
1859
+ mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a';
1848
1860
  uri?: string;
1849
1861
  }
1850
1862
  interface Document {
@@ -1879,7 +1891,7 @@ declare namespace ContentDelta {
1879
1891
  }
1880
1892
  interface FunctionCall {
1881
1893
  /**
1882
- * A unique ID for this specific tool call.
1894
+ * Required. A unique ID for this specific tool call.
1883
1895
  */
1884
1896
  id: string;
1885
1897
  arguments: {
@@ -1892,198 +1904,193 @@ declare namespace ContentDelta {
1892
1904
  */
1893
1905
  signature?: string;
1894
1906
  }
1895
- interface FunctionResult {
1907
+ interface CodeExecutionCall {
1896
1908
  /**
1897
- * ID to match the ID from the function call block.
1909
+ * Required. A unique ID for this specific tool call.
1898
1910
  */
1899
- call_id: string;
1911
+ id: string;
1900
1912
  /**
1901
- * Tool call result delta.
1913
+ * The arguments to pass to the code execution.
1902
1914
  */
1903
- result: FunctionResult.Items | unknown | string;
1904
- type: 'function_result';
1905
- is_error?: boolean;
1906
- name?: string;
1915
+ arguments: InteractionsAPI.CodeExecutionCallArguments;
1916
+ type: 'code_execution_call';
1907
1917
  /**
1908
1918
  * A signature hash for backend validation.
1909
1919
  */
1910
1920
  signature?: string;
1911
1921
  }
1912
- namespace FunctionResult {
1913
- interface Items {
1914
- items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
1915
- }
1916
- }
1917
- interface CodeExecutionCall {
1922
+ interface URLContextCall {
1918
1923
  /**
1919
- * A unique ID for this specific tool call.
1924
+ * Required. A unique ID for this specific tool call.
1920
1925
  */
1921
1926
  id: string;
1922
1927
  /**
1923
- * The arguments to pass to the code execution.
1928
+ * The arguments to pass to the URL context.
1924
1929
  */
1925
- arguments: InteractionsAPI.CodeExecutionCallArguments;
1926
- type: 'code_execution_call';
1930
+ arguments: InteractionsAPI.URLContextCallArguments;
1931
+ type: 'url_context_call';
1927
1932
  /**
1928
1933
  * A signature hash for backend validation.
1929
1934
  */
1930
1935
  signature?: string;
1931
1936
  }
1932
- interface CodeExecutionResult {
1937
+ interface GoogleSearchCall {
1933
1938
  /**
1934
- * ID to match the ID from the function call block.
1939
+ * Required. A unique ID for this specific tool call.
1935
1940
  */
1936
- call_id: string;
1937
- result: string;
1938
- type: 'code_execution_result';
1939
- is_error?: boolean;
1941
+ id: string;
1942
+ /**
1943
+ * The arguments to pass to Google Search.
1944
+ */
1945
+ arguments: InteractionsAPI.GoogleSearchCallArguments;
1946
+ type: 'google_search_call';
1940
1947
  /**
1941
1948
  * A signature hash for backend validation.
1942
1949
  */
1943
1950
  signature?: string;
1944
1951
  }
1945
- interface URLContextCall {
1952
+ interface MCPServerToolCall {
1946
1953
  /**
1947
- * A unique ID for this specific tool call.
1954
+ * Required. A unique ID for this specific tool call.
1948
1955
  */
1949
1956
  id: string;
1950
- /**
1951
- * The arguments to pass to the URL context.
1952
- */
1953
- arguments: InteractionsAPI.URLContextCallArguments;
1954
- type: 'url_context_call';
1957
+ arguments: {
1958
+ [key: string]: unknown;
1959
+ };
1960
+ name: string;
1961
+ server_name: string;
1962
+ type: 'mcp_server_tool_call';
1955
1963
  /**
1956
1964
  * A signature hash for backend validation.
1957
1965
  */
1958
1966
  signature?: string;
1959
1967
  }
1960
- interface URLContextResult {
1968
+ interface FileSearchCall {
1961
1969
  /**
1962
- * ID to match the ID from the function call block.
1970
+ * Required. A unique ID for this specific tool call.
1963
1971
  */
1964
- call_id: string;
1965
- result: Array<InteractionsAPI.URLContextResult>;
1966
- type: 'url_context_result';
1967
- is_error?: boolean;
1972
+ id: string;
1973
+ type: 'file_search_call';
1968
1974
  /**
1969
1975
  * A signature hash for backend validation.
1970
1976
  */
1971
1977
  signature?: string;
1972
1978
  }
1973
- interface GoogleSearchCall {
1979
+ interface GoogleMapsCall {
1974
1980
  /**
1975
- * A unique ID for this specific tool call.
1981
+ * Required. A unique ID for this specific tool call.
1976
1982
  */
1977
1983
  id: string;
1984
+ type: 'google_maps_call';
1978
1985
  /**
1979
- * The arguments to pass to Google Search.
1986
+ * The arguments to pass to the Google Maps tool.
1980
1987
  */
1981
- arguments: InteractionsAPI.GoogleSearchCallArguments;
1982
- type: 'google_search_call';
1988
+ arguments?: InteractionsAPI.GoogleMapsCallArguments;
1983
1989
  /**
1984
1990
  * A signature hash for backend validation.
1985
1991
  */
1986
1992
  signature?: string;
1987
1993
  }
1988
- interface GoogleSearchResult {
1994
+ interface FunctionResult {
1989
1995
  /**
1990
- * ID to match the ID from the function call block.
1996
+ * Required. ID to match the ID from the function call block.
1991
1997
  */
1992
1998
  call_id: string;
1993
- result: Array<InteractionsAPI.GoogleSearchResult>;
1994
- type: 'google_search_result';
1999
+ result: unknown | Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent> | string;
2000
+ type: 'function_result';
1995
2001
  is_error?: boolean;
2002
+ name?: string;
1996
2003
  /**
1997
2004
  * A signature hash for backend validation.
1998
2005
  */
1999
2006
  signature?: string;
2000
2007
  }
2001
- interface MCPServerToolCall {
2008
+ interface CodeExecutionResult {
2002
2009
  /**
2003
- * A unique ID for this specific tool call.
2010
+ * Required. ID to match the ID from the function call block.
2004
2011
  */
2005
- id: string;
2006
- arguments: {
2007
- [key: string]: unknown;
2008
- };
2009
- name: string;
2010
- server_name: string;
2011
- type: 'mcp_server_tool_call';
2012
+ call_id: string;
2013
+ result: string;
2014
+ type: 'code_execution_result';
2015
+ is_error?: boolean;
2012
2016
  /**
2013
2017
  * A signature hash for backend validation.
2014
2018
  */
2015
2019
  signature?: string;
2016
2020
  }
2017
- interface MCPServerToolResult {
2021
+ interface URLContextResult {
2018
2022
  /**
2019
- * ID to match the ID from the function call block.
2023
+ * Required. ID to match the ID from the function call block.
2020
2024
  */
2021
2025
  call_id: string;
2022
- /**
2023
- * Tool call result delta.
2024
- */
2025
- result: MCPServerToolResult.Items | unknown | string;
2026
- type: 'mcp_server_tool_result';
2027
- name?: string;
2028
- server_name?: string;
2026
+ result: Array<InteractionsAPI.URLContextResult>;
2027
+ type: 'url_context_result';
2028
+ is_error?: boolean;
2029
2029
  /**
2030
2030
  * A signature hash for backend validation.
2031
2031
  */
2032
2032
  signature?: string;
2033
2033
  }
2034
- namespace MCPServerToolResult {
2035
- interface Items {
2036
- items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
2037
- }
2038
- }
2039
- interface FileSearchCall {
2034
+ interface GoogleSearchResult {
2040
2035
  /**
2041
- * A unique ID for this specific tool call.
2036
+ * Required. ID to match the ID from the function call block.
2042
2037
  */
2043
- id: string;
2044
- type: 'file_search_call';
2038
+ call_id: string;
2039
+ result: Array<InteractionsAPI.GoogleSearchResult>;
2040
+ type: 'google_search_result';
2041
+ is_error?: boolean;
2045
2042
  /**
2046
2043
  * A signature hash for backend validation.
2047
2044
  */
2048
2045
  signature?: string;
2049
2046
  }
2050
- interface FileSearchResult {
2047
+ interface MCPServerToolResult {
2051
2048
  /**
2052
- * ID to match the ID from the function call block.
2049
+ * Required. ID to match the ID from the function call block.
2053
2050
  */
2054
2051
  call_id: string;
2055
- type: 'file_search_result';
2056
- result?: Array<unknown>;
2052
+ result: unknown | Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent> | string;
2053
+ type: 'mcp_server_tool_result';
2054
+ name?: string;
2055
+ server_name?: string;
2057
2056
  /**
2058
2057
  * A signature hash for backend validation.
2059
2058
  */
2060
2059
  signature?: string;
2061
2060
  }
2062
- interface GoogleMapsCall {
2063
- /**
2064
- * A unique ID for this specific tool call.
2065
- */
2066
- id: string;
2067
- type: 'google_maps_call';
2061
+ interface FileSearchResult {
2068
2062
  /**
2069
- * The arguments to pass to the Google Maps tool.
2063
+ * Required. ID to match the ID from the function call block.
2070
2064
  */
2071
- arguments?: InteractionsAPI.GoogleMapsCallArguments;
2065
+ call_id: string;
2066
+ result: Array<FileSearchResult.Result>;
2067
+ type: 'file_search_result';
2072
2068
  /**
2073
2069
  * A signature hash for backend validation.
2074
2070
  */
2075
2071
  signature?: string;
2076
2072
  }
2073
+ namespace FileSearchResult {
2074
+ /**
2075
+ * The result of the File Search.
2076
+ */
2077
+ interface Result {
2078
+ /**
2079
+ * User provided metadata about the FileSearchResult.
2080
+ */
2081
+ custom_metadata?: Array<unknown>;
2082
+ }
2083
+ }
2077
2084
  interface GoogleMapsResult {
2078
2085
  /**
2079
- * ID to match the ID from the function call block.
2086
+ * Required. ID to match the ID from the function call block.
2080
2087
  */
2081
2088
  call_id: string;
2089
+ type: 'google_maps_result';
2082
2090
  /**
2083
2091
  * The results of the Google Maps.
2084
2092
  */
2085
- result: Array<InteractionsAPI.GoogleMapsResult>;
2086
- type: 'google_maps_result';
2093
+ result?: Array<InteractionsAPI.GoogleMapsResult>;
2087
2094
  /**
2088
2095
  * A signature hash for backend validation.
2089
2096
  */
@@ -2139,7 +2146,8 @@ declare interface ContentStart {
2139
2146
  event_type: 'content.start';
2140
2147
  index: number;
2141
2148
  /**
2142
- * The event_id token to be used to resume the interaction stream, from this event.
2149
+ * The event_id token to be used to resume the interaction stream, from
2150
+ * this event.
2143
2151
  */
2144
2152
  event_id?: string;
2145
2153
  }
@@ -2148,7 +2156,8 @@ declare interface ContentStop {
2148
2156
  event_type: 'content.stop';
2149
2157
  index: number;
2150
2158
  /**
2151
- * The event_id token to be used to resume the interaction stream, from this event.
2159
+ * The event_id token to be used to resume the interaction stream, from
2160
+ * this event.
2152
2161
  */
2153
2162
  event_id?: string;
2154
2163
  }
@@ -2596,7 +2605,7 @@ export declare interface CreateTuningJobConfig {
2596
2605
  preTunedModelCheckpointId?: string;
2597
2606
  /** Adapter size for tuning. */
2598
2607
  adapterSize?: AdapterSize;
2599
- /** Tuning mode for SFT tuning. */
2608
+ /** Tuning mode for tuning. */
2600
2609
  tuningMode?: TuningMode;
2601
2610
  /** Custom base model for tuning. This is only supported for OSS models in Vertex. */
2602
2611
  customBaseModel?: string;
@@ -2908,7 +2917,7 @@ export declare interface DistillationDataStats {
2908
2917
  trainingDatasetStats?: DatasetStats;
2909
2918
  }
2910
2919
 
2911
- /** Hyperparameters for Distillation. This data type is not supported in Gemini API. */
2920
+ /** Hyperparameters for distillation. */
2912
2921
  export declare interface DistillationHyperParameters {
2913
2922
  /** Optional. Adapter size for distillation. */
2914
2923
  adapterSize?: AdapterSize;
@@ -2916,6 +2925,21 @@ export declare interface DistillationHyperParameters {
2916
2925
  epochCount?: string;
2917
2926
  /** Optional. Multiplier for adjusting the default learning rate. */
2918
2927
  learningRateMultiplier?: number;
2928
+ /** The batch size hyperparameter for tuning.
2929
+ This is only supported for OSS models in Vertex. */
2930
+ batchSize?: number;
2931
+ /** The learning rate for tuning. OSS models only. */
2932
+ learningRate?: number;
2933
+ }
2934
+
2935
+ /** Spec for creating a distilled dataset in Vertex Dataset. This data type is not supported in Gemini API. */
2936
+ export declare interface DistillationSamplingSpec {
2937
+ /** Optional. The base teacher model that is being distilled. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/tuning#supported_models). */
2938
+ baseTeacherModel?: string;
2939
+ /** Optional. The resource name of the Tuned teacher model. Format: `projects/{project}/locations/{location}/models/{model}`. */
2940
+ tunedTeacherModelSource?: string;
2941
+ /** Optional. Cloud Storage path to file containing validation dataset for distillation. The dataset must be formatted as a JSONL file. */
2942
+ validationDatasetUri?: string;
2919
2943
  }
2920
2944
 
2921
2945
  /** Distillation tuning spec for tuning. */
@@ -2936,20 +2960,21 @@ export declare interface DistillationSpec {
2936
2960
  tunedTeacherModelSource?: string;
2937
2961
  /** Optional. Cloud Storage path to file containing validation dataset for tuning. The dataset must be formatted as a JSONL file. */
2938
2962
  validationDatasetUri?: string;
2963
+ /** Tuning mode for tuning. */
2964
+ tuningMode?: TuningMode;
2939
2965
  }
2940
2966
 
2941
2967
  /** A Document is a collection of Chunks. */
2942
2968
  declare interface Document_2 {
2943
- /** The resource name of the Document.
2944
- Example: fileSearchStores/file-search-store-foo/documents/documents-bar */
2969
+ /** Immutable. Identifier. The `Document` resource name. The ID (name excluding the "fileSearchStores/&#42;/documents/" prefix) can contain up to 40 characters that are lowercase alphanumeric or dashes (-). The ID cannot start or end with a dash. If the name is empty on create, a unique name will be derived from `display_name` along with a 12 character random suffix. Example: `fileSearchStores/{file_search_store_id}/documents/my-awesome-doc-123a456b789c` */
2945
2970
  name?: string;
2946
- /** The human-readable display name for the Document. */
2971
+ /** Optional. The human-readable display name for the `Document`. The display name must be no more than 512 characters in length, including spaces. Example: "Semantic Retriever Documentation". */
2947
2972
  displayName?: string;
2948
- /** The current state of the Document. */
2973
+ /** Output only. Current state of the `Document`. */
2949
2974
  state?: DocumentState;
2950
- /** The size of the Document in bytes. */
2975
+ /** Output only. The size of raw bytes ingested into the Document. */
2951
2976
  sizeBytes?: string;
2952
- /** The MIME type of the Document. */
2977
+ /** Output only. The mime type of the Document. */
2953
2978
  mimeType?: string;
2954
2979
  /** Output only. The Timestamp of when the `Document` was created. */
2955
2980
  createTime?: string;
@@ -3013,11 +3038,23 @@ declare class Documents extends BaseModule {
3013
3038
  private listInternal;
3014
3039
  }
3015
3040
 
3016
- /** State for the lifecycle of a Document. */
3041
+ /** Output only. Current state of the `Document`. This enum is not supported in Vertex AI. */
3017
3042
  export declare enum DocumentState {
3043
+ /**
3044
+ * The default value. This value is used if the state is omitted.
3045
+ */
3018
3046
  STATE_UNSPECIFIED = "STATE_UNSPECIFIED",
3047
+ /**
3048
+ * Some `Chunks` of the `Document` are being processed (embedding and vector storage).
3049
+ */
3019
3050
  STATE_PENDING = "STATE_PENDING",
3051
+ /**
3052
+ * All `Chunks` of the `Document` is processed and available for querying.
3053
+ */
3020
3054
  STATE_ACTIVE = "STATE_ACTIVE",
3055
+ /**
3056
+ * Some `Chunks` of the `Document` failed processing.
3057
+ */
3021
3058
  STATE_FAILED = "STATE_FAILED"
3022
3059
  }
3023
3060
 
@@ -3359,7 +3396,8 @@ declare interface ErrorEvent_2 {
3359
3396
  */
3360
3397
  error?: ErrorEvent_2.Error;
3361
3398
  /**
3362
- * The event_id token to be used to resume the interaction stream, from this event.
3399
+ * The event_id token to be used to resume the interaction stream, from
3400
+ * this event.
3363
3401
  */
3364
3402
  event_id?: string;
3365
3403
  }
@@ -3416,7 +3454,7 @@ export declare interface EvaluateDatasetRun {
3416
3454
  evaluateDatasetResponse?: EvaluateDatasetResponse;
3417
3455
  /** Output only. The resource name of the evaluation run. Format: `projects/{project}/locations/{location}/evaluationRuns/{evaluation_run_id}`. */
3418
3456
  evaluationRun?: string;
3419
- /** Output only. The operation ID of the evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation_id}`. */
3457
+ /** Output only. Deprecated: The updated architecture uses evaluation_run instead. */
3420
3458
  operationName?: string;
3421
3459
  }
3422
3460
 
@@ -3573,6 +3611,8 @@ declare interface FileCitation {
3573
3611
  source?: string;
3574
3612
  /**
3575
3613
  * Start of segment of the response that is attributed to this source.
3614
+ *
3615
+ * Index indicates the start of the segment, measured in bytes.
3576
3616
  */
3577
3617
  start_index?: number;
3578
3618
  }
@@ -3707,14 +3747,13 @@ export declare class Files extends BaseModule {
3707
3747
  private registerFilesInternal;
3708
3748
  }
3709
3749
 
3710
- /** Tool to retrieve knowledge from the File Search Stores. */
3750
+ /** The FileSearch tool that retrieves knowledge from Semantic Retrieval corpora. Files are imported to Semantic Retrieval corpora using the ImportFile API. This data type is not supported in Vertex AI. */
3711
3751
  export declare interface FileSearch {
3712
- /** The names of the file_search_stores to retrieve from.
3713
- Example: `fileSearchStores/my-file-search-store-123` */
3752
+ /** Required. The names of the file_search_stores to retrieve from. Example: `fileSearchStores/my-file-search-store-123` */
3714
3753
  fileSearchStoreNames?: string[];
3715
- /** The number of file search retrieval chunks to retrieve. */
3754
+ /** Optional. The number of semantic retrieval chunks to retrieve. */
3716
3755
  topK?: number;
3717
- /** Metadata filter to apply to the file search retrieval documents. See https://google.aip.dev/160 for the syntax of the filter expression. */
3756
+ /** Optional. Metadata filter to apply to the semantic retrieval documents and chunks. */
3718
3757
  metadataFilter?: string;
3719
3758
  }
3720
3759
 
@@ -3723,7 +3762,7 @@ export declare interface FileSearch {
3723
3762
  */
3724
3763
  declare interface FileSearchCallContent {
3725
3764
  /**
3726
- * A unique ID for this specific tool call.
3765
+ * Required. A unique ID for this specific tool call.
3727
3766
  */
3728
3767
  id: string;
3729
3768
  type: 'file_search_call';
@@ -3738,20 +3777,32 @@ declare interface FileSearchCallContent {
3738
3777
  */
3739
3778
  declare interface FileSearchResultContent {
3740
3779
  /**
3741
- * ID to match the ID from the file search call block.
3780
+ * Required. ID to match the ID from the function call block.
3742
3781
  */
3743
3782
  call_id: string;
3744
- type: 'file_search_result';
3745
3783
  /**
3746
- * The results of the File Search.
3784
+ * Required. The results of the File Search.
3747
3785
  */
3748
- result?: Array<unknown>;
3786
+ result: Array<FileSearchResultContent.Result>;
3787
+ type: 'file_search_result';
3749
3788
  /**
3750
3789
  * A signature hash for backend validation.
3751
3790
  */
3752
3791
  signature?: string;
3753
3792
  }
3754
3793
 
3794
+ declare namespace FileSearchResultContent {
3795
+ /**
3796
+ * The result of the File Search.
3797
+ */
3798
+ interface Result {
3799
+ /**
3800
+ * User provided metadata about the FileSearchResult.
3801
+ */
3802
+ custom_metadata?: Array<unknown>;
3803
+ }
3804
+ }
3805
+
3755
3806
  /** A collection of Documents. */
3756
3807
  export declare interface FileSearchStore {
3757
3808
  /** The resource name of the FileSearchStore. Example: `fileSearchStores/my-file-search-store-123` */
@@ -4037,17 +4088,17 @@ export declare interface FunctionCall {
4037
4088
  */
4038
4089
  declare interface FunctionCallContent {
4039
4090
  /**
4040
- * A unique ID for this specific tool call.
4091
+ * Required. A unique ID for this specific tool call.
4041
4092
  */
4042
4093
  id: string;
4043
4094
  /**
4044
- * The arguments to pass to the function.
4095
+ * Required. The arguments to pass to the function.
4045
4096
  */
4046
4097
  arguments: {
4047
4098
  [key: string]: unknown;
4048
4099
  };
4049
4100
  /**
4050
- * The name of the tool to call.
4101
+ * Required. The name of the tool to call.
4051
4102
  */
4052
4103
  name: string;
4053
4104
  type: 'function_call';
@@ -4193,7 +4244,7 @@ export declare enum FunctionResponseScheduling {
4193
4244
  */
4194
4245
  declare interface FunctionResultContent {
4195
4246
  /**
4196
- * ID to match the ID from the function call block.
4247
+ * Required. ID to match the ID from the function call block.
4197
4248
  */
4198
4249
  call_id: string;
4199
4250
  /**
@@ -4416,6 +4467,8 @@ export declare interface GenerateContentConfig {
4416
4467
  service. If supplied, safety_settings must not be supplied.
4417
4468
  */
4418
4469
  modelArmorConfig?: ModelArmorConfig;
4470
+ /** The service tier to use for the request. For example, SERVICE_TIER_FLEX. */
4471
+ serviceTier?: ServiceTier;
4419
4472
  }
4420
4473
 
4421
4474
  /** Config for models.generate_content parameters. */
@@ -4452,6 +4505,8 @@ export declare class GenerateContentResponse {
4452
4505
  responseId?: string;
4453
4506
  /** Usage metadata about the response(s). */
4454
4507
  usageMetadata?: GenerateContentResponseUsageMetadata;
4508
+ /** Output only. The current model status of this model. This field is not supported in Vertex AI. */
4509
+ modelStatus?: ModelStatus;
4455
4510
  /**
4456
4511
  * Returns the concatenation of all text parts from the first candidate in the response.
4457
4512
  *
@@ -4781,6 +4836,8 @@ export declare interface GenerateVideosConfig {
4781
4836
  mask?: VideoGenerationMask;
4782
4837
  /** Compression quality of the generated videos. */
4783
4838
  compressionQuality?: VideoCompressionQuality;
4839
+ /** User specified labels to track billing usage. */
4840
+ labels?: Record<string, string>;
4784
4841
  }
4785
4842
 
4786
4843
  /** A video generation operation. */
@@ -4797,7 +4854,6 @@ export declare class GenerateVideosOperation implements Operation<GenerateVideos
4797
4854
  response?: GenerateVideosResponse;
4798
4855
  /**
4799
4856
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
4800
- * @internal
4801
4857
  */
4802
4858
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<GenerateVideosResponse>;
4803
4859
  /** The full HTTP response. */
@@ -4936,7 +4992,7 @@ declare interface GenerationConfig_2 {
4936
4992
  */
4937
4993
  thinking_summaries?: 'auto' | 'none';
4938
4994
  /**
4939
- * The tool choice for the interaction.
4995
+ * The tool choice configuration.
4940
4996
  */
4941
4997
  tool_choice?: ToolChoiceType | ToolChoiceConfig;
4942
4998
  /**
@@ -5286,7 +5342,7 @@ declare interface GoogleMapsCallArguments {
5286
5342
  */
5287
5343
  declare interface GoogleMapsCallContent {
5288
5344
  /**
5289
- * A unique ID for this specific tool call.
5345
+ * Required. A unique ID for this specific tool call.
5290
5346
  */
5291
5347
  id: string;
5292
5348
  type: 'google_maps_call';
@@ -5361,11 +5417,11 @@ declare namespace GoogleMapsResult {
5361
5417
  */
5362
5418
  declare interface GoogleMapsResultContent {
5363
5419
  /**
5364
- * ID to match the ID from the google maps call block.
5420
+ * Required. ID to match the ID from the function call block.
5365
5421
  */
5366
5422
  call_id: string;
5367
5423
  /**
5368
- * The results of the Google Maps.
5424
+ * Required. The results of the Google Maps.
5369
5425
  */
5370
5426
  result: Array<GoogleMapsResult>;
5371
5427
  type: 'google_maps_result';
@@ -5385,9 +5441,9 @@ export declare interface GoogleRpcStatus {
5385
5441
  message?: string;
5386
5442
  }
5387
5443
 
5388
- /** Tool to support web search. */
5444
+ /** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
5389
5445
  export declare interface GoogleSearch {
5390
- /** Different types of search that can be enabled on the GoogleSearch tool. */
5446
+ /** Optional. The set of search types to enable. If not set, web search is enabled by default. */
5391
5447
  searchTypes?: SearchTypes;
5392
5448
  /** Optional. Sites with confidence level chosen & above this value will be blocked from the search results. This field is not supported in Gemini API. */
5393
5449
  blockingConfidence?: PhishBlockThreshold;
@@ -5412,11 +5468,11 @@ declare interface GoogleSearchCallArguments {
5412
5468
  */
5413
5469
  declare interface GoogleSearchCallContent {
5414
5470
  /**
5415
- * A unique ID for this specific tool call.
5471
+ * Required. A unique ID for this specific tool call.
5416
5472
  */
5417
5473
  id: string;
5418
5474
  /**
5419
- * The arguments to pass to Google Search.
5475
+ * Required. The arguments to pass to Google Search.
5420
5476
  */
5421
5477
  arguments: GoogleSearchCallArguments;
5422
5478
  type: 'google_search_call';
@@ -5445,11 +5501,11 @@ declare interface GoogleSearchResult {
5445
5501
  */
5446
5502
  declare interface GoogleSearchResultContent {
5447
5503
  /**
5448
- * ID to match the ID from the google search call block.
5504
+ * Required. ID to match the ID from the function call block.
5449
5505
  */
5450
5506
  call_id: string;
5451
5507
  /**
5452
- * The results of the Google Search.
5508
+ * Required. The results of the Google Search.
5453
5509
  */
5454
5510
  result: Array<GoogleSearchResult>;
5455
5511
  type: 'google_search_result';
@@ -5485,9 +5541,7 @@ export declare interface GoogleTypeDate {
5485
5541
  is enabled, the model returns a `GroundingChunk` that contains a reference to
5486
5542
  the source of the information. */
5487
5543
  export declare interface GroundingChunk {
5488
- /** A grounding chunk from an image search result. See the `Image`
5489
- message for details.
5490
- */
5544
+ /** A grounding chunk from an image search result. See the `Image` message for details. */
5491
5545
  image?: GroundingChunkImage;
5492
5546
  /** A `Maps` chunk is a piece of evidence that comes from Google Maps.
5493
5547
 
@@ -5495,17 +5549,25 @@ export declare interface GroundingChunk {
5495
5549
  reviews. This is used to provide the user with rich, location-based
5496
5550
  information. */
5497
5551
  maps?: GroundingChunkMaps;
5498
- /** A grounding chunk from a data source retrieved by a retrieval tool, such as Vertex AI Search. See the `RetrievedContext` message for details. This field is not supported in Gemini API. */
5552
+ /** A grounding chunk from a data source retrieved by a retrieval tool, such as Vertex AI Search. See the `RetrievedContext` message for details */
5499
5553
  retrievedContext?: GroundingChunkRetrievedContext;
5500
5554
  /** A grounding chunk from a web page, typically from Google Search. See the `Web` message for details. */
5501
5555
  web?: GroundingChunkWeb;
5502
5556
  }
5503
5557
 
5504
- /** A piece of evidence that comes from an image search result.
5558
+ /** User provided metadata about the GroundingFact. This data type is not supported in Vertex AI. */
5559
+ export declare interface GroundingChunkCustomMetadata {
5560
+ /** The key of the metadata. */
5561
+ key?: string;
5562
+ /** Optional. The numeric value of the metadata. The expected range for this value depends on the specific `key` used. */
5563
+ numericValue?: number;
5564
+ /** Optional. A list of string values for the metadata. */
5565
+ stringListValue?: GroundingChunkStringList;
5566
+ /** Optional. The string value of the metadata. */
5567
+ stringValue?: string;
5568
+ }
5505
5569
 
5506
- It contains the URI of the image search result and the URI of the image.
5507
- This is used to provide the user with a link to the source of the
5508
- information. */
5570
+ /** An `Image` chunk is a piece of evidence that comes from an image search result. It contains the URI of the image search result and the URI of the image. This is used to provide the user with a link to the source of the information. */
5509
5571
  export declare interface GroundingChunkImage {
5510
5572
  /** The URI of the image search result page. */
5511
5573
  sourceUri?: string;
@@ -5537,6 +5599,8 @@ export declare interface GroundingChunkMaps {
5537
5599
  title?: string;
5538
5600
  /** The URI of the place. */
5539
5601
  uri?: string;
5602
+ /** Output only. Route information. */
5603
+ route?: GroundingChunkMapsRoute;
5540
5604
  }
5541
5605
 
5542
5606
  /** The sources that were used to generate the place answer.
@@ -5580,11 +5644,21 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
5580
5644
  title?: string;
5581
5645
  }
5582
5646
 
5583
- /** Context retrieved from a data source to ground the model's response. This is used when a retrieval tool fetches information from a user-provided corpus or a public dataset. This data type is not supported in Gemini API. */
5647
+ /** Route information from Google Maps. This data type is not supported in Gemini API. */
5648
+ export declare interface GroundingChunkMapsRoute {
5649
+ /** The total distance of the route, in meters. */
5650
+ distanceMeters?: number;
5651
+ /** The total duration of the route. */
5652
+ duration?: string;
5653
+ /** An encoded polyline of the route. See https://developers.google.com/maps/documentation/utilities/polylinealgorithm */
5654
+ encodedPolyline?: string;
5655
+ }
5656
+
5657
+ /** Context retrieved from a data source to ground the model's response. This is used when a retrieval tool fetches information from a user-provided corpus or a public dataset. */
5584
5658
  export declare interface GroundingChunkRetrievedContext {
5585
- /** Output only. The full resource name of the referenced Vertex AI Search document. This is used to identify the specific document that was retrieved. The format is `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`. */
5659
+ /** Output only. The full resource name of the referenced Vertex AI Search document. This is used to identify the specific document that was retrieved. The format is `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`. This field is not supported in Gemini API. */
5586
5660
  documentName?: string;
5587
- /** Additional context for a Retrieval-Augmented Generation (RAG) retrieval result. This is populated only when the RAG retrieval tool is used. */
5661
+ /** Additional context for a Retrieval-Augmented Generation (RAG) retrieval result. This is populated only when the RAG retrieval tool is used. This field is not supported in Gemini API. */
5588
5662
  ragChunk?: RagChunk;
5589
5663
  /** The content of the retrieved data source. */
5590
5664
  text?: string;
@@ -5592,6 +5666,16 @@ export declare interface GroundingChunkRetrievedContext {
5592
5666
  title?: string;
5593
5667
  /** The URI of the retrieved data source. */
5594
5668
  uri?: string;
5669
+ /** Optional. User-provided metadata about the retrieved context. This field is not supported in Vertex AI. */
5670
+ customMetadata?: GroundingChunkCustomMetadata[];
5671
+ /** Optional. Name of the `FileSearchStore` containing the document. Example: `fileSearchStores/123`. This field is not supported in Vertex AI. */
5672
+ fileSearchStore?: string;
5673
+ }
5674
+
5675
+ /** A list of string values. This data type is not supported in Vertex AI. */
5676
+ export declare interface GroundingChunkStringList {
5677
+ /** The string values of the list. */
5678
+ values?: string[];
5595
5679
  }
5596
5680
 
5597
5681
  /** A `Web` chunk is a piece of evidence that comes from a web page. It contains the URI of the web page, the title of the page, and the domain of the page. This is used to provide the user with a link to the source of the information. */
@@ -5606,10 +5690,7 @@ export declare interface GroundingChunkWeb {
5606
5690
 
5607
5691
  /** Information for various kinds of grounding. */
5608
5692
  export declare interface GroundingMetadata {
5609
- /** Optional. The image search queries that were used to generate the
5610
- content. This field is populated only when the grounding source is Google
5611
- Search with the Image Search search_type enabled.
5612
- */
5693
+ /** Optional. The image search queries that were used to generate the content. This field is populated only when the grounding source is Google Search with the Image Search search_type enabled. */
5613
5694
  imageSearchQueries?: string[];
5614
5695
  /** A list of supporting references retrieved from the grounding
5615
5696
  source. This field is populated when the grounding source is Google
@@ -5625,7 +5706,7 @@ export declare interface GroundingMetadata {
5625
5706
  searchEntryPoint?: SearchEntryPoint;
5626
5707
  /** Web search queries for the following-up web search. */
5627
5708
  webSearchQueries?: string[];
5628
- /** Optional. Output only. A token that can be used to render a Google Maps widget with the contextual data. This field is populated only when the grounding source is Google Maps. This field is not supported in Gemini API. */
5709
+ /** Optional. Output only. A token that can be used to render a Google Maps widget with the contextual data. This field is populated only when the grounding source is Google Maps. */
5629
5710
  googleMapsWidgetContextToken?: string;
5630
5711
  /** Optional. The queries that were executed by the retrieval tools. This field is populated only when the grounding source is a retrieval tool, such as Vertex AI Search. This field is not supported in Gemini API. */
5631
5712
  retrievalQueries?: string[];
@@ -5655,6 +5736,8 @@ export declare interface GroundingSupport {
5655
5736
  groundingChunkIndices?: number[];
5656
5737
  /** Segment of the content this support belongs to. */
5657
5738
  segment?: Segment;
5739
+ /** Indices into the `rendered_parts` field of the `GroundingMetadata` message. These indices specify which rendered parts are associated with this support message. */
5740
+ renderedParts?: number[];
5658
5741
  }
5659
5742
 
5660
5743
  /** The method for blocking content. If not specified, the default behavior is to use the probability score. This enum is not supported in Gemini API. */
@@ -5948,11 +6031,7 @@ export declare interface ImageConfig {
5948
6031
  /** Controls the generation of people. Supported values are:
5949
6032
  ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE. */
5950
6033
  personGeneration?: string;
5951
- /** Controls whether prominent people (celebrities)
5952
- generation is allowed. If used with personGeneration, personGeneration
5953
- enum would take precedence. For instance, if ALLOW_NONE is set, all person
5954
- generation would be blocked. If this field is unspecified, the default
5955
- behavior is to allow prominent people. */
6034
+ /** Optional. Controls whether prominent people (celebrities) generation is allowed. If used with personGeneration, personGeneration enum would take precedence. For instance, if ALLOW_NONE is set, all person generation would be blocked. If this field is unspecified, the default behavior is to allow prominent people. This field is not supported in Gemini API. */
5956
6035
  prominentPeople?: ProminentPeople;
5957
6036
  /** MIME type of the generated image. This field is not
5958
6037
  supported in Gemini API. */
@@ -5960,7 +6039,7 @@ export declare interface ImageConfig {
5960
6039
  /** Compression quality of the generated image (for
5961
6040
  ``image/jpeg`` only). This field is not supported in Gemini API. */
5962
6041
  outputCompressionQuality?: number;
5963
- /** Optional. The image output format for generated images. */
6042
+ /** Optional. The image output format for generated images. This field is not supported in Gemini API. */
5964
6043
  imageOutputOptions?: ImageConfigImageOutputOptions;
5965
6044
  }
5966
6045
 
@@ -5992,7 +6071,7 @@ declare interface ImageContent {
5992
6071
  /**
5993
6072
  * The mime type of the image.
5994
6073
  */
5995
- mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
6074
+ mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif' | 'image/gif' | 'image/bmp' | 'image/tiff';
5996
6075
  /**
5997
6076
  * The resolution of the media.
5998
6077
  */
@@ -6074,7 +6153,6 @@ export declare class ImportFileOperation implements Operation<ImportFileResponse
6074
6153
  response?: ImportFileResponse;
6075
6154
  /**
6076
6155
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
6077
- * @internal
6078
6156
  */
6079
6157
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<ImportFileResponse>;
6080
6158
  /** The full HTTP response. */
@@ -6103,12 +6181,12 @@ export declare class ImportFileResponse {
6103
6181
 
6104
6182
  /** Config for `inlined_embedding_responses` parameter. */
6105
6183
  export declare class InlinedEmbedContentResponse {
6106
- /** The response to the request.
6107
- */
6184
+ /** Output only. The response to the request. */
6108
6185
  response?: SingleEmbedContentResponse;
6109
- /** The error encountered while processing the request.
6110
- */
6186
+ /** Output only. The error encountered while processing the request. */
6111
6187
  error?: JobError;
6188
+ /** Output only. The metadata associated with the request. */
6189
+ metadata?: Record<string, unknown>;
6112
6190
  }
6113
6191
 
6114
6192
  /** Config for inlined request. */
@@ -6143,20 +6221,20 @@ export declare class InlinedResponse {
6143
6221
  */
6144
6222
  declare interface Interaction {
6145
6223
  /**
6146
- * Output only. A unique identifier for the interaction completion.
6224
+ * Required. Output only. A unique identifier for the interaction completion.
6147
6225
  */
6148
6226
  id: string;
6149
6227
  /**
6150
- * Output only. The time at which the response was created in ISO 8601 format
6228
+ * Required. Output only. The time at which the response was created in ISO 8601 format
6151
6229
  * (YYYY-MM-DDThh:mm:ssZ).
6152
6230
  */
6153
6231
  created: string;
6154
6232
  /**
6155
- * Output only. The status of the interaction.
6233
+ * Required. Output only. The status of the interaction.
6156
6234
  */
6157
6235
  status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
6158
6236
  /**
6159
- * Output only. The time at which the response was last updated in ISO 8601 format
6237
+ * Required. Output only. The time at which the response was last updated in ISO 8601 format
6160
6238
  * (YYYY-MM-DDThh:mm:ssZ).
6161
6239
  */
6162
6240
  updated: string;
@@ -6171,7 +6249,7 @@ declare interface Interaction {
6171
6249
  /**
6172
6250
  * The input for the interaction.
6173
6251
  */
6174
- input?: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent | GoogleMapsCallContent | GoogleMapsResultContent;
6252
+ input?: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | CodeExecutionCallContent | URLContextCallContent | MCPServerToolCallContent | GoogleSearchCallContent | FileSearchCallContent | GoogleMapsCallContent | FunctionResultContent | CodeExecutionResultContent | URLContextResultContent | GoogleSearchResultContent | MCPServerToolResultContent | FileSearchResultContent | GoogleMapsResultContent;
6175
6253
  /**
6176
6254
  * The name of the `Model` used for generating the interaction.
6177
6255
  */
@@ -6201,6 +6279,10 @@ declare interface Interaction {
6201
6279
  * Output only. The role of the interaction.
6202
6280
  */
6203
6281
  role?: string;
6282
+ /**
6283
+ * The service tier for the interaction.
6284
+ */
6285
+ service_tier?: 'flex' | 'standard' | 'priority';
6204
6286
  /**
6205
6287
  * System instruction for the interaction.
6206
6288
  */
@@ -6225,12 +6307,13 @@ declare interface InteractionCancelParams {
6225
6307
  declare interface InteractionCompleteEvent {
6226
6308
  event_type: 'interaction.complete';
6227
6309
  /**
6228
- * The completed interaction with empty outputs to reduce the payload size.
6310
+ * Required. The completed interaction with empty outputs to reduce the payload size.
6229
6311
  * Use the preceding ContentDelta events for the actual output.
6230
6312
  */
6231
6313
  interaction: Interaction;
6232
6314
  /**
6233
- * The event_id token to be used to resume the interaction stream, from this event.
6315
+ * The event_id token to be used to resume the interaction stream, from
6316
+ * this event.
6234
6317
  */
6235
6318
  event_id?: string;
6236
6319
  }
@@ -6378,7 +6461,8 @@ declare interface InteractionStartEvent {
6378
6461
  */
6379
6462
  interaction: Interaction;
6380
6463
  /**
6381
- * The event_id token to be used to resume the interaction stream, from this event.
6464
+ * The event_id token to be used to resume the interaction stream, from
6465
+ * this event.
6382
6466
  */
6383
6467
  event_id?: string;
6384
6468
  }
@@ -6388,7 +6472,8 @@ declare interface InteractionStatusUpdate {
6388
6472
  interaction_id: string;
6389
6473
  status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
6390
6474
  /**
6391
- * The event_id token to be used to resume the interaction stream, from this event.
6475
+ * The event_id token to be used to resume the interaction stream, from
6476
+ * this event.
6392
6477
  */
6393
6478
  event_id?: string;
6394
6479
  }
@@ -6630,6 +6715,7 @@ export declare interface ListFileSearchStoresParameters {
6630
6715
  export declare class ListFileSearchStoresResponse {
6631
6716
  /** Used to retain the full HTTP response. */
6632
6717
  sdkHttpResponse?: HttpResponse;
6718
+ /** A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no more pages. */
6633
6719
  nextPageToken?: string;
6634
6720
  /** The returned file search stores. */
6635
6721
  fileSearchStores?: FileSearchStore[];
@@ -7498,6 +7584,8 @@ export declare interface LogprobsResult {
7498
7584
  chosenCandidates?: LogprobsResultCandidate[];
7499
7585
  /** A list of the top candidate tokens at each decoding step. The length of this list is equal to the total number of decoding steps. */
7500
7586
  topCandidates?: LogprobsResultTopCandidates[];
7587
+ /** Sum of log probabilities for all tokens. This field is not supported in Vertex AI. */
7588
+ logProbabilitySum?: number;
7501
7589
  }
7502
7590
 
7503
7591
  /** A single token and its associated log probability. */
@@ -7573,21 +7661,21 @@ export declare interface McpServer {
7573
7661
  */
7574
7662
  declare interface MCPServerToolCallContent {
7575
7663
  /**
7576
- * A unique ID for this specific tool call.
7664
+ * Required. A unique ID for this specific tool call.
7577
7665
  */
7578
7666
  id: string;
7579
7667
  /**
7580
- * The JSON object of arguments for the function.
7668
+ * Required. The JSON object of arguments for the function.
7581
7669
  */
7582
7670
  arguments: {
7583
7671
  [key: string]: unknown;
7584
7672
  };
7585
7673
  /**
7586
- * The name of the tool which was called.
7674
+ * Required. The name of the tool which was called.
7587
7675
  */
7588
7676
  name: string;
7589
7677
  /**
7590
- * The name of the used MCP server.
7678
+ * Required. The name of the used MCP server.
7591
7679
  */
7592
7680
  server_name: string;
7593
7681
  type: 'mcp_server_tool_call';
@@ -7602,7 +7690,7 @@ declare interface MCPServerToolCallContent {
7602
7690
  */
7603
7691
  declare interface MCPServerToolResultContent {
7604
7692
  /**
7605
- * ID to match the ID from the MCP server tool call block.
7693
+ * Required. ID to match the ID from the function call block.
7606
7694
  */
7607
7695
  call_id: string;
7608
7696
  /**
@@ -7778,7 +7866,7 @@ export declare interface Model {
7778
7866
  /**
7779
7867
  * The model that will complete your prompt.\n\nSee [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
7780
7868
  */
7781
- declare type Model_2 = 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | (string & {});
7869
+ declare type Model_2 = 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
7782
7870
 
7783
7871
  /** Configuration for Model Armor. Model Armor is a Google Cloud service that provides safety and security filtering for prompts and responses. It helps protect your AI applications from risks such as harmful content, sensitive data leakage, and prompt injection attacks. This data type is not supported in Gemini API. */
7784
7872
  export declare interface ModelArmorConfig {
@@ -8184,6 +8272,52 @@ export declare interface ModelSelectionConfig {
8184
8272
  featureSelectionPreference?: FeatureSelectionPreference;
8185
8273
  }
8186
8274
 
8275
+ /** The stage of the underlying model. This enum is not supported in Vertex AI. */
8276
+ export declare enum ModelStage {
8277
+ /**
8278
+ * Unspecified model stage.
8279
+ */
8280
+ MODEL_STAGE_UNSPECIFIED = "MODEL_STAGE_UNSPECIFIED",
8281
+ /**
8282
+ * The underlying model is subject to lots of tunings.
8283
+ */
8284
+ UNSTABLE_EXPERIMENTAL = "UNSTABLE_EXPERIMENTAL",
8285
+ /**
8286
+ * Models in this stage are for experimental purposes only.
8287
+ */
8288
+ EXPERIMENTAL = "EXPERIMENTAL",
8289
+ /**
8290
+ * Models in this stage are more mature than experimental models.
8291
+ */
8292
+ PREVIEW = "PREVIEW",
8293
+ /**
8294
+ * Models in this stage are considered stable and ready for production use.
8295
+ */
8296
+ STABLE = "STABLE",
8297
+ /**
8298
+ * If the model is on this stage, it means that this model is on the path to deprecation in near future. Only existing customers can use this model.
8299
+ */
8300
+ LEGACY = "LEGACY",
8301
+ /**
8302
+ * Models in this stage are deprecated. These models cannot be used.
8303
+ */
8304
+ DEPRECATED = "DEPRECATED",
8305
+ /**
8306
+ * Models in this stage are retired. These models cannot be used.
8307
+ */
8308
+ RETIRED = "RETIRED"
8309
+ }
8310
+
8311
+ /** The status of the underlying model. This is used to indicate the stage of the underlying model and the retirement time if applicable. This data type is not supported in Vertex AI. */
8312
+ export declare interface ModelStatus {
8313
+ /** A message explaining the model status. */
8314
+ message?: string;
8315
+ /** The stage of the underlying model. */
8316
+ modelStage?: ModelStage;
8317
+ /** The time at which the model will be retired. */
8318
+ retirementTime?: string;
8319
+ }
8320
+
8187
8321
  /** Configuration for a multi-speaker text-to-speech request. */
8188
8322
  export declare interface MultiSpeakerVoiceConfig {
8189
8323
  /** Required. A list of configurations for the voices of the speakers. Exactly two speaker voice configurations must be provided. */
@@ -8269,7 +8403,6 @@ export declare interface Operation<T> {
8269
8403
  response?: T;
8270
8404
  /**
8271
8405
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
8272
- * @internal
8273
8406
  */
8274
8407
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<T>;
8275
8408
  }
@@ -8548,6 +8681,8 @@ export declare interface Part {
8548
8681
  toolCall?: ToolCall;
8549
8682
  /** The output from a server-side ToolCall execution. This field is populated by the client with the results of executing the corresponding ToolCall. */
8550
8683
  toolResponse?: ToolResponse;
8684
+ /** Custom metadata associated with the Part. Agents using genai.Part as content representation may need to keep track of the additional information. For example it can be name of a file/source from which the Part originates or a way to multiplex multiple Part streams. This field is not supported in Vertex AI. */
8685
+ partMetadata?: Record<string, unknown>;
8551
8686
  }
8552
8687
 
8553
8688
  /** Partial argument value of the function call. This data type is not supported in Gemini API. */
@@ -8689,6 +8824,8 @@ declare interface PlaceCitation {
8689
8824
  review_snippets?: Array<PlaceCitation.ReviewSnippet>;
8690
8825
  /**
8691
8826
  * Start of segment of the response that is attributed to this source.
8827
+ *
8828
+ * Index indicates the start of the segment, measured in bytes.
8692
8829
  */
8693
8830
  start_index?: number;
8694
8831
  /**
@@ -8806,7 +8943,7 @@ export declare interface ProductImage {
8806
8943
  productImage?: Image_2;
8807
8944
  }
8808
8945
 
8809
- /** Enum for controlling whether the model can generate images of prominent people (celebrities). */
8946
+ /** Controls whether prominent people (celebrities) generation is allowed. If used with personGeneration, personGeneration enum would take precedence. For instance, if ALLOW_NONE is set, all person generation would be blocked. If this field is unspecified, the default behavior is to allow prominent people. This enum is not supported in Gemini API. */
8810
8947
  export declare enum ProminentPeople {
8811
8948
  /**
8812
8949
  * Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.
@@ -9083,12 +9220,14 @@ export declare class ReplayResponse {
9083
9220
  sdkResponseSegments?: Record<string, unknown>[];
9084
9221
  }
9085
9222
 
9086
- /** ReplicatedVoiceConfig is used to configure replicated voice. */
9223
+ /** The configuration for the replicated voice to use. */
9087
9224
  export declare interface ReplicatedVoiceConfig {
9088
- /** The mime type of the replicated voice.
9225
+ /** The mimetype of the voice sample. The only currently supported
9226
+ value is `audio/wav`. This represents 16-bit signed little-endian wav
9227
+ data, with a 24kHz sampling rate.
9089
9228
  */
9090
9229
  mimeType?: string;
9091
- /** The sample audio of the replicated voice.
9230
+ /** The sample of the custom voice.
9092
9231
 
9093
9232
  * @remarks Encoded as base64 string. */
9094
9233
  voiceSampleAudio?: string;
@@ -9332,7 +9471,7 @@ export declare interface Schema {
9332
9471
  anyOf?: Schema[];
9333
9472
  /** Optional. Default value to use if the field is not specified. */
9334
9473
  default?: unknown;
9335
- /** Optional. Description of the schema. */
9474
+ /** Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. */
9336
9475
  description?: string;
9337
9476
  /** Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` */
9338
9477
  enum?: string[];
@@ -9392,12 +9531,11 @@ export declare interface SearchEntryPoint {
9392
9531
  sdkBlob?: string;
9393
9532
  }
9394
9533
 
9395
- /** Tool to support computer use. */
9534
+ /** Different types of search that can be enabled on the GoogleSearch tool. */
9396
9535
  export declare interface SearchTypes {
9397
- /** Setting this field enables web search. Only text results are
9398
- returned. */
9536
+ /** Optional. Setting this field enables web search. Only text results are returned. */
9399
9537
  webSearch?: WebSearch;
9400
- /** Setting this field enables image search. Image bytes are returned. */
9538
+ /** Optional. Setting this field enables image search. Image bytes are returned. */
9401
9539
  imageSearch?: ImageSearch;
9402
9540
  }
9403
9541
 
@@ -9510,6 +9648,26 @@ export declare interface SendMessageParameters {
9510
9648
  config?: GenerateContentConfig;
9511
9649
  }
9512
9650
 
9651
+ /** Pricing and performance service tier. */
9652
+ export declare enum ServiceTier {
9653
+ /**
9654
+ * Default service tier, which is standard.
9655
+ */
9656
+ SERVICE_TIER_UNSPECIFIED = "SERVICE_TIER_UNSPECIFIED",
9657
+ /**
9658
+ * Flex service tier.
9659
+ */
9660
+ SERVICE_TIER_FLEX = "SERVICE_TIER_FLEX",
9661
+ /**
9662
+ * Standard service tier.
9663
+ */
9664
+ SERVICE_TIER_STANDARD = "SERVICE_TIER_STANDARD",
9665
+ /**
9666
+ * Priority service tier.
9667
+ */
9668
+ SERVICE_TIER_PRIORITY = "SERVICE_TIER_PRIORITY"
9669
+ }
9670
+
9513
9671
  /**
9514
9672
  Represents a connection to the API.
9515
9673
 
@@ -9699,8 +9857,9 @@ export declare interface SpeakerVoiceConfig {
9699
9857
  voiceConfig?: VoiceConfig;
9700
9858
  }
9701
9859
 
9860
+ /** Config for speech generation and transcription. */
9702
9861
  export declare interface SpeechConfig {
9703
- /** Configuration for the voice of the response. */
9862
+ /** The configuration in case of single-voice output. */
9704
9863
  voiceConfig?: VoiceConfig;
9705
9864
  /** Optional. The language code (ISO 639-1) for the speech synthesis. */
9706
9865
  languageCode?: string;
@@ -9969,7 +10128,7 @@ export declare interface TestTableItem {
9969
10128
  */
9970
10129
  declare interface TextContent {
9971
10130
  /**
9972
- * The text content.
10131
+ * Required. The text content.
9973
10132
  */
9974
10133
  text: string;
9975
10134
  type: 'text';
@@ -9997,6 +10156,10 @@ export declare enum ThinkingLevel {
9997
10156
  * Unspecified thinking level.
9998
10157
  */
9999
10158
  THINKING_LEVEL_UNSPECIFIED = "THINKING_LEVEL_UNSPECIFIED",
10159
+ /**
10160
+ * MINIMAL thinking level.
10161
+ */
10162
+ MINIMAL = "MINIMAL",
10000
10163
  /**
10001
10164
  * Low thinking level.
10002
10165
  */
@@ -10008,11 +10171,7 @@ export declare enum ThinkingLevel {
10008
10171
  /**
10009
10172
  * High thinking level.
10010
10173
  */
10011
- HIGH = "HIGH",
10012
- /**
10013
- * MINIMAL thinking level.
10014
- */
10015
- MINIMAL = "MINIMAL"
10174
+ HIGH = "HIGH"
10016
10175
  }
10017
10176
 
10018
10177
  declare type ThinkingLevel_2 = 'minimal' | 'low' | 'medium' | 'high';
@@ -10140,9 +10299,9 @@ export declare interface Tool {
10140
10299
  computer. If enabled, it automatically populates computer-use specific
10141
10300
  Function Declarations. */
10142
10301
  computerUse?: ComputerUse;
10143
- /** Optional. Tool to retrieve knowledge from the File Search Stores. */
10302
+ /** Optional. FileSearch tool type. Tool to retrieve knowledge from Semantic Retrieval corpora. This field is not supported in Vertex AI. */
10144
10303
  fileSearch?: FileSearch;
10145
- /** Enables the model to execute Google Search as part of generation. */
10304
+ /** Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
10146
10305
  googleSearch?: GoogleSearch;
10147
10306
  /** Optional. Tool that allows grounding the model's response with
10148
10307
  geospatial context related to the user's query. */
@@ -10166,19 +10325,9 @@ export declare interface Tool {
10166
10325
  /**
10167
10326
  * A tool that can be used by the model.
10168
10327
  */
10169
- declare type Tool_2 = Function_2 | Tool_2.GoogleSearch | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.FileSearch | Tool_2.GoogleMaps;
10328
+ declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch | Tool_2.GoogleMaps;
10170
10329
 
10171
10330
  declare namespace Tool_2 {
10172
- /**
10173
- * A tool that can be used by the model to search Google.
10174
- */
10175
- interface GoogleSearch {
10176
- type: 'google_search';
10177
- /**
10178
- * The types of search grounding to enable.
10179
- */
10180
- search_types?: Array<'web_search' | 'image_search'>;
10181
- }
10182
10331
  /**
10183
10332
  * A tool that can be used by the model to execute code.
10184
10333
  */
@@ -10230,6 +10379,16 @@ declare namespace Tool_2 {
10230
10379
  */
10231
10380
  url?: string;
10232
10381
  }
10382
+ /**
10383
+ * A tool that can be used by the model to search Google.
10384
+ */
10385
+ interface GoogleSearch {
10386
+ type: 'google_search';
10387
+ /**
10388
+ * The types of search grounding to enable.
10389
+ */
10390
+ search_types?: Array<'web_search' | 'image_search'>;
10391
+ }
10233
10392
  /**
10234
10393
  * A tool that can be used by the model to search files.
10235
10394
  */
@@ -10252,6 +10411,7 @@ declare namespace Tool_2 {
10252
10411
  * A tool that can be used by the model to call Google Maps.
10253
10412
  */
10254
10413
  interface GoogleMaps {
10414
+ type: 'google_maps';
10255
10415
  /**
10256
10416
  * Whether to return a widget context token in the tool call result of the
10257
10417
  * response.
@@ -10265,7 +10425,6 @@ declare namespace Tool_2 {
10265
10425
  * The longitude of the user's location.
10266
10426
  */
10267
10427
  longitude?: number;
10268
- type?: 'google_maps';
10269
10428
  }
10270
10429
  }
10271
10430
 
@@ -10393,11 +10552,9 @@ export declare enum TrafficType {
10393
10552
 
10394
10553
  /** Audio transcription in Server Conent. */
10395
10554
  export declare interface Transcription {
10396
- /** Transcription text.
10397
- */
10555
+ /** Optional. Transcription text. */
10398
10556
  text?: string;
10399
- /** The bool indicates the end of the transcription.
10400
- */
10557
+ /** Optional. The bool indicates the end of the transcription. */
10401
10558
  finished?: boolean;
10402
10559
  }
10403
10560
 
@@ -10535,6 +10692,18 @@ export declare interface TuningJob {
10535
10692
  tuningJobState?: TuningJobState;
10536
10693
  /** Tuning Spec for Veo Tuning. */
10537
10694
  veoTuningSpec?: VeoTuningSpec;
10695
+ /** Optional. Spec for creating a distillation dataset. */
10696
+ distillationSamplingSpec?: DistillationSamplingSpec;
10697
+ /** Output only. Tuning Job metadata. */
10698
+ tuningJobMetadata?: TuningJobMetadata;
10699
+ }
10700
+
10701
+ /** Tuning job metadata. This data type is not supported in Gemini API. */
10702
+ export declare interface TuningJobMetadata {
10703
+ /** Output only. The number of epochs that have been completed. */
10704
+ completedEpochCount?: string;
10705
+ /** Output only. The number of steps that have been completed. Set for Multi-Step RL. */
10706
+ completedStepCount?: string;
10538
10707
  }
10539
10708
 
10540
10709
  /** Output only. The detail state of the tuning job (while the overall `JobState` is running). This enum is not supported in Gemini API. */
@@ -10695,10 +10864,7 @@ export declare interface TuningValidationDataset {
10695
10864
  }
10696
10865
 
10697
10866
  declare interface Turn {
10698
- /**
10699
- * The content of the turn.
10700
- */
10701
- content?: string | Array<Content_2>;
10867
+ content?: Array<Content_2> | string;
10702
10868
  /**
10703
10869
  * The originator of this turn. Must be user for input or model for
10704
10870
  * model output.
@@ -10739,7 +10905,11 @@ export declare enum TurnCoverage {
10739
10905
  /**
10740
10906
  * The users turn includes all realtime input since the last turn, including inactivity (e.g. silence on the audio stream).
10741
10907
  */
10742
- TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT"
10908
+ TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT",
10909
+ /**
10910
+ * Includes audio activity and all video since the last turn. With automatic activity detection, audio activity means speech and excludes silence.
10911
+ */
10912
+ TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO = "TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO"
10743
10913
  }
10744
10914
 
10745
10915
  /** Data type of the schema field. */
@@ -10795,15 +10965,17 @@ declare namespace types {
10795
10965
  Outcome,
10796
10966
  FunctionResponseScheduling,
10797
10967
  Type,
10798
- PhishBlockThreshold,
10968
+ Environment,
10799
10969
  AuthType,
10800
10970
  HttpElementLocation,
10801
10971
  ApiSpec,
10972
+ PhishBlockThreshold,
10802
10973
  Behavior,
10803
10974
  DynamicRetrievalConfigMode,
10804
10975
  FunctionCallingConfigMode,
10805
10976
  ThinkingLevel,
10806
10977
  PersonGeneration,
10978
+ ProminentPeople,
10807
10979
  HarmCategory,
10808
10980
  HarmBlockMethod,
10809
10981
  HarmBlockThreshold,
@@ -10814,6 +10986,7 @@ declare namespace types {
10814
10986
  BlockedReason,
10815
10987
  TrafficType,
10816
10988
  Modality,
10989
+ ModelStage,
10817
10990
  MediaResolution,
10818
10991
  TuningMode,
10819
10992
  AdapterSize,
@@ -10822,12 +10995,12 @@ declare namespace types {
10822
10995
  AggregationMetric,
10823
10996
  PairwiseChoice,
10824
10997
  TuningTask,
10998
+ DocumentState,
10825
10999
  PartMediaResolutionLevel,
10826
11000
  ToolType,
10827
11001
  ResourceScope,
11002
+ ServiceTier,
10828
11003
  FeatureSelectionPreference,
10829
- Environment,
10830
- ProminentPeople,
10831
11004
  EmbeddingApiType,
10832
11005
  SafetyFilterLevel,
10833
11006
  ImagePromptLanguage,
@@ -10840,7 +11013,6 @@ declare namespace types {
10840
11013
  VideoGenerationMaskMode,
10841
11014
  VideoCompressionQuality,
10842
11015
  TuningMethod,
10843
- DocumentState,
10844
11016
  FileState,
10845
11017
  FileSource,
10846
11018
  TurnCompleteReason,
@@ -10875,12 +11047,6 @@ declare namespace types {
10875
11047
  Schema,
10876
11048
  ModelSelectionConfig,
10877
11049
  ComputerUse,
10878
- FileSearch,
10879
- WebSearch,
10880
- ImageSearch,
10881
- SearchTypes,
10882
- Interval,
10883
- GoogleSearch,
10884
11050
  ApiKeyConfig,
10885
11051
  AuthConfigGoogleServiceAccountConfig,
10886
11052
  AuthConfigHttpBasicAuthConfig,
@@ -10904,6 +11070,12 @@ declare namespace types {
10904
11070
  RagRetrievalConfig,
10905
11071
  VertexRagStore,
10906
11072
  Retrieval,
11073
+ FileSearch,
11074
+ WebSearch,
11075
+ ImageSearch,
11076
+ SearchTypes,
11077
+ Interval,
11078
+ GoogleSearch,
10907
11079
  ToolCodeExecution,
10908
11080
  EnterpriseWebSearch,
10909
11081
  FunctionDeclaration,
@@ -10940,13 +11112,16 @@ declare namespace types {
10940
11112
  GoogleTypeDate,
10941
11113
  Citation,
10942
11114
  CitationMetadata,
10943
- GroundingChunkImage,
10944
11115
  GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
10945
11116
  GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
10946
11117
  GroundingChunkMapsPlaceAnswerSources,
11118
+ GroundingChunkMapsRoute,
10947
11119
  GroundingChunkMaps,
11120
+ GroundingChunkImage,
10948
11121
  RagChunkPageSpan,
10949
11122
  RagChunk,
11123
+ GroundingChunkStringList,
11124
+ GroundingChunkCustomMetadata,
10950
11125
  GroundingChunkRetrievedContext,
10951
11126
  GroundingChunkWeb,
10952
11127
  GroundingChunk,
@@ -10966,6 +11141,7 @@ declare namespace types {
10966
11141
  GenerateContentResponsePromptFeedback,
10967
11142
  ModalityTokenCount,
10968
11143
  GenerateContentResponseUsageMetadata,
11144
+ ModelStatus,
10969
11145
  GenerateContentResponse,
10970
11146
  ReferenceImage,
10971
11147
  EditImageParameters,
@@ -11076,6 +11252,8 @@ declare namespace types {
11076
11252
  FullFineTuningSpec,
11077
11253
  VeoHyperParameters,
11078
11254
  VeoTuningSpec,
11255
+ DistillationSamplingSpec,
11256
+ TuningJobMetadata,
11079
11257
  TuningJob,
11080
11258
  ListTuningJobsConfig,
11081
11259
  ListTuningJobsParameters,
@@ -11449,7 +11627,6 @@ export declare class UploadToFileSearchStoreOperation implements Operation<Uploa
11449
11627
  response?: UploadToFileSearchStoreResponse;
11450
11628
  /**
11451
11629
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
11452
- * @internal
11453
11630
  */
11454
11631
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<UploadToFileSearchStoreResponse>;
11455
11632
  /** The full HTTP response. */
@@ -11562,6 +11739,8 @@ declare interface URLCitation {
11562
11739
  end_index?: number;
11563
11740
  /**
11564
11741
  * Start of segment of the response that is attributed to this source.
11742
+ *
11743
+ * Index indicates the start of the segment, measured in bytes.
11565
11744
  */
11566
11745
  start_index?: number;
11567
11746
  /**
@@ -11593,11 +11772,11 @@ declare interface URLContextCallArguments {
11593
11772
  */
11594
11773
  declare interface URLContextCallContent {
11595
11774
  /**
11596
- * A unique ID for this specific tool call.
11775
+ * Required. A unique ID for this specific tool call.
11597
11776
  */
11598
11777
  id: string;
11599
11778
  /**
11600
- * The arguments to pass to the URL context.
11779
+ * Required. The arguments to pass to the URL context.
11601
11780
  */
11602
11781
  arguments: URLContextCallArguments;
11603
11782
  type: 'url_context_call';
@@ -11632,11 +11811,11 @@ declare interface URLContextResult {
11632
11811
  */
11633
11812
  declare interface URLContextResultContent {
11634
11813
  /**
11635
- * ID to match the ID from the url context call block.
11814
+ * Required. ID to match the ID from the function call block.
11636
11815
  */
11637
11816
  call_id: string;
11638
11817
  /**
11639
- * The results of the URL context.
11818
+ * Required. The results of the URL context.
11640
11819
  */
11641
11820
  result: Array<URLContextResult>;
11642
11821
  type: 'url_context_result';
@@ -12041,16 +12220,17 @@ export declare enum VoiceActivityType {
12041
12220
  ACTIVITY_END = "ACTIVITY_END"
12042
12221
  }
12043
12222
 
12223
+ /** The configuration for the voice to use. */
12044
12224
  export declare interface VoiceConfig {
12045
- /** If true, the model will use a replicated voice for the response. */
12225
+ /** The configuration for a replicated voice, which is a clone of a
12226
+ user's voice that can be used for speech synthesis. If this is unset, a
12227
+ default voice is used. */
12046
12228
  replicatedVoiceConfig?: ReplicatedVoiceConfig;
12047
12229
  /** The configuration for a prebuilt voice. */
12048
12230
  prebuiltVoiceConfig?: PrebuiltVoiceConfig;
12049
12231
  }
12050
12232
 
12051
- /** Standard web search for grounding and related configurations.
12052
-
12053
- Only text results are returned. */
12233
+ /** Standard web search for grounding and related configurations. Only text results are returned. */
12054
12234
  export declare interface WebSearch {
12055
12235
  }
12056
12236