@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.
package/dist/web/web.d.ts CHANGED
@@ -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
  /**
@@ -5223,6 +5327,110 @@ export declare interface GoogleMaps {
5223
5327
  enableWidget?: boolean;
5224
5328
  }
5225
5329
 
5330
+ /**
5331
+ * The arguments to pass to the Google Maps tool.
5332
+ */
5333
+ declare interface GoogleMapsCallArguments {
5334
+ /**
5335
+ * The queries to be executed.
5336
+ */
5337
+ queries?: Array<string>;
5338
+ }
5339
+
5340
+ /**
5341
+ * Google Maps content.
5342
+ */
5343
+ declare interface GoogleMapsCallContent {
5344
+ /**
5345
+ * Required. A unique ID for this specific tool call.
5346
+ */
5347
+ id: string;
5348
+ type: 'google_maps_call';
5349
+ /**
5350
+ * The arguments to pass to the Google Maps tool.
5351
+ */
5352
+ arguments?: GoogleMapsCallArguments;
5353
+ /**
5354
+ * A signature hash for backend validation.
5355
+ */
5356
+ signature?: string;
5357
+ }
5358
+
5359
+ /**
5360
+ * The result of the Google Maps.
5361
+ */
5362
+ declare interface GoogleMapsResult {
5363
+ /**
5364
+ * The places that were found.
5365
+ */
5366
+ places?: Array<GoogleMapsResult.Place>;
5367
+ /**
5368
+ * Resource name of the Google Maps widget context token.
5369
+ */
5370
+ widget_context_token?: string;
5371
+ }
5372
+
5373
+ declare namespace GoogleMapsResult {
5374
+ interface Place {
5375
+ /**
5376
+ * Title of the place.
5377
+ */
5378
+ name?: string;
5379
+ /**
5380
+ * The ID of the place, in `places/{place_id}` format.
5381
+ */
5382
+ place_id?: string;
5383
+ /**
5384
+ * Snippets of reviews that are used to generate answers about the
5385
+ * features of a given place in Google Maps.
5386
+ */
5387
+ review_snippets?: Array<Place.ReviewSnippet>;
5388
+ /**
5389
+ * URI reference of the place.
5390
+ */
5391
+ url?: string;
5392
+ }
5393
+ namespace Place {
5394
+ /**
5395
+ * Encapsulates a snippet of a user review that answers a question about
5396
+ * the features of a specific place in Google Maps.
5397
+ */
5398
+ interface ReviewSnippet {
5399
+ /**
5400
+ * The ID of the review snippet.
5401
+ */
5402
+ review_id?: string;
5403
+ /**
5404
+ * Title of the review.
5405
+ */
5406
+ title?: string;
5407
+ /**
5408
+ * A link that corresponds to the user review on Google Maps.
5409
+ */
5410
+ url?: string;
5411
+ }
5412
+ }
5413
+ }
5414
+
5415
+ /**
5416
+ * Google Maps result content.
5417
+ */
5418
+ declare interface GoogleMapsResultContent {
5419
+ /**
5420
+ * Required. ID to match the ID from the function call block.
5421
+ */
5422
+ call_id: string;
5423
+ /**
5424
+ * Required. The results of the Google Maps.
5425
+ */
5426
+ result: Array<GoogleMapsResult>;
5427
+ type: 'google_maps_result';
5428
+ /**
5429
+ * A signature hash for backend validation.
5430
+ */
5431
+ signature?: string;
5432
+ }
5433
+
5226
5434
  /** 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. */
