google-cloud-ces-v1 0.2.0 → 0.3.0

data/proto_docs/google/cloud/ces/v1/app.rb

@@ -112,10 +112,16 @@ module Google
         # @!attribute [rw] client_certificate_settings
         #   @return [::Google::Cloud::Ces::V1::ClientCertificateSettings]
         #     Optional. The default client certificate settings for the app.
+        # @!attribute [rw] vpc_sc_settings
+        #   @return [::Google::Cloud::Ces::V1::VpcScSettings]
+        #     Optional. VPC-SC settings for the app.
         # @!attribute [rw] locked
         #   @return [::Boolean]
         #     Optional. Indicates whether the app is locked for changes. If the app is
         #     locked, modifications to the app resources will be rejected.
+        # @!attribute [r] validation_errors
+        #   @return [::Array<::String>]
+        #     Output only. Misconfigurations or warnings in the app.
         class App
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -321,12 +327,12 @@ module Google
         # @!attribute [rw] disable_barge_in
         #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::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
+        #     Optional. Deprecated: `disable_barge_in` is deprecated in favor of
         #     {::Google::Cloud::Ces::V1::ChannelProfile#disable_barge_in_control `disable_barge_in_control`}
         #     in ChannelProfile.
+        #
+        #     Disables user barge-in while the agent is speaking. If true, user input
+        #     during agent response playback will be ignored.
         # @!attribute [rw] barge_in_awareness
         #   @return [::Boolean]
         #     Optional. If enabled, the agent will adapt its next response based on the
@@ -347,12 +353,30 @@ module Google
         #     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.
+        # @!attribute [rw] voice_sample_gcs_uri
+        #   @return [::String]
+        #     Optional. The Cloud Storage URI to the audio sample for voice cloning. The
+        #     audio sample should be a mono-channel, 24kHz WAV file.
+        #
+        #     Note: Please make sure the CES service agent
+        #     `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com` has
+        #     `storage.objects.get` permission to the Cloud Storage object.
         # @!attribute [rw] speaking_rate
         #   @return [::Float]
         #     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.
+        # @!attribute [rw] model
+        #   @return [::String]
+        #     Optional. The model used to synthesize audio.
+        #     Currently supported values:
+        #     - "gemini-3.1-flash-tts-preview"
+        #     If empty, Chirp3-HD is used.
+        # @!attribute [rw] instruction
+        #   @return [::String]
+        #     Optional. The instruction used to synthesize speech when using a generative
+        #     model.
         class SynthesizeSpeechConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -376,11 +400,25 @@ module Google
         #     Optional. Configuration for how sensitive data should be redacted.
         # @!attribute [rw] audio_recording_config
         #   @return [::Google::Cloud::Ces::V1::AudioRecordingConfig]
-        #     Optional. Configuration for how audio interactions should be recorded.
+        #     Optional. Configuration for how audio interactions should be recorded. The
+        #     audio is subject to redaction as configured in
+        #     {::Google::Cloud::Ces::V1::LoggingSettings#redaction_config RedactionConfig}.
+        # @!attribute [rw] unredacted_audio_recording_config
+        #   @return [::Google::Cloud::Ces::V1::AudioRecordingConfig]
+        #     Optional. Configures an additional recording of unredacted audio. This can
+        #     be used to maintain a raw audio copy when audio redaction is
+        #     {::Google::Cloud::Ces::V1::RedactionConfig#enable_redaction enabled}, typically
+        #     for auditing or monitoring purposes.
         # @!attribute [rw] bigquery_export_settings
         #   @return [::Google::Cloud::Ces::V1::BigQueryExportSettings]
-        #     Optional. Settings to describe the BigQuery export behaviors for the app.
-        #     The conversation data will be exported to BigQuery tables if it is enabled.
+        #     Optional. Configures the BigQuery export behaviors for the app. The
+        #     conversation data is subject to redaction as configured in
+        #     {::Google::Cloud::Ces::V1::LoggingSettings#redaction_config RedactionConfig}.
+        # @!attribute [rw] unredacted_bigquery_export_settings
+        #   @return [::Google::Cloud::Ces::V1::BigQueryExportSettings]
+        #     Optional. Configures the BigQuery export behaviors for the app.
+        #     The unredacted conversation data will be exported to BigQuery tables if it
+        #     is enabled.
         # @!attribute [rw] cloud_logging_settings
         #   @return [::Google::Cloud::Ces::V1::CloudLoggingSettings]
         #     Optional. Settings to describe the Cloud Logging behaviors for the app.
