google-cloud-ces-v1 0.a → 0.1.0

data/lib/google/cloud/ces/v1/session_service/rest/service_stub.rb

@@ -0,0 +1,199 @@
+# 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!
+
+require "google/cloud/ces/v1/session_service_pb"
+
+module Google
+  module Cloud
+    module Ces
+      module V1
+        module SessionService
+          module Rest
+            ##
+            # REST service stub for the SessionService service.
+            # Service stub contains baseline method implementations
+            # including transcoding, making the REST call, and deserialing the response.
+            #
+            class ServiceStub
+              # @private
+              def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
+                # These require statements are intentionally placed here to initialize
+                # the REST modules only when it's required.
+                require "gapic/rest"
+
+                @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
+                                                             endpoint_template: endpoint_template,
+                                                             universe_domain: universe_domain,
+                                                             credentials: credentials,
+                                                             numeric_enums: true,
+                                                             service_name: self.class,
+                                                             raise_faraday_errors: false,
+                                                             logger: logger
+              end
+
+              ##
+              # The effective universe domain
+              #
+              # @return [String]
+              #
+              def universe_domain
+                @client_stub.universe_domain
+              end
+
+              ##
+              # The effective endpoint
+              #
+              # @return [String]
+              #
+              def endpoint
+                @client_stub.endpoint
+              end
+
+              ##
+              # The logger used for request/response debug logging.
+              #
+              # @return [Logger]
+              #
+              def logger stub: false
+                stub ? @client_stub.stub_logger : @client_stub.logger
+              end
+
+              ##
+              # Baseline implementation for the run_session REST call
+              #
+              # @param request_pb [::Google::Cloud::Ces::V1::RunSessionRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::Ces::V1::RunSessionResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::Ces::V1::RunSessionResponse]
+              #   A result object deserialized from the server's reply
+              def run_session request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_run_session_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "run_session",
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Cloud::Ces::V1::RunSessionResponse.decode_json response.body, ignore_unknown_fields: true
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
+              end
+
+              ##
+              # Baseline implementation for the stream_run_session REST call
+              #
+              # @param request_pb [::Google::Cloud::Ces::V1::RunSessionRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yieldparam chunk [::String] The chunk of data received during server streaming.
+              #
+              # @return [::Gapic::Rest::TransportOperation]
+              def stream_run_session(request_pb, options = nil, &)
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_stream_run_session_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "stream_run_session",
+                  options: options,
+                  is_server_streaming: true,
+                  &
+                )
+                ::Gapic::Rest::TransportOperation.new response
+              end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the run_session REST call
+              #
+              # @param request_pb [::Google::Cloud::Ces::V1::RunSessionRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_run_session_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{config.session}:runSession",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["config.session", %r{^projects/[^/]+/locations/[^/]+/apps/[^/]+/sessions/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the stream_run_session REST call
+              #
+              # @param request_pb [::Google::Cloud::Ces::V1::RunSessionRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_stream_run_session_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{config.session}:streamRunSession",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["config.session", %r{^projects/[^/]+/locations/[^/]+/apps/[^/]+/sessions/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/ces/v1/session_service/rest.rb

@@ -0,0 +1,53 @@
+# 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!
+
+require "gapic/rest"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/ces/v1/version"
+require "google/cloud/ces/v1/bindings_override"
+
+require "google/cloud/ces/v1/session_service/credentials"
+require "google/cloud/ces/v1/session_service/paths"
+require "google/cloud/ces/v1/session_service/rest/client"
+
+module Google
+  module Cloud
+    module Ces
+      module V1
+        ##
+        # Session service provides APIs for interacting with CES agents.
+        #
+        # To load this service and instantiate a REST client:
+        #
+        #     require "google/cloud/ces/v1/session_service/rest"
+        #     client = ::Google::Cloud::Ces::V1::SessionService::Rest::Client.new
+        #
+        module SessionService
+          # Client for the REST transport
+          module Rest
+          end
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "rest", "helpers.rb"
+require "google/cloud/ces/v1/session_service/rest/helpers" if ::File.file? helper_path

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

