@google/genai 2.10.0 → 2.12.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 +1623 -595
- package/dist/index.cjs +1296 -179
- package/dist/index.mjs +1292 -180
- package/dist/index.mjs.map +1 -1
- package/dist/node/index.cjs +1347 -230
- package/dist/node/index.mjs +1343 -231
- package/dist/node/index.mjs.map +1 -1
- package/dist/node/node.d.ts +1623 -595
- package/dist/tokenizer/node.cjs +157 -53
- package/dist/tokenizer/node.d.ts +204 -4
- package/dist/tokenizer/node.mjs +157 -53
- package/dist/tokenizer/node.mjs.map +1 -1
- package/dist/vertex_internal/index.cjs +158 -54
- package/dist/vertex_internal/index.cjs.map +1 -1
- package/dist/vertex_internal/index.d.ts +308 -67
- package/dist/vertex_internal/index.js +158 -54
- package/dist/vertex_internal/index.js.map +1 -1
- package/dist/web/index.mjs +1343 -231
- package/dist/web/index.mjs.map +1 -1
- package/dist/web/web.d.ts +1623 -595
- package/package.json +2 -9
package/dist/node/node.d.ts
CHANGED
|
@@ -80,30 +80,30 @@ declare type Agent$ = Agent;
|
|
|
80
80
|
* }
|
|
81
81
|
*/
|
|
82
82
|
declare type Agent = {
|
|
83
|
-
/**
|
|
84
|
-
* The unique identifier for the agent.
|
|
85
|
-
*/
|
|
86
|
-
id?: string | undefined;
|
|
87
83
|
/**
|
|
88
84
|
* The base agent to extend.
|
|
89
85
|
*/
|
|
90
86
|
base_agent?: string | undefined;
|
|
91
87
|
/**
|
|
92
|
-
*
|
|
88
|
+
* The environment configuration for the agent.
|
|
93
89
|
*/
|
|
94
|
-
|
|
90
|
+
base_environment?: interactions.Environment | string | undefined;
|
|
95
91
|
/**
|
|
96
92
|
* Agent description for developers to quickly read and understand.
|
|
97
93
|
*/
|
|
98
94
|
description?: string | undefined;
|
|
99
95
|
/**
|
|
100
|
-
* The
|
|
96
|
+
* The unique identifier for the agent.
|
|
101
97
|
*/
|
|
102
|
-
|
|
98
|
+
id?: string | undefined;
|
|
103
99
|
/**
|
|
104
|
-
*
|
|
100
|
+
* System instruction for the agent.
|
|
105
101
|
*/
|
|
106
|
-
|
|
102
|
+
system_instruction?: string | undefined;
|
|
103
|
+
/**
|
|
104
|
+
* The tools available to the agent.
|
|
105
|
+
*/
|
|
106
|
+
tools?: Array<AgentTool> | undefined;
|
|
107
107
|
};
|
|
108
108
|
|
|
109
109
|
declare type AgentCreateParams$ = CreateAgentParams;
|
|
@@ -160,7 +160,7 @@ declare type AgentTool$ = AgentTool;
|
|
|
160
160
|
/**
|
|
161
161
|
* A tool that the agent can use.
|
|
162
162
|
*/
|
|
163
|
-
declare type AgentTool = interactions.CodeExecution | interactions.GoogleSearch | interactions.URLContext | interactions.MCPServer;
|
|
163
|
+
declare type AgentTool = interactions.CodeExecution | interactions.GoogleSearch | interactions.URLContext | interactions.MCPServer | interactions.FunctionT;
|
|
164
164
|
|
|
165
165
|
/** Aggregation metric. This enum is not supported in Gemini API. */
|
|
166
166
|
export declare enum AggregationMetric {
|
|
@@ -251,8 +251,6 @@ declare type AllowedTools = {
|
|
|
251
251
|
|
|
252
252
|
declare type Allowlist$ = Allowlist;
|
|
253
253
|
|
|
254
|
-
declare type Allowlist$2 = AllowlistEntry;
|
|
255
|
-
|
|
256
254
|
/**
|
|
257
255
|
* Outbound networking configuration for the sandbox. When specified, restricts which external domains the sandbox can reach. Omit entirely to allow all outbound traffic with no header injection.
|
|
258
256
|
*/
|
|
@@ -263,13 +261,6 @@ declare type Allowlist = {
|
|
|
263
261
|
allowlist?: Array<AllowlistEntry> | undefined;
|
|
264
262
|
};
|
|
265
263
|
|
|
266
|
-
/**
|
|
267
|
-
* @license
|
|
268
|
-
* Copyright 2026 Google LLC
|
|
269
|
-
* SPDX-License-Identifier: Apache-2.0
|
|
270
|
-
*
|
|
271
|
-
* g3-prettier-ignore-file
|
|
272
|
-
*/
|
|
273
264
|
/**
|
|
274
265
|
* A single domain allowlist rule with optional header injection.
|
|
275
266
|
*/
|
|
@@ -279,9 +270,11 @@ declare type AllowlistEntry = {
|
|
|
279
270
|
*/
|
|
280
271
|
domain: string;
|
|
281
272
|
/**
|
|
282
|
-
* Headers to inject on all outbound requests matching this domain.
|
|
273
|
+
* Headers to inject on all outbound requests matching this domain. Accepts a single dict or a list of dicts. The egress proxy injects these automatically.
|
|
283
274
|
*/
|
|
284
|
-
transform?:
|
|
275
|
+
transform?: {
|
|
276
|
+
[k: string]: string;
|
|
277
|
+
} | Array<{
|
|
285
278
|
[k: string]: string;
|
|
286
279
|
}> | undefined;
|
|
287
280
|
};
|
|
@@ -293,6 +286,30 @@ declare type Annotation$ = Annotation;
|
|
|
293
286
|
*/
|
|
294
287
|
declare type Annotation = URLCitation | FileCitation | PlaceCitation;
|
|
295
288
|
|
|
289
|
+
declare type AntigravityAgentConfig$ = AntigravityAgentConfig;
|
|
290
|
+
|
|
291
|
+
/**
|
|
292
|
+
* @license
|
|
293
|
+
* Copyright 2026 Google LLC
|
|
294
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
295
|
+
*
|
|
296
|
+
* g3-prettier-ignore-file
|
|
297
|
+
*/
|
|
298
|
+
/**
|
|
299
|
+
* Configuration for the Antigravity agent runtime.
|
|
300
|
+
*
|
|
301
|
+
* @remarks
|
|
302
|
+
* Provides server-side control over the agent's execution environment
|
|
303
|
+
* and tool configuration.
|
|
304
|
+
*/
|
|
305
|
+
declare type AntigravityAgentConfig = {
|
|
306
|
+
/**
|
|
307
|
+
* Max total tokens for the agent run.
|
|
308
|
+
*/
|
|
309
|
+
max_total_tokens?: string | undefined;
|
|
310
|
+
type: "antigravity";
|
|
311
|
+
};
|
|
312
|
+
|
|
296
313
|
/** 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. */
|
|
297
314
|
export declare interface ApiAuth {
|
|
298
315
|
/** The API secret. */
|
|
@@ -496,24 +513,9 @@ declare type Arguments$2 = GoogleMapsCallArguments;
|
|
|
496
513
|
|
|
497
514
|
declare type Arguments$3 = GoogleSearchCallArguments;
|
|
498
515
|
|
|
499
|
-
declare type Arguments$4 =
|
|
516
|
+
declare type Arguments$4 = RetrievalCallArguments;
|
|
500
517
|
|
|
501
|
-
|
|
502
|
-
* @license
|
|
503
|
-
* Copyright 2026 Google LLC
|
|
504
|
-
* SPDX-License-Identifier: Apache-2.0
|
|
505
|
-
*
|
|
506
|
-
* g3-prettier-ignore-file
|
|
507
|
-
*/
|
|
508
|
-
/**
|
|
509
|
-
* The arguments to pass to the URL context.
|
|
510
|
-
*/
|
|
511
|
-
declare type Arguments = {
|
|
512
|
-
/**
|
|
513
|
-
* The URLs to fetch.
|
|
514
|
-
*/
|
|
515
|
-
urls?: Array<string> | undefined;
|
|
516
|
-
};
|
|
518
|
+
declare type Arguments$5 = URLContextCallArguments;
|
|
517
519
|
|
|
518
520
|
declare type ArgumentsDelta$ = ArgumentsDelta;
|
|
519
521
|
|
|
@@ -525,10 +527,74 @@ declare type ArgumentsDelta$ = ArgumentsDelta;
|
|
|
525
527
|
* g3-prettier-ignore-file
|
|
526
528
|
*/
|
|
527
529
|
declare type ArgumentsDelta = {
|
|
528
|
-
type: "arguments_delta";
|
|
529
530
|
arguments?: string | undefined;
|
|
531
|
+
type: "arguments_delta";
|
|
530
532
|
};
|
|
531
533
|
|
|
534
|
+
/** The aspect ratio for the image output. */
|
|
535
|
+
export declare enum AspectRatio {
|
|
536
|
+
/**
|
|
537
|
+
* Default value. This value is unused.
|
|
538
|
+
*/
|
|
539
|
+
ASPECT_RATIO_UNSPECIFIED = "ASPECT_RATIO_UNSPECIFIED",
|
|
540
|
+
/**
|
|
541
|
+
* 1:1 aspect ratio.
|
|
542
|
+
*/
|
|
543
|
+
ASPECT_RATIO_ONE_BY_ONE = "ASPECT_RATIO_ONE_BY_ONE",
|
|
544
|
+
/**
|
|
545
|
+
* 2:3 aspect ratio.
|
|
546
|
+
*/
|
|
547
|
+
ASPECT_RATIO_TWO_BY_THREE = "ASPECT_RATIO_TWO_BY_THREE",
|
|
548
|
+
/**
|
|
549
|
+
* 3:2 aspect ratio.
|
|
550
|
+
*/
|
|
551
|
+
ASPECT_RATIO_THREE_BY_TWO = "ASPECT_RATIO_THREE_BY_TWO",
|
|
552
|
+
/**
|
|
553
|
+
* 3:4 aspect ratio.
|
|
554
|
+
*/
|
|
555
|
+
ASPECT_RATIO_THREE_BY_FOUR = "ASPECT_RATIO_THREE_BY_FOUR",
|
|
556
|
+
/**
|
|
557
|
+
* 4:3 aspect ratio.
|
|
558
|
+
*/
|
|
559
|
+
ASPECT_RATIO_FOUR_BY_THREE = "ASPECT_RATIO_FOUR_BY_THREE",
|
|
560
|
+
/**
|
|
561
|
+
* 4:5 aspect ratio.
|
|
562
|
+
*/
|
|
563
|
+
ASPECT_RATIO_FOUR_BY_FIVE = "ASPECT_RATIO_FOUR_BY_FIVE",
|
|
564
|
+
/**
|
|
565
|
+
* 5:4 aspect ratio.
|
|
566
|
+
*/
|
|
567
|
+
ASPECT_RATIO_FIVE_BY_FOUR = "ASPECT_RATIO_FIVE_BY_FOUR",
|
|
568
|
+
/**
|
|
569
|
+
* 9:16 aspect ratio.
|
|
570
|
+
*/
|
|
571
|
+
ASPECT_RATIO_NINE_BY_SIXTEEN = "ASPECT_RATIO_NINE_BY_SIXTEEN",
|
|
572
|
+
/**
|
|
573
|
+
* 16:9 aspect ratio.
|
|
574
|
+
*/
|
|
575
|
+
ASPECT_RATIO_SIXTEEN_BY_NINE = "ASPECT_RATIO_SIXTEEN_BY_NINE",
|
|
576
|
+
/**
|
|
577
|
+
* 21:9 aspect ratio.
|
|
578
|
+
*/
|
|
579
|
+
ASPECT_RATIO_TWENTY_ONE_BY_NINE = "ASPECT_RATIO_TWENTY_ONE_BY_NINE",
|
|
580
|
+
/**
|
|
581
|
+
* 1:8 aspect ratio.
|
|
582
|
+
*/
|
|
583
|
+
ASPECT_RATIO_ONE_BY_EIGHT = "ASPECT_RATIO_ONE_BY_EIGHT",
|
|
584
|
+
/**
|
|
585
|
+
* 8:1 aspect ratio.
|
|
586
|
+
*/
|
|
587
|
+
ASPECT_RATIO_EIGHT_BY_ONE = "ASPECT_RATIO_EIGHT_BY_ONE",
|
|
588
|
+
/**
|
|
589
|
+
* 1:4 aspect ratio.
|
|
590
|
+
*/
|
|
591
|
+
ASPECT_RATIO_ONE_BY_FOUR = "ASPECT_RATIO_ONE_BY_FOUR",
|
|
592
|
+
/**
|
|
593
|
+
* 4:1 aspect ratio.
|
|
594
|
+
*/
|
|
595
|
+
ASPECT_RATIO_FOUR_BY_ONE = "ASPECT_RATIO_FOUR_BY_ONE"
|
|
596
|
+
}
|
|
597
|
+
|
|
532
598
|
declare type Audio$ = AudioDelta;
|
|
533
599
|
|
|
534
600
|
/** Representation of an audio chunk. */
|
|
@@ -548,27 +614,27 @@ declare type AudioContent$ = AudioContent;
|
|
|
548
614
|
* An audio content block.
|
|
549
615
|
*/
|
|
550
616
|
declare type AudioContent = {
|
|
551
|
-
type: "audio";
|
|
552
617
|
/**
|
|
553
|
-
* The audio
|
|
618
|
+
* The number of audio channels.
|
|
554
619
|
*/
|
|
555
|
-
|
|
620
|
+
channels?: number | undefined;
|
|
556
621
|
/**
|
|
557
|
-
* The
|
|
622
|
+
* The audio content.
|
|
558
623
|
*/
|
|
559
|
-
|
|
624
|
+
data?: string | undefined;
|
|
560
625
|
/**
|
|
561
626
|
* The mime type of the audio.
|
|
562
627
|
*/
|
|
563
628
|
mime_type?: AudioContentMimeType | undefined;
|
|
564
|
-
/**
|
|
565
|
-
* The number of audio channels.
|
|
566
|
-
*/
|
|
567
|
-
channels?: number | undefined;
|
|
568
629
|
/**
|
|
569
630
|
* The sample rate of the audio.
|
|
570
631
|
*/
|
|
571
632
|
sample_rate?: number | undefined;
|
|
633
|
+
type: "audio";
|
|
634
|
+
/**
|
|
635
|
+
* The URI of the audio.
|
|
636
|
+
*/
|
|
637
|
+
uri?: string | undefined;
|
|
572
638
|
};
|
|
573
639
|
|
|
574
640
|
/**
|
|
@@ -584,9 +650,11 @@ declare type AudioContent = {
|
|
|
584
650
|
declare type AudioContentMimeType = "audio/wav" | "audio/mp3" | "audio/aiff" | "audio/aac" | "audio/ogg" | "audio/flac" | "audio/mpeg" | "audio/m4a" | "audio/l16" | "audio/opus" | "audio/alaw" | "audio/mulaw" | (string & {});
|
|
585
651
|
|
|
586
652
|
declare type AudioDelta = {
|
|
587
|
-
|
|
653
|
+
/**
|
|
654
|
+
* The number of audio channels.
|
|
655
|
+
*/
|
|
656
|
+
channels?: number | undefined;
|
|
588
657
|
data?: string | undefined;
|
|
589
|
-
uri?: string | undefined;
|
|
590
658
|
mime_type?: AudioDeltaMimeType | undefined;
|
|
591
659
|
/**
|
|
592
660
|
* Deprecated. Use sample_rate instead. The value is ignored.
|
|
@@ -598,10 +666,8 @@ declare type AudioDelta = {
|
|
|
598
666
|
* The sample rate of the audio.
|
|
599
667
|
*/
|
|
600
668
|
sample_rate?: number | undefined;
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
*/
|
|
604
|
-
channels?: number | undefined;
|
|
669
|
+
type: "audio";
|
|
670
|
+
uri?: string | undefined;
|
|
605
671
|
};
|
|
606
672
|
|
|
607
673
|
/**
|
|
@@ -613,39 +679,46 @@ declare type AudioDelta = {
|
|
|
613
679
|
*/
|
|
614
680
|
declare type AudioDeltaMimeType = "audio/wav" | "audio/mp3" | "audio/aiff" | "audio/aac" | "audio/ogg" | "audio/flac" | "audio/mpeg" | "audio/m4a" | "audio/l16" | "audio/opus" | "audio/alaw" | "audio/mulaw" | (string & {});
|
|
615
681
|
|
|
616
|
-
declare type AudioResponseFormat$ =
|
|
682
|
+
declare type AudioResponseFormat$ = AudioResponseFormat_2;
|
|
683
|
+
|
|
684
|
+
/** Configuration for audio-specific output formatting. */
|
|
685
|
+
export declare class AudioResponseFormat {
|
|
686
|
+
/** Optional. Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus). */
|
|
687
|
+
bitRate?: number;
|
|
688
|
+
/** Optional. Delivery mode for the generated content. */
|
|
689
|
+
delivery?: Delivery;
|
|
690
|
+
/** Optional. The MIME type of the audio output. */
|
|
691
|
+
mimeType?: string;
|
|
692
|
+
/** Optional. Sample rate for the generated audio in Hertz. */
|
|
693
|
+
sampleRate?: number;
|
|
694
|
+
}
|
|
617
695
|
|
|
618
696
|
/**
|
|
619
697
|
* Configuration for audio output format.
|
|
620
698
|
*/
|
|
621
|
-
declare type
|
|
622
|
-
type: "audio";
|
|
699
|
+
declare type AudioResponseFormat_2 = {
|
|
623
700
|
/**
|
|
624
|
-
*
|
|
701
|
+
* Bit rate in bits per second (bps). Only applicable for compressed formats
|
|
702
|
+
*
|
|
703
|
+
* @remarks
|
|
704
|
+
* (MP3, Opus).
|
|
625
705
|
*/
|
|
626
|
-
|
|
706
|
+
bit_rate?: number | undefined;
|
|
627
707
|
/**
|
|
628
708
|
* The delivery mode for the audio output.
|
|
629
709
|
*/
|
|
630
710
|
delivery?: AudioResponseFormatDelivery | undefined;
|
|
631
711
|
/**
|
|
632
|
-
*
|
|
712
|
+
* The MIME type of the audio output.
|
|
633
713
|
*/
|
|
634
|
-
|
|
714
|
+
mime_type?: AudioResponseFormatMimeType | undefined;
|
|
635
715
|
/**
|
|
636
|
-
*
|
|
637
|
-
*
|
|
638
|
-
* @remarks
|
|
639
|
-
* (MP3, Opus).
|
|
716
|
+
* Sample rate in Hz.
|
|
640
717
|
*/
|
|
641
|
-
|
|
718
|
+
sample_rate?: number | undefined;
|
|
719
|
+
type: "audio";
|
|
642
720
|
};
|
|
643
721
|
|
|
644
|
-
/**
|
|
645
|
-
* The delivery mode for the audio output.
|
|
646
|
-
*/
|
|
647
|
-
declare type AudioResponseFormatDelivery = "inline" | "uri" | (string & {});
|
|
648
|
-
|
|
649
722
|
/**
|
|
650
723
|
* @license
|
|
651
724
|
* Copyright 2026 Google LLC
|
|
@@ -653,6 +726,11 @@ declare type AudioResponseFormatDelivery = "inline" | "uri" | (string & {});
|
|
|
653
726
|
*
|
|
654
727
|
* g3-prettier-ignore-file
|
|
655
728
|
*/
|
|
729
|
+
/**
|
|
730
|
+
* The delivery mode for the audio output.
|
|
731
|
+
*/
|
|
732
|
+
declare type AudioResponseFormatDelivery = "inline" | "uri" | (string & {});
|
|
733
|
+
|
|
656
734
|
/**
|
|
657
735
|
* The MIME type of the audio output.
|
|
658
736
|
*/
|
|
@@ -1103,7 +1181,7 @@ export declare interface BatchJobSource {
|
|
|
1103
1181
|
|
|
1104
1182
|
export declare type BatchJobSourceUnion = BatchJobSource | InlinedRequest[] | string;
|
|
1105
1183
|
|
|
1106
|
-
/** Specifies the function Behavior.
|
|
1184
|
+
/** Specifies the function Behavior. If not specified, the system keeps the current function call behavior. This field is currently only supported by the BidiGenerateContent method. */
|
|
1107
1185
|
export declare enum Behavior {
|
|
1108
1186
|
/**
|
|
1109
1187
|
* This value is unspecified.
|
|
@@ -1618,18 +1696,17 @@ declare type CodeExecutionCallArguments$ = CodeExecutionCallArguments;
|
|
|
1618
1696
|
* The arguments to pass to the code execution.
|
|
1619
1697
|
*/
|
|
1620
1698
|
declare type CodeExecutionCallArguments = {
|
|
1621
|
-
/**
|
|
1622
|
-
* Programming language of the `code`.
|
|
1623
|
-
*/
|
|
1624
|
-
language?: Language_2 | undefined;
|
|
1625
1699
|
/**
|
|
1626
1700
|
* The code to be executed.
|
|
1627
1701
|
*/
|
|
1628
1702
|
code?: string | undefined;
|
|
1703
|
+
/**
|
|
1704
|
+
* Programming language of the `code`.
|
|
1705
|
+
*/
|
|
1706
|
+
language?: Language_2 | undefined;
|
|
1629
1707
|
};
|
|
1630
1708
|
|
|
1631
1709
|
declare type CodeExecutionCallDelta = {
|
|
1632
|
-
type: "code_execution_call";
|
|
1633
1710
|
/**
|
|
1634
1711
|
* The arguments to pass to the code execution.
|
|
1635
1712
|
*/
|
|
@@ -1638,6 +1715,7 @@ declare type CodeExecutionCallDelta = {
|
|
|
1638
1715
|
* A signature hash for backend validation.
|
|
1639
1716
|
*/
|
|
1640
1717
|
signature?: string | undefined;
|
|
1718
|
+
type: "code_execution_call";
|
|
1641
1719
|
};
|
|
1642
1720
|
|
|
1643
1721
|
declare type CodeExecutionCallStep$ = CodeExecutionCallStep;
|
|
@@ -1646,7 +1724,6 @@ declare type CodeExecutionCallStep$ = CodeExecutionCallStep;
|
|
|
1646
1724
|
* Code execution call step.
|
|
1647
1725
|
*/
|
|
1648
1726
|
declare type CodeExecutionCallStep = {
|
|
1649
|
-
type: "code_execution_call";
|
|
1650
1727
|
/**
|
|
1651
1728
|
* The arguments to pass to the code execution.
|
|
1652
1729
|
*/
|
|
@@ -1659,6 +1736,7 @@ declare type CodeExecutionCallStep = {
|
|
|
1659
1736
|
* A signature hash for backend validation.
|
|
1660
1737
|
*/
|
|
1661
1738
|
signature?: string | undefined;
|
|
1739
|
+
type: "code_execution_call";
|
|
1662
1740
|
};
|
|
1663
1741
|
|
|
1664
1742
|
declare type CodeExecutionResult$ = CodeExecutionResultDelta;
|
|
@@ -1681,13 +1759,13 @@ export declare interface CodeExecutionResult {
|
|
|
1681
1759
|
* g3-prettier-ignore-file
|
|
1682
1760
|
*/
|
|
1683
1761
|
declare type CodeExecutionResultDelta = {
|
|
1684
|
-
type: "code_execution_result";
|
|
1685
|
-
result: string;
|
|
1686
1762
|
is_error?: boolean | undefined;
|
|
1763
|
+
result: string;
|
|
1687
1764
|
/**
|
|
1688
1765
|
* A signature hash for backend validation.
|
|
1689
1766
|
*/
|
|
1690
1767
|
signature?: string | undefined;
|
|
1768
|
+
type: "code_execution_result";
|
|
1691
1769
|
};
|
|
1692
1770
|
|
|
1693
1771
|
declare type CodeExecutionResultStep$ = CodeExecutionResultStep;
|
|
@@ -1703,23 +1781,64 @@ declare type CodeExecutionResultStep$ = CodeExecutionResultStep;
|
|
|
1703
1781
|
* Code execution result step.
|
|
1704
1782
|
*/
|
|
1705
1783
|
declare type CodeExecutionResultStep = {
|
|
1706
|
-
type: "code_execution_result";
|
|
1707
1784
|
/**
|
|
1708
|
-
* Required.
|
|
1785
|
+
* Required. ID to match the ID from the function call block.
|
|
1709
1786
|
*/
|
|
1710
|
-
|
|
1787
|
+
call_id: string;
|
|
1711
1788
|
/**
|
|
1712
1789
|
* Whether the code execution resulted in an error.
|
|
1713
1790
|
*/
|
|
1714
1791
|
is_error?: boolean | undefined;
|
|
1715
1792
|
/**
|
|
1716
|
-
* Required.
|
|
1793
|
+
* Required. The output of the code execution.
|
|
1717
1794
|
*/
|
|
1718
|
-
|
|
1795
|
+
result: string;
|
|
1719
1796
|
/**
|
|
1720
1797
|
* A signature hash for backend validation.
|
|
1721
1798
|
*/
|
|
1722
1799
|
signature?: string | undefined;
|
|
1800
|
+
type: "code_execution_result";
|
|
1801
|
+
};
|
|
1802
|
+
|
|
1803
|
+
declare type CodeMenderAgentConfig$ = CodeMenderAgentConfig;
|
|
1804
|
+
|
|
1805
|
+
/**
|
|
1806
|
+
* Configuration for the CodeMender agent.
|
|
1807
|
+
*/
|
|
1808
|
+
declare type CodeMenderAgentConfig = {
|
|
1809
|
+
/**
|
|
1810
|
+
* Request parameters specific to FIND sessions, used for discovering
|
|
1811
|
+
*
|
|
1812
|
+
* @remarks
|
|
1813
|
+
* vulnerabilities in a codebase.
|
|
1814
|
+
*/
|
|
1815
|
+
find_request?: FindRequest | undefined;
|
|
1816
|
+
/**
|
|
1817
|
+
* Request parameters specific to FIX sessions, used for generating and
|
|
1818
|
+
*
|
|
1819
|
+
* @remarks
|
|
1820
|
+
* validating security patches.
|
|
1821
|
+
*/
|
|
1822
|
+
fix_request?: FixRequest | undefined;
|
|
1823
|
+
/**
|
|
1824
|
+
* The name of the model to use for the CodeMender agent. One
|
|
1825
|
+
*
|
|
1826
|
+
* @remarks
|
|
1827
|
+
* CodeMender session will only use one model.
|
|
1828
|
+
*/
|
|
1829
|
+
model?: string | undefined;
|
|
1830
|
+
/**
|
|
1831
|
+
* The configuration of CodeMender sessions.
|
|
1832
|
+
*/
|
|
1833
|
+
session_config?: SessionConfig | undefined;
|
|
1834
|
+
/**
|
|
1835
|
+
* Parameter for grouping multiple interactions that belong to
|
|
1836
|
+
*
|
|
1837
|
+
* @remarks
|
|
1838
|
+
* the same CodeMender session.
|
|
1839
|
+
*/
|
|
1840
|
+
session_id?: string | undefined;
|
|
1841
|
+
type: "code-mender";
|
|
1723
1842
|
};
|
|
1724
1843
|
|
|
1725
1844
|
/** Success and error statistics of processing multiple entities (for example, DataItems or structured data rows) in batch. This data type is not supported in Gemini API. */
|
|
@@ -1736,13 +1855,15 @@ export declare interface CompletionStats {
|
|
|
1736
1855
|
|
|
1737
1856
|
/** Composite reinforcement tuning reward config. */
|
|
1738
1857
|
export declare interface CompositeReinforcementTuningRewardConfig {
|
|
1858
|
+
/** List of reward function configurations with weights. */
|
|
1739
1859
|
weightedRewardConfigs?: CompositeReinforcementTuningRewardConfigWeightedRewardConfig[];
|
|
1740
1860
|
}
|
|
1741
1861
|
|
|
1742
1862
|
/** Composite reinforcement tuning reward config weighted reward config. */
|
|
1743
1863
|
export declare interface CompositeReinforcementTuningRewardConfigWeightedRewardConfig {
|
|
1864
|
+
/** Single reward configuration. */
|
|
1744
1865
|
rewardConfig?: SingleReinforcementTuningRewardConfig;
|
|
1745
|
-
/** How much this single reward contributes to the total overall reward. */
|
|
1866
|
+
/** How much this single reward contributes to the total overall reward. Total reward is a linear combination of single rewards with their corresponding weights, i.e., ``` total_reward = ( weight_a * reward_a + weight_b * reward_b + ... ) / (weight_a + weight_b + ...) ``` */
|
|
1746
1867
|
weight?: number;
|
|
1747
1868
|
}
|
|
1748
1869
|
|
|
@@ -1764,15 +1885,10 @@ export declare interface ComputerUse {
|
|
|
1764
1885
|
* A tool that can be used by the model to interact with the computer.
|
|
1765
1886
|
*/
|
|
1766
1887
|
declare type ComputerUse_2 = {
|
|
1767
|
-
type: "computer_use";
|
|
1768
|
-
/**
|
|
1769
|
-
* The environment being operated.
|
|
1770
|
-
*/
|
|
1771
|
-
environment?: EnvironmentEnum | undefined;
|
|
1772
1888
|
/**
|
|
1773
|
-
*
|
|
1889
|
+
* Optional. Disabled safety policies for computer use.
|
|
1774
1890
|
*/
|
|
1775
|
-
|
|
1891
|
+
disabled_safety_policies?: Array<DisabledSafetyPolicy> | undefined;
|
|
1776
1892
|
/**
|
|
1777
1893
|
* Whether enable the prompt injection detection check on computer-use
|
|
1778
1894
|
*
|
|
@@ -1781,9 +1897,14 @@ declare type ComputerUse_2 = {
|
|
|
1781
1897
|
*/
|
|
1782
1898
|
enable_prompt_injection_detection?: boolean | undefined;
|
|
1783
1899
|
/**
|
|
1784
|
-
*
|
|
1900
|
+
* The environment being operated.
|
|
1785
1901
|
*/
|
|
1786
|
-
|
|
1902
|
+
environment?: EnvironmentEnum | undefined;
|
|
1903
|
+
/**
|
|
1904
|
+
* The list of predefined functions that are excluded from the model call.
|
|
1905
|
+
*/
|
|
1906
|
+
excluded_predefined_functions?: Array<string> | undefined;
|
|
1907
|
+
type: "computer_use";
|
|
1787
1908
|
};
|
|
1788
1909
|
|
|
1789
1910
|
/** Optional parameters for computing tokens. */
|
|
@@ -1861,6 +1982,9 @@ export declare interface ContentEmbeddingStatistics {
|
|
|
1861
1982
|
/** Gemini Enterprise Agent Platform only. Number of tokens of the input text.
|
|
1862
1983
|
*/
|
|
1863
1984
|
tokenCount?: number;
|
|
1985
|
+
/** Gemini Enterprise Agent Platform only. List of modalities and their token count for the input content.
|
|
1986
|
+
*/
|
|
1987
|
+
tokensDetails?: ModalityTokenCount[];
|
|
1864
1988
|
}
|
|
1865
1989
|
|
|
1866
1990
|
export declare type ContentListUnion = Content | Content[] | PartUnion | PartUnion[];
|
|
@@ -2032,7 +2156,7 @@ declare type CreateAgentInteraction = {
|
|
|
2032
2156
|
/**
|
|
2033
2157
|
* Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field.
|
|
2034
2158
|
*/
|
|
2035
|
-
response_format?: Array<
|
|
2159
|
+
response_format?: Array<ResponseFormat_2> | ResponseFormat_2 | undefined;
|
|
2036
2160
|
/**
|
|
2037
2161
|
* The environment configuration for the interaction. Can be an object specifying remote environment sources or a string referencing an existing environment ID.
|
|
2038
2162
|
*/
|
|
@@ -2040,7 +2164,17 @@ declare type CreateAgentInteraction = {
|
|
|
2040
2164
|
/**
|
|
2041
2165
|
* Configuration parameters for the agent interaction.
|
|
2042
2166
|
*/
|
|
2043
|
-
agent_config?: DynamicAgentConfig | DeepResearchAgentConfig | undefined;
|
|
2167
|
+
agent_config?: DynamicAgentConfig | DeepResearchAgentConfig | CodeMenderAgentConfig | AntigravityAgentConfig | undefined;
|
|
2168
|
+
/**
|
|
2169
|
+
* Safety settings for the interaction.
|
|
2170
|
+
*/
|
|
2171
|
+
safety_settings?: Array<SafetySetting_2> | undefined;
|
|
2172
|
+
/**
|
|
2173
|
+
* The labels with user-defined metadata for the request.
|
|
2174
|
+
*/
|
|
2175
|
+
labels?: {
|
|
2176
|
+
[k: string]: string;
|
|
2177
|
+
} | undefined;
|
|
2044
2178
|
/**
|
|
2045
2179
|
* The input for the interaction.
|
|
2046
2180
|
*/
|
|
@@ -2050,7 +2184,7 @@ declare type CreateAgentInteraction = {
|
|
|
2050
2184
|
/**
|
|
2051
2185
|
* Configuration parameters for the agent interaction.
|
|
2052
2186
|
*/
|
|
2053
|
-
declare type CreateAgentInteractionAgentConfig = DynamicAgentConfig | DeepResearchAgentConfig;
|
|
2187
|
+
declare type CreateAgentInteractionAgentConfig = DynamicAgentConfig | DeepResearchAgentConfig | CodeMenderAgentConfig | AntigravityAgentConfig;
|
|
2054
2188
|
|
|
2055
2189
|
/**
|
|
2056
2190
|
* The environment configuration for the interaction. Can be an object specifying remote environment sources or a string referencing an existing environment ID.
|
|
@@ -2074,7 +2208,7 @@ declare type CreateAgentInteractionParamsStreaming = CreateAgentInteractionParam
|
|
|
2074
2208
|
/**
|
|
2075
2209
|
* Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field.
|
|
2076
2210
|
*/
|
|
2077
|
-
declare type CreateAgentInteractionResponseFormat = Array<
|
|
2211
|
+
declare type CreateAgentInteractionResponseFormat = Array<ResponseFormat_2> | ResponseFormat_2;
|
|
2078
2212
|
|
|
2079
2213
|
declare type CreateAgentParams = Omit<CreateAgentRequest, "body"> & CreateAgentRequest["body"];
|
|
2080
2214
|
|
|
@@ -2418,7 +2552,7 @@ declare type CreateModelInteraction = {
|
|
|
2418
2552
|
/**
|
|
2419
2553
|
* Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field.
|
|
2420
2554
|
*/
|
|
2421
|
-
response_format?: Array<
|
|
2555
|
+
response_format?: Array<ResponseFormat_2> | ResponseFormat_2 | undefined;
|
|
2422
2556
|
/**
|
|
2423
2557
|
* The environment configuration for the interaction. Can be an object specifying remote environment sources or a string referencing an existing environment ID.
|
|
2424
2558
|
*/
|
|
@@ -2428,15 +2562,15 @@ declare type CreateModelInteraction = {
|
|
|
2428
2562
|
*/
|
|
2429
2563
|
generation_config?: GenerationConfig_2 | undefined;
|
|
2430
2564
|
/**
|
|
2431
|
-
*
|
|
2432
|
-
|
|
2433
|
-
|
|
2434
|
-
|
|
2435
|
-
*
|
|
2436
|
-
* Format:
|
|
2437
|
-
* `projects/{project}/locations/{location}/cachedContents/{cachedContent}`
|
|
2565
|
+
* Safety settings for the interaction.
|
|
2566
|
+
*/
|
|
2567
|
+
safety_settings?: Array<SafetySetting_2> | undefined;
|
|
2568
|
+
/**
|
|
2569
|
+
* The labels with user-defined metadata for the request.
|
|
2438
2570
|
*/
|
|
2439
|
-
|
|
2571
|
+
labels?: {
|
|
2572
|
+
[k: string]: string;
|
|
2573
|
+
} | undefined;
|
|
2440
2574
|
/**
|
|
2441
2575
|
* The input for the interaction.
|
|
2442
2576
|
*/
|
|
@@ -2465,7 +2599,7 @@ declare type CreateModelInteractionParamsStreaming = CreateModelInteractionParam
|
|
|
2465
2599
|
/**
|
|
2466
2600
|
* Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field.
|
|
2467
2601
|
*/
|
|
2468
|
-
declare type CreateModelInteractionResponseFormat = Array<
|
|
2602
|
+
declare type CreateModelInteractionResponseFormat = Array<ResponseFormat_2> | ResponseFormat_2;
|
|
2469
2603
|
|
|
2470
2604
|
/**
|
|
2471
2605
|
* Creates a `Part` object from a `base64` encoded `string`.
|
|
@@ -2502,6 +2636,16 @@ export declare function createPartFromText(text: string): Part;
|
|
|
2502
2636
|
*/
|
|
2503
2637
|
export declare function createPartFromUri(uri: string, mimeType: string, mediaResolution?: PartMediaResolutionLevel): Part;
|
|
2504
2638
|
|
|
2639
|
+
declare type CreateTriggerParams = Omit<CreateTriggerRequest, "body"> & CreateTriggerRequest["body"];
|
|
2640
|
+
|
|
2641
|
+
declare type CreateTriggerRequest = {
|
|
2642
|
+
/**
|
|
2643
|
+
* Which version of the API to use.
|
|
2644
|
+
*/
|
|
2645
|
+
api_version?: string | undefined;
|
|
2646
|
+
body: triggers.TriggerCreateParams;
|
|
2647
|
+
};
|
|
2648
|
+
|
|
2505
2649
|
/** Fine-tuning job creation request - optional fields. */
|
|
2506
2650
|
export declare interface CreateTuningJobConfig {
|
|
2507
2651
|
/** Used to override HTTP request options. */
|
|
@@ -2697,6 +2841,12 @@ export declare interface DatasetStats {
|
|
|
2697
2841
|
userMessagePerExampleDistribution?: DatasetDistribution;
|
|
2698
2842
|
/** Output only. Dataset distributions for the user output tokens. */
|
|
2699
2843
|
userOutputTokenDistribution?: DatasetDistribution;
|
|
2844
|
+
/** Output only. Dataset distributions for the number of contents per example. */
|
|
2845
|
+
contentsPerExampleDistribution?: DatasetDistribution;
|
|
2846
|
+
/** Output only. Sample user dataset examples in the training dataset uri for Reinforcement Tuning. */
|
|
2847
|
+
reinforcementTuningUserDatasetExamples?: ReinforcementTuningUserDatasetExamples;
|
|
2848
|
+
/** Output only. Number of billable tokens in the tuning dataset. */
|
|
2849
|
+
totalBillableTokenCount?: string;
|
|
2700
2850
|
}
|
|
2701
2851
|
|
|
2702
2852
|
declare type DeepResearchAgentConfig$ = DeepResearchAgentConfig;
|
|
@@ -2705,12 +2855,6 @@ declare type DeepResearchAgentConfig$ = DeepResearchAgentConfig;
|
|
|
2705
2855
|
* Configuration for the Deep Research agent.
|
|
2706
2856
|
*/
|
|
2707
2857
|
declare type DeepResearchAgentConfig = {
|
|
2708
|
-
type: "deep-research";
|
|
2709
|
-
thinking_summaries?: ThinkingSummaries | undefined;
|
|
2710
|
-
/**
|
|
2711
|
-
* Whether to include visualizations in the response.
|
|
2712
|
-
*/
|
|
2713
|
-
visualization?: Visualization | undefined;
|
|
2714
2858
|
/**
|
|
2715
2859
|
* Enables human-in-the-loop planning for the Deep Research agent. If set to
|
|
2716
2860
|
*
|
|
@@ -2724,8 +2868,14 @@ declare type DeepResearchAgentConfig = {
|
|
|
2724
2868
|
* Enables bigquery tool for the Deep Research agent.
|
|
2725
2869
|
*/
|
|
2726
2870
|
enable_bigquery_tool?: boolean | undefined;
|
|
2727
|
-
|
|
2728
|
-
|
|
2871
|
+
thinking_summaries?: ThinkingSummaries | undefined;
|
|
2872
|
+
type: "deep-research";
|
|
2873
|
+
/**
|
|
2874
|
+
* Whether to include visualizations in the response.
|
|
2875
|
+
*/
|
|
2876
|
+
visualization?: Visualization | undefined;
|
|
2877
|
+
};
|
|
2878
|
+
|
|
2729
2879
|
declare type DeleteAgentParams = Omit<DeleteAgentRequest, "id">;
|
|
2730
2880
|
|
|
2731
2881
|
declare type DeleteAgentRequest = {
|
|
@@ -2915,6 +3065,19 @@ export declare interface DeleteResourceJob {
|
|
|
2915
3065
|
error?: JobError;
|
|
2916
3066
|
}
|
|
2917
3067
|
|
|
3068
|
+
declare type DeleteTriggerParams = Omit<DeleteTriggerRequest, "id">;
|
|
3069
|
+
|
|
3070
|
+
declare type DeleteTriggerRequest = {
|
|
3071
|
+
/**
|
|
3072
|
+
* Which version of the API to use.
|
|
3073
|
+
*/
|
|
3074
|
+
api_version?: string | undefined;
|
|
3075
|
+
/**
|
|
3076
|
+
* Resource name of the trigger.
|
|
3077
|
+
*/
|
|
3078
|
+
id: string;
|
|
3079
|
+
};
|
|
3080
|
+
|
|
2918
3081
|
declare type DeleteWebhookParams = Omit<DeleteWebhookRequest, "id">;
|
|
2919
3082
|
|
|
2920
3083
|
declare type DeleteWebhookRequest = {
|
|
@@ -2931,11 +3094,34 @@ declare type DeleteWebhookRequest = {
|
|
|
2931
3094
|
id: string;
|
|
2932
3095
|
};
|
|
2933
3096
|
|
|
3097
|
+
/** Delivery mode for the generated content. */
|
|
3098
|
+
export declare enum Delivery {
|
|
3099
|
+
/**
|
|
3100
|
+
* Default value. This value is unused.
|
|
3101
|
+
*/
|
|
3102
|
+
DELIVERY_UNSPECIFIED = "DELIVERY_UNSPECIFIED",
|
|
3103
|
+
/**
|
|
3104
|
+
* Generated bytes are returned inline in the response.
|
|
3105
|
+
*/
|
|
3106
|
+
INLINE = "INLINE",
|
|
3107
|
+
/**
|
|
3108
|
+
* Generated content is stored and a URI is returned.
|
|
3109
|
+
*/
|
|
3110
|
+
URI = "URI"
|
|
3111
|
+
}
|
|
3112
|
+
|
|
2934
3113
|
/**
|
|
2935
3114
|
* Turns all network off.
|
|
2936
3115
|
*/
|
|
2937
3116
|
declare type Disabled = "disabled";
|
|
2938
3117
|
|
|
3118
|
+
/**
|
|
3119
|
+
* @license
|
|
3120
|
+
* Copyright 2026 Google LLC
|
|
3121
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
3122
|
+
*
|
|
3123
|
+
* g3-prettier-ignore-file
|
|
3124
|
+
*/
|
|
2939
3125
|
declare type DisabledSafetyPolicy = "financial_transactions" | "sensitive_data_modification" | "communication_tool" | "account_creation" | "data_modification" | "user_consent_management" | "legal_terms_and_agreements" | (string & {});
|
|
2940
3126
|
|
|
2941
3127
|
/** Statistics for distillation prompt dataset. These statistics do not include the responses sampled from the teacher model. This data type is not supported in Gemini API. */
|
|
@@ -3037,19 +3223,19 @@ declare type DocumentContent$ = DocumentContent;
|
|
|
3037
3223
|
* A document content block.
|
|
3038
3224
|
*/
|
|
3039
3225
|
declare type DocumentContent = {
|
|
3040
|
-
type: "document";
|
|
3041
3226
|
/**
|
|
3042
3227
|
* The document content.
|
|
3043
3228
|
*/
|
|
3044
3229
|
data?: string | undefined;
|
|
3045
|
-
/**
|
|
3046
|
-
* The URI of the document.
|
|
3047
|
-
*/
|
|
3048
|
-
uri?: string | undefined;
|
|
3049
3230
|
/**
|
|
3050
3231
|
* The mime type of the document.
|
|
3051
3232
|
*/
|
|
3052
3233
|
mime_type?: DocumentContentMimeType | undefined;
|
|
3234
|
+
type: "document";
|
|
3235
|
+
/**
|
|
3236
|
+
* The URI of the document.
|
|
3237
|
+
*/
|
|
3238
|
+
uri?: string | undefined;
|
|
3053
3239
|
};
|
|
3054
3240
|
|
|
3055
3241
|
/**
|
|
@@ -3065,10 +3251,10 @@ declare type DocumentContent = {
|
|
|
3065
3251
|
declare type DocumentContentMimeType = "application/pdf" | "text/csv" | (string & {});
|
|
3066
3252
|
|
|
3067
3253
|
declare type DocumentDelta = {
|
|
3068
|
-
type: "document";
|
|
3069
3254
|
data?: string | undefined;
|
|
3070
|
-
uri?: string | undefined;
|
|
3071
3255
|
mime_type?: DocumentDeltaMimeType | undefined;
|
|
3256
|
+
type: "document";
|
|
3257
|
+
uri?: string | undefined;
|
|
3072
3258
|
};
|
|
3073
3259
|
|
|
3074
3260
|
/**
|
|
@@ -3526,21 +3712,21 @@ export declare enum Environment {
|
|
|
3526
3712
|
* Configuration for a custom environment.
|
|
3527
3713
|
*/
|
|
3528
3714
|
declare type Environment_2 = {
|
|
3529
|
-
|
|
3530
|
-
|
|
3715
|
+
/**
|
|
3716
|
+
* Optional. The environment ID for the interaction. If specified, the request will
|
|
3717
|
+
*
|
|
3718
|
+
* @remarks
|
|
3719
|
+
* update the existing environment instead of creating a new one.
|
|
3720
|
+
*/
|
|
3721
|
+
environment_id?: string | undefined;
|
|
3531
3722
|
/**
|
|
3532
3723
|
* Network configuration for the environment.
|
|
3533
3724
|
*/
|
|
3534
3725
|
network?: EnvironmentNetworkEgressAllowlist | NetworkEnum | undefined;
|
|
3726
|
+
sources?: Array<Source> | undefined;
|
|
3727
|
+
type: "remote";
|
|
3535
3728
|
};
|
|
3536
3729
|
|
|
3537
|
-
/**
|
|
3538
|
-
* @license
|
|
3539
|
-
* Copyright 2026 Google LLC
|
|
3540
|
-
* SPDX-License-Identifier: Apache-2.0
|
|
3541
|
-
*
|
|
3542
|
-
* g3-prettier-ignore-file
|
|
3543
|
-
*/
|
|
3544
3730
|
/**
|
|
3545
3731
|
* The environment being operated.
|
|
3546
3732
|
*/
|
|
@@ -3558,7 +3744,6 @@ declare type Error$2 = Status;
|
|
|
3558
3744
|
declare type ErrorEvent$ = ErrorEvent_2;
|
|
3559
3745
|
|
|
3560
3746
|
declare type ErrorEvent_2 = {
|
|
3561
|
-
event_type: "error";
|
|
3562
3747
|
/**
|
|
3563
3748
|
* Error message from an interaction.
|
|
3564
3749
|
*/
|
|
@@ -3570,6 +3755,7 @@ declare type ErrorEvent_2 = {
|
|
|
3570
3755
|
* this event.
|
|
3571
3756
|
*/
|
|
3572
3757
|
event_id?: string | undefined;
|
|
3758
|
+
event_type: "error";
|
|
3573
3759
|
metadata?: StreamMetadata | undefined;
|
|
3574
3760
|
};
|
|
3575
3761
|
|
|
@@ -3768,33 +3954,36 @@ declare type FileCitation$ = FileCitation;
|
|
|
3768
3954
|
* A file citation annotation.
|
|
3769
3955
|
*/
|
|
3770
3956
|
declare type FileCitation = {
|
|
3771
|
-
|
|
3957
|
+
/**
|
|
3958
|
+
* User provided metadata about the retrieved context.
|
|
3959
|
+
*/
|
|
3960
|
+
custom_metadata?: {
|
|
3961
|
+
[k: string]: any;
|
|
3962
|
+
} | undefined;
|
|
3772
3963
|
/**
|
|
3773
3964
|
* The URI of the file.
|
|
3774
3965
|
*/
|
|
3775
3966
|
document_uri?: string | undefined;
|
|
3776
3967
|
/**
|
|
3777
|
-
*
|
|
3968
|
+
* End of the attributed segment, exclusive.
|
|
3778
3969
|
*/
|
|
3779
|
-
|
|
3970
|
+
end_index?: number | undefined;
|
|
3780
3971
|
/**
|
|
3781
|
-
*
|
|
3972
|
+
* The name of the file.
|
|
3782
3973
|
*/
|
|
3783
|
-
|
|
3974
|
+
file_name?: string | undefined;
|
|
3784
3975
|
/**
|
|
3785
|
-
*
|
|
3976
|
+
* Media ID in-case of image citations, if applicable.
|
|
3786
3977
|
*/
|
|
3787
|
-
|
|
3788
|
-
[k: string]: any;
|
|
3789
|
-
} | undefined;
|
|
3978
|
+
media_id?: string | undefined;
|
|
3790
3979
|
/**
|
|
3791
3980
|
* Page number of the cited document, if applicable.
|
|
3792
3981
|
*/
|
|
3793
3982
|
page_number?: number | undefined;
|
|
3794
3983
|
/**
|
|
3795
|
-
*
|
|
3984
|
+
* Source attributed for a portion of the text.
|
|
3796
3985
|
*/
|
|
3797
|
-
|
|
3986
|
+
source?: string | undefined;
|
|
3798
3987
|
/**
|
|
3799
3988
|
* Start of segment of the response that is attributed to this source.
|
|
3800
3989
|
*
|
|
@@ -3803,10 +3992,28 @@ declare type FileCitation = {
|
|
|
3803
3992
|
* Index indicates the start of the segment, measured in bytes.
|
|
3804
3993
|
*/
|
|
3805
3994
|
start_index?: number | undefined;
|
|
3995
|
+
type: "file_citation";
|
|
3996
|
+
};
|
|
3997
|
+
|
|
3998
|
+
/**
|
|
3999
|
+
* @license
|
|
4000
|
+
* Copyright 2026 Google LLC
|
|
4001
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
4002
|
+
*
|
|
4003
|
+
* g3-prettier-ignore-file
|
|
4004
|
+
*/
|
|
4005
|
+
/**
|
|
4006
|
+
* Content of a single file in the codebase.
|
|
4007
|
+
*/
|
|
4008
|
+
declare type FileContent = {
|
|
3806
4009
|
/**
|
|
3807
|
-
*
|
|
4010
|
+
* The UTF-8 encoded text content of the file.
|
|
3808
4011
|
*/
|
|
3809
|
-
|
|
4012
|
+
content?: string | undefined;
|
|
4013
|
+
/**
|
|
4014
|
+
* The relative path of the file from the project root.
|
|
4015
|
+
*/
|
|
4016
|
+
path?: string | undefined;
|
|
3810
4017
|
};
|
|
3811
4018
|
|
|
3812
4019
|
/** 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. */
|
|
@@ -3962,19 +4169,19 @@ export declare interface FileSearch {
|
|
|
3962
4169
|
* A tool that can be used by the model to search files.
|
|
3963
4170
|
*/
|
|
3964
4171
|
declare type FileSearch_2 = {
|
|
3965
|
-
type: "file_search";
|
|
3966
4172
|
/**
|
|
3967
4173
|
* The file search store names to search.
|
|
3968
4174
|
*/
|
|
3969
4175
|
file_search_store_names?: Array<string> | undefined;
|
|
3970
|
-
/**
|
|
3971
|
-
* The number of semantic retrieval chunks to retrieve.
|
|
3972
|
-
*/
|
|
3973
|
-
top_k?: number | undefined;
|
|
3974
4176
|
/**
|
|
3975
4177
|
* Metadata filter to apply to the semantic retrieval documents and chunks.
|
|
3976
4178
|
*/
|
|
3977
4179
|
metadata_filter?: string | undefined;
|
|
4180
|
+
/**
|
|
4181
|
+
* The number of semantic retrieval chunks to retrieve.
|
|
4182
|
+
*/
|
|
4183
|
+
top_k?: number | undefined;
|
|
4184
|
+
type: "file_search";
|
|
3978
4185
|
};
|
|
3979
4186
|
|
|
3980
4187
|
declare type FileSearchCall$ = FileSearchCallDelta;
|
|
@@ -3987,11 +4194,11 @@ declare type FileSearchCall$ = FileSearchCallDelta;
|
|
|
3987
4194
|
* g3-prettier-ignore-file
|
|
3988
4195
|
*/
|
|
3989
4196
|
declare type FileSearchCallDelta = {
|
|
3990
|
-
type: "file_search_call";
|
|
3991
4197
|
/**
|
|
3992
4198
|
* A signature hash for backend validation.
|
|
3993
4199
|
*/
|
|
3994
4200
|
signature?: string | undefined;
|
|
4201
|
+
type: "file_search_call";
|
|
3995
4202
|
};
|
|
3996
4203
|
|
|
3997
4204
|
declare type FileSearchCallStep$ = FileSearchCallStep;
|
|
@@ -4007,7 +4214,6 @@ declare type FileSearchCallStep$ = FileSearchCallStep;
|
|
|
4007
4214
|
* File Search call step.
|
|
4008
4215
|
*/
|
|
4009
4216
|
declare type FileSearchCallStep = {
|
|
4010
|
-
type: "file_search_call";
|
|
4011
4217
|
/**
|
|
4012
4218
|
* Required. A unique ID for this specific tool call.
|
|
4013
4219
|
*/
|
|
@@ -4016,6 +4222,7 @@ declare type FileSearchCallStep = {
|
|
|
4016
4222
|
* A signature hash for backend validation.
|
|
4017
4223
|
*/
|
|
4018
4224
|
signature?: string | undefined;
|
|
4225
|
+
type: "file_search_call";
|
|
4019
4226
|
};
|
|
4020
4227
|
|
|
4021
4228
|
declare type FileSearchResult$ = FileSearchResultDelta;
|
|
@@ -4033,12 +4240,12 @@ declare type FileSearchResult$ = FileSearchResultDelta;
|
|
|
4033
4240
|
declare type FileSearchResult = {};
|
|
4034
4241
|
|
|
4035
4242
|
declare type FileSearchResultDelta = {
|
|
4036
|
-
type: "file_search_result";
|
|
4037
4243
|
result: Array<FileSearchResult>;
|
|
4038
4244
|
/**
|
|
4039
4245
|
* A signature hash for backend validation.
|
|
4040
4246
|
*/
|
|
4041
4247
|
signature?: string | undefined;
|
|
4248
|
+
type: "file_search_result";
|
|
4042
4249
|
};
|
|
4043
4250
|
|
|
4044
4251
|
declare type FileSearchResultStep$ = FileSearchResultStep;
|
|
@@ -4054,7 +4261,6 @@ declare type FileSearchResultStep$ = FileSearchResultStep;
|
|
|
4054
4261
|
* File Search result step.
|
|
4055
4262
|
*/
|
|
4056
4263
|
declare type FileSearchResultStep = {
|
|
4057
|
-
type: "file_search_result";
|
|
4058
4264
|
/**
|
|
4059
4265
|
* Required. ID to match the ID from the function call block.
|
|
4060
4266
|
*/
|
|
@@ -4063,6 +4269,7 @@ declare type FileSearchResultStep = {
|
|
|
4063
4269
|
* A signature hash for backend validation.
|
|
4064
4270
|
*/
|
|
4065
4271
|
signature?: string | undefined;
|
|
4272
|
+
type: "file_search_result";
|
|
4066
4273
|
};
|
|
4067
4274
|
|
|
4068
4275
|
/** A collection of Documents. */
|
|
@@ -4239,6 +4446,10 @@ export declare interface FileStatus {
|
|
|
4239
4446
|
* Config for filters.
|
|
4240
4447
|
*/
|
|
4241
4448
|
declare type Filter = {
|
|
4449
|
+
/**
|
|
4450
|
+
* Optional. String for metadata filtering.
|
|
4451
|
+
*/
|
|
4452
|
+
metadata_filter?: string | undefined;
|
|
4242
4453
|
/**
|
|
4243
4454
|
* Optional. Only returns contexts with vector distance smaller than the
|
|
4244
4455
|
*
|
|
@@ -4253,10 +4464,40 @@ declare type Filter = {
|
|
|
4253
4464
|
* threshold.
|
|
4254
4465
|
*/
|
|
4255
4466
|
vector_similarity_threshold?: number | undefined;
|
|
4467
|
+
};
|
|
4468
|
+
|
|
4469
|
+
declare type FindRequest$ = FindRequest;
|
|
4470
|
+
|
|
4471
|
+
/**
|
|
4472
|
+
* Request parameters specific to FIND sessions, used for discovering
|
|
4473
|
+
*
|
|
4474
|
+
* @remarks
|
|
4475
|
+
* vulnerabilities in a codebase.
|
|
4476
|
+
*/
|
|
4477
|
+
declare type FindRequest = {
|
|
4256
4478
|
/**
|
|
4257
|
-
*
|
|
4479
|
+
* Additional context or custom instructions provided by the user to guide
|
|
4480
|
+
*
|
|
4481
|
+
* @remarks
|
|
4482
|
+
* the vulnerability analysis.
|
|
4258
4483
|
*/
|
|
4259
|
-
|
|
4484
|
+
description?: string | undefined;
|
|
4485
|
+
/**
|
|
4486
|
+
* The identifier of a specific finding to verify. This is primarily used in
|
|
4487
|
+
*
|
|
4488
|
+
* @remarks
|
|
4489
|
+
* VERIFY mode to focus the agent's execution-based validation on a single
|
|
4490
|
+
* vulnerability.
|
|
4491
|
+
*/
|
|
4492
|
+
finding_id?: string | undefined;
|
|
4493
|
+
/**
|
|
4494
|
+
* The mode of the find session.
|
|
4495
|
+
*/
|
|
4496
|
+
mode?: Mode | undefined;
|
|
4497
|
+
/**
|
|
4498
|
+
* A list of source files to provide as context for the scan.
|
|
4499
|
+
*/
|
|
4500
|
+
source_files?: Array<FileContent> | undefined;
|
|
4260
4501
|
};
|
|
4261
4502
|
|
|
4262
4503
|
/** Output only. The reason why the model stopped generating tokens.
|
|
@@ -4333,6 +4574,38 @@ export declare enum FinishReason {
|
|
|
4333
4574
|
IMAGE_OTHER = "IMAGE_OTHER"
|
|
4334
4575
|
}
|
|
4335
4576
|
|
|
4577
|
+
declare type FixRequest$ = FixRequest;
|
|
4578
|
+
|
|
4579
|
+
/**
|
|
4580
|
+
* Request parameters specific to FIX sessions, used for generating and
|
|
4581
|
+
*
|
|
4582
|
+
* @remarks
|
|
4583
|
+
* validating security patches.
|
|
4584
|
+
*/
|
|
4585
|
+
declare type FixRequest = {
|
|
4586
|
+
/**
|
|
4587
|
+
* Additional context or custom instructions provided by the user to guide
|
|
4588
|
+
*
|
|
4589
|
+
* @remarks
|
|
4590
|
+
* the patch generation process.
|
|
4591
|
+
*/
|
|
4592
|
+
description?: string | undefined;
|
|
4593
|
+
/**
|
|
4594
|
+
* The identifier of the specific security finding to be remediated. This ID
|
|
4595
|
+
*
|
|
4596
|
+
* @remarks
|
|
4597
|
+
* maps to a previously discovered vulnerability.
|
|
4598
|
+
*/
|
|
4599
|
+
finding_id?: string | undefined;
|
|
4600
|
+
/**
|
|
4601
|
+
* A list of source files providing context for the remediation. These files
|
|
4602
|
+
*
|
|
4603
|
+
* @remarks
|
|
4604
|
+
* are typically the ones containing the identified vulnerability.
|
|
4605
|
+
*/
|
|
4606
|
+
source_files?: Array<FileContent> | undefined;
|
|
4607
|
+
};
|
|
4608
|
+
|
|
4336
4609
|
/** Tuning Spec for Full Fine Tuning. This data type is not supported in Gemini API. */
|
|
4337
4610
|
export declare interface FullFineTuningSpec {
|
|
4338
4611
|
/** Optional. Hyperparameters for Full Fine Tuning. */
|
|
@@ -4406,11 +4679,6 @@ declare type FunctionCallStep$ = FunctionCallStep;
|
|
|
4406
4679
|
* A function tool call step.
|
|
4407
4680
|
*/
|
|
4408
4681
|
declare type FunctionCallStep = {
|
|
4409
|
-
type: "function_call";
|
|
4410
|
-
/**
|
|
4411
|
-
* Required. The name of the tool to call.
|
|
4412
|
-
*/
|
|
4413
|
-
name: string;
|
|
4414
4682
|
/**
|
|
4415
4683
|
* Required. The arguments to pass to the function.
|
|
4416
4684
|
*/
|
|
@@ -4421,6 +4689,11 @@ declare type FunctionCallStep = {
|
|
|
4421
4689
|
* Required. A unique ID for this specific tool call.
|
|
4422
4690
|
*/
|
|
4423
4691
|
id: string;
|
|
4692
|
+
/**
|
|
4693
|
+
* Required. The name of the tool to call.
|
|
4694
|
+
*/
|
|
4695
|
+
name: string;
|
|
4696
|
+
type: "function_call";
|
|
4424
4697
|
};
|
|
4425
4698
|
|
|
4426
4699
|
/** Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name, description, parameters and response type. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client. */
|
|
@@ -4437,7 +4710,7 @@ export declare interface FunctionDeclaration {
|
|
|
4437
4710
|
response?: Schema;
|
|
4438
4711
|
/** Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function. This field is mutually exclusive with `response`. */
|
|
4439
4712
|
responseJsonSchema?: unknown;
|
|
4440
|
-
/** Optional. Specifies the function Behavior.
|
|
4713
|
+
/** Optional. Specifies the function Behavior. If not specified, the system keeps the current function call behavior. This field is currently only supported by the BidiGenerateContent method. */
|
|
4441
4714
|
behavior?: Behavior;
|
|
4442
4715
|
}
|
|
4443
4716
|
|
|
@@ -4509,14 +4782,14 @@ export declare enum FunctionResponseScheduling {
|
|
|
4509
4782
|
declare type FunctionResult$ = FunctionResultDelta;
|
|
4510
4783
|
|
|
4511
4784
|
declare type FunctionResultDelta = {
|
|
4512
|
-
type: "function_result";
|
|
4513
|
-
name?: string | undefined;
|
|
4514
|
-
is_error?: boolean | undefined;
|
|
4515
4785
|
/**
|
|
4516
4786
|
* Required. ID to match the ID from the function call block.
|
|
4517
4787
|
*/
|
|
4518
4788
|
call_id: string;
|
|
4789
|
+
is_error?: boolean | undefined;
|
|
4790
|
+
name?: string | undefined;
|
|
4519
4791
|
result: FunctionResultDeltaResult | Array<FunctionResultSubcontent> | string;
|
|
4792
|
+
type: "function_result";
|
|
4520
4793
|
};
|
|
4521
4794
|
|
|
4522
4795
|
declare type FunctionResultDeltaResult = {};
|
|
@@ -4529,23 +4802,23 @@ declare type FunctionResultStep$ = FunctionResultStep;
|
|
|
4529
4802
|
* Result of a function tool call.
|
|
4530
4803
|
*/
|
|
4531
4804
|
declare type FunctionResultStep = {
|
|
4532
|
-
type: "function_result";
|
|
4533
4805
|
/**
|
|
4534
|
-
*
|
|
4806
|
+
* Required. ID to match the ID from the function call block.
|
|
4535
4807
|
*/
|
|
4536
|
-
|
|
4808
|
+
call_id: string;
|
|
4537
4809
|
/**
|
|
4538
4810
|
* Whether the tool call resulted in an error.
|
|
4539
4811
|
*/
|
|
4540
4812
|
is_error?: boolean | undefined;
|
|
4541
4813
|
/**
|
|
4542
|
-
*
|
|
4814
|
+
* The name of the tool that was called.
|
|
4543
4815
|
*/
|
|
4544
|
-
|
|
4816
|
+
name?: string | undefined;
|
|
4545
4817
|
/**
|
|
4546
4818
|
* The result of the tool call.
|
|
4547
4819
|
*/
|
|
4548
4820
|
result: FunctionResultStepResult | Array<FunctionResultSubcontent> | string;
|
|
4821
|
+
type: "function_result";
|
|
4549
4822
|
};
|
|
4550
4823
|
|
|
4551
4824
|
declare type FunctionResultStepResult = {};
|
|
@@ -4568,19 +4841,19 @@ declare type FunctionResultSubcontent = TextContent | ImageContent;
|
|
|
4568
4841
|
* A tool that can be used by the model.
|
|
4569
4842
|
*/
|
|
4570
4843
|
declare type FunctionT = {
|
|
4571
|
-
type: "function";
|
|
4572
|
-
/**
|
|
4573
|
-
* The name of the function.
|
|
4574
|
-
*/
|
|
4575
|
-
name?: string | undefined;
|
|
4576
4844
|
/**
|
|
4577
4845
|
* A description of the function.
|
|
4578
4846
|
*/
|
|
4579
4847
|
description?: string | undefined;
|
|
4848
|
+
/**
|
|
4849
|
+
* The name of the function.
|
|
4850
|
+
*/
|
|
4851
|
+
name?: string | undefined;
|
|
4580
4852
|
/**
|
|
4581
4853
|
* The JSON Schema for the function's parameters.
|
|
4582
4854
|
*/
|
|
4583
4855
|
parameters?: any | undefined;
|
|
4856
|
+
type: "function";
|
|
4584
4857
|
};
|
|
4585
4858
|
|
|
4586
4859
|
/** The Google Cloud Storage location for the input content. This data type is not supported in Gemini API. */
|
|
@@ -4623,6 +4896,20 @@ declare class GeminiNextGenInteractions {
|
|
|
4623
4896
|
private getClient;
|
|
4624
4897
|
}
|
|
4625
4898
|
|
|
4899
|
+
declare class GeminiNextGenTriggers {
|
|
4900
|
+
private readonly parentClient;
|
|
4901
|
+
private sdk;
|
|
4902
|
+
constructor(parentClient: GoogleGenAIParentClient);
|
|
4903
|
+
create(params: CreateTriggerParams, options?: GoogleGenAIRequestOptions): Promise<triggers.Trigger>;
|
|
4904
|
+
list(params?: ListTriggersParams_2 | null | undefined, options?: GoogleGenAIRequestOptions): Promise<triggers.ListTriggersResponse>;
|
|
4905
|
+
get(id: string, params?: GetTriggerParams | null | undefined, options?: GoogleGenAIRequestOptions): Promise<triggers.Trigger>;
|
|
4906
|
+
update(id: string, params: UpdateTriggerParams, options?: GoogleGenAIRequestOptions): Promise<triggers.Trigger>;
|
|
4907
|
+
delete(id: string, params?: DeleteTriggerParams | null | undefined, options?: GoogleGenAIRequestOptions): Promise<interactions.Empty>;
|
|
4908
|
+
run(trigger_id: string, params?: RunTriggerParams | null | undefined, options?: GoogleGenAIRequestOptions): Promise<triggers.TriggerExecution>;
|
|
4909
|
+
listExecutions(trigger_id: string, params?: ListTriggerExecutionsParams_2 | null | undefined, options?: GoogleGenAIRequestOptions): Promise<triggers.ListTriggerExecutionsResponse>;
|
|
4910
|
+
private getClient;
|
|
4911
|
+
}
|
|
4912
|
+
|
|
4626
4913
|
declare class GeminiNextGenWebhooks {
|
|
4627
4914
|
private readonly parentClient;
|
|
4628
4915
|
private sdk;
|
|
@@ -5287,11 +5574,11 @@ export declare interface GenerationConfig {
|
|
|
5287
5574
|
presencePenalty?: number;
|
|
5288
5575
|
/** Optional. If set to true, the log probabilities of the output tokens are returned. Log probabilities are the logarithm of the probability of a token appearing in the output. A higher log probability means the token is more likely to be generated. This can be useful for analyzing the model's confidence in its own output and for debugging. */
|
|
5289
5576
|
responseLogprobs?: boolean;
|
|
5290
|
-
/** Optional. The IANA standard MIME type of the response. The model will generate output that conforms to this MIME type. Supported values include 'text/plain' (default) and 'application/json'. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. */
|
|
5577
|
+
/** Optional. The IANA standard MIME type of the response. The model will generate output that conforms to this MIME type. Supported values include 'text/plain' (default) and 'application/json'. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. Deprecated: Use `response_format` instead. */
|
|
5291
5578
|
responseMimeType?: string;
|
|
5292
5579
|
/** Optional. The modalities of the response. The model will generate a response that includes all the specified modalities. For example, if this is set to `[TEXT, IMAGE]`, the response will include both text and an image. */
|
|
5293
5580
|
responseModalities?: Modality[];
|
|
5294
|
-
/** Optional. Lets you to specify a schema for the model's response, ensuring that the output conforms to a particular structure. This is useful for generating structured data such as JSON. The schema is a subset of the [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema) object. When this field is set, you must also set the `response_mime_type` to `application/json`. */
|
|
5581
|
+
/** Optional. Lets you to specify a schema for the model's response, ensuring that the output conforms to a particular structure. This is useful for generating structured data such as JSON. The schema is a subset of the [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema) object. When this field is set, you must also set the `response_mime_type` to `application/json`. Deprecated: Use `response_format` instead. */
|
|
5295
5582
|
responseSchema?: Schema;
|
|
5296
5583
|
/** Optional. Routing configuration. This field is not supported in Gemini API. */
|
|
5297
5584
|
routingConfig?: GenerationConfigRoutingConfig;
|
|
@@ -5311,6 +5598,10 @@ export declare interface GenerationConfig {
|
|
|
5311
5598
|
topP?: number;
|
|
5312
5599
|
/** Optional. Enables enhanced civic answers. It may not be available for all models. This field is not supported in Vertex AI. */
|
|
5313
5600
|
enableEnhancedCivicAnswers?: boolean;
|
|
5601
|
+
/** Optional. New response format field for the model to configure output formatting and delivery. */
|
|
5602
|
+
responseFormat?: ResponseFormat[];
|
|
5603
|
+
/** Optional. Config for translation. This field is not supported in Vertex AI. */
|
|
5604
|
+
translationConfig?: TranslationConfig;
|
|
5314
5605
|
}
|
|
5315
5606
|
|
|
5316
5607
|
/**
|
|
@@ -5318,61 +5609,45 @@ export declare interface GenerationConfig {
|
|
|
5318
5609
|
*/
|
|
5319
5610
|
declare type GenerationConfig_2 = {
|
|
5320
5611
|
/**
|
|
5321
|
-
*
|
|
5612
|
+
* The configuration for image interaction.
|
|
5613
|
+
*
|
|
5614
|
+
* @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
|
|
5322
5615
|
*/
|
|
5323
|
-
|
|
5616
|
+
image_config?: ImageConfig_2 | undefined;
|
|
5324
5617
|
/**
|
|
5325
|
-
* The maximum
|
|
5618
|
+
* The maximum number of tokens to include in the response.
|
|
5326
5619
|
*/
|
|
5327
|
-
|
|
5620
|
+
max_output_tokens?: number | undefined;
|
|
5328
5621
|
/**
|
|
5329
5622
|
* Seed used in decoding for reproducibility.
|
|
5330
5623
|
*/
|
|
5331
5624
|
seed?: number | undefined;
|
|
5332
|
-
/**
|
|
5333
|
-
* A list of character sequences that will stop output interaction.
|
|
5334
|
-
*/
|
|
5335
|
-
stop_sequences?: Array<string> | undefined;
|
|
5336
|
-
thinking_level?: ThinkingLevel_2 | undefined;
|
|
5337
|
-
thinking_summaries?: ThinkingSummaries | undefined;
|
|
5338
|
-
/**
|
|
5339
|
-
* The maximum number of tokens to include in the response.
|
|
5340
|
-
*/
|
|
5341
|
-
max_output_tokens?: number | undefined;
|
|
5342
5625
|
/**
|
|
5343
5626
|
* Configuration for speech interaction.
|
|
5344
5627
|
*/
|
|
5345
5628
|
speech_config?: Array<SpeechConfig_2> | undefined;
|
|
5346
5629
|
/**
|
|
5347
|
-
*
|
|
5348
|
-
*
|
|
5349
|
-
* @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
|
|
5630
|
+
* A list of character sequences that will stop output interaction.
|
|
5350
5631
|
*/
|
|
5351
|
-
|
|
5632
|
+
stop_sequences?: Array<string> | undefined;
|
|
5352
5633
|
/**
|
|
5353
|
-
*
|
|
5634
|
+
* Controls the randomness of the output.
|
|
5354
5635
|
*/
|
|
5355
|
-
|
|
5636
|
+
temperature?: number | undefined;
|
|
5637
|
+
thinking_level?: ThinkingLevel_2 | undefined;
|
|
5638
|
+
thinking_summaries?: ThinkingSummaries | undefined;
|
|
5356
5639
|
/**
|
|
5357
|
-
*
|
|
5358
|
-
*
|
|
5359
|
-
* @remarks
|
|
5360
|
-
* text. A positive value encourages the model to generate more diverse and
|
|
5361
|
-
* less repetitive text. Valid values can range from [-2.0, 2.0].
|
|
5640
|
+
* The tool choice configuration.
|
|
5362
5641
|
*/
|
|
5363
|
-
|
|
5642
|
+
tool_choice?: ToolChoiceType | ToolChoiceConfig | undefined;
|
|
5364
5643
|
/**
|
|
5365
|
-
*
|
|
5366
|
-
*
|
|
5367
|
-
* @remarks
|
|
5368
|
-
* A positive value helps to reduce the repetition of words and phrases.
|
|
5369
|
-
* Valid values can range from [-2.0, 2.0].
|
|
5644
|
+
* The maximum cumulative probability of tokens to consider when sampling.
|
|
5370
5645
|
*/
|
|
5371
|
-
|
|
5646
|
+
top_p?: number | undefined;
|
|
5372
5647
|
/**
|
|
5373
|
-
*
|
|
5648
|
+
* Configuration options for video generation.
|
|
5374
5649
|
*/
|
|
5375
|
-
|
|
5650
|
+
video_config?: VideoConfig | undefined;
|
|
5376
5651
|
};
|
|
5377
5652
|
|
|
5378
5653
|
/** The configuration for routing the request to a specific model. This can be used to control which model is used for the generation, either automatically or by specifying a model name. This data type is not supported in Gemini API. */
|
|
@@ -5598,6 +5873,19 @@ export declare interface GetOperationParameters {
|
|
|
5598
5873
|
config?: GetOperationConfig;
|
|
5599
5874
|
}
|
|
5600
5875
|
|
|
5876
|
+
declare type GetTriggerParams = Omit<GetTriggerRequest, "id">;
|
|
5877
|
+
|
|
5878
|
+
declare type GetTriggerRequest = {
|
|
5879
|
+
/**
|
|
5880
|
+
* Which version of the API to use.
|
|
5881
|
+
*/
|
|
5882
|
+
api_version?: string | undefined;
|
|
5883
|
+
/**
|
|
5884
|
+
* Resource name of the trigger.
|
|
5885
|
+
*/
|
|
5886
|
+
id: string;
|
|
5887
|
+
};
|
|
5888
|
+
|
|
5601
5889
|
/** Optional parameters for tunings.get method. */
|
|
5602
5890
|
export declare interface GetTuningJobConfig {
|
|
5603
5891
|
/** Used to override HTTP request options. */
|
|
@@ -5694,10 +5982,12 @@ export declare class GoogleGenAI {
|
|
|
5694
5982
|
private _webhooks;
|
|
5695
5983
|
private _agents;
|
|
5696
5984
|
private _nextGenClient;
|
|
5985
|
+
private _triggers;
|
|
5697
5986
|
private getNextGenClient;
|
|
5698
5987
|
get interactions(): GeminiNextGenInteractions;
|
|
5699
5988
|
get webhooks(): GeminiNextGenWebhooks;
|
|
5700
5989
|
get agents(): GeminiNextGenAgents;
|
|
5990
|
+
get triggers(): GeminiNextGenTriggers;
|
|
5701
5991
|
constructor(options: GoogleGenAIOptions);
|
|
5702
5992
|
}
|
|
5703
5993
|
|
|
@@ -5792,6 +6082,7 @@ declare interface GoogleGenAIParentClient {
|
|
|
5792
6082
|
getBaseUrl(): string;
|
|
5793
6083
|
getApiVersion(): string;
|
|
5794
6084
|
getDefaultHeaders?(): Record<string, string>;
|
|
6085
|
+
getHeaders?(): Record<string, string> | undefined;
|
|
5795
6086
|
getAuthHeaders(url?: string): Headers | Promise<Headers>;
|
|
5796
6087
|
}
|
|
5797
6088
|
|
|
@@ -5835,7 +6126,6 @@ export declare interface GoogleMaps {
|
|
|
5835
6126
|
* A tool that can be used by the model to call Google Maps.
|
|
5836
6127
|
*/
|
|
5837
6128
|
declare type GoogleMaps_2 = {
|
|
5838
|
-
type: "google_maps";
|
|
5839
6129
|
/**
|
|
5840
6130
|
* Whether to return a widget context token in the tool call result of the
|
|
5841
6131
|
*
|
|
@@ -5851,6 +6141,7 @@ declare type GoogleMaps_2 = {
|
|
|
5851
6141
|
* The longitude of the user's location.
|
|
5852
6142
|
*/
|
|
5853
6143
|
longitude?: number | undefined;
|
|
6144
|
+
type: "google_maps";
|
|
5854
6145
|
};
|
|
5855
6146
|
|
|
5856
6147
|
declare type GoogleMapsCall$ = GoogleMapsCallDelta;
|
|
@@ -5875,7 +6166,6 @@ declare type GoogleMapsCallArguments = {
|
|
|
5875
6166
|
};
|
|
5876
6167
|
|
|
5877
6168
|
declare type GoogleMapsCallDelta = {
|
|
5878
|
-
type: "google_maps_call";
|
|
5879
6169
|
/**
|
|
5880
6170
|
* The arguments to pass to the Google Maps tool.
|
|
5881
6171
|
*/
|
|
@@ -5884,6 +6174,7 @@ declare type GoogleMapsCallDelta = {
|
|
|
5884
6174
|
* A signature hash for backend validation.
|
|
5885
6175
|
*/
|
|
5886
6176
|
signature?: string | undefined;
|
|
6177
|
+
type: "google_maps_call";
|
|
5887
6178
|
};
|
|
5888
6179
|
|
|
5889
6180
|
declare type GoogleMapsCallStep$ = GoogleMapsCallStep;
|
|
@@ -5892,7 +6183,6 @@ declare type GoogleMapsCallStep$ = GoogleMapsCallStep;
|
|
|
5892
6183
|
* Google Maps call step.
|
|
5893
6184
|
*/
|
|
5894
6185
|
declare type GoogleMapsCallStep = {
|
|
5895
|
-
type: "google_maps_call";
|
|
5896
6186
|
/**
|
|
5897
6187
|
* The arguments to pass to the Google Maps tool.
|
|
5898
6188
|
*/
|
|
@@ -5905,6 +6195,7 @@ declare type GoogleMapsCallStep = {
|
|
|
5905
6195
|
* A signature hash for backend validation.
|
|
5906
6196
|
*/
|
|
5907
6197
|
signature?: string | undefined;
|
|
6198
|
+
type: "google_maps_call";
|
|
5908
6199
|
};
|
|
5909
6200
|
|
|
5910
6201
|
declare type GoogleMapsResult$ = GoogleMapsResult;
|
|
@@ -5920,7 +6211,6 @@ declare type GoogleMapsResult = {
|
|
|
5920
6211
|
};
|
|
5921
6212
|
|
|
5922
6213
|
declare type GoogleMapsResultDelta = {
|
|
5923
|
-
type: "google_maps_result";
|
|
5924
6214
|
/**
|
|
5925
6215
|
* The results of the Google Maps.
|
|
5926
6216
|
*/
|
|
@@ -5929,13 +6219,14 @@ declare type GoogleMapsResultDelta = {
|
|
|
5929
6219
|
* A signature hash for backend validation.
|
|
5930
6220
|
*/
|
|
5931
6221
|
signature?: string | undefined;
|
|
6222
|
+
type: "google_maps_result";
|
|
5932
6223
|
};
|
|
5933
6224
|
|
|
5934
6225
|
declare type GoogleMapsResultPlaces = {
|
|
5935
|
-
place_id?: string | undefined;
|
|
5936
6226
|
name?: string | undefined;
|
|
5937
|
-
|
|
6227
|
+
place_id?: string | undefined;
|
|
5938
6228
|
review_snippets?: Array<ReviewSnippet> | undefined;
|
|
6229
|
+
url?: string | undefined;
|
|
5939
6230
|
};
|
|
5940
6231
|
|
|
5941
6232
|
declare type GoogleMapsResultStep$ = GoogleMapsResultStep;
|
|
@@ -5944,16 +6235,16 @@ declare type GoogleMapsResultStep$ = GoogleMapsResultStep;
|
|
|
5944
6235
|
* Google Maps result step.
|
|
5945
6236
|
*/
|
|
5946
6237
|
declare type GoogleMapsResultStep = {
|
|
5947
|
-
type: "google_maps_result";
|
|
5948
|
-
result: Array<GoogleMapsResult>;
|
|
5949
6238
|
/**
|
|
5950
6239
|
* Required. ID to match the ID from the function call block.
|
|
5951
6240
|
*/
|
|
5952
6241
|
call_id: string;
|
|
6242
|
+
result: Array<GoogleMapsResult>;
|
|
5953
6243
|
/**
|
|
5954
6244
|
* A signature hash for backend validation.
|
|
5955
6245
|
*/
|
|
5956
6246
|
signature?: string | undefined;
|
|
6247
|
+
type: "google_maps_result";
|
|
5957
6248
|
};
|
|
5958
6249
|
|
|
5959
6250
|
/** 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. */
|
|
@@ -5984,11 +6275,11 @@ export declare interface GoogleSearch {
|
|
|
5984
6275
|
* A tool that can be used by the model to search Google.
|
|
5985
6276
|
*/
|
|
5986
6277
|
declare type GoogleSearch_2 = {
|
|
5987
|
-
type: "google_search";
|
|
5988
6278
|
/**
|
|
5989
6279
|
* The types of search grounding to enable.
|
|
5990
6280
|
*/
|
|
5991
6281
|
search_types?: Array<GoogleSearchSearchType> | undefined;
|
|
6282
|
+
type: "google_search";
|
|
5992
6283
|
};
|
|
5993
6284
|
|
|
5994
6285
|
declare type GoogleSearchCall$ = GoogleSearchCallDelta;
|
|
@@ -6013,7 +6304,6 @@ declare type GoogleSearchCallArguments = {
|
|
|
6013
6304
|
};
|
|
6014
6305
|
|
|
6015
6306
|
declare type GoogleSearchCallDelta = {
|
|
6016
|
-
type: "google_search_call";
|
|
6017
6307
|
/**
|
|
6018
6308
|
* The arguments to pass to Google Search.
|
|
6019
6309
|
*/
|
|
@@ -6022,6 +6312,7 @@ declare type GoogleSearchCallDelta = {
|
|
|
6022
6312
|
* A signature hash for backend validation.
|
|
6023
6313
|
*/
|
|
6024
6314
|
signature?: string | undefined;
|
|
6315
|
+
type: "google_search_call";
|
|
6025
6316
|
};
|
|
6026
6317
|
|
|
6027
6318
|
declare type GoogleSearchCallStep$ = GoogleSearchCallStep;
|
|
@@ -6030,23 +6321,23 @@ declare type GoogleSearchCallStep$ = GoogleSearchCallStep;
|
|
|
6030
6321
|
* Google Search call step.
|
|
6031
6322
|
*/
|
|
6032
6323
|
declare type GoogleSearchCallStep = {
|
|
6033
|
-
type: "google_search_call";
|
|
6034
6324
|
/**
|
|
6035
6325
|
* The arguments to pass to Google Search.
|
|
6036
6326
|
*/
|
|
6037
6327
|
arguments: GoogleSearchCallArguments;
|
|
6038
|
-
/**
|
|
6039
|
-
* The type of search grounding enabled.
|
|
6040
|
-
*/
|
|
6041
|
-
search_type?: GoogleSearchCallStepSearchType | undefined;
|
|
6042
6328
|
/**
|
|
6043
6329
|
* Required. A unique ID for this specific tool call.
|
|
6044
6330
|
*/
|
|
6045
6331
|
id: string;
|
|
6332
|
+
/**
|
|
6333
|
+
* The type of search grounding enabled.
|
|
6334
|
+
*/
|
|
6335
|
+
search_type?: GoogleSearchCallStepSearchType | undefined;
|
|
6046
6336
|
/**
|
|
6047
6337
|
* A signature hash for backend validation.
|
|
6048
6338
|
*/
|
|
6049
6339
|
signature?: string | undefined;
|
|
6340
|
+
type: "google_search_call";
|
|
6050
6341
|
};
|
|
6051
6342
|
|
|
6052
6343
|
/**
|
|
@@ -6076,13 +6367,13 @@ declare type GoogleSearchResult = {
|
|
|
6076
6367
|
};
|
|
6077
6368
|
|
|
6078
6369
|
declare type GoogleSearchResultDelta = {
|
|
6079
|
-
type: "google_search_result";
|
|
6080
|
-
result: Array<GoogleSearchResult>;
|
|
6081
6370
|
is_error?: boolean | undefined;
|
|
6371
|
+
result: Array<GoogleSearchResult>;
|
|
6082
6372
|
/**
|
|
6083
6373
|
* A signature hash for backend validation.
|
|
6084
6374
|
*/
|
|
6085
6375
|
signature?: string | undefined;
|
|
6376
|
+
type: "google_search_result";
|
|
6086
6377
|
};
|
|
6087
6378
|
|
|
6088
6379
|
declare type GoogleSearchResultStep$ = GoogleSearchResultStep;
|
|
@@ -6091,23 +6382,23 @@ declare type GoogleSearchResultStep$ = GoogleSearchResultStep;
|
|
|
6091
6382
|
* Google Search result step.
|
|
6092
6383
|
*/
|
|
6093
6384
|
declare type GoogleSearchResultStep = {
|
|
6094
|
-
type: "google_search_result";
|
|
6095
6385
|
/**
|
|
6096
|
-
* Required.
|
|
6386
|
+
* Required. ID to match the ID from the function call block.
|
|
6097
6387
|
*/
|
|
6098
|
-
|
|
6388
|
+
call_id: string;
|
|
6099
6389
|
/**
|
|
6100
6390
|
* Whether the Google Search resulted in an error.
|
|
6101
6391
|
*/
|
|
6102
6392
|
is_error?: boolean | undefined;
|
|
6103
6393
|
/**
|
|
6104
|
-
* Required.
|
|
6394
|
+
* Required. The results of the Google Search.
|
|
6105
6395
|
*/
|
|
6106
|
-
|
|
6396
|
+
result: Array<GoogleSearchResult>;
|
|
6107
6397
|
/**
|
|
6108
6398
|
* A signature hash for backend validation.
|
|
6109
6399
|
*/
|
|
6110
6400
|
signature?: string | undefined;
|
|
6401
|
+
type: "google_search_result";
|
|
6111
6402
|
};
|
|
6112
6403
|
|
|
6113
6404
|
/** Tool to retrieve public web data for grounding, powered by Google. */
|
|
@@ -6310,7 +6601,7 @@ export declare interface GroundingMetadata {
|
|
|
6310
6601
|
searchEntryPoint?: SearchEntryPoint;
|
|
6311
6602
|
/** Web search queries for the following-up web search. */
|
|
6312
6603
|
webSearchQueries?: string[];
|
|
6313
|
-
/** 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. */
|
|
6604
|
+
/** Optional. Output only. Deprecated: The Google Maps contextual widget behavior in Grounding with Google Maps is being deprecated; this field is planned for removal and will no longer be populated once removed. 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. */
|
|
6314
6605
|
googleMapsWidgetContextToken?: string;
|
|
6315
6606
|
/** 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. */
|
|
6316
6607
|
retrievalQueries?: string[];
|
|
@@ -6350,14 +6641,14 @@ declare type GroundingToolCount$ = GroundingToolCount;
|
|
|
6350
6641
|
* The number of grounding tool counts.
|
|
6351
6642
|
*/
|
|
6352
6643
|
declare type GroundingToolCount = {
|
|
6353
|
-
/**
|
|
6354
|
-
* The grounding tool type associated with the count.
|
|
6355
|
-
*/
|
|
6356
|
-
type?: GroundingToolCountType | undefined;
|
|
6357
6644
|
/**
|
|
6358
6645
|
* The number of grounding tool counts.
|
|
6359
6646
|
*/
|
|
6360
6647
|
count?: number | undefined;
|
|
6648
|
+
/**
|
|
6649
|
+
* The grounding tool type associated with the count.
|
|
6650
|
+
*/
|
|
6651
|
+
type?: GroundingToolCountType | undefined;
|
|
6361
6652
|
};
|
|
6362
6653
|
|
|
6363
6654
|
/**
|
|
@@ -6416,6 +6707,8 @@ export declare enum HarmBlockThreshold {
|
|
|
6416
6707
|
OFF = "OFF"
|
|
6417
6708
|
}
|
|
6418
6709
|
|
|
6710
|
+
declare type HarmCategory$ = HarmCategory_2;
|
|
6711
|
+
|
|
6419
6712
|
/** The harm category to be blocked. */
|
|
6420
6713
|
export declare enum HarmCategory {
|
|
6421
6714
|
/**
|
|
@@ -6464,6 +6757,15 @@ export declare enum HarmCategory {
|
|
|
6464
6757
|
HARM_CATEGORY_JAILBREAK = "HARM_CATEGORY_JAILBREAK"
|
|
6465
6758
|
}
|
|
6466
6759
|
|
|
6760
|
+
/**
|
|
6761
|
+
* @license
|
|
6762
|
+
* Copyright 2026 Google LLC
|
|
6763
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
6764
|
+
*
|
|
6765
|
+
* g3-prettier-ignore-file
|
|
6766
|
+
*/
|
|
6767
|
+
declare type HarmCategory_2 = "hate_speech" | "dangerous_content" | "harassment" | "sexually_explicit" | "civic_integrity" | "image_hate" | "image_dangerous_content" | "image_harassment" | "image_sexually_explicit" | "jailbreak" | (string & {});
|
|
6768
|
+
|
|
6467
6769
|
/** Output only. The probability of harm for this category. */
|
|
6468
6770
|
export declare enum HarmProbability {
|
|
6469
6771
|
/**
|
|
@@ -6512,6 +6814,16 @@ export declare enum HarmSeverity {
|
|
|
6512
6814
|
HARM_SEVERITY_HIGH = "HARM_SEVERITY_HIGH"
|
|
6513
6815
|
}
|
|
6514
6816
|
|
|
6817
|
+
/** Configuration for history exchange between client and server. */
|
|
6818
|
+
export declare interface HistoryConfig {
|
|
6819
|
+
/** If true, after sending `setup_complete`, the server will wait
|
|
6820
|
+
and at first process `client_content` messages until `turn_complete` is
|
|
6821
|
+
`true`. This initial history will not trigger a model call and
|
|
6822
|
+
may end with model content. After `turn_complete` is `true`, the client
|
|
6823
|
+
can start the realtime conversation via `realtime_input`. */
|
|
6824
|
+
initialHistoryInClientContent?: boolean;
|
|
6825
|
+
}
|
|
6826
|
+
|
|
6515
6827
|
/** The location of the API key. This enum is not supported in Gemini API. */
|
|
6516
6828
|
export declare enum HttpElementLocation {
|
|
6517
6829
|
HTTP_IN_UNSPECIFIED = "HTTP_IN_UNSPECIFIED",
|
|
@@ -6723,20 +7035,20 @@ declare type ImageContent$ = ImageContent;
|
|
|
6723
7035
|
* An image content block.
|
|
6724
7036
|
*/
|
|
6725
7037
|
declare type ImageContent = {
|
|
6726
|
-
type: "image";
|
|
6727
7038
|
/**
|
|
6728
7039
|
* The image content.
|
|
6729
7040
|
*/
|
|
6730
7041
|
data?: string | undefined;
|
|
6731
|
-
/**
|
|
6732
|
-
* The URI of the image.
|
|
6733
|
-
*/
|
|
6734
|
-
uri?: string | undefined;
|
|
6735
7042
|
/**
|
|
6736
7043
|
* The mime type of the image.
|
|
6737
7044
|
*/
|
|
6738
7045
|
mime_type?: ImageContentMimeType | undefined;
|
|
6739
7046
|
resolution?: MediaResolution_2 | undefined;
|
|
7047
|
+
type: "image";
|
|
7048
|
+
/**
|
|
7049
|
+
* The URI of the image.
|
|
7050
|
+
*/
|
|
7051
|
+
uri?: string | undefined;
|
|
6740
7052
|
};
|
|
6741
7053
|
|
|
6742
7054
|
/**
|
|
@@ -6745,11 +7057,11 @@ declare type ImageContent = {
|
|
|
6745
7057
|
declare type ImageContentMimeType = "image/png" | "image/jpeg" | "image/webp" | "image/heic" | "image/heif" | "image/gif" | "image/bmp" | "image/tiff" | (string & {});
|
|
6746
7058
|
|
|
6747
7059
|
declare type ImageDelta = {
|
|
6748
|
-
type: "image";
|
|
6749
7060
|
data?: string | undefined;
|
|
6750
|
-
uri?: string | undefined;
|
|
6751
7061
|
mime_type?: ImageDeltaMimeType | undefined;
|
|
6752
7062
|
resolution?: MediaResolution_2 | undefined;
|
|
7063
|
+
type: "image";
|
|
7064
|
+
uri?: string | undefined;
|
|
6753
7065
|
};
|
|
6754
7066
|
|
|
6755
7067
|
declare type ImageDeltaMimeType = "image/png" | "image/jpeg" | "image/webp" | "image/heic" | "image/heif" | "image/gif" | "image/bmp" | "image/tiff" | (string & {});
|
|
@@ -6804,31 +7116,50 @@ export declare enum ImageResizeMode {
|
|
|
6804
7116
|
PAD = "PAD"
|
|
6805
7117
|
}
|
|
6806
7118
|
|
|
6807
|
-
declare type ImageResponseFormat$ =
|
|
7119
|
+
declare type ImageResponseFormat$ = ImageResponseFormat_2;
|
|
7120
|
+
|
|
7121
|
+
/** Configuration for image-specific output formatting. */
|
|
7122
|
+
export declare class ImageResponseFormat {
|
|
7123
|
+
/** Optional. The aspect ratio for the image output. */
|
|
7124
|
+
aspectRatio?: AspectRatio;
|
|
7125
|
+
/** Optional. Delivery mode for the generated content. */
|
|
7126
|
+
delivery?: Delivery;
|
|
7127
|
+
/** Optional. The size of the image output. */
|
|
7128
|
+
imageSize?: ImageSize;
|
|
7129
|
+
/** Optional. The MIME type of the image output. */
|
|
7130
|
+
mimeType?: string;
|
|
7131
|
+
}
|
|
6808
7132
|
|
|
6809
7133
|
/**
|
|
6810
7134
|
* Configuration for image output format.
|
|
6811
7135
|
*/
|
|
6812
|
-
declare type
|
|
6813
|
-
type: "image";
|
|
7136
|
+
declare type ImageResponseFormat_2 = {
|
|
6814
7137
|
/**
|
|
6815
|
-
* The
|
|
7138
|
+
* The aspect ratio for the image output.
|
|
6816
7139
|
*/
|
|
6817
|
-
|
|
7140
|
+
aspect_ratio?: ImageResponseFormatAspectRatio | undefined;
|
|
6818
7141
|
/**
|
|
6819
7142
|
* The delivery mode for the image output.
|
|
6820
7143
|
*/
|
|
6821
7144
|
delivery?: ImageResponseFormatDelivery | undefined;
|
|
6822
|
-
/**
|
|
6823
|
-
* The aspect ratio for the image output.
|
|
6824
|
-
*/
|
|
6825
|
-
aspect_ratio?: ImageResponseFormatAspectRatio | undefined;
|
|
6826
7145
|
/**
|
|
6827
7146
|
* The size of the image output.
|
|
6828
7147
|
*/
|
|
6829
7148
|
image_size?: ImageResponseFormatImageSize | undefined;
|
|
7149
|
+
/**
|
|
7150
|
+
* The MIME type of the image output.
|
|
7151
|
+
*/
|
|
7152
|
+
mime_type?: ImageResponseFormatMimeType | undefined;
|
|
7153
|
+
type: "image";
|
|
6830
7154
|
};
|
|
6831
7155
|
|
|
7156
|
+
/**
|
|
7157
|
+
* @license
|
|
7158
|
+
* Copyright 2026 Google LLC
|
|
7159
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
7160
|
+
*
|
|
7161
|
+
* g3-prettier-ignore-file
|
|
7162
|
+
*/
|
|
6832
7163
|
/**
|
|
6833
7164
|
* The aspect ratio for the image output.
|
|
6834
7165
|
*/
|
|
@@ -6844,13 +7175,6 @@ declare type ImageResponseFormatDelivery = "inline" | "uri" | (string & {});
|
|
|
6844
7175
|
*/
|
|
6845
7176
|
declare type ImageResponseFormatImageSize = "512" | "1K" | "2K" | "4K" | (string & {});
|
|
6846
7177
|
|
|
6847
|
-
/**
|
|
6848
|
-
* @license
|
|
6849
|
-
* Copyright 2026 Google LLC
|
|
6850
|
-
* SPDX-License-Identifier: Apache-2.0
|
|
6851
|
-
*
|
|
6852
|
-
* g3-prettier-ignore-file
|
|
6853
|
-
*/
|
|
6854
7178
|
/**
|
|
6855
7179
|
* The MIME type of the image output.
|
|
6856
7180
|
*/
|
|
@@ -6860,6 +7184,30 @@ declare type ImageResponseFormatMimeType = "image/jpeg";
|
|
|
6860
7184
|
export declare interface ImageSearch {
|
|
6861
7185
|
}
|
|
6862
7186
|
|
|
7187
|
+
/** The size of the image output. */
|
|
7188
|
+
export declare enum ImageSize {
|
|
7189
|
+
/**
|
|
7190
|
+
* Default value. This value is unused.
|
|
7191
|
+
*/
|
|
7192
|
+
IMAGE_SIZE_UNSPECIFIED = "IMAGE_SIZE_UNSPECIFIED",
|
|
7193
|
+
/**
|
|
7194
|
+
* 512px image size.
|
|
7195
|
+
*/
|
|
7196
|
+
IMAGE_SIZE_FIVE_TWELVE = "IMAGE_SIZE_FIVE_TWELVE",
|
|
7197
|
+
/**
|
|
7198
|
+
* 1K image size.
|
|
7199
|
+
*/
|
|
7200
|
+
IMAGE_SIZE_ONE_K = "IMAGE_SIZE_ONE_K",
|
|
7201
|
+
/**
|
|
7202
|
+
* 2K image size.
|
|
7203
|
+
*/
|
|
7204
|
+
IMAGE_SIZE_TWO_K = "IMAGE_SIZE_TWO_K",
|
|
7205
|
+
/**
|
|
7206
|
+
* 4K image size.
|
|
7207
|
+
*/
|
|
7208
|
+
IMAGE_SIZE_FOUR_K = "IMAGE_SIZE_FOUR_K"
|
|
7209
|
+
}
|
|
7210
|
+
|
|
6863
7211
|
/** Optional parameters for importing a file. */
|
|
6864
7212
|
export declare interface ImportFileConfig {
|
|
6865
7213
|
/** Used to override HTTP request options. */
|
|
@@ -7037,7 +7385,7 @@ declare type Interaction = {
|
|
|
7037
7385
|
/**
|
|
7038
7386
|
* Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field.
|
|
7039
7387
|
*/
|
|
7040
|
-
response_format?: Array<
|
|
7388
|
+
response_format?: Array<ResponseFormat_2> | ResponseFormat_2 | undefined;
|
|
7041
7389
|
/**
|
|
7042
7390
|
* The environment configuration for the interaction. Can be an object specifying remote environment sources or a string referencing an existing environment ID.
|
|
7043
7391
|
*/
|
|
@@ -7047,19 +7395,19 @@ declare type Interaction = {
|
|
|
7047
7395
|
*/
|
|
7048
7396
|
generation_config?: GenerationConfig_2 | undefined;
|
|
7049
7397
|
/**
|
|
7050
|
-
*
|
|
7051
|
-
*
|
|
7052
|
-
* @remarks
|
|
7053
|
-
* Note: only used in explicit caching, where users can have control over
|
|
7054
|
-
* caching (e.g. what content to cache) and enjoy guaranteed cost savings.
|
|
7055
|
-
* Format:
|
|
7056
|
-
* `projects/{project}/locations/{location}/cachedContents/{cachedContent}`
|
|
7398
|
+
* Configuration parameters for the agent interaction.
|
|
7057
7399
|
*/
|
|
7058
|
-
|
|
7400
|
+
agent_config?: DynamicAgentConfig | DeepResearchAgentConfig | CodeMenderAgentConfig | AntigravityAgentConfig | undefined;
|
|
7059
7401
|
/**
|
|
7060
|
-
*
|
|
7402
|
+
* Safety settings for the interaction.
|
|
7061
7403
|
*/
|
|
7062
|
-
|
|
7404
|
+
safety_settings?: Array<SafetySetting_2> | undefined;
|
|
7405
|
+
/**
|
|
7406
|
+
* The labels with user-defined metadata for the request.
|
|
7407
|
+
*/
|
|
7408
|
+
labels?: {
|
|
7409
|
+
[k: string]: string;
|
|
7410
|
+
} | undefined;
|
|
7063
7411
|
/**
|
|
7064
7412
|
* The input for the interaction.
|
|
7065
7413
|
*/
|
|
@@ -7086,10 +7434,15 @@ declare type Interaction = {
|
|
|
7086
7434
|
output_video?: VideoContent | undefined;
|
|
7087
7435
|
};
|
|
7088
7436
|
|
|
7437
|
+
/**
|
|
7438
|
+
* Required. The interaction request template to be executed.
|
|
7439
|
+
*/
|
|
7440
|
+
declare type Interaction_2 = interactions.CreateAgentInteraction | interactions.CreateModelInteraction;
|
|
7441
|
+
|
|
7089
7442
|
/**
|
|
7090
7443
|
* Configuration parameters for the agent interaction.
|
|
7091
7444
|
*/
|
|
7092
|
-
declare type InteractionAgentConfig = DynamicAgentConfig | DeepResearchAgentConfig;
|
|
7445
|
+
declare type InteractionAgentConfig = DynamicAgentConfig | DeepResearchAgentConfig | CodeMenderAgentConfig | AntigravityAgentConfig;
|
|
7093
7446
|
|
|
7094
7447
|
declare type InteractionCancelParams$ = CancelInteractionByIdParams;
|
|
7095
7448
|
|
|
@@ -7173,17 +7526,20 @@ declare type InteractionGetParamsStreaming = GetInteractionByIdParamsStreaming;
|
|
|
7173
7526
|
/**
|
|
7174
7527
|
* Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field.
|
|
7175
7528
|
*/
|
|
7176
|
-
declare type InteractionResponseFormat = Array<
|
|
7529
|
+
declare type InteractionResponseFormat = Array<ResponseFormat_2> | ResponseFormat_2;
|
|
7177
7530
|
|
|
7178
7531
|
export declare namespace Interactions {
|
|
7179
7532
|
export type AllowedTools = AllowedTools$;
|
|
7180
7533
|
export type Annotation = Annotation$;
|
|
7534
|
+
export type AntigravityAgentConfig = AntigravityAgentConfig$;
|
|
7181
7535
|
export type AudioContent = AudioContent$;
|
|
7182
7536
|
export type AudioResponseFormat = AudioResponseFormat$;
|
|
7183
7537
|
export type CodeExecutionCallArguments = CodeExecutionCallArguments$;
|
|
7184
7538
|
export interface CodeExecutionCallStep extends CodeExecutionCallStep$ {
|
|
7185
7539
|
}
|
|
7186
7540
|
export type CodeExecutionResultStep = CodeExecutionResultStep$;
|
|
7541
|
+
export interface CodeMenderAgentConfig extends CodeMenderAgentConfig$ {
|
|
7542
|
+
}
|
|
7187
7543
|
export type Content = Content$;
|
|
7188
7544
|
export type CreateAgentInteractionParamsNonStreaming = CreateAgentInteractionParamsNonStreaming$;
|
|
7189
7545
|
export type CreateAgentInteractionParamsStreaming = CreateAgentInteractionParamsStreaming$;
|
|
@@ -7216,6 +7572,7 @@ export declare namespace Interactions {
|
|
|
7216
7572
|
export type GoogleSearchResult = GoogleSearchResult$;
|
|
7217
7573
|
export interface GoogleSearchResultStep extends GoogleSearchResultStep$ {
|
|
7218
7574
|
}
|
|
7575
|
+
export type HarmCategory = HarmCategory$;
|
|
7219
7576
|
export type ImageConfig = ImageConfig$;
|
|
7220
7577
|
export type ImageContent = ImageContent$;
|
|
7221
7578
|
export type ImageResponseFormat = ImageResponseFormat$;
|
|
@@ -7241,6 +7598,11 @@ export declare namespace Interactions {
|
|
|
7241
7598
|
}
|
|
7242
7599
|
export interface PlaceCitation extends PlaceCitation$ {
|
|
7243
7600
|
}
|
|
7601
|
+
export type RetrievalCallArguments = RetrievalCallArguments$;
|
|
7602
|
+
export interface RetrievalCallDelta extends RetrievalCallDelta$ {
|
|
7603
|
+
}
|
|
7604
|
+
export type RetrievalResultDelta = RetrievalResultDelta$;
|
|
7605
|
+
export type SafetySetting = SafetySetting$;
|
|
7244
7606
|
export type SpeechConfig = SpeechConfig$;
|
|
7245
7607
|
export type Step = Step$;
|
|
7246
7608
|
export interface StepDelta extends StepDelta$ {
|
|
@@ -7273,13 +7635,22 @@ export declare namespace Interactions {
|
|
|
7273
7635
|
export namespace CodeExecutionCallStep {
|
|
7274
7636
|
export type Arguments = Arguments$;
|
|
7275
7637
|
}
|
|
7276
|
-
export namespace
|
|
7277
|
-
export interface
|
|
7638
|
+
export namespace CodeMenderAgentConfig {
|
|
7639
|
+
export interface FindRequest extends FindRequest$ {
|
|
7278
7640
|
}
|
|
7279
|
-
export
|
|
7280
|
-
|
|
7281
|
-
|
|
7641
|
+
export interface FixRequest extends FixRequest$ {
|
|
7642
|
+
}
|
|
7643
|
+
export type SessionConfig = SessionConfig$;
|
|
7644
|
+
export namespace FindRequest {
|
|
7645
|
+
export type SourceFile = SourceFile$;
|
|
7282
7646
|
}
|
|
7647
|
+
export namespace FixRequest {
|
|
7648
|
+
export type SourceFile = SourceFile$2;
|
|
7649
|
+
}
|
|
7650
|
+
}
|
|
7651
|
+
export namespace Environment {
|
|
7652
|
+
export type Allowlist = Allowlist$;
|
|
7653
|
+
export type Source = Source$;
|
|
7283
7654
|
}
|
|
7284
7655
|
export namespace ErrorEvent {
|
|
7285
7656
|
export type Error = Error$;
|
|
@@ -7331,6 +7702,9 @@ export declare namespace Interactions {
|
|
|
7331
7702
|
export namespace PlaceCitation {
|
|
7332
7703
|
export type ReviewSnippet = ReviewSnippet$3;
|
|
7333
7704
|
}
|
|
7705
|
+
export namespace RetrievalCallDelta {
|
|
7706
|
+
export type Arguments = Arguments$4;
|
|
7707
|
+
}
|
|
7334
7708
|
export namespace StepDelta {
|
|
7335
7709
|
export type ArgumentsDelta = ArgumentsDelta$;
|
|
7336
7710
|
export type Audio = Audio$;
|
|
@@ -7377,7 +7751,7 @@ export declare namespace Interactions {
|
|
|
7377
7751
|
}
|
|
7378
7752
|
}
|
|
7379
7753
|
export namespace URLContextCallStep {
|
|
7380
|
-
export type Arguments = Arguments$
|
|
7754
|
+
export type Arguments = Arguments$5;
|
|
7381
7755
|
}
|
|
7382
7756
|
export namespace URLContextResultStep {
|
|
7383
7757
|
export type Result = Result$3;
|
|
@@ -7395,16 +7769,18 @@ declare namespace interactions {
|
|
|
7395
7769
|
export {
|
|
7396
7770
|
AgentOption,
|
|
7397
7771
|
AllowedTools,
|
|
7772
|
+
Transform,
|
|
7398
7773
|
AllowlistEntry,
|
|
7399
7774
|
Annotation,
|
|
7775
|
+
AntigravityAgentConfig,
|
|
7400
7776
|
ArgumentsDelta,
|
|
7401
7777
|
AudioContentMimeType,
|
|
7402
7778
|
AudioContent,
|
|
7403
7779
|
AudioDeltaMimeType,
|
|
7404
7780
|
AudioDelta,
|
|
7405
|
-
AudioResponseFormatMimeType,
|
|
7406
7781
|
AudioResponseFormatDelivery,
|
|
7407
|
-
|
|
7782
|
+
AudioResponseFormatMimeType,
|
|
7783
|
+
AudioResponseFormat_2 as AudioResponseFormat,
|
|
7408
7784
|
Language_2 as Language,
|
|
7409
7785
|
CodeExecutionCallArguments,
|
|
7410
7786
|
CodeExecutionCallDelta,
|
|
@@ -7412,8 +7788,9 @@ declare namespace interactions {
|
|
|
7412
7788
|
CodeExecutionResultDelta,
|
|
7413
7789
|
CodeExecutionResultStep,
|
|
7414
7790
|
CodeExecution,
|
|
7415
|
-
|
|
7791
|
+
CodeMenderAgentConfig,
|
|
7416
7792
|
DisabledSafetyPolicy,
|
|
7793
|
+
EnvironmentEnum,
|
|
7417
7794
|
ComputerUse_2 as ComputerUse,
|
|
7418
7795
|
Content_2 as Content,
|
|
7419
7796
|
CreateAgentInteractionResponseFormat,
|
|
@@ -7441,6 +7818,7 @@ declare namespace interactions {
|
|
|
7441
7818
|
ErrorT,
|
|
7442
7819
|
ExaAISearchConfig,
|
|
7443
7820
|
FileCitation,
|
|
7821
|
+
FileContent,
|
|
7444
7822
|
FileSearchCallDelta,
|
|
7445
7823
|
FileSearchCallStep,
|
|
7446
7824
|
FileSearchResultDelta,
|
|
@@ -7448,6 +7826,9 @@ declare namespace interactions {
|
|
|
7448
7826
|
FileSearchResult,
|
|
7449
7827
|
FileSearch_2 as FileSearch,
|
|
7450
7828
|
Filter,
|
|
7829
|
+
Mode,
|
|
7830
|
+
FindRequest,
|
|
7831
|
+
FixRequest,
|
|
7451
7832
|
FunctionCallStep,
|
|
7452
7833
|
FunctionResultDeltaResult,
|
|
7453
7834
|
FunctionResultDeltaResultUnion,
|
|
@@ -7478,6 +7859,7 @@ declare namespace interactions {
|
|
|
7478
7859
|
GoogleSearch_2 as GoogleSearch,
|
|
7479
7860
|
GroundingToolCountType,
|
|
7480
7861
|
GroundingToolCount,
|
|
7862
|
+
HarmCategory_2 as HarmCategory,
|
|
7481
7863
|
HybridSearch,
|
|
7482
7864
|
ImageConfigAspectRatio,
|
|
7483
7865
|
ImageConfigImageSize,
|
|
@@ -7486,11 +7868,11 @@ declare namespace interactions {
|
|
|
7486
7868
|
ImageContent,
|
|
7487
7869
|
ImageDeltaMimeType,
|
|
7488
7870
|
ImageDelta,
|
|
7489
|
-
ImageResponseFormatMimeType,
|
|
7490
|
-
ImageResponseFormatDelivery,
|
|
7491
7871
|
ImageResponseFormatAspectRatio,
|
|
7872
|
+
ImageResponseFormatDelivery,
|
|
7492
7873
|
ImageResponseFormatImageSize,
|
|
7493
|
-
|
|
7874
|
+
ImageResponseFormatMimeType,
|
|
7875
|
+
ImageResponseFormat_2 as ImageResponseFormat,
|
|
7494
7876
|
InteractionCompletedEvent,
|
|
7495
7877
|
InteractionCreatedEvent,
|
|
7496
7878
|
InteractionSseEventInteractionStatus,
|
|
@@ -7524,12 +7906,20 @@ declare namespace interactions {
|
|
|
7524
7906
|
RagRetrievalConfig_2 as RagRetrievalConfig,
|
|
7525
7907
|
RagStoreConfig,
|
|
7526
7908
|
Ranking,
|
|
7527
|
-
ResponseFormat,
|
|
7909
|
+
ResponseFormat_2 as ResponseFormat,
|
|
7528
7910
|
ResponseModality,
|
|
7529
|
-
|
|
7911
|
+
RetrievalCallArguments,
|
|
7912
|
+
RetrievalCallDeltaRetrievalType,
|
|
7913
|
+
RetrievalCallDelta,
|
|
7914
|
+
RetrievalResultDelta,
|
|
7915
|
+
RetrievalRetrievalType,
|
|
7530
7916
|
Retrieval_2 as Retrieval,
|
|
7531
7917
|
ReviewSnippet,
|
|
7918
|
+
Method,
|
|
7919
|
+
Threshold,
|
|
7920
|
+
SafetySetting_2 as SafetySetting,
|
|
7532
7921
|
ServiceTier_2 as ServiceTier,
|
|
7922
|
+
SessionConfig,
|
|
7533
7923
|
SourceType,
|
|
7534
7924
|
Source,
|
|
7535
7925
|
SpeechConfig_2 as SpeechConfig,
|
|
@@ -7545,7 +7935,7 @@ declare namespace interactions {
|
|
|
7545
7935
|
TextContent,
|
|
7546
7936
|
TextDelta,
|
|
7547
7937
|
TextResponseFormatMimeType,
|
|
7548
|
-
TextResponseFormat,
|
|
7938
|
+
TextResponseFormat_2 as TextResponseFormat,
|
|
7549
7939
|
ThinkingLevel_2 as ThinkingLevel,
|
|
7550
7940
|
ThinkingSummaries,
|
|
7551
7941
|
ThoughtSignatureDelta,
|
|
@@ -7560,7 +7950,6 @@ declare namespace interactions {
|
|
|
7560
7950
|
URLCitation,
|
|
7561
7951
|
URLContextCallArguments,
|
|
7562
7952
|
URLContextCallDelta,
|
|
7563
|
-
Arguments,
|
|
7564
7953
|
URLContextCallStep,
|
|
7565
7954
|
URLContextResultDelta,
|
|
7566
7955
|
URLContextResultStep,
|
|
@@ -7576,9 +7965,9 @@ declare namespace interactions {
|
|
|
7576
7965
|
VideoContent,
|
|
7577
7966
|
VideoDeltaMimeType,
|
|
7578
7967
|
VideoDelta,
|
|
7579
|
-
VideoResponseFormatDelivery,
|
|
7580
7968
|
VideoResponseFormatAspectRatio,
|
|
7581
|
-
|
|
7969
|
+
VideoResponseFormatDelivery,
|
|
7970
|
+
VideoResponseFormat_2 as VideoResponseFormat,
|
|
7582
7971
|
WebhookConfig_2 as WebhookConfig
|
|
7583
7972
|
}
|
|
7584
7973
|
}
|
|
@@ -7656,9 +8045,6 @@ declare type InteractionStatus = "in_progress" | "requires_action" | "completed"
|
|
|
7656
8045
|
declare type InteractionStatusUpdate$ = InteractionStatusUpdate;
|
|
7657
8046
|
|
|
7658
8047
|
declare type InteractionStatusUpdate = {
|
|
7659
|
-
event_type: "interaction.status_update";
|
|
7660
|
-
interaction_id: string;
|
|
7661
|
-
status: InteractionStatusUpdateStatus;
|
|
7662
8048
|
/**
|
|
7663
8049
|
* The event_id token to be used to resume the interaction stream, from
|
|
7664
8050
|
*
|
|
@@ -7666,7 +8052,10 @@ declare type InteractionStatusUpdate = {
|
|
|
7666
8052
|
* this event.
|
|
7667
8053
|
*/
|
|
7668
8054
|
event_id?: string | undefined;
|
|
8055
|
+
event_type: "interaction.status_update";
|
|
8056
|
+
interaction_id: string;
|
|
7669
8057
|
metadata?: StreamMetadata | undefined;
|
|
8058
|
+
status: InteractionStatusUpdateStatus;
|
|
7670
8059
|
};
|
|
7671
8060
|
|
|
7672
8061
|
declare type InteractionStatusUpdateStatus = "in_progress" | "requires_action" | "completed" | "failed" | "cancelled" | "incomplete" | "budget_exceeded" | (string & {});
|
|
@@ -7991,6 +8380,99 @@ export declare class ListModelsResponse {
|
|
|
7991
8380
|
models?: Model[];
|
|
7992
8381
|
}
|
|
7993
8382
|
|
|
8383
|
+
declare type ListTriggerExecutionsParams = Omit<ListTriggerExecutionsRequest, "trigger_id">;
|
|
8384
|
+
|
|
8385
|
+
declare type ListTriggerExecutionsParams_2 = {
|
|
8386
|
+
api_version?: string;
|
|
8387
|
+
pageSize?: number;
|
|
8388
|
+
pageToken?: string;
|
|
8389
|
+
};
|
|
8390
|
+
|
|
8391
|
+
declare type ListTriggerExecutionsRequest = {
|
|
8392
|
+
/**
|
|
8393
|
+
* Which version of the API to use.
|
|
8394
|
+
*/
|
|
8395
|
+
api_version?: string | undefined;
|
|
8396
|
+
/**
|
|
8397
|
+
* Resource name of the trigger.
|
|
8398
|
+
*/
|
|
8399
|
+
trigger_id: string;
|
|
8400
|
+
/**
|
|
8401
|
+
* Optional. The maximum number of executions to return per page.
|
|
8402
|
+
*/
|
|
8403
|
+
page_size?: number | undefined;
|
|
8404
|
+
/**
|
|
8405
|
+
* Optional. A page token from a previous ListTriggerExecutions call.
|
|
8406
|
+
*/
|
|
8407
|
+
page_token?: string | undefined;
|
|
8408
|
+
};
|
|
8409
|
+
|
|
8410
|
+
declare type ListTriggerExecutionsResponse$ = ListTriggerExecutionsResponse;
|
|
8411
|
+
|
|
8412
|
+
/**
|
|
8413
|
+
* Response message for TriggerService.ListTriggerExecutions.
|
|
8414
|
+
*/
|
|
8415
|
+
declare type ListTriggerExecutionsResponse = {
|
|
8416
|
+
/**
|
|
8417
|
+
* A page token, received from a previous `ListTriggerExecutions` call.
|
|
8418
|
+
*
|
|
8419
|
+
* @remarks
|
|
8420
|
+
* Provide this to retrieve the subsequent page.
|
|
8421
|
+
*/
|
|
8422
|
+
next_page_token?: string | undefined;
|
|
8423
|
+
/**
|
|
8424
|
+
* The list of trigger executions.
|
|
8425
|
+
*/
|
|
8426
|
+
trigger_executions?: Array<TriggerExecution> | undefined;
|
|
8427
|
+
};
|
|
8428
|
+
|
|
8429
|
+
declare type ListTriggersParams = ListTriggersRequest;
|
|
8430
|
+
|
|
8431
|
+
declare type ListTriggersParams_2 = {
|
|
8432
|
+
api_version?: string;
|
|
8433
|
+
filter?: string;
|
|
8434
|
+
pageSize?: number;
|
|
8435
|
+
pageToken?: string;
|
|
8436
|
+
};
|
|
8437
|
+
|
|
8438
|
+
declare type ListTriggersRequest = {
|
|
8439
|
+
/**
|
|
8440
|
+
* Which version of the API to use.
|
|
8441
|
+
*/
|
|
8442
|
+
api_version?: string | undefined;
|
|
8443
|
+
/**
|
|
8444
|
+
* Optional. Filter expression (e.g., by state).
|
|
8445
|
+
*/
|
|
8446
|
+
filter?: string | undefined;
|
|
8447
|
+
/**
|
|
8448
|
+
* Optional. The maximum number of triggers to return per page.
|
|
8449
|
+
*/
|
|
8450
|
+
page_size?: number | undefined;
|
|
8451
|
+
/**
|
|
8452
|
+
* Optional. A page token from a previous ListTriggers call.
|
|
8453
|
+
*/
|
|
8454
|
+
page_token?: string | undefined;
|
|
8455
|
+
};
|
|
8456
|
+
|
|
8457
|
+
declare type ListTriggersResponse$ = ListTriggersResponse;
|
|
8458
|
+
|
|
8459
|
+
/**
|
|
8460
|
+
* Response message for TriggerService.ListTriggers.
|
|
8461
|
+
*/
|
|
8462
|
+
declare type ListTriggersResponse = {
|
|
8463
|
+
/**
|
|
8464
|
+
* A page token, received from a previous `ListTriggers` call.
|
|
8465
|
+
*
|
|
8466
|
+
* @remarks
|
|
8467
|
+
* Provide this to retrieve the subsequent page.
|
|
8468
|
+
*/
|
|
8469
|
+
next_page_token?: string | undefined;
|
|
8470
|
+
/**
|
|
8471
|
+
* The list of triggers.
|
|
8472
|
+
*/
|
|
8473
|
+
triggers?: Array<Trigger> | undefined;
|
|
8474
|
+
};
|
|
8475
|
+
|
|
7994
8476
|
/** Configuration for the list tuning jobs method. */
|
|
7995
8477
|
export declare interface ListTuningJobsConfig {
|
|
7996
8478
|
/** Used to override HTTP request options. */
|
|
@@ -8246,6 +8728,8 @@ export declare interface LiveClientSetup {
|
|
|
8246
8728
|
response.
|
|
8247
8729
|
*/
|
|
8248
8730
|
safetySettings?: SafetySetting[];
|
|
8731
|
+
/** Configures the exchange of history between the client and the server. */
|
|
8732
|
+
historyConfig?: HistoryConfig;
|
|
8249
8733
|
}
|
|
8250
8734
|
|
|
8251
8735
|
/** Client generated response to a `ToolCall` received from the server.
|
|
@@ -8815,6 +9299,11 @@ export declare interface LiveServerSessionResumptionUpdate {
|
|
|
8815
9299
|
export declare interface LiveServerSetupComplete {
|
|
8816
9300
|
/** The session id of the live session. */
|
|
8817
9301
|
sessionId?: string;
|
|
9302
|
+
/** Signature of the verified consent audio. This is populated when the
|
|
9303
|
+
request has a ReplicatedVoiceConfig with consent_audio set, if the consent
|
|
9304
|
+
verification was successful. This may be used in a subsequent request
|
|
9305
|
+
instead of the consent_audio to verify the same consent. */
|
|
9306
|
+
voiceConsentSignature?: VoiceConsentSignature;
|
|
8818
9307
|
}
|
|
8819
9308
|
|
|
8820
9309
|
/** Request for the client to execute the `function_calls` and return the responses with the matching `id`s. */
|
|
@@ -8903,22 +9392,22 @@ export declare enum MaskReferenceMode {
|
|
|
8903
9392
|
MASK_MODE_SEMANTIC = "MASK_MODE_SEMANTIC"
|
|
8904
9393
|
}
|
|
8905
9394
|
|
|
8906
|
-
/** Match operation to use for
|
|
9395
|
+
/** Match operation to use for evaluating rewards. This enum is not supported in Gemini API. */
|
|
8907
9396
|
export declare enum MatchOperation {
|
|
8908
9397
|
/**
|
|
8909
|
-
* Default value.
|
|
9398
|
+
* Default value. A user error will be returned if not set.
|
|
8910
9399
|
*/
|
|
8911
9400
|
MATCH_OPERATION_UNSPECIFIED = "MATCH_OPERATION_UNSPECIFIED",
|
|
8912
9401
|
/**
|
|
8913
|
-
* Equivalent to GoogleSQL `REGEX_CONTAINS(target, expression)`.
|
|
9402
|
+
* Equivalent to [GoogleSQL](https://cloud.google.com/bigquery/docs/reference/standard-sql/string_functions#regexp_contains) `REGEX_CONTAINS(target, expression)`.
|
|
8914
9403
|
*/
|
|
8915
9404
|
REGEX_CONTAINS = "REGEX_CONTAINS",
|
|
8916
9405
|
/**
|
|
8917
|
-
* `
|
|
9406
|
+
* The match operation returns `true` if expression is a substring of the target.
|
|
8918
9407
|
*/
|
|
8919
9408
|
PARTIAL_MATCH = "PARTIAL_MATCH",
|
|
8920
9409
|
/**
|
|
8921
|
-
* `
|
|
9410
|
+
* The match operation returns `true` expression is an exact match of the target.
|
|
8922
9411
|
*/
|
|
8923
9412
|
EXACT_MATCH = "EXACT_MATCH"
|
|
8924
9413
|
}
|
|
@@ -8929,11 +9418,21 @@ declare type MCPServer$ = MCPServer;
|
|
|
8929
9418
|
* A MCPServer is a server that can be called by the model to perform actions.
|
|
8930
9419
|
*/
|
|
8931
9420
|
declare type MCPServer = {
|
|
8932
|
-
|
|
9421
|
+
/**
|
|
9422
|
+
* The allowed tools.
|
|
9423
|
+
*/
|
|
9424
|
+
allowed_tools?: Array<AllowedTools> | undefined;
|
|
9425
|
+
/**
|
|
9426
|
+
* Optional: Fields for authentication headers, timeouts, etc., if needed.
|
|
9427
|
+
*/
|
|
9428
|
+
headers?: {
|
|
9429
|
+
[k: string]: string;
|
|
9430
|
+
} | undefined;
|
|
8933
9431
|
/**
|
|
8934
9432
|
* The name of the MCPServer.
|
|
8935
9433
|
*/
|
|
8936
9434
|
name?: string | undefined;
|
|
9435
|
+
type: "mcp_server";
|
|
8937
9436
|
/**
|
|
8938
9437
|
* The full URL for the MCPServer endpoint.
|
|
8939
9438
|
*
|
|
@@ -8941,16 +9440,6 @@ declare type MCPServer = {
|
|
|
8941
9440
|
* Example: "https://api.example.com/mcp"
|
|
8942
9441
|
*/
|
|
8943
9442
|
url?: string | undefined;
|
|
8944
|
-
/**
|
|
8945
|
-
* Optional: Fields for authentication headers, timeouts, etc., if needed.
|
|
8946
|
-
*/
|
|
8947
|
-
headers?: {
|
|
8948
|
-
[k: string]: string;
|
|
8949
|
-
} | undefined;
|
|
8950
|
-
/**
|
|
8951
|
-
* The allowed tools.
|
|
8952
|
-
*/
|
|
8953
|
-
allowed_tools?: Array<AllowedTools> | undefined;
|
|
8954
9443
|
};
|
|
8955
9444
|
|
|
8956
9445
|
/** A MCPServer is a server that can be called by the model to perform actions. It is a server that implements the MCP protocol. Next ID: 6. This data type is not supported in Vertex AI. */
|
|
@@ -8971,12 +9460,12 @@ declare type MCPServerToolCall$ = MCPServerToolCallDelta;
|
|
|
8971
9460
|
* g3-prettier-ignore-file
|
|
8972
9461
|
*/
|
|
8973
9462
|
declare type MCPServerToolCallDelta = {
|
|
8974
|
-
type: "mcp_server_tool_call";
|
|
8975
|
-
name: string;
|
|
8976
|
-
server_name: string;
|
|
8977
9463
|
arguments: {
|
|
8978
9464
|
[k: string]: any;
|
|
8979
9465
|
};
|
|
9466
|
+
name: string;
|
|
9467
|
+
server_name: string;
|
|
9468
|
+
type: "mcp_server_tool_call";
|
|
8980
9469
|
};
|
|
8981
9470
|
|
|
8982
9471
|
declare type MCPServerToolCallStep$ = MCPServerToolCallStep;
|
|
@@ -8992,15 +9481,6 @@ declare type MCPServerToolCallStep$ = MCPServerToolCallStep;
|
|
|
8992
9481
|
* MCPServer tool call step.
|
|
8993
9482
|
*/
|
|
8994
9483
|
declare type MCPServerToolCallStep = {
|
|
8995
|
-
type: "mcp_server_tool_call";
|
|
8996
|
-
/**
|
|
8997
|
-
* Required. The name of the tool which was called.
|
|
8998
|
-
*/
|
|
8999
|
-
name: string;
|
|
9000
|
-
/**
|
|
9001
|
-
* Required. The name of the used MCP server.
|
|
9002
|
-
*/
|
|
9003
|
-
server_name: string;
|
|
9004
9484
|
/**
|
|
9005
9485
|
* Required. The JSON object of arguments for the function.
|
|
9006
9486
|
*/
|
|
@@ -9011,15 +9491,24 @@ declare type MCPServerToolCallStep = {
|
|
|
9011
9491
|
* Required. A unique ID for this specific tool call.
|
|
9012
9492
|
*/
|
|
9013
9493
|
id: string;
|
|
9494
|
+
/**
|
|
9495
|
+
* Required. The name of the tool which was called.
|
|
9496
|
+
*/
|
|
9497
|
+
name: string;
|
|
9498
|
+
/**
|
|
9499
|
+
* Required. The name of the used MCP server.
|
|
9500
|
+
*/
|
|
9501
|
+
server_name: string;
|
|
9502
|
+
type: "mcp_server_tool_call";
|
|
9014
9503
|
};
|
|
9015
9504
|
|
|
9016
9505
|
declare type MCPServerToolResult$ = MCPServerToolResultDelta;
|
|
9017
9506
|
|
|
9018
9507
|
declare type MCPServerToolResultDelta = {
|
|
9019
|
-
type: "mcp_server_tool_result";
|
|
9020
9508
|
name?: string | undefined;
|
|
9021
|
-
server_name?: string | undefined;
|
|
9022
9509
|
result: MCPServerToolResultDeltaResult | Array<FunctionResultSubcontent> | string;
|
|
9510
|
+
server_name?: string | undefined;
|
|
9511
|
+
type: "mcp_server_tool_result";
|
|
9023
9512
|
};
|
|
9024
9513
|
|
|
9025
9514
|
declare type MCPServerToolResultDeltaResult = {};
|
|
@@ -9032,23 +9521,23 @@ declare type MCPServerToolResultStep$ = MCPServerToolResultStep;
|
|
|
9032
9521
|
* MCPServer tool result step.
|
|
9033
9522
|
*/
|
|
9034
9523
|
declare type MCPServerToolResultStep = {
|
|
9035
|
-
type: "mcp_server_tool_result";
|
|
9036
|
-
/**
|
|
9037
|
-
* Name of the tool which is called for this specific tool call.
|
|
9038
|
-
*/
|
|
9039
|
-
name?: string | undefined;
|
|
9040
|
-
/**
|
|
9041
|
-
* The name of the used MCP server.
|
|
9042
|
-
*/
|
|
9043
|
-
server_name?: string | undefined;
|
|
9044
9524
|
/**
|
|
9045
9525
|
* Required. ID to match the ID from the function call block.
|
|
9046
9526
|
*/
|
|
9047
9527
|
call_id: string;
|
|
9528
|
+
/**
|
|
9529
|
+
* Name of the tool which is called for this specific tool call.
|
|
9530
|
+
*/
|
|
9531
|
+
name?: string | undefined;
|
|
9048
9532
|
/**
|
|
9049
9533
|
* The output from the MCP server call. Can be simple text or rich content.
|
|
9050
9534
|
*/
|
|
9051
9535
|
result: MCPServerToolResultStepResult | string | Array<FunctionResultSubcontent>;
|
|
9536
|
+
/**
|
|
9537
|
+
* The name of the used MCP server.
|
|
9538
|
+
*/
|
|
9539
|
+
server_name?: string | undefined;
|
|
9540
|
+
type: "mcp_server_tool_result";
|
|
9052
9541
|
};
|
|
9053
9542
|
|
|
9054
9543
|
declare type MCPServerToolResultStepResult = {};
|
|
@@ -9141,6 +9630,14 @@ declare type Metadata$6 = StreamMetadata;
|
|
|
9141
9630
|
|
|
9142
9631
|
declare type Metadata$7 = StreamMetadata;
|
|
9143
9632
|
|
|
9633
|
+
/**
|
|
9634
|
+
* Optional. The method for blocking content. If not specified, the default
|
|
9635
|
+
*
|
|
9636
|
+
* @remarks
|
|
9637
|
+
* behavior is to use the probability score.
|
|
9638
|
+
*/
|
|
9639
|
+
declare type Method = "severity" | "probability" | (string & {});
|
|
9640
|
+
|
|
9144
9641
|
/** Server content modalities. */
|
|
9145
9642
|
export declare enum Modality {
|
|
9146
9643
|
/**
|
|
@@ -9184,6 +9681,11 @@ declare type ModalityTokens = {
|
|
|
9184
9681
|
tokens?: number | undefined;
|
|
9185
9682
|
};
|
|
9186
9683
|
|
|
9684
|
+
/**
|
|
9685
|
+
* The mode of the find session.
|
|
9686
|
+
*/
|
|
9687
|
+
declare type Mode = "scan" | "verify" | (string & {});
|
|
9688
|
+
|
|
9187
9689
|
declare type Model$ = Model_2;
|
|
9188
9690
|
|
|
9189
9691
|
/** A trained machine learning model. */
|
|
@@ -9251,7 +9753,7 @@ export declare interface Model {
|
|
|
9251
9753
|
/**
|
|
9252
9754
|
* The model that will complete your prompt.\n\nSee [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
|
|
9253
9755
|
*/
|
|
9254
|
-
declare type Model_2 = "gemini-2.5-
|
|
9756
|
+
declare type Model_2 = "gemini-2.5-flash" | "gemini-2.5-pro" | "gemma-4-26b-a4b-it" | "gemma-4-31b-it" | "gemini-flash-latest" | "gemini-flash-lite-latest" | "gemini-pro-latest" | "gemini-2.5-flash-lite" | "gemini-2.5-flash-image" | "gemini-3-flash-preview" | "gemini-3.1-pro-preview" | "gemini-3.1-pro-preview-customtools" | "gemini-3.1-flash-lite" | "gemini-3-pro-image" | "nano-banana-pro-preview" | "gemini-3.1-flash-image" | "gemini-3.5-flash" | "lyria-3-clip-preview" | "lyria-3-pro-preview" | "gemini-robotics-er-1.6-preview" | (string & {});
|
|
9255
9757
|
|
|
9256
9758
|
/** 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. */
|
|
9257
9759
|
export declare interface ModelArmorConfig {
|
|
@@ -9267,7 +9769,6 @@ declare type ModelOutputStep$ = ModelOutputStep;
|
|
|
9267
9769
|
* Output generated by the model.
|
|
9268
9770
|
*/
|
|
9269
9771
|
declare type ModelOutputStep = {
|
|
9270
|
-
type: "model_output";
|
|
9271
9772
|
content?: Array<Content_2> | undefined;
|
|
9272
9773
|
/**
|
|
9273
9774
|
* The `Status` type defines a logical error model that is suitable for
|
|
@@ -9281,6 +9782,7 @@ declare type ModelOutputStep = {
|
|
|
9281
9782
|
* [API Design Guide](https://cloud.google.com/apis/design/errors).
|
|
9282
9783
|
*/
|
|
9283
9784
|
error?: Status | undefined;
|
|
9785
|
+
type: "model_output";
|
|
9284
9786
|
};
|
|
9285
9787
|
|
|
9286
9788
|
export declare class Models extends BaseModule {
|
|
@@ -10189,19 +10691,18 @@ declare type PlaceCitation$ = PlaceCitation;
|
|
|
10189
10691
|
* A place citation annotation.
|
|
10190
10692
|
*/
|
|
10191
10693
|
declare type PlaceCitation = {
|
|
10192
|
-
type: "place_citation";
|
|
10193
10694
|
/**
|
|
10194
|
-
*
|
|
10695
|
+
* End of the attributed segment, exclusive.
|
|
10195
10696
|
*/
|
|
10196
|
-
|
|
10697
|
+
end_index?: number | undefined;
|
|
10197
10698
|
/**
|
|
10198
10699
|
* Title of the place.
|
|
10199
10700
|
*/
|
|
10200
10701
|
name?: string | undefined;
|
|
10201
10702
|
/**
|
|
10202
|
-
*
|
|
10703
|
+
* The ID of the place, in `places/{place_id}` format.
|
|
10203
10704
|
*/
|
|
10204
|
-
|
|
10705
|
+
place_id?: string | undefined;
|
|
10205
10706
|
/**
|
|
10206
10707
|
* Snippets of reviews that are used to generate answers about the
|
|
10207
10708
|
*
|
|
@@ -10217,10 +10718,11 @@ declare type PlaceCitation = {
|
|
|
10217
10718
|
* Index indicates the start of the segment, measured in bytes.
|
|
10218
10719
|
*/
|
|
10219
10720
|
start_index?: number | undefined;
|
|
10721
|
+
type: "place_citation";
|
|
10220
10722
|
/**
|
|
10221
|
-
*
|
|
10723
|
+
* URI reference of the place.
|
|
10222
10724
|
*/
|
|
10223
|
-
|
|
10725
|
+
url?: string | undefined;
|
|
10224
10726
|
};
|
|
10225
10727
|
|
|
10226
10728
|
/** Spec for pointwise metric result. This data type is not supported in Gemini API. */
|
|
@@ -10388,21 +10890,21 @@ export declare interface RagRetrievalConfig {
|
|
|
10388
10890
|
*/
|
|
10389
10891
|
declare type RagRetrievalConfig_2 = {
|
|
10390
10892
|
/**
|
|
10391
|
-
*
|
|
10893
|
+
* Config for filters.
|
|
10392
10894
|
*/
|
|
10393
|
-
|
|
10895
|
+
filter?: Filter | undefined;
|
|
10394
10896
|
/**
|
|
10395
10897
|
* Config for Hybrid Search.
|
|
10396
10898
|
*/
|
|
10397
10899
|
hybrid_search?: HybridSearch | undefined;
|
|
10398
|
-
/**
|
|
10399
|
-
* Config for filters.
|
|
10400
|
-
*/
|
|
10401
|
-
filter?: Filter | undefined;
|
|
10402
10900
|
/**
|
|
10403
10901
|
* Config for Rank Service.
|
|
10404
10902
|
*/
|
|
10405
10903
|
ranking?: Ranking | undefined;
|
|
10904
|
+
/**
|
|
10905
|
+
* Optional. The number of contexts to retrieve.
|
|
10906
|
+
*/
|
|
10907
|
+
top_k?: number | undefined;
|
|
10406
10908
|
};
|
|
10407
10909
|
|
|
10408
10910
|
/** Config for filters. This data type is not supported in Gemini API. */
|
|
@@ -10449,6 +10951,10 @@ declare type RagStoreConfig = {
|
|
|
10449
10951
|
* Optional. The representation of the rag source.
|
|
10450
10952
|
*/
|
|
10451
10953
|
rag_resources?: Array<RagResource> | undefined;
|
|
10954
|
+
/**
|
|
10955
|
+
* Specifies the context retrieval config.
|
|
10956
|
+
*/
|
|
10957
|
+
rag_retrieval_config?: RagRetrievalConfig_2 | undefined;
|
|
10452
10958
|
/**
|
|
10453
10959
|
* Optional. Number of top k results to return from the selected corpora.
|
|
10454
10960
|
*
|
|
@@ -10461,10 +10967,6 @@ declare type RagStoreConfig = {
|
|
|
10461
10967
|
* @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
|
|
10462
10968
|
*/
|
|
10463
10969
|
vector_distance_threshold?: number | undefined;
|
|
10464
|
-
/**
|
|
10465
|
-
* Specifies the context retrieval config.
|
|
10466
|
-
*/
|
|
10467
|
-
rag_retrieval_config?: RagRetrievalConfig_2 | undefined;
|
|
10468
10970
|
};
|
|
10469
10971
|
|
|
10470
10972
|
/**
|
|
@@ -10478,11 +10980,11 @@ declare type RagStoreConfig = {
|
|
|
10478
10980
|
* Config for Rank Service.
|
|
10479
10981
|
*/
|
|
10480
10982
|
declare type Ranking = {
|
|
10481
|
-
ranking_config: "rank_service";
|
|
10482
10983
|
/**
|
|
10483
10984
|
* Optional. The model name of the rank service.
|
|
10484
10985
|
*/
|
|
10485
10986
|
model_name?: string | undefined;
|
|
10987
|
+
ranking_config: "rank_service";
|
|
10486
10988
|
};
|
|
10487
10989
|
|
|
10488
10990
|
/** Raw output. This data type is not supported in Gemini API. */
|
|
@@ -10646,39 +11148,39 @@ export declare class RegisterFilesResponse {
|
|
|
10646
11148
|
export declare interface ReinforcementTuningAutoraterScorer {
|
|
10647
11149
|
/** Autorater config for evaluation. */
|
|
10648
11150
|
autoraterConfig?: AutoraterConfig;
|
|
10649
|
-
/**
|
|
11151
|
+
/** The prompt for an autorater to scorer the parsed sample response. This field supports the following placeholders that will be replaced before scoring: - {{prompt}} - {{response}} - {{system_instruction}} - {{references.key}} */
|
|
10650
11152
|
autoraterPrompt?: string;
|
|
10651
|
-
/** Parses autorater returned response. */
|
|
11153
|
+
/** Parses autorater returned response for scoring. For example, if the autorater response has reward stored in the `2.0` block, defining a parsing response config using regex `".*(.*?)"` will return a score `"2.0"`. */
|
|
10652
11154
|
autoraterResponseParseConfig?: ReinforcementTuningParseResponseConfig;
|
|
10653
|
-
/** Scores autorater responses by directly converting parsed autorater response to float reward. */
|
|
11155
|
+
/** Scores autorater responses by directly converting parsed autorater response to a float reward. Note: Reward is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`. */
|
|
10654
11156
|
parsedResponseConversionScorer?: ReinforcementTuningAutoraterScorerParsedResponseConversionScorer;
|
|
10655
|
-
/** Scores autorater responses by using
|
|
11157
|
+
/** Scores autorater responses by using string match reward scorer. */
|
|
10656
11158
|
exactMatchScorer?: ReinforcementTuningAutoraterScorerExactMatchScorer;
|
|
10657
11159
|
}
|
|
10658
11160
|
|
|
10659
|
-
/** Scores autorater responses by using exact string match reward scorer. */
|
|
11161
|
+
/** Scores autorater responses by using exact string match reward scorer. This data type is not supported in Gemini API. */
|
|
10660
11162
|
export declare interface ReinforcementTuningAutoraterScorerExactMatchScorer {
|
|
10661
|
-
/** Assigns this reward score if parsed response string equals the expression. */
|
|
11163
|
+
/** Assigns this reward score if the parsed response string equals the expression. */
|
|
10662
11164
|
correctAnswerReward?: number;
|
|
10663
|
-
/** Assigns this reward score if parsed reward value does not equal the expression. */
|
|
11165
|
+
/** Assigns this reward score if the parsed reward value does not equal the expression. */
|
|
10664
11166
|
wrongAnswerReward?: number;
|
|
10665
|
-
/** The string expression to match against.
|
|
11167
|
+
/** The string expression to match against for scoring. This field supports placeholders in the format of {{references.key}} that will be replaced before matching. Regex is not supported for this expression. For example, users can define an ExactMatchScorer as follows: { "correctAnswerReward": 1.0, "wrongAnswerReward": -1.0, "expression": "{{references.concise_answer}}" } When evaluating the reward for each parsed autorater response, if the prompt references in the training/validation dataset has the following fields: ``` { "example": ..., "references": { "concise_ansser": "Yes", "verbose_answer": "The answer is Yes" } } ``` The above ExactMatchScorer will be replaced as follows for scoring: ``` { "correctAnswerReward": 1.0, "wrongAnswerReward": -1.0, "expression": "Yes" } ``` If the *parsed* autorater response is equal to the string `"Yes"`, then the reward is `1.0`, otherwise the reward is `-1.0`. */
|
|
10666
11168
|
expression?: string;
|
|
10667
11169
|
}
|
|
10668
11170
|
|
|
10669
|
-
/** Scores responses by directly converting parsed autorater response to float reward
|
|
11171
|
+
/** Scores responses by directly converting the parsed autorater response to a float reward. Note: Reward is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`. This data type is not supported in Gemini API. */
|
|
10670
11172
|
export declare class ReinforcementTuningAutoraterScorerParsedResponseConversionScorer {
|
|
10671
11173
|
}
|
|
10672
11174
|
|
|
10673
|
-
/**
|
|
11175
|
+
/** ReinforcementTuningCloudRunRewardScorer allows users to implement a reward function through GCP Cloud Run. Comparing with ReinforcementTuningCodeExecutionRewardScorer that runs in a Sandbox and has no internet access, Cloud Run reward scorer is fully controlled by users. The Cloud Run service should implement the following HTTP API: HTTP method: `POST` HTTP request body: ``` { "example": ReinforcementTuningExample, "response": Content, "metadata": { "step": int "tuning_job_id": int64 } } ``` * `example` is a ReinforcementTuningExample in ProtoJSON format, (i.e., the format is the same as as one line in the training/validation dataset except that the keys must be in camel case). System instructions (i.e., `example.get("systemInstruction")`) and references (i.e., `example.get("references")`) are also included in the `example` provided that they are set in the training/validation dataset. * `response` is a Content in ProtoJSON format (i.e., keys must be in camel case), which is the same as the Online Prediction response for Gemini models. HTTP response body: { "reward": float, "user_requested_aux_info": str // Optional } where the field "user_requested_aux_info" is any (optional) string provided by users for assisting debugging. It's in snake case. This field is mostly useful when calling the GenAiTuningService.ValidateReinforcementTuningReward API, where the proto field (not Cloud Run HTTP response body) userRequestedAuxInfo will be populated if the Cloud Run reward function sets this field in the HTTP response. The following are examples for the HTTP request and response body. Example HTTP request body: ``` { "example": { "contents": [ { "role": "user", "parts": [ { "text": "What is the capital of France?" } ] } ], "references": { "answer": "Paris" } }, "response": { "parts": [ { "text": "London" } ] }, "metadata": { "step": 1, "tuning_job_id": 123456789 } } ``` Example HTTP response body: ``` { "reward": -1.0 } ``` Note: Reward output by Cloud Run reward function is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`. This data type is not supported in Gemini API. */
|
|
10674
11176
|
export declare interface ReinforcementTuningCloudRunRewardScorer {
|
|
10675
|
-
/** URI of the Cloud Run service that will be used to compute the reward. The Vertex AI Secure Fine Tuning Service Agent (`service
|
|
11177
|
+
/** URI of the Cloud Run service that will be used to compute the reward. The [Vertex AI Secure Fine Tuning Service Agent](https://docs.cloud.google.com/iam/docs/service-agents#vertex-ai-secure-fine-tuning-service-agent) (`service-@gcp-sa-vertex-tune.iam.gserviceaccount.com`) must be granted the permission (e.g. by granting `roles/run.invoker` in IAM) to invoke the Cloud Run service. */
|
|
10676
11178
|
cloudRunUri?: string;
|
|
10677
11179
|
}
|
|
10678
11180
|
|
|
10679
|
-
/**
|
|
11181
|
+
/** ReinforcementTuningCodeExecutionRewardScorer allows users to implement a function to evaluate rewards for the sample response. The function signature is as follows: ``` def evaluate(example: dict[str, Any], response: dict[str, Any]) -> float: ... ``` `example` is a ReinforcementTuningExample in ProtoJSON format, (i.e., the format is the same as as one line in the training/validation dataset except that the keys must be in camel case). System instructions (i.e., `example.get("systemInstruction")`) and references (i.e., `example.get("references")`) are also included in the `example` provided that they are set in the training/validation dataset. `response` is a Content in ProtoJSON format (i.e., keys must be in camel case), which is the same as the Online Prediction response for Gemini models. Note: Reward output by the `evaluate` function is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`. This data type is not supported in Gemini API. */
|
|
10680
11182
|
export declare interface ReinforcementTuningCodeExecutionRewardScorer {
|
|
10681
|
-
/**
|
|
11183
|
+
/** The python code snippet as a string for evaluating rewards. The following is an example python code snippet that returns a reward `1.0` for a parsed response matching the user-provided reference answer in per prompt references map. ``` def evaluate(example, response) -> float: response_str = response.get("parts", [])0 references = example.get("references", {}) if response_str == references.get("concise_answer"): return 1.0 return -1.0 ``` Note: Reward output by the evaluate function is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`. */
|
|
10682
11184
|
pythonCodeSnippet?: string;
|
|
10683
11185
|
}
|
|
10684
11186
|
|
|
@@ -10688,37 +11190,39 @@ export declare interface ReinforcementTuningExample {
|
|
|
10688
11190
|
contents?: Content[];
|
|
10689
11191
|
/** References for the given prompt. The key is the name of the reference, and the value is the reference itself. */
|
|
10690
11192
|
references?: Record<string, string>;
|
|
10691
|
-
/** Corresponds to
|
|
11193
|
+
/** Corresponds to system_instruction in user-facing GenerateContentRequest. */
|
|
10692
11194
|
systemInstruction?: Content;
|
|
10693
11195
|
}
|
|
10694
11196
|
|
|
10695
11197
|
/** Hyperparameters for Reinforcement Tuning. */
|
|
10696
11198
|
export declare interface ReinforcementTuningHyperParameters {
|
|
10697
|
-
/** Number of training
|
|
11199
|
+
/** Optional. Number of training epoches for the tuning job. */
|
|
10698
11200
|
epochCount?: string;
|
|
10699
11201
|
/** Learning rate multiplier for Reinforcement Learning. */
|
|
10700
11202
|
learningRateMultiplier?: number;
|
|
10701
|
-
/** Adapter size for Reinforcement Tuning. */
|
|
11203
|
+
/** Optional. Adapter size for Reinforcement Tuning. */
|
|
10702
11204
|
adapterSize?: AdapterSize;
|
|
10703
|
-
/** Number of different responses to generate per prompt during tuning. */
|
|
11205
|
+
/** Optional. Number of different responses to generate per prompt during tuning. */
|
|
10704
11206
|
samplesPerPrompt?: number;
|
|
10705
|
-
/** Batch size for the tuning job. How many prompts to process at a train step. If not set, the batch size will be determined automatically. */
|
|
11207
|
+
/** Optional. Batch size for the tuning job. How many prompts to process at a train step. If not set, the batch size will be determined automatically. */
|
|
10706
11208
|
batchSize?: number;
|
|
10707
|
-
/** How often
|
|
11209
|
+
/** Optional. How often at steps to evaluate the tuning job during training. If not set, evel will be run per epoch. `total_steps = epoch_count * samples_per_prompt / total_prompts_in_dataset` */
|
|
10708
11210
|
evaluateInterval?: number;
|
|
10709
|
-
/** How often
|
|
11211
|
+
/** Optional. How often at steps to save checkpoints during training. If not set, one checkpoint per epoch will be set. ```total_steps = epoch_count * samples_per_prompt / total_prompts_in_dataset``` */
|
|
10710
11212
|
checkpointInterval?: number;
|
|
10711
|
-
/** The maximum number of tokens to generate per prompt.
|
|
11213
|
+
/** Optional. The maximum number of tokens to generate per prompt. Default to 32768. */
|
|
10712
11214
|
maxOutputTokens?: number;
|
|
10713
|
-
/** Indicates the maximum thinking depth.
|
|
11215
|
+
/** Indicates the maximum thinking depth during tuning. Starting from Gemini 3.5 models, the old thinking_budget will no longer be supported and will result in a user error if set. Instead, users should use the thinking_level parameter to control the maximum thinking depth. */
|
|
10714
11216
|
thinkingLevel?: ReinforcementTuningThinkingLevel;
|
|
11217
|
+
/** Optional. The thinking budget for the tuning job to optimize for (Gemini 2.5 only). * -1 means dynamic thinking * 0 means no thinking * > 0 means thinking budget in tokens If not set, default to -1 (dynamic thinking). */
|
|
11218
|
+
thinkingBudget?: number;
|
|
10715
11219
|
}
|
|
10716
11220
|
|
|
10717
|
-
/** Defines how to parse sample response for reinforcement tuning. */
|
|
11221
|
+
/** Defines how to parse sample response config for reinforcement tuning. The parsed response (i.e., substring) will be passed to the reward functions. For example, the input prompt might be: > "Perform step-by-step thoughts first to problem A, finally output answer in the <ans> </ans> block." The sample response from the model under tuning might look like: > "<ans>Yes</ans>" Here, users can define the following parse config: ``` { "parseType": "REGEX_EXTRACT", "regexExtractExpression": ".*(.*?)" } ``` The resulting parsed response would be `"Yes"` and will be passed to the reward functions for evaluating rewards. This data type is not supported in Gemini API. */
|
|
10718
11222
|
export declare class ReinforcementTuningParseResponseConfig {
|
|
10719
|
-
/** Defines
|
|
11223
|
+
/** Defines the type for parsing sample response. */
|
|
10720
11224
|
parseType?: ResponseParseType;
|
|
10721
|
-
/** Defines the regex
|
|
11225
|
+
/** Defines the regex for extracting the important part of sample response. This field is only used when parse_type is ResponseParseType.REGEX_EXTRACT. */
|
|
10722
11226
|
regexExtractExpression?: string;
|
|
10723
11227
|
}
|
|
10724
11228
|
|
|
@@ -10726,16 +11230,17 @@ export declare class ReinforcementTuningParseResponseConfig {
|
|
|
10726
11230
|
export declare interface ReinforcementTuningRewardInfo {
|
|
10727
11231
|
/** Output only. The calculated reward for the reward function. */
|
|
10728
11232
|
reward?: number;
|
|
10729
|
-
/** Output only. The user-requested auxiliary info for the reward function. */
|
|
11233
|
+
/** Output only. The user-requested auxiliary info for the reward function. This field is set only if the Cloud Run reward function configured by user returns a "user_requested_aux_info". Refer to ReinforcementTuningCloudRunRewardScorer for more details. */
|
|
10730
11234
|
userRequestedAuxInfo?: string;
|
|
10731
11235
|
}
|
|
10732
11236
|
|
|
10733
11237
|
/** Reinforcement tuning spec for tuning. */
|
|
10734
11238
|
export declare interface ReinforcementTuningSpec {
|
|
11239
|
+
/** Composite reward function configuration for reinforcement tuning. */
|
|
10735
11240
|
compositeRewardConfig?: CompositeReinforcementTuningRewardConfig;
|
|
10736
|
-
/** Cloud Storage path to file containing training dataset for tuning. The dataset must be formatted as a JSONL file. */
|
|
11241
|
+
/** Cloud Storage path to the file containing training dataset for tuning. The dataset must be formatted as a JSONL file. */
|
|
10737
11242
|
trainingDatasetUri?: string;
|
|
10738
|
-
/** Cloud Storage path to file containing validation dataset for tuning. The dataset must be formatted as a JSONL file.
|
|
11243
|
+
/** Cloud Storage path to the file containing validation dataset for tuning. The dataset must be formatted as a JSONL file. */
|
|
10739
11244
|
validationDatasetUri?: string;
|
|
10740
11245
|
/** Additional hyper-parameters to use during tuning. */
|
|
10741
11246
|
hyperParameters?: ReinforcementTuningHyperParameters;
|
|
@@ -10743,11 +11248,11 @@ export declare interface ReinforcementTuningSpec {
|
|
|
10743
11248
|
singleRewardConfig?: SingleReinforcementTuningRewardConfig;
|
|
10744
11249
|
}
|
|
10745
11250
|
|
|
10746
|
-
/**
|
|
11251
|
+
/** ReinforcementTuningStringMatchRewardScorer is used to score parsed responses for string matching use cases. For example, for math problems, users can use string match scorer to check if the correct exact answer is generated. Note: Reward returned by the string match reward function is clipped to be within `[-1, 1]` if wrongAnswerReward or correctAnswerReward are beyond the range, i.e., `reward = max(min(reward, 1.0), -1.0)`. This data type is not supported in Gemini API. */
|
|
10747
11252
|
export declare interface ReinforcementTuningStringMatchRewardScorer {
|
|
10748
|
-
/** Wrong answer reward is returned if
|
|
11253
|
+
/** Wrong answer reward is returned if the parsed response is evaluated as `false`. All wrong answers get the same reward. */
|
|
10749
11254
|
wrongAnswerReward?: number;
|
|
10750
|
-
/** Correct answer
|
|
11255
|
+
/** Correct answer rewawrd is returned if the parsed response is evaluated as `true`. All correct answers get the same reward. */
|
|
10751
11256
|
correctAnswerReward?: number;
|
|
10752
11257
|
/** Uses string match expression to evaluate parsed response. */
|
|
10753
11258
|
stringMatchExpression?: ReinforcementTuningStringMatchRewardScorerStringMatchExpression;
|
|
@@ -10755,19 +11260,19 @@ export declare interface ReinforcementTuningStringMatchRewardScorer {
|
|
|
10755
11260
|
jsonMatchExpression?: ReinforcementTuningStringMatchRewardScorerJsonMatchExpression;
|
|
10756
11261
|
}
|
|
10757
11262
|
|
|
10758
|
-
/**
|
|
11263
|
+
/** JsonMatchExpression supports converting the parsed responses to JSON format, finding the value in the JSON response that matches the key_name in the first level, and performing StringMatchExpression operation on the matched JSON value. This data type is not supported in Gemini API. */
|
|
10759
11264
|
export declare interface ReinforcementTuningStringMatchRewardScorerJsonMatchExpression {
|
|
10760
|
-
/**
|
|
11265
|
+
/** The key name to find the value in the parsed response that's in JSON format. Only first-level key matching is supported. */
|
|
10761
11266
|
keyName?: string;
|
|
10762
|
-
/** String match expression to match against the value of
|
|
11267
|
+
/** String match expression to match against the extracted value from the JSON representation of the parsed response. */
|
|
10763
11268
|
valueStringMatchExpression?: ReinforcementTuningStringMatchRewardScorerStringMatchExpression;
|
|
10764
11269
|
}
|
|
10765
11270
|
|
|
10766
|
-
/** Evaluates parsed response using match type against expression. */
|
|
11271
|
+
/** Evaluates parsed response using match type against the expression. Returns `true` if `MatchOperation(target, expression)` evaluates to `true`, and `false` otherwise. This data type is not supported in Gemini API. */
|
|
10767
11272
|
export declare interface ReinforcementTuningStringMatchRewardScorerStringMatchExpression {
|
|
10768
|
-
/** Match operation to use for
|
|
11273
|
+
/** Match operation to use for evaluating rewards. */
|
|
10769
11274
|
matchOperation?: MatchOperation;
|
|
10770
|
-
/**
|
|
11275
|
+
/** A string or a regular expression to match against for evaluating rewards. Users can also provide a references map of `{key: value}` whose `value` will be used to replace the placeholder {{references.key}} in the expression. For example, if the following `references` are defined in the training / validation dataset: ``` { "systemInstruction": ..., "contents": ..., "references": { "concise_answer": "Yes", "verbose_answer": "The answer is Yes" } } ``` and if users define the following StringMatchExpression: { "matchOperation": "REGEX_CONTAINS", "expression": ".*{{references.concise_answer}}.*" } On evaluating the reward for each sample response, this StringMatchExpression will be substituted as: ``` { "matchOperation": "REGEX_CONTAINS", "expression": ".*Yes.*" } ``` */
|
|
10771
11276
|
expression?: string;
|
|
10772
11277
|
}
|
|
10773
11278
|
|
|
@@ -10787,6 +11292,12 @@ export declare enum ReinforcementTuningThinkingLevel {
|
|
|
10787
11292
|
HIGH = "HIGH"
|
|
10788
11293
|
}
|
|
10789
11294
|
|
|
11295
|
+
/** Sample reinforcement tuning user data in the training dataset. The contents are truncated for better UI showing. This data type is not supported in Gemini API. */
|
|
11296
|
+
export declare interface ReinforcementTuningUserDatasetExamples {
|
|
11297
|
+
/** List of user datasset examples showing to user. */
|
|
11298
|
+
userDatasetExamples?: ReinforcementTuningExample[];
|
|
11299
|
+
}
|
|
11300
|
+
|
|
10790
11301
|
/** Represents a recorded session. */
|
|
10791
11302
|
export declare interface ReplayFile {
|
|
10792
11303
|
replayId?: string;
|
|
@@ -10826,6 +11337,17 @@ export declare interface ReplicatedVoiceConfig {
|
|
|
10826
11337
|
|
|
10827
11338
|
* @remarks Encoded as base64 string. */
|
|
10828
11339
|
voiceSampleAudio?: string;
|
|
11340
|
+
/** Recorded consent verifying ownership of the voice. This
|
|
11341
|
+
represents 16-bit signed little-endian wav data, with a 24kHz sampling
|
|
11342
|
+
rate.
|
|
11343
|
+
* @remarks Encoded as base64 string. */
|
|
11344
|
+
consentAudio?: string;
|
|
11345
|
+
/** Signature of a previously verified consent audio. This should be
|
|
11346
|
+
populated with a signature generated by the server for a previous
|
|
11347
|
+
request containing the consent_audio field. When provided, the
|
|
11348
|
+
signature is verified instead of the consent_audio field to reduce
|
|
11349
|
+
latency. Requests will fail if the signature is invalid or expired. */
|
|
11350
|
+
voiceConsentSignature?: VoiceConsentSignature;
|
|
10829
11351
|
}
|
|
10830
11352
|
|
|
10831
11353
|
declare type RequestOptions = {
|
|
@@ -10882,7 +11404,19 @@ export declare enum ResourceScope {
|
|
|
10882
11404
|
COLLECTION = "COLLECTION"
|
|
10883
11405
|
}
|
|
10884
11406
|
|
|
10885
|
-
|
|
11407
|
+
/** Configuration for the model to configure output formatting and delivery. This data type is not supported in Gemini API. */
|
|
11408
|
+
export declare class ResponseFormat {
|
|
11409
|
+
/** Audio output format. */
|
|
11410
|
+
audio?: AudioResponseFormat;
|
|
11411
|
+
/** Image output format. */
|
|
11412
|
+
image?: ImageResponseFormat;
|
|
11413
|
+
/** Text output format. */
|
|
11414
|
+
text?: TextResponseFormat;
|
|
11415
|
+
/** Video output format. */
|
|
11416
|
+
video?: VideoResponseFormat;
|
|
11417
|
+
}
|
|
11418
|
+
|
|
11419
|
+
declare type ResponseFormat_2 = AudioResponseFormat_2 | TextResponseFormat_2 | ImageResponseFormat_2 | VideoResponseFormat_2 | {
|
|
10886
11420
|
[k: string]: any;
|
|
10887
11421
|
};
|
|
10888
11422
|
|
|
@@ -10895,18 +11429,18 @@ declare type ResponseFormat = AudioResponseFormat | TextResponseFormat | ImageRe
|
|
|
10895
11429
|
*/
|
|
10896
11430
|
declare type ResponseModality = "text" | "image" | "audio" | "video" | "document" | (string & {});
|
|
10897
11431
|
|
|
10898
|
-
/** Defines
|
|
11432
|
+
/** Defines the type for parsing sample response. This enum is not supported in Gemini API. */
|
|
10899
11433
|
export declare enum ResponseParseType {
|
|
10900
11434
|
/**
|
|
10901
|
-
* Default value.
|
|
11435
|
+
* Default value. Fallback to IDENTITY
|
|
10902
11436
|
*/
|
|
10903
11437
|
RESPONSE_PARSE_TYPE_UNSPECIFIED = "RESPONSE_PARSE_TYPE_UNSPECIFIED",
|
|
10904
11438
|
/**
|
|
10905
|
-
*
|
|
11439
|
+
* Returns the sample response as is.
|
|
10906
11440
|
*/
|
|
10907
11441
|
IDENTITY = "IDENTITY",
|
|
10908
11442
|
/**
|
|
10909
|
-
*
|
|
11443
|
+
* Uses regex to extract the important part of sample response. Similar to [GoogleSQL](https://cloud.google.com/bigquery/docs/reference/standard-sql/string_functions#regexp_extract) `REGEX_EXTRACT(response, regex_extract_expression)`, but different in that if there are multiple matches, the last match will be returned.
|
|
10910
11444
|
*/
|
|
10911
11445
|
REGEX_EXTRACT = "REGEX_EXTRACT"
|
|
10912
11446
|
}
|
|
@@ -10935,29 +11469,77 @@ export declare interface Retrieval {
|
|
|
10935
11469
|
* A tool that can be used by the model to retrieve files.
|
|
10936
11470
|
*/
|
|
10937
11471
|
declare type Retrieval_2 = {
|
|
10938
|
-
|
|
11472
|
+
/**
|
|
11473
|
+
* Used to specify configuration for ExaAISearch.
|
|
11474
|
+
*/
|
|
11475
|
+
exa_ai_search_config?: ExaAISearchConfig | undefined;
|
|
11476
|
+
/**
|
|
11477
|
+
* Used to specify configuration for ParallelAISearch.
|
|
11478
|
+
*/
|
|
11479
|
+
parallel_ai_search_config?: ParallelAISearchConfig | undefined;
|
|
11480
|
+
/**
|
|
11481
|
+
* Use to specify configuration for RAG Store.
|
|
11482
|
+
*/
|
|
11483
|
+
rag_store_config?: RagStoreConfig | undefined;
|
|
10939
11484
|
/**
|
|
10940
11485
|
* The types of file retrieval to enable.
|
|
10941
11486
|
*/
|
|
10942
|
-
retrieval_types?: Array<
|
|
11487
|
+
retrieval_types?: Array<RetrievalRetrievalType> | undefined;
|
|
11488
|
+
type: "retrieval";
|
|
10943
11489
|
/**
|
|
10944
11490
|
* Used to specify configuration for VertexAISearch.
|
|
10945
11491
|
*/
|
|
10946
11492
|
vertex_ai_search_config?: VertexAISearchConfig | undefined;
|
|
11493
|
+
};
|
|
11494
|
+
|
|
11495
|
+
declare type RetrievalCallArguments$ = RetrievalCallArguments;
|
|
11496
|
+
|
|
11497
|
+
/**
|
|
11498
|
+
* @license
|
|
11499
|
+
* Copyright 2026 Google LLC
|
|
11500
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
11501
|
+
*
|
|
11502
|
+
* g3-prettier-ignore-file
|
|
11503
|
+
*/
|
|
11504
|
+
/**
|
|
11505
|
+
* The arguments to pass to Retrieval tools.
|
|
11506
|
+
*/
|
|
11507
|
+
declare type RetrievalCallArguments = {
|
|
10947
11508
|
/**
|
|
10948
|
-
*
|
|
11509
|
+
* Queries for Retrieval information.
|
|
10949
11510
|
*/
|
|
10950
|
-
|
|
11511
|
+
queries?: Array<string> | undefined;
|
|
11512
|
+
};
|
|
11513
|
+
|
|
11514
|
+
declare type RetrievalCallDelta$ = RetrievalCallDelta;
|
|
11515
|
+
|
|
11516
|
+
/**
|
|
11517
|
+
* Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search,
|
|
11518
|
+
*
|
|
11519
|
+
* @remarks
|
|
11520
|
+
* etc. RetrievalType decides which tool is used.
|
|
11521
|
+
*/
|
|
11522
|
+
declare type RetrievalCallDelta = {
|
|
10951
11523
|
/**
|
|
10952
|
-
*
|
|
11524
|
+
* The arguments to pass to Retrieval tools.
|
|
10953
11525
|
*/
|
|
10954
|
-
|
|
11526
|
+
arguments: RetrievalCallArguments;
|
|
10955
11527
|
/**
|
|
10956
|
-
*
|
|
11528
|
+
* The type of retrieval tools.
|
|
10957
11529
|
*/
|
|
10958
|
-
|
|
11530
|
+
retrieval_type?: RetrievalCallDeltaRetrievalType | undefined;
|
|
11531
|
+
/**
|
|
11532
|
+
* A signature hash for backend validation.
|
|
11533
|
+
*/
|
|
11534
|
+
signature?: string | undefined;
|
|
11535
|
+
type: "retrieval_call";
|
|
10959
11536
|
};
|
|
10960
11537
|
|
|
11538
|
+
/**
|
|
11539
|
+
* The type of retrieval tools.
|
|
11540
|
+
*/
|
|
11541
|
+
declare type RetrievalCallDeltaRetrievalType = "vertex_ai_search" | "rag_store" | "exa_ai_search" | "parallel_ai_search" | (string & {});
|
|
11542
|
+
|
|
10961
11543
|
/** Retrieval config. */
|
|
10962
11544
|
export declare interface RetrievalConfig {
|
|
10963
11545
|
/** The location of the user. */
|
|
@@ -10977,7 +11559,35 @@ export declare interface RetrievalMetadata {
|
|
|
10977
11559
|
googleSearchDynamicRetrievalScore?: number;
|
|
10978
11560
|
}
|
|
10979
11561
|
|
|
10980
|
-
declare type
|
|
11562
|
+
declare type RetrievalResultDelta$ = RetrievalResultDelta;
|
|
11563
|
+
|
|
11564
|
+
/**
|
|
11565
|
+
* @license
|
|
11566
|
+
* Copyright 2026 Google LLC
|
|
11567
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
11568
|
+
*
|
|
11569
|
+
* g3-prettier-ignore-file
|
|
11570
|
+
*/
|
|
11571
|
+
/**
|
|
11572
|
+
* Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search,
|
|
11573
|
+
*
|
|
11574
|
+
* @remarks
|
|
11575
|
+
* etc.
|
|
11576
|
+
* ToolResultDelta.type
|
|
11577
|
+
*/
|
|
11578
|
+
declare type RetrievalResultDelta = {
|
|
11579
|
+
/**
|
|
11580
|
+
* Whether the retrieval resulted in an error.
|
|
11581
|
+
*/
|
|
11582
|
+
is_error?: boolean | undefined;
|
|
11583
|
+
/**
|
|
11584
|
+
* A signature hash for backend validation.
|
|
11585
|
+
*/
|
|
11586
|
+
signature?: string | undefined;
|
|
11587
|
+
type: "retrieval_result";
|
|
11588
|
+
};
|
|
11589
|
+
|
|
11590
|
+
declare type RetrievalRetrievalType = "vertex_ai_search" | "rag_store" | "exa_ai_search" | "parallel_ai_search" | (string & {});
|
|
10981
11591
|
|
|
10982
11592
|
declare type RetryConfig = {
|
|
10983
11593
|
strategy: "none";
|
|
@@ -11012,6 +11622,10 @@ declare type ReviewSnippet$3 = ReviewSnippet;
|
|
|
11012
11622
|
* the features of a specific place in Google Maps.
|
|
11013
11623
|
*/
|
|
11014
11624
|
declare type ReviewSnippet = {
|
|
11625
|
+
/**
|
|
11626
|
+
* The ID of the review snippet.
|
|
11627
|
+
*/
|
|
11628
|
+
review_id?: string | undefined;
|
|
11015
11629
|
/**
|
|
11016
11630
|
* Title of the review.
|
|
11017
11631
|
*/
|
|
@@ -11020,10 +11634,6 @@ declare type ReviewSnippet = {
|
|
|
11020
11634
|
* A link that corresponds to the user review on Google Maps.
|
|
11021
11635
|
*/
|
|
11022
11636
|
url?: string | undefined;
|
|
11023
|
-
/**
|
|
11024
|
-
* The ID of the review snippet.
|
|
11025
|
-
*/
|
|
11026
|
-
review_id?: string | undefined;
|
|
11027
11637
|
};
|
|
11028
11638
|
|
|
11029
11639
|
/**
|
|
@@ -11056,6 +11666,19 @@ export declare interface RougeMetricValue {
|
|
|
11056
11666
|
score?: number;
|
|
11057
11667
|
}
|
|
11058
11668
|
|
|
11669
|
+
declare type RunTriggerParams = Omit<RunTriggerRequest, "trigger_id">;
|
|
11670
|
+
|
|
11671
|
+
declare type RunTriggerRequest = {
|
|
11672
|
+
/**
|
|
11673
|
+
* Which version of the API to use.
|
|
11674
|
+
*/
|
|
11675
|
+
api_version?: string | undefined;
|
|
11676
|
+
/**
|
|
11677
|
+
* Resource name of the trigger.
|
|
11678
|
+
*/
|
|
11679
|
+
trigger_id: string;
|
|
11680
|
+
};
|
|
11681
|
+
|
|
11059
11682
|
/** Safety attributes of a GeneratedImage or the user-provided prompt. */
|
|
11060
11683
|
export declare interface SafetyAttributes {
|
|
11061
11684
|
/** List of RAI categories. */
|
|
@@ -11128,6 +11751,8 @@ export declare interface SafetyRating {
|
|
|
11128
11751
|
severityScore?: number;
|
|
11129
11752
|
}
|
|
11130
11753
|
|
|
11754
|
+
declare type SafetySetting$ = SafetySetting_2;
|
|
11755
|
+
|
|
11131
11756
|
/** A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category. */
|
|
11132
11757
|
export declare interface SafetySetting {
|
|
11133
11758
|
/** Required. The harm category to be blocked. */
|
|
@@ -11138,6 +11763,34 @@ export declare interface SafetySetting {
|
|
|
11138
11763
|
threshold?: HarmBlockThreshold;
|
|
11139
11764
|
}
|
|
11140
11765
|
|
|
11766
|
+
/**
|
|
11767
|
+
* A safety setting that affects the safety-blocking behavior.
|
|
11768
|
+
*
|
|
11769
|
+
* @remarks
|
|
11770
|
+
*
|
|
11771
|
+
* A SafetySetting consists of a
|
|
11772
|
+
* harm category and a
|
|
11773
|
+
* threshold for that
|
|
11774
|
+
* category.
|
|
11775
|
+
*/
|
|
11776
|
+
declare type SafetySetting_2 = {
|
|
11777
|
+
/**
|
|
11778
|
+
* Optional. The method for blocking content. If not specified, the default
|
|
11779
|
+
*
|
|
11780
|
+
* @remarks
|
|
11781
|
+
* behavior is to use the probability score.
|
|
11782
|
+
*/
|
|
11783
|
+
method?: Method | undefined;
|
|
11784
|
+
/**
|
|
11785
|
+
* Required. The threshold for blocking content. If the harm probability
|
|
11786
|
+
*
|
|
11787
|
+
* @remarks
|
|
11788
|
+
* exceeds this threshold, the content will be blocked.
|
|
11789
|
+
*/
|
|
11790
|
+
threshold: Threshold;
|
|
11791
|
+
type: HarmCategory_2;
|
|
11792
|
+
};
|
|
11793
|
+
|
|
11141
11794
|
/** Scale of the generated music. */
|
|
11142
11795
|
export declare enum Scale {
|
|
11143
11796
|
/**
|
|
@@ -11418,6 +12071,7 @@ declare type ServiceTier_2 = "flex" | "standard" | "priority" | (string & {});
|
|
|
11418
12071
|
export declare class Session {
|
|
11419
12072
|
readonly conn: WebSocket_2;
|
|
11420
12073
|
private readonly apiClient;
|
|
12074
|
+
setupComplete?: types.LiveServerSetupComplete;
|
|
11421
12075
|
constructor(conn: WebSocket_2, apiClient: ApiClient);
|
|
11422
12076
|
private tLiveClientContent;
|
|
11423
12077
|
private tLiveClienttToolResponse;
|
|
@@ -11535,6 +12189,28 @@ export declare class Session {
|
|
|
11535
12189
|
close(): void;
|
|
11536
12190
|
}
|
|
11537
12191
|
|
|
12192
|
+
declare type SessionConfig$ = SessionConfig;
|
|
12193
|
+
|
|
12194
|
+
/**
|
|
12195
|
+
* @license
|
|
12196
|
+
* Copyright 2026 Google LLC
|
|
12197
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
12198
|
+
*
|
|
12199
|
+
* g3-prettier-ignore-file
|
|
12200
|
+
*/
|
|
12201
|
+
/**
|
|
12202
|
+
* The configuration of CodeMender sessions.
|
|
12203
|
+
*/
|
|
12204
|
+
declare type SessionConfig = {
|
|
12205
|
+
/**
|
|
12206
|
+
* The maximum number of interaction rounds the agent is allowed to perform
|
|
12207
|
+
*
|
|
12208
|
+
* @remarks
|
|
12209
|
+
* before reaching a timeout.
|
|
12210
|
+
*/
|
|
12211
|
+
max_rounds?: number | undefined;
|
|
12212
|
+
};
|
|
12213
|
+
|
|
11538
12214
|
/** Configuration of session resumption mechanism.
|
|
11539
12215
|
|
|
11540
12216
|
Included in `LiveConnectConfig.session_resumption`. If included server
|
|
@@ -11583,14 +12259,14 @@ declare type SigningSecret$ = SigningSecret;
|
|
|
11583
12259
|
* Represents a signing secret used to verify webhook payloads.
|
|
11584
12260
|
*/
|
|
11585
12261
|
declare type SigningSecret = {
|
|
11586
|
-
/**
|
|
11587
|
-
* Output only. The truncated version of the signing secret.
|
|
11588
|
-
*/
|
|
11589
|
-
truncated_secret?: string | undefined;
|
|
11590
12262
|
/**
|
|
11591
12263
|
* Output only. The expiration date of the signing secret.
|
|
11592
12264
|
*/
|
|
11593
12265
|
expire_time?: string | undefined;
|
|
12266
|
+
/**
|
|
12267
|
+
* Output only. The truncated version of the signing secret.
|
|
12268
|
+
*/
|
|
12269
|
+
truncated_secret?: string | undefined;
|
|
11594
12270
|
};
|
|
11595
12271
|
|
|
11596
12272
|
/** Config for `response` parameter. */
|
|
@@ -11607,15 +12283,15 @@ export declare class SingleEmbedContentResponse {
|
|
|
11607
12283
|
export declare interface SingleReinforcementTuningRewardConfig {
|
|
11608
12284
|
/** Scores parsed responses for autorater use cases by using a model to compute the reward. */
|
|
11609
12285
|
autoraterScorer?: ReinforcementTuningAutoraterScorer;
|
|
11610
|
-
/** A unique reward name
|
|
12286
|
+
/** A unique reward name for identifying each single reinforcement tuning reward. */
|
|
11611
12287
|
rewardName?: string;
|
|
11612
|
-
/** Defines how to parse sample response. */
|
|
12288
|
+
/** Defines how to parse sample response. For example, given a sample response for evaluating the reward, users might want to extract the text only between `` and `` in the sample response, and keeps only the last one in case there are multiple such tags. To achieve such a purpose, they can define a regex `".*(.*?)"` using the ReinforcementTuningParseResponseConfig.ResponseParseType.REGEX_EXTRACT parse type. */
|
|
11613
12289
|
parseResponseConfig?: ReinforcementTuningParseResponseConfig;
|
|
11614
|
-
/**
|
|
12290
|
+
/** ReinforcementTuningCodeExecutionRewardScorer is used to score parsed responses for code execution use cases. */
|
|
11615
12291
|
codeExecutionRewardScorer?: ReinforcementTuningCodeExecutionRewardScorer;
|
|
11616
|
-
/**
|
|
12292
|
+
/** ReinforcementTuningStringMatchRewardScorer is used to score parsed responses for simple string matching use cases against reference answers. */
|
|
11617
12293
|
stringMatchRewardScorer?: ReinforcementTuningStringMatchRewardScorer;
|
|
11618
|
-
/**
|
|
12294
|
+
/** ReinforcementTuningCloudRunRewardScorer is used to score parsed responses by calling a Cloud Run service. */
|
|
11619
12295
|
cloudRunRewardScorer?: ReinforcementTuningCloudRunRewardScorer;
|
|
11620
12296
|
}
|
|
11621
12297
|
|
|
@@ -11636,7 +12312,14 @@ declare type Source$ = Source;
|
|
|
11636
12312
|
* A source to be mounted into the environment.
|
|
11637
12313
|
*/
|
|
11638
12314
|
declare type Source = {
|
|
11639
|
-
|
|
12315
|
+
/**
|
|
12316
|
+
* The inline content if `type` is `INLINE`.
|
|
12317
|
+
*/
|
|
12318
|
+
content?: string | undefined;
|
|
12319
|
+
/**
|
|
12320
|
+
* Optional encoding for inline content (e.g. `base64`).
|
|
12321
|
+
*/
|
|
12322
|
+
encoding?: string | undefined;
|
|
11640
12323
|
/**
|
|
11641
12324
|
* The source of the environment.
|
|
11642
12325
|
*
|
|
@@ -11649,16 +12332,13 @@ declare type Source = {
|
|
|
11649
12332
|
* Where the source should appear in the environment.
|
|
11650
12333
|
*/
|
|
11651
12334
|
target?: string | undefined;
|
|
11652
|
-
|
|
11653
|
-
* The inline content if `type` is `INLINE`.
|
|
11654
|
-
*/
|
|
11655
|
-
content?: string | undefined;
|
|
11656
|
-
/**
|
|
11657
|
-
* Optional encoding for inline content (e.g. `base64`).
|
|
11658
|
-
*/
|
|
11659
|
-
encoding?: string | undefined;
|
|
12335
|
+
type?: SourceType | undefined;
|
|
11660
12336
|
};
|
|
11661
12337
|
|
|
12338
|
+
declare type SourceFile$ = FileContent;
|
|
12339
|
+
|
|
12340
|
+
declare type SourceFile$2 = FileContent;
|
|
12341
|
+
|
|
11662
12342
|
/**
|
|
11663
12343
|
* @license
|
|
11664
12344
|
* Copyright 2026 Google LLC
|
|
@@ -11699,10 +12379,6 @@ export declare interface SpeechConfig {
|
|
|
11699
12379
|
* The configuration for speech interaction.
|
|
11700
12380
|
*/
|
|
11701
12381
|
declare type SpeechConfig_2 = {
|
|
11702
|
-
/**
|
|
11703
|
-
* The voice of the speaker.
|
|
11704
|
-
*/
|
|
11705
|
-
voice?: string | undefined;
|
|
11706
12382
|
/**
|
|
11707
12383
|
* The language of the speech.
|
|
11708
12384
|
*/
|
|
@@ -11711,6 +12387,10 @@ declare type SpeechConfig_2 = {
|
|
|
11711
12387
|
* The speaker's name, it should match the speaker name given in the prompt.
|
|
11712
12388
|
*/
|
|
11713
12389
|
speaker?: string | undefined;
|
|
12390
|
+
/**
|
|
12391
|
+
* The voice of the speaker.
|
|
12392
|
+
*/
|
|
12393
|
+
voice?: string | undefined;
|
|
11714
12394
|
};
|
|
11715
12395
|
|
|
11716
12396
|
export declare type SpeechConfigUnion = SpeechConfig | string;
|
|
@@ -11761,14 +12441,6 @@ declare type Status = {
|
|
|
11761
12441
|
* The status code, which should be an enum value of google.rpc.Code.
|
|
11762
12442
|
*/
|
|
11763
12443
|
code?: number | undefined;
|
|
11764
|
-
/**
|
|
11765
|
-
* A developer-facing error message, which should be in English. Any
|
|
11766
|
-
*
|
|
11767
|
-
* @remarks
|
|
11768
|
-
* user-facing error message should be localized and sent in the
|
|
11769
|
-
* google.rpc.Status.details field, or localized by the client.
|
|
11770
|
-
*/
|
|
11771
|
-
message?: string | undefined;
|
|
11772
12444
|
/**
|
|
11773
12445
|
* A list of messages that carry the error details. There is a common set of
|
|
11774
12446
|
*
|
|
@@ -11778,6 +12450,14 @@ declare type Status = {
|
|
|
11778
12450
|
details?: Array<{
|
|
11779
12451
|
[k: string]: any;
|
|
11780
12452
|
}> | undefined;
|
|
12453
|
+
/**
|
|
12454
|
+
* A developer-facing error message, which should be in English. Any
|
|
12455
|
+
*
|
|
12456
|
+
* @remarks
|
|
12457
|
+
* user-facing error message should be localized and sent in the
|
|
12458
|
+
* google.rpc.Status.details field, or localized by the client.
|
|
12459
|
+
*/
|
|
12460
|
+
message?: string | undefined;
|
|
11781
12461
|
};
|
|
11782
12462
|
|
|
11783
12463
|
declare type Step$ = Step;
|
|
@@ -11790,8 +12470,6 @@ declare type Step = UserInputStep | ModelOutputStep | ThoughtStep | FunctionCall
|
|
|
11790
12470
|
declare type StepDelta$ = StepDelta;
|
|
11791
12471
|
|
|
11792
12472
|
declare type StepDelta = {
|
|
11793
|
-
event_type: "step.delta";
|
|
11794
|
-
index: number;
|
|
11795
12473
|
delta: StepDeltaData;
|
|
11796
12474
|
/**
|
|
11797
12475
|
* The event_id token to be used to resume the interaction stream, from
|
|
@@ -11800,13 +12478,15 @@ declare type StepDelta = {
|
|
|
11800
12478
|
* this event.
|
|
11801
12479
|
*/
|
|
11802
12480
|
event_id?: string | undefined;
|
|
12481
|
+
event_type: "step.delta";
|
|
12482
|
+
index: number;
|
|
11803
12483
|
/**
|
|
11804
12484
|
* Optional metadata accompanying ANY streamed event.
|
|
11805
12485
|
*/
|
|
11806
12486
|
metadata?: StepDeltaMetadata | undefined;
|
|
11807
12487
|
};
|
|
11808
12488
|
|
|
11809
|
-
declare type StepDeltaData = TextDelta | ImageDelta | AudioDelta | DocumentDelta | VideoDelta | ThoughtSummaryDelta | ThoughtSignatureDelta | TextAnnotationDelta | ArgumentsDelta | CodeExecutionCallDelta | URLContextCallDelta | GoogleSearchCallDelta | MCPServerToolCallDelta | FileSearchCallDelta | GoogleMapsCallDelta | CodeExecutionResultDelta | URLContextResultDelta | GoogleSearchResultDelta | MCPServerToolResultDelta | FileSearchResultDelta | GoogleMapsResultDelta | FunctionResultDelta;
|
|
12489
|
+
declare type StepDeltaData = TextDelta | ImageDelta | AudioDelta | DocumentDelta | VideoDelta | ThoughtSummaryDelta | ThoughtSignatureDelta | TextAnnotationDelta | ArgumentsDelta | CodeExecutionCallDelta | URLContextCallDelta | GoogleSearchCallDelta | MCPServerToolCallDelta | FileSearchCallDelta | GoogleMapsCallDelta | RetrievalCallDelta | CodeExecutionResultDelta | URLContextResultDelta | GoogleSearchResultDelta | MCPServerToolResultDelta | FileSearchResultDelta | GoogleMapsResultDelta | RetrievalResultDelta | FunctionResultDelta;
|
|
11810
12490
|
|
|
11811
12491
|
/**
|
|
11812
12492
|
* Optional metadata accompanying ANY streamed event.
|
|
@@ -11821,12 +12501,6 @@ declare type StepDeltaMetadata = {
|
|
|
11821
12501
|
declare type StepStart$ = StepStart;
|
|
11822
12502
|
|
|
11823
12503
|
declare type StepStart = {
|
|
11824
|
-
event_type: "step.start";
|
|
11825
|
-
index: number;
|
|
11826
|
-
/**
|
|
11827
|
-
* A step in the interaction.
|
|
11828
|
-
*/
|
|
11829
|
-
step: Step;
|
|
11830
12504
|
/**
|
|
11831
12505
|
* The event_id token to be used to resume the interaction stream, from
|
|
11832
12506
|
*
|
|
@@ -11834,22 +12508,18 @@ declare type StepStart = {
|
|
|
11834
12508
|
* this event.
|
|
11835
12509
|
*/
|
|
11836
12510
|
event_id?: string | undefined;
|
|
12511
|
+
event_type: "step.start";
|
|
12512
|
+
index: number;
|
|
11837
12513
|
metadata?: StreamMetadata | undefined;
|
|
12514
|
+
/**
|
|
12515
|
+
* A step in the interaction.
|
|
12516
|
+
*/
|
|
12517
|
+
step: Step;
|
|
11838
12518
|
};
|
|
11839
12519
|
|
|
11840
12520
|
declare type StepStop$ = StepStop;
|
|
11841
12521
|
|
|
11842
12522
|
declare type StepStop = {
|
|
11843
|
-
event_type: "step.stop";
|
|
11844
|
-
index: number;
|
|
11845
|
-
/**
|
|
11846
|
-
* Statistics on the interaction request's token usage.
|
|
11847
|
-
*/
|
|
11848
|
-
usage?: Usage | undefined;
|
|
11849
|
-
/**
|
|
11850
|
-
* Statistics on the interaction request's token usage.
|
|
11851
|
-
*/
|
|
11852
|
-
step_usage?: Usage | undefined;
|
|
11853
12523
|
/**
|
|
11854
12524
|
* The event_id token to be used to resume the interaction stream, from
|
|
11855
12525
|
*
|
|
@@ -11857,7 +12527,17 @@ declare type StepStop = {
|
|
|
11857
12527
|
* this event.
|
|
11858
12528
|
*/
|
|
11859
12529
|
event_id?: string | undefined;
|
|
12530
|
+
event_type: "step.stop";
|
|
12531
|
+
index: number;
|
|
11860
12532
|
metadata?: StreamMetadata | undefined;
|
|
12533
|
+
/**
|
|
12534
|
+
* Statistics on the interaction request's token usage.
|
|
12535
|
+
*/
|
|
12536
|
+
step_usage?: Usage | undefined;
|
|
12537
|
+
/**
|
|
12538
|
+
* Statistics on the interaction request's token usage.
|
|
12539
|
+
*/
|
|
12540
|
+
usage?: Usage | undefined;
|
|
11861
12541
|
};
|
|
11862
12542
|
|
|
11863
12543
|
export declare class Stream<T> extends ReadableStream<T> {
|
|
@@ -12109,11 +12789,11 @@ declare type Text$ = TextDelta;
|
|
|
12109
12789
|
declare type TextAnnotationDelta$ = TextAnnotationDelta;
|
|
12110
12790
|
|
|
12111
12791
|
declare type TextAnnotationDelta = {
|
|
12112
|
-
type: "text_annotation_delta";
|
|
12113
12792
|
/**
|
|
12114
12793
|
* Citation information for model-generated content.
|
|
12115
12794
|
*/
|
|
12116
12795
|
annotations?: Array<Annotation> | undefined;
|
|
12796
|
+
type: "text_annotation_delta";
|
|
12117
12797
|
};
|
|
12118
12798
|
|
|
12119
12799
|
declare type TextContent$ = TextContent;
|
|
@@ -12122,15 +12802,15 @@ declare type TextContent$ = TextContent;
|
|
|
12122
12802
|
* A text content block.
|
|
12123
12803
|
*/
|
|
12124
12804
|
declare type TextContent = {
|
|
12125
|
-
type: "text";
|
|
12126
|
-
/**
|
|
12127
|
-
* Required. The text content.
|
|
12128
|
-
*/
|
|
12129
|
-
text: string;
|
|
12130
12805
|
/**
|
|
12131
12806
|
* Citation information for model-generated content.
|
|
12132
12807
|
*/
|
|
12133
12808
|
annotations?: Array<Annotation> | undefined;
|
|
12809
|
+
/**
|
|
12810
|
+
* Required. The text content.
|
|
12811
|
+
*/
|
|
12812
|
+
text: string;
|
|
12813
|
+
type: "text";
|
|
12134
12814
|
};
|
|
12135
12815
|
|
|
12136
12816
|
/**
|
|
@@ -12141,17 +12821,24 @@ declare type TextContent = {
|
|
|
12141
12821
|
* g3-prettier-ignore-file
|
|
12142
12822
|
*/
|
|
12143
12823
|
declare type TextDelta = {
|
|
12144
|
-
type: "text";
|
|
12145
12824
|
text: string;
|
|
12825
|
+
type: "text";
|
|
12146
12826
|
};
|
|
12147
12827
|
|
|
12148
|
-
declare type TextResponseFormat$ =
|
|
12828
|
+
declare type TextResponseFormat$ = TextResponseFormat_2;
|
|
12829
|
+
|
|
12830
|
+
/** Configuration for text-specific output formatting. */
|
|
12831
|
+
export declare class TextResponseFormat {
|
|
12832
|
+
/** Optional. The IANA standard MIME type of the response. */
|
|
12833
|
+
mimeType?: string;
|
|
12834
|
+
/** Optional. The JSON schema that the output should conform to. Only applicable when mime_type is APPLICATION_JSON. */
|
|
12835
|
+
schema?: unknown;
|
|
12836
|
+
}
|
|
12149
12837
|
|
|
12150
12838
|
/**
|
|
12151
12839
|
* Configuration for text output format.
|
|
12152
12840
|
*/
|
|
12153
|
-
declare type
|
|
12154
|
-
type: "text";
|
|
12841
|
+
declare type TextResponseFormat_2 = {
|
|
12155
12842
|
/**
|
|
12156
12843
|
* The MIME type of the text output.
|
|
12157
12844
|
*/
|
|
@@ -12165,6 +12852,7 @@ declare type TextResponseFormat = {
|
|
|
12165
12852
|
schema?: {
|
|
12166
12853
|
[k: string]: any;
|
|
12167
12854
|
} | undefined;
|
|
12855
|
+
type: "text";
|
|
12168
12856
|
};
|
|
12169
12857
|
|
|
12170
12858
|
/**
|
|
@@ -12245,11 +12933,11 @@ declare type ThoughtSignature$ = ThoughtSignatureDelta;
|
|
|
12245
12933
|
* g3-prettier-ignore-file
|
|
12246
12934
|
*/
|
|
12247
12935
|
declare type ThoughtSignatureDelta = {
|
|
12248
|
-
type: "thought_signature";
|
|
12249
12936
|
/**
|
|
12250
12937
|
* Signature to match the backend source to be part of the generation.
|
|
12251
12938
|
*/
|
|
12252
12939
|
signature?: string | undefined;
|
|
12940
|
+
type: "thought_signature";
|
|
12253
12941
|
};
|
|
12254
12942
|
|
|
12255
12943
|
declare type ThoughtStep$ = ThoughtStep;
|
|
@@ -12258,7 +12946,6 @@ declare type ThoughtStep$ = ThoughtStep;
|
|
|
12258
12946
|
* A thought step.
|
|
12259
12947
|
*/
|
|
12260
12948
|
declare type ThoughtStep = {
|
|
12261
|
-
type: "thought";
|
|
12262
12949
|
/**
|
|
12263
12950
|
* A signature hash for backend validation.
|
|
12264
12951
|
*/
|
|
@@ -12267,6 +12954,7 @@ declare type ThoughtStep = {
|
|
|
12267
12954
|
* A summary of the thought.
|
|
12268
12955
|
*/
|
|
12269
12956
|
summary?: Array<ThoughtSummaryContent> | undefined;
|
|
12957
|
+
type: "thought";
|
|
12270
12958
|
};
|
|
12271
12959
|
|
|
12272
12960
|
declare type ThoughtSummary$ = ThoughtSummaryDelta;
|
|
@@ -12274,13 +12962,21 @@ declare type ThoughtSummary$ = ThoughtSummaryDelta;
|
|
|
12274
12962
|
declare type ThoughtSummaryContent = TextContent | ImageContent;
|
|
12275
12963
|
|
|
12276
12964
|
declare type ThoughtSummaryDelta = {
|
|
12277
|
-
type: "thought_summary";
|
|
12278
12965
|
/**
|
|
12279
12966
|
* The content of the response.
|
|
12280
12967
|
*/
|
|
12281
12968
|
content?: Content_2 | undefined;
|
|
12969
|
+
type: "thought_summary";
|
|
12282
12970
|
};
|
|
12283
12971
|
|
|
12972
|
+
/**
|
|
12973
|
+
* Required. The threshold for blocking content. If the harm probability
|
|
12974
|
+
*
|
|
12975
|
+
* @remarks
|
|
12976
|
+
* exceeds this threshold, the content will be blocked.
|
|
12977
|
+
*/
|
|
12978
|
+
declare type Threshold = "block_low_and_above" | "block_medium_and_above" | "block_only_high" | "block_none" | "off" | (string & {});
|
|
12979
|
+
|
|
12284
12980
|
export declare class Tokens extends BaseModule {
|
|
12285
12981
|
private readonly apiClient;
|
|
12286
12982
|
constructor(apiClient: ApiClient);
|
|
@@ -12410,6 +13106,8 @@ export declare interface Tool {
|
|
|
12410
13106
|
urlContext?: UrlContext;
|
|
12411
13107
|
/** Optional. MCP Servers to connect to. This field is not supported in Vertex AI. */
|
|
12412
13108
|
mcpServers?: McpServer[];
|
|
13109
|
+
/** Optional. Uses Exa.ai to search for information to answer user queries. The search results will be grounded on Exa.ai and presented to the model for response generation. This field is not supported in Gemini API. */
|
|
13110
|
+
exaAiSearch?: ToolExaAiSearch;
|
|
12413
13111
|
}
|
|
12414
13112
|
|
|
12415
13113
|
/**
|
|
@@ -12474,6 +13172,14 @@ export declare interface ToolConfig {
|
|
|
12474
13172
|
includeServerSideToolInvocations?: boolean;
|
|
12475
13173
|
}
|
|
12476
13174
|
|
|
13175
|
+
/** ExaAiSearch tool type. A tool that uses the Exa.ai search engine for grounding. This data type is not supported in Gemini API. */
|
|
13176
|
+
export declare interface ToolExaAiSearch {
|
|
13177
|
+
/** Required. The API key for ExaAiSearch. */
|
|
13178
|
+
apiKey?: string;
|
|
13179
|
+
/** Optional. This field can be used to pass any parameter from the Exa.ai Search API. */
|
|
13180
|
+
customConfigs?: Record<string, unknown>;
|
|
13181
|
+
}
|
|
13182
|
+
|
|
12477
13183
|
export declare type ToolListUnion = ToolUnion[];
|
|
12478
13184
|
|
|
12479
13185
|
/** ParallelAiSearch tool type. A tool that uses the Parallel.ai search engine for grounding. This data type is not supported in Gemini API. */
|
|
@@ -12565,17 +13271,291 @@ export declare interface Transcription {
|
|
|
12565
13271
|
languageCode?: string;
|
|
12566
13272
|
}
|
|
12567
13273
|
|
|
13274
|
+
/**
|
|
13275
|
+
* @license
|
|
13276
|
+
* Copyright 2026 Google LLC
|
|
13277
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
13278
|
+
*
|
|
13279
|
+
* g3-prettier-ignore-file
|
|
13280
|
+
*/
|
|
13281
|
+
/**
|
|
13282
|
+
* Headers to inject on all outbound requests matching this domain. Accepts a single dict or a list of dicts. The egress proxy injects these automatically.
|
|
13283
|
+
*/
|
|
13284
|
+
declare type Transform = {
|
|
13285
|
+
[k: string]: string;
|
|
13286
|
+
} | Array<{
|
|
13287
|
+
[k: string]: string;
|
|
13288
|
+
}>;
|
|
13289
|
+
|
|
12568
13290
|
/** Config for stream translation. */
|
|
12569
13291
|
export declare interface TranslationConfig {
|
|
12570
|
-
/** If true, the model will generate audio when the target language is
|
|
12571
|
-
spoken, essentially it will parrot the input. If false, we will not produce
|
|
12572
|
-
audio for the target language. */
|
|
13292
|
+
/** Optional. If true, the model will generate audio when the target language is spoken, essentially it will parrot the input. If false, we will not produce audio for the target language. */
|
|
12573
13293
|
echoTargetLanguage?: boolean;
|
|
12574
|
-
/** The target language for translation. Supported values are BCP-47
|
|
12575
|
-
language codes (e.g. "en", "es", "fr"). */
|
|
13294
|
+
/** Required. The target language for translation. Supported values are BCP-47 language codes (e.g. "en", "es", "fr"). */
|
|
12576
13295
|
targetLanguageCode?: string;
|
|
12577
13296
|
}
|
|
12578
13297
|
|
|
13298
|
+
declare type Trigger$ = Trigger;
|
|
13299
|
+
|
|
13300
|
+
/**
|
|
13301
|
+
* A trigger configuration that is scheduled to run an agent.
|
|
13302
|
+
*/
|
|
13303
|
+
declare type Trigger = {
|
|
13304
|
+
/**
|
|
13305
|
+
* Output only. The number of consecutive failures that have occurred
|
|
13306
|
+
*
|
|
13307
|
+
* @remarks
|
|
13308
|
+
* since the last successful execution.
|
|
13309
|
+
*/
|
|
13310
|
+
consecutive_failure_count?: number | undefined;
|
|
13311
|
+
/**
|
|
13312
|
+
* Output only. The time when the trigger was created.
|
|
13313
|
+
*/
|
|
13314
|
+
create_time?: string | undefined;
|
|
13315
|
+
/**
|
|
13316
|
+
* Optional. The display name of the trigger.
|
|
13317
|
+
*/
|
|
13318
|
+
display_name?: string | undefined;
|
|
13319
|
+
/**
|
|
13320
|
+
* Optional. The environment ID for the trigger execution.
|
|
13321
|
+
*/
|
|
13322
|
+
environment_id?: string | undefined;
|
|
13323
|
+
/**
|
|
13324
|
+
* Optional. The execution timeout for the triggered interaction.
|
|
13325
|
+
*/
|
|
13326
|
+
execution_timeout_seconds?: number | undefined;
|
|
13327
|
+
/**
|
|
13328
|
+
* Required. Output only. Identifier. The ID of the trigger.
|
|
13329
|
+
*/
|
|
13330
|
+
id: string;
|
|
13331
|
+
/**
|
|
13332
|
+
* The Interaction resource.
|
|
13333
|
+
*/
|
|
13334
|
+
interaction: interactions.Interaction;
|
|
13335
|
+
/**
|
|
13336
|
+
* Output only. The time when the trigger was last paused.
|
|
13337
|
+
*/
|
|
13338
|
+
last_pause_time?: string | undefined;
|
|
13339
|
+
/**
|
|
13340
|
+
* Output only. The time when the trigger was last resumed.
|
|
13341
|
+
*/
|
|
13342
|
+
last_resume_time?: string | undefined;
|
|
13343
|
+
/**
|
|
13344
|
+
* Output only. The time when the trigger was last run.
|
|
13345
|
+
*/
|
|
13346
|
+
last_run_time?: string | undefined;
|
|
13347
|
+
/**
|
|
13348
|
+
* Optional. The maximum number of consecutive failures allowed before
|
|
13349
|
+
*
|
|
13350
|
+
* @remarks
|
|
13351
|
+
* the trigger is automatically paused (status becomes ERROR).
|
|
13352
|
+
*/
|
|
13353
|
+
max_consecutive_failures?: number | undefined;
|
|
13354
|
+
/**
|
|
13355
|
+
* Output only. The time when the trigger is scheduled to run next.
|
|
13356
|
+
*/
|
|
13357
|
+
next_run_time?: string | undefined;
|
|
13358
|
+
/**
|
|
13359
|
+
* Output only. The ID of the last interaction created by this trigger.
|
|
13360
|
+
*/
|
|
13361
|
+
previous_interaction_id?: string | undefined;
|
|
13362
|
+
/**
|
|
13363
|
+
* Required. The cron schedule on which the trigger should run.
|
|
13364
|
+
*
|
|
13365
|
+
* @remarks
|
|
13366
|
+
* Standard cron format.
|
|
13367
|
+
*/
|
|
13368
|
+
schedule: string;
|
|
13369
|
+
/**
|
|
13370
|
+
* Output only. The current status of the trigger.
|
|
13371
|
+
*/
|
|
13372
|
+
status?: TriggerStatus | undefined;
|
|
13373
|
+
/**
|
|
13374
|
+
* Required. Time zone in which the schedule should be interpreted.
|
|
13375
|
+
*/
|
|
13376
|
+
time_zone: string;
|
|
13377
|
+
/**
|
|
13378
|
+
* Output only. The time when the trigger was last updated.
|
|
13379
|
+
*/
|
|
13380
|
+
update_time?: string | undefined;
|
|
13381
|
+
};
|
|
13382
|
+
|
|
13383
|
+
declare type TriggerCreateParams$ = TriggerCreateParams;
|
|
13384
|
+
|
|
13385
|
+
/**
|
|
13386
|
+
* Parameters for creating a trigger.
|
|
13387
|
+
*/
|
|
13388
|
+
declare type TriggerCreateParams = {
|
|
13389
|
+
/**
|
|
13390
|
+
* Required. The cron schedule on which the trigger should run. Standard cron format.
|
|
13391
|
+
*/
|
|
13392
|
+
schedule: string;
|
|
13393
|
+
/**
|
|
13394
|
+
* Required. Time zone in which the schedule should be interpreted.
|
|
13395
|
+
*/
|
|
13396
|
+
time_zone: string;
|
|
13397
|
+
/**
|
|
13398
|
+
* Optional. The display name of the trigger.
|
|
13399
|
+
*/
|
|
13400
|
+
display_name?: string | undefined;
|
|
13401
|
+
/**
|
|
13402
|
+
* Optional. The environment ID for the trigger execution.
|
|
13403
|
+
*/
|
|
13404
|
+
environment_id?: string | undefined;
|
|
13405
|
+
/**
|
|
13406
|
+
* Optional. The maximum number of consecutive failures allowed before the trigger is automatically paused (status becomes ERROR).
|
|
13407
|
+
*/
|
|
13408
|
+
max_consecutive_failures?: number | undefined;
|
|
13409
|
+
/**
|
|
13410
|
+
* Optional. The execution timeout for the triggered interaction.
|
|
13411
|
+
*/
|
|
13412
|
+
execution_timeout_seconds?: number | undefined;
|
|
13413
|
+
/**
|
|
13414
|
+
* Required. The interaction request template to be executed.
|
|
13415
|
+
*/
|
|
13416
|
+
interaction: interactions.CreateAgentInteraction | interactions.CreateModelInteraction;
|
|
13417
|
+
};
|
|
13418
|
+
|
|
13419
|
+
declare type TriggerDeleteParams$ = DeleteTriggerParams;
|
|
13420
|
+
|
|
13421
|
+
declare type TriggerDeleteResponse$ = Empty;
|
|
13422
|
+
|
|
13423
|
+
declare type TriggerExecution$ = TriggerExecution;
|
|
13424
|
+
|
|
13425
|
+
/**
|
|
13426
|
+
* An execution instance of a trigger.
|
|
13427
|
+
*/
|
|
13428
|
+
declare type TriggerExecution = {
|
|
13429
|
+
/**
|
|
13430
|
+
* Output only. The time when the execution finished.
|
|
13431
|
+
*/
|
|
13432
|
+
end_time?: string | undefined;
|
|
13433
|
+
/**
|
|
13434
|
+
* Output only. The environment ID used for the execution.
|
|
13435
|
+
*/
|
|
13436
|
+
environment_id?: string | undefined;
|
|
13437
|
+
/**
|
|
13438
|
+
* Output only. The error message if the execution failed.
|
|
13439
|
+
*/
|
|
13440
|
+
error?: string | undefined;
|
|
13441
|
+
/**
|
|
13442
|
+
* Required. Output only. Identifier. The ID of the trigger execution.
|
|
13443
|
+
*/
|
|
13444
|
+
id: string;
|
|
13445
|
+
/**
|
|
13446
|
+
* Output only. The ID of the interaction created by this execution, if any.
|
|
13447
|
+
*/
|
|
13448
|
+
interaction_id?: string | undefined;
|
|
13449
|
+
/**
|
|
13450
|
+
* Output only. The time when the execution was scheduled to run.
|
|
13451
|
+
*/
|
|
13452
|
+
scheduled_time?: string | undefined;
|
|
13453
|
+
/**
|
|
13454
|
+
* Output only. The time when the execution started.
|
|
13455
|
+
*/
|
|
13456
|
+
start_time?: string | undefined;
|
|
13457
|
+
/**
|
|
13458
|
+
* Output only. The status of the execution.
|
|
13459
|
+
*/
|
|
13460
|
+
status?: TriggerExecutionStatus | undefined;
|
|
13461
|
+
/**
|
|
13462
|
+
* Required. Output only. Identifier. The ID of the trigger that created this execution.
|
|
13463
|
+
*/
|
|
13464
|
+
trigger_id: string;
|
|
13465
|
+
};
|
|
13466
|
+
|
|
13467
|
+
/**
|
|
13468
|
+
* @license
|
|
13469
|
+
* Copyright 2026 Google LLC
|
|
13470
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
13471
|
+
*
|
|
13472
|
+
* g3-prettier-ignore-file
|
|
13473
|
+
*/
|
|
13474
|
+
/**
|
|
13475
|
+
* Output only. The status of the execution.
|
|
13476
|
+
*/
|
|
13477
|
+
declare type TriggerExecutionStatus = "in_progress" | "completed" | "failed" | "skipped" | "timed_out" | (string & {});
|
|
13478
|
+
|
|
13479
|
+
declare type TriggerGetParams$ = GetTriggerParams;
|
|
13480
|
+
|
|
13481
|
+
declare type TriggerListExecutionsParams$ = ListTriggerExecutionsParams;
|
|
13482
|
+
|
|
13483
|
+
declare type TriggerListExecutionsResponse$ = ListTriggerExecutionsResponse;
|
|
13484
|
+
|
|
13485
|
+
declare type TriggerListParams$ = ListTriggersParams;
|
|
13486
|
+
|
|
13487
|
+
declare type TriggerListResponse$ = ListTriggersResponse;
|
|
13488
|
+
|
|
13489
|
+
declare type TriggerRunParams$ = RunTriggerParams;
|
|
13490
|
+
|
|
13491
|
+
export declare namespace Triggers {
|
|
13492
|
+
export type ListTriggerExecutionsResponse = ListTriggerExecutionsResponse$;
|
|
13493
|
+
export type ListTriggersResponse = ListTriggersResponse$;
|
|
13494
|
+
export type Trigger = Trigger$;
|
|
13495
|
+
export type TriggerCreateParams = TriggerCreateParams$;
|
|
13496
|
+
export type TriggerDeleteParams = TriggerDeleteParams$;
|
|
13497
|
+
export type TriggerDeleteResponse = TriggerDeleteResponse$;
|
|
13498
|
+
export type TriggerExecution = TriggerExecution$;
|
|
13499
|
+
export type TriggerGetParams = TriggerGetParams$;
|
|
13500
|
+
export type TriggerListExecutionsParams = TriggerListExecutionsParams$;
|
|
13501
|
+
export type TriggerListExecutionsResponse = TriggerListExecutionsResponse$;
|
|
13502
|
+
export type TriggerListParams = TriggerListParams$;
|
|
13503
|
+
export type TriggerListResponse = TriggerListResponse$;
|
|
13504
|
+
export type TriggerRunParams = TriggerRunParams$;
|
|
13505
|
+
export type TriggerUpdate = TriggerUpdate$;
|
|
13506
|
+
export type TriggerUpdateParams = TriggerUpdateParams$;
|
|
13507
|
+
}
|
|
13508
|
+
|
|
13509
|
+
declare namespace triggers {
|
|
13510
|
+
export {
|
|
13511
|
+
ListTriggerExecutionsResponse,
|
|
13512
|
+
ListTriggersResponse,
|
|
13513
|
+
Interaction_2 as Interaction,
|
|
13514
|
+
TriggerCreateParams,
|
|
13515
|
+
TriggerExecutionStatus,
|
|
13516
|
+
TriggerExecution,
|
|
13517
|
+
TriggerUpdateStatus,
|
|
13518
|
+
TriggerUpdate,
|
|
13519
|
+
TriggerStatus,
|
|
13520
|
+
Trigger
|
|
13521
|
+
}
|
|
13522
|
+
}
|
|
13523
|
+
|
|
13524
|
+
/**
|
|
13525
|
+
* Output only. The current status of the trigger.
|
|
13526
|
+
*/
|
|
13527
|
+
declare type TriggerStatus = "active" | "paused" | "error" | (string & {});
|
|
13528
|
+
|
|
13529
|
+
declare type TriggerUpdate$ = TriggerUpdate;
|
|
13530
|
+
|
|
13531
|
+
/**
|
|
13532
|
+
* Represents the fields of a Trigger that can be updated.
|
|
13533
|
+
*/
|
|
13534
|
+
declare type TriggerUpdate = {
|
|
13535
|
+
/**
|
|
13536
|
+
* Optional. The display name of the trigger.
|
|
13537
|
+
*/
|
|
13538
|
+
display_name?: string | undefined;
|
|
13539
|
+
/**
|
|
13540
|
+
* Optional. The status of the trigger.
|
|
13541
|
+
*/
|
|
13542
|
+
status?: TriggerUpdateStatus | undefined;
|
|
13543
|
+
};
|
|
13544
|
+
|
|
13545
|
+
declare type TriggerUpdateParams$ = UpdateTriggerParams;
|
|
13546
|
+
|
|
13547
|
+
/**
|
|
13548
|
+
* @license
|
|
13549
|
+
* Copyright 2026 Google LLC
|
|
13550
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
13551
|
+
*
|
|
13552
|
+
* g3-prettier-ignore-file
|
|
13553
|
+
*/
|
|
13554
|
+
/**
|
|
13555
|
+
* Optional. The status of the trigger.
|
|
13556
|
+
*/
|
|
13557
|
+
declare type TriggerUpdateStatus = "active" | "paused" | "error";
|
|
13558
|
+
|
|
12579
13559
|
/** TunedModel for the Tuned Model of a Tuning Job. */
|
|
12580
13560
|
export declare interface TunedModel {
|
|
12581
13561
|
/** Output only. The resource name of the TunedModel.
|
|
@@ -12640,6 +13620,8 @@ export declare interface TuningDataStats {
|
|
|
12640
13620
|
preferenceOptimizationDataStats?: PreferenceOptimizationDataStats;
|
|
12641
13621
|
/** The SFT Tuning data stats. */
|
|
12642
13622
|
supervisedTuningDataStats?: SupervisedTuningDataStats;
|
|
13623
|
+
/** Output only. Statistics for reinforcement tuning. */
|
|
13624
|
+
reinforcementTuningDataStats?: DatasetStats;
|
|
12643
13625
|
}
|
|
12644
13626
|
|
|
12645
13627
|
/** A single example for tuning. This data type is not supported in Vertex AI. */
|
|
@@ -12682,6 +13664,7 @@ export declare interface TuningJob {
|
|
|
12682
13664
|
preferenceOptimizationSpec?: PreferenceOptimizationSpec;
|
|
12683
13665
|
/** Tuning Spec for Distillation. */
|
|
12684
13666
|
distillationSpec?: DistillationSpec;
|
|
13667
|
+
/** Tuning Spec for Reinforcement Tuning. */
|
|
12685
13668
|
reinforcementTuningSpec?: ReinforcementTuningSpec;
|
|
12686
13669
|
/** Output only. The tuning data statistics associated with this TuningJob. */
|
|
12687
13670
|
tuningDataStats?: TuningDataStats;
|
|
@@ -12908,6 +13891,7 @@ export declare interface TuningValidationDataset {
|
|
|
12908
13891
|
* @deprecated class: This will be removed in a future release, please migrate away from it as soon as possible.
|
|
12909
13892
|
*/
|
|
12910
13893
|
declare type Turn = {
|
|
13894
|
+
content?: Array<Content_2> | string | undefined;
|
|
12911
13895
|
/**
|
|
12912
13896
|
* The originator of this turn. Must be user for input or model for
|
|
12913
13897
|
*
|
|
@@ -12915,7 +13899,6 @@ declare type Turn = {
|
|
|
12915
13899
|
* model output.
|
|
12916
13900
|
*/
|
|
12917
13901
|
role?: string | undefined;
|
|
12918
|
-
content?: Array<Content_2> | string | undefined;
|
|
12919
13902
|
};
|
|
12920
13903
|
|
|
12921
13904
|
/** The reason why the turn is complete. */
|
|
@@ -13134,8 +14117,14 @@ declare namespace types {
|
|
|
13134
14117
|
ModelStage,
|
|
13135
14118
|
MediaResolution,
|
|
13136
14119
|
Modality,
|
|
14120
|
+
Delivery,
|
|
14121
|
+
AspectRatio,
|
|
14122
|
+
ImageSize,
|
|
13137
14123
|
TuningMode,
|
|
13138
14124
|
AdapterSize,
|
|
14125
|
+
ResponseParseType,
|
|
14126
|
+
MatchOperation,
|
|
14127
|
+
ReinforcementTuningThinkingLevel,
|
|
13139
14128
|
JobState,
|
|
13140
14129
|
TuningJobState,
|
|
13141
14130
|
AggregationMetric,
|
|
@@ -13161,9 +14150,6 @@ declare namespace types {
|
|
|
13161
14150
|
VideoGenerationMaskMode,
|
|
13162
14151
|
VideoCompressionQuality,
|
|
13163
14152
|
ImageResizeMode,
|
|
13164
|
-
ResponseParseType,
|
|
13165
|
-
MatchOperation,
|
|
13166
|
-
ReinforcementTuningThinkingLevel,
|
|
13167
14153
|
TuningMethod,
|
|
13168
14154
|
FileState,
|
|
13169
14155
|
FileSource,
|
|
@@ -13236,7 +14222,9 @@ declare namespace types {
|
|
|
13236
14222
|
UrlContext,
|
|
13237
14223
|
StreamableHttpTransport,
|
|
13238
14224
|
McpServer,
|
|
14225
|
+
ToolExaAiSearch,
|
|
13239
14226
|
Tool,
|
|
14227
|
+
VoiceConsentSignature,
|
|
13240
14228
|
ReplicatedVoiceConfig,
|
|
13241
14229
|
PrebuiltVoiceConfig,
|
|
13242
14230
|
VoiceConfig,
|
|
@@ -13341,6 +14329,12 @@ declare namespace types {
|
|
|
13341
14329
|
DeleteModelConfig,
|
|
13342
14330
|
DeleteModelParameters,
|
|
13343
14331
|
DeleteModelResponse,
|
|
14332
|
+
AudioResponseFormat,
|
|
14333
|
+
ImageResponseFormat,
|
|
14334
|
+
TextResponseFormat,
|
|
14335
|
+
VideoResponseFormat,
|
|
14336
|
+
ResponseFormat,
|
|
14337
|
+
TranslationConfig,
|
|
13344
14338
|
GenerationConfig,
|
|
13345
14339
|
CountTokensConfig,
|
|
13346
14340
|
CountTokensParameters,
|
|
@@ -13390,6 +14384,8 @@ declare namespace types {
|
|
|
13390
14384
|
PreTunedModel,
|
|
13391
14385
|
DatasetDistributionDistributionBucket,
|
|
13392
14386
|
DatasetDistribution,
|
|
14387
|
+
ReinforcementTuningExample,
|
|
14388
|
+
ReinforcementTuningUserDatasetExamples,
|
|
13393
14389
|
DatasetStats,
|
|
13394
14390
|
DistillationDataStats,
|
|
13395
14391
|
GeminiPreferenceExampleCompletion,
|
|
@@ -13435,7 +14431,6 @@ declare namespace types {
|
|
|
13435
14431
|
CreateTuningJobConfig,
|
|
13436
14432
|
CreateTuningJobParametersPrivate,
|
|
13437
14433
|
TuningOperation,
|
|
13438
|
-
ReinforcementTuningExample,
|
|
13439
14434
|
ValidateRewardConfig,
|
|
13440
14435
|
ValidateRewardParameters,
|
|
13441
14436
|
ReinforcementTuningRewardInfo,
|
|
@@ -13570,6 +14565,7 @@ declare namespace types {
|
|
|
13570
14565
|
LanguageHints,
|
|
13571
14566
|
AudioTranscriptionConfig,
|
|
13572
14567
|
ProactivityConfig,
|
|
14568
|
+
HistoryConfig,
|
|
13573
14569
|
CustomizedAvatar,
|
|
13574
14570
|
AvatarConfig,
|
|
13575
14571
|
LiveClientSetup,
|
|
@@ -13579,7 +14575,6 @@ declare namespace types {
|
|
|
13579
14575
|
LiveClientRealtimeInput,
|
|
13580
14576
|
LiveClientToolResponse,
|
|
13581
14577
|
LiveClientMessage,
|
|
13582
|
-
TranslationConfig,
|
|
13583
14578
|
LiveConnectConfig,
|
|
13584
14579
|
LiveConnectParameters,
|
|
13585
14580
|
CreateChatParameters,
|
|
@@ -13680,6 +14675,20 @@ export declare interface UpdateModelParameters {
|
|
|
13680
14675
|
config?: UpdateModelConfig;
|
|
13681
14676
|
}
|
|
13682
14677
|
|
|
14678
|
+
declare type UpdateTriggerParams = Omit<UpdateTriggerRequest, "id" | "body"> & UpdateTriggerRequest["body"];
|
|
14679
|
+
|
|
14680
|
+
declare type UpdateTriggerRequest = {
|
|
14681
|
+
/**
|
|
14682
|
+
* Which version of the API to use.
|
|
14683
|
+
*/
|
|
14684
|
+
api_version?: string | undefined;
|
|
14685
|
+
/**
|
|
14686
|
+
* Resource name of the trigger.
|
|
14687
|
+
*/
|
|
14688
|
+
id: string;
|
|
14689
|
+
body: triggers.TriggerUpdate;
|
|
14690
|
+
};
|
|
14691
|
+
|
|
13683
14692
|
declare interface Uploader {
|
|
13684
14693
|
/**
|
|
13685
14694
|
* Uploads a file to the given upload url.
|
|
@@ -13891,15 +14900,10 @@ declare type URLCitation$ = URLCitation;
|
|
|
13891
14900
|
* A URL citation annotation.
|
|
13892
14901
|
*/
|
|
13893
14902
|
declare type URLCitation = {
|
|
13894
|
-
type: "url_citation";
|
|
13895
14903
|
/**
|
|
13896
|
-
*
|
|
13897
|
-
*/
|
|
13898
|
-
url?: string | undefined;
|
|
13899
|
-
/**
|
|
13900
|
-
* The title of the URL.
|
|
14904
|
+
* End of the attributed segment, exclusive.
|
|
13901
14905
|
*/
|
|
13902
|
-
|
|
14906
|
+
end_index?: number | undefined;
|
|
13903
14907
|
/**
|
|
13904
14908
|
* Start of segment of the response that is attributed to this source.
|
|
13905
14909
|
*
|
|
@@ -13909,9 +14913,14 @@ declare type URLCitation = {
|
|
|
13909
14913
|
*/
|
|
13910
14914
|
start_index?: number | undefined;
|
|
13911
14915
|
/**
|
|
13912
|
-
*
|
|
14916
|
+
* The title of the URL.
|
|
13913
14917
|
*/
|
|
13914
|
-
|
|
14918
|
+
title?: string | undefined;
|
|
14919
|
+
type: "url_citation";
|
|
14920
|
+
/**
|
|
14921
|
+
* The URL.
|
|
14922
|
+
*/
|
|
14923
|
+
url?: string | undefined;
|
|
13915
14924
|
};
|
|
13916
14925
|
|
|
13917
14926
|
declare type URLContext$ = URLContext;
|
|
@@ -13956,7 +14965,6 @@ declare type URLContextCallArguments = {
|
|
|
13956
14965
|
};
|
|
13957
14966
|
|
|
13958
14967
|
declare type URLContextCallDelta = {
|
|
13959
|
-
type: "url_context_call";
|
|
13960
14968
|
/**
|
|
13961
14969
|
* The arguments to pass to the URL context.
|
|
13962
14970
|
*/
|
|
@@ -13965,6 +14973,7 @@ declare type URLContextCallDelta = {
|
|
|
13965
14973
|
* A signature hash for backend validation.
|
|
13966
14974
|
*/
|
|
13967
14975
|
signature?: string | undefined;
|
|
14976
|
+
type: "url_context_call";
|
|
13968
14977
|
};
|
|
13969
14978
|
|
|
13970
14979
|
declare type URLContextCallStep$ = URLContextCallStep;
|
|
@@ -13973,7 +14982,10 @@ declare type URLContextCallStep$ = URLContextCallStep;
|
|
|
13973
14982
|
* URL context call step.
|
|
13974
14983
|
*/
|
|
13975
14984
|
declare type URLContextCallStep = {
|
|
13976
|
-
|
|
14985
|
+
/**
|
|
14986
|
+
* The arguments to pass to the URL context.
|
|
14987
|
+
*/
|
|
14988
|
+
arguments: URLContextCallArguments;
|
|
13977
14989
|
/**
|
|
13978
14990
|
* Required. A unique ID for this specific tool call.
|
|
13979
14991
|
*/
|
|
@@ -13982,10 +14994,7 @@ declare type URLContextCallStep = {
|
|
|
13982
14994
|
* A signature hash for backend validation.
|
|
13983
14995
|
*/
|
|
13984
14996
|
signature?: string | undefined;
|
|
13985
|
-
|
|
13986
|
-
* The arguments to pass to the URL context.
|
|
13987
|
-
*/
|
|
13988
|
-
arguments: Arguments;
|
|
14997
|
+
type: "url_context_call";
|
|
13989
14998
|
};
|
|
13990
14999
|
|
|
13991
15000
|
/** Metadata returned when the model uses the `url_context` tool to get information from a user-provided URL. */
|
|
@@ -14002,24 +15011,24 @@ declare type URLContextResult$2 = URLContextResultDelta;
|
|
|
14002
15011
|
* The result of the URL context.
|
|
14003
15012
|
*/
|
|
14004
15013
|
declare type URLContextResult = {
|
|
14005
|
-
/**
|
|
14006
|
-
* The URL that was fetched.
|
|
14007
|
-
*/
|
|
14008
|
-
url?: string | undefined;
|
|
14009
15014
|
/**
|
|
14010
15015
|
* The status of the URL retrieval.
|
|
14011
15016
|
*/
|
|
14012
15017
|
status?: URLContextResultStatus | undefined;
|
|
15018
|
+
/**
|
|
15019
|
+
* The URL that was fetched.
|
|
15020
|
+
*/
|
|
15021
|
+
url?: string | undefined;
|
|
14013
15022
|
};
|
|
14014
15023
|
|
|
14015
15024
|
declare type URLContextResultDelta = {
|
|
14016
|
-
type: "url_context_result";
|
|
14017
|
-
result: Array<URLContextResult>;
|
|
14018
15025
|
is_error?: boolean | undefined;
|
|
15026
|
+
result: Array<URLContextResult>;
|
|
14019
15027
|
/**
|
|
14020
15028
|
* A signature hash for backend validation.
|
|
14021
15029
|
*/
|
|
14022
15030
|
signature?: string | undefined;
|
|
15031
|
+
type: "url_context_result";
|
|
14023
15032
|
};
|
|
14024
15033
|
|
|
14025
15034
|
/**
|
|
@@ -14040,23 +15049,23 @@ declare type URLContextResultStep$ = URLContextResultStep;
|
|
|
14040
15049
|
* URL context result step.
|
|
14041
15050
|
*/
|
|
14042
15051
|
declare type URLContextResultStep = {
|
|
14043
|
-
type: "url_context_result";
|
|
14044
15052
|
/**
|
|
14045
|
-
* Required.
|
|
15053
|
+
* Required. ID to match the ID from the function call block.
|
|
14046
15054
|
*/
|
|
14047
|
-
|
|
15055
|
+
call_id: string;
|
|
14048
15056
|
/**
|
|
14049
15057
|
* Whether the URL context resulted in an error.
|
|
14050
15058
|
*/
|
|
14051
15059
|
is_error?: boolean | undefined;
|
|
14052
15060
|
/**
|
|
14053
|
-
* Required.
|
|
15061
|
+
* Required. The results of the URL context.
|
|
14054
15062
|
*/
|
|
14055
|
-
|
|
15063
|
+
result: Array<URLContextResult>;
|
|
14056
15064
|
/**
|
|
14057
15065
|
* A signature hash for backend validation.
|
|
14058
15066
|
*/
|
|
14059
15067
|
signature?: string | undefined;
|
|
15068
|
+
type: "url_context_result";
|
|
14060
15069
|
};
|
|
14061
15070
|
|
|
14062
15071
|
/** The metadata for a single URL retrieval. */
|
|
@@ -14098,37 +15107,37 @@ declare type Usage$ = Usage;
|
|
|
14098
15107
|
*/
|
|
14099
15108
|
declare type Usage = {
|
|
14100
15109
|
/**
|
|
14101
|
-
*
|
|
15110
|
+
* A breakdown of cached token usage by modality.
|
|
14102
15111
|
*/
|
|
14103
|
-
|
|
15112
|
+
cached_tokens_by_modality?: Array<ModalityTokens> | undefined;
|
|
14104
15113
|
/**
|
|
14105
|
-
*
|
|
15114
|
+
* Grounding tool count.
|
|
14106
15115
|
*/
|
|
14107
|
-
|
|
15116
|
+
grounding_tool_count?: Array<GroundingToolCount> | undefined;
|
|
14108
15117
|
/**
|
|
14109
|
-
*
|
|
15118
|
+
* A breakdown of input token usage by modality.
|
|
14110
15119
|
*/
|
|
14111
|
-
|
|
15120
|
+
input_tokens_by_modality?: Array<ModalityTokens> | undefined;
|
|
14112
15121
|
/**
|
|
14113
|
-
* A breakdown of
|
|
15122
|
+
* A breakdown of output token usage by modality.
|
|
14114
15123
|
*/
|
|
14115
|
-
|
|
15124
|
+
output_tokens_by_modality?: Array<ModalityTokens> | undefined;
|
|
14116
15125
|
/**
|
|
14117
|
-
*
|
|
15126
|
+
* A breakdown of tool-use token usage by modality.
|
|
14118
15127
|
*/
|
|
14119
|
-
|
|
15128
|
+
tool_use_tokens_by_modality?: Array<ModalityTokens> | undefined;
|
|
14120
15129
|
/**
|
|
14121
|
-
*
|
|
15130
|
+
* Number of tokens in the cached part of the prompt (the cached content).
|
|
14122
15131
|
*/
|
|
14123
|
-
|
|
15132
|
+
total_cached_tokens?: number | undefined;
|
|
14124
15133
|
/**
|
|
14125
|
-
* Number of tokens
|
|
15134
|
+
* Number of tokens in the prompt (context).
|
|
14126
15135
|
*/
|
|
14127
|
-
|
|
15136
|
+
total_input_tokens?: number | undefined;
|
|
14128
15137
|
/**
|
|
14129
|
-
*
|
|
15138
|
+
* Total number of tokens across all the generated responses.
|
|
14130
15139
|
*/
|
|
14131
|
-
|
|
15140
|
+
total_output_tokens?: number | undefined;
|
|
14132
15141
|
/**
|
|
14133
15142
|
* Number of tokens of thoughts for thinking models.
|
|
14134
15143
|
*/
|
|
@@ -14141,9 +15150,9 @@ declare type Usage = {
|
|
|
14141
15150
|
*/
|
|
14142
15151
|
total_tokens?: number | undefined;
|
|
14143
15152
|
/**
|
|
14144
|
-
*
|
|
15153
|
+
* Number of tokens present in tool-use prompt(s).
|
|
14145
15154
|
*/
|
|
14146
|
-
|
|
15155
|
+
total_tool_use_tokens?: number | undefined;
|
|
14147
15156
|
};
|
|
14148
15157
|
|
|
14149
15158
|
/** Usage metadata about response(s). */
|
|
@@ -14312,14 +15321,14 @@ declare type VertexAISearchConfig$ = VertexAISearchConfig;
|
|
|
14312
15321
|
* Used to specify configuration for VertexAISearch.
|
|
14313
15322
|
*/
|
|
14314
15323
|
declare type VertexAISearchConfig = {
|
|
14315
|
-
/**
|
|
14316
|
-
* Optional. Used to specify Vertex AI Search engine.
|
|
14317
|
-
*/
|
|
14318
|
-
engine?: string | undefined;
|
|
14319
15324
|
/**
|
|
14320
15325
|
* Optional. Used to specify Vertex AI Search datastores.
|
|
14321
15326
|
*/
|
|
14322
15327
|
datastores?: Array<string> | undefined;
|
|
15328
|
+
/**
|
|
15329
|
+
* Optional. Used to specify Vertex AI Search engine.
|
|
15330
|
+
*/
|
|
15331
|
+
engine?: string | undefined;
|
|
14323
15332
|
};
|
|
14324
15333
|
|
|
14325
15334
|
/** Define data stores within engine to filter on in a search call and configurations for those data stores. For more information, see https://cloud.google.com/generative-ai-app-builder/docs/reference/rpc/google.cloud.discoveryengine.v1#datastorespec. This data type is not supported in Gemini API. */
|
|
@@ -14413,20 +15422,20 @@ declare type VideoContent$ = VideoContent;
|
|
|
14413
15422
|
* A video content block.
|
|
14414
15423
|
*/
|
|
14415
15424
|
declare type VideoContent = {
|
|
14416
|
-
type: "video";
|
|
14417
15425
|
/**
|
|
14418
15426
|
* The video content.
|
|
14419
15427
|
*/
|
|
14420
15428
|
data?: string | undefined;
|
|
14421
|
-
/**
|
|
14422
|
-
* The URI of the video.
|
|
14423
|
-
*/
|
|
14424
|
-
uri?: string | undefined;
|
|
14425
15429
|
/**
|
|
14426
15430
|
* The mime type of the video.
|
|
14427
15431
|
*/
|
|
14428
15432
|
mime_type?: VideoContentMimeType | undefined;
|
|
14429
15433
|
resolution?: MediaResolution_2 | undefined;
|
|
15434
|
+
type: "video";
|
|
15435
|
+
/**
|
|
15436
|
+
* The URI of the video.
|
|
15437
|
+
*/
|
|
15438
|
+
uri?: string | undefined;
|
|
14430
15439
|
};
|
|
14431
15440
|
|
|
14432
15441
|
/**
|
|
@@ -14435,11 +15444,11 @@ declare type VideoContent = {
|
|
|
14435
15444
|
declare type VideoContentMimeType = "video/mp4" | "video/mpeg" | "video/mpg" | "video/mov" | "video/avi" | "video/x-flv" | "video/webm" | "video/wmv" | "video/3gpp" | (string & {});
|
|
14436
15445
|
|
|
14437
15446
|
declare type VideoDelta = {
|
|
14438
|
-
type: "video";
|
|
14439
15447
|
data?: string | undefined;
|
|
14440
|
-
uri?: string | undefined;
|
|
14441
15448
|
mime_type?: VideoDeltaMimeType | undefined;
|
|
14442
15449
|
resolution?: MediaResolution_2 | undefined;
|
|
15450
|
+
type: "video";
|
|
15451
|
+
uri?: string | undefined;
|
|
14443
15452
|
};
|
|
14444
15453
|
|
|
14445
15454
|
declare type VideoDeltaMimeType = "video/mp4" | "video/mpeg" | "video/mpg" | "video/mov" | "video/avi" | "video/x-flv" | "video/webm" | "video/wmv" | "video/3gpp" | (string & {});
|
|
@@ -14531,17 +15540,36 @@ export declare enum VideoOrientation {
|
|
|
14531
15540
|
PORTRAIT = "PORTRAIT"
|
|
14532
15541
|
}
|
|
14533
15542
|
|
|
14534
|
-
declare type VideoResponseFormat$ =
|
|
15543
|
+
declare type VideoResponseFormat$ = VideoResponseFormat_2;
|
|
15544
|
+
|
|
15545
|
+
/** Configuration for video-specific output formatting. This data type is not supported in Gemini API. */
|
|
15546
|
+
export declare class VideoResponseFormat {
|
|
15547
|
+
/** The aspect ratio for the video output. */
|
|
15548
|
+
aspectRatio?: AspectRatio;
|
|
15549
|
+
/** Optional. Delivery mode for the generated content. */
|
|
15550
|
+
delivery?: Delivery;
|
|
15551
|
+
/** Optional. The duration for the video output. */
|
|
15552
|
+
duration?: string;
|
|
15553
|
+
/** Optional. The Google Cloud Storage URI to store the video output. Required for Vertex if delivery is URI. */
|
|
15554
|
+
gcsUri?: string;
|
|
15555
|
+
}
|
|
14535
15556
|
|
|
14536
15557
|
/**
|
|
14537
15558
|
* Configuration for video output format.
|
|
14538
15559
|
*/
|
|
14539
|
-
declare type
|
|
14540
|
-
|
|
15560
|
+
declare type VideoResponseFormat_2 = {
|
|
15561
|
+
/**
|
|
15562
|
+
* The aspect ratio for the video output.
|
|
15563
|
+
*/
|
|
15564
|
+
aspect_ratio?: VideoResponseFormatAspectRatio | undefined;
|
|
14541
15565
|
/**
|
|
14542
15566
|
* The delivery mode for the video output.
|
|
14543
15567
|
*/
|
|
14544
15568
|
delivery?: VideoResponseFormatDelivery | undefined;
|
|
15569
|
+
/**
|
|
15570
|
+
* The duration for the video output.
|
|
15571
|
+
*/
|
|
15572
|
+
duration?: string | undefined;
|
|
14545
15573
|
/**
|
|
14546
15574
|
* The GCS URI to store the video output. Required for Vertex if delivery mode
|
|
14547
15575
|
*
|
|
@@ -14549,21 +15577,9 @@ declare type VideoResponseFormat = {
|
|
|
14549
15577
|
* is URI.
|
|
14550
15578
|
*/
|
|
14551
15579
|
gcs_uri?: string | undefined;
|
|
14552
|
-
|
|
14553
|
-
* The aspect ratio for the video output.
|
|
14554
|
-
*/
|
|
14555
|
-
aspect_ratio?: VideoResponseFormatAspectRatio | undefined;
|
|
14556
|
-
/**
|
|
14557
|
-
* The duration for the video output.
|
|
14558
|
-
*/
|
|
14559
|
-
duration?: string | undefined;
|
|
15580
|
+
type: "video";
|
|
14560
15581
|
};
|
|
14561
15582
|
|
|
14562
|
-
/**
|
|
14563
|
-
* The aspect ratio for the video output.
|
|
14564
|
-
*/
|
|
14565
|
-
declare type VideoResponseFormatAspectRatio = "16:9" | "9:16" | (string & {});
|
|
14566
|
-
|
|
14567
15583
|
/**
|
|
14568
15584
|
* @license
|
|
14569
15585
|
* Copyright 2026 Google LLC
|
|
@@ -14571,6 +15587,11 @@ declare type VideoResponseFormatAspectRatio = "16:9" | "9:16" | (string & {});
|
|
|
14571
15587
|
*
|
|
14572
15588
|
* g3-prettier-ignore-file
|
|
14573
15589
|
*/
|
|
15590
|
+
/**
|
|
15591
|
+
* The aspect ratio for the video output.
|
|
15592
|
+
*/
|
|
15593
|
+
declare type VideoResponseFormatAspectRatio = "16:9" | "9:16" | (string & {});
|
|
15594
|
+
|
|
14574
15595
|
/**
|
|
14575
15596
|
* The delivery mode for the video output.
|
|
14576
15597
|
*/
|
|
@@ -14620,20 +15641,43 @@ export declare interface VoiceConfig {
|
|
|
14620
15641
|
prebuiltVoiceConfig?: PrebuiltVoiceConfig;
|
|
14621
15642
|
}
|
|
14622
15643
|
|
|
15644
|
+
/** The signature of the voice consent check. */
|
|
15645
|
+
export declare interface VoiceConsentSignature {
|
|
15646
|
+
/** The signature string.
|
|
15647
|
+
*/
|
|
15648
|
+
signature?: string;
|
|
15649
|
+
}
|
|
15650
|
+
|
|
14623
15651
|
declare type Webhook$ = Webhook;
|
|
14624
15652
|
|
|
14625
15653
|
/**
|
|
14626
15654
|
* A Webhook resource.
|
|
14627
15655
|
*/
|
|
14628
15656
|
declare type Webhook = {
|
|
15657
|
+
/**
|
|
15658
|
+
* Output only. The timestamp when the webhook was created.
|
|
15659
|
+
*/
|
|
15660
|
+
create_time?: string | undefined;
|
|
15661
|
+
/**
|
|
15662
|
+
* Output only. The ID of the webhook.
|
|
15663
|
+
*/
|
|
15664
|
+
id?: string | undefined;
|
|
14629
15665
|
/**
|
|
14630
15666
|
* Optional. The user-provided name of the webhook.
|
|
14631
15667
|
*/
|
|
14632
15668
|
name?: string | undefined;
|
|
14633
15669
|
/**
|
|
14634
|
-
*
|
|
15670
|
+
* Output only. The new signing secret for the webhook. Only populated on create.
|
|
14635
15671
|
*/
|
|
14636
|
-
|
|
15672
|
+
new_signing_secret?: string | undefined;
|
|
15673
|
+
/**
|
|
15674
|
+
* Output only. The signing secrets associated with this webhook.
|
|
15675
|
+
*/
|
|
15676
|
+
signing_secrets?: Array<SigningSecret> | undefined;
|
|
15677
|
+
/**
|
|
15678
|
+
* Output only. The state of the webhook.
|
|
15679
|
+
*/
|
|
15680
|
+
state?: WebhookState | undefined;
|
|
14637
15681
|
/**
|
|
14638
15682
|
* Required. The events that the webhook is subscribed to.
|
|
14639
15683
|
*
|
|
@@ -14648,30 +15692,14 @@ declare type Webhook = {
|
|
|
14648
15692
|
* - video.generated
|
|
14649
15693
|
*/
|
|
14650
15694
|
subscribed_events: Array<WebhookSubscribedEvent>;
|
|
14651
|
-
/**
|
|
14652
|
-
* Output only. The timestamp when the webhook was created.
|
|
14653
|
-
*/
|
|
14654
|
-
create_time?: string | undefined;
|
|
14655
15695
|
/**
|
|
14656
15696
|
* Output only. The timestamp when the webhook was last updated.
|
|
14657
15697
|
*/
|
|
14658
15698
|
update_time?: string | undefined;
|
|
14659
15699
|
/**
|
|
14660
|
-
*
|
|
14661
|
-
*/
|
|
14662
|
-
signing_secrets?: Array<SigningSecret> | undefined;
|
|
14663
|
-
/**
|
|
14664
|
-
* Output only. The state of the webhook.
|
|
14665
|
-
*/
|
|
14666
|
-
state?: WebhookState | undefined;
|
|
14667
|
-
/**
|
|
14668
|
-
* Output only. The new signing secret for the webhook. Only populated on create.
|
|
14669
|
-
*/
|
|
14670
|
-
new_signing_secret?: string | undefined;
|
|
14671
|
-
/**
|
|
14672
|
-
* Output only. The ID of the webhook.
|
|
15700
|
+
* Required. The URI to which webhook events will be sent.
|
|
14673
15701
|
*/
|
|
14674
|
-
|
|
15702
|
+
uri: string;
|
|
14675
15703
|
};
|
|
14676
15704
|
|
|
14677
15705
|
declare type WebhookConfig$ = WebhookConfig_2;
|
|
@@ -14737,10 +15765,6 @@ declare type WebhookInput = {
|
|
|
14737
15765
|
* Optional. The user-provided name of the webhook.
|
|
14738
15766
|
*/
|
|
14739
15767
|
name?: string | undefined;
|
|
14740
|
-
/**
|
|
14741
|
-
* Required. The URI to which webhook events will be sent.
|
|
14742
|
-
*/
|
|
14743
|
-
uri: string;
|
|
14744
15768
|
/**
|
|
14745
15769
|
* Required. The events that the webhook is subscribed to.
|
|
14746
15770
|
*
|
|
@@ -14755,6 +15779,10 @@ declare type WebhookInput = {
|
|
|
14755
15779
|
* - video.generated
|
|
14756
15780
|
*/
|
|
14757
15781
|
subscribed_events: Array<WebhookSubscribedEvent>;
|
|
15782
|
+
/**
|
|
15783
|
+
* Required. The URI to which webhook events will be sent.
|
|
15784
|
+
*/
|
|
15785
|
+
uri: string;
|
|
14758
15786
|
};
|
|
14759
15787
|
|
|
14760
15788
|
declare type WebhookListParams$ = ListWebhooksParams;
|
|
@@ -14771,10 +15799,6 @@ declare type WebhookListResponse$ = WebhookListResponse;
|
|
|
14771
15799
|
* Response message for WebhookService.ListWebhooks.
|
|
14772
15800
|
*/
|
|
14773
15801
|
declare type WebhookListResponse = {
|
|
14774
|
-
/**
|
|
14775
|
-
* The webhooks.
|
|
14776
|
-
*/
|
|
14777
|
-
webhooks?: Array<Webhook> | undefined;
|
|
14778
15802
|
/**
|
|
14779
15803
|
* A token, which can be sent as `page_token` to retrieve the next page.
|
|
14780
15804
|
*
|
|
@@ -14782,6 +15806,10 @@ declare type WebhookListResponse = {
|
|
|
14782
15806
|
* If this field is omitted, there are no subsequent pages.
|
|
14783
15807
|
*/
|
|
14784
15808
|
next_page_token?: string | undefined;
|
|
15809
|
+
/**
|
|
15810
|
+
* The webhooks.
|
|
15811
|
+
*/
|
|
15812
|
+
webhooks?: Array<Webhook> | undefined;
|
|
14785
15813
|
};
|
|
14786
15814
|
|
|
14787
15815
|
declare type WebhookPingParams$ = PingWebhookRequest;
|
|
@@ -14859,11 +15887,11 @@ declare namespace webhooks {
|
|
|
14859
15887
|
WebhookListResponse,
|
|
14860
15888
|
WebhookPingResponse,
|
|
14861
15889
|
WebhookRotateSigningSecretResponse,
|
|
14862
|
-
WebhookUpdateSubscribedEvent,
|
|
14863
15890
|
WebhookUpdateState,
|
|
15891
|
+
WebhookUpdateSubscribedEvent,
|
|
14864
15892
|
WebhookUpdate,
|
|
14865
|
-
WebhookSubscribedEvent,
|
|
14866
15893
|
WebhookState,
|
|
15894
|
+
WebhookSubscribedEvent,
|
|
14867
15895
|
Webhook,
|
|
14868
15896
|
WebhookInput
|
|
14869
15897
|
}
|
|
@@ -14884,9 +15912,9 @@ declare type WebhookUpdate = {
|
|
|
14884
15912
|
*/
|
|
14885
15913
|
name?: string | undefined;
|
|
14886
15914
|
/**
|
|
14887
|
-
* Optional. The
|
|
15915
|
+
* Optional. The state of the webhook.
|
|
14888
15916
|
*/
|
|
14889
|
-
|
|
15917
|
+
state?: WebhookUpdateState | undefined;
|
|
14890
15918
|
/**
|
|
14891
15919
|
* Optional. The events that the webhook is subscribed to.
|
|
14892
15920
|
*
|
|
@@ -14902,9 +15930,9 @@ declare type WebhookUpdate = {
|
|
|
14902
15930
|
*/
|
|
14903
15931
|
subscribed_events?: Array<WebhookUpdateSubscribedEvent> | undefined;
|
|
14904
15932
|
/**
|
|
14905
|
-
* Optional. The
|
|
15933
|
+
* Optional. The URI to which webhook events will be sent.
|
|
14906
15934
|
*/
|
|
14907
|
-
|
|
15935
|
+
uri?: string | undefined;
|
|
14908
15936
|
};
|
|
14909
15937
|
|
|
14910
15938
|
declare type WebhookUpdateParams$ = WebhookUpdate;
|
|
@@ -14914,11 +15942,6 @@ declare type WebhookUpdateParams = {
|
|
|
14914
15942
|
update_mask?: string;
|
|
14915
15943
|
} & webhooks.WebhookUpdate;
|
|
14916
15944
|
|
|
14917
|
-
/**
|
|
14918
|
-
* Optional. The state of the webhook.
|
|
14919
|
-
*/
|
|
14920
|
-
declare type WebhookUpdateState = "enabled" | "disabled" | "disabled_due_to_failed_deliveries";
|
|
14921
|
-
|
|
14922
15945
|
/**
|
|
14923
15946
|
* @license
|
|
14924
15947
|
* Copyright 2026 Google LLC
|
|
@@ -14926,6 +15949,11 @@ declare type WebhookUpdateState = "enabled" | "disabled" | "disabled_due_to_fail
|
|
|
14926
15949
|
*
|
|
14927
15950
|
* g3-prettier-ignore-file
|
|
14928
15951
|
*/
|
|
15952
|
+
/**
|
|
15953
|
+
* Optional. The state of the webhook.
|
|
15954
|
+
*/
|
|
15955
|
+
declare type WebhookUpdateState = "enabled" | "disabled" | "disabled_due_to_failed_deliveries";
|
|
15956
|
+
|
|
14929
15957
|
declare type WebhookUpdateSubscribedEvent = "batch.succeeded" | "batch.expired" | "batch.failed" | "interaction.requires_action" | "interaction.completed" | "interaction.failed" | "video.generated" | (string & {});
|
|
14930
15958
|
|
|
14931
15959
|
/** Standard web search for grounding and related configurations. Only text results are returned. */
|