@google/genai 1.45.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.
@@ -157,23 +157,7 @@ declare interface AllowedTools {
157
157
  /**
158
158
  * Citation information for model-generated content.
159
159
  */
160
- declare interface Annotation {
161
- /**
162
- * End of the attributed segment, exclusive.
163
- */
164
- end_index?: number;
165
- /**
166
- * Source attributed for a portion of the text. Could be a URL, title, or
167
- * other identifier.
168
- */
169
- source?: string;
170
- /**
171
- * Start of segment of the response that is attributed to this source.
172
- *
173
- * Index indicates the start of the segment, measured in bytes.
174
- */
175
- start_index?: number;
176
- }
160
+ declare type Annotation = URLCitation | FileCitation | PlaceCitation;
177
161
 
178
162
  /** The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. This data type is not supported in Gemini API. */
179
163
  export declare interface ApiAuth {
@@ -488,7 +472,7 @@ declare interface AudioContent {
488
472
  /**
489
473
  * The mime type of the audio.
490
474
  */
491
- 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';
492
476
  /**
493
477
  * The URI of the audio.
494
478
  */
@@ -655,7 +639,7 @@ declare interface BaseCreateAgentInteractionParams {
655
639
  /**
656
640
  * Body param: The input for the interaction.
657
641
  */
658
- 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;
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;
659
643
  /**
660
644
  * Body param: Configuration parameters for the agent interaction.
661
645
  */
@@ -681,6 +665,10 @@ declare interface BaseCreateAgentInteractionParams {
681
665
  * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
682
666
  */
683
667
  response_modalities?: Array<'text' | 'image' | 'audio'>;
668
+ /**
669
+ * Body param: The service tier for the interaction.
670
+ */
671
+ service_tier?: 'flex' | 'standard' | 'priority';
684
672
  /**
685
673
  * Body param: Input only. Whether to store the response and request for later retrieval.
686
674
  */
@@ -707,7 +695,7 @@ declare interface BaseCreateModelInteractionParams {
707
695
  /**
708
696
  * Body param: The input for the interaction.
709
697
  */
710
- 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;
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;
711
699
  /**
712
700
  * Body param: The name of the `Model` used for generating the interaction.
713
701
  */
@@ -737,6 +725,10 @@ declare interface BaseCreateModelInteractionParams {
737
725
  * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
738
726
  */
739
727
  response_modalities?: Array<'text' | 'image' | 'audio'>;
728
+ /**
729
+ * Body param: The service tier for the interaction.
730
+ */
731
+ service_tier?: 'flex' | 'standard' | 'priority';
740
732
  /**
741
733
  * Body param: Input only. Whether to store the response and request for later retrieval.
742
734
  */
@@ -855,7 +847,7 @@ declare class BaseInteractions extends APIResource {
855
847
  * const interaction = await client.interactions.create({
856
848
  * api_version: 'api_version',
857
849
  * input: [{ text: 'text', type: 'text' }],
858
- * model: 'gemini-2.5-flash',
850
+ * model: 'gemini-2.5-computer-use-preview-10-2025',
859
851
  * });
860
852
  * ```
861
853
  */
@@ -1695,22 +1687,30 @@ declare interface CodeExecutionCallArguments {
1695
1687
  */
1696
1688
  declare interface CodeExecutionCallContent {
1697
1689
  /**
1698
- * A unique ID for this specific tool call.
1690
+ * Required. A unique ID for this specific tool call.
1699
1691
  */
1700
1692
  id: string;
1701
1693
  /**
1702
- * The arguments to pass to the code execution.
1694
+ * Required. The arguments to pass to the code execution.
1703
1695
  */
1704
1696
  arguments: CodeExecutionCallArguments;
1705
1697
  type: 'code_execution_call';
1698
+ /**
1699
+ * A signature hash for backend validation.
1700
+ */
1701
+ signature?: string;
1706
1702
  }
1707
1703
 
1708
- /** Result of executing the [ExecutableCode]. Only generated when using the [CodeExecution] tool, and always follows a `part` containing the [ExecutableCode]. */
1704
+ /** Result of executing the `ExecutableCode`.
1705
+
1706
+ Generated only when the `CodeExecution` tool is used. */
1709
1707
  export declare interface CodeExecutionResult {
1710
1708
  /** Required. Outcome of the code execution. */
1711
1709
  outcome?: Outcome;
1712
1710
  /** Optional. Contains stdout when code execution is successful, stderr or other description otherwise. */
1713
1711
  output?: string;
1712
+ /** The identifier of the `ExecutableCode` part this result is for. Only populated if the corresponding `ExecutableCode` has an id. */
1713
+ id?: string;
1714
1714
  }
1715
1715
 
1716
1716
  /**
@@ -1718,11 +1718,11 @@ export declare interface CodeExecutionResult {
1718
1718
  */
1719
1719
  declare interface CodeExecutionResultContent {
1720
1720
  /**
1721
- * ID to match the ID from the code execution call block.
1721
+ * Required. ID to match the ID from the function call block.
1722
1722
  */
1723
1723
  call_id: string;
1724
1724
  /**
1725
- * The output of the code execution.
1725
+ * Required. The output of the code execution.
1726
1726
  */
1727
1727
  result: string;
1728
1728
  type: 'code_execution_result';
@@ -1818,20 +1818,24 @@ export declare interface Content {
1818
1818
  /**
1819
1819
  * The content of the response.
1820
1820
  */
1821
- declare type Content_2 = TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
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;
1822
1822
 
1823
1823
  declare interface ContentDelta {
1824
- delta: ContentDelta.TextDelta | ContentDelta.ImageDelta | ContentDelta.AudioDelta | ContentDelta.DocumentDelta | ContentDelta.VideoDelta | ContentDelta.ThoughtSummaryDelta | ContentDelta.ThoughtSignatureDelta | ContentDelta.FunctionCallDelta | ContentDelta.FunctionResultDelta | ContentDelta.CodeExecutionCallDelta | ContentDelta.CodeExecutionResultDelta | ContentDelta.URLContextCallDelta | ContentDelta.URLContextResultDelta | ContentDelta.GoogleSearchCallDelta | ContentDelta.GoogleSearchResultDelta | ContentDelta.MCPServerToolCallDelta | ContentDelta.MCPServerToolResultDelta | ContentDelta.FileSearchCallDelta | ContentDelta.FileSearchResultDelta;
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;
1825
1828
  event_type: 'content.delta';
1826
1829
  index: number;
1827
1830
  /**
1828
- * 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.
1829
1833
  */
1830
1834
  event_id?: string;
1831
1835
  }
1832
1836
 
1833
1837
  declare namespace ContentDelta {
1834
- interface TextDelta {
1838
+ interface Text {
1835
1839
  text: string;
1836
1840
  type: 'text';
1837
1841
  /**
@@ -1839,29 +1843,29 @@ declare namespace ContentDelta {
1839
1843
  */
1840
1844
  annotations?: Array<InteractionsAPI.Annotation>;
1841
1845
  }
1842
- interface ImageDelta {
1846
+ interface Image {
1843
1847
  type: 'image';
1844
1848
  data?: string;
1845
- 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';
1846
1850
  /**
1847
1851
  * The resolution of the media.
1848
1852
  */
1849
1853
  resolution?: 'low' | 'medium' | 'high' | 'ultra_high';
1850
1854
  uri?: string;
1851
1855
  }
1852
- interface AudioDelta {
1856
+ interface Audio {
1853
1857
  type: 'audio';
1854
1858
  data?: string;
1855
- 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';
1856
1860
  uri?: string;
1857
1861
  }
1858
- interface DocumentDelta {
1862
+ interface Document {
1859
1863
  type: 'document';
1860
1864
  data?: string;
1861
1865
  mime_type?: 'application/pdf';
1862
1866
  uri?: string;
1863
1867
  }
1864
- interface VideoDelta {
1868
+ interface Video {
1865
1869
  type: 'video';
1866
1870
  data?: string;
1867
1871
  mime_type?: 'video/mp4' | 'video/mpeg' | 'video/mpg' | 'video/mov' | 'video/avi' | 'video/x-flv' | 'video/webm' | 'video/wmv' | 'video/3gpp';
@@ -1871,23 +1875,23 @@ declare namespace ContentDelta {
1871
1875
  resolution?: 'low' | 'medium' | 'high' | 'ultra_high';
1872
1876
  uri?: string;
1873
1877
  }
1874
- interface ThoughtSummaryDelta {
1878
+ interface ThoughtSummary {
1875
1879
  type: 'thought_summary';
1876
1880
  /**
1877
1881
  * A new summary item to be added to the thought.
1878
1882
  */
1879
1883
  content?: InteractionsAPI.TextContent | InteractionsAPI.ImageContent;
1880
1884
  }
1881
- interface ThoughtSignatureDelta {
1885
+ interface ThoughtSignature {
1882
1886
  type: 'thought_signature';
1883
1887
  /**
1884
1888
  * Signature to match the backend source to be part of the generation.
1885
1889
  */
1886
1890
  signature?: string;
1887
1891
  }
1888
- interface FunctionCallDelta {
1892
+ interface FunctionCall {
1889
1893
  /**
1890
- * A unique ID for this specific tool call.
1894
+ * Required. A unique ID for this specific tool call.
1891
1895
  */
1892
1896
  id: string;
1893
1897
  arguments: {
@@ -1895,32 +1899,14 @@ declare namespace ContentDelta {
1895
1899
  };
1896
1900
  name: string;
1897
1901
  type: 'function_call';
1898
- }
1899
- interface FunctionResultDelta {
1900
- /**
1901
- * ID to match the ID from the function call block.
1902
- */
1903
- call_id: string;
1904
- /**
1905
- * Tool call result delta.
1906
- */
1907
- result: FunctionResultDelta.Items | unknown | string;
1908
- type: 'function_result';
1909
- is_error?: boolean;
1910
- name?: string;
1911
1902
  /**
1912
1903
  * A signature hash for backend validation.
1913
1904
  */
1914
1905
  signature?: string;
1915
1906
  }
1916
- namespace FunctionResultDelta {
1917
- interface Items {
1918
- items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
1919
- }
1920
- }
1921
- interface CodeExecutionCallDelta {
1907
+ interface CodeExecutionCall {
1922
1908
  /**
1923
- * A unique ID for this specific tool call.
1909
+ * Required. A unique ID for this specific tool call.
1924
1910
  */
1925
1911
  id: string;
1926
1912
  /**
@@ -1928,23 +1914,14 @@ declare namespace ContentDelta {
1928
1914
  */
1929
1915
  arguments: InteractionsAPI.CodeExecutionCallArguments;
1930
1916
  type: 'code_execution_call';
1931
- }
1932
- interface CodeExecutionResultDelta {
1933
- /**
1934
- * ID to match the ID from the function call block.
1935
- */
1936
- call_id: string;
1937
- result: string;
1938
- type: 'code_execution_result';
1939
- is_error?: boolean;
1940
1917
  /**
1941
1918
  * A signature hash for backend validation.
1942
1919
  */
1943
1920
  signature?: string;
1944
1921
  }
1945
- interface URLContextCallDelta {
1922
+ interface URLContextCall {
1946
1923
  /**
1947
- * A unique ID for this specific tool call.
1924
+ * Required. A unique ID for this specific tool call.
1948
1925
  */
1949
1926
  id: string;
1950
1927
  /**
@@ -1952,23 +1929,14 @@ declare namespace ContentDelta {
1952
1929
  */
1953
1930
  arguments: InteractionsAPI.URLContextCallArguments;
1954
1931
  type: 'url_context_call';
1955
- }
1956
- interface URLContextResultDelta {
1957
- /**
1958
- * ID to match the ID from the function call block.
1959
- */
1960
- call_id: string;
1961
- result: Array<InteractionsAPI.URLContextResult>;
1962
- type: 'url_context_result';
1963
- is_error?: boolean;
1964
1932
  /**
1965
1933
  * A signature hash for backend validation.
1966
1934
  */
1967
1935
  signature?: string;
1968
1936
  }
1969
- interface GoogleSearchCallDelta {
1937
+ interface GoogleSearchCall {
1970
1938
  /**
1971
- * A unique ID for this specific tool call.
1939
+ * Required. A unique ID for this specific tool call.
1972
1940
  */
1973
1941
  id: string;
1974
1942
  /**
@@ -1976,23 +1944,14 @@ declare namespace ContentDelta {
1976
1944
  */
1977
1945
  arguments: InteractionsAPI.GoogleSearchCallArguments;
1978
1946
  type: 'google_search_call';
1979
- }
1980
- interface GoogleSearchResultDelta {
1981
- /**
1982
- * ID to match the ID from the function call block.
1983
- */
1984
- call_id: string;
1985
- result: Array<InteractionsAPI.GoogleSearchResult>;
1986
- type: 'google_search_result';
1987
- is_error?: boolean;
1988
1947
  /**
1989
1948
  * A signature hash for backend validation.
1990
1949
  */
1991
1950
  signature?: string;
1992
1951
  }
1993
- interface MCPServerToolCallDelta {
1952
+ interface MCPServerToolCall {
1994
1953
  /**
1995
- * A unique ID for this specific tool call.
1954
+ * Required. A unique ID for this specific tool call.
1996
1955
  */
1997
1956
  id: string;
1998
1957
  arguments: {
@@ -2001,67 +1960,142 @@ declare namespace ContentDelta {
2001
1960
  name: string;
2002
1961
  server_name: string;
2003
1962
  type: 'mcp_server_tool_call';
1963
+ /**
1964
+ * A signature hash for backend validation.
1965
+ */
1966
+ signature?: string;
2004
1967
  }
2005
- interface MCPServerToolResultDelta {
1968
+ interface FileSearchCall {
2006
1969
  /**
2007
- * ID to match the ID from the function call block.
1970
+ * Required. A unique ID for this specific tool call.
2008
1971
  */
2009
- call_id: string;
1972
+ id: string;
1973
+ type: 'file_search_call';
2010
1974
  /**
2011
- * Tool call result delta.
1975
+ * A signature hash for backend validation.
2012
1976
  */
2013
- result: MCPServerToolResultDelta.Items | unknown | string;
2014
- type: 'mcp_server_tool_result';
1977
+ signature?: string;
1978
+ }
1979
+ interface GoogleMapsCall {
1980
+ /**
1981
+ * Required. A unique ID for this specific tool call.
1982
+ */
1983
+ id: string;
1984
+ type: 'google_maps_call';
1985
+ /**
1986
+ * The arguments to pass to the Google Maps tool.
1987
+ */
1988
+ arguments?: InteractionsAPI.GoogleMapsCallArguments;
1989
+ /**
1990
+ * A signature hash for backend validation.
1991
+ */
1992
+ signature?: string;
1993
+ }
1994
+ interface FunctionResult {
1995
+ /**
1996
+ * Required. ID to match the ID from the function call block.
1997
+ */
1998
+ call_id: string;
1999
+ result: unknown | Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent> | string;
2000
+ type: 'function_result';
2001
+ is_error?: boolean;
2015
2002
  name?: string;
2016
- server_name?: string;
2017
2003
  /**
2018
2004
  * A signature hash for backend validation.
2019
2005
  */
2020
2006
  signature?: string;
2021
2007
  }
2022
- namespace MCPServerToolResultDelta {
2023
- interface Items {
2024
- items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
2025
- }
2008
+ interface CodeExecutionResult {
2009
+ /**
2010
+ * Required. ID to match the ID from the function call block.
2011
+ */
2012
+ call_id: string;
2013
+ result: string;
2014
+ type: 'code_execution_result';
2015
+ is_error?: boolean;
2016
+ /**
2017
+ * A signature hash for backend validation.
2018
+ */
2019
+ signature?: string;
2026
2020
  }
2027
- interface FileSearchCallDelta {
2021
+ interface URLContextResult {
2028
2022
  /**
2029
- * A unique ID for this specific tool call.
2023
+ * Required. ID to match the ID from the function call block.
2030
2024
  */
2031
- id: string;
2032
- type: 'file_search_call';
2025
+ call_id: string;
2026
+ result: Array<InteractionsAPI.URLContextResult>;
2027
+ type: 'url_context_result';
2028
+ is_error?: boolean;
2029
+ /**
2030
+ * A signature hash for backend validation.
2031
+ */
2032
+ signature?: string;
2033
+ }
2034
+ interface GoogleSearchResult {
2035
+ /**
2036
+ * Required. ID to match the ID from the function call block.
2037
+ */
2038
+ call_id: string;
2039
+ result: Array<InteractionsAPI.GoogleSearchResult>;
2040
+ type: 'google_search_result';
2041
+ is_error?: boolean;
2042
+ /**
2043
+ * A signature hash for backend validation.
2044
+ */
2045
+ signature?: string;
2033
2046
  }
2034
- interface FileSearchResultDelta {
2047
+ interface MCPServerToolResult {
2035
2048
  /**
2036
- * ID to match the ID from the function call block.
2049
+ * Required. ID to match the ID from the function call block.
2037
2050
  */
2038
2051
  call_id: string;
2052
+ result: unknown | Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent> | string;
2053
+ type: 'mcp_server_tool_result';
2054
+ name?: string;
2055
+ server_name?: string;
2056
+ /**
2057
+ * A signature hash for backend validation.
2058
+ */
2059
+ signature?: string;
2060
+ }
2061
+ interface FileSearchResult {
2062
+ /**
2063
+ * Required. ID to match the ID from the function call block.
2064
+ */
2065
+ call_id: string;
2066
+ result: Array<FileSearchResult.Result>;
2039
2067
  type: 'file_search_result';
2040
- result?: Array<FileSearchResultDelta.Result>;
2041
2068
  /**
2042
2069
  * A signature hash for backend validation.
2043
2070
  */
2044
2071
  signature?: string;
2045
2072
  }
2046
- namespace FileSearchResultDelta {
2073
+ namespace FileSearchResult {
2047
2074
  /**
2048
2075
  * The result of the File Search.
2049
2076
  */
2050
2077
  interface Result {
2051
2078
  /**
2052
- * The name of the file search store.
2053
- */
2054
- file_search_store?: string;
2055
- /**
2056
- * The text of the search result.
2079
+ * User provided metadata about the FileSearchResult.
2057
2080
  */
2058
- text?: string;
2059
- /**
2060
- * The title of the search result.
2061
- */
2062
- title?: string;
2081
+ custom_metadata?: Array<unknown>;
2063
2082
  }
2064
2083
  }
2084
+ interface GoogleMapsResult {
2085
+ /**
2086
+ * Required. ID to match the ID from the function call block.
2087
+ */
2088
+ call_id: string;
2089
+ type: 'google_maps_result';
2090
+ /**
2091
+ * The results of the Google Maps.
2092
+ */
2093
+ result?: Array<InteractionsAPI.GoogleMapsResult>;
2094
+ /**
2095
+ * A signature hash for backend validation.
2096
+ */
2097
+ signature?: string;
2098
+ }
2065
2099
  }
2066
2100
 
2067
2101
  /** The embedding generated from an input content. */
@@ -2112,7 +2146,8 @@ declare interface ContentStart {
2112
2146
  event_type: 'content.start';
2113
2147
  index: number;
2114
2148
  /**
2115
- * 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.
2116
2151
  */
2117
2152
  event_id?: string;
2118
2153
  }
@@ -2121,7 +2156,8 @@ declare interface ContentStop {
2121
2156
  event_type: 'content.stop';
2122
2157
  index: number;
2123
2158
  /**
2124
- * 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.
2125
2161
  */
2126
2162
  event_id?: string;
2127
2163
  }
@@ -2569,7 +2605,7 @@ export declare interface CreateTuningJobConfig {
2569
2605
  preTunedModelCheckpointId?: string;
2570
2606
  /** Adapter size for tuning. */
2571
2607
  adapterSize?: AdapterSize;
2572
- /** Tuning mode for SFT tuning. */
2608
+ /** Tuning mode for tuning. */
2573
2609
  tuningMode?: TuningMode;
2574
2610
  /** Custom base model for tuning. This is only supported for OSS models in Vertex. */
2575
2611
  customBaseModel?: string;
@@ -2881,7 +2917,7 @@ export declare interface DistillationDataStats {
2881
2917
  trainingDatasetStats?: DatasetStats;
2882
2918
  }
2883
2919
 
2884
- /** Hyperparameters for Distillation. This data type is not supported in Gemini API. */
2920
+ /** Hyperparameters for distillation. */
2885
2921
  export declare interface DistillationHyperParameters {
2886
2922
  /** Optional. Adapter size for distillation. */
2887
2923
  adapterSize?: AdapterSize;
@@ -2889,6 +2925,21 @@ export declare interface DistillationHyperParameters {
2889
2925
  epochCount?: string;
2890
2926
  /** Optional. Multiplier for adjusting the default learning rate. */
2891
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;
2892
2943
  }
2893
2944
 
2894
2945
  /** Distillation tuning spec for tuning. */
@@ -2909,20 +2960,21 @@ export declare interface DistillationSpec {
2909
2960
  tunedTeacherModelSource?: string;
2910
2961
  /** Optional. Cloud Storage path to file containing validation dataset for tuning. The dataset must be formatted as a JSONL file. */
2911
2962
  validationDatasetUri?: string;
2963
+ /** Tuning mode for tuning. */
2964
+ tuningMode?: TuningMode;
2912
2965
  }
2913
2966
 
2914
2967
  /** A Document is a collection of Chunks. */
2915
2968
  declare interface Document_2 {
2916
- /** The resource name of the Document.
2917
- 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` */
2918
2970
  name?: string;
2919
- /** 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". */
2920
2972
  displayName?: string;
2921
- /** The current state of the Document. */
2973
+ /** Output only. Current state of the `Document`. */
2922
2974
  state?: DocumentState;
2923
- /** The size of the Document in bytes. */
2975
+ /** Output only. The size of raw bytes ingested into the Document. */
2924
2976
  sizeBytes?: string;
2925
- /** The MIME type of the Document. */
2977
+ /** Output only. The mime type of the Document. */
2926
2978
  mimeType?: string;
2927
2979
  /** Output only. The Timestamp of when the `Document` was created. */
2928
2980
  createTime?: string;
@@ -2986,11 +3038,23 @@ declare class Documents extends BaseModule {
2986
3038
  private listInternal;
2987
3039
  }
2988
3040
 
2989
- /** State for the lifecycle of a Document. */
3041
+ /** Output only. Current state of the `Document`. This enum is not supported in Vertex AI. */
2990
3042
  export declare enum DocumentState {
3043
+ /**
3044
+ * The default value. This value is used if the state is omitted.
3045
+ */
2991
3046
  STATE_UNSPECIFIED = "STATE_UNSPECIFIED",
3047
+ /**
3048
+ * Some `Chunks` of the `Document` are being processed (embedding and vector storage).
3049
+ */
2992
3050
  STATE_PENDING = "STATE_PENDING",
3051
+ /**
3052
+ * All `Chunks` of the `Document` is processed and available for querying.
3053
+ */
2993
3054
  STATE_ACTIVE = "STATE_ACTIVE",
3055
+ /**
3056
+ * Some `Chunks` of the `Document` failed processing.
3057
+ */
2994
3058
  STATE_FAILED = "STATE_FAILED"
2995
3059
  }
2996
3060
 
@@ -3332,7 +3396,8 @@ declare interface ErrorEvent_2 {
3332
3396
  */
3333
3397
  error?: ErrorEvent_2.Error;
3334
3398
  /**
3335
- * 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.
3336
3401
  */
3337
3402
  event_id?: string;
3338
3403
  }
@@ -3389,7 +3454,7 @@ export declare interface EvaluateDatasetRun {
3389
3454
  evaluateDatasetResponse?: EvaluateDatasetResponse;
3390
3455
  /** Output only. The resource name of the evaluation run. Format: `projects/{project}/locations/{location}/evaluationRuns/{evaluation_run_id}`. */
3391
3456
  evaluationRun?: string;
3392
- /** 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. */
3393
3458
  operationName?: string;
3394
3459
  }
3395
3460
 
@@ -3407,12 +3472,18 @@ export declare interface ExactMatchMetricValue {
3407
3472
  score?: number;
3408
3473
  }
3409
3474
 
3410
- /** Code generated by the model that is meant to be executed, and the result returned to the model. Generated when using the [CodeExecution] tool, in which the code will be automatically executed, and a corresponding [CodeExecutionResult] will also be generated. */
3475
+ /** Model-generated code executed server-side, results returned to the model.
3476
+
3477
+ Only generated when using the `CodeExecution` tool, in which the code will
3478
+ be automatically executed, and a corresponding `CodeExecutionResult` will
3479
+ also be generated. */
3411
3480
  export declare interface ExecutableCode {
3412
3481
  /** Required. The code to be executed. */
3413
3482
  code?: string;
3414
3483
  /** Required. Programming language of the `code`. */
3415
3484
  language?: Language;
3485
+ /** Unique identifier of the `ExecutableCode` part. The server returns the `CodeExecutionResult` with the matching `id`. */
3486
+ id?: string;
3416
3487
  }
3417
3488
 
3418
3489
  /** Retrieve from data source powered by external API for grounding. The external API is not owned by Google, but need to follow the pre-defined API spec. This data type is not supported in Gemini API. */
@@ -3517,6 +3588,35 @@ declare interface File_2 {
3517
3588
  }
3518
3589
  export { File_2 as File }
3519
3590
 
3591
+ /**
3592
+ * A file citation annotation.
3593
+ */
3594
+ declare interface FileCitation {
3595
+ type: 'file_citation';
3596
+ /**
3597
+ * The URI of the file.
3598
+ */
3599
+ document_uri?: string;
3600
+ /**
3601
+ * End of the attributed segment, exclusive.
3602
+ */
3603
+ end_index?: number;
3604
+ /**
3605
+ * The name of the file.
3606
+ */
3607
+ file_name?: string;
3608
+ /**
3609
+ * Source attributed for a portion of the text.
3610
+ */
3611
+ source?: string;
3612
+ /**
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.
3616
+ */
3617
+ start_index?: number;
3618
+ }
3619
+
3520
3620
  /** URI-based data. A FileData message contains a URI pointing to data of a specific media type. It is used to represent images, audio, and video stored in Google Cloud Storage. */
3521
3621
  export declare interface FileData {
3522
3622
  /** Optional. The display name of the file. Used to provide a label or filename to distinguish files. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server side tools (`code_execution`, `google_search`, and `url_context`) are enabled. This field is not supported in Gemini API. */
@@ -3647,14 +3747,13 @@ export declare class Files extends BaseModule {
3647
3747
  private registerFilesInternal;
3648
3748
  }
3649
3749
 
3650
- /** 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. */
3651
3751
  export declare interface FileSearch {
3652
- /** The names of the file_search_stores to retrieve from.
3653
- 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` */
3654
3753
  fileSearchStoreNames?: string[];
3655
- /** The number of file search retrieval chunks to retrieve. */
3754
+ /** Optional. The number of semantic retrieval chunks to retrieve. */
3656
3755
  topK?: number;
3657
- /** 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. */
3658
3757
  metadataFilter?: string;
3659
3758
  }
3660
3759
 
@@ -3663,10 +3762,14 @@ export declare interface FileSearch {
3663
3762
  */
3664
3763
  declare interface FileSearchCallContent {
3665
3764
  /**
3666
- * A unique ID for this specific tool call.
3765
+ * Required. A unique ID for this specific tool call.
3667
3766
  */
3668
3767
  id: string;
3669
3768
  type: 'file_search_call';
3769
+ /**
3770
+ * A signature hash for backend validation.
3771
+ */
3772
+ signature?: string;
3670
3773
  }
3671
3774
 
3672
3775
  /**
@@ -3674,14 +3777,14 @@ declare interface FileSearchCallContent {
3674
3777
  */
3675
3778
  declare interface FileSearchResultContent {
3676
3779
  /**
3677
- * ID to match the ID from the file search call block.
3780
+ * Required. ID to match the ID from the function call block.
3678
3781
  */
3679
3782
  call_id: string;
3680
- type: 'file_search_result';
3681
3783
  /**
3682
- * The results of the File Search.
3784
+ * Required. The results of the File Search.
3683
3785
  */
3684
- result?: Array<FileSearchResultContent.Result>;
3786
+ result: Array<FileSearchResultContent.Result>;
3787
+ type: 'file_search_result';
3685
3788
  /**
3686
3789
  * A signature hash for backend validation.
3687
3790
  */
@@ -3694,17 +3797,9 @@ declare namespace FileSearchResultContent {
3694
3797
  */
3695
3798
  interface Result {
3696
3799
  /**
3697
- * The name of the file search store.
3698
- */
3699
- file_search_store?: string;
3700
- /**
3701
- * The text of the search result.
3800
+ * User provided metadata about the FileSearchResult.
3702
3801
  */
3703
- text?: string;
3704
- /**
3705
- * The title of the search result.
3706
- */
3707
- title?: string;
3802
+ custom_metadata?: Array<unknown>;
3708
3803
  }
3709
3804
  }
3710
3805
 
@@ -3993,20 +4088,24 @@ export declare interface FunctionCall {
3993
4088
  */
3994
4089
  declare interface FunctionCallContent {
3995
4090
  /**
3996
- * A unique ID for this specific tool call.
4091
+ * Required. A unique ID for this specific tool call.
3997
4092
  */
3998
4093
  id: string;
3999
4094
  /**
4000
- * The arguments to pass to the function.
4095
+ * Required. The arguments to pass to the function.
4001
4096
  */
4002
4097
  arguments: {
4003
4098
  [key: string]: unknown;
4004
4099
  };
4005
4100
  /**
4006
- * The name of the tool to call.
4101
+ * Required. The name of the tool to call.
4007
4102
  */
4008
4103
  name: string;
4009
4104
  type: 'function_call';
4105
+ /**
4106
+ * A signature hash for backend validation.
4107
+ */
4108
+ signature?: string;
4010
4109
  }
4011
4110
 
4012
4111
  /** Function calling config. */
@@ -4145,7 +4244,7 @@ export declare enum FunctionResponseScheduling {
4145
4244
  */
4146
4245
  declare interface FunctionResultContent {
4147
4246
  /**
4148
- * ID to match the ID from the function call block.
4247
+ * Required. ID to match the ID from the function call block.
4149
4248
  */
4150
4249
  call_id: string;
4151
4250
  /**
@@ -4368,6 +4467,8 @@ export declare interface GenerateContentConfig {
4368
4467
  service. If supplied, safety_settings must not be supplied.
4369
4468
  */
4370
4469
  modelArmorConfig?: ModelArmorConfig;
4470
+ /** The service tier to use for the request. For example, SERVICE_TIER_FLEX. */
4471
+ serviceTier?: ServiceTier;
4371
4472
  }
4372
4473
 
4373
4474
  /** Config for models.generate_content parameters. */
@@ -4404,6 +4505,8 @@ export declare class GenerateContentResponse {
4404
4505
  responseId?: string;
4405
4506
  /** Usage metadata about the response(s). */
4406
4507
  usageMetadata?: GenerateContentResponseUsageMetadata;
4508
+ /** Output only. The current model status of this model. This field is not supported in Vertex AI. */
4509
+ modelStatus?: ModelStatus;
4407
4510
  /**
4408
4511
  * Returns the concatenation of all text parts from the first candidate in the response.
4409
4512
  *
@@ -4733,6 +4836,8 @@ export declare interface GenerateVideosConfig {
4733
4836
  mask?: VideoGenerationMask;
4734
4837
  /** Compression quality of the generated videos. */
4735
4838
  compressionQuality?: VideoCompressionQuality;
4839
+ /** User specified labels to track billing usage. */
4840
+ labels?: Record<string, string>;
4736
4841
  }
4737
4842
 
4738
4843
  /** A video generation operation. */
@@ -4749,7 +4854,6 @@ export declare class GenerateVideosOperation implements Operation<GenerateVideos
4749
4854
  response?: GenerateVideosResponse;
4750
4855
  /**
4751
4856
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
4752
- * @internal
4753
4857
  */
4754
4858
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<GenerateVideosResponse>;
4755
4859
  /** The full HTTP response. */
@@ -4888,7 +4992,7 @@ declare interface GenerationConfig_2 {
4888
4992
  */
4889
4993
  thinking_summaries?: 'auto' | 'none';
4890
4994
  /**
4891
- * The tool choice for the interaction.
4995
+ * The tool choice configuration.
4892
4996
  */
4893
4997
  tool_choice?: ToolChoiceType | ToolChoiceConfig;
4894
4998
  /**
@@ -5230,6 +5334,110 @@ export declare interface GoogleMaps {
5230
5334
  enableWidget?: boolean;
5231
5335
  }
5232
5336
 
5337
+ /**
5338
+ * The arguments to pass to the Google Maps tool.
5339
+ */
5340
+ declare interface GoogleMapsCallArguments {
5341
+ /**
5342
+ * The queries to be executed.
5343
+ */
5344
+ queries?: Array<string>;
5345
+ }
5346
+
5347
+ /**
5348
+ * Google Maps content.
5349
+ */
5350
+ declare interface GoogleMapsCallContent {
5351
+ /**
5352
+ * Required. A unique ID for this specific tool call.
5353
+ */
5354
+ id: string;
5355
+ type: 'google_maps_call';
5356
+ /**
5357
+ * The arguments to pass to the Google Maps tool.
5358
+ */
5359
+ arguments?: GoogleMapsCallArguments;
5360
+ /**
5361
+ * A signature hash for backend validation.
5362
+ */
5363
+ signature?: string;
5364
+ }
5365
+
5366
+ /**
5367
+ * The result of the Google Maps.
5368
+ */
5369
+ declare interface GoogleMapsResult {
5370
+ /**
5371
+ * The places that were found.
5372
+ */
5373
+ places?: Array<GoogleMapsResult.Place>;
5374
+ /**
5375
+ * Resource name of the Google Maps widget context token.
5376
+ */
5377
+ widget_context_token?: string;
5378
+ }
5379
+
5380
+ declare namespace GoogleMapsResult {
5381
+ interface Place {
5382
+ /**
5383
+ * Title of the place.
5384
+ */
5385
+ name?: string;
5386
+ /**
5387
+ * The ID of the place, in `places/{place_id}` format.
5388
+ */
5389
+ place_id?: string;
5390
+ /**
5391
+ * Snippets of reviews that are used to generate answers about the
5392
+ * features of a given place in Google Maps.
5393
+ */
5394
+ review_snippets?: Array<Place.ReviewSnippet>;
5395
+ /**
5396
+ * URI reference of the place.
5397
+ */
5398
+ url?: string;
5399
+ }
5400
+ namespace Place {
5401
+ /**
5402
+ * Encapsulates a snippet of a user review that answers a question about
5403
+ * the features of a specific place in Google Maps.
5404
+ */
5405
+ interface ReviewSnippet {
5406
+ /**
5407
+ * The ID of the review snippet.
5408
+ */
5409
+ review_id?: string;
5410
+ /**
5411
+ * Title of the review.
5412
+ */
5413
+ title?: string;
5414
+ /**
5415
+ * A link that corresponds to the user review on Google Maps.
5416
+ */
5417
+ url?: string;
5418
+ }
5419
+ }
5420
+ }
5421
+
5422
+ /**
5423
+ * Google Maps result content.
5424
+ */
5425
+ declare interface GoogleMapsResultContent {
5426
+ /**
5427
+ * Required. ID to match the ID from the function call block.
5428
+ */
5429
+ call_id: string;
5430
+ /**
5431
+ * Required. The results of the Google Maps.
5432
+ */
5433
+ result: Array<GoogleMapsResult>;
5434
+ type: 'google_maps_result';
5435
+ /**
5436
+ * A signature hash for backend validation.
5437
+ */
5438
+ signature?: string;
5439
+ }
5440
+
5233
5441
  /** The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). This data type is not supported in Gemini API. */
5234
5442
  export declare interface GoogleRpcStatus {
5235
5443
  /** The status code, which should be an enum value of google.rpc.Code. */
@@ -5240,9 +5448,9 @@ export declare interface GoogleRpcStatus {
5240
5448
  message?: string;
5241
5449
  }
5242
5450
 
5243
- /** Tool to support web search. */
5451
+ /** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
5244
5452
  export declare interface GoogleSearch {
5245
- /** Different types of search that can be enabled on the GoogleSearch tool. */
5453
+ /** Optional. The set of search types to enable. If not set, web search is enabled by default. */
5246
5454
  searchTypes?: SearchTypes;
5247
5455
  /** Optional. Sites with confidence level chosen & above this value will be blocked from the search results. This field is not supported in Gemini API. */
5248
5456
  blockingConfidence?: PhishBlockThreshold;
@@ -5267,11 +5475,11 @@ declare interface GoogleSearchCallArguments {
5267
5475
  */
5268
5476
  declare interface GoogleSearchCallContent {
5269
5477
  /**
5270
- * A unique ID for this specific tool call.
5478
+ * Required. A unique ID for this specific tool call.
5271
5479
  */
5272
5480
  id: string;
5273
5481
  /**
5274
- * The arguments to pass to Google Search.
5482
+ * Required. The arguments to pass to Google Search.
5275
5483
  */
5276
5484
  arguments: GoogleSearchCallArguments;
5277
5485
  type: 'google_search_call';
@@ -5279,6 +5487,10 @@ declare interface GoogleSearchCallContent {
5279
5487
  * The type of search grounding enabled.
5280
5488
  */
5281
5489
  search_type?: 'web_search' | 'image_search';
5490
+ /**
5491
+ * A signature hash for backend validation.
5492
+ */
5493
+ signature?: string;
5282
5494
  }
5283
5495
 
5284
5496
  /**
@@ -5288,15 +5500,7 @@ declare interface GoogleSearchResult {
5288
5500
  /**
5289
5501
  * Web content snippet that can be embedded in a web page or an app webview.
5290
5502
  */
5291
- rendered_content?: string;
5292
- /**
5293
- * Title of the search result.
5294
- */
5295
- title?: string;
5296
- /**
5297
- * URI reference of the search result.
5298
- */
5299
- url?: string;
5503
+ search_suggestions?: string;
5300
5504
  }
5301
5505
 
5302
5506
  /**
@@ -5304,11 +5508,11 @@ declare interface GoogleSearchResult {
5304
5508
  */
5305
5509
  declare interface GoogleSearchResultContent {
5306
5510
  /**
5307
- * ID to match the ID from the google search call block.
5511
+ * Required. ID to match the ID from the function call block.
5308
5512
  */
5309
5513
  call_id: string;
5310
5514
  /**
5311
- * The results of the Google Search.
5515
+ * Required. The results of the Google Search.
5312
5516
  */
5313
5517
  result: Array<GoogleSearchResult>;
5314
5518
  type: 'google_search_result';
@@ -5344,9 +5548,7 @@ export declare interface GoogleTypeDate {
5344
5548
  is enabled, the model returns a `GroundingChunk` that contains a reference to
5345
5549
  the source of the information. */
5346
5550
  export declare interface GroundingChunk {
5347
- /** A grounding chunk from an image search result. See the `Image`
5348
- message for details.
5349
- */
5551
+ /** A grounding chunk from an image search result. See the `Image` message for details. */
5350
5552
  image?: GroundingChunkImage;
5351
5553
  /** A `Maps` chunk is a piece of evidence that comes from Google Maps.
5352
5554
 
@@ -5354,17 +5556,25 @@ export declare interface GroundingChunk {
5354
5556
  reviews. This is used to provide the user with rich, location-based
5355
5557
  information. */
5356
5558
  maps?: GroundingChunkMaps;
5357
- /** 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. */
5559
+ /** A grounding chunk from a data source retrieved by a retrieval tool, such as Vertex AI Search. See the `RetrievedContext` message for details */
5358
5560
  retrievedContext?: GroundingChunkRetrievedContext;
5359
5561
  /** A grounding chunk from a web page, typically from Google Search. See the `Web` message for details. */
5360
5562
  web?: GroundingChunkWeb;
5361
5563
  }
5362
5564
 
5363
- /** A piece of evidence that comes from an image search result.
5565
+ /** User provided metadata about the GroundingFact. This data type is not supported in Vertex AI. */
5566
+ export declare interface GroundingChunkCustomMetadata {
5567
+ /** The key of the metadata. */
5568
+ key?: string;
5569
+ /** Optional. The numeric value of the metadata. The expected range for this value depends on the specific `key` used. */
5570
+ numericValue?: number;
5571
+ /** Optional. A list of string values for the metadata. */
5572
+ stringListValue?: GroundingChunkStringList;
5573
+ /** Optional. The string value of the metadata. */
5574
+ stringValue?: string;
5575
+ }
5364
5576
 
5365
- It contains the URI of the image search result and the URI of the image.
5366
- This is used to provide the user with a link to the source of the
5367
- information. */
5577
+ /** 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. */
5368
5578
  export declare interface GroundingChunkImage {
5369
5579
  /** The URI of the image search result page. */
5370
5580
  sourceUri?: string;
@@ -5396,6 +5606,8 @@ export declare interface GroundingChunkMaps {
5396
5606
  title?: string;
5397
5607
  /** The URI of the place. */
5398
5608
  uri?: string;
5609
+ /** Output only. Route information. */
5610
+ route?: GroundingChunkMapsRoute;
5399
5611
  }
5400
5612
 
5401
5613
  /** The sources that were used to generate the place answer.
@@ -5439,11 +5651,21 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
5439
5651
  title?: string;
5440
5652
  }
5441
5653
 
5442
- /** 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. */
5654
+ /** Route information from Google Maps. This data type is not supported in Gemini API. */
5655
+ export declare interface GroundingChunkMapsRoute {
5656
+ /** The total distance of the route, in meters. */
5657
+ distanceMeters?: number;
5658
+ /** The total duration of the route. */
5659
+ duration?: string;
5660
+ /** An encoded polyline of the route. See https://developers.google.com/maps/documentation/utilities/polylinealgorithm */
5661
+ encodedPolyline?: string;
5662
+ }
5663
+
5664
+ /** 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. */
5443
5665
  export declare interface GroundingChunkRetrievedContext {
5444
- /** 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}`. */
5666
+ /** 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. */
5445
5667
  documentName?: string;
5446
- /** Additional context for a Retrieval-Augmented Generation (RAG) retrieval result. This is populated only when the RAG retrieval tool is used. */
5668
+ /** 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. */
5447
5669
  ragChunk?: RagChunk;
5448
5670
  /** The content of the retrieved data source. */
5449
5671
  text?: string;
@@ -5451,6 +5673,16 @@ export declare interface GroundingChunkRetrievedContext {
5451
5673
  title?: string;
5452
5674
  /** The URI of the retrieved data source. */
5453
5675
  uri?: string;
5676
+ /** Optional. User-provided metadata about the retrieved context. This field is not supported in Vertex AI. */
5677
+ customMetadata?: GroundingChunkCustomMetadata[];
5678
+ /** Optional. Name of the `FileSearchStore` containing the document. Example: `fileSearchStores/123`. This field is not supported in Vertex AI. */
5679
+ fileSearchStore?: string;
5680
+ }
5681
+
5682
+ /** A list of string values. This data type is not supported in Vertex AI. */
5683
+ export declare interface GroundingChunkStringList {
5684
+ /** The string values of the list. */
5685
+ values?: string[];
5454
5686
  }
5455
5687
 
5456
5688
  /** 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. */
@@ -5465,10 +5697,7 @@ export declare interface GroundingChunkWeb {
5465
5697
 
5466
5698
  /** Information for various kinds of grounding. */
5467
5699
  export declare interface GroundingMetadata {
5468
- /** Optional. The image search queries that were used to generate the
5469
- content. This field is populated only when the grounding source is Google
5470
- Search with the Image Search search_type enabled.
5471
- */
5700
+ /** 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. */
5472
5701
  imageSearchQueries?: string[];
5473
5702
  /** A list of supporting references retrieved from the grounding
5474
5703
  source. This field is populated when the grounding source is Google
@@ -5484,7 +5713,7 @@ export declare interface GroundingMetadata {
5484
5713
  searchEntryPoint?: SearchEntryPoint;
5485
5714
  /** Web search queries for the following-up web search. */
5486
5715
  webSearchQueries?: string[];
5487
- /** 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. */
5716
+ /** 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. */
5488
5717
  googleMapsWidgetContextToken?: string;
5489
5718
  /** 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. */
5490
5719
  retrievalQueries?: string[];
@@ -5514,6 +5743,8 @@ export declare interface GroundingSupport {
5514
5743
  groundingChunkIndices?: number[];
5515
5744
  /** Segment of the content this support belongs to. */
5516
5745
  segment?: Segment;
5746
+ /** Indices into the `rendered_parts` field of the `GroundingMetadata` message. These indices specify which rendered parts are associated with this support message. */
5747
+ renderedParts?: number[];
5517
5748
  }
5518
5749
 
5519
5750
  /** 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. */
@@ -5807,11 +6038,7 @@ export declare interface ImageConfig {
5807
6038
  /** Controls the generation of people. Supported values are:
5808
6039
  ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE. */
5809
6040
  personGeneration?: string;
5810
- /** Controls whether prominent people (celebrities)
5811
- generation is allowed. If used with personGeneration, personGeneration
5812
- enum would take precedence. For instance, if ALLOW_NONE is set, all person
5813
- generation would be blocked. If this field is unspecified, the default
5814
- behavior is to allow prominent people. */
6041
+ /** 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. */
5815
6042
  prominentPeople?: ProminentPeople;
5816
6043
  /** MIME type of the generated image. This field is not
5817
6044
  supported in Gemini API. */
@@ -5819,7 +6046,7 @@ export declare interface ImageConfig {
5819
6046
  /** Compression quality of the generated image (for
5820
6047
  ``image/jpeg`` only). This field is not supported in Gemini API. */
5821
6048
  outputCompressionQuality?: number;
5822
- /** Optional. The image output format for generated images. */
6049
+ /** Optional. The image output format for generated images. This field is not supported in Gemini API. */
5823
6050
  imageOutputOptions?: ImageConfigImageOutputOptions;
5824
6051
  }
5825
6052
 
@@ -5851,7 +6078,7 @@ declare interface ImageContent {
5851
6078
  /**
5852
6079
  * The mime type of the image.
5853
6080
  */
5854
- mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
6081
+ mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif' | 'image/gif' | 'image/bmp' | 'image/tiff';
5855
6082
  /**
5856
6083
  * The resolution of the media.
5857
6084
  */
@@ -5933,7 +6160,6 @@ export declare class ImportFileOperation implements Operation<ImportFileResponse
5933
6160
  response?: ImportFileResponse;
5934
6161
  /**
5935
6162
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
5936
- * @internal
5937
6163
  */
5938
6164
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<ImportFileResponse>;
5939
6165
  /** The full HTTP response. */
@@ -5962,12 +6188,12 @@ export declare class ImportFileResponse {
5962
6188
 
5963
6189
  /** Config for `inlined_embedding_responses` parameter. */
5964
6190
  export declare class InlinedEmbedContentResponse {
5965
- /** The response to the request.
5966
- */
6191
+ /** Output only. The response to the request. */
5967
6192
  response?: SingleEmbedContentResponse;
5968
- /** The error encountered while processing the request.
5969
- */
6193
+ /** Output only. The error encountered while processing the request. */
5970
6194
  error?: JobError;
6195
+ /** Output only. The metadata associated with the request. */
6196
+ metadata?: Record<string, unknown>;
5971
6197
  }
5972
6198
 
5973
6199
  /** Config for inlined request. */
@@ -6002,20 +6228,20 @@ export declare class InlinedResponse {
6002
6228
  */
6003
6229
  declare interface Interaction {
6004
6230
  /**
6005
- * Output only. A unique identifier for the interaction completion.
6231
+ * Required. Output only. A unique identifier for the interaction completion.
6006
6232
  */
6007
6233
  id: string;
6008
6234
  /**
6009
- * Output only. The time at which the response was created in ISO 8601 format
6235
+ * Required. Output only. The time at which the response was created in ISO 8601 format
6010
6236
  * (YYYY-MM-DDThh:mm:ssZ).
6011
6237
  */
6012
6238
  created: string;
6013
6239
  /**
6014
- * Output only. The status of the interaction.
6240
+ * Required. Output only. The status of the interaction.
6015
6241
  */
6016
6242
  status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
6017
6243
  /**
6018
- * Output only. The time at which the response was last updated in ISO 8601 format
6244
+ * Required. Output only. The time at which the response was last updated in ISO 8601 format
6019
6245
  * (YYYY-MM-DDThh:mm:ssZ).
6020
6246
  */
6021
6247
  updated: string;
@@ -6030,7 +6256,7 @@ declare interface Interaction {
6030
6256
  /**
6031
6257
  * The input for the interaction.
6032
6258
  */
6033
- 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;
6259
+ 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;
6034
6260
  /**
6035
6261
  * The name of the `Model` used for generating the interaction.
6036
6262
  */
@@ -6060,6 +6286,10 @@ declare interface Interaction {
6060
6286
  * Output only. The role of the interaction.
6061
6287
  */
6062
6288
  role?: string;
6289
+ /**
6290
+ * The service tier for the interaction.
6291
+ */
6292
+ service_tier?: 'flex' | 'standard' | 'priority';
6063
6293
  /**
6064
6294
  * System instruction for the interaction.
6065
6295
  */
@@ -6084,12 +6314,13 @@ declare interface InteractionCancelParams {
6084
6314
  declare interface InteractionCompleteEvent {
6085
6315
  event_type: 'interaction.complete';
6086
6316
  /**
6087
- * The completed interaction with empty outputs to reduce the payload size.
6317
+ * Required. The completed interaction with empty outputs to reduce the payload size.
6088
6318
  * Use the preceding ContentDelta events for the actual output.
6089
6319
  */
6090
6320
  interaction: Interaction;
6091
6321
  /**
6092
- * The event_id token to be used to resume the interaction stream, from this event.
6322
+ * The event_id token to be used to resume the interaction stream, from
6323
+ * this event.
6093
6324
  */
6094
6325
  event_id?: string;
6095
6326
  }
@@ -6149,7 +6380,7 @@ export declare class Interactions extends BaseInteractions {
6149
6380
  }
6150
6381
 
6151
6382
  export declare namespace Interactions {
6152
- export { type AllowedTools as AllowedTools, type Annotation as Annotation, type AudioContent as AudioContent, type CodeExecutionCallArguments as CodeExecutionCallArguments, type CodeExecutionCallContent as CodeExecutionCallContent, type CodeExecutionResultContent as CodeExecutionResultContent, type Content_2 as Content, type ContentDelta as ContentDelta, type ContentStart as ContentStart, type ContentStop as ContentStop, type DeepResearchAgentConfig as DeepResearchAgentConfig, type DocumentContent as DocumentContent, type DynamicAgentConfig as DynamicAgentConfig, type ErrorEvent_2 as ErrorEvent, type FileSearchCallContent as FileSearchCallContent, type FileSearchResultContent as FileSearchResultContent, type Function_2 as Function, type FunctionCallContent as FunctionCallContent, type FunctionResultContent as FunctionResultContent, type GenerationConfig_2 as GenerationConfig, type GoogleSearchCallArguments as GoogleSearchCallArguments, type GoogleSearchCallContent as GoogleSearchCallContent, type GoogleSearchResult as GoogleSearchResult, type GoogleSearchResultContent as GoogleSearchResultContent, type ImageConfig_2 as ImageConfig, type ImageContent as ImageContent, type Interaction as Interaction, type InteractionCompleteEvent as InteractionCompleteEvent, type InteractionSSEEvent as InteractionSSEEvent, type InteractionStartEvent as InteractionStartEvent, type InteractionStatusUpdate as InteractionStatusUpdate, type MCPServerToolCallContent as MCPServerToolCallContent, type MCPServerToolResultContent as MCPServerToolResultContent, type Model_2 as Model, type SpeechConfig_2 as SpeechConfig, type TextContent as TextContent, type ThinkingLevel_2 as ThinkingLevel, type ThoughtContent as ThoughtContent, type Tool_2 as Tool, type ToolChoiceConfig as ToolChoiceConfig, type ToolChoiceType as ToolChoiceType, type Turn as Turn, type URLContextCallArguments as URLContextCallArguments, type URLContextCallContent as URLContextCallContent, type URLContextResult as URLContextResult, type URLContextResultContent as URLContextResultContent, type Usage as Usage, type VideoContent as VideoContent, type InteractionDeleteResponse as InteractionDeleteResponse, type InteractionCreateParams as InteractionCreateParams, type CreateModelInteractionParamsNonStreaming as CreateModelInteractionParamsNonStreaming, type CreateModelInteractionParamsStreaming as CreateModelInteractionParamsStreaming, type CreateAgentInteractionParamsNonStreaming as CreateAgentInteractionParamsNonStreaming, type CreateAgentInteractionParamsStreaming as CreateAgentInteractionParamsStreaming, type InteractionDeleteParams as InteractionDeleteParams, type InteractionCancelParams as InteractionCancelParams, type InteractionGetParams as InteractionGetParams, type InteractionGetParamsNonStreaming as InteractionGetParamsNonStreaming, type InteractionGetParamsStreaming as InteractionGetParamsStreaming, };
6383
+ export { type AllowedTools as AllowedTools, type Annotation as Annotation, type AudioContent as AudioContent, type CodeExecutionCallArguments as CodeExecutionCallArguments, type CodeExecutionCallContent as CodeExecutionCallContent, type CodeExecutionResultContent as CodeExecutionResultContent, type Content_2 as Content, type ContentDelta as ContentDelta, type ContentStart as ContentStart, type ContentStop as ContentStop, type DeepResearchAgentConfig as DeepResearchAgentConfig, type DocumentContent as DocumentContent, type DynamicAgentConfig as DynamicAgentConfig, type ErrorEvent_2 as ErrorEvent, type FileCitation as FileCitation, type FileSearchCallContent as FileSearchCallContent, type FileSearchResultContent as FileSearchResultContent, type Function_2 as Function, type FunctionCallContent as FunctionCallContent, type FunctionResultContent as FunctionResultContent, type GenerationConfig_2 as GenerationConfig, type GoogleMapsCallArguments as GoogleMapsCallArguments, type GoogleMapsCallContent as GoogleMapsCallContent, type GoogleMapsResult as GoogleMapsResult, type GoogleMapsResultContent as GoogleMapsResultContent, type GoogleSearchCallArguments as GoogleSearchCallArguments, type GoogleSearchCallContent as GoogleSearchCallContent, type GoogleSearchResult as GoogleSearchResult, type GoogleSearchResultContent as GoogleSearchResultContent, type ImageConfig_2 as ImageConfig, type ImageContent as ImageContent, type Interaction as Interaction, type InteractionCompleteEvent as InteractionCompleteEvent, type InteractionSSEEvent as InteractionSSEEvent, type InteractionStartEvent as InteractionStartEvent, type InteractionStatusUpdate as InteractionStatusUpdate, type MCPServerToolCallContent as MCPServerToolCallContent, type MCPServerToolResultContent as MCPServerToolResultContent, type Model_2 as Model, type PlaceCitation as PlaceCitation, type SpeechConfig_2 as SpeechConfig, type TextContent as TextContent, type ThinkingLevel_2 as ThinkingLevel, type ThoughtContent as ThoughtContent, type Tool_2 as Tool, type ToolChoiceConfig as ToolChoiceConfig, type ToolChoiceType as ToolChoiceType, type Turn as Turn, type URLCitation as URLCitation, type URLContextCallArguments as URLContextCallArguments, type URLContextCallContent as URLContextCallContent, type URLContextResult as URLContextResult, type URLContextResultContent as URLContextResultContent, type Usage as Usage, type VideoContent as VideoContent, type InteractionDeleteResponse as InteractionDeleteResponse, type InteractionCreateParams as InteractionCreateParams, type CreateModelInteractionParamsNonStreaming as CreateModelInteractionParamsNonStreaming, type CreateModelInteractionParamsStreaming as CreateModelInteractionParamsStreaming, type CreateAgentInteractionParamsNonStreaming as CreateAgentInteractionParamsNonStreaming, type CreateAgentInteractionParamsStreaming as CreateAgentInteractionParamsStreaming, type InteractionDeleteParams as InteractionDeleteParams, type InteractionCancelParams as InteractionCancelParams, type InteractionGetParams as InteractionGetParams, type InteractionGetParamsNonStreaming as InteractionGetParamsNonStreaming, type InteractionGetParamsStreaming as InteractionGetParamsStreaming, };
6153
6384
  }
6154
6385
 
6155
6386
  declare namespace InteractionsAPI {
@@ -6170,12 +6401,17 @@ declare namespace InteractionsAPI {
6170
6401
  DocumentContent,
6171
6402
  DynamicAgentConfig,
6172
6403
  ErrorEvent_2 as ErrorEvent,
6404
+ FileCitation,
6173
6405
  FileSearchCallContent,
6174
6406
  FileSearchResultContent,
6175
6407
  Function_2 as Function,
6176
6408
  FunctionCallContent,
6177
6409
  FunctionResultContent,
6178
6410
  GenerationConfig_2 as GenerationConfig,
6411
+ GoogleMapsCallArguments,
6412
+ GoogleMapsCallContent,
6413
+ GoogleMapsResult,
6414
+ GoogleMapsResultContent,
6179
6415
  GoogleSearchCallArguments,
6180
6416
  GoogleSearchCallContent,
6181
6417
  GoogleSearchResult,
@@ -6190,6 +6426,7 @@ declare namespace InteractionsAPI {
6190
6426
  MCPServerToolCallContent,
6191
6427
  MCPServerToolResultContent,
6192
6428
  Model_2 as Model,
6429
+ PlaceCitation,
6193
6430
  SpeechConfig_2 as SpeechConfig,
6194
6431
  TextContent,
6195
6432
  ThinkingLevel_2 as ThinkingLevel,
@@ -6198,6 +6435,7 @@ declare namespace InteractionsAPI {
6198
6435
  ToolChoiceConfig,
6199
6436
  ToolChoiceType,
6200
6437
  Turn,
6438
+ URLCitation,
6201
6439
  URLContextCallArguments,
6202
6440
  URLContextCallContent,
6203
6441
  URLContextResult,
@@ -6230,7 +6468,8 @@ declare interface InteractionStartEvent {
6230
6468
  */
6231
6469
  interaction: Interaction;
6232
6470
  /**
6233
- * The event_id token to be used to resume the interaction stream, from this event.
6471
+ * The event_id token to be used to resume the interaction stream, from
6472
+ * this event.
6234
6473
  */
6235
6474
  event_id?: string;
6236
6475
  }
@@ -6240,7 +6479,8 @@ declare interface InteractionStatusUpdate {
6240
6479
  interaction_id: string;
6241
6480
  status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
6242
6481
  /**
6243
- * The event_id token to be used to resume the interaction stream, from this event.
6482
+ * The event_id token to be used to resume the interaction stream, from
6483
+ * this event.
6244
6484
  */
6245
6485
  event_id?: string;
6246
6486
  }
@@ -6482,6 +6722,7 @@ export declare interface ListFileSearchStoresParameters {
6482
6722
  export declare class ListFileSearchStoresResponse {
6483
6723
  /** Used to retain the full HTTP response. */
6484
6724
  sdkHttpResponse?: HttpResponse;
6725
+ /** A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no more pages. */
6485
6726
  nextPageToken?: string;
6486
6727
  /** The returned file search stores. */
6487
6728
  fileSearchStores?: FileSearchStore[];
@@ -7350,6 +7591,8 @@ export declare interface LogprobsResult {
7350
7591
  chosenCandidates?: LogprobsResultCandidate[];
7351
7592
  /** 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. */
7352
7593
  topCandidates?: LogprobsResultTopCandidates[];
7594
+ /** Sum of log probabilities for all tokens. This field is not supported in Vertex AI. */
7595
+ logProbabilitySum?: number;
7353
7596
  }
7354
7597
 
7355
7598
  /** A single token and its associated log probability. */
@@ -7425,24 +7668,28 @@ export declare interface McpServer {
7425
7668
  */
7426
7669
  declare interface MCPServerToolCallContent {
7427
7670
  /**
7428
- * A unique ID for this specific tool call.
7671
+ * Required. A unique ID for this specific tool call.
7429
7672
  */
7430
7673
  id: string;
7431
7674
  /**
7432
- * The JSON object of arguments for the function.
7675
+ * Required. The JSON object of arguments for the function.
7433
7676
  */
7434
7677
  arguments: {
7435
7678
  [key: string]: unknown;
7436
7679
  };
7437
7680
  /**
7438
- * The name of the tool which was called.
7681
+ * Required. The name of the tool which was called.
7439
7682
  */
7440
7683
  name: string;
7441
7684
  /**
7442
- * The name of the used MCP server.
7685
+ * Required. The name of the used MCP server.
7443
7686
  */
7444
7687
  server_name: string;
7445
7688
  type: 'mcp_server_tool_call';
7689
+ /**
7690
+ * A signature hash for backend validation.
7691
+ */
7692
+ signature?: string;
7446
7693
  }
7447
7694
 
7448
7695
  /**
@@ -7450,7 +7697,7 @@ declare interface MCPServerToolCallContent {
7450
7697
  */
7451
7698
  declare interface MCPServerToolResultContent {
7452
7699
  /**
7453
- * ID to match the ID from the MCP server tool call block.
7700
+ * Required. ID to match the ID from the function call block.
7454
7701
  */
7455
7702
  call_id: string;
7456
7703
  /**
@@ -7626,7 +7873,7 @@ export declare interface Model {
7626
7873
  /**
7627
7874
  * The model that will complete your prompt.\n\nSee [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
7628
7875
  */
7629
- 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 & {});
7876
+ 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 & {});
7630
7877
 
7631
7878
  /** 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. */
7632
7879
  export declare interface ModelArmorConfig {
@@ -8032,6 +8279,52 @@ export declare interface ModelSelectionConfig {
8032
8279
  featureSelectionPreference?: FeatureSelectionPreference;
8033
8280
  }
8034
8281
 
8282
+ /** The stage of the underlying model. This enum is not supported in Vertex AI. */
8283
+ export declare enum ModelStage {
8284
+ /**
8285
+ * Unspecified model stage.
8286
+ */
8287
+ MODEL_STAGE_UNSPECIFIED = "MODEL_STAGE_UNSPECIFIED",
8288
+ /**
8289
+ * The underlying model is subject to lots of tunings.
8290
+ */
8291
+ UNSTABLE_EXPERIMENTAL = "UNSTABLE_EXPERIMENTAL",
8292
+ /**
8293
+ * Models in this stage are for experimental purposes only.
8294
+ */
8295
+ EXPERIMENTAL = "EXPERIMENTAL",
8296
+ /**
8297
+ * Models in this stage are more mature than experimental models.
8298
+ */
8299
+ PREVIEW = "PREVIEW",
8300
+ /**
8301
+ * Models in this stage are considered stable and ready for production use.
8302
+ */
8303
+ STABLE = "STABLE",
8304
+ /**
8305
+ * 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.
8306
+ */
8307
+ LEGACY = "LEGACY",
8308
+ /**
8309
+ * Models in this stage are deprecated. These models cannot be used.
8310
+ */
8311
+ DEPRECATED = "DEPRECATED",
8312
+ /**
8313
+ * Models in this stage are retired. These models cannot be used.
8314
+ */
8315
+ RETIRED = "RETIRED"
8316
+ }
8317
+
8318
+ /** 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. */
8319
+ export declare interface ModelStatus {
8320
+ /** A message explaining the model status. */
8321
+ message?: string;
8322
+ /** The stage of the underlying model. */
8323
+ modelStage?: ModelStage;
8324
+ /** The time at which the model will be retired. */
8325
+ retirementTime?: string;
8326
+ }
8327
+
8035
8328
  /** Configuration for a multi-speaker text-to-speech request. */
8036
8329
  export declare interface MultiSpeakerVoiceConfig {
8037
8330
  /** Required. A list of configurations for the voices of the speakers. Exactly two speaker voice configurations must be provided. */
@@ -8117,7 +8410,6 @@ export declare interface Operation<T> {
8117
8410
  response?: T;
8118
8411
  /**
8119
8412
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
8120
- * @internal
8121
8413
  */
8122
8414
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<T>;
8123
8415
  }
@@ -8392,6 +8684,12 @@ export declare interface Part {
8392
8684
  thoughtSignature?: string;
8393
8685
  /** Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data. */
8394
8686
  videoMetadata?: VideoMetadata;
8687
+ /** Server-side tool call. This field is populated when the model predicts a tool invocation that should be executed on the server. The client is expected to echo this message back to the API. */
8688
+ toolCall?: ToolCall;
8689
+ /** The output from a server-side ToolCall execution. This field is populated by the client with the results of executing the corresponding ToolCall. */
8690
+ toolResponse?: ToolResponse;
8691
+ /** 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. */
8692
+ partMetadata?: Record<string, unknown>;
8395
8693
  }
8396
8694
 
8397
8695
  /** Partial argument value of the function call. This data type is not supported in Gemini API. */
@@ -8509,6 +8807,61 @@ export declare enum PhishBlockThreshold {
8509
8807
  BLOCK_ONLY_EXTREMELY_HIGH = "BLOCK_ONLY_EXTREMELY_HIGH"
8510
8808
  }
8511
8809
 
8810
+ /**
8811
+ * A place citation annotation.
8812
+ */
8813
+ declare interface PlaceCitation {
8814
+ type: 'place_citation';
8815
+ /**
8816
+ * End of the attributed segment, exclusive.
8817
+ */
8818
+ end_index?: number;
8819
+ /**
8820
+ * Title of the place.
8821
+ */
8822
+ name?: string;
8823
+ /**
8824
+ * The ID of the place, in `places/{place_id}` format.
8825
+ */
8826
+ place_id?: string;
8827
+ /**
8828
+ * Snippets of reviews that are used to generate answers about the
8829
+ * features of a given place in Google Maps.
8830
+ */
8831
+ review_snippets?: Array<PlaceCitation.ReviewSnippet>;
8832
+ /**
8833
+ * Start of segment of the response that is attributed to this source.
8834
+ *
8835
+ * Index indicates the start of the segment, measured in bytes.
8836
+ */
8837
+ start_index?: number;
8838
+ /**
8839
+ * URI reference of the place.
8840
+ */
8841
+ url?: string;
8842
+ }
8843
+
8844
+ declare namespace PlaceCitation {
8845
+ /**
8846
+ * Encapsulates a snippet of a user review that answers a question about
8847
+ * the features of a specific place in Google Maps.
8848
+ */
8849
+ interface ReviewSnippet {
8850
+ /**
8851
+ * The ID of the review snippet.
8852
+ */
8853
+ review_id?: string;
8854
+ /**
8855
+ * Title of the review.
8856
+ */
8857
+ title?: string;
8858
+ /**
8859
+ * A link that corresponds to the user review on Google Maps.
8860
+ */
8861
+ url?: string;
8862
+ }
8863
+ }
8864
+
8512
8865
  /** Spec for pointwise metric result. This data type is not supported in Gemini API. */
8513
8866
  export declare interface PointwiseMetricResult {
8514
8867
  /** Output only. Spec for custom output. */
@@ -8597,7 +8950,7 @@ export declare interface ProductImage {
8597
8950
  productImage?: Image_2;
8598
8951
  }
8599
8952
 
8600
- /** Enum for controlling whether the model can generate images of prominent people (celebrities). */
8953
+ /** 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. */
8601
8954
  export declare enum ProminentPeople {
8602
8955
  /**
8603
8956
  * Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.
@@ -8874,12 +9227,14 @@ export declare class ReplayResponse {
8874
9227
  sdkResponseSegments?: Record<string, unknown>[];
8875
9228
  }
8876
9229
 
8877
- /** ReplicatedVoiceConfig is used to configure replicated voice. */
9230
+ /** The configuration for the replicated voice to use. */
8878
9231
  export declare interface ReplicatedVoiceConfig {
8879
- /** The mime type of the replicated voice.
9232
+ /** The mimetype of the voice sample. The only currently supported
9233
+ value is `audio/wav`. This represents 16-bit signed little-endian wav
9234
+ data, with a 24kHz sampling rate.
8880
9235
  */
8881
9236
  mimeType?: string;
8882
- /** The sample audio of the replicated voice.
9237
+ /** The sample of the custom voice.
8883
9238
 
8884
9239
  * @remarks Encoded as base64 string. */
8885
9240
  voiceSampleAudio?: string;
@@ -9123,7 +9478,7 @@ export declare interface Schema {
9123
9478
  anyOf?: Schema[];
9124
9479
  /** Optional. Default value to use if the field is not specified. */
9125
9480
  default?: unknown;
9126
- /** Optional. Description of the schema. */
9481
+ /** 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. */
9127
9482
  description?: string;
9128
9483
  /** 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"]}` */
9129
9484
  enum?: string[];
@@ -9183,12 +9538,11 @@ export declare interface SearchEntryPoint {
9183
9538
  sdkBlob?: string;
9184
9539
  }
9185
9540
 
9186
- /** Tool to support computer use. */
9541
+ /** Different types of search that can be enabled on the GoogleSearch tool. */
9187
9542
  export declare interface SearchTypes {
9188
- /** Setting this field enables web search. Only text results are
9189
- returned. */
9543
+ /** Optional. Setting this field enables web search. Only text results are returned. */
9190
9544
  webSearch?: WebSearch;
9191
- /** Setting this field enables image search. Image bytes are returned. */
9545
+ /** Optional. Setting this field enables image search. Image bytes are returned. */
9192
9546
  imageSearch?: ImageSearch;
9193
9547
  }
9194
9548
 
@@ -9301,6 +9655,26 @@ export declare interface SendMessageParameters {
9301
9655
  config?: GenerateContentConfig;
9302
9656
  }
9303
9657
 
9658
+ /** Pricing and performance service tier. */
9659
+ export declare enum ServiceTier {
9660
+ /**
9661
+ * Default service tier, which is standard.
9662
+ */
9663
+ SERVICE_TIER_UNSPECIFIED = "SERVICE_TIER_UNSPECIFIED",
9664
+ /**
9665
+ * Flex service tier.
9666
+ */
9667
+ SERVICE_TIER_FLEX = "SERVICE_TIER_FLEX",
9668
+ /**
9669
+ * Standard service tier.
9670
+ */
9671
+ SERVICE_TIER_STANDARD = "SERVICE_TIER_STANDARD",
9672
+ /**
9673
+ * Priority service tier.
9674
+ */
9675
+ SERVICE_TIER_PRIORITY = "SERVICE_TIER_PRIORITY"
9676
+ }
9677
+
9304
9678
  /**
9305
9679
  Represents a connection to the API.
9306
9680
 
@@ -9490,8 +9864,9 @@ export declare interface SpeakerVoiceConfig {
9490
9864
  voiceConfig?: VoiceConfig;
9491
9865
  }
9492
9866
 
9867
+ /** Config for speech generation and transcription. */
9493
9868
  export declare interface SpeechConfig {
9494
- /** Configuration for the voice of the response. */
9869
+ /** The configuration in case of single-voice output. */
9495
9870
  voiceConfig?: VoiceConfig;
9496
9871
  /** Optional. The language code (ISO 639-1) for the speech synthesis. */
9497
9872
  languageCode?: string;
@@ -9760,7 +10135,7 @@ export declare interface TestTableItem {
9760
10135
  */
9761
10136
  declare interface TextContent {
9762
10137
  /**
9763
- * The text content.
10138
+ * Required. The text content.
9764
10139
  */
9765
10140
  text: string;
9766
10141
  type: 'text';
@@ -9788,6 +10163,10 @@ export declare enum ThinkingLevel {
9788
10163
  * Unspecified thinking level.
9789
10164
  */
9790
10165
  THINKING_LEVEL_UNSPECIFIED = "THINKING_LEVEL_UNSPECIFIED",
10166
+ /**
10167
+ * MINIMAL thinking level.
10168
+ */
10169
+ MINIMAL = "MINIMAL",
9791
10170
  /**
9792
10171
  * Low thinking level.
9793
10172
  */
@@ -9799,11 +10178,7 @@ export declare enum ThinkingLevel {
9799
10178
  /**
9800
10179
  * High thinking level.
9801
10180
  */
9802
- HIGH = "HIGH",
9803
- /**
9804
- * MINIMAL thinking level.
9805
- */
9806
- MINIMAL = "MINIMAL"
10181
+ HIGH = "HIGH"
9807
10182
  }
9808
10183
 
9809
10184
  declare type ThinkingLevel_2 = 'minimal' | 'low' | 'medium' | 'high';
@@ -9931,9 +10306,9 @@ export declare interface Tool {
9931
10306
  computer. If enabled, it automatically populates computer-use specific
9932
10307
  Function Declarations. */
9933
10308
  computerUse?: ComputerUse;
9934
- /** Optional. Tool to retrieve knowledge from the File Search Stores. */
10309
+ /** Optional. FileSearch tool type. Tool to retrieve knowledge from Semantic Retrieval corpora. This field is not supported in Vertex AI. */
9935
10310
  fileSearch?: FileSearch;
9936
- /** Enables the model to execute Google Search as part of generation. */
10311
+ /** Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
9937
10312
  googleSearch?: GoogleSearch;
9938
10313
  /** Optional. Tool that allows grounding the model's response with
9939
10314
  geospatial context related to the user's query. */
@@ -9957,7 +10332,7 @@ export declare interface Tool {
9957
10332
  /**
9958
10333
  * A tool that can be used by the model.
9959
10334
  */
9960
- declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch;
10335
+ 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;
9961
10336
 
9962
10337
  declare namespace Tool_2 {
9963
10338
  /**
@@ -10039,6 +10414,40 @@ declare namespace Tool_2 {
10039
10414
  */
10040
10415
  top_k?: number;
10041
10416
  }
10417
+ /**
10418
+ * A tool that can be used by the model to call Google Maps.
10419
+ */
10420
+ interface GoogleMaps {
10421
+ type: 'google_maps';
10422
+ /**
10423
+ * Whether to return a widget context token in the tool call result of the
10424
+ * response.
10425
+ */
10426
+ enable_widget?: boolean;
10427
+ /**
10428
+ * The latitude of the user's location.
10429
+ */
10430
+ latitude?: number;
10431
+ /**
10432
+ * The longitude of the user's location.
10433
+ */
10434
+ longitude?: number;
10435
+ }
10436
+ }
10437
+
10438
+ /** A predicted server-side `ToolCall` returned from the model.
10439
+
10440
+ This message contains information about a tool that the model wants to invoke.
10441
+ The client is NOT expected to execute this `ToolCall`. Instead, the
10442
+ client should pass this `ToolCall` back to the API in a subsequent turn
10443
+ within a `Content` message, along with the corresponding `ToolResponse`. */
10444
+ export declare interface ToolCall {
10445
+ /** Unique identifier of the tool call. The server returns the tool response with the matching `id`. */
10446
+ id?: string;
10447
+ /** The type of tool that was called. */
10448
+ toolType?: ToolType;
10449
+ /** The tool call arguments. Example: {"arg1": "value1", "arg2": "value2"}. */
10450
+ args?: Record<string, unknown>;
10042
10451
  }
10043
10452
 
10044
10453
  /**
@@ -10065,6 +10474,8 @@ export declare interface ToolConfig {
10065
10474
  retrievalConfig?: RetrievalConfig;
10066
10475
  /** Optional. Function calling config. */
10067
10476
  functionCallingConfig?: FunctionCallingConfig;
10477
+ /** If true, the API response will include the server-side tool calls and responses within the `Content` message. This allows clients to observe the server's tool invocations. */
10478
+ includeServerSideToolInvocations?: boolean;
10068
10479
  }
10069
10480
 
10070
10481
  export declare type ToolListUnion = ToolUnion[];
@@ -10077,6 +10488,49 @@ export declare interface ToolParallelAiSearch {
10077
10488
  customConfigs?: Record<string, unknown>;
10078
10489
  }
10079
10490
 
10491
+ /** The output from a server-side `ToolCall` execution.
10492
+
10493
+ This message contains the results of a tool invocation that was initiated by a
10494
+ `ToolCall` from the model. The client should pass this `ToolResponse` back to
10495
+ the API in a subsequent turn within a `Content` message, along with the
10496
+ corresponding `ToolCall`. */
10497
+ export declare class ToolResponse {
10498
+ /** The identifier of the tool call this response is for. */
10499
+ id?: string;
10500
+ /** The type of tool that was called, matching the tool_type in the corresponding ToolCall. */
10501
+ toolType?: ToolType;
10502
+ /** The tool response. */
10503
+ response?: Record<string, unknown>;
10504
+ }
10505
+
10506
+ /** The type of tool in the function call. */
10507
+ export declare enum ToolType {
10508
+ /**
10509
+ * Unspecified tool type.
10510
+ */
10511
+ TOOL_TYPE_UNSPECIFIED = "TOOL_TYPE_UNSPECIFIED",
10512
+ /**
10513
+ * Google search tool, maps to Tool.google_search.search_types.web_search.
10514
+ */
10515
+ GOOGLE_SEARCH_WEB = "GOOGLE_SEARCH_WEB",
10516
+ /**
10517
+ * Image search tool, maps to Tool.google_search.search_types.image_search.
10518
+ */
10519
+ GOOGLE_SEARCH_IMAGE = "GOOGLE_SEARCH_IMAGE",
10520
+ /**
10521
+ * URL context tool, maps to Tool.url_context.
10522
+ */
10523
+ URL_CONTEXT = "URL_CONTEXT",
10524
+ /**
10525
+ * Google maps tool, maps to Tool.google_maps.
10526
+ */
10527
+ GOOGLE_MAPS = "GOOGLE_MAPS",
10528
+ /**
10529
+ * File search tool, maps to Tool.file_search.
10530
+ */
10531
+ FILE_SEARCH = "FILE_SEARCH"
10532
+ }
10533
+
10080
10534
  export declare type ToolUnion = Tool | CallableTool;
10081
10535
 
10082
10536
  /** Output only. The traffic type for this request. This enum is not supported in Gemini API. */
@@ -10105,11 +10559,9 @@ export declare enum TrafficType {
10105
10559
 
10106
10560
  /** Audio transcription in Server Conent. */
10107
10561
  export declare interface Transcription {
10108
- /** Transcription text.
10109
- */
10562
+ /** Optional. Transcription text. */
10110
10563
  text?: string;
10111
- /** The bool indicates the end of the transcription.
10112
- */
10564
+ /** Optional. The bool indicates the end of the transcription. */
10113
10565
  finished?: boolean;
10114
10566
  }
10115
10567
 
@@ -10247,6 +10699,18 @@ export declare interface TuningJob {
10247
10699
  tuningJobState?: TuningJobState;
10248
10700
  /** Tuning Spec for Veo Tuning. */
10249
10701
  veoTuningSpec?: VeoTuningSpec;
10702
+ /** Optional. Spec for creating a distillation dataset. */
10703
+ distillationSamplingSpec?: DistillationSamplingSpec;
10704
+ /** Output only. Tuning Job metadata. */
10705
+ tuningJobMetadata?: TuningJobMetadata;
10706
+ }
10707
+
10708
+ /** Tuning job metadata. This data type is not supported in Gemini API. */
10709
+ export declare interface TuningJobMetadata {
10710
+ /** Output only. The number of epochs that have been completed. */
10711
+ completedEpochCount?: string;
10712
+ /** Output only. The number of steps that have been completed. Set for Multi-Step RL. */
10713
+ completedStepCount?: string;
10250
10714
  }
10251
10715
 
10252
10716
  /** Output only. The detail state of the tuning job (while the overall `JobState` is running). This enum is not supported in Gemini API. */
@@ -10407,10 +10871,7 @@ export declare interface TuningValidationDataset {
10407
10871
  }
10408
10872
 
10409
10873
  declare interface Turn {
10410
- /**
10411
- * The content of the turn.
10412
- */
10413
- content?: string | Array<Content_2>;
10874
+ content?: Array<Content_2> | string;
10414
10875
  /**
10415
10876
  * The originator of this turn. Must be user for input or model for
10416
10877
  * model output.
@@ -10451,7 +10912,11 @@ export declare enum TurnCoverage {
10451
10912
  /**
10452
10913
  * The users turn includes all realtime input since the last turn, including inactivity (e.g. silence on the audio stream).
10453
10914
  */
10454
- TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT"
10915
+ TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT",
10916
+ /**
10917
+ * Includes audio activity and all video since the last turn. With automatic activity detection, audio activity means speech and excludes silence.
10918
+ */
10919
+ TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO = "TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO"
10455
10920
  }
10456
10921
 
10457
10922
  /** Data type of the schema field. */
@@ -10503,19 +10968,21 @@ declare namespace types {
10503
10968
  createPartFromExecutableCode,
10504
10969
  createUserContent,
10505
10970
  createModelContent,
10506
- Outcome,
10507
10971
  Language,
10972
+ Outcome,
10508
10973
  FunctionResponseScheduling,
10509
10974
  Type,
10510
- PhishBlockThreshold,
10975
+ Environment,
10511
10976
  AuthType,
10512
10977
  HttpElementLocation,
10513
10978
  ApiSpec,
10979
+ PhishBlockThreshold,
10514
10980
  Behavior,
10515
10981
  DynamicRetrievalConfigMode,
10516
10982
  FunctionCallingConfigMode,
10517
10983
  ThinkingLevel,
10518
10984
  PersonGeneration,
10985
+ ProminentPeople,
10519
10986
  HarmCategory,
10520
10987
  HarmBlockMethod,
10521
10988
  HarmBlockThreshold,
@@ -10526,6 +10993,7 @@ declare namespace types {
10526
10993
  BlockedReason,
10527
10994
  TrafficType,
10528
10995
  Modality,
10996
+ ModelStage,
10529
10997
  MediaResolution,
10530
10998
  TuningMode,
10531
10999
  AdapterSize,
@@ -10534,11 +11002,12 @@ declare namespace types {
10534
11002
  AggregationMetric,
10535
11003
  PairwiseChoice,
10536
11004
  TuningTask,
11005
+ DocumentState,
10537
11006
  PartMediaResolutionLevel,
11007
+ ToolType,
10538
11008
  ResourceScope,
11009
+ ServiceTier,
10539
11010
  FeatureSelectionPreference,
10540
- Environment,
10541
- ProminentPeople,
10542
11011
  EmbeddingApiType,
10543
11012
  SafetyFilterLevel,
10544
11013
  ImagePromptLanguage,
@@ -10551,7 +11020,6 @@ declare namespace types {
10551
11020
  VideoGenerationMaskMode,
10552
11021
  VideoCompressionQuality,
10553
11022
  TuningMethod,
10554
- DocumentState,
10555
11023
  FileState,
10556
11024
  FileSource,
10557
11025
  TurnCompleteReason,
@@ -10565,9 +11033,11 @@ declare namespace types {
10565
11033
  Scale,
10566
11034
  MusicGenerationMode,
10567
11035
  LiveMusicPlaybackControl,
10568
- PartMediaResolution,
10569
- CodeExecutionResult,
10570
11036
  ExecutableCode,
11037
+ CodeExecutionResult,
11038
+ PartMediaResolution,
11039
+ ToolCall,
11040
+ ToolResponse,
10571
11041
  FileData,
10572
11042
  PartialArg,
10573
11043
  FunctionCall,
@@ -10584,12 +11054,6 @@ declare namespace types {
10584
11054
  Schema,
10585
11055
  ModelSelectionConfig,
10586
11056
  ComputerUse,
10587
- FileSearch,
10588
- WebSearch,
10589
- ImageSearch,
10590
- SearchTypes,
10591
- Interval,
10592
- GoogleSearch,
10593
11057
  ApiKeyConfig,
10594
11058
  AuthConfigGoogleServiceAccountConfig,
10595
11059
  AuthConfigHttpBasicAuthConfig,
@@ -10613,6 +11077,12 @@ declare namespace types {
10613
11077
  RagRetrievalConfig,
10614
11078
  VertexRagStore,
10615
11079
  Retrieval,
11080
+ FileSearch,
11081
+ WebSearch,
11082
+ ImageSearch,
11083
+ SearchTypes,
11084
+ Interval,
11085
+ GoogleSearch,
10616
11086
  ToolCodeExecution,
10617
11087
  EnterpriseWebSearch,
10618
11088
  FunctionDeclaration,
@@ -10649,13 +11119,16 @@ declare namespace types {
10649
11119
  GoogleTypeDate,
10650
11120
  Citation,
10651
11121
  CitationMetadata,
10652
- GroundingChunkImage,
10653
11122
  GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
10654
11123
  GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
10655
11124
  GroundingChunkMapsPlaceAnswerSources,
11125
+ GroundingChunkMapsRoute,
10656
11126
  GroundingChunkMaps,
11127
+ GroundingChunkImage,
10657
11128
  RagChunkPageSpan,
10658
11129
  RagChunk,
11130
+ GroundingChunkStringList,
11131
+ GroundingChunkCustomMetadata,
10659
11132
  GroundingChunkRetrievedContext,
10660
11133
  GroundingChunkWeb,
10661
11134
  GroundingChunk,
@@ -10675,6 +11148,7 @@ declare namespace types {
10675
11148
  GenerateContentResponsePromptFeedback,
10676
11149
  ModalityTokenCount,
10677
11150
  GenerateContentResponseUsageMetadata,
11151
+ ModelStatus,
10678
11152
  GenerateContentResponse,
10679
11153
  ReferenceImage,
10680
11154
  EditImageParameters,
@@ -10785,6 +11259,8 @@ declare namespace types {
10785
11259
  FullFineTuningSpec,
10786
11260
  VeoHyperParameters,
10787
11261
  VeoTuningSpec,
11262
+ DistillationSamplingSpec,
11263
+ TuningJobMetadata,
10788
11264
  TuningJob,
10789
11265
  ListTuningJobsConfig,
10790
11266
  ListTuningJobsParameters,
@@ -11072,7 +11548,7 @@ declare interface Uploader {
11072
11548
  * @param apiClient The ApiClient to use for uploading.
11073
11549
  * @return A Promise that resolves to types.File.
11074
11550
  */
11075
- upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<File_2>;
11551
+ upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<File_2>;
11076
11552
  /**
11077
11553
  * Uploads a file to file search store via the given upload url.
11078
11554
  *
@@ -11081,9 +11557,10 @@ declare interface Uploader {
11081
11557
  * uploaded to. The uploadUrl must be a url that was returned by the
11082
11558
  * https://generativelanguage.googleapis.com/upload/v1beta/{file_search_store_name}:uploadToFileSearchStore endpoint
11083
11559
  * @param apiClient The ApiClient to use for uploading.
11560
+ * @param httpOptions Optional HTTP options to merge.
11084
11561
  * @return A Promise that resolves to types.UploadToFileSearchStoreOperation.
11085
11562
  */
11086
- uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<UploadToFileSearchStoreOperation>;
11563
+ uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<UploadToFileSearchStoreOperation>;
11087
11564
  /**
11088
11565
  * Returns the file's mimeType and the size of a given file. If the file is a
11089
11566
  * string path, the file type is determined by the file extension. If the
@@ -11157,7 +11634,6 @@ export declare class UploadToFileSearchStoreOperation implements Operation<Uploa
11157
11634
  response?: UploadToFileSearchStoreResponse;
11158
11635
  /**
11159
11636
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
11160
- * @internal
11161
11637
  */
11162
11638
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<UploadToFileSearchStoreResponse>;
11163
11639
  /** The full HTTP response. */
@@ -11259,6 +11735,31 @@ export declare class UpscaleImageResponse {
11259
11735
  generatedImages?: GeneratedImage[];
11260
11736
  }
11261
11737
 
11738
+ /**
11739
+ * A URL citation annotation.
11740
+ */
11741
+ declare interface URLCitation {
11742
+ type: 'url_citation';
11743
+ /**
11744
+ * End of the attributed segment, exclusive.
11745
+ */
11746
+ end_index?: number;
11747
+ /**
11748
+ * Start of segment of the response that is attributed to this source.
11749
+ *
11750
+ * Index indicates the start of the segment, measured in bytes.
11751
+ */
11752
+ start_index?: number;
11753
+ /**
11754
+ * The title of the URL.
11755
+ */
11756
+ title?: string;
11757
+ /**
11758
+ * The URL.
11759
+ */
11760
+ url?: string;
11761
+ }
11762
+
11262
11763
  /** Tool to support URL context. */
11263
11764
  export declare interface UrlContext {
11264
11765
  }
@@ -11278,14 +11779,18 @@ declare interface URLContextCallArguments {
11278
11779
  */
11279
11780
  declare interface URLContextCallContent {
11280
11781
  /**
11281
- * A unique ID for this specific tool call.
11782
+ * Required. A unique ID for this specific tool call.
11282
11783
  */
11283
11784
  id: string;
11284
11785
  /**
11285
- * The arguments to pass to the URL context.
11786
+ * Required. The arguments to pass to the URL context.
11286
11787
  */
11287
11788
  arguments: URLContextCallArguments;
11288
11789
  type: 'url_context_call';
11790
+ /**
11791
+ * A signature hash for backend validation.
11792
+ */
11793
+ signature?: string;
11289
11794
  }
11290
11795
 
11291
11796
  /** Metadata returned when the model uses the `url_context` tool to get information from a user-provided URL. */
@@ -11313,11 +11818,11 @@ declare interface URLContextResult {
11313
11818
  */
11314
11819
  declare interface URLContextResultContent {
11315
11820
  /**
11316
- * ID to match the ID from the url context call block.
11821
+ * Required. ID to match the ID from the function call block.
11317
11822
  */
11318
11823
  call_id: string;
11319
11824
  /**
11320
- * The results of the URL context.
11825
+ * Required. The results of the URL context.
11321
11826
  */
11322
11827
  result: Array<URLContextResult>;
11323
11828
  type: 'url_context_result';
@@ -11722,16 +12227,17 @@ export declare enum VoiceActivityType {
11722
12227
  ACTIVITY_END = "ACTIVITY_END"
11723
12228
  }
11724
12229
 
12230
+ /** The configuration for the voice to use. */
11725
12231
  export declare interface VoiceConfig {
11726
- /** If true, the model will use a replicated voice for the response. */
12232
+ /** The configuration for a replicated voice, which is a clone of a
12233
+ user's voice that can be used for speech synthesis. If this is unset, a
12234
+ default voice is used. */
11727
12235
  replicatedVoiceConfig?: ReplicatedVoiceConfig;
11728
12236
  /** The configuration for a prebuilt voice. */
11729
12237
  prebuiltVoiceConfig?: PrebuiltVoiceConfig;
11730
12238
  }
11731
12239
 
11732
- /** Standard web search for grounding and related configurations.
11733
-
11734
- Only text results are returned. */
12240
+ /** Standard web search for grounding and related configurations. Only text results are returned. */
11735
12241
  export declare interface WebSearch {
11736
12242
  }
11737
12243