@@ -0,0 +1,55 @@
+# 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!
+
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/ces/v1/version"
+
+require "google/cloud/ces/v1/session_service/credentials"
+require "google/cloud/ces/v1/session_service/paths"
+require "google/cloud/ces/v1/session_service/client"
+require "google/cloud/ces/v1/session_service/rest"
+
+module Google
+  module Cloud
+    module Ces
+      module V1
+        ##
+        # Session service provides APIs for interacting with CES agents.
+        #
+        # @example Load this service and instantiate a gRPC client
+        #
+        #     require "google/cloud/ces/v1/session_service"
+        #     client = ::Google::Cloud::Ces::V1::SessionService::Client.new
+        #
+        # @example Load this service and instantiate a REST client
+        #
+        #     require "google/cloud/ces/v1/session_service/rest"
+        #     client = ::Google::Cloud::Ces::V1::SessionService::Rest::Client.new
+        #
+        module SessionService
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "session_service", "helpers.rb"
+require "google/cloud/ces/v1/session_service/helpers" if ::File.file? helper_path

data/lib/google/cloud/ces/v1/session_service_pb.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/ces/v1/session_service.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/ces/v1/common_pb'
+require 'google/cloud/ces/v1/example_pb'
+require 'google/cloud/ces/v1/search_suggestions_pb'
+require 'google/protobuf/struct_pb'
+
+
+descriptor_data = "\n)google/cloud/ces/v1/session_service.proto\x12\x13google.cloud.ces.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a google/cloud/ces/v1/common.proto\x1a!google/cloud/ces/v1/example.proto\x1a,google/cloud/ces/v1/search_suggestions.proto\x1a\x1cgoogle/protobuf/struct.proto\"\x99\x01\n\x10InputAudioConfig\x12?\n\x0e\x61udio_encoding\x18\x01 \x01(\x0e\x32\".google.cloud.ces.v1.AudioEncodingB\x03\xe0\x41\x02\x12\x1e\n\x11sample_rate_hertz\x18\x02 \x01(\x05\x42\x03\xe0\x41\x02\x12$\n\x17noise_suppression_level\x18\x06 \x01(\tB\x03\xe0\x41\x01\"t\n\x11OutputAudioConfig\x12?\n\x0e\x61udio_encoding\x18\x01 \x01(\x0e\x32\".google.cloud.ces.v1.AudioEncodingB\x03\xe0\x41\x02\x12\x1e\n\x11sample_rate_hertz\x18\x02 \x01(\x05\x42\x03\xe0\x41\x02\"\xed\x06\n\rSessionConfig\x12\x33\n\x07session\x18\x01 \x01(\tB\"\xe0\x41\x02\xfa\x41\x1c\n\x1a\x63\x65s.googleapis.com/Session\x12\x46\n\x12input_audio_config\x18\x02 \x01(\x0b\x32%.google.cloud.ces.v1.InputAudioConfigB\x03\xe0\x41\x01\x12H\n\x13output_audio_config\x18\x03 \x01(\x0b\x32&.google.cloud.ces.v1.OutputAudioConfigB\x03\xe0\x41\x01\x12>\n\x13historical_contexts\x18\x05 \x03(\x0b\x32\x1c.google.cloud.ces.v1.MessageB\x03\xe0\x41\x01\x12\x35\n\x0b\x65ntry_agent\x18\x0c \x01(\tB \xe0\x41\x01\xfa\x41\x1a\n\x18\x63\x65s.googleapis.com/Agent\x12\x17\n\ndeployment\x18\x08 \x01(\tB\x03\xe0\x41\x01\x12\x16\n\ttime_zone\x18\x0b \x01(\tB\x03\xe0\x41\x01\x12\x1b\n\x0euse_tool_fakes\x18\x0e \x01(\x08\x42\x03\xe0\x41\x01\x12s\n\"remote_dialogflow_query_parameters\x18\x0f \x01(\x0b\x32\x42.google.cloud.ces.v1.SessionConfig.RemoteDialogflowQueryParametersB\x03\xe0\x41\x01\x12\"\n\x15\x65nable_text_streaming\x18\x12 \x01(\x08\x42\x03\xe0\x41\x01\x1a\xb6\x02\n\x1fRemoteDialogflowQueryParameters\x12t\n\x0fwebhook_headers\x18\x01 \x03(\x0b\x32V.google.cloud.ces.v1.SessionConfig.RemoteDialogflowQueryParameters.WebhookHeadersEntryB\x03\xe0\x41\x01\x12-\n\x07payload\x18\x02 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\x12\x37\n\x11\x65nd_user_metadata\x18\x03 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\x1a\x35\n\x13WebhookHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"C\n\tToolCalls\x12\x36\n\ntool_calls\x18\x01 \x03(\x0b\x32\x1d.google.cloud.ces.v1.ToolCallB\x03\xe0\x41\x01\"O\n\rToolResponses\x12>\n\x0etool_responses\x18\x01 \x03(\x0b\x32!.google.cloud.ces.v1.ToolResponseB\x03\xe0\x41\x01\"\x84\x01\n\tCitations\x12?\n\x0c\x63ited_chunks\x18\x01 \x03(\x0b\x32).google.cloud.ces.v1.Citations.CitedChunk\x1a\x36\n\nCitedChunk\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\r\n\x05title\x18\x02 \x01(\t\x12\x0c\n\x04text\x18\x03 \x01(\t\"\x1b\n\x05\x45vent\x12\x12\n\x05\x65vent\x18\x01 \x01(\tB\x03\xe0\x41\x02\"\x82\x03\n\x0cSessionInput\x12\x13\n\x04text\x18\x01 \x01(\tB\x03\xe0\x41\x01H\x00\x12\x13\n\x04\x64tmf\x18\x06 \x01(\tB\x03\xe0\x41\x01H\x00\x12\x14\n\x05\x61udio\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x01H\x00\x12\x41\n\x0etool_responses\x18\x03 \x01(\x0b\x32\".google.cloud.ces.v1.ToolResponsesB\x03\xe0\x41\x01H\x00\x12\x30\n\x05image\x18\x04 \x01(\x0b\x32\x1a.google.cloud.ces.v1.ImageB\x03\xe0\x41\x01H\x00\x12.\n\x04\x62lob\x18\x07 \x01(\x0b\x32\x19.google.cloud.ces.v1.BlobB\x03\xe0\x41\x01H\x00\x12\x31\n\tvariables\x18\x05 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01H\x00\x12\x30\n\x05\x65vent\x18\t \x01(\x0b\x32\x1a.google.cloud.ces.v1.EventB\x03\xe0\x41\x01H\x00\x12\x1a\n\rwill_continue\x18\x08 \x01(\x08\x42\x03\xe0\x41\x01\x42\x0c\n\ninput_type\"\xce\x04\n\rSessionOutput\x12\x0e\n\x04text\x18\x01 \x01(\tH\x00\x12\x0f\n\x05\x61udio\x18\x02 \x01(\x0cH\x00\x12\x34\n\ntool_calls\x18\x03 \x01(\x0b\x32\x1e.google.cloud.ces.v1.ToolCallsH\x00\x12\x33\n\tcitations\x18\x08 \x01(\x0b\x32\x1e.google.cloud.ces.v1.CitationsH\x00\x12Q\n\x19google_search_suggestions\x18\n \x01(\x0b\x32,.google.cloud.ces.v1.GoogleSearchSuggestionsH\x00\x12\x36\n\x0b\x65nd_session\x18\t \x01(\x0b\x32\x1f.google.cloud.ces.v1.EndSessionH\x00\x12*\n\x07payload\x18\x0b \x01(\x0b\x32\x17.google.protobuf.StructH\x00\x12\x12\n\nturn_index\x18\x06 \x01(\x05\x12\x16\n\x0eturn_completed\x18\x04 \x01(\x08\x12O\n\x0f\x64iagnostic_info\x18\x07 \x01(\x0b\x32\x31.google.cloud.ces.v1.SessionOutput.DiagnosticInfoB\x03\xe0\x41\x01\x1an\n\x0e\x44iagnosticInfo\x12.\n\x08messages\x18\x01 \x03(\x0b\x32\x1c.google.cloud.ces.v1.Message\x12,\n\troot_span\x18\x03 \x01(\x0b\x32\x19.google.cloud.ces.v1.SpanB\r\n\x0boutput_type\",\n\x11RecognitionResult\x12\x17\n\ntranscript\x18\x01 \x01(\tB\x03\xe0\x41\x01\"&\n\x12InterruptionSignal\x12\x10\n\x08\x62\x61rge_in\x18\x01 \x01(\x08\"<\n\nEndSession\x12.\n\x08metadata\x18\x01 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\"\x08\n\x06GoAway\"\x84\x01\n\x11RunSessionRequest\x12\x37\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".google.cloud.ces.v1.SessionConfigB\x03\xe0\x41\x02\x12\x36\n\x06inputs\x18\x03 \x03(\x0b\x32!.google.cloud.ces.v1.SessionInputB\x03\xe0\x41\x02\"I\n\x12RunSessionResponse\x12\x33\n\x07outputs\x18\x01 \x03(\x0b\x32\".google.cloud.ces.v1.SessionOutput\"\xa7\x01\n\x18\x42idiSessionClientMessage\x12\x39\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".google.cloud.ces.v1.SessionConfigB\x03\xe0\x41\x01H\x00\x12@\n\x0erealtime_input\x18\x02 \x01(\x0b\x32!.google.cloud.ces.v1.SessionInputB\x03\xe0\x41\x01H\x00\x42\x0e\n\x0cmessage_type\"\xf7\x02\n\x18\x42idiSessionServerMessage\x12\x41\n\x0esession_output\x18\x01 \x01(\x0b\x32\".google.cloud.ces.v1.SessionOutputB\x03\xe0\x41\x01H\x00\x12I\n\x12recognition_result\x18\x02 \x01(\x0b\x32&.google.cloud.ces.v1.RecognitionResultB\x03\xe0\x41\x01H\x00\x12K\n\x13interruption_signal\x18\x03 \x01(\x0b\x32\'.google.cloud.ces.v1.InterruptionSignalB\x03\xe0\x41\x01H\x00\x12;\n\x0b\x65nd_session\x18\x05 \x01(\x0b\x32\x1f.google.cloud.ces.v1.EndSessionB\x03\xe0\x41\x01H\x00\x12\x33\n\x07go_away\x18\x06 \x01(\x0b\x32\x1b.google.cloud.ces.v1.GoAwayB\x03\xe0\x41\x01H\x00\x42\x0e\n\x0cmessage_type*R\n\rAudioEncoding\x12\x1e\n\x1a\x41UDIO_ENCODING_UNSPECIFIED\x10\x00\x12\x0c\n\x08LINEAR16\x10\x01\x12\t\n\x05MULAW\x10\x02\x12\x08\n\x04\x41LAW\x10\x03\x32\xea\x04\n\x0eSessionService\x12\xb2\x01\n\nRunSession\x12&.google.cloud.ces.v1.RunSessionRequest\x1a\'.google.cloud.ces.v1.RunSessionResponse\"S\x82\xd3\xe4\x93\x02M\"H/v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:runSession:\x01*\x12\xc0\x01\n\x10StreamRunSession\x12&.google.cloud.ces.v1.RunSessionRequest\x1a\'.google.cloud.ces.v1.RunSessionResponse\"Y\x82\xd3\xe4\x93\x02S\"N/v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:streamRunSession:\x01*0\x01\x12t\n\x0e\x42idiRunSession\x12-.google.cloud.ces.v1.BidiSessionClientMessage\x1a-.google.cloud.ces.v1.BidiSessionServerMessage\"\x00(\x01\x30\x01\x1aj\xca\x41\x12\x63\x65s.googleapis.com\xd2\x41Rhttps://www.googleapis.com/auth/ces,https://www.googleapis.com/auth/cloud-platformB\xc1\x01\n\x17\x63om.google.cloud.ces.v1B\x13SessionServiceProtoP\x01Z)cloud.google.com/go/ces/apiv1/cespb;cespb\xea\x41\x63\n\x1a\x63\x65s.googleapis.com/Session\x12\x45projects/{project}/locations/{location}/apps/{app}/sessions/{session}b\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Google
+  module Cloud
+    module Ces
+      module V1
+        InputAudioConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.InputAudioConfig").msgclass
+        OutputAudioConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.OutputAudioConfig").msgclass
+        SessionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.SessionConfig").msgclass
+        SessionConfig::RemoteDialogflowQueryParameters = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.SessionConfig.RemoteDialogflowQueryParameters").msgclass
+        ToolCalls = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.ToolCalls").msgclass
+        ToolResponses = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.ToolResponses").msgclass
+        Citations = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.Citations").msgclass
+        Citations::CitedChunk = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.Citations.CitedChunk").msgclass
+        Event = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.Event").msgclass
+        SessionInput = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.SessionInput").msgclass
+        SessionOutput = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.SessionOutput").msgclass
+        SessionOutput::DiagnosticInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.SessionOutput.DiagnosticInfo").msgclass
+        RecognitionResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.RecognitionResult").msgclass
+        InterruptionSignal = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.InterruptionSignal").msgclass
+        EndSession = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.EndSession").msgclass
+        GoAway = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.GoAway").msgclass
+        RunSessionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.RunSessionRequest").msgclass
+        RunSessionResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.RunSessionResponse").msgclass
+        BidiSessionClientMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.BidiSessionClientMessage").msgclass
+        BidiSessionServerMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.BidiSessionServerMessage").msgclass
+        AudioEncoding = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.AudioEncoding").enummodule
+      end
+    end
+  end
+end

data/lib/google/cloud/ces/v1/session_service_services_pb.rb

@@ -0,0 +1,119 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/ces/v1/session_service.proto for package 'google.cloud.ces.v1'
+# Original file comments:
+# 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
+#
+#     http://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.
+#
+
+require 'grpc'
+require 'google/cloud/ces/v1/session_service_pb'
+
+module Google
+  module Cloud
+    module Ces
+      module V1
+        module SessionService
+          # Session service provides APIs for interacting with CES agents.
+          class Service
+
+            include ::GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.ces.v1.SessionService'
+
+            # Initiates a single-turn interaction with the CES agent within a session.
+            rpc :RunSession, ::Google::Cloud::Ces::V1::RunSessionRequest, ::Google::Cloud::Ces::V1::RunSessionResponse
+            # Initiates a single-turn interaction with the CES agent. Uses server-side
+            # streaming to deliver incremental results and partial responses as they are
+            # generated.
+            #
+            # By default, complete responses (e.g., messages from callbacks or full LLM
+            # responses) are sent to the client as soon as they are available. To enable
+            # streaming individual text chunks directly from the model, set
+            # [enable_text_streaming][google.cloud.ces.v1.SessionConfig.enable_text_streaming]
+            # to true.
+            rpc :StreamRunSession, ::Google::Cloud::Ces::V1::RunSessionRequest, stream(::Google::Cloud::Ces::V1::RunSessionResponse)
+            # Establishes a bidirectional streaming connection with the CES agent.
+            # The agent processes continuous multimodal inputs (e.g., text, audio) and
+            # generates real-time multimodal output streams.
+            #
+            # --- Client Request Stream ---
+            # The client streams requests in the following order:
+            #
+            # 1.  Initialization:
+            #     The first message must contain
+            #     [SessionConfig][google.cloud.ces.v1.BidiSessionClientMessage.config].
+            #     For audio sessions, this should also include
+            #     [InputAudioConfig][google.cloud.ces.v1.SessionConfig.input_audio_config]
+            #     and
+            #     [OutputAudioConfig][google.cloud.ces.v1.SessionConfig.output_audio_config]
+            #     to define audio processing and synthesis parameters.
+            #
+            # 2.  Interaction:
+            #     Subsequent messages stream
+            #     [SessionInput][google.cloud.ces.v1.BidiSessionClientMessage.realtime_input]
+            #     containing real-time user input data.
+            #
+            # 3.  Termination:
+            #     The client should half-close the stream when there is no more user
+            #     input. It should also half-close upon receiving
+            #     [EndSession][google.cloud.ces.v1.BidiSessionServerMessage.end_session]
+            #     or [GoAway][google.cloud.ces.v1.BidiSessionServerMessage.go_away] from
+            #     the agent.
+            #
+            # --- Server Response Stream ---
+            # For each interaction turn, the agent streams messages in the following
+            # sequence:
+            #
+            # 1.  Speech Recognition (First N messages):
+            #     Contains
+            #     [RecognitionResult][google.cloud.ces.v1.BidiSessionServerMessage.recognition_result]
+            #     representing the concatenated user speech segments captured so far.
+            #     This is only populated for audio sessions.
+            #
+            # 2.  Response (Next M messages):
+            #     Contains
+            #     [SessionOutput][google.cloud.ces.v1.BidiSessionServerMessage.session_output]
+            #     delivering the agent's response in various modalities (e.g., text,
+            #     audio).
+            #
+            # 3.  Turn Completion (Final message of the turn):
+            #     Contains
+            #     [SessionOutput][google.cloud.ces.v1.BidiSessionServerMessage.session_output]
+            #     with [turn_completed][google.cloud.ces.v1.SessionOutput.turn_completed]
+            #     set to true. This signals the end of the current turn and includes
+            #     [DiagnosticInfo][google.cloud.ces.v1.SessionOutput.diagnostic_info]
+            #     with execution details.
+            #
+            # --- Audio Best Practices ---
+            # 1.  Streaming:
+            #     Stream [audio data][google.cloud.ces.v1.SessionInput.audio]
+            #     **CONTINUOUSLY**, even during silence. Recommended chunk size: 40-120ms
+            #     (balances latency vs. efficiency).
+            #
+            # 2.  Playback & Interruption:
+            #     Play [audio responses][google.cloud.ces.v1.SessionOutput.audio] upon
+            #     receipt. Stop playback immediately if an
+            #     [InterruptionSignal][google.cloud.ces.v1.BidiSessionServerMessage.interruption_signal]
+            #     is received (e.g., user barge-in or new agent response).
+            rpc :BidiRunSession, stream(::Google::Cloud::Ces::V1::BidiSessionClientMessage), stream(::Google::Cloud::Ces::V1::BidiSessionServerMessage)
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/ces/v1/system_tool_pb.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/ces/v1/system_tool.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+
+
+descriptor_data = "\n%google/cloud/ces/v1/system_tool.proto\x12\x13google.cloud.ces.v1\x1a\x1fgoogle/api/field_behavior.proto\"9\n\nSystemTool\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x18\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x03\xe0\x41\x03\x42W\n\x17\x63om.google.cloud.ces.v1B\x0fSystemToolProtoP\x01Z)cloud.google.com/go/ces/apiv1/cespb;cespbb\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Google
+  module Cloud
+    module Ces
+      module V1
+        SystemTool = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.SystemTool").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/ces/v1/tool_pb.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/ces/v1/tool.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/ces/v1/agent_tool_pb'
+require 'google/cloud/ces/v1/client_function_pb'
+require 'google/cloud/ces/v1/common_pb'
+require 'google/cloud/ces/v1/connector_tool_pb'
+require 'google/cloud/ces/v1/data_store_tool_pb'
+require 'google/cloud/ces/v1/fakes_pb'
+require 'google/cloud/ces/v1/file_search_tool_pb'
+require 'google/cloud/ces/v1/google_search_tool_pb'
+require 'google/cloud/ces/v1/mcp_tool_pb'
+require 'google/cloud/ces/v1/open_api_tool_pb'
+require 'google/cloud/ces/v1/python_function_pb'
+require 'google/cloud/ces/v1/system_tool_pb'
+require 'google/cloud/ces/v1/widget_tool_pb'
+require 'google/protobuf/timestamp_pb'
+
+
+descriptor_data = "\n\x1egoogle/cloud/ces/v1/tool.proto\x12\x13google.cloud.ces.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a$google/cloud/ces/v1/agent_tool.proto\x1a)google/cloud/ces/v1/client_function.proto\x1a google/cloud/ces/v1/common.proto\x1a(google/cloud/ces/v1/connector_tool.proto\x1a)google/cloud/ces/v1/data_store_tool.proto\x1a\x1fgoogle/cloud/ces/v1/fakes.proto\x1a*google/cloud/ces/v1/file_search_tool.proto\x1a,google/cloud/ces/v1/google_search_tool.proto\x1a\"google/cloud/ces/v1/mcp_tool.proto\x1a\'google/cloud/ces/v1/open_api_tool.proto\x1a)google/cloud/ces/v1/python_function.proto\x1a%google/cloud/ces/v1/system_tool.proto\x1a%google/cloud/ces/v1/widget_tool.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x99\t\n\x04Tool\x12\x43\n\x0f\x63lient_function\x18\x02 \x01(\x0b\x32#.google.cloud.ces.v1.ClientFunctionB\x03\xe0\x41\x01H\x00\x12>\n\ropen_api_tool\x18\x03 \x01(\x0b\x32 .google.cloud.ces.v1.OpenApiToolB\x03\xe0\x41\x01H\x00\x12H\n\x12google_search_tool\x18\x05 \x01(\x0b\x32%.google.cloud.ces.v1.GoogleSearchToolB\x03\xe0\x41\x01H\x00\x12\x41\n\x0e\x63onnector_tool\x18\x08 \x01(\x0b\x32\".google.cloud.ces.v1.ConnectorToolB\x03\xe0\x41\x01H\x00\x12\x42\n\x0f\x64\x61ta_store_tool\x18\n \x01(\x0b\x32\".google.cloud.ces.v1.DataStoreToolB\x03\xe0\x41\x01H\x00\x12\x43\n\x0fpython_function\x18\x0b \x01(\x0b\x32#.google.cloud.ces.v1.PythonFunctionB\x03\xe0\x41\x01H\x00\x12\x35\n\x08mcp_tool\x18\x10 \x01(\x0b\x32\x1c.google.cloud.ces.v1.McpToolB\x03\xe0\x41\x01H\x00\x12\x44\n\x10\x66ile_search_tool\x18\x11 \x01(\x0b\x32#.google.cloud.ces.v1.FileSearchToolB\x03\xe0\x41\x01H\x00\x12;\n\x0bsystem_tool\x18\x12 \x01(\x0b\x32\x1f.google.cloud.ces.v1.SystemToolB\x03\xe0\x41\x01H\x00\x12\x39\n\nagent_tool\x18\x17 \x01(\x0b\x32\x1e.google.cloud.ces.v1.AgentToolB\x03\xe0\x41\x01H\x00\x12;\n\x0bwidget_tool\x18\x18 \x01(\x0b\x32\x1f.google.cloud.ces.v1.WidgetToolB\x03\xe0\x41\x01H\x00\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x08\x12\x19\n\x0c\x64isplay_name\x18\r \x01(\tB\x03\xe0\x41\x03\x12?\n\x0e\x65xecution_type\x18\x0c \x01(\x0e\x32\".google.cloud.ces.v1.ExecutionTypeB\x03\xe0\x41\x01\x12\x34\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x34\n\x0bupdate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x0c\n\x04\x65tag\x18\x0e \x01(\t\x12\x1e\n\x11generated_summary\x18\x0f \x01(\tB\x03\xe0\x41\x03\x12\x42\n\x10tool_fake_config\x18\x14 \x01(\x0b\x32#.google.cloud.ces.v1.ToolFakeConfigB\x03\xe0\x41\x01:j\xea\x41g\n\x17\x63\x65s.googleapis.com/Tool\x12?projects/{project}/locations/{location}/apps/{app}/tools/{tool}*\x05tools2\x04toolB\x0b\n\ttool_typeBQ\n\x17\x63om.google.cloud.ces.v1B\tToolProtoP\x01Z)cloud.google.com/go/ces/apiv1/cespb;cespbb\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Google
+  module Cloud
+    module Ces
+      module V1
+        Tool = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.Tool").msgclass
+      end
+    end
+  end
+end