google-cloud-ces-v1beta 1.0.1 → 1.2.0

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

@@ -130,6 +130,10 @@ module Google
         # @!attribute [r] validation_errors
         #   @return [::Array<::String>]
         #     Output only. Misconfigurations or warnings in the app.
+        # @!attribute [rw] dashboard_settings
+        #   @return [::Google::Cloud::Ces::V1beta::DashboardSettings]
+        #     Optional. App-specific dashboard settings for linking and configuring
+        #     Contact Center Insights dashboards.
         class App
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -179,6 +183,20 @@ module Google
           end
         end
 
+        # Settings for dashboards associated with the app, that show up in the
+        # Monitoring view.
+        # @!attribute [rw] default_dashboard
+        #   @return [::String]
+        #     Optional. The resource name of the default Contact Center Insights
+        #     dashboard associated with the app. This is the dashboard that will be
+        #     displayed when users navigate to the Monitoring view for the app.
+        #
+        #     Format: `projects/{project}/locations/{location}/dashboards/{dashboard}`
+        class DashboardSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # TimeZone settings of the app.
         # @!attribute [rw] time_zone
         #   @return [::String]
@@ -200,8 +218,8 @@ module Google
         #     `default_language_code`.
         # @!attribute [rw] enable_multilingual_support
         #   @return [::Boolean]
-        #     Optional. Enables multilingual support. If true, agents in the app will use
-        #     pre-built instructions to improve handling of multilingual input.
+        #     Optional. Enables multilingual support. If `true`, agents in the app will
+        #     use pre-built instructions to improve handling of multilingual input.
         # @!attribute [rw] fallback_action
         #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::String]
@@ -223,6 +241,79 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Configuration for a custom voice sample used for voice cloning.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Optional. The user-defined name for the custom voice sample.
+        # @!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.
+        # @!attribute [rw] consent_audio_gcs_uri
+        #   @return [::String]
+        #     Optional. Consent audio for voice cloning.
+        # @!attribute [rw] voice_instruction
+        #   @return [::String]
+        #     Optional. Natural language instructions for voice style, tone, pacing, or
+        #     pronunciation.
+        # @!attribute [r] preview_audio_content
+        #   @return [::String]
+        #     Output only. Synthesized preview audio for custom voice, formatted as
+        #     canonical WAV (LINEAR16, 24kHz, 16-bit, mono).
+        # @!attribute [rw] preview_text
+        #   @return [::String]
+        #     Optional. Text for synthesizing preview audio for custom voice.
+        # @!attribute [r] warnings
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::CustomVoiceSample::Warning>]
+        #     Output only. Warning messages encountered during voice clone processing
+        #     (e.g. low audio level).
+        # @!attribute [rw] voice_instruction_mode
+        #   @return [::Google::Cloud::Ces::V1beta::CustomVoiceSample::VoiceInstructionMode]
+        #     Optional. Instruction mode for the voice sample. If unspecified, defaults
+        #     to NO_INSTRUCTION.
+        class CustomVoiceSample
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # A warning message encountered during voice sample processing.
+          # @!attribute [r] message
+          #   @return [::String]
+          #     Output only. A human-readable description of the warning.
+          # @!attribute [r] type
+          #   @return [::Google::Cloud::Ces::V1beta::CustomVoiceSample::Warning::WarningType]
+          #     Output only. The type of the warning.
+          class Warning
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Type of warning encountered during voice sample processing.
+            module WarningType
+              # Unspecified warning type.
+              WARNING_TYPE_UNSPECIFIED = 0
+
+              # The audio level of the voice sample is too low (e.g. low RMS
+              # amplitude).
+              LOW_AUDIO_LEVEL = 1
+            end
+          end
+
+          # Instruction mode for the voice sample.
+          module VoiceInstructionMode
+            # Unspecified instruction mode. Defaults to NO_INSTRUCTION.
+            VOICE_INSTRUCTION_MODE_UNSPECIFIED = 0
+
+            # No voice instruction will be used.
+            NO_INSTRUCTION = 1
+
+            # Voice instruction will be automatically generated by AI from the audio
+            # sample.
+            GENERATE_INSTRUCTION = 2
+
+            # Custom voice instruction provided by the user.
+            CUSTOM_INSTRUCTION = 3
+          end
+        end
+
         # Configuration for how the input and output audio should be processed and
         # delivered.
         # @!attribute [rw] synthesize_speech_configs