5227
5435
  export declare interface GoogleRpcStatus {
5228
5436
  /** The status code, which should be an enum value of google.rpc.Code. */
@@ -5233,9 +5441,9 @@ export declare interface GoogleRpcStatus {
5233
5441
  message?: string;
5234
5442
  }
5235
5443
 
5236
- /** Tool to support web search. */
5444
+ /** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
5237
5445
  export declare interface GoogleSearch {
5238
- /** Different types of search that can be enabled on the GoogleSearch tool. */
5446
+ /** Optional. The set of search types to enable. If not set, web search is enabled by default. */
5239
5447
  searchTypes?: SearchTypes;
5240
5448
  /** Optional. Sites with confidence level chosen & above this value will be blocked from the search results. This field is not supported in Gemini API. */
5241
5449
  blockingConfidence?: PhishBlockThreshold;
@@ -5260,11 +5468,11 @@ declare interface GoogleSearchCallArguments {
5260
5468
  */
5261
5469
  declare interface GoogleSearchCallContent {
5262
5470
  /**
5263
- * A unique ID for this specific tool call.
5471
+ * Required. A unique ID for this specific tool call.
5264
5472
  */
5265
5473
  id: string;
5266
5474
  /**
5267
- * The arguments to pass to Google Search.
5475
+ * Required. The arguments to pass to Google Search.
5268
5476
  */
5269
5477
  arguments: GoogleSearchCallArguments;
5270
5478
  type: 'google_search_call';
@@ -5272,6 +5480,10 @@ declare interface GoogleSearchCallContent {
5272
5480
  * The type of search grounding enabled.
5273
5481
  */
5274
5482
  search_type?: 'web_search' | 'image_search';
5483
+ /**
5484
+ * A signature hash for backend validation.
5485
+ */
5486
+ signature?: string;
5275
5487
  }
5276
5488
 
5277
5489
  /**
@@ -5281,15 +5493,7 @@ declare interface GoogleSearchResult {
5281
5493
  /**
5282
5494
  * Web content snippet that can be embedded in a web page or an app webview.
5283
5495
  */
5284
- rendered_content?: string;
5285
- /**
5286
- * Title of the search result.
5287
- */
5288
- title?: string;
5289
- /**
5290
- * URI reference of the search result.
5291
- */
5292
- url?: string;
5496
+ search_suggestions?: string;
5293
5497
  }
5294
5498
 
5295
5499
  /**
@@ -5297,11 +5501,11 @@ declare interface GoogleSearchResult {
5297
5501
  */
5298
5502
  declare interface GoogleSearchResultContent {
5299
5503
  /**
5300
- * ID to match the ID from the google search call block.
5504
+ * Required. ID to match the ID from the function call block.
5301
5505
  */
5302
5506
  call_id: string;
5303
5507
  /**
5304
- * The results of the Google Search.
5508
+ * Required. The results of the Google Search.
5305
5509
  */
5306
5510
  result: Array<GoogleSearchResult>;
5307
5511
  type: 'google_search_result';
@@ -5337,9 +5541,7 @@ export declare interface GoogleTypeDate {
5337
5541
  is enabled, the model returns a `GroundingChunk` that contains a reference to
5338
5542
  the source of the information. */
5339
5543
  export declare interface GroundingChunk {
5340
- /** A grounding chunk from an image search result. See the `Image`
5341
- message for details.
5342
- */
5544
+ /** A grounding chunk from an image search result. See the `Image` message for details. */
5343
5545
  image?: GroundingChunkImage;
5344
5546
  /** A `Maps` chunk is a piece of evidence that comes from Google Maps.
5345
5547
 
@@ -5347,17 +5549,25 @@ export declare interface GroundingChunk {
5347
5549
  reviews. This is used to provide the user with rich, location-based
5348
5550
  information. */
5349
5551
  maps?: GroundingChunkMaps;
5350
- /** A grounding chunk from a data source retrieved by a retrieval tool, such as Vertex AI Search. See the `RetrievedContext` message for details. This field is not supported in Gemini API. */
5552
+ /** A grounding chunk from a data source retrieved by a retrieval tool, such as Vertex AI Search. See the `RetrievedContext` message for details */
5351
5553
  retrievedContext?: GroundingChunkRetrievedContext;
5352
5554
  /** A grounding chunk from a web page, typically from Google Search. See the `Web` message for details. */
5353
5555
  web?: GroundingChunkWeb;
5354
5556
  }
5355
5557
 
5356
- /** A piece of evidence that comes from an image search result.
5558
+ /** User provided metadata about the GroundingFact. This data type is not supported in Vertex AI. */
5559
+ export declare interface GroundingChunkCustomMetadata {
5560
+ /** The key of the metadata. */
5561
+ key?: string;
5562
+ /** Optional. The numeric value of the metadata. The expected range for this value depends on the specific `key` used. */
5563
+ numericValue?: number;
5564
+ /** Optional. A list of string values for the metadata. */
5565
+ stringListValue?: GroundingChunkStringList;
5566
+ /** Optional. The string value of the metadata. */
5567
+ stringValue?: string;
5568
+ }
5357
5569
 
5358
- It contains the URI of the image search result and the URI of the image.
5359
- This is used to provide the user with a link to the source of the
5360
- information. */
5570
+ /** An `Image` chunk is a piece of evidence that comes from an image search result. It contains the URI of the image search result and the URI of the image. This is used to provide the user with a link to the source of the information. */
5361
5571
  export declare interface GroundingChunkImage {
5362
5572
  /** The URI of the image search result page. */
5363
5573
  sourceUri?: string;
@@ -5389,6 +5599,8 @@ export declare interface GroundingChunkMaps {
5389
5599
  title?: string;
5390
5600
  /** The URI of the place. */
5391
5601
  uri?: string;
5602
+ /** Output only. Route information. */
5603
+ route?: GroundingChunkMapsRoute;
5392
5604
  }
5393
5605
 
5394
5606
  /** The sources that were used to generate the place answer.
@@ -5432,11 +5644,21 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
5432
5644
  title?: string;
5433
5645
  }
5434
5646
 
5435
- /** Context retrieved from a data source to ground the model's response. This is used when a retrieval tool fetches information from a user-provided corpus or a public dataset. This data type is not supported in Gemini API. */
5647
+ /** Route information from Google Maps. This data type is not supported in Gemini API. */
5648
+ export declare interface GroundingChunkMapsRoute {
5649
+ /** The total distance of the route, in meters. */
5650
+ distanceMeters?: number;
5651
+ /** The total duration of the route. */
5652
+ duration?: string;
5653
+ /** An encoded polyline of the route. See https://developers.google.com/maps/documentation/utilities/polylinealgorithm */
5654
+ encodedPolyline?: string;
5655
+ }
5656
+
5657
+ /** Context retrieved from a data source to ground the model's response. This is used when a retrieval tool fetches information from a user-provided corpus or a public dataset. */
5436
5658
  export declare interface GroundingChunkRetrievedContext {
5437
- /** Output only. The full resource name of the referenced Vertex AI Search document. This is used to identify the specific document that was retrieved. The format is `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`. */
5659
+ /** Output only. The full resource name of the referenced Vertex AI Search document. This is used to identify the specific document that was retrieved. The format is `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`. This field is not supported in Gemini API. */
5438
5660
  documentName?: string;
5439
- /** Additional context for a Retrieval-Augmented Generation (RAG) retrieval result. This is populated only when the RAG retrieval tool is used. */
5661
+ /** Additional context for a Retrieval-Augmented Generation (RAG) retrieval result. This is populated only when the RAG retrieval tool is used. This field is not supported in Gemini API. */
5440
5662
  ragChunk?: RagChunk;
5441
5663
  /** The content of the retrieved data source. */
5442
5664
  text?: string;
@@ -5444,6 +5666,16 @@ export declare interface GroundingChunkRetrievedContext {
5444
5666
  title?: string;
5445
5667
  /** The URI of the retrieved data source. */
5446
5668
  uri?: string;
5669
+ /** Optional. User-provided metadata about the retrieved context. This field is not supported in Vertex AI. */
5670
+ customMetadata?: GroundingChunkCustomMetadata[];
5671
+ /** Optional. Name of the `FileSearchStore` containing the document. Example: `fileSearchStores/123`. This field is not supported in Vertex AI. */
5672
+ fileSearchStore?: string;
5673
+ }
5674
+
5675
+ /** A list of string values. This data type is not supported in Vertex AI. */
5676
+ export declare interface GroundingChunkStringList {
5677
+ /** The string values of the list. */
5678
+ values?: string[];
5447
5679
  }
5448
5680
 
5449
5681
  /** A `Web` chunk is a piece of evidence that comes from a web page. It contains the URI of the web page, the title of the page, and the domain of the page. This is used to provide the user with a link to the source of the information. */
@@ -5458,10 +5690,7 @@ export declare interface GroundingChunkWeb {
5458
5690
 
5459
5691
  /** Information for various kinds of grounding. */
5460
5692
  export declare interface GroundingMetadata {
5461
- /** Optional. The image search queries that were used to generate the
5462
- content. This field is populated only when the grounding source is Google
5463
- Search with the Image Search search_type enabled.
5464
- */
5693
+ /** Optional. The image search queries that were used to generate the content. This field is populated only when the grounding source is Google Search with the Image Search search_type enabled. */
5465
5694
  imageSearchQueries?: string[];
5466
5695
  /** A list of supporting references retrieved from the grounding
5467
5696
  source. This field is populated when the grounding source is Google
@@ -5477,7 +5706,7 @@ export declare interface GroundingMetadata {
5477
5706
  searchEntryPoint?: SearchEntryPoint;
5478
5707
  /** Web search queries for the following-up web search. */
5479
5708
  webSearchQueries?: string[];
5480
- /** Optional. Output only. A token that can be used to render a Google Maps widget with the contextual data. This field is populated only when the grounding source is Google Maps. This field is not supported in Gemini API. */
5709
+ /** Optional. Output only. A token that can be used to render a Google Maps widget with the contextual data. This field is populated only when the grounding source is Google Maps. */
5481
5710
  googleMapsWidgetContextToken?: string;
5482
5711
  /** Optional. The queries that were executed by the retrieval tools. This field is populated only when the grounding source is a retrieval tool, such as Vertex AI Search. This field is not supported in Gemini API. */
5483
5712
  retrievalQueries?: string[];
@@ -5507,6 +5736,8 @@ export declare interface GroundingSupport {
5507
5736
  groundingChunkIndices?: number[];
5508
5737
  /** Segment of the content this support belongs to. */
5509
5738
  segment?: Segment;
5739
+ /** Indices into the `rendered_parts` field of the `GroundingMetadata` message. These indices specify which rendered parts are associated with this support message. */
5740
+ renderedParts?: number[];
5510
5741
  }
5511
5742
 
5512
5743
  /** The method for blocking content. If not specified, the default behavior is to use the probability score. This enum is not supported in Gemini API. */
@@ -5800,11 +6031,7 @@ export declare interface ImageConfig {
5800
6031
  /** Controls the generation of people. Supported values are:
5801
6032
  ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE. */
5802
6033
  personGeneration?: string;
5803
- /** Controls whether prominent people (celebrities)
5804
- generation is allowed. If used with personGeneration, personGeneration
5805
- enum would take precedence. For instance, if ALLOW_NONE is set, all person
5806
- generation would be blocked. If this field is unspecified, the default
5807
- behavior is to allow prominent people. */
6034
+ /** Optional. Controls whether prominent people (celebrities) generation is allowed. If used with personGeneration, personGeneration enum would take precedence. For instance, if ALLOW_NONE is set, all person generation would be blocked. If this field is unspecified, the default behavior is to allow prominent people. This field is not supported in Gemini API. */
5808
6035
  prominentPeople?: ProminentPeople;
5809
6036
  /** MIME type of the generated image. This field is not
5810
6037
  supported in Gemini API. */
@@ -5812,7 +6039,7 @@ export declare interface ImageConfig {
5812
6039
  /** Compression quality of the generated image (for
5813
6040
  ``image/jpeg`` only). This field is not supported in Gemini API. */
5814
6041
  outputCompressionQuality?: number;
5815
- /** Optional. The image output format for generated images. */
6042
+ /** Optional. The image output format for generated images. This field is not supported in Gemini API. */
5816
6043
  imageOutputOptions?: ImageConfigImageOutputOptions;
5817
6044
  }
5818
6045
 
@@ -5844,7 +6071,7 @@ declare interface ImageContent {
5844
6071
  /**
5845
6072
  * The mime type of the image.
5846
6073
  */
5847
- mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
6074
+ mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif' | 'image/gif' | 'image/bmp' | 'image/tiff';
5848
6075
  /**
5849
6076
  * The resolution of the media.
5850
6077
  */
@@ -5926,7 +6153,6 @@ export declare class ImportFileOperation implements Operation<ImportFileResponse
5926
6153
  response?: ImportFileResponse;
5927
6154
  /**
5928
6155
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
5929
- * @internal
5930
6156
  */
5931
6157
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<ImportFileResponse>;
5932
6158
  /** The full HTTP response. */
@@ -5955,12 +6181,12 @@ export declare class ImportFileResponse {
5955
6181
 
5956
6182
  /** Config for `inlined_embedding_responses` parameter. */
5957
6183
  export declare class InlinedEmbedContentResponse {
5958
- /** The response to the request.
5959
- */
6184
+ /** Output only. The response to the request. */
5960
6185
  response?: SingleEmbedContentResponse;
5961
- /** The error encountered while processing the request.
5962
- */
6186
+ /** Output only. The error encountered while processing the request. */
5963
6187
  error?: JobError;
6188
+ /** Output only. The metadata associated with the request. */
6189
+ metadata?: Record<string, unknown>;
5964
6190
  }
5965
6191
 
5966
6192
  /** Config for inlined request. */
@@ -5995,20 +6221,20 @@ export declare class InlinedResponse {
5995
6221
  */
5996
6222
  declare interface Interaction {
5997
6223
  /**
5998
- * Output only. A unique identifier for the interaction completion.
6224
+ * Required. Output only. A unique identifier for the interaction completion.
5999
6225
  */
6000
6226
  id: string;
6001
6227
  /**
6002
- * Output only. The time at which the response was created in ISO 8601 format
6228
+ * Required. Output only. The time at which the response was created in ISO 8601 format
6003
6229
  * (YYYY-MM-DDThh:mm:ssZ).
6004
6230
  */
6005
6231
  created: string;
6006
6232
  /**
6007
- * Output only. The status of the interaction.
6233
+ * Required. Output only. The status of the interaction.
6008
6234
  */
6009
6235
  status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
6010
6236
  /**
6011
- * Output only. The time at which the response was last updated in ISO 8601 format
6237
+ * Required. Output only. The time at which the response was last updated in ISO 8601 format
6012
6238
  * (YYYY-MM-DDThh:mm:ssZ).
6013
6239
  */
6014
6240
  updated: string;
@@ -6023,7 +6249,7 @@ declare interface Interaction {
6023
6249
  /**
6024
6250
  * The input for the interaction.
6025
6251
  */
6026
- 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;
6252
+ input?: Array<Content_2> | string | Array<Turn> | TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | CodeExecutionCallContent | URLContextCallContent | MCPServerToolCallContent | GoogleSearchCallContent | FileSearchCallContent | GoogleMapsCallContent | FunctionResultContent | CodeExecutionResultContent | URLContextResultContent | GoogleSearchResultContent | MCPServerToolResultContent | FileSearchResultContent | GoogleMapsResultContent;
6027
6253
  /**
6028
6254
  * The name of the `Model` used for generating the interaction.
6029
6255
  */
@@ -6053,6 +6279,10 @@ declare interface Interaction {
6053
6279
  * Output only. The role of the interaction.
6054
6280
  */
6055
6281
  role?: string;
6282
+ /**
6283
+ * The service tier for the interaction.
6284
+ */
6285
+ service_tier?: 'flex' | 'standard' | 'priority';
6056
6286
  /**
6057
6287
  * System instruction for the interaction.
6058
6288
  */
@@ -6077,12 +6307,13 @@ declare interface InteractionCancelParams {
6077
6307
  declare interface InteractionCompleteEvent {
6078
6308
  event_type: 'interaction.complete';
6079
6309
  /**
6080
- * The completed interaction with empty outputs to reduce the payload size.
6310
+ * Required. The completed interaction with empty outputs to reduce the payload size.
6081
6311
  * Use the preceding ContentDelta events for the actual output.
6082
6312
  */
6083
6313
  interaction: Interaction;
6084
6314
  /**
6085
- * The event_id token to be used to resume the interaction stream, from this event.
6315
+ * The event_id token to be used to resume the interaction stream, from
6316
+ * this event.
6086
6317
  */
6087
6318
  event_id?: string;
6088
6319
  }
@@ -6142,7 +6373,7 @@ export declare class Interactions extends BaseInteractions {
6142
6373
  }
6143
6374
 
6144
6375
  export declare namespace Interactions {
6145
- 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, };
6376
+ 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, };
6146
6377
  }
6147
6378
 
6148
6379
  declare namespace InteractionsAPI {
@@ -6163,12 +6394,17 @@ declare namespace InteractionsAPI {
6163
6394
  DocumentContent,
6164
6395
  DynamicAgentConfig,
6165
6396
  ErrorEvent_2 as ErrorEvent,
6397
+ FileCitation,
6166
6398
  FileSearchCallContent,
6167
6399
  FileSearchResultContent,
6168
6400
  Function_2 as Function,
6169
6401
  FunctionCallContent,
6170
6402
  FunctionResultContent,
6171
6403
  GenerationConfig_2 as GenerationConfig,
6404
+ GoogleMapsCallArguments,
6405
+ GoogleMapsCallContent,
6406
+ GoogleMapsResult,
6407
+ GoogleMapsResultContent,
6172
6408
  GoogleSearchCallArguments,
6173
6409
  GoogleSearchCallContent,
6174
6410
  GoogleSearchResult,
@@ -6183,6 +6419,7 @@ declare namespace InteractionsAPI {
6183
6419
  MCPServerToolCallContent,
6184
6420
  MCPServerToolResultContent,
6185
6421
  Model_2 as Model,
6422
+ PlaceCitation,
6186
6423
  SpeechConfig_2 as SpeechConfig,
6187
6424
  TextContent,
6188
6425
  ThinkingLevel_2 as ThinkingLevel,
@@ -6191,6 +6428,7 @@ declare namespace InteractionsAPI {
6191
6428
  ToolChoiceConfig,
6192
6429
  ToolChoiceType,
6193
6430
  Turn,
6431
+ URLCitation,
6194
6432
  URLContextCallArguments,
6195
6433
  URLContextCallContent,
6196
6434
  URLContextResult,
@@ -6223,7 +6461,8 @@ declare interface InteractionStartEvent {
6223
6461
  */
6224
6462
  interaction: Interaction;
6225
6463
  /**
6226
- * The event_id token to be used to resume the interaction stream, from this event.
6464
+ * The event_id token to be used to resume the interaction stream, from
6465
+ * this event.
6227
6466
  */
6228
6467
  event_id?: string;
6229
6468
  }
@@ -6233,7 +6472,8 @@ declare interface InteractionStatusUpdate {
6233
6472
  interaction_id: string;
6234
6473
  status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
6235
6474
  /**
6236
- * The event_id token to be used to resume the interaction stream, from this event.
6475
+ * The event_id token to be used to resume the interaction stream, from
6476
+ * this event.
6237
6477
  */
6238
6478
  event_id?: string;
6239
6479
  }
@@ -6475,6 +6715,7 @@ export declare interface ListFileSearchStoresParameters {
6475
6715
  export declare class ListFileSearchStoresResponse {
6476
6716
  /** Used to retain the full HTTP response. */
6477
6717
  sdkHttpResponse?: HttpResponse;
6718
+ /** A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no more pages. */
6478
6719
  nextPageToken?: string;
6479
6720
  /** The returned file search stores. */
6480
6721
  fileSearchStores?: FileSearchStore[];
@@ -7343,6 +7584,8 @@ export declare interface LogprobsResult {
7343
7584
  chosenCandidates?: LogprobsResultCandidate[];
7344
7585
  /** A list of the top candidate tokens at each decoding step. The length of this list is equal to the total number of decoding steps. */
7345
7586
  topCandidates?: LogprobsResultTopCandidates[];
7587
+ /** Sum of log probabilities for all tokens. This field is not supported in Vertex AI. */
7588
+ logProbabilitySum?: number;
7346
7589
  }
7347
7590
 
7348
7591
  /** A single token and its associated log probability. */
@@ -7418,24 +7661,28 @@ export declare interface McpServer {
7418
7661
  */
7419
7662
  declare interface MCPServerToolCallContent {
7420
7663
  /**
7421
- * A unique ID for this specific tool call.
7664
+ * Required. A unique ID for this specific tool call.
7422
7665
  */
7423
7666
  id: string;
7424
7667
  /**
7425
- * The JSON object of arguments for the function.
7668
+ * Required. The JSON object of arguments for the function.
7426
7669
  */
7427
7670
  arguments: {
7428
7671
  [key: string]: unknown;
7429
7672
  };
7430
7673
  /**
7431
- * The name of the tool which was called.
7674
+ * Required. The name of the tool which was called.
7432
7675
  */
7433
7676
  name: string;
7434
7677
  /**
7435
- * The name of the used MCP server.
7678
+ * Required. The name of the used MCP server.
7436
7679
  */
7437
7680
  server_name: string;
7438
7681
  type: 'mcp_server_tool_call';
7682
+ /**
7683
+ * A signature hash for backend validation.
7684
+ */
7685
+ signature?: string;
7439
7686
  }
7440
7687
 
7441
7688
  /**
@@ -7443,7 +7690,7 @@ declare interface MCPServerToolCallContent {
7443
7690
  */
7444
7691
  declare interface MCPServerToolResultContent {
7445
7692
  /**
7446
- * ID to match the ID from the MCP server tool call block.
7693
+ * Required. ID to match the ID from the function call block.
7447
7694
  */
7448
7695
  call_id: string;
7449
7696
  /**
@@ -7619,7 +7866,7 @@ export declare interface Model {
7619
7866
  /**
7620
7867
  * The model that will complete your prompt.\n\nSee [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
7621
7868
  */
7622
- declare type Model_2 = 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | (string & {});
7869
+ declare type Model_2 = 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
7623
7870
 
7624
7871
  /** Configuration for Model Armor. Model Armor is a Google Cloud service that provides safety and security filtering for prompts and responses. It helps protect your AI applications from risks such as harmful content, sensitive data leakage, and prompt injection attacks. This data type is not supported in Gemini API. */
7625
7872
  export declare interface ModelArmorConfig {
@@ -8025,6 +8272,52 @@ export declare interface ModelSelectionConfig {
8025
8272
  featureSelectionPreference?: FeatureSelectionPreference;
8026
8273
  }
8027
8274
 
8275
+ /** The stage of the underlying model. This enum is not supported in Vertex AI. */
8276
+ export declare enum ModelStage {
8277
+ /**
8278
+ * Unspecified model stage.
8279
+ */
8280
+ MODEL_STAGE_UNSPECIFIED = "MODEL_STAGE_UNSPECIFIED",
8281
+ /**
8282
+ * The underlying model is subject to lots of tunings.
8283
+ */
8284
+ UNSTABLE_EXPERIMENTAL = "UNSTABLE_EXPERIMENTAL",
8285
+ /**
8286
+ * Models in this stage are for experimental purposes only.
8287
+ */
8288
+ EXPERIMENTAL = "EXPERIMENTAL",
8289
+ /**
8290
+ * Models in this stage are more mature than experimental models.
8291
+ */
8292
+ PREVIEW = "PREVIEW",
8293
+ /**
8294
+ * Models in this stage are considered stable and ready for production use.
8295
+ */
8296
+ STABLE = "STABLE",
8297
+ /**
8298
+ * If the model is on this stage, it means that this model is on the path to deprecation in near future. Only existing customers can use this model.
8299
+ */
8300
+ LEGACY = "LEGACY",
8301
+ /**
8302
+ * Models in this stage are deprecated. These models cannot be used.
8303
+ */
8304
+ DEPRECATED = "DEPRECATED",
8305
+ /**
8306
+ * Models in this stage are retired. These models cannot be used.
8307
+ */
8308
+ RETIRED = "RETIRED"
8309
+ }
8310
+
8311
+ /** The status of the underlying model. This is used to indicate the stage of the underlying model and the retirement time if applicable. This data type is not supported in Vertex AI. */
8312
+ export declare interface ModelStatus {
8313
+ /** A message explaining the model status. */
8314
+ message?: string;
8315
+ /** The stage of the underlying model. */
8316
+ modelStage?: ModelStage;
8317
+ /** The time at which the model will be retired. */
8318
+ retirementTime?: string;
8319
+ }
8320
+
8028
8321
  /** Configuration for a multi-speaker text-to-speech request. */
8029
8322
  export declare interface MultiSpeakerVoiceConfig {
8030
8323
  /** Required. A list of configurations for the voices of the speakers. Exactly two speaker voice configurations must be provided. */
@@ -8110,7 +8403,6 @@ export declare interface Operation<T> {
8110
8403
  response?: T;
8111
8404
  /**
8112
8405
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
8113
- * @internal
8114
8406
  */
8115
8407
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<T>;
8116
8408
  }
@@ -8385,6 +8677,12 @@ export declare interface Part {
8385
8677
  thoughtSignature?: string;
8386
8678
  /** Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data. */
8387
8679
  videoMetadata?: VideoMetadata;
8680
+ /** 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. */
8681
+ toolCall?: ToolCall;
8682
+ /** The output from a server-side ToolCall execution. This field is populated by the client with the results of executing the corresponding ToolCall. */
8683
+ toolResponse?: ToolResponse;
8684
+ /** Custom metadata associated with the Part. Agents using genai.Part as content representation may need to keep track of the additional information. For example it can be name of a file/source from which the Part originates or a way to multiplex multiple Part streams. This field is not supported in Vertex AI. */
8685
+ partMetadata?: Record<string, unknown>;
8388
8686
  }
8389
8687
 
8390
8688
  /** Partial argument value of the function call. This data type is not supported in Gemini API. */
@@ -8502,6 +8800,61 @@ export declare enum PhishBlockThreshold {
8502
8800
  BLOCK_ONLY_EXTREMELY_HIGH = "BLOCK_ONLY_EXTREMELY_HIGH"
8503
8801
  }
8504
8802
 
8803
+ /**
8804
+ * A place citation annotation.
8805
+ */
8806
+ declare interface PlaceCitation {
8807
+ type: 'place_citation';
8808
+ /**
8809
+ * End of the attributed segment, exclusive.
8810
+ */
8811
+ end_index?: number;
8812
+ /**
8813
+ * Title of the place.
8814
+ */
8815
+ name?: string;
8816
+ /**
8817
+ * The ID of the place, in `places/{place_id}` format.
8818
+ */
8819
+ place_id?: string;
8820
+ /**
8821
+ * Snippets of reviews that are used to generate answers about the
8822
+ * features of a given place in Google Maps.
8823
+ */
8824
+ review_snippets?: Array<PlaceCitation.ReviewSnippet>;
8825
+ /**
8826
+ * Start of segment of the response that is attributed to this source.
8827
+ *
8828
+ * Index indicates the start of the segment, measured in bytes.
8829
+ */
8830
+ start_index?: number;
8831
+ /**
8832
+ * URI reference of the place.
8833
+ */
8834
+ url?: string;
8835
+ }
8836
+
8837
+ declare namespace PlaceCitation {
8838
+ /**
8839
+ * Encapsulates a snippet of a user review that answers a question about
8840
+ * the features of a specific place in Google Maps.
8841
+ */
8842
+ interface ReviewSnippet {
8843
+ /**
8844
+ * The ID of the review snippet.
8845
+ */
8846
+ review_id?: string;
8847
+ /**
8848
+ * Title of the review.
8849
+ */
8850
+ title?: string;
8851
+ /**
8852
+ * A link that corresponds to the user review on Google Maps.
8853
+ */
8854
+ url?: string;
8855
+ }
8856
+ }
8857
+
8505
8858
  /** Spec for pointwise metric result. This data type is not supported in Gemini API. */
8506
8859
  export declare interface PointwiseMetricResult {
8507
8860
  /** Output only. Spec for custom output. */
@@ -8590,7 +8943,7 @@ export declare interface ProductImage {
8590
8943
  productImage?: Image_2;
8591
8944
  }
8592
8945
 
8593
- /** Enum for controlling whether the model can generate images of prominent people (celebrities). */
8946
+ /** Controls whether prominent people (celebrities) generation is allowed. If used with personGeneration, personGeneration enum would take precedence. For instance, if ALLOW_NONE is set, all person generation would be blocked. If this field is unspecified, the default behavior is to allow prominent people. This enum is not supported in Gemini API. */
8594
8947
  export declare enum ProminentPeople {
8595
8948
  /**
8596
8949
  * Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.
@@ -8867,12 +9220,14 @@ export declare class ReplayResponse {
8867
9220
  sdkResponseSegments?: Record<string, unknown>[];
8868
9221
  }
8869
9222
 
8870
- /** ReplicatedVoiceConfig is used to configure replicated voice. */
9223
+ /** The configuration for the replicated voice to use. */
8871
9224
  export declare interface ReplicatedVoiceConfig {
8872
- /** The mime type of the replicated voice.
9225
+ /** The mimetype of the voice sample. The only currently supported
9226
+ value is `audio/wav`. This represents 16-bit signed little-endian wav
9227
+ data, with a 24kHz sampling rate.
8873
9228
  */
8874
9229
  mimeType?: string;
8875
- /** The sample audio of the replicated voice.
9230
+ /** The sample of the custom voice.
8876
9231
 
8877
9232
  * @remarks Encoded as base64 string. */
8878
9233
  voiceSampleAudio?: string;
@@ -9116,7 +9471,7 @@ export declare interface Schema {
9116
9471
  anyOf?: Schema[];
9117
9472
  /** Optional. Default value to use if the field is not specified. */
9118
9473
  default?: unknown;
9119
- /** Optional. Description of the schema. */
9474
+ /** Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. */
9120
9475
  description?: string;
9121
9476
  /** Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` */
9122
9477
  enum?: string[];
@@ -9176,12 +9531,11 @@ export declare interface SearchEntryPoint {
9176
9531
  sdkBlob?: string;
9177
9532
  }
9178
9533
 
9179
- /** Tool to support computer use. */
9534
+ /** Different types of search that can be enabled on the GoogleSearch tool. */
9180
9535
  export declare interface SearchTypes {
9181
- /** Setting this field enables web search. Only text results are
9182
- returned. */
9536
+ /** Optional. Setting this field enables web search. Only text results are returned. */
9183
9537
  webSearch?: WebSearch;
9184
- /** Setting this field enables image search. Image bytes are returned. */
9538
+ /** Optional. Setting this field enables image search. Image bytes are returned. */
9185
9539
  imageSearch?: ImageSearch;
9186
9540
  }
9187
9541
 
@@ -9294,6 +9648,26 @@ export declare interface SendMessageParameters {
9294
9648
  config?: GenerateContentConfig;
9295
9649
  }
9296
9650
 
9651
+ /** Pricing and performance service tier. */
9652
+ export declare enum ServiceTier {
9653
+ /**
9654
+ * Default service tier, which is standard.
9655
+ */
9656
+ SERVICE_TIER_UNSPECIFIED = "SERVICE_TIER_UNSPECIFIED",
9657
+ /**
9658
+ * Flex service tier.
9659
+ */
9660
+ SERVICE_TIER_FLEX = "SERVICE_TIER_FLEX",
9661
+ /**
9662
+ * Standard service tier.
9663
+ */
9664
+ SERVICE_TIER_STANDARD = "SERVICE_TIER_STANDARD",
9665
+ /**
9666
+ * Priority service tier.
9667
+ */
9668
+ SERVICE_TIER_PRIORITY = "SERVICE_TIER_PRIORITY"
9669
+ }
9670
+
9297
9671
  /**
9298
9672
  Represents a connection to the API.
9299
9673
 
@@ -9483,8 +9857,9 @@ export declare interface SpeakerVoiceConfig {
9483
9857
  voiceConfig?: VoiceConfig;
9484
9858
  }
9485
9859
 
9860
+ /** Config for speech generation and transcription. */
9486
9861
  export declare interface SpeechConfig {
9487
- /** Configuration for the voice of the response. */
9862
+ /** The configuration in case of single-voice output. */
9488
9863
  voiceConfig?: VoiceConfig;
9489
9864
  /** Optional. The language code (ISO 639-1) for the speech synthesis. */
9490
9865
  languageCode?: string;
@@ -9753,7 +10128,7 @@ export declare interface TestTableItem {
9753
10128
  */
9754
10129
  declare interface TextContent {
9755
10130
  /**
9756
- * The text content.
10131
+ * Required. The text content.
9757
10132
  */
9758
10133
  text: string;
9759
10134
  type: 'text';
@@ -9781,6 +10156,10 @@ export declare enum ThinkingLevel {
9781
10156
  * Unspecified thinking level.
9782
10157
  */
9783
10158
  THINKING_LEVEL_UNSPECIFIED = "THINKING_LEVEL_UNSPECIFIED",
10159
+ /**
10160
+ * MINIMAL thinking level.
10161
+ */
10162
+ MINIMAL = "MINIMAL",
9784
10163
  /**
9785
10164
  * Low thinking level.
9786
10165
  */
@@ -9792,11 +10171,7 @@ export declare enum ThinkingLevel {
9792
10171
  /**
9793
10172
  * High thinking level.
9794
10173
  */
9795
- HIGH = "HIGH",
9796
- /**
9797
- * MINIMAL thinking level.
9798
- */
9799
- MINIMAL = "MINIMAL"
10174
+ HIGH = "HIGH"
9800
10175
  }
9801
10176
 
9802
10177
  declare type ThinkingLevel_2 = 'minimal' | 'low' | 'medium' | 'high';
@@ -9924,9 +10299,9 @@ export declare interface Tool {
9924
10299
  computer. If enabled, it automatically populates computer-use specific
9925
10300
  Function Declarations. */
9926
10301
  computerUse?: ComputerUse;
9927
- /** Optional. Tool to retrieve knowledge from the File Search Stores. */
10302
+ /** Optional. FileSearch tool type. Tool to retrieve knowledge from Semantic Retrieval corpora. This field is not supported in Vertex AI. */
9928
10303
  fileSearch?: FileSearch;
9929
- /** Enables the model to execute Google Search as part of generation. */
10304
+ /** Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
9930
10305
  googleSearch?: GoogleSearch;
9931
10306
  /** Optional. Tool that allows grounding the model's response with
9932
10307
  geospatial context related to the user's query. */
@@ -9950,7 +10325,7 @@ export declare interface Tool {
9950
10325
  /**
9951
10326
  * A tool that can be used by the model.
9952
10327
  */
9953
- declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch;
10328
+ declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch | Tool_2.GoogleMaps;
9954
10329
 
9955
10330
  declare namespace Tool_2 {
9956
10331
  /**
@@ -10032,6 +10407,40 @@ declare namespace Tool_2 {
10032
10407
  */
10033
10408
  top_k?: number;
10034
10409
  }
10410
+ /**
10411
+ * A tool that can be used by the model to call Google Maps.
10412
+ */
10413
+ interface GoogleMaps {
10414
+ type: 'google_maps';
10415
+ /**
10416
+ * Whether to return a widget context token in the tool call result of the
10417
+ * response.
10418
+ */
10419
+ enable_widget?: boolean;
10420
+ /**
10421
+ * The latitude of the user's location.
10422
+ */
10423
+ latitude?: number;
10424
+ /**
10425
+ * The longitude of the user's location.
10426
+ */
10427
+ longitude?: number;
10428
+ }
10429
+ }
10430
+
10431
+ /** A predicted server-side `ToolCall` returned from the model.
10432
+
10433
+ This message contains information about a tool that the model wants to invoke.
10434
+ The client is NOT expected to execute this `ToolCall`. Instead, the
10435
+ client should pass this `ToolCall` back to the API in a subsequent turn
10436
+ within a `Content` message, along with the corresponding `ToolResponse`. */
10437
+ export declare interface ToolCall {
10438
+ /** Unique identifier of the tool call. The server returns the tool response with the matching `id`. */
10439
+ id?: string;
10440
+ /** The type of tool that was called. */
10441
+ toolType?: ToolType;
10442
+ /** The tool call arguments. Example: {"arg1": "value1", "arg2": "value2"}. */
10443
+ args?: Record<string, unknown>;
10035
10444
  }
10036
10445
 
10037
10446
  /**
@@ -10058,6 +10467,8 @@ export declare interface ToolConfig {
10058
10467
  retrievalConfig?: RetrievalConfig;
10059
10468
  /** Optional. Function calling config. */
10060
10469
  functionCallingConfig?: FunctionCallingConfig;
10470
+ /** 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. */
10471
+ includeServerSideToolInvocations?: boolean;
10061
10472
  }
10062
10473
 
10063
10474
  export declare type ToolListUnion = ToolUnion[];
@@ -10070,6 +10481,49 @@ export declare interface ToolParallelAiSearch {
10070
10481
  customConfigs?: Record<string, unknown>;
10071
10482
  }
10072
10483
 
10484
+ /** The output from a server-side `ToolCall` execution.
10485
+
10486
+ This message contains the results of a tool invocation that was initiated by a
10487
+ `ToolCall` from the model. The client should pass this `ToolResponse` back to
10488
+ the API in a subsequent turn within a `Content` message, along with the
10489
+ corresponding `ToolCall`. */
10490
+ export declare class ToolResponse {
10491
+ /** The identifier of the tool call this response is for. */
10492
+ id?: string;
10493
+ /** The type of tool that was called, matching the tool_type in the corresponding ToolCall. */
10494
+ toolType?: ToolType;
10495
+ /** The tool response. */
10496
+ response?: Record<string, unknown>;
10497
+ }
10498
+
10499
+ /** The type of tool in the function call. */
10500
+ export declare enum ToolType {
10501
+ /**
10502
+ * Unspecified tool type.
10503
+ */
10504
+ TOOL_TYPE_UNSPECIFIED = "TOOL_TYPE_UNSPECIFIED",
10505
+ /**
10506
+ * Google search tool, maps to Tool.google_search.search_types.web_search.
10507
+ */
10508
+ GOOGLE_SEARCH_WEB = "GOOGLE_SEARCH_WEB",
10509
+ /**
10510
+ * Image search tool, maps to Tool.google_search.search_types.image_search.
10511
+ */
10512
+ GOOGLE_SEARCH_IMAGE = "GOOGLE_SEARCH_IMAGE",
10513
+ /**
10514
+ * URL context tool, maps to Tool.url_context.
10515
+ */
10516
+ URL_CONTEXT = "URL_CONTEXT",
10517
+ /**
10518
+ * Google maps tool, maps to Tool.google_maps.
10519
+ */
10520
+ GOOGLE_MAPS = "GOOGLE_MAPS",
10521
+ /**
10522
+ * File search tool, maps to Tool.file_search.
10523
+ */
10524
+ FILE_SEARCH = "FILE_SEARCH"
10525
+ }
10526
+
10073
10527
  export declare type ToolUnion = Tool | CallableTool;
10074
10528
 
10075
10529
  /** Output only. The traffic type for this request. This enum is not supported in Gemini API. */
@@ -10098,11 +10552,9 @@ export declare enum TrafficType {
10098
10552
 
10099
10553
  /** Audio transcription in Server Conent. */
10100
10554
  export declare interface Transcription {
10101
- /** Transcription text.
10102
- */
10555
+ /** Optional. Transcription text. */
10103
10556
  text?: string;
10104
- /** The bool indicates the end of the transcription.
10105
- */
10557
+ /** Optional. The bool indicates the end of the transcription. */
10106
10558
  finished?: boolean;
10107
10559
  }
10108
10560
 
@@ -10240,6 +10692,18 @@ export declare interface TuningJob {
10240
10692
  tuningJobState?: TuningJobState;
10241
10693
  /** Tuning Spec for Veo Tuning. */
10242
10694
  veoTuningSpec?: VeoTuningSpec;
10695
+ /** Optional. Spec for creating a distillation dataset. */
10696
+ distillationSamplingSpec?: DistillationSamplingSpec;
10697
+ /** Output only. Tuning Job metadata. */
10698
+ tuningJobMetadata?: TuningJobMetadata;
10699
+ }
10700
+
10701
+ /** Tuning job metadata. This data type is not supported in Gemini API. */
10702
+ export declare interface TuningJobMetadata {
10703
+ /** Output only. The number of epochs that have been completed. */
10704
+ completedEpochCount?: string;
10705
+ /** Output only. The number of steps that have been completed. Set for Multi-Step RL. */
10706
+ completedStepCount?: string;
10243
10707
  }
10244
10708
 
10245
10709
  /** Output only. The detail state of the tuning job (while the overall `JobState` is running). This enum is not supported in Gemini API. */
@@ -10400,10 +10864,7 @@ export declare interface TuningValidationDataset {
10400
10864
  }
10401
10865
 
10402
10866
  declare interface Turn {
10403
- /**
10404
- * The content of the turn.
10405
- */
10406
- content?: string | Array<Content_2>;
10867
+ content?: Array<Content_2> | string;
10407
10868
  /**
10408
10869
  * The originator of this turn. Must be user for input or model for
10409
10870
  * model output.
@@ -10444,7 +10905,11 @@ export declare enum TurnCoverage {
10444
10905
  /**
10445
10906
  * The users turn includes all realtime input since the last turn, including inactivity (e.g. silence on the audio stream).
10446
10907
  */
10447
- TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT"
10908
+ TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT",
10909
+ /**
10910
+ * Includes audio activity and all video since the last turn. With automatic activity detection, audio activity means speech and excludes silence.
10911
+ */
10912
+ TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO = "TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO"
10448
10913
  }
10449
10914
 
10450
10915
  /** Data type of the schema field. */
@@ -10496,19 +10961,21 @@ declare namespace types {
10496
10961
  createPartFromExecutableCode,
10497
10962
  createUserContent,
10498
10963
  createModelContent,
10499
- Outcome,
10500
10964
  Language,
10965
+ Outcome,
10501
10966
  FunctionResponseScheduling,
10502
10967
  Type,
10503
- PhishBlockThreshold,
10968
+ Environment,
10504
10969
  AuthType,
10505
10970
  HttpElementLocation,
10506
10971
  ApiSpec,
10972
+ PhishBlockThreshold,
10507
10973
  Behavior,
10508
10974
  DynamicRetrievalConfigMode,
10509
10975
  FunctionCallingConfigMode,
10510
10976
  ThinkingLevel,
10511
10977
  PersonGeneration,
10978
+ ProminentPeople,
10512
10979
  HarmCategory,
10513
10980
  HarmBlockMethod,
10514
10981
  HarmBlockThreshold,
@@ -10519,6 +10986,7 @@ declare namespace types {
10519
10986
  BlockedReason,
10520
10987
  TrafficType,
10521
10988
  Modality,
10989
+ ModelStage,
10522
10990
  MediaResolution,
10523
10991
  TuningMode,
10524
10992
  AdapterSize,
@@ -10527,11 +10995,12 @@ declare namespace types {
10527
10995
  AggregationMetric,
10528
10996
  PairwiseChoice,
10529
10997
  TuningTask,
10998
+ DocumentState,
10530
10999
  PartMediaResolutionLevel,
11000
+ ToolType,
10531
11001
  ResourceScope,
11002
+ ServiceTier,
10532
11003
  FeatureSelectionPreference,
10533
- Environment,
10534
- ProminentPeople,
10535
11004
  EmbeddingApiType,
10536
11005
  SafetyFilterLevel,
10537
11006
  ImagePromptLanguage,
@@ -10544,7 +11013,6 @@ declare namespace types {
10544
11013
  VideoGenerationMaskMode,
10545
11014
  VideoCompressionQuality,
10546
11015
  TuningMethod,
10547
- DocumentState,
10548
11016
  FileState,
10549
11017
  FileSource,
10550
11018
  TurnCompleteReason,
@@ -10558,9 +11026,11 @@ declare namespace types {
10558
11026
  Scale,
10559
11027
  MusicGenerationMode,
10560
11028
  LiveMusicPlaybackControl,
10561
- PartMediaResolution,
10562
- CodeExecutionResult,
10563
11029
  ExecutableCode,
11030
+ CodeExecutionResult,
11031
+ PartMediaResolution,
11032
+ ToolCall,
11033
+ ToolResponse,
10564
11034
  FileData,
10565
11035
  PartialArg,
10566
11036
  FunctionCall,
@@ -10577,12 +11047,6 @@ declare namespace types {
10577
11047
  Schema,
10578
11048
  ModelSelectionConfig,
10579
11049
  ComputerUse,
10580
- FileSearch,
10581
- WebSearch,
10582
- ImageSearch,
10583
- SearchTypes,
10584
- Interval,
10585
- GoogleSearch,
10586
11050
  ApiKeyConfig,
10587
11051
  AuthConfigGoogleServiceAccountConfig,
10588
11052
  AuthConfigHttpBasicAuthConfig,
@@ -10606,6 +11070,12 @@ declare namespace types {
10606
11070
  RagRetrievalConfig,
10607
11071
  VertexRagStore,
10608
11072
  Retrieval,
11073
+ FileSearch,
11074
+ WebSearch,
11075
+ ImageSearch,
11076
+ SearchTypes,
11077
+ Interval,
11078
+ GoogleSearch,
10609
11079
  ToolCodeExecution,
10610
11080
  EnterpriseWebSearch,
10611
11081
  FunctionDeclaration,
@@ -10642,13 +11112,16 @@ declare namespace types {
10642
11112
  GoogleTypeDate,
10643
11113
  Citation,
10644
11114
  CitationMetadata,
10645
- GroundingChunkImage,
10646
11115
  GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
10647
11116
  GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
10648
11117
  GroundingChunkMapsPlaceAnswerSources,
11118
+ GroundingChunkMapsRoute,
10649
11119
  GroundingChunkMaps,
11120
+ GroundingChunkImage,
10650
11121
  RagChunkPageSpan,
10651
11122
  RagChunk,
11123
+ GroundingChunkStringList,
11124
+ GroundingChunkCustomMetadata,
10652
11125
  GroundingChunkRetrievedContext,
10653
11126
  GroundingChunkWeb,
10654
11127
  GroundingChunk,
@@ -10668,6 +11141,7 @@ declare namespace types {
10668
11141
  GenerateContentResponsePromptFeedback,
10669
11142
  ModalityTokenCount,
10670
11143
  GenerateContentResponseUsageMetadata,
11144
+ ModelStatus,
10671
11145
  GenerateContentResponse,
10672
11146
  ReferenceImage,
10673
11147
  EditImageParameters,
@@ -10778,6 +11252,8 @@ declare namespace types {
10778
11252
  FullFineTuningSpec,
10779
11253
  VeoHyperParameters,
10780
11254
  VeoTuningSpec,
11255
+ DistillationSamplingSpec,
11256
+ TuningJobMetadata,
10781
11257
  TuningJob,
10782
11258
  ListTuningJobsConfig,
10783
11259
  ListTuningJobsParameters,
@@ -11065,7 +11541,7 @@ declare interface Uploader {
11065
11541
  * @param apiClient The ApiClient to use for uploading.
11066
11542
  * @return A Promise that resolves to types.File.
11067
11543
  */
11068
- upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<File_2>;
11544
+ upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<File_2>;
11069
11545
  /**
11070
11546
  * Uploads a file to file search store via the given upload url.
11071
11547
  *
@@ -11074,9 +11550,10 @@ declare interface Uploader {
11074
11550
  * uploaded to. The uploadUrl must be a url that was returned by the
11075
11551
  * https://generativelanguage.googleapis.com/upload/v1beta/{file_search_store_name}:uploadToFileSearchStore endpoint
11076
11552
  * @param apiClient The ApiClient to use for uploading.
11553
+ * @param httpOptions Optional HTTP options to merge.
11077
11554
  * @return A Promise that resolves to types.UploadToFileSearchStoreOperation.
11078
11555
  */
11079
- uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<UploadToFileSearchStoreOperation>;
11556
+ uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<UploadToFileSearchStoreOperation>;
11080
11557
  /**
11081
11558
  * Returns the file's mimeType and the size of a given file. If the file is a
11082
11559
  * string path, the file type is determined by the file extension. If the
@@ -11150,7 +11627,6 @@ export declare class UploadToFileSearchStoreOperation implements Operation<Uploa
11150
11627
  response?: UploadToFileSearchStoreResponse;
11151
11628
  /**
11152
11629
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
11153
- * @internal
11154
11630
  */
11155
11631
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<UploadToFileSearchStoreResponse>;
11156
11632
  /** The full HTTP response. */
@@ -11252,6 +11728,31 @@ export declare class UpscaleImageResponse {
11252
11728
  generatedImages?: GeneratedImage[];
11253
11729
  }
11254
11730
 
11731
+ /**
11732
+ * A URL citation annotation.
11733
+ */
11734
+ declare interface URLCitation {
11735
+ type: 'url_citation';
11736
+ /**
11737
+ * End of the attributed segment, exclusive.
11738
+ */
11739
+ end_index?: number;
11740
+ /**
11741
+ * Start of segment of the response that is attributed to this source.
11742
+ *
11743
+ * Index indicates the start of the segment, measured in bytes.
11744
+ */
11745
+ start_index?: number;
11746
+ /**
11747
+ * The title of the URL.
11748
+ */
11749
+ title?: string;
11750
+ /**
11751
+ * The URL.
11752
+ */
11753
+ url?: string;
11754
+ }
11755
+
11255
11756
  /** Tool to support URL context. */
11256
11757
  export declare interface UrlContext {
11257
11758
  }
@@ -11271,14 +11772,18 @@ declare interface URLContextCallArguments {
11271
11772
  */
11272
11773
  declare interface URLContextCallContent {
11273
11774
  /**
11274
- * A unique ID for this specific tool call.
11775
+ * Required. A unique ID for this specific tool call.
11275
11776
  */
11276
11777
  id: string;
11277
11778
  /**
11278
- * The arguments to pass to the URL context.
11779
+ * Required. The arguments to pass to the URL context.
11279
11780
  */
11280
11781
  arguments: URLContextCallArguments;
11281
11782
  type: 'url_context_call';
11783
+ /**
11784
+ * A signature hash for backend validation.
11785
+ */
11786
+ signature?: string;
11282
11787
  }
11283
11788
 
11284
11789
  /** Metadata returned when the model uses the `url_context` tool to get information from a user-provided URL. */
@@ -11306,11 +11811,11 @@ declare interface URLContextResult {
11306
11811
  */
11307
11812
  declare interface URLContextResultContent {
11308
11813
  /**
11309
- * ID to match the ID from the url context call block.
11814
+ * Required. ID to match the ID from the function call block.
11310
11815
  */
11311
11816
  call_id: string;
11312
11817
  /**
11313
- * The results of the URL context.
11818
+ * Required. The results of the URL context.
11314
11819
  */
11315
11820
  result: Array<URLContextResult>;
11316
11821
  type: 'url_context_result';
@@ -11715,16 +12220,17 @@ export declare enum VoiceActivityType {
11715
12220
  ACTIVITY_END = "ACTIVITY_END"
11716
12221
  }
11717
12222
 
12223
+ /** The configuration for the voice to use. */
11718
12224
  export declare interface VoiceConfig {
11719
- /** If true, the model will use a replicated voice for the response. */
12225
+ /** The configuration for a replicated voice, which is a clone of a
12226
+ user's voice that can be used for speech synthesis. If this is unset, a
12227
+ default voice is used. */
11720
12228
  replicatedVoiceConfig?: ReplicatedVoiceConfig;
11721
12229
  /** The configuration for a prebuilt voice. */
11722
12230
  prebuiltVoiceConfig?: PrebuiltVoiceConfig;
11723
12231
  }
11724
12232
 
11725
- /** Standard web search for grounding and related configurations.
11726
-
11727
- Only text results are returned. */
12233
+ /** Standard web search for grounding and related configurations. Only text results are returned. */
11728
12234
  export declare interface WebSearch {
11729
12235
  }
11730
12236