@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/genai.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
  /**
@@ -5218,6 +5322,110 @@ export declare interface GoogleMaps {
5218
5322
  enableWidget?: boolean;
5219
5323
  }
5220
5324
 
5325
+ /**
5326
+ * The arguments to pass to the Google Maps tool.
5327
+ */
5328
+ declare interface GoogleMapsCallArguments {
5329
+ /**
5330
+ * The queries to be executed.
5331
+ */
5332
+ queries?: Array<string>;
5333
+ }
5334
+
5335
+ /**
5336
+ * Google Maps content.
5337
+ */
5338
+ declare interface GoogleMapsCallContent {
5339
+ /**
5340
+ * Required. A unique ID for this specific tool call.
5341
+ */
5342
+ id: string;
5343
+ type: 'google_maps_call';
5344
+ /**
5345
+ * The arguments to pass to the Google Maps tool.
5346
+ */
5347
+ arguments?: GoogleMapsCallArguments;
5348
+ /**
5349
+ * A signature hash for backend validation.
5350
+ */
5351
+ signature?: string;
5352
+ }
5353
+
5354
+ /**
5355
+ * The result of the Google Maps.
5356
+ */
5357
+ declare interface GoogleMapsResult {
5358
+ /**
5359
+ * The places that were found.
5360
+ */
5361
+ places?: Array<GoogleMapsResult.Place>;
5362
+ /**
5363
+ * Resource name of the Google Maps widget context token.
5364
+ */
5365
+ widget_context_token?: string;
5366
+ }
5367
+
5368
+ declare namespace GoogleMapsResult {
5369
+ interface Place {
5370
+ /**
5371
+ * Title of the place.
5372
+ */
5373
+ name?: string;
5374
+ /**
5375
+ * The ID of the place, in `places/{place_id}` format.
5376
+ */
5377
+ place_id?: string;
5378
+ /**
5379
+ * Snippets of reviews that are used to generate answers about the
5380
+ * features of a given place in Google Maps.
5381
+ */
5382
+ review_snippets?: Array<Place.ReviewSnippet>;
5383
+ /**
5384
+ * URI reference of the place.
5385
+ */
5386
+ url?: string;
5387
+ }
5388
+ namespace Place {
5389
+ /**
5390
+ * Encapsulates a snippet of a user review that answers a question about
5391
+ * the features of a specific place in Google Maps.
5392
+ */
5393
+ interface ReviewSnippet {
5394
+ /**
5395
+ * The ID of the review snippet.
5396
+ */
5397
+ review_id?: string;
5398
+ /**
5399
+ * Title of the review.
5400
+ */
5401
+ title?: string;
5402
+ /**
5403
+ * A link that corresponds to the user review on Google Maps.
5404
+ */
5405
+ url?: string;
5406
+ }
5407
+ }
5408
+ }
5409
+
5410
+ /**
5411
+ * Google Maps result content.
5412
+ */
5413
+ declare interface GoogleMapsResultContent {
5414
+ /**
5415
+ * Required. ID to match the ID from the function call block.
5416
+ */
5417
+ call_id: string;
5418
+ /**
5419
+ * Required. The results of the Google Maps.
5420
+ */
5421
+ result: Array<GoogleMapsResult>;
5422
+ type: 'google_maps_result';
5423
+ /**
5424
+ * A signature hash for backend validation.
5425
+ */
5426
+ signature?: string;
5427
+ }
5428
+
5221
5429
  /** 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. */