@@ -249,6 +340,9 @@ module Google
         #   @return [::Google::Cloud::Ces::V1beta::AmbientSoundConfig]
         #     Optional. Configuration for the ambient sound to be played with the
         #     synthesized agent response, to enhance the naturalness of the conversation.
+        # @!attribute [rw] custom_voice_samples
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::CustomVoiceSample>]
+        #     Optional. Configures custom voice samples for voice cloning.
         class AudioProcessingConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -443,6 +537,20 @@ module Google
         #   @return [::Google::Cloud::Ces::V1beta::MetricAnalysisSettings]
         #     Optional. Settings to describe the conversation data collection behaviors
         #     for the LLM analysis pipeline for the app.
+        # @!attribute [rw] required_recording_consent
+        #   @return [::Boolean]
+        #     Optional. Whether the app has to say what may be recorded before anything
+        #     is kept.
+        #
+        #     When true, a session starts with recording off and stays off until the
+        #     client sends
+        #     [SessionInput.recording_control][google.cloud.ces.v1main.SessionInput.recording_control],
+        #     which then decides every turn from that point on. This covers audio
+        #     recording as well as conversation history, BigQuery export and Cloud
+        #     Logging.
+        #
+        #     When `false`, the default, the settings above decide on their own and the
+        #     client does not have to send anything.
         class LoggingSettings
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -780,8 +888,9 @@ module Google
         # Configuration to instruct how sensitive data should be handled.
         # @!attribute [rw] enable_redaction
         #   @return [::Boolean]
-        #     Optional. If true, redaction will be applied in various logging scenarios,
-        #     including conversation history, Cloud Logging and audio recording.
+        #     Optional. If `true`, redaction will be applied in various logging
+        #     scenarios, including conversation history, Cloud Logging and audio
+        #     recording.
         # @!attribute [rw] inspect_template
         #   @return [::String]
         #     Optional. [DLP](https://cloud.google.com/dlp/docs) inspect template name to

data/proto_docs/google/cloud/ces/v1beta/app_version.rb

@@ -65,6 +65,9 @@ module Google
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Timestamp when the app version was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Timestamp when the app version was last updated.
         # @!attribute [r] snapshot
         #   @return [::Google::Cloud::Ces::V1beta::AppSnapshot]
         #     Output only. The snapshot of the app when the version is created.

data/proto_docs/google/cloud/ces/v1beta/assistant_service.rb

