@maxim_mazurok/gapi.client.ces-v1 0.0.20260204

package/index.d.ts

@@ -0,0 +1,4174 @@
+/* Type definitions for non-npm package Gemini Enterprise for Customer Experience API v1 0.0 */
+// Project: https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference
+// Definitions by: Maxim Mazurok <https://github.com/Maxim-Mazurok>
+//                 Nick Amoscato <https://github.com/namoscato>
+//                 Declan Vong <https://github.com/declanvong>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+// IMPORTANT
+// This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
+// In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
+// Generated from: https://ces.googleapis.com/$discovery/rest?version=v1
+// Revision: 20260204
+
+/// <reference types="gapi.client" />
+
+declare namespace gapi.client {
+  /** Load Gemini Enterprise for Customer Experience API v1 */
+  function load(
+    urlOrObject: 'https://ces.googleapis.com/$discovery/rest?version=v1',
+  ): Promise<void>;
+  /** @deprecated Please load APIs with discovery documents. */
+  function load(name: 'ces', version: 'v1'): Promise<void>;
+  /** @deprecated Please load APIs with discovery documents. */
+  function load(name: 'ces', version: 'v1', callback: () => any): void;
+
+  namespace ces {
+    interface Action {
+      /** ID of a Connection action for the tool to use. */
+      connectionActionId?: string;
+      /** Entity operation configuration for the tool to use. */
+      entityOperation?: ActionEntityOperation;
+      /** Optional. Entity fields to use as inputs for the operation. If no fields are specified, all fields of the Entity will be used. */
+      inputFields?: string[];
+      /** Optional. Entity fields to return from the operation. If no fields are specified, all fields of the Entity will be returned. */
+      outputFields?: string[];
+    }
+    interface ActionEntityOperation {
+      /** Required. ID of the entity. */
+      entityId?: string;
+      /** Required. Operation to perform on the entity. */
+      operation?: string;
+    }
+    interface Agent {
+      /** Optional. The callbacks to execute after the agent is called. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped. */
+      afterAgentCallbacks?: Callback[];
+      /** Optional. The callbacks to execute after the model is called. If there are multiple calls to the model, the callback will be executed multiple times. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped. */
+      afterModelCallbacks?: Callback[];
+      /** Optional. The callbacks to execute after the tool is invoked. If there are multiple tool invocations, the callback will be executed multiple times. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped. */
+      afterToolCallbacks?: Callback[];
+      /** Optional. The callbacks to execute before the agent is called. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped. */
+      beforeAgentCallbacks?: Callback[];
+      /** Optional. The callbacks to execute before the model is called. If there are multiple calls to the model, the callback will be executed multiple times. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped. */
+      beforeModelCallbacks?: Callback[];
+      /** Optional. The callbacks to execute before the tool is invoked. If there are multiple tool invocations, the callback will be executed multiple times. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped. */
+      beforeToolCallbacks?: Callback[];
+      /** Optional. List of child agents in the agent tree. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+      childAgents?: string[];
+      /** Output only. Timestamp when the agent was created. */
+      createTime?: string;
+      /** Optional. Human-readable description of the agent. */
+      description?: string;
+      /** Required. Display name of the agent. */
+      displayName?: string;
+      /** Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. */
+      etag?: string;
+      /** Output only. If the agent is generated by the LLM assistant, this field contains a descriptive summary of the generation. */
+      generatedSummary?: string;
+      /** Optional. List of guardrails for the agent. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}` */
+      guardrails?: string[];
+      /** Optional. Instructions for the LLM model to guide the agent's behavior. */
+      instruction?: string;
+      /** Optional. The default agent type. */
+      llmAgent?: any;
+      /** Optional. Configurations for the LLM model. */
+      modelSettings?: ModelSettings;
+      /** Identifier. The unique identifier of the agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+      name?: string;
+      /** Optional. The remote [Dialogflow](https://cloud.google.com/dialogflow/cx/docs/concept/console-conversational-agents) agent to be used for the agent execution. If this field is set, all other agent level properties will be ignored. Note: If the Dialogflow agent is in a different project from the app, you should grant `roles/dialogflow.client` to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`. */
+      remoteDialogflowAgent?: AgentRemoteDialogflowAgent;
+      /** Optional. List of available tools for the agent. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` */
+      tools?: string[];
+      /** Optional. List of toolsets for the agent. */
+      toolsets?: AgentAgentToolset[];
+      /** Optional. Agent transfer rules. If multiple rules match, the first one in the list will be used. */
+      transferRules?: TransferRule[];
+      /** Output only. Timestamp when the agent was last updated. */
+      updateTime?: string;
+    }
+    interface AgentAgentToolset {
+      /** Optional. The tools IDs to filter the toolset. */
+      toolIds?: string[];
+      /** Required. The resource name of the toolset. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}` */
+      toolset?: string;
+    }
+    interface AgentLlmAgent {}
+    interface AgentRemoteDialogflowAgent {
+      /** Required. The [Dialogflow](https://docs.cloud.google.com/dialogflow/cx/docs/concept/agent) agent resource name. Format: `projects/{project}/locations/{location}/agents/{agent}` */
+      agent?: string;
+      /** Optional. The environment ID of the Dialogflow agent to be used for the agent execution. If not specified, the draft environment will be used. */
+      environmentId?: string;
+      /** Optional. The flow ID of the flow in the Dialogflow agent. */
+      flowId?: string;
+      /** Optional. The mapping of the app variables names to the Dialogflow session parameters names to be sent to the Dialogflow agent as input. */
+      inputVariableMapping?: {[P in string]: string};
+      /** Optional. The mapping of the Dialogflow session parameters names to the app variables names to be sent back to the CES agent after the Dialogflow agent execution ends. */
+      outputVariableMapping?: {[P in string]: string};
+      /** Optional. Indicates whether to respect the message-level interruption settings configured in the Dialogflow agent. * If false: all response messages from the Dialogflow agent follow the app-level barge-in settings. * If true: only response messages with [`allow_playback_interruption`](https://docs.cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#text) set to true will be interruptable, all other messages follow the app-level barge-in settings. */
+      respectResponseInterruptionSettings?: boolean;
+    }
+    interface AgentTransfer {
+      /** Output only. Display name of the agent. */
+      displayName?: string;
+      /** Required. The agent to which the conversation is being transferred. The agent will handle the conversation from this point forward. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+      targetAgent?: string;
+    }
+    interface AmbientSoundConfig {
+      /** Optional. Ambient noise as a mono-channel, 16kHz WAV file stored in [Cloud Storage](https://cloud.google.com/storage). Note: Please make sure the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com` has `storage.objects.get` permission to the Cloud Storage object. */
+      gcsUri?: string;
+      /** Optional. Deprecated: `prebuilt_ambient_noise` is deprecated in favor of `prebuilt_ambient_sound`. */
+      prebuiltAmbientNoise?: string;
+      /** Optional. Name of the prebuilt ambient sound. Valid values are: - "coffee_shop" - "keyboard" - "keypad" - "hum" - "office_1" - "office_2" - "office_3" - "room_1" - "room_2" - "room_3" - "room_4" - "room_5" - "air_conditioner" */
+      prebuiltAmbientSound?: string;
+      /** Optional. Volume gain (in dB) of the normal native volume supported by ambient noise, in the range [-96.0, 16.0]. If unset, or set to a value of 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB) will play at approximately half the amplitude of the normal native signal amplitude. A value of +6.0 (dB) will play at approximately twice the amplitude of the normal native signal amplitude. We strongly recommend not to exceed +10 (dB) as there's usually no effective increase in loudness for any value greater than that. */
+      volumeGainDb?: number;
+    }
+    interface ApiAuthentication {
+      /** Optional. Config for API key auth. */
+      apiKeyConfig?: ApiKeyConfig;
+      /** Optional. Config for bearer token auth. */
+      bearerTokenConfig?: BearerTokenConfig;
+      /** Optional. Config for OAuth. */
+      oauthConfig?: OAuthConfig;
+      /** Optional. Config for service account authentication. */
+      serviceAccountAuthConfig?: ServiceAccountAuthConfig;
+      /** Optional. Config for ID token auth generated from CES service agent. */
+      serviceAgentIdTokenAuthConfig?: any;
+    }
+    interface ApiKeyConfig {
+      /** Required. The name of the SecretManager secret version resource storing the API key. Format: `projects/{project}/secrets/{secret}/versions/{version}` Note: You should grant `roles/secretmanager.secretAccessor` role to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`. */
+      apiKeySecretVersion?: string;
+      /** Required. The parameter name or the header name of the API key. E.g., If the API request is "https://example.com/act?X-Api-Key=", "X-Api-Key" would be the parameter name. */
+      keyName?: string;
+      /** Required. Key location in the request. */
+      requestLocation?: string;
+    }
+    interface App {
+      /** Optional. Audio processing configuration of the app. */
+      audioProcessingConfig?: AudioProcessingConfig;
+      /** Optional. The default client certificate settings for the app. */
+      clientCertificateSettings?: ClientCertificateSettings;
+      /** Output only. Timestamp when the app was created. */
+      createTime?: string;
+      /** Optional. The data store settings for the app. */
+      dataStoreSettings?: DataStoreSettings;
+      /** Optional. The default channel profile used by the app. */
+      defaultChannelProfile?: ChannelProfile;
+      /** Output only. Number of deployments in the app. */
+      deploymentCount?: number;
+      /** Optional. Human-readable description of the app. */
+      description?: string;
+      /** Required. Display name of the app. */
+      displayName?: string;
+      /** Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. */
+      etag?: string;
+      /** Optional. The evaluation thresholds for the app. */
+      evaluationMetricsThresholds?: EvaluationMetricsThresholds;
+      /** Optional. Instructions for all the agents in the app. You can use this instruction to set up a stable identity or personality across all the agents. */
+      globalInstruction?: string;
+      /** Optional. List of guardrails for the app. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}` */
+      guardrails?: string[];
+      /** Optional. Language settings of the app. */
+      languageSettings?: LanguageSettings;
+      /** Optional. Indicates whether the app is locked for changes. If the app is locked, modifications to the app resources will be rejected. */
+      locked?: boolean;
+      /** Optional. Logging settings of the app. */
+      loggingSettings?: LoggingSettings;
+      /** Optional. Metadata about the app. This field can be used to store additional information relevant to the app's details or intended usages. */
+      metadata?: {[P in string]: string};
+      /** Optional. The default LLM model settings for the app. Individual resources (e.g. agents, guardrails) can override these configurations as needed. */
+      modelSettings?: ModelSettings;
+      /** Identifier. The unique identifier of the app. Format: `projects/{project}/locations/{location}/apps/{app}` */
+      name?: string;
+      /** Optional. Whether the app is pinned in the app list. */
+      pinned?: boolean;
+      /** Output only. The declarations of predefined variables for the app. */
+      predefinedVariableDeclarations?: AppVariableDeclaration[];
+      /** Optional. The root agent is the entry point of the app. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+      rootAgent?: string;
+      /** Optional. TimeZone settings of the app. */
+      timeZoneSettings?: TimeZoneSettings;
+      /** Optional. The tool execution mode for the app. If not provided, will default to PARALLEL. */
+      toolExecutionMode?: string;
+      /** Output only. Timestamp when the app was last updated. */
+      updateTime?: string;
+      /** Optional. The declarations of the variables. */
+      variableDeclarations?: AppVariableDeclaration[];
+    }
+    interface AppSnapshot {
+      /** Optional. List of agents in the app. */
+      agents?: Agent[];
+      /** Optional. The basic settings for the app. */
+      app?: App;
+      /** Optional. List of examples in the app. */
+      examples?: Example[];
+      /** Optional. List of guardrails in the app. */
+      guardrails?: Guardrail[];
+      /** Optional. List of tools in the app. */
+      tools?: Tool[];
+      /** Optional. List of toolsets in the app. */
+      toolsets?: Toolset[];
+    }
+    interface AppVariableDeclaration {
+      /** Required. The description of the variable. */
+      description?: string;
+      /** Required. The name of the variable. The name must start with a letter or underscore and contain only letters, numbers, or underscores. */
+      name?: string;
+      /** Required. The schema of the variable. */
+      schema?: Schema;
+    }
+    interface AppVersion {
+      /** Output only. Timestamp when the app version was created. */
+      createTime?: string;
+      /** Output only. Email of the user who created the app version. */
+      creator?: string;
+      /** Optional. The description of the app version. */
+      description?: string;
+      /** Optional. The display name of the app version. */
+      displayName?: string;
+      /** Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. */
+      etag?: string;
+      /** Identifier. The unique identifier of the app version. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}` */
+      name?: string;
+      /** Output only. The snapshot of the app when the version is created. */
+      snapshot?: AppSnapshot;
+    }
+    interface AudioProcessingConfig {
+      /** Optional. Configuration for the ambient sound to be played with the synthesized agent response, to enhance the naturalness of the conversation. */
+      ambientSoundConfig?: AmbientSoundConfig;
+      /** Optional. Configures the agent behavior for the user barge-in activities. */
+      bargeInConfig?: BargeInConfig;
+      /** Optional. The duration of user inactivity (no speech or interaction) before the agent prompts the user for reengagement. If not set, the agent will not prompt the user for reengagement. */
+      inactivityTimeout?: string;
+      /** Optional. Configuration of how the agent response should be synthesized, mapping from the language code to SynthesizeSpeechConfig. If the configuration for the specified language code is not found, the configuration for the root language code will be used. For example, if the map contains "en-us" and "en", and the specified language code is "en-gb", then "en" configuration will be used. Note: Language code is case-insensitive. */
+      synthesizeSpeechConfigs?: {[P in string]: SynthesizeSpeechConfig};
+    }
+    interface AudioRecordingConfig {
+      /** Optional. The [Cloud Storage](https://cloud.google.com/storage) bucket to store the session audio recordings. The URI must start with "gs://". Please choose a bucket location that meets your data residency requirements. Note: If the Cloud Storage bucket is in a different project from the app, you should grant `storage.objects.create` permission to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`. */
+      gcsBucket?: string;
+      /** Optional. The Cloud Storage path prefix for audio recordings. This prefix can include the following placeholders, which will be dynamically substituted at serving time: - $project: project ID - $location: app location - $app: app ID - $date: session date in YYYY-MM-DD format - $session: session ID If the path prefix is not specified, the default prefix `$project/$location/$app/$date/$session/` will be used. */
+      gcsPathPrefix?: string;
+    }
+    interface BargeInConfig {
+      /** Optional. If enabled, the agent will adapt its next response based on the assumption that the user hasn't heard the full preceding agent message. This should not be used in scenarios where agent responses are displayed visually. */
+      bargeInAwareness?: boolean;
+      /** Optional. Disables user barge-in while the agent is speaking. If true, user input during agent response playback will be ignored. Deprecated: `disable_barge_in` is deprecated in favor of `disable_barge_in_control` in ChannelProfile. */
+      disableBargeIn?: boolean;
+    }
+    interface BatchDeleteConversationsRequest {
+      /** Required. The resource names of the conversations to delete. */
+      conversations?: string[];
+    }
+    interface BearerTokenConfig {
+      /** Required. The bearer token. Must be in the format `$context.variables.`. */
+      token?: string;
+    }
+    interface BigQueryExportSettings {
+      /** Optional. The BigQuery dataset to export the data to. */
+      dataset?: string;
+      /** Optional. Indicates whether the BigQuery export is enabled. */
+      enabled?: boolean;
+      /** Optional. The project ID of the BigQuery dataset to export the data to. Note: If the BigQuery dataset is in a different project from the app, you should grant `roles/bigquery.admin` role to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`. */
+      project?: string;
+    }
+    interface Blob {
+      /** Required. Raw bytes of the blob. */
+      data?: string;
+      /** Required. The IANA standard MIME type of the source data. */
+      mimeType?: string;
+    }
+    interface Callback {
+      /** Optional. Human-readable description of the callback. */
+      description?: string;
+      /** Optional. Whether the callback is disabled. Disabled callbacks are ignored by the agent. */
+      disabled?: boolean;
+      /** Required. The python code to execute for the callback. */
+      pythonCode?: string;
+    }
+    interface CancelOperationRequest {}
+    interface Changelog {
+      /** Output only. The action that was performed on the resource. */
+      action?: string;
+      /** Output only. Email address of the change author. */
+      author?: string;
+      /** Output only. The time when the change was made. */
+      createTime?: string;
+      /** Output only. The dependent resources that were changed. */
+      dependentResources?: Array<{[P in string]: any}>;
+      /** Output only. Description of the change. which typically captures the changed fields in the resource. */
+      description?: string;
+      /** Output only. Display name of the change. It typically should be the display name of the resource that was changed. */
+      displayName?: string;
+      /** Identifier. The unique identifier of the changelog. Format: `projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}` */
+      name?: string;
+      /** Output only. The new resource after the change. */
+      newResource?: {[P in string]: any};
+      /** Output only. The original resource before the change. */
+      originalResource?: {[P in string]: any};
+      /** Output only. The resource that was changed. */
+      resource?: string;
+      /** Output only. The type of the resource that was changed. */
+      resourceType?: string;
+      /** Output only. The monotonically increasing sequence number of the changelog. */
+      sequenceNumber?: string;
+    }
+    interface ChannelProfile {
+      /** Optional. The type of the channel profile. */
+      channelType?: string;
+      /** Optional. Whether to disable user barge-in control in the conversation. - **true**: User interruptions are disabled while the agent is speaking. - **false**: The agent retains automatic control over when the user can interrupt. */
+      disableBargeInControl?: boolean;
+      /** Optional. Whether to disable DTMF (dual-tone multi-frequency). */
+      disableDtmf?: boolean;
+      /** Optional. The noise suppression level of the channel profile. Available values are "low", "moderate", "high", "very_high". */
+      noiseSuppressionLevel?: string;
+      /** Optional. The persona property of the channel profile. */
+      personaProperty?: ChannelProfilePersonaProperty;
+      /** Optional. The unique identifier of the channel profile. */
+      profileId?: string;
+      /** Optional. The configuration for the web widget. */
+      webWidgetConfig?: ChannelProfileWebWidgetConfig;
+    }
+    interface ChannelProfilePersonaProperty {
+      /** Optional. The persona of the channel. */
+      persona?: string;
+    }
+    interface ChannelProfileWebWidgetConfig {
+      /** Optional. The modality of the web widget. */
+      modality?: string;
+      /** Optional. The security settings of the web widget. */
+      securitySettings?: ChannelProfileWebWidgetConfigSecuritySettings;
+      /** Optional. The theme of the web widget. */
+      theme?: string;
+      /** Optional. The title of the web widget. */
+      webWidgetTitle?: string;
+    }
+    interface ChannelProfileWebWidgetConfigSecuritySettings {
+      /** Optional. The origins that are allowed to host the web widget. An origin is defined by RFC 6454. If empty, all origins are allowed. A maximum of 100 origins is allowed. Example: "https://example.com" */
+      allowedOrigins?: string[];
+      /** Optional. Indicates whether origin check for the web widget is enabled. If `true`, the web widget will check the origin of the website that loads the web widget and only allow it to be loaded in the same origin or any of the allowed origins. */
+      enableOriginCheck?: boolean;
+      /** Optional. Indicates whether public access to the web widget is enabled. If `true`, the web widget will be publicly accessible. If `false`, the web widget must be integrated with your own authentication and authorization system to return valid credentials for accessing the CES agent. */
+      enablePublicAccess?: boolean;
+      /** Optional. Indicates whether reCAPTCHA verification for the web widget is enabled. */
+      enableRecaptcha?: boolean;
+    }
+    interface Chunk {
+      /** Optional. Agent transfer event. */
+      agentTransfer?: AgentTransfer;
+      /** A struct represents default variables at the start of the conversation, keyed by variable names. */
+      defaultVariables?: {[P in string]: any};
+      /** Optional. Image data. */
+      image?: Image;
+      /** Optional. Custom payload data. */
+      payload?: {[P in string]: any};
+      /** Optional. Text data. */
+      text?: string;
+      /** Optional. Tool execution request. */
+      toolCall?: ToolCall;
+      /** Optional. Tool execution response. */
+      toolResponse?: ToolResponse;
+      /** Optional. Transcript associated with the audio. */
+      transcript?: string;
+      /** A struct represents variables that were updated in the conversation, keyed by variable names. */
+      updatedVariables?: {[P in string]: any};
+    }
+    interface Citations {
+      /** List of cited pieces of information. */
+      citedChunks?: CitationsCitedChunk[];
+    }
+    interface CitationsCitedChunk {
+      /** Text used for citaiton. */
+      text?: string;
+      /** Title of the cited document. */
+      title?: string;
+      /** URI used for citation. */
+      uri?: string;
+    }
+    interface ClientCertificateSettings {
+      /** Optional. The name of the SecretManager secret version resource storing the passphrase to decrypt the private key. Should be left unset if the private key is not encrypted. Format: `projects/{project}/secrets/{secret}/versions/{version}` */
+      passphrase?: string;
+      /** Required. The name of the SecretManager secret version resource storing the private key encoded in PEM format. Format: `projects/{project}/secrets/{secret}/versions/{version}` */
+      privateKey?: string;
+      /** Required. The TLS certificate encoded in PEM format. This string must include the begin header and end footer lines. */
+      tlsCertificate?: string;
+    }
+    interface ClientFunction {
+      /** Optional. The function description. */
+      description?: string;
+      /** Required. The function name. */
+      name?: string;
+      /** Optional. The schema of the function parameters. */
+      parameters?: Schema;
+      /** Optional. The schema of the function response. */
+      response?: Schema;
+    }
+    interface CloudLoggingSettings {
+      /** Optional. Whether to enable Cloud Logging for the sessions. */
+      enableCloudLogging?: boolean;
+    }
+    interface CodeBlock {
+      /** Required. Python code which will be invoked in tool fake mode. Expected Python function signature - To catch all tool calls: def fake_tool_call(tool: Tool, input: dict[str, Any], callback_context: CallbackContext) -> Optional[dict[str, Any]]: To catch a specific tool call: def fake_{tool_id}(tool: Tool, input: dict[str, Any], callback_context: CallbackContext) -> Optional[dict[str, Any]]: If the function returns None, the real tool will be invoked instead. */
+      pythonCode?: string;
+    }
+    interface ConnectorTool {
+      /** Required. Action for the tool to use. */
+      action?: Action;
+      /** Optional. Configures how authentication is handled in Integration Connectors. By default, an admin authentication is passed in the Integration Connectors API requests. You can override it with a different end-user authentication config. **Note**: The Connection must have authentication override enabled in order to specify an EUC configuration here - otherwise, the ConnectorTool creation will fail. See https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override for details. */
+      authConfig?: EndUserAuthConfig;
+      /** Required. The full resource name of the referenced Integration Connectors Connection. Format: `projects/{project}/locations/{location}/connections/{connection}` */
+      connection?: string;
+      /** Optional. The description of the tool that can be used by the Agent to decide whether to call this ConnectorTool. */
+      description?: string;
+      /** Optional. The name of the tool that can be used by the Agent to decide whether to call this ConnectorTool. */
+      name?: string;
+    }
+    interface ConnectorToolset {
+      /** Optional. Configures how authentication is handled in Integration Connectors. By default, an admin authentication is passed in the Integration Connectors API requests. You can override it with a different end-user authentication config. **Note**: The Connection must have authentication override enabled in order to specify an EUC configuration here - otherwise, the Toolset creation will fail. See: https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override */
+      authConfig?: EndUserAuthConfig;
+      /** Required. The full resource name of the referenced Integration Connectors Connection. Format: `projects/{project}/locations/{location}/connections/{connection}` */
+      connection?: string;
+      /** Required. The list of connector actions/entity operations to generate tools for. */
+      connectorActions?: Action[];
+    }
+    interface Conversation {
+      /** Output only. The version of the app used for processing the conversation. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}` */
+      appVersion?: string;
+      /** DEPRECATED. Please use input_types instead. */
+      channelType?: string;
+      /** Output only. The deployment of the app used for processing the conversation. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}` */
+      deployment?: string;
+      /** Output only. Timestamp when the conversation was completed. */
+      endTime?: string;
+      /** Output only. The agent that initially handles the conversation. If not specified, the conversation is handled by the root agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+      entryAgent?: string;
+      /** Output only. The input types of the conversation. */
+      inputTypes?: string[];
+      /** Output only. The language code of the conversation. */
+      languageCode?: string;
+      /** Deprecated. Use turns instead. */
+      messages?: Message[];
+      /** Identifier. The unique identifier of the conversation. Format: `projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}` */
+      name?: string;
+      /** Output only. Indicate the source of the conversation. */
+      source?: string;
+      /** Output only. Timestamp when the conversation was created. */
+      startTime?: string;
+      /** Output only. The number of turns in the conversation. */
+      turnCount?: number;
+      /** Required. The turns in the conversation. */
+      turns?: ConversationTurn[];
+    }
+    interface ConversationLoggingSettings {
+      /** Optional. Whether to disable conversation logging for the sessions. */
+      disableConversationLogging?: boolean;
+    }
+    interface ConversationTurn {
+      /** Optional. List of messages in the conversation turn, including user input, agent responses and intermediate events during the processing. */
+      messages?: Message[];
+      /** Optional. The root span of the action processing. */
+      rootSpan?: Span;
+    }
+    interface DataStore {
+      /** Output only. The connector config for the data store connection. */
+      connectorConfig?: DataStoreConnectorConfig;
+      /** Output only. Timestamp when the data store was created. */
+      createTime?: string;
+      /** Output only. The display name of the data store. */
+      displayName?: string;
+      /** Output only. The document processing mode for the data store connection. Only set for PUBLIC_WEB and UNSTRUCTURED data stores. */
+      documentProcessingMode?: string;
+      /** Required. Full resource name of the DataStore. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` */
+      name?: string;
+      /** Output only. The type of the data store. This field is readonly and populated by the server. */
+      type?: string;
+    }
+    interface DataStoreConnectorConfig {
+      /** Resource name of the collection the data store belongs to. */
+      collection?: string;
+      /** Display name of the collection the data store belongs to. */
+      collectionDisplayName?: string;
+      /** The name of the data source. Example: `salesforce`, `jira`, `confluence`, `bigquery`. */
+      dataSource?: string;
+    }
+    interface DataStoreSettings {
+      /** Output only. The engines for the app. */
+      engines?: DataStoreSettingsEngine[];
+    }
+    interface DataStoreSettingsEngine {
+      /** Output only. The resource name of the engine. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` */
+      name?: string;
+      /** Output only. The type of the engine. */
+      type?: string;
+    }
+    interface DataStoreTool {
+      /** Optional. Boost specification to boost certain documents. */
+      boostSpecs?: DataStoreToolBoostSpecs[];
+      /** Optional. Search within a single specific DataStore. */
+      dataStoreSource?: DataStoreToolDataStoreSource;
+      /** Optional. The tool description. */
+      description?: string;
+      /** Optional. Search within an Engine (potentially across multiple DataStores). */
+      engineSource?: DataStoreToolEngineSource;
+      /** Optional. The filter parameter behavior. */
+      filterParameterBehavior?: string;
+      /** Optional. The modality configs for the data store. */
+      modalityConfigs?: DataStoreToolModalityConfig[];
+      /** Required. The data store tool name. */
+      name?: string;
+    }
+    interface DataStoreToolBoostSpec {
+      /** Required. A list of boosting specifications. */
+      conditionBoostSpecs?: DataStoreToolBoostSpecConditionBoostSpec[];
+    }
+    interface DataStoreToolBoostSpecConditionBoostSpec {
+      /** Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that are relevant might still be shown. Setting to 0.0 means no boost applied. The boosting condition is ignored. */
+      boost?: number;
+      /** Optional. Complex specification for custom ranking based on customer defined attribute value. */
+      boostControlSpec?: DataStoreToolBoostSpecConditionBoostSpecBoostControlSpec;
+      /** Required. An expression which specifies a boost condition. The syntax is the same as filter expression syntax. Currently, the only supported condition is a list of BCP-47 lang codes. Example: To boost suggestions in languages en or fr: (lang_code: ANY("en", "fr")) */
+      condition?: string;
+    }
+    interface DataStoreToolBoostSpecConditionBoostSpecBoostControlSpec {
+      /** Optional. The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value). */
+      attributeType?: string;
+      /** Optional. The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here. */
+      controlPoints?: DataStoreToolBoostSpecConditionBoostSpecBoostControlSpecControlPoint[];
+      /** Optional. The name of the field whose value will be used to determine the boost amount. */
+      fieldName?: string;
+      /** Optional. The interpolation type to be applied to connect the control points listed below. */
+      interpolationType?: string;
+    }
+    interface DataStoreToolBoostSpecConditionBoostSpecBoostControlSpecControlPoint {
+      /** Optional. Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`. */
+      attributeValue?: string;
+      /** Optional. The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above. */
+      boostAmount?: number;
+    }
+    interface DataStoreToolBoostSpecs {
+      /** Required. The Data Store where the boosting configuration is applied. Full resource name of DataStore, such as projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. */
+      dataStores?: string[];
+      /** Required. A list of boosting specifications. */
+      spec?: DataStoreToolBoostSpec[];
+    }
+    interface DataStoreToolDataStoreSource {
+      /** Optional. The data store. */
+      dataStore?: DataStore;
+      /** Optional. Filter specification for the DataStore. See: https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata */
+      filter?: string;
+    }
+    interface DataStoreToolEngineSource {
+      /** Optional. Use to target specific DataStores within the Engine. If empty, the search applies to all DataStores associated with the Engine. */
+      dataStoreSources?: DataStoreToolDataStoreSource[];
+      /** Required. Full resource name of the Engine. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` */
+      engine?: string;
+      /** Optional. A filter applied to the search across the Engine. Not relevant and not used if 'data_store_sources' is provided. See: https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata */
+      filter?: string;
+    }
+    interface DataStoreToolGroundingConfig {
+      /** Optional. Whether grounding is disabled. */
+      disabled?: boolean;
+      /** Optional. The groundedness threshold of the answer based on the retrieved sources. The value has a configurable range of [1, 5]. The level is used to threshold the groundedness of the answer, meaning that all responses with a groundedness score below the threshold will fall back to returning relevant snippets only. For example, a level of 3 means that the groundedness score must be 3 or higher for the response to be returned. */
+      groundingLevel?: number;
+    }
+    interface DataStoreToolModalityConfig {
+      /** Optional. The grounding configuration. */
+      groundingConfig?: DataStoreToolGroundingConfig;
+      /** Required. The modality type. */
+      modalityType?: string;
+      /** Optional. The rewriter config. */
+      rewriterConfig?: DataStoreToolRewriterConfig;
+      /** Optional. The summarization config. */
+      summarizationConfig?: DataStoreToolSummarizationConfig;
+    }
+    interface DataStoreToolRewriterConfig {
+      /** Optional. Whether the rewriter is disabled. */
+      disabled?: boolean;
+      /** Required. Configurations for the LLM model. */
+      modelSettings?: ModelSettings;
+      /** Optional. The prompt definition. If not set, default prompt will be used. */
+      prompt?: string;
+    }
+    interface DataStoreToolSummarizationConfig {
+      /** Optional. Whether summarization is disabled. */
+      disabled?: boolean;
+      /** Optional. Configurations for the LLM model. */
+      modelSettings?: ModelSettings;
+      /** Optional. The prompt definition. If not set, default prompt will be used. */
+      prompt?: string;
+    }
+    interface Deployment {
+      /** Required. The resource name of the app version to deploy. Format: projects/{project}/locations/{location}/apps/{app}/versions/{version} */
+      appVersion?: string;
+      /** Required. The channel profile used in the deployment. */
+      channelProfile?: ChannelProfile;
+      /** Output only. Timestamp when this deployment was created. */
+      createTime?: string;
+      /** Required. Display name of the deployment. */
+      displayName?: string;
+      /** Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. */
+      etag?: string;
+      /** Identifier. The resource name of the deployment. Format: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment} */
+      name?: string;
+      /** Output only. Timestamp when this deployment was last updated. */
+      updateTime?: string;
+    }
+    interface Empty {}
+    interface EndSession {
+      /** Optional. Provides additional information about the end session signal, such as the reason for ending the session. */
+      metadata?: {[P in string]: any};
+    }
+    interface EndUserAuthConfig {
+      /** Oauth 2.0 Authorization Code authentication. */
+      oauth2AuthCodeConfig?: EndUserAuthConfigOauth2AuthCodeConfig;
+      /** JWT Profile Oauth 2.0 Authorization Grant authentication. */
+      oauth2JwtBearerConfig?: EndUserAuthConfigOauth2JwtBearerConfig;
+    }
+    interface EndUserAuthConfigOauth2AuthCodeConfig {
+      /** Required. Oauth token parameter name to pass through. Must be in the format `$context.variables.`. */
+      oauthToken?: string;
+    }
+    interface EndUserAuthConfigOauth2JwtBearerConfig {
+      /** Required. Client parameter name to pass through. Must be in the format `$context.variables.`. */
+      clientKey?: string;
+      /** Required. Issuer parameter name to pass through. Must be in the format `$context.variables.`. */
+      issuer?: string;
+      /** Required. Subject parameter name to pass through. Must be in the format `$context.variables.`. */
+      subject?: string;
+    }
+    interface EvaluationMetricsThresholds {
+      /** Optional. The golden evaluation metrics thresholds. */
+      goldenEvaluationMetricsThresholds?: EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholds;
+      /** Optional. The hallucination metric behavior for golden evaluations. */
+      goldenHallucinationMetricBehavior?: string;
+      /** Optional. Deprecated: Use `golden_hallucination_metric_behavior` instead. The hallucination metric behavior is currently used for golden evaluations. */
+      hallucinationMetricBehavior?: string;
+      /** Optional. The hallucination metric behavior for scenario evaluations. */
+      scenarioHallucinationMetricBehavior?: string;
+    }
+    interface EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholds {
+      /** Optional. The expectation level metrics thresholds. */
+      expectationLevelMetricsThresholds?: EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsExpectationLevelMetricsThresholds;
+      /** Optional. The turn level metrics thresholds. */
+      turnLevelMetricsThresholds?: EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsTurnLevelMetricsThresholds;
+    }
+    interface EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsExpectationLevelMetricsThresholds {
+      /** Optional. The success threshold for individual tool invocation parameter correctness. Must be a float between 0 and 1. Default is 1.0. */
+      toolInvocationParameterCorrectnessThreshold?: number;
+    }
+    interface EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsTurnLevelMetricsThresholds {
+      /** Optional. The success threshold for overall tool invocation correctness. Must be a float between 0 and 1. Default is 1.0. */
+      overallToolInvocationCorrectnessThreshold?: number;
+      /** Optional. The semantic similarity channel to use for evaluation. */
+      semanticSimilarityChannel?: string;
+      /** Optional. The success threshold for semantic similarity. Must be an integer between 0 and 4. Default is >= 3. */
+      semanticSimilaritySuccessThreshold?: number;
+    }
+    interface Event {
+      /** Required. The name of the event. */
+      event?: string;
+    }
+    interface Example {
+      /** Output only. Timestamp when the example was created. */
+      createTime?: string;
+      /** Optional. Human-readable description of the example. */
+      description?: string;
+      /** Required. Display name of the example. */
+      displayName?: string;
+      /** Optional. The agent that initially handles the conversation. If not specified, the example represents a conversation that is handled by the root agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+      entryAgent?: string;
+      /** Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. */
+      etag?: string;
+      /** Output only. The example may become invalid if referencing resources are deleted. Invalid examples will not be used as few-shot examples. */
+      invalid?: boolean;
+      /** Optional. The collection of messages that make up the conversation. */
+      messages?: Message[];
+      /** Identifier. The unique identifier of the example. Format: `projects/{project}/locations/{location}/apps/{app}/examples/{example}` */
+      name?: string;
+      /** Output only. Timestamp when the example was last updated. */
+      updateTime?: string;
+    }
+    interface ExecuteToolRequest {
+      /** Optional. The input parameters and values for the tool in JSON object format. */
+      args?: {[P in string]: any};
+      /** Optional. The name of the tool to execute. Format: projects/{project}/locations/{location}/apps/{app}/tools/{tool} */
+      tool?: string;
+      /** Optional. The toolset tool to execute. Only one tool should match the predicate from the toolset. Otherwise, an error will be returned. */
+      toolsetTool?: ToolsetTool;
+    }
+    interface ExecuteToolResponse {
+      /** Required. The tool execution result in JSON object format. Use "output" key to specify tool response and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as tool execution result. */
+      response?: {[P in string]: any};
+      /** The name of the tool that got executed. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` */
+      tool?: string;
+      /** The toolset tool that got executed. */
+      toolsetTool?: ToolsetTool;
+    }
+    interface ExportAppRequest {
+      /** Required. The format to export the app in. */
+      exportFormat?: string;
+      /** Optional. The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI to which to export the app. The format of this URI must be `gs:///`. The exported app archive will be written directly to the specified GCS object. */
+      gcsUri?: string;
+    }
+    interface ExportAppResponse {
+      /** App folder compressed as a zip file. */
+      appContent?: string;
+      /** The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI to which the app was exported. */
+      appUri?: string;
+    }
+    interface ExpressionCondition {
+      /** Required. The string representation of cloud.api.Expression condition. */
+      expression?: string;
+    }
+    interface FileSearchTool {
+      /** Optional. The type of the corpus. Default is FULLY_MANAGED. */
+      corpusType?: string;
+      /** Optional. The tool description. */
+      description?: string;
+      /** Optional. The corpus where files are stored. Format: projects/{project}/locations/{location}/ragCorpora/{rag_corpus} */
+      fileCorpus?: string;
+      /** Required. The tool name. */
+      name?: string;
+    }
+    interface GenerateChatTokenRequest {
+      /** Required. The deployment of the app to use for the session. Format: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment} */
+      deployment?: string;
+      /** Optional. The reCAPTCHA token generated by the client-side chat widget. */
+      recaptchaToken?: string;
+    }
+    interface GenerateChatTokenResponse {
+      /** The session scoped token for chat widget to authenticate with Session APIs. */
+      chatToken?: string;
+      /** The time at which the chat token expires. */
+      expireTime?: string;
+    }
+    interface GoogleSearchSuggestions {
+      /** Compliant HTML and CSS styling for search suggestions. The provided HTML and CSS automatically adapts to your device settings, displaying in either light or dark mode indicated by `@media(prefers-color-scheme)`. */
+      htmls?: string[];
+      /** List of queries used to perform the google search along with the search result URIs forming the search suggestions. */
+      webSearchQueries?: WebSearchQuery[];
+    }
+    interface GoogleSearchTool {
+      /** Optional. Content will be fetched directly from these URLs for context and grounding. Example: "https://example.com/path.html". A maximum of 20 URLs are allowed. */
+      contextUrls?: string[];
+      /** Optional. Description of the tool's purpose. */
+      description?: string;
+      /** Optional. List of domains to be excluded from the search results. Example: "example.com". A maximum of 2000 domains can be excluded. */
+      excludeDomains?: string[];
+      /** Required. The name of the tool. */
+      name?: string;
+      /** Optional. Specifies domains to restrict search results to. Example: "example.com", "another.site". A maximum of 20 domains can be specified. */
+      preferredDomains?: string[];
+    }
+    interface Guardrail {
+      /** Optional. Action to take when the guardrail is triggered. */
+      action?: TriggerAction;
+      /** Optional. Guardrail that potentially blocks the conversation based on the result of the callback execution. */
+      codeCallback?: GuardrailCodeCallback;
+      /** Optional. Guardrail that bans certain content from being used in the conversation. */
+      contentFilter?: GuardrailContentFilter;
+      /** Output only. Timestamp when the guardrail was created. */
+      createTime?: string;
+      /** Optional. Description of the guardrail. */
+      description?: string;
+      /** Required. Display name of the guardrail. */
+      displayName?: string;
+      /** Optional. Whether the guardrail is enabled. */
+      enabled?: boolean;
+      /** Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. */
+      etag?: string;
+      /** Optional. Guardrail that blocks the conversation if the LLM response is considered violating the policy based on the LLM classification. */
+      llmPolicy?: GuardrailLlmPolicy;
+      /** Optional. Guardrail that blocks the conversation if the prompt is considered unsafe based on the LLM classification. */
+      llmPromptSecurity?: GuardrailLlmPromptSecurity;
+      /** Optional. Guardrail that blocks the conversation if the LLM response is considered unsafe based on the model safety settings. */
+      modelSafety?: GuardrailModelSafety;
+      /** Identifier. The unique identifier of the guardrail. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}` */
+      name?: string;
+      /** Output only. Timestamp when the guardrail was last updated. */
+      updateTime?: string;
+    }
+    interface GuardrailCodeCallback {
+      /** Optional. The callback to execute after the agent is called. Each callback function is expected to return a structure (e.g., a dict or object) containing at least: - 'decision': Either 'OK' or 'TRIGGER'. - 'reason': A string explaining the decision. A 'TRIGGER' decision may halt further processing. */
+      afterAgentCallback?: Callback;
+      /** Optional. The callback to execute after the model is called. If there are multiple calls to the model, the callback will be executed multiple times. Each callback function is expected to return a structure (e.g., a dict or object) containing at least: - 'decision': Either 'OK' or 'TRIGGER'. - 'reason': A string explaining the decision. A 'TRIGGER' decision may halt further processing. */
+      afterModelCallback?: Callback;
+      /** Optional. The callback to execute before the agent is called. Each callback function is expected to return a structure (e.g., a dict or object) containing at least: - 'decision': Either 'OK' or 'TRIGGER'. - 'reason': A string explaining the decision. A 'TRIGGER' decision may halt further processing. */
+      beforeAgentCallback?: Callback;
+      /** Optional. The callback to execute before the model is called. If there are multiple calls to the model, the callback will be executed multiple times. Each callback function is expected to return a structure (e.g., a dict or object) containing at least: - 'decision': Either 'OK' or 'TRIGGER'. - 'reason': A string explaining the decision. A 'TRIGGER' decision may halt further processing. */
+      beforeModelCallback?: Callback;
+    }
+    interface GuardrailContentFilter {
+      /** Optional. List of banned phrases. Applies to both user inputs and agent responses. */
+      bannedContents?: string[];
+      /** Optional. List of banned phrases. Applies only to agent responses. */
+      bannedContentsInAgentResponse?: string[];
+      /** Optional. List of banned phrases. Applies only to user inputs. */
+      bannedContentsInUserInput?: string[];
+      /** Optional. If true, diacritics are ignored during matching. */
+      disregardDiacritics?: boolean;
+      /** Required. Match type for the content filter. */
+      matchType?: string;
+    }
+    interface GuardrailLlmPolicy {
+      /** Optional. By default, the LLM policy check is bypassed for short utterances. Enabling this setting applies the policy check to all utterances, including those that would normally be skipped. */
+      allowShortUtterance?: boolean;
+      /** Optional. If an error occurs during the policy check, fail open and do not trigger the guardrail. */
+      failOpen?: boolean;
+      /** Optional. When checking this policy, consider the last 'n' messages in the conversation. When not set a default value of 10 will be used. */
+      maxConversationMessages?: number;
+      /** Optional. Model settings. */
+      modelSettings?: ModelSettings;
+      /** Required. Defines when to apply the policy check during the conversation. If set to `POLICY_SCOPE_UNSPECIFIED`, the policy will be applied to the user input. When applying the policy to the agent response, additional latency will be introduced before the agent can respond. */
+      policyScope?: string;
+      /** Required. Policy prompt. */
+      prompt?: string;
+    }
+    interface GuardrailLlmPromptSecurity {
+      /** Optional. Use a user-defined LlmPolicy to configure the security guardrail. */
+      customPolicy?: GuardrailLlmPolicy;
+      /** Optional. Use the system's predefined default security settings. To select this mode, include an empty 'default_settings' message in the request. The 'default_prompt_template' field within will be populated by the server in the response. */
+      defaultSettings?: GuardrailLlmPromptSecurityDefaultSecuritySettings;
+      /** Optional. Determines the behavior when the guardrail encounters an LLM error. - If true: the guardrail is bypassed. - If false (default): the guardrail triggers/blocks. Note: If a custom policy is provided, this field is ignored in favor of the policy's 'fail_open' configuration. */
+      failOpen?: boolean;
+    }
+    interface GuardrailLlmPromptSecurityDefaultSecuritySettings {
+      /** Output only. The default prompt template used by the system. This field is for display purposes to show the user what prompt the system uses by default. It is OUTPUT_ONLY. */
+      defaultPromptTemplate?: string;
+    }
+    interface GuardrailModelSafety {
+      /** Required. List of safety settings. */
+      safetySettings?: GuardrailModelSafetySafetySetting[];
+    }
+    interface GuardrailModelSafetySafetySetting {
+      /** Required. The harm category. */
+      category?: string;
+      /** Required. The harm block threshold. */
+      threshold?: string;
+    }
+    interface Image {
+      /** Required. Raw bytes of the image. */
+      data?: string;
+      /** Required. The IANA standard MIME type of the source data. Supported image types includes: * image/png * image/jpeg * image/webp */
+      mimeType?: string;
+    }
+    interface ImportAppRequest {
+      /** Raw bytes representing the compressed zip file with the app folder structure. */
+      appContent?: string;
+      /** Optional. The ID to use for the imported app. * If not specified, a unique ID will be automatically assigned for the app. * Otherwise, the imported app will use this ID as the final component of its resource name. If an app with the same ID already exists at the specified location in the project, the content of the existing app will be replaced. */
+      appId?: string;
+      /** Optional. The display name of the app to import. * If the app is created on import, and the display name is specified, the imported app will use this display name. If a conflict is detected with an existing app, a timestamp will be appended to the display name to make it unique. * If the app is a reimport, this field should not be set. Providing a display name during reimport will result in an INVALID_ARGUMENT error. */
+      displayName?: string;
+      /** The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI from which to import app. The format of this URI must be `gs:///`. */
+      gcsUri?: string;
+      /** Optional. Options governing the import process for the app. */
+      importOptions?: ImportAppRequestImportOptions;
+    }
+    interface ImportAppRequestImportOptions {
+      /** Optional. The strategy to use when resolving conflicts during import. */
+      conflictResolutionStrategy?: string;
+    }
+    interface ImportAppResponse {
+      /** The resource name of the app that was imported. */
+      name?: string;
+      /** Warning messages generated during the import process. If errors occur for specific resources, they will not be included in the imported app and the error will be mentioned here. */
+      warnings?: string[];
+    }
+    interface InputAudioConfig {
+      /** Required. The encoding of the input audio data. */
+      audioEncoding?: string;
+      /** Optional. Whether to enable noise suppression on the input audio. Available values are "low", "moderate", "high", "very_high". */
+      noiseSuppressionLevel?: string;
+      /** Required. The sample rate (in Hertz) of the input audio data. */
+      sampleRateHertz?: number;
+    }
+    interface LanguageSettings {
+      /** Optional. The default language code of the app. */
+      defaultLanguageCode?: string;
+      /** Optional. Enables multilingual support. If true, agents in the app will use pre-built instructions to improve handling of multilingual input. */
+      enableMultilingualSupport?: boolean;
+      /** Optional. The action to perform when an agent receives input in an unsupported language. This can be a predefined action or a custom tool call. Valid values are: - A tool's full resource name, which triggers a specific tool execution. - A predefined system action, such as "escalate" or "exit", which triggers an EndSession signal with corresponding metadata to terminate the conversation. */
+      fallbackAction?: string;
+      /** Optional. List of languages codes supported by the app, in addition to the `default_language_code`. */
+      supportedLanguageCodes?: string[];
+    }
+    interface ListAgentsResponse {
+      /** The list of agents. */
+      agents?: Agent[];
+      /** A token that can be sent as ListAgentsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages. */
+      nextPageToken?: string;
+    }
+    interface ListAppsResponse {
+      /** The list of apps. */
+      apps?: App[];
+      /** A token that can be sent as ListAppsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages. */
+      nextPageToken?: string;
+      /** Unordered list. Locations that could not be reached. */
+      unreachable?: string[];
+    }
+    interface ListAppVersionsResponse {
+      /** The list of app versions. */
+      appVersions?: AppVersion[];
+      /** A token that can be sent as ListAppVersionsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages. */
+      nextPageToken?: string;
+    }
+    interface ListChangelogsResponse {
+      /** The list of changelogs. */
+      changelogs?: Changelog[];
+      /** A token that can be sent as ListChangelogsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages. */
+      nextPageToken?: string;
+    }
+    interface ListConversationsResponse {
+      /** The list of conversations. */
+      conversations?: Conversation[];
+      /** A token that can be sent as ListConversationsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages. */
+      nextPageToken?: string;
+    }
+    interface ListDeploymentsResponse {
+      /** The list of deployments. */
+      deployments?: Deployment[];
+      /** A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. */
+      nextPageToken?: string;
+    }
+    interface ListExamplesResponse {
+      /** The list of examples. */
+      examples?: Example[];
+      /** A token that can be sent as ListExamplesRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages. */
+      nextPageToken?: string;
+    }
+    interface ListGuardrailsResponse {
+      /** The list of guardrails. */
+      guardrails?: Guardrail[];
+      /** A token that can be sent as ListGuardrailsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages. */
+      nextPageToken?: string;
+    }
+    interface ListLocationsResponse {
+      /** A list of locations that matches the specified filter in the request. */
+      locations?: Location[];
+      /** The standard List next-page token. */
+      nextPageToken?: string;
+    }
+    interface ListOperationsResponse {
+      /** The standard List next-page token. */
+      nextPageToken?: string;
+      /** A list of operations that matches the specified filter in the request. */
+      operations?: Operation[];
+      /** Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations. */
+      unreachable?: string[];
+    }
+    interface ListToolsetsResponse {
+      /** A token that can be sent as ListToolsetsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages. */
+      nextPageToken?: string;
+      /** The list of toolsets. */
+      toolsets?: Toolset[];
+    }
+    interface ListToolsResponse {
+      /** A token that can be sent as ListToolsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages. */
+      nextPageToken?: string;
+      /** The list of tools. */
+      tools?: Tool[];
+    }
+    interface Location {
+      /** The friendly name for this location, typically a nearby city name. For example, "Tokyo". */
+      displayName?: string;
+      /** Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"} */
+      labels?: {[P in string]: string};
+      /** The canonical id for this location. For example: `"us-east1"`. */
+      locationId?: string;
+      /** Service-specific metadata. For example the available capacity at the given location. */
+      metadata?: {[P in string]: any};
+      /** Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"` */
+      name?: string;
+    }
+    interface LoggingSettings {
+      /** Optional. Configuration for how audio interactions should be recorded. */
+      audioRecordingConfig?: AudioRecordingConfig;
+      /** Optional. Settings to describe the BigQuery export behaviors for the app. The conversation data will be exported to BigQuery tables if it is enabled. */
+      bigqueryExportSettings?: BigQueryExportSettings;
+      /** Optional. Settings to describe the Cloud Logging behaviors for the app. */
+      cloudLoggingSettings?: CloudLoggingSettings;
+      /** Optional. Settings to describe the conversation logging behaviors for the app. */
+      conversationLoggingSettings?: ConversationLoggingSettings;
+      /** Optional. Configuration for how audio interactions should be recorded for the evaluation. By default, audio recording is not enabled for evaluation sessions. */
+      evaluationAudioRecordingConfig?: AudioRecordingConfig;
+      /** Optional. Settings to describe the conversation data collection behaviors for the LLM analysis pipeline for the app. */
+      metricAnalysisSettings?: MetricAnalysisSettings;
+      /** Optional. Configuration for how sensitive data should be redacted. */
+      redactionConfig?: RedactionConfig;
+    }
+    interface McpTool {
+      /** Optional. Authentication information required to execute the tool against the MCP server. For bearer token authentication, the token applies only to tool execution, not to listing tools. This requires that tools can be listed without authentication. */
+      apiAuthentication?: ApiAuthentication;
+      /** Optional. The description of the MCP tool. */
+      description?: string;
+      /** Optional. The schema of the input arguments of the MCP tool. */
+      inputSchema?: Schema;
+      /** Required. The name of the MCP tool. */
+      name?: string;
+      /** Optional. The schema of the output arguments of the MCP tool. */
+      outputSchema?: Schema;
+      /** Required. The server address of the MCP server, e.g., "https://example.com/mcp/". If the server is built with the MCP SDK, the url should be suffixed with "/mcp/". Only Streamable HTTP transport based servers are supported. This is the same as the server_address in the McpToolset. See https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http for more details. */
+      serverAddress?: string;
+      /** Optional. Service Directory configuration for VPC-SC, used to resolve service names within a perimeter. */
+      serviceDirectoryConfig?: ServiceDirectoryConfig;
+      /** Optional. The TLS configuration. Includes the custom server certificates that the client should trust. */
+      tlsConfig?: TlsConfig;
+    }
+    interface McpToolset {
+      /** Optional. Authentication information required to access tools and execute a tool against the MCP server. For bearer token authentication, the token applies only to tool execution, not to listing tools. This requires that tools can be listed without authentication. */
+      apiAuthentication?: ApiAuthentication;
+      /** Required. The address of the MCP server, for example, "https://example.com/mcp/". If the server is built with the MCP SDK, the url should be suffixed with "/mcp/". Only Streamable HTTP transport based servers are supported. See https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http for more details. */
+      serverAddress?: string;
+      /** Optional. Service Directory configuration for VPC-SC, used to resolve service names within a perimeter. */
+      serviceDirectoryConfig?: ServiceDirectoryConfig;
+      /** Optional. The TLS configuration. Includes the custom server certificates that the client should trust. */
+      tlsConfig?: TlsConfig;
+    }
+    interface Message {
+      /** Optional. Content of the message as a series of chunks. */
+      chunks?: Chunk[];
+      /** Optional. Timestamp when the message was sent or received. Should not be used if the message is part of an example. */
+      eventTime?: string;
+      /** Optional. The role within the conversation, e.g., user, agent. */
+      role?: string;
+    }
+    interface MetricAnalysisSettings {
+      /** Optional. Whether to collect conversation data for llm analysis metrics. If true, conversation data will not be collected for llm analysis metrics; otherwise, conversation data will be collected. */
+      llmMetricsOptedOut?: boolean;
+    }
+    interface ModelSettings {
+      /** Optional. The LLM model that the agent should use. If not set, the agent will inherit the model from its parent agent. */
+      model?: string;
+      /** Optional. If set, this temperature will be used for the LLM model. Temperature controls the randomness of the model's responses. Lower temperatures produce responses that are more predictable. Higher temperatures produce responses that are more creative. */
+      temperature?: number;
+    }
+    interface OAuthConfig {
+      /** Required. The client ID from the OAuth provider. */
+      clientId?: string;
+      /** Required. The name of the SecretManager secret version resource storing the client secret. Format: `projects/{project}/secrets/{secret}/versions/{version}` Note: You should grant `roles/secretmanager.secretAccessor` role to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`. */
+      clientSecretVersion?: string;
+      /** Required. OAuth grant types. */
+      oauthGrantType?: string;
+      /** Optional. The OAuth scopes to grant. */
+      scopes?: string[];
+      /** Required. The token endpoint in the OAuth provider to exchange for an access token. */
+      tokenEndpoint?: string;
+    }
+    interface Omnichannel {
+      /** Output only. Timestamp when the omnichannel resource was created. */
+      createTime?: string;
+      /** Optional. Human-readable description of the omnichannel resource. */
+      description?: string;
+      /** Required. Display name of the omnichannel resource. */
+      displayName?: string;
+      /** Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. */
+      etag?: string;
+      /** Optional. The integration config for the omnichannel resource. */
+      integrationConfig?: OmnichannelIntegrationConfig;
+      /** Identifier. The unique identifier of the omnichannel resource. Format: `projects/{project}/locations/{location}/omnichannels/{omnichannel}` */
+      name?: string;
+      /** Output only. Timestamp when the omnichannel resource was last updated. */
+      updateTime?: string;
+    }
+    interface OmnichannelIntegrationConfig {
+      /** Optional. Various of configuration for handling App events. */
+      channelConfigs?: {
+        [P in string]: OmnichannelIntegrationConfigChannelConfig;
+      };
+      /** Optional. The key of routing_configs is a key of `app_configs`, value is a `RoutingConfig`, which contains subscriber's key. */
+      routingConfigs?: {
+        [P in string]: OmnichannelIntegrationConfigRoutingConfig;
+      };
+      /** Optional. Various of subscribers configs. */
+      subscriberConfigs?: {
+        [P in string]: OmnichannelIntegrationConfigSubscriberConfig;
+      };
+    }
+    interface OmnichannelIntegrationConfigCesAppConfig {
+      /** The unique identifier of the CES app. Format: `projects/{project}/locations/{location}/apps/{app}` */
+      app?: string;
+    }
+    interface OmnichannelIntegrationConfigChannelConfig {
+      /** WhatsApp config. */
+      whatsappConfig?: OmnichannelIntegrationConfigWhatsappConfig;
+    }
+    interface OmnichannelIntegrationConfigRoutingConfig {
+      /** The key of the subscriber. */
+      subscriberKey?: string;
+    }
+    interface OmnichannelIntegrationConfigSubscriberConfig {
+      /** Ces app config. */
+      cesAppConfig?: OmnichannelIntegrationConfigCesAppConfig;
+    }
+    interface OmnichannelIntegrationConfigWhatsappConfig {
+      /** The Meta Business Portfolio (MBP) ID. https://www.facebook.com/business/help/1710077379203657 */
+      metaBusinessPortfolioId?: string;
+      /** The phone number used for sending/receiving messages. */
+      phoneNumber?: string;
+      /** The Phone Number ID associated with the WhatsApp Business Account. */
+      phoneNumberId?: string;
+      /** The verify token configured in the Meta App Dashboard for webhook verification. */
+      webhookVerifyToken?: string;
+      /** The customer's WhatsApp Business Account (WABA) ID. */
+      whatsappBusinessAccountId?: string;
+      /** The access token for authenticating API calls to the WhatsApp Cloud API. https://developers.facebook.com/docs/whatsapp/business-management-api/get-started/#business-integration-system-user-access-tokens */
+      whatsappBusinessToken?: string;
+    }
+    interface OmnichannelOperationMetadata {
+      /** Output only. The time the operation was created. */
+      createTime?: string;
+      /** Output only. The time the operation finished running. */
+      endTime?: string;
+      /** Output only. Identifies whether the user has requested cancellation of the operation. */
+      requestedCancellation?: boolean;
+      /** Output only. Human-readable status of the operation, if any. */
+      statusMessage?: string;
+    }
+    interface OpenApiTool {
+      /** Optional. Authentication information required by the API. */
+      apiAuthentication?: ApiAuthentication;
+      /** Optional. The description of the tool. If not provided, the description of the tool will be derived from the OpenAPI schema, from `operation.description` or `operation.summary`. */
+      description?: string;
+      /** Optional. If true, the agent will ignore unknown fields in the API response. */
+      ignoreUnknownFields?: boolean;
+      /** Optional. The name of the tool. If not provided, the name of the tool will be derived from the OpenAPI schema, from `operation.operationId`. */
+      name?: string;
+      /** Required. The OpenAPI schema in JSON or YAML format. */
+      openApiSchema?: string;
+      /** Optional. Service Directory configuration. */
+      serviceDirectoryConfig?: ServiceDirectoryConfig;
+      /** Optional. The TLS configuration. Includes the custom server certificates that the client will trust. */
+      tlsConfig?: TlsConfig;
+      /** Optional. The server URL of the Open API schema. This field is only set in tools in the environment dependencies during the export process if the schema contains a server url. During the import process, if this url is present in the environment dependencies and the schema has the $env_var placeholder, it will replace the placeholder in the schema. */
+      url?: string;
+    }
+    interface OpenApiToolset {
+      /** Optional. Authentication information required by the API. */
+      apiAuthentication?: ApiAuthentication;
+      /** Optional. If true, the agent will ignore unknown fields in the API response for all operations defined in the OpenAPI schema. */
+      ignoreUnknownFields?: boolean;
+      /** Required. The OpenAPI schema of the toolset. */
+      openApiSchema?: string;
+      /** Optional. Service Directory configuration. */
+      serviceDirectoryConfig?: ServiceDirectoryConfig;
+      /** Optional. The TLS configuration. Includes the custom server certificates */
+      tlsConfig?: TlsConfig;
+      /** Optional. The server URL of the Open API schema. This field is only set in toolsets in the environment dependencies during the export process if the schema contains a server url. During the import process, if this url is present in the environment dependencies and the schema has the $env_var placeholder, it will replace the placeholder in the schema. */
+      url?: string;
+    }
+    interface Operation {
+      /** If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. */
+      done?: boolean;
+      /** The error result of the operation in case of failure or cancellation. */
+      error?: Status;
+      /** Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any. */
+      metadata?: {[P in string]: any};
+      /** The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`. */
+      name?: string;
+      /** The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. */
+      response?: {[P in string]: any};
+    }
+    interface OperationMetadata {
+      /** Output only. The time the operation was created. */
+      createTime?: string;
+      /** Output only. The time the operation finished running. */
+      endTime?: string;
+      /** Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`. */
+      requestedCancellation?: boolean;
+      /** Output only. Human-readable status of the operation, if any. */
+      statusMessage?: string;
+    }
+    interface OutputAudioConfig {
+      /** Required. The encoding of the output audio data. */
+      audioEncoding?: string;
+      /** Required. The sample rate (in Hertz) of the output audio data. */
+      sampleRateHertz?: number;
+    }
+    interface PythonCodeCondition {
+      /** Required. The python code to execute. */
+      pythonCode?: string;
+    }
+    interface PythonFunction {
+      /** Output only. The description of the Python function, parsed from the python code's docstring. */
+      description?: string;
+      /** Optional. The name of the Python function to execute. Must match a Python function name defined in the python code. Case sensitive. If the name is not provided, the first function defined in the python code will be used. */
+      name?: string;
+      /** Optional. The Python code to execute for the tool. */
+      pythonCode?: string;
+    }
+    interface RedactionConfig {
+      /** Optional. [DLP](https://cloud.google.com/dlp/docs) deidentify template name to instruct on how to de-identify content. Format: `projects/{project}/locations/{location}/deidentifyTemplates/{deidentify_template}` */
+      deidentifyTemplate?: string;
+      /** Optional. If true, redaction will be applied in various logging scenarios, including conversation history, Cloud Logging and audio recording. */
+      enableRedaction?: boolean;
+      /** Optional. [DLP](https://cloud.google.com/dlp/docs) inspect template name to configure detection of sensitive data types. Format: `projects/{project}/locations/{location}/inspectTemplates/{inspect_template}` */
+      inspectTemplate?: string;
+    }
+    interface RestoreAppVersionRequest {}
+    interface RetrieveToolSchemaRequest {
+      /** Optional. The name of the tool to retrieve the schema for. Format: projects/{project}/locations/{location}/apps/{app}/tools/{tool} */
+      tool?: string;
+      /** Optional. The toolset tool to retrieve the schema for. Only one tool should match the predicate from the toolset. Otherwise, an error will be returned. */
+      toolsetTool?: ToolsetTool;
+    }
+    interface RetrieveToolSchemaResponse {
+      /** Required. The schema of the tool input parameters. */
+      inputSchema?: Schema;
+      /** Required. The schema of the tool output parameters. */
+      outputSchema?: Schema;
+      /** The name of the tool that the schema is for. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` */
+      tool?: string;
+      /** The toolset tool that the schema is for. */
+      toolsetTool?: ToolsetTool;
+    }
+    interface RetrieveToolsRequest {
+      /** Optional. The identifiers of the tools to retrieve from the toolset. If empty, all tools in the toolset will be returned. */
+      toolIds?: string[];
+    }
+    interface RetrieveToolsResponse {
+      /** Required. The list of tools that are included in the specified toolset. */
+      tools?: Tool[];
+    }
+    interface RunSessionRequest {
+      /** Required. The configuration for the session. */
+      config?: SessionConfig;
+      /** Required. Inputs for the session. */
+      inputs?: SessionInput[];
+    }
+    interface RunSessionResponse {
+      /** Outputs for the session. */
+      outputs?: SessionOutput[];
+    }
+    interface Schema {
+      /** Optional. Can either be a boolean or an object, controls the presence of additional properties. */
+      additionalProperties?: Schema;
+      /** Optional. The value should be validated against any (one or more) of the subschemas in the list. */
+      anyOf?: Schema[];
+      /** Optional. Default value of the data. */
+      default?: any;
+      /** Optional. A map of definitions for use by `ref`. Only allowed at the root of the schema. */
+      defs?: {[P in string]: Schema};
+      /** Optional. The description of the data. */
+      description?: string;
+      /** Optional. Possible values of the element of primitive type with enum format. Examples: 1. We can define direction as : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} 2. We can define apartment number as : {type:INTEGER, format:enum, enum:["101", "201", "301"]} */
+      enum?: string[];
+      /** Optional. Schema of the elements of Type.ARRAY. */
+      items?: Schema;
+      /** Optional. Maximum value for Type.INTEGER and Type.NUMBER. */
+      maximum?: number;
+      /** Optional. Maximum number of the elements for Type.ARRAY. */
+      maxItems?: string;
+      /** Optional. Minimum value for Type.INTEGER and Type.NUMBER. */
+      minimum?: number;
+      /** Optional. Minimum number of the elements for Type.ARRAY. */
+      minItems?: string;
+      /** Optional. Indicates if the value may be null. */
+      nullable?: boolean;
+      /** Optional. Schemas of initial elements of Type.ARRAY. */
+      prefixItems?: Schema[];
+      /** Optional. Properties of Type.OBJECT. */
+      properties?: {[P in string]: Schema};
+      /** Optional. Allows indirect references between schema nodes. The value should be a valid reference to a child of the root `defs`. For example, the following schema defines a reference to a schema node named "Pet": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the "pet" property is a reference to the schema node named "Pet". See details in https://json-schema.org/understanding-json-schema/structuring. */
+      ref?: string;
+      /** Optional. Required properties of Type.OBJECT. */
+      required?: string[];
+      /** Optional. The title of the schema. */
+      title?: string;
+      /** Required. The type of the data. */
+      type?: string;
+      /** Optional. Indicate the items in the array must be unique. Only applies to TYPE.ARRAY. */
+      uniqueItems?: boolean;
+    }
+    interface ServiceAccountAuthConfig {
+      /** Optional. The OAuth scopes to grant. If not specified, the default scope `https://www.googleapis.com/auth/cloud-platform` is used. */
+      scopes?: string[];
+      /** Required. The email address of the service account used for authentication. CES uses this service account to exchange an access token and the access token is then sent in the `Authorization` header of the request. The service account must have the `roles/iam.serviceAccountTokenCreator` role granted to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`. */
+      serviceAccount?: string;
+    }
+    interface ServiceAgentIdTokenAuthConfig {}
+    interface ServiceDirectoryConfig {
+      /** Required. The name of [Service Directory](https://cloud.google.com/service-directory) service. Format: `projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}`. Location of the service directory must be the same as the location of the app. */
+      service?: string;
+    }
+    interface SessionConfig {
+      /** Optional. The deployment of the app to use for the session. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}` */
+      deployment?: string;
+      /** Optional. The entry agent to handle the session. If not specified, the session will be handled by the root agent of the app. Format: `projects/{project}/locations/{location}/agents/{agent}` */
+      entryAgent?: string;
+      /** Optional. The historical context of the session, including user inputs, agent responses, and other messages. Typically, CES agent would manage session automatically so client doesn't need to explicitly populate this field. However, client can optionally override the historical contexts to force the session start from certain state. */
+      historicalContexts?: Message[];
+      /** Optional. Configuration for processing the input audio. */
+      inputAudioConfig?: InputAudioConfig;
+      /** Optional. Configuration for generating the output audio. */
+      outputAudioConfig?: OutputAudioConfig;
+      /** Optional. [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters) to send to the remote [Dialogflow](https://cloud.google.com/dialogflow/cx/docs/concept/console-conversational-agents) agent when the session control is transferred to the remote agent. */
+      remoteDialogflowQueryParameters?: SessionConfigRemoteDialogflowQueryParameters;
+      /** Optional. The time zone of the user. If provided, the agent will use the time zone for date and time related variables. Otherwise, the agent will use the time zone specified in the App.time_zone_settings. The format is the IANA Time Zone Database time zone, e.g. "America/Los_Angeles". */
+      timeZone?: string;
+    }
+    interface SessionConfigRemoteDialogflowQueryParameters {
+      /** Optional. The end user metadata to be sent in [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters). */
+      endUserMetadata?: {[P in string]: any};
+      /** Optional. The payload to be sent in [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters). */
+      payload?: {[P in string]: any};
+      /** Optional. The HTTP headers to be sent as webhook_headers in [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters). */
+      webhookHeaders?: {[P in string]: string};
+    }
+    interface SessionInput {
+      /** Optional. Audio data from the end user. */
+      audio?: string;
+      /** Optional. Blob data from the end user. */
+      blob?: Blob;
+      /** Optional. DTMF digits from the end user. */
+      dtmf?: string;
+      /** Optional. Event input. */
+      event?: Event;
+      /** Optional. Image data from the end user. */
+      image?: Image;
+      /** Optional. Text data from the end user. */
+      text?: string;
+      /** Optional. Execution results for the tool calls from the client. */
+      toolResponses?: ToolResponses;
+      /** Optional. Contextual variables for the session, keyed by name. Only variables declared in the app will be used by the CES agent. Unrecognized variables will still be sent to the Dialogflow agent as additional session parameters. */
+      variables?: {[P in string]: any};
+      /** Optional. A flag to indicate if the current message is a fragment of a larger input in the bidi streaming session. When `true`, the agent will defer processing until a subsequent message with `will_continue` set to `false` is received. Note: This flag has no effect on audio and DTMF inputs, which are always processed in real-time. */
+      willContinue?: boolean;
+    }
+    interface SessionOutput {
+      /** Output audio from the CES agent. */
+      audio?: string;
+      /** Citations that provide the source information for the agent's generated text. */
+      citations?: Citations;
+      /** Optional. Diagnostic information contains execution details during the processing of the input. Only populated in the last SessionOutput (with `turn_completed=true`) for each turn. */
+      diagnosticInfo?: SessionOutputDiagnosticInfo;
+      /** Indicates the session has ended. */
+      endSession?: EndSession;
+      /** The suggestions returned from Google Search as a result of invoking the GoogleSearchTool. */
+      googleSearchSuggestions?: GoogleSearchSuggestions;
+      /** Custom payload with structured output from the CES agent. */
+      payload?: {[P in string]: any};
+      /** Output text from the CES agent. */
+      text?: string;
+      /** Request for the client to execute the tools. */
+      toolCalls?: ToolCalls;
+      /** If true, the CES agent has detected the end of the current conversation turn and will provide no further output for this turn. */
+      turnCompleted?: boolean;
+      /** Indicates the sequential order of conversation turn to which this output belongs to, starting from 1. */
+      turnIndex?: number;
+    }
+    interface SessionOutputDiagnosticInfo {
+      /** List of the messages that happened during the processing. */
+      messages?: Message[];
+      /** A trace of the entire request processing, represented as a root span. This span can contain nested child spans for specific operations. */
+      rootSpan?: Span;
+    }
+    interface Span {
+      /** Output only. Key-value attributes associated with the span. */
+      attributes?: {[P in string]: any};
+      /** Output only. The child spans that are nested under this span. */
+      childSpans?: Span[];
+      /** Output only. The duration of the span. */
+      duration?: string;
+      /** Output only. The end time of the span. */
+      endTime?: string;
+      /** Output only. The name of the span. */
+      name?: string;
+      /** Output only. The start time of the span. */
+      startTime?: string;
+    }
+    interface Status {
+      /** The status code, which should be an enum value of google.rpc.Code. */
+      code?: number;
+      /** A list of messages that carry the error details. There is a common set of message types for APIs to use. */
+      details?: Array<{[P in string]: any}>;
+      /** A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. */
+      message?: string;
+    }
+    interface SynthesizeSpeechConfig {
+      /** Optional. The speaking rate/speed in the range [0.25, 2.0]. 1.0 is the normal native speed supported by the specific voice. 2.0 is twice as fast, and 0.5 is half as fast. Values outside of the range [0.25, 2.0] will return an error. */
+      speakingRate?: number;
+      /** Optional. The name of the voice. If not set, the service will choose a voice based on the other parameters such as language_code. For the list of available voices, please refer to [Supported voices and languages](https://cloud.google.com/text-to-speech/docs/voices) from Cloud Text-to-Speech. */
+      voice?: string;
+    }
+    interface SystemTool {
+      /** Output only. The description of the system tool. */
+      description?: string;
+      /** Required. The name of the system tool. */
+      name?: string;
+    }
+    interface TimeZoneSettings {
+      /** Optional. The time zone of the app from the [time zone database](https://www.iana.org/time-zones), e.g., America/Los_Angeles, Europe/Paris. */
+      timeZone?: string;
+    }
+    interface TlsConfig {
+      /** Required. Specifies a list of allowed custom CA certificates for HTTPS verification. */
+      caCerts?: TlsConfigCaCert[];
+    }
+    interface TlsConfigCaCert {
+      /** Required. The allowed custom CA certificates (in DER format) for HTTPS verification. This overrides the default SSL trust store. If this is empty or unspecified, CES will use Google's default trust store to verify certificates. N.B. Make sure the HTTPS server certificates are signed with "subject alt name". For instance a certificate can be self-signed using the following command, openssl x509 -req -days 200 -in example.com.csr \ -signkey example.com.key \ -out example.com.crt \ -extfile <(printf "\nsubjectAltName='DNS:www.example.com'") */
+      cert?: string;
+      /** Required. The name of the allowed custom CA certificates. This can be used to disambiguate the custom CA certificates. */
+      displayName?: string;
+    }
+    interface Tool {
+      /** Optional. The client function. */
+      clientFunction?: ClientFunction;
+      /** Optional. The Integration Connector tool. */
+      connectorTool?: ConnectorTool;
+      /** Output only. Timestamp when the tool was created. */
+      createTime?: string;
+      /** Optional. The data store tool. */
+      dataStoreTool?: DataStoreTool;
+      /** Output only. The display name of the tool, derived based on the tool's type. For example, display name of a ClientFunction is derived from its `name` property. */
+      displayName?: string;
+      /** Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. */
+      etag?: string;
+      /** Optional. The execution type of the tool. */
+      executionType?: string;
+      /** Optional. The file search tool. */
+      fileSearchTool?: FileSearchTool;
+      /** Output only. If the tool is generated by the LLM assistant, this field contains a descriptive summary of the generation. */
+      generatedSummary?: string;
+      /** Optional. The google search tool. */
+      googleSearchTool?: GoogleSearchTool;
+      /** Optional. The MCP tool. An MCP tool cannot be created or updated directly and is managed by the MCP toolset. */
+      mcpTool?: McpTool;
+      /** Identifier. The unique identifier of the tool. Format: - `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` for ## standalone tools. `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}/tools/{tool}` for tools retrieved from a toolset. These tools are dynamic and output-only, they cannot be referenced directly where a tool is expected. */
+      name?: string;
+      /** Optional. The open API tool. */
+      openApiTool?: OpenApiTool;
+      /** Optional. The python function tool. */
+      pythonFunction?: PythonFunction;
+      /** Optional. The system tool. */
+      systemTool?: SystemTool;
+      /** Optional. Configuration for tool behavior in fake mode. */
+      toolFakeConfig?: ToolFakeConfig;
+      /** Output only. Timestamp when the tool was last updated. */
+      updateTime?: string;
+      /** Optional. The widget tool. */
+      widgetTool?: WidgetTool;
+    }
+    interface ToolCall {
+      /** Optional. The input parameters and values for the tool in JSON object format. */
+      args?: {[P in string]: any};
+      /** Output only. Display name of the tool. */
+      displayName?: string;
+      /** Optional. The unique identifier of the tool call. If populated, the client should return the execution result with the matching ID in ToolResponse. */
+      id?: string;
+      /** Optional. The name of the tool to execute. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` */
+      tool?: string;
+      /** Optional. The toolset tool to execute. */
+      toolsetTool?: ToolsetTool;
+    }
+    interface ToolCalls {
+      /** Optional. The list of tool calls to execute. */
+      toolCalls?: ToolCall[];
+    }
+    interface ToolFakeConfig {
+      /** Optional. Code block which will be executed instead of a real tool call. */
+      codeBlock?: CodeBlock;
+      /** Optional. Whether the tool is using fake mode. */
+      enableFakeMode?: boolean;
+    }
+    interface ToolResponse {
+      /** Output only. Display name of the tool. */
+      displayName?: string;
+      /** Optional. The matching ID of the tool call the response is for. */
+      id?: string;
+      /** Required. The tool execution result in JSON object format. Use "output" key to specify tool response and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as tool execution result. */
+      response?: {[P in string]: any};
+      /** Optional. The name of the tool to execute. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` */
+      tool?: string;
+      /** Optional. The toolset tool that got executed. */
+      toolsetTool?: ToolsetTool;
+    }
+    interface ToolResponses {
+      /** Optional. The list of tool execution results. */
+      toolResponses?: ToolResponse[];
+    }
+    interface Toolset {
+      /** Optional. A toolset that generates tools from an Integration Connectors Connection. */
+      connectorToolset?: ConnectorToolset;
+      /** Output only. Timestamp when the toolset was created. */
+      createTime?: string;
+      /** Optional. The description of the toolset. */
+      description?: string;
+      /** Optional. The display name of the toolset. Must be unique within the same app. */
+      displayName?: string;
+      /** ETag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. */
+      etag?: string;
+      /** Optional. The execution type of the tools in the toolset. */
+      executionType?: string;
+      /** Optional. A toolset that contains a list of tools that are offered by the MCP server. */
+      mcpToolset?: McpToolset;
+      /** Identifier. The unique identifier of the toolset. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}` */
+      name?: string;
+      /** Optional. A toolset that contains a list of tools that are defined by an OpenAPI schema. */
+      openApiToolset?: OpenApiToolset;
+      /** Optional. Configuration for tools behavior in fake mode. */
+      toolFakeConfig?: ToolFakeConfig;
+      /** Output only. Timestamp when the toolset was last updated. */
+      updateTime?: string;
+    }
+    interface ToolsetTool {
+      /** Optional. The tool ID to filter the tools to retrieve the schema for. */
+      toolId?: string;
+      /** Required. The resource name of the Toolset from which this tool is derived. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}` */
+      toolset?: string;
+    }
+    interface TransferRule {
+      /** Required. The resource name of the child agent the rule applies to. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+      childAgent?: string;
+      /** Optional. A rule that immediately transfers to the target agent when the condition is met. */
+      deterministicTransfer?: TransferRuleDeterministicTransfer;
+      /** Required. The direction of the transfer. */
+      direction?: string;
+      /** Optional. Rule that prevents the planner from transferring to the target agent. */
+      disablePlannerTransfer?: TransferRuleDisablePlannerTransfer;
+    }
+    interface TransferRuleDeterministicTransfer {
+      /** Optional. A rule that evaluates a session state condition. If the condition evaluates to true, the transfer occurs. */
+      expressionCondition?: ExpressionCondition;
+      /** Optional. A rule that uses Python code block to evaluate the conditions. If the condition evaluates to true, the transfer occurs. */
+      pythonCodeCondition?: PythonCodeCondition;
+    }
+    interface TransferRuleDisablePlannerTransfer {
+      /** Required. If the condition evaluates to true, planner will not be allowed to transfer to the target agent. */
+      expressionCondition?: ExpressionCondition;
+    }
+    interface TriggerAction {
+      /** Optional. Respond with a generative answer. */
+      generativeAnswer?: TriggerActionGenerativeAnswer;
+      /** Optional. Immediately respond with a preconfigured response. */
+      respondImmediately?: TriggerActionRespondImmediately;
+      /** Optional. Transfer the conversation to a different agent. */
+      transferAgent?: TriggerActionTransferAgent;
+    }
+    interface TriggerActionGenerativeAnswer {
+      /** Required. The prompt to use for the generative answer. */
+      prompt?: string;
+    }
+    interface TriggerActionRespondImmediately {
+      /** Required. The canned responses for the agent to choose from. The response is chosen randomly. */
+      responses?: TriggerActionResponse[];
+    }
+    interface TriggerActionResponse {
+      /** Optional. Whether the response is disabled. Disabled responses are not used by the agent. */
+      disabled?: boolean;
+      /** Required. Text for the agent to respond with. */
+      text?: string;
+    }
+    interface TriggerActionTransferAgent {
+      /** Required. The name of the agent to transfer the conversation to. The agent must be in the same app as the current agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+      agent?: string;
+    }
+    interface WebSearchQuery {
+      /** The search query text. */
+      query?: string;
+      /** The URI to the Google Search results page for the query. */
+      uri?: string;
+    }
+    interface WidgetTool {
+      /** Optional. The description of the widget tool. */
+      description?: string;
+      /** Required. The display name of the widget tool. */
+      name?: string;
+      /** Optional. The input parameters of the widget tool. */
+      parameters?: Schema;
+      /** Optional. The type of the widget tool. If not specified, the default type will be CUSTOMIZED. */
+      widgetType?: string;
+    }
+    interface AgentsResource {
+      /** Creates a new agent in the given app. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Optional. The ID to use for the agent, which will become the final component of the agent's resource name. If not provided, a unique ID will be automatically assigned for the agent. */
+        agentId?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the app to create an agent in. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Agent;
+      }): Request<Agent>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Optional. The ID to use for the agent, which will become the final component of the agent's resource name. If not provided, a unique ID will be automatically assigned for the agent. */
+          agentId?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the app to create an agent in. */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Agent,
+      ): Request<Agent>;
+      /** Deletes the specified agent. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The current etag of the agent. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the agent, deletion will be blocked and an ABORTED error will be returned. */
+        etag?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Indicates whether to forcefully delete the agent, even if it is still referenced by other app/agents/examples. * If `force = false`, the deletion fails if other agents/examples reference it. * If `force = true`, delete the agent and remove it from all referencing apps/agents/examples. */
+        force?: boolean;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the agent to delete. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets details of the specified agent. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the agent to retrieve. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Agent>;
+      /** Lists agents in the given app. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Filter to be applied when listing the agents. See https://google.aip.dev/160 for more details. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. */
+        orderBy?: string;
+        /** Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */
+        pageSize?: number;
+        /** Optional. The next_page_token value returned from a previous list AgentService.ListAgents call. */
+        pageToken?: string;
+        /** Required. The resource name of the app to list agents from. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListAgentsResponse>;
+      /** Updates the specified agent. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Identifier. The unique identifier of the agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Agent;
+      }): Request<Agent>;
+      patch(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Identifier. The unique identifier of the agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+          updateMask?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Agent,
+      ): Request<Agent>;
+    }
+    interface ChangelogsResource {
+      /** Gets the specified changelog. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the changelog to retrieve. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Changelog>;
+      /** Lists the changelogs of the specified app. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Filter to be applied when listing the changelogs. See https://google.aip.dev/160 for more details. The filter string can be used to filter by `action`, `resource_type`, `resource_name`, `author`, and `create_time`. The `:` comparator can be used for case-insensitive partial matching on string fields, while `=` performs an exact case-sensitive match. Examples: * `action:update` (case-insensitive partial match) * `action="Create"` (case-sensitive exact match) * `resource_type:agent` * `resource_name:my-agent` * `author:me@example.com` * `create_time > "2025-01-01T00:00:00Z"` * `create_time <= "2025-01-01T00:00:00Z" AND resource_type:tool` */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. */
+        orderBy?: string;
+        /** Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */
+        pageSize?: number;
+        /** Optional. The next_page_token value returned from a previous list AgentService.ListChangelogs call. */
+        pageToken?: string;
+        /** Required. The resource name of the app to list changelogs from. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListChangelogsResponse>;
+    }
+    interface ConversationsResource {
+      /** Batch deletes the specified conversations. */
+      batchDelete(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the app to delete conversations from. Format: `projects/{project}/locations/{location}/apps/{app}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: BatchDeleteConversationsRequest;
+      }): Request<Operation>;
+      batchDelete(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the app to delete conversations from. Format: `projects/{project}/locations/{location}/apps/{app}` */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: BatchDeleteConversationsRequest,
+      ): Request<Operation>;
+      /** Deletes the specified conversation. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the conversation to delete. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Indicate the source of the conversation. If not set, Source.Live will be applied by default. */
+        source?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets details of the specified conversation. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the conversation to retrieve. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Indicate the source of the conversation. If not set, all source will be searched. */
+        source?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Conversation>;
+      /** Lists conversations in the given app. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Filter to be applied when listing the conversations. See https://google.aip.dev/160 for more details. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */
+        pageSize?: number;
+        /** Optional. The next_page_token value returned from a previous list AgentService.ListConversations call. */
+        pageToken?: string;
+        /** Required. The resource name of the app to list conversations from. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Indicate the source of the conversation. If not set, Source.Live will be applied by default. */
+        source?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListConversationsResponse>;
+    }
+    interface DeploymentsResource {
+      /** Creates a new deployment in the given app. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The ID to use for the deployment, which will become the final component of the deployment's resource name. If not provided, a unique ID will be automatically assigned for the deployment. */
+        deploymentId?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The parent app. Format: `projects/{project}/locations/{location}/apps/{app}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Deployment;
+      }): Request<Deployment>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Optional. The ID to use for the deployment, which will become the final component of the deployment's resource name. If not provided, a unique ID will be automatically assigned for the deployment. */
+          deploymentId?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The parent app. Format: `projects/{project}/locations/{location}/apps/{app}` */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Deployment,
+      ): Request<Deployment>;
+      /** Deletes the specified deployment. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The etag of the deployment. If an etag is provided and does not match the current etag of the deployment, deletion will be blocked and an ABORTED error will be returned. */
+        etag?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The name of the deployment to delete. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets details of the specified deployment. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The name of the deployment. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Deployment>;
+      /** Lists deployments in the given app. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. */
+        orderBy?: string;
+        /** Optional. The maximum number of deployments to return. The service may return fewer than this value. If unspecified, at most 50 deployments will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. */
+        pageSize?: number;
+        /** Optional. A page token, received from a previous `ListDeployments` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListDeployments` must match the call that provided the page token. */
+        pageToken?: string;
+        /** Required. The parent app. Format: `projects/{project}/locations/{location}/apps/{app}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListDeploymentsResponse>;
+      /** Updates the specified deployment. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Identifier. The resource name of the deployment. Format: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment} */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. The list of fields to update. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Deployment;
+      }): Request<Deployment>;
+      patch(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Identifier. The resource name of the deployment. Format: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment} */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. The list of fields to update. */
+          updateMask?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Deployment,
+      ): Request<Deployment>;
+    }
+    interface ExamplesResource {
+      /** Creates a new example in the given app. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The ID to use for the example, which will become the final component of the example's resource name. If not provided, a unique ID will be automatically assigned for the example. */
+        exampleId?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the app to create an example in. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Example;
+      }): Request<Example>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Optional. The ID to use for the example, which will become the final component of the example's resource name. If not provided, a unique ID will be automatically assigned for the example. */
+          exampleId?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the app to create an example in. */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Example,
+      ): Request<Example>;
+      /** Deletes the specified example. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The current etag of the example. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the example, deletion will be blocked and an ABORTED error will be returned. */
+        etag?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the example to delete. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets details of the specified example. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the example to retrieve. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Example>;
+      /** Lists examples in the given app. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Filter to be applied when listing the examples. See https://google.aip.dev/160 for more details. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. */
+        orderBy?: string;
+        /** Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */
+        pageSize?: number;
+        /** Optional. The next_page_token value returned from a previous list AgentService.ListExamples call. */
+        pageToken?: string;
+        /** Required. The resource name of the app to list examples from. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListExamplesResponse>;
+      /** Updates the specified example. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Identifier. The unique identifier of the example. Format: `projects/{project}/locations/{location}/apps/{app}/examples/{example}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Example;
+      }): Request<Example>;
+      patch(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Identifier. The unique identifier of the example. Format: `projects/{project}/locations/{location}/apps/{app}/examples/{example}` */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+          updateMask?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Example,
+      ): Request<Example>;
+    }
+    interface GuardrailsResource {
+      /** Creates a new guardrail in the given app. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. The ID to use for the guardrail, which will become the final component of the guardrail's resource name. If not provided, a unique ID will be automatically assigned for the guardrail. */
+        guardrailId?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the app to create a guardrail in. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Guardrail;
+      }): Request<Guardrail>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** Optional. The ID to use for the guardrail, which will become the final component of the guardrail's resource name. If not provided, a unique ID will be automatically assigned for the guardrail. */
+          guardrailId?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the app to create a guardrail in. */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Guardrail,
+      ): Request<Guardrail>;
+      /** Deletes the specified guardrail. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The current etag of the guardrail. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the guardrail, deletion will be blocked and an ABORTED error will be returned. */
+        etag?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Indicates whether to forcefully delete the guardrail, even if it is still referenced by app/agents. * If `force = false`, the deletion fails if any apps/agents still reference the guardrail. * If `force = true`, all existing references from apps/agents will be removed and the guardrail will be deleted. */
+        force?: boolean;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the guardrail to delete. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets details of the specified guardrail. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the guardrail to retrieve. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Guardrail>;
+      /** Lists guardrails in the given app. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Filter to be applied when listing the guardrails. See https://google.aip.dev/160 for more details. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. */
+        orderBy?: string;
+        /** Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */
+        pageSize?: number;
+        /** Optional. The next_page_token value returned from a previous list AgentService.ListGuardrails call. */
+        pageToken?: string;
+        /** Required. The resource name of the app to list guardrails from. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListGuardrailsResponse>;
+      /** Updates the specified guardrail. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Identifier. The unique identifier of the guardrail. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Guardrail;
+      }): Request<Guardrail>;
+      patch(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Identifier. The unique identifier of the guardrail. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}` */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+          updateMask?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Guardrail,
+      ): Request<Guardrail>;
+    }
+    interface SessionsResource {
+      /** Generates a session scoped token for chat widget to authenticate with Session APIs. */
+      generateChatToken(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The session name to generate the chat token for. Format: projects/{project}/locations/{location}/apps/{app}/sessions/{session} */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: GenerateChatTokenRequest;
+      }): Request<GenerateChatTokenResponse>;
+      generateChatToken(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Required. The session name to generate the chat token for. Format: projects/{project}/locations/{location}/apps/{app}/sessions/{session} */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: GenerateChatTokenRequest,
+      ): Request<GenerateChatTokenResponse>;
+      /** Initiates a single turn interaction with the CES agent within a session. */
+      runSession(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Required. The unique identifier of the session. Format: `projects/{project}/locations/{location}/apps/{app}/sessions/{session}` */
+        session: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: RunSessionRequest;
+      }): Request<RunSessionResponse>;
+      runSession(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Required. The unique identifier of the session. Format: `projects/{project}/locations/{location}/apps/{app}/sessions/{session}` */
+          session: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: RunSessionRequest,
+      ): Request<RunSessionResponse>;
+    }
+    interface ToolsResource {
+      /** Creates a new tool in the given app. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the app to create a tool in. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. The ID to use for the tool, which will become the final component of the tool's resource name. If not provided, a unique ID will be automatically assigned for the tool. */
+        toolId?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Tool;
+      }): Request<Tool>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the app to create a tool in. */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. The ID to use for the tool, which will become the final component of the tool's resource name. If not provided, a unique ID will be automatically assigned for the tool. */
+          toolId?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Tool,
+      ): Request<Tool>;
+      /** Deletes the specified tool. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The current etag of the tool. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the tool, deletion will be blocked and an ABORTED error will be returned. */
+        etag?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Indicates whether to forcefully delete the tool, even if it is still referenced by agents/examples. * If `force = false`, the deletion will fail if any agents still reference the tool. * If `force = true`, all existing references from agents will be removed and the tool will be deleted. */
+        force?: boolean;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the tool to delete. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets details of the specified tool. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the tool to retrieve. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Tool>;
+      /** Lists tools in the given app. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Filter to be applied when listing the tools. Use "include_system_tools=true" to include system tools in the response. See https://google.aip.dev/160 for more details. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. */
+        orderBy?: string;
+        /** Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */
+        pageSize?: number;
+        /** Optional. The next_page_token value returned from a previous list AgentService.ListTools call. */
+        pageToken?: string;
+        /** Required. The resource name of the app to list tools from. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListToolsResponse>;
+      /** Updates the specified tool. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Identifier. The unique identifier of the tool. Format: - `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` for ## standalone tools. `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}/tools/{tool}` for tools retrieved from a toolset. These tools are dynamic and output-only, they cannot be referenced directly where a tool is expected. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Tool;
+      }): Request<Tool>;
+      patch(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Identifier. The unique identifier of the tool. Format: - `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` for ## standalone tools. `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}/tools/{tool}` for tools retrieved from a toolset. These tools are dynamic and output-only, they cannot be referenced directly where a tool is expected. */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+          updateMask?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Tool,
+      ): Request<Tool>;
+    }
+    interface ToolsetsResource {
+      /** Creates a new toolset in the given app. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the app to create a toolset in. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. The ID to use for the toolset, which will become the final component of the toolset's resource name. If not provided, a unique ID will be automatically assigned for the toolset. */
+        toolsetId?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Toolset;
+      }): Request<Toolset>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the app to create a toolset in. */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. The ID to use for the toolset, which will become the final component of the toolset's resource name. If not provided, a unique ID will be automatically assigned for the toolset. */
+          toolsetId?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Toolset,
+      ): Request<Toolset>;
+      /** Deletes the specified toolset. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The current etag of the toolset. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the toolset, deletion will be blocked and an ABORTED error will be returned. */
+        etag?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Indicates whether to forcefully delete the toolset, even if it is still referenced by app/agents. * If `force = false`, the deletion fails if any agents still reference the toolset. * If `force = true`, all existing references from agents will be removed and the toolset will be deleted. */
+        force?: boolean;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the toolset to delete. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets details of the specified toolset. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the toolset to retrieve. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Toolset>;
+      /** Lists toolsets in the given app. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Filter to be applied when listing the toolsets. See https://google.aip.dev/160 for more details. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. */
+        orderBy?: string;
+        /** Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */
+        pageSize?: number;
+        /** Optional. The next_page_token value returned from a previous list AgentService.ListToolsets call. */
+        pageToken?: string;
+        /** Required. The resource name of the app to list toolsets from. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListToolsetsResponse>;
+      /** Updates the specified toolset. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Identifier. The unique identifier of the toolset. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: Toolset;
+      }): Request<Toolset>;
+      patch(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Identifier. The unique identifier of the toolset. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}` */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+          updateMask?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: Toolset,
+      ): Request<Toolset>;
+      /** Retrieve the list of tools included in the specified toolset. */
+      retrieveTools(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Required. The name of the toolset to retrieve the tools for. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}` */
+        toolset: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: RetrieveToolsRequest;
+      }): Request<RetrieveToolsResponse>;
+      retrieveTools(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Required. The name of the toolset to retrieve the tools for. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}` */
+          toolset: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: RetrieveToolsRequest,
+      ): Request<RetrieveToolsResponse>;
+    }
+    interface VersionsResource {
+      /** Creates a new app version in the given app. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** Optional. The ID to use for the app version, which will become the final component of the app version's resource name. If not provided, a unique ID will be automatically assigned for the app version. */
+        appVersionId?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the app to create an app version in. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: AppVersion;
+      }): Request<AppVersion>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** Optional. The ID to use for the app version, which will become the final component of the app version's resource name. If not provided, a unique ID will be automatically assigned for the app version. */
+          appVersionId?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the app to create an app version in. */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: AppVersion,
+      ): Request<AppVersion>;
+      /** Deletes the specified app version. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The current etag of the app version. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the app version, deletion will be blocked and an ABORTED error will be returned. */
+        etag?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the app version to delete. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets details of the specified app version. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the app version to retrieve. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<AppVersion>;
+      /** Lists all app versions in the given app. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Filter to be applied when listing the app versions. See https://google.aip.dev/160 for more details. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. */
+        orderBy?: string;
+        /** Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */
+        pageSize?: number;
+        /** Optional. The next_page_token value returned from a previous list AgentService.ListAppVersions call. */
+        pageToken?: string;
+        /** Required. The resource name of the app to list app versions from. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListAppVersionsResponse>;
+      /** Restores the specified app version. This will create a new app version from the current draft app and overwrite the current draft with the specified app version. */
+      restore(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the app version to restore. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: RestoreAppVersionRequest;
+      }): Request<Operation>;
+      restore(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Required. The resource name of the app version to restore. */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: RestoreAppVersionRequest,
+      ): Request<Operation>;
+    }
+    interface AppsResource {
+      /** Creates a new app in the given project and location. */
+      create(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** Optional. The ID to use for the app, which will become the final component of the app's resource name. If not provided, a unique ID will be automatically assigned for the app. */
+        appId?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the location to create an app in. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: App;
+      }): Request<Operation>;
+      create(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** Optional. The ID to use for the app, which will become the final component of the app's resource name. If not provided, a unique ID will be automatically assigned for the app. */
+          appId?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the location to create an app in. */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: App,
+      ): Request<Operation>;
+      /** Deletes the specified app. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. The current etag of the app. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the app, deletion will be blocked and an ABORTED error will be returned. */
+        etag?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the app to delete. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Operation>;
+      /** Executes the given tool with the given arguments. */
+      executeTool(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the app which the tool/toolset belongs to. Format: `projects/{project}/locations/{location}/apps/{app}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: ExecuteToolRequest;
+      }): Request<ExecuteToolResponse>;
+      executeTool(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the app which the tool/toolset belongs to. Format: `projects/{project}/locations/{location}/apps/{app}` */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: ExecuteToolRequest,
+      ): Request<ExecuteToolResponse>;
+      /** Exports the specified app. */
+      exportApp(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the app to export. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: ExportAppRequest;
+      }): Request<Operation>;
+      exportApp(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Required. The resource name of the app to export. */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: ExportAppRequest,
+      ): Request<Operation>;
+      /** Gets details of the specified app. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Required. The resource name of the app to retrieve. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<App>;
+      /** Imports the specified app. */
+      importApp(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The parent resource name with the location of the app to import. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: ImportAppRequest;
+      }): Request<Operation>;
+      importApp(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The parent resource name with the location of the app to import. */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: ImportAppRequest,
+      ): Request<Operation>;
+      /** Lists apps in the given project and location. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** Optional. Filter to be applied when listing the apps. See https://google.aip.dev/160 for more details. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. */
+        orderBy?: string;
+        /** Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */
+        pageSize?: number;
+        /** Optional. The next_page_token value returned from a previous list AgentService.ListApps call. */
+        pageToken?: string;
+        /** Required. The resource name of the location to list apps from. */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListAppsResponse>;
+      /** Updates the specified app. */
+      patch(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Identifier. The unique identifier of the app. Format: `projects/{project}/locations/{location}/apps/{app}` */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+        updateMask?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: App;
+      }): Request<App>;
+      patch(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** Identifier. The unique identifier of the app. Format: `projects/{project}/locations/{location}/apps/{app}` */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated. */
+          updateMask?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: App,
+      ): Request<App>;
+      /** Retrieve the schema of the given tool. The schema is computed on the fly for the given instance of the tool. */
+      retrieveToolSchema(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. The resource name of the app which the tool/toolset belongs to. Format: `projects/{project}/locations/{location}/apps/{app}` */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: RetrieveToolSchemaRequest;
+      }): Request<RetrieveToolSchemaResponse>;
+      retrieveToolSchema(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. The resource name of the app which the tool/toolset belongs to. Format: `projects/{project}/locations/{location}/apps/{app}` */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: RetrieveToolSchemaRequest,
+      ): Request<RetrieveToolSchemaResponse>;
+      agents: AgentsResource;
+      changelogs: ChangelogsResource;
+      conversations: ConversationsResource;
+      deployments: DeploymentsResource;
+      examples: ExamplesResource;
+      guardrails: GuardrailsResource;
+      sessions: SessionsResource;
+      tools: ToolsResource;
+      toolsets: ToolsetsResource;
+      versions: VersionsResource;
+    }
+    interface OperationsResource {
+      /** Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`. */
+      cancel(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** The name of the operation resource to be cancelled. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: CancelOperationRequest;
+      }): Request<{}>;
+      cancel(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** The name of the operation resource to be cancelled. */
+          name: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: CancelOperationRequest,
+      ): Request<{}>;
+      /** Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. */
+      delete(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** The name of the operation resource to be deleted. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<{}>;
+      /** Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** The name of the operation resource. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Operation>;
+      /** Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** The standard list filter. */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** The name of the operation's parent resource. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** The standard list page size. */
+        pageSize?: number;
+        /** The standard list page token. */
+        pageToken?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `"projects/example/locations/-"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation. */
+        returnPartialSuccess?: boolean;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListOperationsResponse>;
+    }
+    interface LocationsResource {
+      /** Gets information about a location. */
+      get(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** Resource name for the location. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<Location>;
+      /** Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project. */
+      list(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage. */
+        extraLocationTypes?: string | string[];
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160). */
+        filter?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** The resource that owns the locations collection, if applicable. */
+        name: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** The maximum number of results to return. If not set, the service selects a default. */
+        pageSize?: number;
+        /** A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page. */
+        pageToken?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<ListLocationsResponse>;
+      apps: AppsResource;
+      operations: OperationsResource;
+    }
+    interface ProjectsResource {
+      locations: LocationsResource;
+    }
+
+    const projects: ProjectsResource;
+  }
+}