5222
5430
  export declare interface GoogleRpcStatus {
5223
5431
  /** The status code, which should be an enum value of google.rpc.Code. */
@@ -5228,9 +5436,9 @@ export declare interface GoogleRpcStatus {
5228
5436
  message?: string;
5229
5437
  }
5230
5438
 
5231
- /** Tool to support web search. */
5439
+ /** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
5232
5440
  export declare interface GoogleSearch {
5233
- /** Different types of search that can be enabled on the GoogleSearch tool. */
5441
+ /** Optional. The set of search types to enable. If not set, web search is enabled by default. */
5234
5442
  searchTypes?: SearchTypes;
5235
5443
  /** Optional. Sites with confidence level chosen & above this value will be blocked from the search results. This field is not supported in Gemini API. */
5236
5444
  blockingConfidence?: PhishBlockThreshold;
@@ -5255,11 +5463,11 @@ declare interface GoogleSearchCallArguments {
5255
5463
  */
5256
5464
  declare interface GoogleSearchCallContent {
5257
5465
  /**
5258
- * A unique ID for this specific tool call.
5466
+ * Required. A unique ID for this specific tool call.
5259
5467
  */
5260
5468
  id: string;
5261
5469
  /**
5262
- * The arguments to pass to Google Search.
5470
+ * Required. The arguments to pass to Google Search.
5263
5471
  */
5264
5472
  arguments: GoogleSearchCallArguments;
5265
5473
  type: 'google_search_call';
@@ -5267,6 +5475,10 @@ declare interface GoogleSearchCallContent {
5267
5475
  * The type of search grounding enabled.
5268
5476
  */
5269
5477
  search_type?: 'web_search' | 'image_search';
5478
+ /**
5479
+ * A signature hash for backend validation.
5480
+ */
5481
+ signature?: string;
5270
5482
  }
5271
5483
 
5272
5484
  /**
@@ -5276,15 +5488,7 @@ declare interface GoogleSearchResult {
5276
5488
  /**
5277
5489
  * Web content snippet that can be embedded in a web page or an app webview.
5278
5490
  */
5279
- rendered_content?: string;
5280
- /**
5281
- * Title of the search result.
5282
- */
5283
- title?: string;
5284
- /**
5285
- * URI reference of the search result.
5286
- */
5287
- url?: string;
5491
+ search_suggestions?: string;
5288
5492
  }
5289
5493
 
5290
5494
  /**
@@ -5292,11 +5496,11 @@ declare interface GoogleSearchResult {
5292
5496
  */
5293
5497
  declare interface GoogleSearchResultContent {
5294
5498
  /**
5295
- * ID to match the ID from the google search call block.
5499
+ * Required. ID to match the ID from the function call block.
5296
5500
  */
5297
5501
  call_id: string;
5298
5502
  /**
5299
- * The results of the Google Search.
5503
+ * Required. The results of the Google Search.
5300
5504
  */
5301
5505
  result: Array<GoogleSearchResult>;
5302
5506
  type: 'google_search_result';
@@ -5332,9 +5536,7 @@ export declare interface GoogleTypeDate {
5332
5536
  is enabled, the model returns a `GroundingChunk` that contains a reference to
5333
5537
  the source of the information. */
5334
5538
  export declare interface GroundingChunk {
5335
- /** A grounding chunk from an image search result. See the `Image`
5336
- message for details.
5337
- */
5539
+ /** A grounding chunk from an image search result. See the `Image` message for details. */
5338
5540
  image?: GroundingChunkImage;
5339
5541
  /** A `Maps` chunk is a piece of evidence that comes from Google Maps.
5340
5542
 
@@ -5342,17 +5544,25 @@ export declare interface GroundingChunk {
5342
5544
  reviews. This is used to provide the user with rich, location-based
5343
5545
  information. */
5344
5546
  maps?: GroundingChunkMaps;
5345
- /** 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. */
5547
+ /** A grounding chunk from a data source retrieved by a retrieval tool, such as Vertex AI Search. See the `RetrievedContext` message for details */
5346
5548
  retrievedContext?: GroundingChunkRetrievedContext;
5347
5549
  /** A grounding chunk from a web page, typically from Google Search. See the `Web` message for details. */
5348
5550
  web?: GroundingChunkWeb;
5349
5551
  }
5350
5552
 
5351
- /** A piece of evidence that comes from an image search result.
5553
+ /** User provided metadata about the GroundingFact. This data type is not supported in Vertex AI. */
5554
+ export declare interface GroundingChunkCustomMetadata {
5555
+ /** The key of the metadata. */
5556
+ key?: string;
5557
+ /** Optional. The numeric value of the metadata. The expected range for this value depends on the specific `key` used. */
5558
+ numericValue?: number;
5559
+ /** Optional. A list of string values for the metadata. */
5560
+ stringListValue?: GroundingChunkStringList;
5561
+ /** Optional. The string value of the metadata. */
5562
+ stringValue?: string;
5563
+ }
5352
5564
 
5353
- It contains the URI of the image search result and the URI of the image.
5354
- This is used to provide the user with a link to the source of the
5355
- information. */
5565
+ /** 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. */
5356
5566
  export declare interface GroundingChunkImage {
5357
5567
  /** The URI of the image search result page. */
5358
5568
  sourceUri?: string;
@@ -5384,6 +5594,8 @@ export declare interface GroundingChunkMaps {
5384
5594
  title?: string;
5385
5595
  /** The URI of the place. */
5386
5596
  uri?: string;
5597
+ /** Output only. Route information. */
5598
+ route?: GroundingChunkMapsRoute;
5387
5599
  }
5388
5600
 
5389
5601
  /** The sources that were used to generate the place answer.
@@ -5427,11 +5639,21 @@ export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
5427
5639
  title?: string;
5428
5640
  }
5429
5641
 
5430
- /** 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. */
5642
+ /** Route information from Google Maps. This data type is not supported in Gemini API. */
5643
+ export declare interface GroundingChunkMapsRoute {
5644
+ /** The total distance of the route, in meters. */
5645
+ distanceMeters?: number;
5646
+ /** The total duration of the route. */
5647
+ duration?: string;
5648
+ /** An encoded polyline of the route. See https://developers.google.com/maps/documentation/utilities/polylinealgorithm */
5649
+ encodedPolyline?: string;
5650
+ }
5651
+
5652
+ /** 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. */
5431
5653
  export declare interface GroundingChunkRetrievedContext {
5432
- /** 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}`. */
5654
+ /** 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. */
5433
5655
  documentName?: string;
5434
- /** Additional context for a Retrieval-Augmented Generation (RAG) retrieval result. This is populated only when the RAG retrieval tool is used. */
5656
+ /** 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. */
5435
5657
  ragChunk?: RagChunk;
5436
5658
  /** The content of the retrieved data source. */
5437
5659
  text?: string;
@@ -5439,6 +5661,16 @@ export declare interface GroundingChunkRetrievedContext {
5439
5661
  title?: string;
5440
5662
  /** The URI of the retrieved data source. */
5441
5663
  uri?: string;
5664
+ /** Optional. User-provided metadata about the retrieved context. This field is not supported in Vertex AI. */
5665
+ customMetadata?: GroundingChunkCustomMetadata[];
5666
+ /** Optional. Name of the `FileSearchStore` containing the document. Example: `fileSearchStores/123`. This field is not supported in Vertex AI. */
5667
+ fileSearchStore?: string;
5668
+ }
5669
+
5670
+ /** A list of string values. This data type is not supported in Vertex AI. */
5671
+ export declare interface GroundingChunkStringList {
5672
+ /** The string values of the list. */
5673
+ values?: string[];
5442
5674
  }
5443
5675
 
5444
5676
  /** 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. */
@@ -5453,10 +5685,7 @@ export declare interface GroundingChunkWeb {
5453
5685
 
5454
5686
  /** Information for various kinds of grounding. */
5455
5687
  export declare interface GroundingMetadata {
5456
- /** Optional. The image search queries that were used to generate the
5457
- content. This field is populated only when the grounding source is Google
5458
- Search with the Image Search search_type enabled.
5459
- */
5688
+ /** 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. */
5460
5689
  imageSearchQueries?: string[];
5461
5690
  /** A list of supporting references retrieved from the grounding
5462
5691
  source. This field is populated when the grounding source is Google
@@ -5472,7 +5701,7 @@ export declare interface GroundingMetadata {
5472
5701
  searchEntryPoint?: SearchEntryPoint;
5473
5702
  /** Web search queries for the following-up web search. */
5474
5703
  webSearchQueries?: string[];
5475
- /** 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. */
5704
+ /** 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. */
5476
5705
  googleMapsWidgetContextToken?: string;
5477
5706
  /** 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. */
5478
5707
  retrievalQueries?: string[];
@@ -5502,6 +5731,8 @@ export declare interface GroundingSupport {
5502
5731
  groundingChunkIndices?: number[];
5503
5732
  /** Segment of the content this support belongs to. */
5504
5733
  segment?: Segment;
5734
+ /** Indices into the `rendered_parts` field of the `GroundingMetadata` message. These indices specify which rendered parts are associated with this support message. */
5735
+ renderedParts?: number[];
5505
5736
  }
5506
5737
 
5507
5738
  /** 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. */
@@ -5795,11 +6026,7 @@ export declare interface ImageConfig {
5795
6026
  /** Controls the generation of people. Supported values are:
5796
6027
  ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE. */
5797
6028
  personGeneration?: string;
5798
- /** Controls whether prominent people (celebrities)
5799
- generation is allowed. If used with personGeneration, personGeneration
5800
- enum would take precedence. For instance, if ALLOW_NONE is set, all person
5801
- generation would be blocked. If this field is unspecified, the default
5802
- behavior is to allow prominent people. */
6029
+ /** 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. */
5803
6030
  prominentPeople?: ProminentPeople;
5804
6031
  /** MIME type of the generated image. This field is not
5805
6032
  supported in Gemini API. */
@@ -5807,7 +6034,7 @@ export declare interface ImageConfig {
5807
6034
  /** Compression quality of the generated image (for
5808
6035
  ``image/jpeg`` only). This field is not supported in Gemini API. */
5809
6036
  outputCompressionQuality?: number;
5810
- /** Optional. The image output format for generated images. */
6037
+ /** Optional. The image output format for generated images. This field is not supported in Gemini API. */
5811
6038
  imageOutputOptions?: ImageConfigImageOutputOptions;
5812
6039
  }
5813
6040
 
@@ -5839,7 +6066,7 @@ declare interface ImageContent {
5839
6066
  /**
5840
6067
  * The mime type of the image.
5841
6068
  */
5842
- mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif';
6069
+ mime_type?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/heic' | 'image/heif' | 'image/gif' | 'image/bmp' | 'image/tiff';
5843
6070
  /**
5844
6071
  * The resolution of the media.
5845
6072
  */
@@ -5921,7 +6148,6 @@ export declare class ImportFileOperation implements Operation<ImportFileResponse
5921
6148
  response?: ImportFileResponse;
5922
6149
  /**
5923
6150
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
5924
- * @internal
5925
6151
  */
5926
6152
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<ImportFileResponse>;
5927
6153
  /** The full HTTP response. */
@@ -5950,12 +6176,12 @@ export declare class ImportFileResponse {
5950
6176
 
5951
6177
  /** Config for `inlined_embedding_responses` parameter. */
5952
6178
  export declare class InlinedEmbedContentResponse {
5953
- /** The response to the request.
5954
- */
6179
+ /** Output only. The response to the request. */
5955
6180
  response?: SingleEmbedContentResponse;
5956
- /** The error encountered while processing the request.
5957
- */
6181
+ /** Output only. The error encountered while processing the request. */
5958
6182
  error?: JobError;
6183
+ /** Output only. The metadata associated with the request. */
6184
+ metadata?: Record<string, unknown>;
5959
6185
  }
5960
6186
 
5961
6187
  /** Config for inlined request. */
@@ -5990,20 +6216,20 @@ export declare class InlinedResponse {
5990
6216
  */
5991
6217
  declare interface Interaction {
5992
6218
  /**
5993
- * Output only. A unique identifier for the interaction completion.
6219
+ * Required. Output only. A unique identifier for the interaction completion.
5994
6220
  */
5995
6221
  id: string;
5996
6222
  /**
5997
- * Output only. The time at which the response was created in ISO 8601 format
6223
+ * Required. Output only. The time at which the response was created in ISO 8601 format
5998
6224
  * (YYYY-MM-DDThh:mm:ssZ).
5999
6225
  */
6000
6226
  created: string;
6001
6227
  /**
6002
- * Output only. The status of the interaction.
6228
+ * Required. Output only. The status of the interaction.
6003
6229
  */
6004
6230
  status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
6005
6231
  /**
6006
- * Output only. The time at which the response was last updated in ISO 8601 format
6232
+ * Required. Output only. The time at which the response was last updated in ISO 8601 format
6007
6233
  * (YYYY-MM-DDThh:mm:ssZ).
6008
6234
  */
6009
6235
  updated: string;
@@ -6018,7 +6244,7 @@ declare interface Interaction {
6018
6244
  /**
6019
6245
  * The input for the interaction.
6020
6246
  */
6021
- 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;
6247
+ 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;
6022
6248
  /**
6023
6249
  * The name of the `Model` used for generating the interaction.
6024
6250
  */
@@ -6048,6 +6274,10 @@ declare interface Interaction {
6048
6274
  * Output only. The role of the interaction.
6049
6275
  */
6050
6276
  role?: string;
6277
+ /**
6278
+ * The service tier for the interaction.
6279
+ */
6280
+ service_tier?: 'flex' | 'standard' | 'priority';
6051
6281
  /**
6052
6282
  * System instruction for the interaction.
6053
6283
  */
@@ -6072,12 +6302,13 @@ declare interface InteractionCancelParams {
6072
6302
  declare interface InteractionCompleteEvent {
6073
6303
  event_type: 'interaction.complete';
6074
6304
  /**
6075
- * The completed interaction with empty outputs to reduce the payload size.
6305
+ * Required. The completed interaction with empty outputs to reduce the payload size.
6076
6306
  * Use the preceding ContentDelta events for the actual output.
6077
6307
  */
6078
6308
  interaction: Interaction;
6079
6309
  /**
6080
- * The event_id token to be used to resume the interaction stream, from this event.
6310
+ * The event_id token to be used to resume the interaction stream, from
6311
+ * this event.
6081
6312
  */
6082
6313
  event_id?: string;
6083
6314
  }
@@ -6137,7 +6368,7 @@ export declare class Interactions extends BaseInteractions {
6137
6368
  }
6138
6369
 
6139
6370
  export declare namespace Interactions {
6140
- 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, };
6371
+ 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, };
6141
6372
  }
6142
6373
 
6143
6374
  declare namespace InteractionsAPI {
@@ -6158,12 +6389,17 @@ declare namespace InteractionsAPI {
6158
6389
  DocumentContent,
6159
6390
  DynamicAgentConfig,
6160
6391
  ErrorEvent_2 as ErrorEvent,
6392
+ FileCitation,
6161
6393
  FileSearchCallContent,
6162
6394
  FileSearchResultContent,
6163
6395
  Function_2 as Function,
6164
6396
  FunctionCallContent,
6165
6397
  FunctionResultContent,
6166
6398
  GenerationConfig_2 as GenerationConfig,
6399
+ GoogleMapsCallArguments,
6400
+ GoogleMapsCallContent,
6401
+ GoogleMapsResult,
6402
+ GoogleMapsResultContent,
6167
6403
  GoogleSearchCallArguments,
6168
6404
  GoogleSearchCallContent,
6169
6405
  GoogleSearchResult,
@@ -6178,6 +6414,7 @@ declare namespace InteractionsAPI {
6178
6414
  MCPServerToolCallContent,
6179
6415
  MCPServerToolResultContent,
6180
6416
  Model_2 as Model,
6417
+ PlaceCitation,
6181
6418
  SpeechConfig_2 as SpeechConfig,
6182
6419
  TextContent,
6183
6420
  ThinkingLevel_2 as ThinkingLevel,
@@ -6186,6 +6423,7 @@ declare namespace InteractionsAPI {
6186
6423
  ToolChoiceConfig,
6187
6424
  ToolChoiceType,
6188
6425
  Turn,
6426
+ URLCitation,
6189
6427
  URLContextCallArguments,
6190
6428
  URLContextCallContent,
6191
6429
  URLContextResult,
@@ -6218,7 +6456,8 @@ declare interface InteractionStartEvent {
6218
6456
  */
6219
6457
  interaction: Interaction;
6220
6458
  /**
6221
- * The event_id token to be used to resume the interaction stream, from this event.
6459
+ * The event_id token to be used to resume the interaction stream, from
6460
+ * this event.
6222
6461
  */
6223
6462
  event_id?: string;
6224
6463
  }
@@ -6228,7 +6467,8 @@ declare interface InteractionStatusUpdate {
6228
6467
  interaction_id: string;
6229
6468
  status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
6230
6469
  /**
6231
- * The event_id token to be used to resume the interaction stream, from this event.
6470
+ * The event_id token to be used to resume the interaction stream, from
6471
+ * this event.
6232
6472
  */
6233
6473
  event_id?: string;
6234
6474
  }
@@ -6470,6 +6710,7 @@ export declare interface ListFileSearchStoresParameters {
6470
6710
  export declare class ListFileSearchStoresResponse {
6471
6711
  /** Used to retain the full HTTP response. */
6472
6712
  sdkHttpResponse?: HttpResponse;
6713
+ /** A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no more pages. */
6473
6714
  nextPageToken?: string;
6474
6715
  /** The returned file search stores. */
6475
6716
  fileSearchStores?: FileSearchStore[];
@@ -7338,6 +7579,8 @@ export declare interface LogprobsResult {
7338
7579
  chosenCandidates?: LogprobsResultCandidate[];
7339
7580
  /** 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. */
7340
7581
  topCandidates?: LogprobsResultTopCandidates[];
7582
+ /** Sum of log probabilities for all tokens. This field is not supported in Vertex AI. */
7583
+ logProbabilitySum?: number;
7341
7584
  }
7342
7585
 
7343
7586
  /** A single token and its associated log probability. */
@@ -7413,24 +7656,28 @@ export declare interface McpServer {
7413
7656
  */
7414
7657
  declare interface MCPServerToolCallContent {
7415
7658
  /**
7416
- * A unique ID for this specific tool call.
7659
+ * Required. A unique ID for this specific tool call.
7417
7660
  */
7418
7661
  id: string;
7419
7662
  /**
7420
- * The JSON object of arguments for the function.
7663
+ * Required. The JSON object of arguments for the function.
7421
7664
  */
7422
7665
  arguments: {
7423
7666
  [key: string]: unknown;
7424
7667
  };
7425
7668
  /**
7426
- * The name of the tool which was called.
7669
+ * Required. The name of the tool which was called.
7427
7670
  */
7428
7671
  name: string;
7429
7672
  /**
7430
- * The name of the used MCP server.
7673
+ * Required. The name of the used MCP server.
7431
7674
  */
7432
7675
  server_name: string;
7433
7676
  type: 'mcp_server_tool_call';
7677
+ /**
7678
+ * A signature hash for backend validation.
7679
+ */
7680
+ signature?: string;
7434
7681
  }
7435
7682
 
7436
7683
  /**
@@ -7438,7 +7685,7 @@ declare interface MCPServerToolCallContent {
7438
7685
  */
7439
7686
  declare interface MCPServerToolResultContent {
7440
7687
  /**
7441
- * ID to match the ID from the MCP server tool call block.
7688
+ * Required. ID to match the ID from the function call block.
7442
7689
  */
7443
7690
  call_id: string;
7444
7691
  /**
@@ -7614,7 +7861,7 @@ export declare interface Model {
7614
7861
  /**
7615
7862
  * The model that will complete your prompt.\n\nSee [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
7616
7863
  */
7617
- 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 & {});
7864
+ 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 & {});
7618
7865
 
7619
7866
  /** 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. */
7620
7867
  export declare interface ModelArmorConfig {
@@ -8020,6 +8267,52 @@ export declare interface ModelSelectionConfig {
8020
8267
  featureSelectionPreference?: FeatureSelectionPreference;
8021
8268
  }
8022
8269
 
8270
+ /** The stage of the underlying model. This enum is not supported in Vertex AI. */
8271
+ export declare enum ModelStage {
8272
+ /**
8273
+ * Unspecified model stage.
8274
+ */
8275
+ MODEL_STAGE_UNSPECIFIED = "MODEL_STAGE_UNSPECIFIED",
8276
+ /**
8277
+ * The underlying model is subject to lots of tunings.
8278
+ */
8279
+ UNSTABLE_EXPERIMENTAL = "UNSTABLE_EXPERIMENTAL",
8280
+ /**
8281
+ * Models in this stage are for experimental purposes only.
8282
+ */
8283
+ EXPERIMENTAL = "EXPERIMENTAL",
8284
+ /**
8285
+ * Models in this stage are more mature than experimental models.
8286
+ */
8287
+ PREVIEW = "PREVIEW",
8288
+ /**
8289
+ * Models in this stage are considered stable and ready for production use.
8290
+ */
8291
+ STABLE = "STABLE",
8292
+ /**
8293
+ * 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.
8294
+ */
8295
+ LEGACY = "LEGACY",
8296
+ /**
8297
+ * Models in this stage are deprecated. These models cannot be used.
8298
+ */
8299
+ DEPRECATED = "DEPRECATED",
8300
+ /**
8301
+ * Models in this stage are retired. These models cannot be used.
8302
+ */
8303
+ RETIRED = "RETIRED"
8304
+ }
8305
+
8306
+ /** 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. */
8307
+ export declare interface ModelStatus {
8308
+ /** A message explaining the model status. */
8309
+ message?: string;
8310
+ /** The stage of the underlying model. */
8311
+ modelStage?: ModelStage;
8312
+ /** The time at which the model will be retired. */
8313
+ retirementTime?: string;
8314
+ }
8315
+
8023
8316
  /** Configuration for a multi-speaker text-to-speech request. */
8024
8317
  export declare interface MultiSpeakerVoiceConfig {
8025
8318
  /** Required. A list of configurations for the voices of the speakers. Exactly two speaker voice configurations must be provided. */
@@ -8105,7 +8398,6 @@ export declare interface Operation<T> {
8105
8398
  response?: T;
8106
8399
  /**
8107
8400
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
8108
- * @internal
8109
8401
  */
8110
8402
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<T>;
8111
8403
  }
@@ -8380,6 +8672,12 @@ export declare interface Part {
8380
8672
  thoughtSignature?: string;
8381
8673
  /** Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data. */
8382
8674
  videoMetadata?: VideoMetadata;
8675
+ /** 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. */
8676
+ toolCall?: ToolCall;
8677
+ /** The output from a server-side ToolCall execution. This field is populated by the client with the results of executing the corresponding ToolCall. */
8678
+ toolResponse?: ToolResponse;
8679
+ /** 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. */
8680
+ partMetadata?: Record<string, unknown>;
8383
8681
  }
8384
8682
 
8385
8683
  /** Partial argument value of the function call. This data type is not supported in Gemini API. */
@@ -8497,6 +8795,61 @@ export declare enum PhishBlockThreshold {
8497
8795
  BLOCK_ONLY_EXTREMELY_HIGH = "BLOCK_ONLY_EXTREMELY_HIGH"
8498
8796
  }
8499
8797
 
8798
+ /**
8799
+ * A place citation annotation.
8800
+ */
8801
+ declare interface PlaceCitation {
8802
+ type: 'place_citation';
8803
+ /**
8804
+ * End of the attributed segment, exclusive.
8805
+ */
8806
+ end_index?: number;
8807
+ /**
8808
+ * Title of the place.
8809
+ */
8810
+ name?: string;
8811
+ /**
8812
+ * The ID of the place, in `places/{place_id}` format.
8813
+ */
8814
+ place_id?: string;
8815
+ /**
8816
+ * Snippets of reviews that are used to generate answers about the
8817
+ * features of a given place in Google Maps.
8818
+ */
8819
+ review_snippets?: Array<PlaceCitation.ReviewSnippet>;
8820
+ /**
8821
+ * Start of segment of the response that is attributed to this source.
8822
+ *
8823
+ * Index indicates the start of the segment, measured in bytes.
8824
+ */
8825
+ start_index?: number;
8826
+ /**
8827
+ * URI reference of the place.
8828
+ */
8829
+ url?: string;
8830
+ }
8831
+
8832
+ declare namespace PlaceCitation {
8833
+ /**
8834
+ * Encapsulates a snippet of a user review that answers a question about
8835
+ * the features of a specific place in Google Maps.
8836
+ */
8837
+ interface ReviewSnippet {
8838
+ /**
8839
+ * The ID of the review snippet.
8840
+ */
8841
+ review_id?: string;
8842
+ /**
8843
+ * Title of the review.
8844
+ */
8845
+ title?: string;
8846
+ /**
8847
+ * A link that corresponds to the user review on Google Maps.
8848
+ */
8849
+ url?: string;
8850
+ }
8851
+ }
8852
+
8500
8853
  /** Spec for pointwise metric result. This data type is not supported in Gemini API. */
8501
8854
  export declare interface PointwiseMetricResult {
8502
8855
  /** Output only. Spec for custom output. */
@@ -8585,7 +8938,7 @@ export declare interface ProductImage {
8585
8938
  productImage?: Image_2;
8586
8939
  }
8587
8940
 
8588
- /** Enum for controlling whether the model can generate images of prominent people (celebrities). */
8941
+ /** 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. */
8589
8942
  export declare enum ProminentPeople {
8590
8943
  /**
8591
8944
  * Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.
@@ -8862,12 +9215,14 @@ export declare class ReplayResponse {
8862
9215
  sdkResponseSegments?: Record<string, unknown>[];
8863
9216
  }
8864
9217
 
8865
- /** ReplicatedVoiceConfig is used to configure replicated voice. */
9218
+ /** The configuration for the replicated voice to use. */
8866
9219
  export declare interface ReplicatedVoiceConfig {
8867
- /** The mime type of the replicated voice.
9220
+ /** The mimetype of the voice sample. The only currently supported
9221
+ value is `audio/wav`. This represents 16-bit signed little-endian wav
9222
+ data, with a 24kHz sampling rate.
8868
9223
  */
8869
9224
  mimeType?: string;
8870
- /** The sample audio of the replicated voice.
9225
+ /** The sample of the custom voice.
8871
9226
 
8872
9227
  * @remarks Encoded as base64 string. */
8873
9228
  voiceSampleAudio?: string;
@@ -9111,7 +9466,7 @@ export declare interface Schema {
9111
9466
  anyOf?: Schema[];
9112
9467
  /** Optional. Default value to use if the field is not specified. */
9113
9468
  default?: unknown;
9114
- /** Optional. Description of the schema. */
9469
+ /** 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. */
9115
9470
  description?: string;
9116
9471
  /** 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"]}` */
9117
9472
  enum?: string[];
@@ -9171,12 +9526,11 @@ export declare interface SearchEntryPoint {
9171
9526
  sdkBlob?: string;
9172
9527
  }
9173
9528
 
9174
- /** Tool to support computer use. */
9529
+ /** Different types of search that can be enabled on the GoogleSearch tool. */
9175
9530
  export declare interface SearchTypes {
9176
- /** Setting this field enables web search. Only text results are
9177
- returned. */
9531
+ /** Optional. Setting this field enables web search. Only text results are returned. */
9178
9532
  webSearch?: WebSearch;
9179
- /** Setting this field enables image search. Image bytes are returned. */
9533
+ /** Optional. Setting this field enables image search. Image bytes are returned. */
9180
9534
  imageSearch?: ImageSearch;
9181
9535
  }
9182
9536
 
@@ -9289,6 +9643,26 @@ export declare interface SendMessageParameters {
9289
9643
  config?: GenerateContentConfig;
9290
9644
  }
9291
9645
 
9646
+ /** Pricing and performance service tier. */
9647
+ export declare enum ServiceTier {
9648
+ /**
9649
+ * Default service tier, which is standard.
9650
+ */
9651
+ SERVICE_TIER_UNSPECIFIED = "SERVICE_TIER_UNSPECIFIED",
9652
+ /**
9653
+ * Flex service tier.
9654
+ */
9655
+ SERVICE_TIER_FLEX = "SERVICE_TIER_FLEX",
9656
+ /**
9657
+ * Standard service tier.
9658
+ */
9659
+ SERVICE_TIER_STANDARD = "SERVICE_TIER_STANDARD",
9660
+ /**
9661
+ * Priority service tier.
9662
+ */
9663
+ SERVICE_TIER_PRIORITY = "SERVICE_TIER_PRIORITY"
9664
+ }
9665
+
9292
9666
  /**
9293
9667
  Represents a connection to the API.
9294
9668
 
@@ -9478,8 +9852,9 @@ export declare interface SpeakerVoiceConfig {
9478
9852
  voiceConfig?: VoiceConfig;
9479
9853
  }
9480
9854
 
9855
+ /** Config for speech generation and transcription. */
9481
9856
  export declare interface SpeechConfig {
9482
- /** Configuration for the voice of the response. */
9857
+ /** The configuration in case of single-voice output. */
9483
9858
  voiceConfig?: VoiceConfig;
9484
9859
  /** Optional. The language code (ISO 639-1) for the speech synthesis. */
9485
9860
  languageCode?: string;
@@ -9748,7 +10123,7 @@ export declare interface TestTableItem {
9748
10123
  */
9749
10124
  declare interface TextContent {
9750
10125
  /**
9751
- * The text content.
10126
+ * Required. The text content.
9752
10127
  */
9753
10128
  text: string;
9754
10129
  type: 'text';
@@ -9776,6 +10151,10 @@ export declare enum ThinkingLevel {
9776
10151
  * Unspecified thinking level.
9777
10152
  */
9778
10153
  THINKING_LEVEL_UNSPECIFIED = "THINKING_LEVEL_UNSPECIFIED",
10154
+ /**
10155
+ * MINIMAL thinking level.
10156
+ */
10157
+ MINIMAL = "MINIMAL",
9779
10158
  /**
9780
10159
  * Low thinking level.
9781
10160
  */
@@ -9787,11 +10166,7 @@ export declare enum ThinkingLevel {
9787
10166
  /**
9788
10167
  * High thinking level.
9789
10168
  */
9790
- HIGH = "HIGH",
9791
- /**
9792
- * MINIMAL thinking level.
9793
- */
9794
- MINIMAL = "MINIMAL"
10169
+ HIGH = "HIGH"
9795
10170
  }
9796
10171
 
9797
10172
  declare type ThinkingLevel_2 = 'minimal' | 'low' | 'medium' | 'high';
@@ -9919,9 +10294,9 @@ export declare interface Tool {
9919
10294
  computer. If enabled, it automatically populates computer-use specific
9920
10295
  Function Declarations. */
9921
10296
  computerUse?: ComputerUse;
9922
- /** Optional. Tool to retrieve knowledge from the File Search Stores. */
10297
+ /** Optional. FileSearch tool type. Tool to retrieve knowledge from Semantic Retrieval corpora. This field is not supported in Vertex AI. */
9923
10298
  fileSearch?: FileSearch;
9924
- /** Enables the model to execute Google Search as part of generation. */
10299
+ /** Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
9925
10300
  googleSearch?: GoogleSearch;
9926
10301
  /** Optional. Tool that allows grounding the model's response with
9927
10302
  geospatial context related to the user's query. */
@@ -9945,7 +10320,7 @@ export declare interface Tool {
9945
10320
  /**
9946
10321
  * A tool that can be used by the model.
9947
10322
  */
9948
- declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch;
10323
+ 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;
9949
10324
 
9950
10325
  declare namespace Tool_2 {
9951
10326
  /**
@@ -10027,6 +10402,40 @@ declare namespace Tool_2 {
10027
10402
  */
10028
10403
  top_k?: number;
10029
10404
  }
10405
+ /**
10406
+ * A tool that can be used by the model to call Google Maps.
10407
+ */
10408
+ interface GoogleMaps {
10409
+ type: 'google_maps';
10410
+ /**
10411
+ * Whether to return a widget context token in the tool call result of the
10412
+ * response.
10413
+ */
10414
+ enable_widget?: boolean;
10415
+ /**
10416
+ * The latitude of the user's location.
10417
+ */
10418
+ latitude?: number;
10419
+ /**
10420
+ * The longitude of the user's location.
10421
+ */
10422
+ longitude?: number;
10423
+ }
10424
+ }
10425
+
10426
+ /** A predicted server-side `ToolCall` returned from the model.
10427
+
10428
+ This message contains information about a tool that the model wants to invoke.
10429
+ The client is NOT expected to execute this `ToolCall`. Instead, the
10430
+ client should pass this `ToolCall` back to the API in a subsequent turn
10431
+ within a `Content` message, along with the corresponding `ToolResponse`. */
10432
+ export declare interface ToolCall {
10433
+ /** Unique identifier of the tool call. The server returns the tool response with the matching `id`. */
10434
+ id?: string;
10435
+ /** The type of tool that was called. */
10436
+ toolType?: ToolType;
10437
+ /** The tool call arguments. Example: {"arg1": "value1", "arg2": "value2"}. */
10438
+ args?: Record<string, unknown>;
10030
10439
  }
10031
10440
 
10032
10441
  /**
@@ -10053,6 +10462,8 @@ export declare interface ToolConfig {
10053
10462
  retrievalConfig?: RetrievalConfig;
10054
10463
  /** Optional. Function calling config. */
10055
10464
  functionCallingConfig?: FunctionCallingConfig;
10465
+ /** 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. */
10466
+ includeServerSideToolInvocations?: boolean;
10056
10467
  }
10057
10468
 
10058
10469
  export declare type ToolListUnion = ToolUnion[];
@@ -10065,6 +10476,49 @@ export declare interface ToolParallelAiSearch {
10065
10476
  customConfigs?: Record<string, unknown>;
10066
10477
  }
10067
10478
 
10479
+ /** The output from a server-side `ToolCall` execution.
10480
+
10481
+ This message contains the results of a tool invocation that was initiated by a
10482
+ `ToolCall` from the model. The client should pass this `ToolResponse` back to
10483
+ the API in a subsequent turn within a `Content` message, along with the
10484
+ corresponding `ToolCall`. */
10485
+ export declare class ToolResponse {
10486
+ /** The identifier of the tool call this response is for. */
10487
+ id?: string;
10488
+ /** The type of tool that was called, matching the tool_type in the corresponding ToolCall. */
10489
+ toolType?: ToolType;
10490
+ /** The tool response. */
10491
+ response?: Record<string, unknown>;
10492
+ }
10493
+
10494
+ /** The type of tool in the function call. */
10495
+ export declare enum ToolType {
10496
+ /**
10497
+ * Unspecified tool type.
10498
+ */
10499
+ TOOL_TYPE_UNSPECIFIED = "TOOL_TYPE_UNSPECIFIED",
10500
+ /**
10501
+ * Google search tool, maps to Tool.google_search.search_types.web_search.
10502
+ */
10503
+ GOOGLE_SEARCH_WEB = "GOOGLE_SEARCH_WEB",
10504
+ /**
10505
+ * Image search tool, maps to Tool.google_search.search_types.image_search.
10506
+ */
10507
+ GOOGLE_SEARCH_IMAGE = "GOOGLE_SEARCH_IMAGE",
10508
+ /**
10509
+ * URL context tool, maps to Tool.url_context.
10510
+ */
10511
+ URL_CONTEXT = "URL_CONTEXT",
10512
+ /**
10513
+ * Google maps tool, maps to Tool.google_maps.
10514
+ */
10515
+ GOOGLE_MAPS = "GOOGLE_MAPS",
10516
+ /**
10517
+ * File search tool, maps to Tool.file_search.
10518
+ */
10519
+ FILE_SEARCH = "FILE_SEARCH"
10520
+ }
10521
+
10068
10522
  export declare type ToolUnion = Tool | CallableTool;
10069
10523
 
10070
10524
  /** Output only. The traffic type for this request. This enum is not supported in Gemini API. */
@@ -10093,11 +10547,9 @@ export declare enum TrafficType {
10093
10547
 
10094
10548
  /** Audio transcription in Server Conent. */
10095
10549
  export declare interface Transcription {
10096
- /** Transcription text.
10097
- */
10550
+ /** Optional. Transcription text. */
10098
10551
  text?: string;
10099
- /** The bool indicates the end of the transcription.
10100
- */
10552
+ /** Optional. The bool indicates the end of the transcription. */
10101
10553
  finished?: boolean;
10102
10554
  }
10103
10555
 
@@ -10235,6 +10687,18 @@ export declare interface TuningJob {
10235
10687
  tuningJobState?: TuningJobState;
10236
10688
  /** Tuning Spec for Veo Tuning. */
10237
10689
  veoTuningSpec?: VeoTuningSpec;
10690
+ /** Optional. Spec for creating a distillation dataset. */
10691
+ distillationSamplingSpec?: DistillationSamplingSpec;
10692
+ /** Output only. Tuning Job metadata. */
10693
+ tuningJobMetadata?: TuningJobMetadata;
10694
+ }
10695
+
10696
+ /** Tuning job metadata. This data type is not supported in Gemini API. */
10697
+ export declare interface TuningJobMetadata {
10698
+ /** Output only. The number of epochs that have been completed. */
10699
+ completedEpochCount?: string;
10700
+ /** Output only. The number of steps that have been completed. Set for Multi-Step RL. */
10701
+ completedStepCount?: string;
10238
10702
  }
10239
10703
 
10240
10704
  /** Output only. The detail state of the tuning job (while the overall `JobState` is running). This enum is not supported in Gemini API. */
@@ -10395,10 +10859,7 @@ export declare interface TuningValidationDataset {
10395
10859
  }
10396
10860
 
10397
10861
  declare interface Turn {
10398
- /**
10399
- * The content of the turn.
10400
- */
10401
- content?: string | Array<Content_2>;
10862
+ content?: Array<Content_2> | string;
10402
10863
  /**
10403
10864
  * The originator of this turn. Must be user for input or model for
10404
10865
  * model output.
@@ -10439,7 +10900,11 @@ export declare enum TurnCoverage {
10439
10900
  /**
10440
10901
  * The users turn includes all realtime input since the last turn, including inactivity (e.g. silence on the audio stream).
10441
10902
  */
10442
- TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT"
10903
+ TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT",
10904
+ /**
10905
+ * Includes audio activity and all video since the last turn. With automatic activity detection, audio activity means speech and excludes silence.
10906
+ */
10907
+ TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO = "TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO"
10443
10908
  }
10444
10909
 
10445
10910
  /** Data type of the schema field. */
@@ -10491,19 +10956,21 @@ declare namespace types {
10491
10956
  createPartFromExecutableCode,
10492
10957
  createUserContent,
10493
10958
  createModelContent,
10494
- Outcome,
10495
10959
  Language,
10960
+ Outcome,
10496
10961
  FunctionResponseScheduling,
10497
10962
  Type,
10498
- PhishBlockThreshold,
10963
+ Environment,
10499
10964
  AuthType,
10500
10965
  HttpElementLocation,
10501
10966
  ApiSpec,
10967
+ PhishBlockThreshold,
10502
10968
  Behavior,
10503
10969
  DynamicRetrievalConfigMode,
10504
10970
  FunctionCallingConfigMode,
10505
10971
  ThinkingLevel,
10506
10972
  PersonGeneration,
10973
+ ProminentPeople,
10507
10974
  HarmCategory,
10508
10975
  HarmBlockMethod,
10509
10976
  HarmBlockThreshold,
@@ -10514,6 +10981,7 @@ declare namespace types {
10514
10981
  BlockedReason,
10515
10982
  TrafficType,
10516
10983
  Modality,
10984
+ ModelStage,
10517
10985
  MediaResolution,
10518
10986
  TuningMode,
10519
10987
  AdapterSize,
@@ -10522,11 +10990,12 @@ declare namespace types {
10522
10990
  AggregationMetric,
10523
10991
  PairwiseChoice,
10524
10992
  TuningTask,
10993
+ DocumentState,
10525
10994
  PartMediaResolutionLevel,
10995
+ ToolType,
10526
10996
  ResourceScope,
10997
+ ServiceTier,
10527
10998
  FeatureSelectionPreference,
10528
- Environment,
10529
- ProminentPeople,
10530
10999
  EmbeddingApiType,
10531
11000
  SafetyFilterLevel,
10532
11001
  ImagePromptLanguage,
@@ -10539,7 +11008,6 @@ declare namespace types {
10539
11008
  VideoGenerationMaskMode,
10540
11009
  VideoCompressionQuality,
10541
11010
  TuningMethod,
10542
- DocumentState,
10543
11011
  FileState,
10544
11012
  FileSource,
10545
11013
  TurnCompleteReason,
@@ -10553,9 +11021,11 @@ declare namespace types {
10553
11021
  Scale,
10554
11022
  MusicGenerationMode,
10555
11023
  LiveMusicPlaybackControl,
10556
- PartMediaResolution,
10557
- CodeExecutionResult,
10558
11024
  ExecutableCode,
11025
+ CodeExecutionResult,
11026
+ PartMediaResolution,
11027
+ ToolCall,
11028
+ ToolResponse,
10559
11029
  FileData,
10560
11030
  PartialArg,
10561
11031
  FunctionCall,
@@ -10572,12 +11042,6 @@ declare namespace types {
10572
11042
  Schema,
10573
11043
  ModelSelectionConfig,
10574
11044
  ComputerUse,
10575
- FileSearch,
10576
- WebSearch,
10577
- ImageSearch,
10578
- SearchTypes,
10579
- Interval,
10580
- GoogleSearch,
10581
11045
  ApiKeyConfig,
10582
11046
  AuthConfigGoogleServiceAccountConfig,
10583
11047
  AuthConfigHttpBasicAuthConfig,
@@ -10601,6 +11065,12 @@ declare namespace types {
10601
11065
  RagRetrievalConfig,
10602
11066
  VertexRagStore,
10603
11067
  Retrieval,
11068
+ FileSearch,
11069
+ WebSearch,
11070
+ ImageSearch,
11071
+ SearchTypes,
11072
+ Interval,
11073
+ GoogleSearch,
10604
11074
  ToolCodeExecution,
10605
11075
  EnterpriseWebSearch,
10606
11076
  FunctionDeclaration,
@@ -10637,13 +11107,16 @@ declare namespace types {
10637
11107
  GoogleTypeDate,
10638
11108
  Citation,
10639
11109
  CitationMetadata,
10640
- GroundingChunkImage,
10641
11110
  GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
10642
11111
  GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
10643
11112
  GroundingChunkMapsPlaceAnswerSources,
11113
+ GroundingChunkMapsRoute,
10644
11114
  GroundingChunkMaps,
11115
+ GroundingChunkImage,
10645
11116
  RagChunkPageSpan,
10646
11117
  RagChunk,
11118
+ GroundingChunkStringList,
11119
+ GroundingChunkCustomMetadata,
10647
11120
  GroundingChunkRetrievedContext,
10648
11121
  GroundingChunkWeb,
10649
11122
  GroundingChunk,
@@ -10663,6 +11136,7 @@ declare namespace types {
10663
11136
  GenerateContentResponsePromptFeedback,
10664
11137
  ModalityTokenCount,
10665
11138
  GenerateContentResponseUsageMetadata,
11139
+ ModelStatus,
10666
11140
  GenerateContentResponse,
10667
11141
  ReferenceImage,
10668
11142
  EditImageParameters,
@@ -10773,6 +11247,8 @@ declare namespace types {
10773
11247
  FullFineTuningSpec,
10774
11248
  VeoHyperParameters,
10775
11249
  VeoTuningSpec,
11250
+ DistillationSamplingSpec,
11251
+ TuningJobMetadata,
10776
11252
  TuningJob,
10777
11253
  ListTuningJobsConfig,
10778
11254
  ListTuningJobsParameters,
@@ -11060,7 +11536,7 @@ declare interface Uploader {
11060
11536
  * @param apiClient The ApiClient to use for uploading.
11061
11537
  * @return A Promise that resolves to types.File.
11062
11538
  */
11063
- upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<File_2>;
11539
+ upload(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<File_2>;
11064
11540
  /**
11065
11541
  * Uploads a file to file search store via the given upload url.
11066
11542
  *
@@ -11069,9 +11545,10 @@ declare interface Uploader {
11069
11545
  * uploaded to. The uploadUrl must be a url that was returned by the
11070
11546
  * https://generativelanguage.googleapis.com/upload/v1beta/{file_search_store_name}:uploadToFileSearchStore endpoint
11071
11547
  * @param apiClient The ApiClient to use for uploading.
11548
+ * @param httpOptions Optional HTTP options to merge.
11072
11549
  * @return A Promise that resolves to types.UploadToFileSearchStoreOperation.
11073
11550
  */
11074
- uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient): Promise<UploadToFileSearchStoreOperation>;
11551
+ uploadToFileSearchStore(file: string | Blob, uploadUrl: string, apiClient: ApiClient, httpOptions?: HttpOptions): Promise<UploadToFileSearchStoreOperation>;
11075
11552
  /**
11076
11553
  * Returns the file's mimeType and the size of a given file. If the file is a
11077
11554
  * string path, the file type is determined by the file extension. If the
@@ -11145,7 +11622,6 @@ export declare class UploadToFileSearchStoreOperation implements Operation<Uploa
11145
11622
  response?: UploadToFileSearchStoreResponse;
11146
11623
  /**
11147
11624
  * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
11148
- * @internal
11149
11625
  */
11150
11626
  _fromAPIResponse({ apiResponse, _isVertexAI, }: OperationFromAPIResponseParameters): Operation<UploadToFileSearchStoreResponse>;
11151
11627
  /** The full HTTP response. */
@@ -11247,6 +11723,31 @@ export declare class UpscaleImageResponse {
11247
11723
  generatedImages?: GeneratedImage[];
11248
11724
  }
11249
11725
 
11726
+ /**
11727
+ * A URL citation annotation.
11728
+ */
11729
+ declare interface URLCitation {
11730
+ type: 'url_citation';
11731
+ /**
11732
+ * End of the attributed segment, exclusive.
11733
+ */
11734
+ end_index?: number;
11735
+ /**
11736
+ * Start of segment of the response that is attributed to this source.
11737
+ *
11738
+ * Index indicates the start of the segment, measured in bytes.
11739
+ */
11740
+ start_index?: number;
11741
+ /**
11742
+ * The title of the URL.
11743
+ */
11744
+ title?: string;
11745
+ /**
11746
+ * The URL.
11747
+ */
11748
+ url?: string;
11749
+ }
11750
+
11250
11751
  /** Tool to support URL context. */
11251
11752
  export declare interface UrlContext {
11252
11753
  }
@@ -11266,14 +11767,18 @@ declare interface URLContextCallArguments {
11266
11767
  */
11267
11768
  declare interface URLContextCallContent {
11268
11769
  /**
11269
- * A unique ID for this specific tool call.
11770
+ * Required. A unique ID for this specific tool call.
11270
11771
  */
11271
11772
  id: string;
11272
11773
  /**
11273
- * The arguments to pass to the URL context.
11774
+ * Required. The arguments to pass to the URL context.
11274
11775
  */
11275
11776
  arguments: URLContextCallArguments;
11276
11777
  type: 'url_context_call';
11778
+ /**
11779
+ * A signature hash for backend validation.
11780
+ */
11781
+ signature?: string;
11277
11782
  }
11278
11783
 
11279
11784
  /** Metadata returned when the model uses the `url_context` tool to get information from a user-provided URL. */
@@ -11301,11 +11806,11 @@ declare interface URLContextResult {
11301
11806
  */
11302
11807
  declare interface URLContextResultContent {
11303
11808
  /**
11304
- * ID to match the ID from the url context call block.
11809
+ * Required. ID to match the ID from the function call block.
11305
11810
  */
11306
11811
  call_id: string;
11307
11812
  /**
11308
- * The results of the URL context.
11813
+ * Required. The results of the URL context.
11309
11814
  */
11310
11815
  result: Array<URLContextResult>;
11311
11816
  type: 'url_context_result';
@@ -11710,16 +12215,17 @@ export declare enum VoiceActivityType {
11710
12215
  ACTIVITY_END = "ACTIVITY_END"
11711
12216
  }
11712
12217
 
12218
+ /** The configuration for the voice to use. */
11713
12219
  export declare interface VoiceConfig {
11714
- /** If true, the model will use a replicated voice for the response. */
12220
+ /** The configuration for a replicated voice, which is a clone of a
12221
+ user's voice that can be used for speech synthesis. If this is unset, a
12222
+ default voice is used. */
11715
12223
  replicatedVoiceConfig?: ReplicatedVoiceConfig;
11716
12224
  /** The configuration for a prebuilt voice. */
11717
12225
  prebuiltVoiceConfig?: PrebuiltVoiceConfig;
11718
12226
  }
11719
12227
 
11720
- /** Standard web search for grounding and related configurations.
11721
-
11722
- Only text results are returned. */
12228
+ /** Standard web search for grounding and related configurations. Only text results are returned. */
11723
12229
  export declare interface WebSearch {
11724
12230
  }
11725
12231