@@ -0,0 +1,452 @@
+# 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 V1beta
+        # Request message for
+        # {::Google::Cloud::Ces::V1beta::AssistantService::Client#list_assistant_sessions AssistantService.ListAssistantSessions}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The app to list assistant sessions from.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Requested page size. Server may return fewer items than
+        #     requested. If unspecified, server will pick an appropriate default.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. The
+        #     {::Google::Cloud::Ces::V1beta::ListAssistantSessionsResponse#next_page_token next_page_token}
+        #     value returned from a previous list
+        #     {::Google::Cloud::Ces::V1beta::AssistantService::Client#list_assistant_sessions AssistantService.ListAssistantSessions}
+        #     call.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Filter to be applied when listing the assistant sessions.
+        #     See https://google.aip.dev/160 for more details.
+        class ListAssistantSessionsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::Ces::V1beta::AssistantService::Client#list_assistant_sessions AssistantService.ListAssistantSessions}.
+        # @!attribute [rw] assistant_sessions
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::AssistantSession>]
+        #     The list of assistant sessions.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Optional. A token that can be sent as
+        #     {::Google::Cloud::Ces::V1beta::ListAssistantSessionsRequest#page_token ListAssistantSessionsRequest.page_token}
+        #     to retrieve the next page. Absence of this field indicates there are no
+        #     subsequent pages.
+        class ListAssistantSessionsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::Ces::V1beta::AssistantService::Client#get_assistant_session AssistantService.GetAssistantSession}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the assistant session to retrieve.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistant_session}`
+        class GetAssistantSessionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::Ces::V1beta::AssistantService::Client#create_assistant_session AssistantService.CreateAssistantSession}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The app to create the assistant session in
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}`
+        # @!attribute [rw] assistant_session_id
+        #   @return [::String]
+        #     Optional. The ID to use for the assistant session, which will become the
+        #     final component of the assistant session's resource name. If not provided,
+        #     a unique ID will be automatically assigned for the assistant session.
+        # @!attribute [rw] assistant_session_messages
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::AssistantMessage>]
+        #     Optional. The messages to seed the assistant session with.
+        class CreateAssistantSessionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::Ces::V1beta::AssistantService::Client#delete_assistant_session AssistantService.DeleteAssistantSession}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the assistant session to delete.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistant_session}`
+        class DeleteAssistantSessionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::Ces::V1beta::AssistantService::Client#run_assistant AssistantService.RunAssistant}.
+        # @!attribute [rw] app
+        #   @return [::String]
+        #     Required. The app to run assistant for.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}`
+        # @!attribute [rw] assistant_session
+        #   @return [::String]
+        #     Required. The assistant session to be used to run the assistant.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistant_session}`
+        # @!attribute [rw] message
+        #   @return [::Google::Cloud::Ces::V1beta::AssistantMessage]
+        #     Required. The message to send to the assistant agent.
+        # @!attribute [rw] interaction_type
+        #   @return [::Google::Cloud::Ces::V1beta::RunAssistantRequest::InteractionType]
+        #     Optional. Different interaction types for the assistant message.
+        class RunAssistantRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The type of interaction for the message sent to the assistant.
+          module InteractionType
+            # The default value. This value is used if the type is not specified.
+            INTERACTION_TYPE_UNSPECIFIED = 0
+
+            # The message is a user input. User input is provided in the chunk list.
+            NEW_MESSAGE = 1
+
+            # The message is for polling the state of the assistant session.
+            POLL = 2
+
+            # The message is to dismiss the assistant session pending review. This will
+            # change the state of the assistant session to idle.
+            DISMISS = 3
+          end
+        end
+
+        # Response message for
+        # {::Google::Cloud::Ces::V1beta::AssistantService::Client#run_assistant AssistantService.RunAssistant}.
+        # @!attribute [rw] output
+        #   @return [::Google::Cloud::Ces::V1beta::AssistantOutput]
+        #     Required. The output from the assistant agent.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::Ces::V1beta::AssistantSessionState]
+        #     Output only. The status of the assistant session.
+        class RunAssistantResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # An assistant session represents a conversation between a user and the
+        # assistant agent.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Identifier. The unique identifier of the session.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{session}`
+        # @!attribute [r] requestor
+        #   @return [::String]
+        #     Output only. The user who initiated the session.
+        # @!attribute [rw] messages
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::AssistantMessage>]
+        #     Optional. History of messages in the session.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::Ces::V1beta::AssistantSessionState]
+        #     Output only. The status of the assistant session.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time the assistant session was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time the assistant session was last updated.
+        # @!attribute [r] user_response_suggestions
+        #   @return [::Google::Cloud::Ces::V1beta::UserResponseSuggestions]
+        #     Output only. Suggested user responses from the assistant agent.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Optional. The display name of the assistant session.
+        # @!attribute [r] artifacts
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::AssistantSessionArtifact>]
+        #     Output only. Document artifacts (e.g. generated TDDs in markdown) produced
+        #     by the assistant in this session. Pointers only; the file content lives in
+        #     the customer's Cloud Storage bucket.
+        # @!attribute [r] session_checkpoint
+        #   @return [::Google::Cloud::Ces::V1beta::SessionCheckpoint]
+        #     Output only. Session checkpoint containing user intent and rolling history
+        #     summary.
+        # @!attribute [r] active_turn
+        #   @return [::Google::Cloud::Ces::V1beta::ActiveTurnInfo]
+        #     Output only. Attachment info for this session's currently running turn.
+        #     Unset when no turn is running.
+        class AssistantSession
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Live-attachment info for a session turn that is currently running,
+        # disconnected from its client, or parked for pickup by another server task.
+        # @!attribute [rw] turn_id
+        #   @return [::String]
+        #     Identifies the turn; echoed by resume snapshots on the streaming API.
+        # @!attribute [rw] status
+        #   @return [::Google::Cloud::Ces::V1beta::ActiveTurnInfo::Status]
+        #     Current attachment status.
+        # @!attribute [r] start_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. When the turn started.
+        # @!attribute [r] last_progress_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. When the turn last persisted progress.
+        # @!attribute [r] orphan_deadline_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. When the turn will be wound down if no client attaches.
+        class ActiveTurnInfo
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # How the running turn currently relates to clients and server tasks.
+          module Status
+            # Unspecified.
+            STATUS_UNSPECIFIED = 0
+
+            # The turn is executing with at least one client attached.
+            RUNNING = 1
+
+            # The turn is executing with no client attached.
+            DISCONNECTED = 2
+
+            # The turn is parked for pickup: the next attach continues it.
+            RESUMING = 3
+
+            # The turn's server lease has lapsed and no task is driving it; the next
+            # read seals it to a committed partial. Not attachable.
+            ABANDONED = 4
+          end
+        end
+
+        # A document artifact generated by the assistant within a session, stored as
+        # a file in the customer's Cloud Storage bucket.
+        # @!attribute [r] id
+        #   @return [::String]
+        #     Output only. The unique identifier of the artifact within the session.
+        # @!attribute [r] display_name
+        #   @return [::String]
+        #     Output only. The file name shown to the user, e.g. "hotel_booking_tdd.md".
+        # @!attribute [r] gcs_uri
+        #   @return [::String]
+        #     Output only. The Cloud Storage object holding the artifact content.
+        #     Example:
+        #     "gs://\\{project}-agent-assist-artifacts/agent-assist-generated/1_tdd.md"
+        # @!attribute [r] mime_type
+        #   @return [::String]
+        #     Output only. The IANA media type of the artifact content, e.g.
+        #     "text/markdown".
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. When the artifact was persisted.
+        # @!attribute [r] turn_index
+        #   @return [::Integer]
+        #     Output only. Index of the message in [AssistantSession.messages] whose turn
+        #     produced the artifact, for placing the artifact chip when history is
+        #     restored.
+        class AssistantSessionArtifact
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A chunk of data in an assistant message.
+        # @!attribute [rw] text
+        #   @return [::String]
+        #     Optional. Text data.
+        #
+        #     Note: The following fields are mutually exclusive: `text`, `thought`, `payload`, `typed_payload`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] thought
+        #   @return [::String]
+        #     Optional. Thought generated by the model.
+        #
+        #     Note: The following fields are mutually exclusive: `thought`, `text`, `payload`, `typed_payload`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] payload
+        #   @return [::Google::Protobuf::Struct]
+        #     Optional. Payload which contains structured responses like the quality
+        #     report, agent version name, suggested responses etc.
+        #
+        #     Note: The following fields are mutually exclusive: `payload`, `text`, `thought`, `typed_payload`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] typed_payload
+        #   @return [::Google::Cloud::Ces::V1beta::TypedPayload]
+        #     Optional. Typed payload which contains structured responses.
+        #
+        #     Note: The following fields are mutually exclusive: `typed_payload`, `text`, `thought`, `payload`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Optional. Timestamp when the chunk was created or emitted.
+        class AssistantChunk
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The output from the assistant agent.
+        # @!attribute [rw] message
+        #   @return [::Google::Cloud::Ces::V1beta::AssistantMessage]
+        #     Required. The response from the assistant agent.
+        # @!attribute [r] user_response_suggestions
+        #   @return [::Google::Cloud::Ces::V1beta::UserResponseSuggestions]
+        #     Output only. Suggested user responses from the assistant agent.
+        class AssistantOutput
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A message in an assistant session.
+        # @!attribute [rw] role
+        #   @return [::String]
+        #     Required. Role within the conversation "user" or  "model".
+        # @!attribute [rw] chunks
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::AssistantChunk>]
+        #     Optional. Content of the message as chunks.
+        # @!attribute [rw] event_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Required. Timestamp when the message was sent or received.
+        # @!attribute [rw] attached_gcs_uris
+        #   @return [::Array<::String>]
+        #     Optional. Cloud Storage URIs for files uploaded by the user during this
+        #     turn. This allows attachments to be persisted and rendered in the session
+        #     history UI. Example: "gs://cxas-transient-uploads/uuid/prd.pdf"
+        class AssistantMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Payload with a type.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. The display name of the payload.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     Required. The type of the payload.
+        # @!attribute [rw] value
+        #   @return [::Google::Protobuf::Struct]
+        #     Required. The value of the payload.
+        # @!attribute [rw] metadata
+        #   @return [::Google::Protobuf::Struct]
+        #     Optional. The metadata of the payload.
+        class TypedPayload
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Suggested user responses from the assistant agent.
+        # @!attribute [rw] suggestions
+        #   @return [::Array<::String>]
+        #     Required. The assistant suggested user responses. These are suggestions for
+        #     the user on how to interact with the assistant.
+        class UserResponseSuggestions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::Ces::V1beta::AssistantService::Client#chat_ai_assistant AssistantService.ChatAiAssistant}.
+        # @!attribute [rw] app
+        #   @return [::String]
+        #     Required. The app to run assistant for.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}`
+        # @!attribute [rw] assistant_session
+        #   @return [::String]
+        #     Required. The assistant session to be used to run the assistant.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistant_session}`
+        # @!attribute [rw] message
+        #   @return [::String]
+        #     Required. The message to send to the assistant agent.
+        # @!attribute [rw] attached_gcs_uris
+        #   @return [::Array<::String>]
+        #     Optional. Cloud Storage URIs for files uploaded by the user during this
+        #     turn. Example: "gs://cxas-transient-uploads/uuid/prd.pdf"
+        # @!attribute [rw] context_token
+        #   @return [::String]
+        #     Optional. Opaque onboarding context token returned by
+        #     {::Google::Cloud::Ces::V1beta::SessionService::Client#generate_onboarding_suggestions SessionService.GenerateOnboardingSuggestions}.
+        #     When set and still fresh, the server reuses the onboarding snapshot
+        #     computed for the zero state instead of recomputing it for the first
+        #     conversation turn.
+        class ChatAiAssistantRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::Ces::V1beta::AssistantService::Client#chat_ai_assistant AssistantService.ChatAiAssistant}.
+        # @!attribute [rw] text_chunk
+        #   @return [::String]
+        #     Text Token (for streaming Gemini responses word-by-word)
+        #
+        #     Note: The following fields are mutually exclusive: `text_chunk`, `status_message`, `session_checkpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] status_message
+        #   @return [::String]
+        #     Simple status update
+        #
+        #     Note: The following fields are mutually exclusive: `status_message`, `text_chunk`, `session_checkpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] session_checkpoint
+        #   @return [::Google::Cloud::Ces::V1beta::SessionCheckpoint]
+        #     Session checkpoint/compaction recap event containing user intent and
+        #     rolling summary.
+        #
+        #     Note: The following fields are mutually exclusive: `session_checkpoint`, `text_chunk`, `status_message`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] event_id
+        #   @return [::String]
+        #     Unique identifier for the event.
+        # @!attribute [rw] event_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Timestamp when the event occurred.
+        # @!attribute [rw] ui_event
+        #   @return [::Google::Cloud::Ces::V1beta::UiEvent]
+        #     Optional. UI event payload.
+        class ChatAiAssistantResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The status of the assistant session.
+        module AssistantSessionState
+          # The default value. This value is used if the status is not specified.
+          ASSISTANT_SESSION_STATE_UNSPECIFIED = 0
+
+          # The assistant agent is processing the request as a long running task.
+          PROCESSING = 1
+
+          # The assistant agent is idle and does not have any pending requests or
+          # response.
+          IDLE = 2
+
+          # The assistant agent is done processing a long running task and has a
+          # response ready for the user.
+          PENDING_REVIEW = 3
+        end
+      end
+    end
+  end
+end