@@ -406,10 +444,56 @@ module Google
         # @!attribute [rw] error_handling_strategy
         #   @return [::Google::Cloud::Ces::V1::ErrorHandlingSettings::ErrorHandlingStrategy]
         #     Optional. The strategy to use for error handling.
+        # @!attribute [rw] fallback_response_config
+        #   @return [::Google::Cloud::Ces::V1::ErrorHandlingSettings::FallbackResponseConfig]
+        #     Optional. Configuration for handling fallback responses.
+        # @!attribute [rw] end_session_config
+        #   @return [::Google::Cloud::Ces::V1::ErrorHandlingSettings::EndSessionConfig]
+        #     Optional. Configuration for ending the session in case of system errors
+        #     (e.g. LLM errors).
         class ErrorHandlingSettings
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Configuration for handling fallback responses.
+          # @!attribute [rw] custom_fallback_messages
+          #   @return [::Google::Protobuf::Map{::String => ::String}]
+          #     Optional. The fallback messages in case of system errors (e.g. LLM
+          #     errors), mapped by [supported language
+          #     code](https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference/language).
+          # @!attribute [rw] max_fallback_attempts
+          #   @return [::Integer]
+          #     Optional. The maximum number of fallback attempts to make before the
+          #     agent emitting {::Google::Cloud::Ces::V1::EndSession EndSession} Signal.
+          class FallbackResponseConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::String]
+            class CustomFallbackMessagesEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Configuration for ending the session in case of system errors (e.g. LLM
+          # errors).
+          # @!attribute [rw] escalate_session
+          #   @return [::Boolean]
+          #     Optional. Whether to escalate the session in
+          #     {::Google::Cloud::Ces::V1::EndSession EndSession}. If session is escalated,
+          #     {::Google::Cloud::Ces::V1::EndSession#metadata metadata in EndSession} will
+          #     contain `session_escalated = true`. See
+          #     https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/deploy/google-telephony-platform#transfer_a_call_to_a_human_agent
+          #     for details.
+          class EndSessionConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Defines the strategy for handling errors.
           module ErrorHandlingStrategy
             # Unspecified error handling strategy.
@@ -563,10 +647,27 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # VPC-SC settings for the app.
+        # @!attribute [rw] allowed_origins
+        #   @return [::Array<::String>]
+        #     Optional. The allowed HTTP(s) origins that OpenAPI tools in the App are
+        #     able to directly call when VPC Service Controls are enabled. These strings
+        #     must match the origin exactly, including the port if specified. For
+        #     example, "https://example.com" or "https://example.com:443". This list does
+        #     not yet apply to Python tools that may make direct HTTP calls.
+        class VpcScSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Settings to describe the conversation logging behaviors for the app.
         # @!attribute [rw] disable_conversation_logging
         #   @return [::Boolean]
         #     Optional. Whether to disable conversation logging for the sessions.
+        # @!attribute [rw] retention_window
+        #   @return [::Google::Protobuf::Duration]
+        #     Optional. Controls the retention window for the conversation.
+        #     If not set, the conversation will be retained for 365 days.
         class ConversationLoggingSettings
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/ces/v1/common.rb

@@ -202,6 +202,12 @@ module Google
         #   @return [::String]
         #     Optional. The noise suppression level of the channel profile.
         #     Available values are "low", "moderate", "high", "very_high".
+        # @!attribute [rw] whatsapp_config
+        #   @return [::Google::Cloud::Ces::V1::ChannelProfile::WhatsAppConfig]
+        #     Optional. Configuration specific to WhatsApp deployments.
+        # @!attribute [rw] instagram_config
+        #   @return [::Google::Cloud::Ces::V1::ChannelProfile::InstagramConfig]
+        #     Optional. Configuration specific to Instagram deployments.
         class ChannelProfile
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -303,6 +309,48 @@ module Google
             end
           end
 
+          # Configuration specific to WhatsApp deployments.
+          # @!attribute [rw] waba_id
+          #   @return [::String]
+          #     Required. The WhatsApp Business Account ID.
+          # @!attribute [rw] phone_number_id
+          #   @return [::String]
+          #     Required. The Meta phone number ID.
+          # @!attribute [rw] phone_number
+          #   @return [::String]
+          #     Optional. The phone number in E.164 format.
+          # @!attribute [r] display_name
+          #   @return [::String]
+          #     Output only. The fetched Meta business page name.
+          # @!attribute [r] thumbnail_url
+          #   @return [::String]
+          #     Output only. The fetched Meta business profile thumbnail URL.
+          # @!attribute [r] description
+          #   @return [::String]
+          #     Output only. The description of the Meta business page or profile.
+          class WhatsAppConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Configuration specific to Instagram deployments.
+          # @!attribute [rw] instagram_account_id
+          #   @return [::String]
+          #     Required. The Instagram Account ID.
+          # @!attribute [r] display_name
+          #   @return [::String]
+          #     Output only. The fetched Meta business page name.
+          # @!attribute [r] thumbnail_url
+          #   @return [::String]
+          #     Output only. The fetched Meta business profile thumbnail URL.
+          # @!attribute [r] description
+          #   @return [::String]
+          #     Output only. The description of the Meta business page or profile.
+          class InstagramConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # The type of the channel profile.
           module ChannelType
             # Unknown channel type.
@@ -323,11 +371,20 @@ module Google
             # Contact Center as a Service (CCaaS) channel.
             CONTACT_CENTER_AS_A_SERVICE = 6
 
+            # Contact Center as a Service (CCaaS Chat) channel.
+            CONTACT_CENTER_AS_A_SERVICE_CHAT = 11
+
             # Five9 channel.
             FIVE9 = 7
 
             # Third party contact center integration channel.
             CONTACT_CENTER_INTEGRATION = 8
+
+            # WhatsApp channel.
+            WHATSAPP = 9
+
+            # Instagram channel.
+            INSTAGRAM = 10
           end
         end
 

data/proto_docs/google/cloud/ces/v1/conversation.rb

@@ -120,6 +120,10 @@ module Google
 
             # The conversation is from the evaluation.
             EVAL = 3
+
+            # The conversation is from an agent tool. Agent tool runs the agent in a
+            # separate session, which is persisted for testing and debugging purposes.
+            AGENT_TOOL = 4
           end
 
           # Type of the input message.
@@ -127,22 +131,25 @@ module Google
             # Unspecified input type.
             INPUT_TYPE_UNSPECIFIED = 0
 
-            # The input message is text.
+            # Text input.
             INPUT_TYPE_TEXT = 1
 
-            # The input message is audio.
+            # Event input.
+            INPUT_TYPE_EVENT = 7
+
+            # Audio input.
             INPUT_TYPE_AUDIO = 2
 
-            # The input message is image.
+            # Image input.
             INPUT_TYPE_IMAGE = 3
 
-            # The input message is blob file.
+            # Blob input.
             INPUT_TYPE_BLOB = 4
 
-            # The input message is client function tool response.
+            # Client function tool response input.
             INPUT_TYPE_TOOL_RESPONSE = 5
 
-            # The input message are variables.
+            # Variables input.
             INPUT_TYPE_VARIABLES = 6
           end
         end

data/proto_docs/google/cloud/ces/v1/deployment.rb

@@ -21,6 +21,64 @@ module Google
   module Cloud
     module Ces
       module V1
+        # Experiment for the deployment.
+        # @!attribute [rw] version_release
+        #   @return [::Google::Cloud::Ces::V1::ExperimentConfig::VersionRelease]
+        #     Optional. Version release for the experiment.
+        class ExperimentConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Version release for the experiment.
+          # @!attribute [rw] state
+          #   @return [::Google::Cloud::Ces::V1::ExperimentConfig::State]
+          #     Optional. State of the version release.
+          # @!attribute [rw] traffic_allocations
+          #   @return [::Array<::Google::Cloud::Ces::V1::ExperimentConfig::VersionRelease::TrafficAllocation>]
+          #     Optional. Traffic allocations for the version release.
+          class VersionRelease
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Traffic allocation for the version release.
+            # @!attribute [rw] id
+            #   @return [::String]
+            #     Optional. Id of the traffic allocation.
+            #     Free format string, up to 128 characters.
+            # @!attribute [rw] traffic_percentage
+            #   @return [::Integer]
+            #     Optional. Traffic percentage of the traffic allocation.
+            #     Must be between 0 and 100.
+            # @!attribute [rw] app_version
+            #   @return [::String]
+            #     Optional. App version of the traffic allocation.
+            #     Format:
+            #     `projects/{project}/locations/{location}/apps/{app}/versions/{version}`
+            class TrafficAllocation
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # State of the experiment.
+          module State
+            # Unspecified state.
+            STATE_UNSPECIFIED = 0
+
+            # Deprecated: This state is no longer used.
+            PENDING = 1
+
+            # Running state. Experiment is running and valid.
+            RUNNING = 2
+
+            # Deprecated: This state is no longer used.
+            DONE = 3
+
+            # Deprecated: This state is no longer used.
+            EXPIRED = 4
+          end
+        end
+
         # A deployment represents an immutable, queryable version of the app.
         # It is used to deploy an app version with a specific channel profile.
         # @!attribute [rw] name
@@ -52,10 +110,57 @@ module Google
         #     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.
+        # @!attribute [rw] experiment_config
+        #   @return [::Google::Cloud::Ces::V1::ExperimentConfig]
+        #     Optional. Experiment configuration for the deployment.
+        # @!attribute [rw] whatsapp_credentials
+        #   @return [::Google::Cloud::Ces::V1::WhatsAppCredentials]
+        #     Optional. Input only. Ephemeral WhatsApp credentials required when
+        #     configuring a WhatsApp channel profile.
+        # @!attribute [rw] instagram_credentials
+        #   @return [::Google::Cloud::Ces::V1::InstagramCredentials]
+        #     Optional. Input only. Ephemeral Instagram credentials required when
+        #     configuring a Instagram channel profile.
         class Deployment
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Ephemeral Meta credentials for WhatsApp native integration.
+        # @!attribute [rw] auth_code
+        #   @return [::String]
+        #     Required. The Meta auth code provided by the embedded signup flow.
+        # @!attribute [rw] pin
+        #   @return [::String]
+        #     Required. The 6-digit PIN created by the user for two-step verification.
+        # @!attribute [rw] phone_number
+        #   @return [::String]
+        #     Required. The phone number to register with WhatsApp.
+        # @!attribute [rw] business_account_id
+        #   @return [::String]
+        #     Required. The Business Account ID to use for the phone number.
+        # @!attribute [rw] waba_id
+        #   @return [::String]
+        #     Required. The WhatsApp Business Account ID.
+        # @!attribute [rw] conversation_profile_id
+        #   @return [::String]
+        #     Required. The Conversation Profile ID to use for the deployment.
+        class WhatsAppCredentials
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Ephemeral Meta credentials for Instagram native integration.
+        # @!attribute [rw] auth_code
+        #   @return [::String]
+        #     Required. The Meta auth code provided by the embedded signup flow.
+        # @!attribute [rw] conversation_profile_id
+        #   @return [::String]
+        #     Required. The Conversation Profile ID to use for the deployment.
+        class InstagramCredentials
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/ces/v1/mcp_tool.rb

@@ -27,6 +27,10 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The name of the MCP tool.
+        # @!attribute [rw] name_override
+        #   @return [::String]
+        #     Optional. The name override of the MCP tool.
+        #     This is populated if the name was overridden by a Toolset override.
         # @!attribute [rw] description
         #   @return [::String]
         #     Optional. The description of the MCP tool.
@@ -66,6 +70,10 @@ module Google
         #     can be set in the session variables. See
         #     https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection
         #     for more details.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::Ces::V1::McpTool::State]
+        #     Output only. The dynamic availability state of the tool on the external
+        #     server.
         class McpTool
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -78,6 +86,23 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Represents the dynamic availability state of the tool.
+          module State
+            # Default state.
+            STATE_UNSPECIFIED = 0
+
+            # The tool is available and actively offered by the server.
+            ACTIVE = 1
+
+            # The tool is configured or pinned, but currently not offered by the
+            # server.
+            INACTIVE = 2
+
+            # The tool exists on the server, but does not match the version on the
+            # server.
+            STALE = 3
+          end
         end
       end
     end

data/proto_docs/google/cloud/ces/v1/mcp_toolset.rb

@@ -52,6 +52,11 @@ module Google
         #     can be set in the session variables. See
         #     https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection
         #     for more details.
+        # @!attribute [rw] tool_overrides
+        #   @return [::Array<::Google::Cloud::Ces::V1::McpToolOverride>]
+        #     Optional. Overrides for individual tools within this toolset.
+        #     This allows overriding specific details like descriptions, names,
+        #     or pinning the tools' states so they aren't fully dynamic.
         class McpToolset
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -65,6 +70,48 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
         end
+
+        # Overrides associated with a given tool in a Toolset.
+        # This enables "pinning" or "overriding" of tool definitions from the external
+        # dynamic server.
+        # @!attribute [rw] tool
+        #   @return [::String]
+        #     Required. The original name of the tool as it is emitted by the MCP server.
+        # @!attribute [rw] name_override
+        #   @return [::String]
+        #     Optional. If present, this tool uses this name in the Agent instead of the
+        #     original name. This is primarily used as an alias if the MCP server offers
+        #     poorly named tools.
+        # @!attribute [rw] description_override
+        #   @return [::String]
+        #     Optional. If present, this tool uses this description instead of the
+        #     original description from the server.
+        # @!attribute [r] snapshot
+        #   @return [::Google::Cloud::Ces::V1::McpToolDefinition]
+        #     Output only. If present, this tool is "Pinned" and uses the snapshot values
+        #     as fallbacks if the server becomes temporarily unavailable or if no
+        #     Override is present.
+        class McpToolOverride
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Container for a tool's core definition elements that are snapshot.
+        # Schemas in the snapshot are used as-is and cannot be overridden.
+        # @!attribute [r] description
+        #   @return [::String]
+        #     Output only. The description of the MCP tool. This can be overridden
+        #     by `description_override` in `McpToolOverride`.
+        # @!attribute [r] input_schema
+        #   @return [::Google::Cloud::Ces::V1::Schema]
+        #     Output only. The schema of the input arguments of the MCP tool.
+        # @!attribute [r] output_schema
+        #   @return [::Google::Cloud::Ces::V1::Schema]
+        #     Output only. The schema of the output arguments of the MCP tool.
+        class McpToolDefinition
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/ces/v1/mocks.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Ces
+      module V1
+        # A mocked tool call.
+        #
+        # Expresses the target tool + a pattern to match against that tool's
+        # args / inputs. If the pattern matches, then the mock response will be
+        # returned.
+        # @!attribute [rw] tool_id
+        #   @return [::String]
+        #     Optional. The name of the tool to mock.
+        #     Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
+        #
+        #     Note: The following fields are mutually exclusive: `tool_id`, `toolset`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] toolset
+        #   @return [::Google::Cloud::Ces::V1::ToolsetTool]
+        #     Optional. The toolset to mock.
+        #
+        #     Note: The following fields are mutually exclusive: `toolset`, `tool_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] tool
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
+        #   @return [::String]
+        #     Optional. Deprecated. Use tool_identifier instead.
+        # @!attribute [rw] expected_args_pattern
+        #   @return [::Google::Protobuf::Struct]
+        #     Required. A pattern to match against the args / inputs of all dispatched
+        #     tool calls. If the tool call inputs match this pattern, then mock output
+        #     will be returned.
+        # @!attribute [rw] mock_response
+        #   @return [::Google::Protobuf::Struct]
+        #     Optional. The mock response / output to return if the tool call args /
+        #     inputs match the pattern.
+        class MockedToolCall
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/ces/v1/python_function.rb

@@ -34,6 +34,9 @@ module Google
         #   @return [::String]
         #     Output only. The description of the Python function, parsed from the python
         #     code's docstring.
+        # @!attribute [rw] service_directory_config
+        #   @return [::Google::Cloud::Ces::V1::ServiceDirectoryConfig]
+        #     Optional. Service Directory configuration for the tool.
         class PythonFunction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/ces/v1/session_service.rb

@@ -21,6 +21,32 @@ module Google
   module Cloud
     module Ces
       module V1
+        # Mock tool calls configuration for the session.
+        # @!attribute [rw] mocked_tool_calls
+        #   @return [::Array<::Google::Cloud::Ces::V1::MockedToolCall>]
+        #     Optional. All tool calls to mock for the duration of the session.
+        # @!attribute [rw] unmatched_tool_call_behavior
+        #   @return [::Google::Cloud::Ces::V1::MockConfig::UnmatchedToolCallBehavior]
+        #     Required. Beavhior for tool calls that don't match any args patterns in
+        #     mocked_tool_calls.
+        class MockConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # What to do when a tool call doesn't match any mocked tool calls.
+          module UnmatchedToolCallBehavior
+            # Default value. This value is unused.
+            UNMATCHED_TOOL_CALL_BEHAVIOR_UNSPECIFIED = 0
+
+            # Throw an error for any tool calls that don't match a mock expected input
+            # pattern.
+            FAIL = 1
+
+            # For unmatched tool calls, pass the tool call through to real tool.
+            PASS_THROUGH = 2
+          end
+        end
+
         # InputAudioConfig configures how the CES agent should interpret the incoming
         # audio data.
         # @!attribute [rw] audio_encoding
@@ -181,6 +207,9 @@ module Google
           # @!attribute [rw] text
           #   @return [::String]
           #     Text used for citation.
+          # @!attribute [rw] requires_attribution
+          #   @return [::Boolean]
+          #     Whether this citation requires attribution to be shown to the end users.
           class CitedChunk
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -308,6 +337,9 @@ module Google
         #     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.
+        # @!attribute [rw] context
+        #   @return [::Array<::Google::Protobuf::Any>]
+        #     Context messages for external supervision guardrails.
         class SessionOutput
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods