google-cloud-ces-v1beta 0.a → 0.2.0

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

@@ -0,0 +1,324 @@
+# 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
+        # Guardrail contains a list of checks and balances to keep the agents safe and
+        # secure.
+        # @!attribute [rw] content_filter
+        #   @return [::Google::Cloud::Ces::V1beta::Guardrail::ContentFilter]
+        #     Optional. Guardrail that bans certain content from being used in the
+        #     conversation.
+        #
+        #     Note: The following fields are mutually exclusive: `content_filter`, `llm_prompt_security`, `llm_policy`, `model_safety`, `code_callback`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] llm_prompt_security
+        #   @return [::Google::Cloud::Ces::V1beta::Guardrail::LlmPromptSecurity]
+        #     Optional. Guardrail that blocks the conversation if the prompt is
+        #     considered unsafe based on the LLM classification.
+        #
+        #     Note: The following fields are mutually exclusive: `llm_prompt_security`, `content_filter`, `llm_policy`, `model_safety`, `code_callback`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] llm_policy
+        #   @return [::Google::Cloud::Ces::V1beta::Guardrail::LlmPolicy]
+        #     Optional. Guardrail that blocks the conversation if the LLM response is
+        #     considered violating the policy based on the LLM classification.
+        #
+        #     Note: The following fields are mutually exclusive: `llm_policy`, `content_filter`, `llm_prompt_security`, `model_safety`, `code_callback`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] model_safety
+        #   @return [::Google::Cloud::Ces::V1beta::Guardrail::ModelSafety]
+        #     Optional. Guardrail that blocks the conversation if the LLM response is
+        #     considered unsafe based on the model safety settings.
+        #
+        #     Note: The following fields are mutually exclusive: `model_safety`, `content_filter`, `llm_prompt_security`, `llm_policy`, `code_callback`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] code_callback
+        #   @return [::Google::Cloud::Ces::V1beta::Guardrail::CodeCallback]
+        #     Optional. Guardrail that potentially blocks the conversation based on the
+        #     result of the callback execution.
+        #
+        #     Note: The following fields are mutually exclusive: `code_callback`, `content_filter`, `llm_prompt_security`, `llm_policy`, `model_safety`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. The unique identifier of the guardrail.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}`
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. Display name of the guardrail.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Description of the guardrail.
+        # @!attribute [rw] enabled
+        #   @return [::Boolean]
+        #     Optional. Whether the guardrail is enabled.
+        # @!attribute [rw] action
+        #   @return [::Google::Cloud::Ces::V1beta::TriggerAction]
+        #     Optional. Action to take when the guardrail is triggered.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Timestamp when the guardrail was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Timestamp when the guardrail was last updated.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Etag used to ensure the object hasn't changed during a read-modify-write
+        #     operation. If the etag is empty, the update will overwrite any concurrent
+        #     changes.
+        class Guardrail
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Guardrail that bans certain content from being used in the conversation.
+          # @!attribute [rw] banned_contents
+          #   @return [::Array<::String>]
+          #     Optional. List of banned phrases. Applies to both user inputs and agent
+          #     responses.
+          # @!attribute [rw] banned_contents_in_user_input
+          #   @return [::Array<::String>]
+          #     Optional. List of banned phrases. Applies only to user inputs.
+          # @!attribute [rw] banned_contents_in_agent_response
+          #   @return [::Array<::String>]
+          #     Optional. List of banned phrases. Applies only to agent responses.
+          # @!attribute [rw] match_type
+          #   @return [::Google::Cloud::Ces::V1beta::Guardrail::ContentFilter::MatchType]
+          #     Required. Match type for the content filter.
+          # @!attribute [rw] disregard_diacritics
+          #   @return [::Boolean]
+          #     Optional. If true, diacritics are ignored during matching.
+          class ContentFilter
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Match type for the content filter.
+            module MatchType
+              # Match type is not specified.
+              MATCH_TYPE_UNSPECIFIED = 0
+
+              # Content is matched for substrings character by character.
+              SIMPLE_STRING_MATCH = 1
+
+              # Content only matches if the pattern found in the text is
+              # surrounded by word delimiters. Banned phrases can also contain word
+              # delimiters.
+              WORD_BOUNDARY_STRING_MATCH = 2
+
+              # Content is matched using regular expression syntax.
+              REGEXP_MATCH = 3
+            end
+          end
+
+          # Guardrail that blocks the conversation if the input is considered unsafe
+          # based on the LLM classification.
+          # @!attribute [rw] default_settings
+          #   @return [::Google::Cloud::Ces::V1beta::Guardrail::LlmPromptSecurity::DefaultSecuritySettings]
+          #     Optional. Use the system's predefined default security settings.
+          #     To select this mode, include an empty 'default_settings' message
+          #     in the request. The 'default_prompt_template' field within
+          #     will be populated by the server in the response.
+          #
+          #     Note: The following fields are mutually exclusive: `default_settings`, `custom_policy`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] custom_policy
+          #   @return [::Google::Cloud::Ces::V1beta::Guardrail::LlmPolicy]
+          #     Optional. Use a user-defined LlmPolicy to configure the security
+          #     guardrail.
+          #
+          #     Note: The following fields are mutually exclusive: `custom_policy`, `default_settings`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] fail_open
+          #   @return [::Boolean]
+          #     Optional. Determines the behavior when the guardrail encounters an LLM
+          #     error.
+          #     - If true: the guardrail is bypassed.
+          #     - If false (default): the guardrail triggers/blocks.
+          #
+          #     Note: If a custom policy is provided, this field is ignored in favor
+          #     of the policy's 'fail_open' configuration.
+          class LlmPromptSecurity
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Configuration for default system security settings.
+            # @!attribute [r] default_prompt_template
+            #   @return [::String]
+            #     Output only. The default prompt template used by the system.
+            #     This field is for display purposes to show the user what prompt
+            #     the system uses by default. It is OUTPUT_ONLY.
+            class DefaultSecuritySettings
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Guardrail that blocks the conversation if the LLM response is considered
+          # violating the policy based on the LLM classification.
+          # @!attribute [rw] max_conversation_messages
+          #   @return [::Integer]
+          #     Optional. When checking this policy, consider the last 'n' messages in
+          #     the conversation. When not set a default value of 10 will be used.
+          # @!attribute [rw] model_settings
+          #   @return [::Google::Cloud::Ces::V1beta::ModelSettings]
+          #     Optional. Model settings.
+          # @!attribute [rw] prompt
+          #   @return [::String]
+          #     Required. Policy prompt.
+          # @!attribute [rw] policy_scope
+          #   @return [::Google::Cloud::Ces::V1beta::Guardrail::LlmPolicy::PolicyScope]
+          #     Required. Defines when to apply the policy check during the conversation.
+          #     If set to `POLICY_SCOPE_UNSPECIFIED`, the policy will be applied to the
+          #     user input. When applying the policy to the agent response, additional
+          #     latency will be introduced before the agent can respond.
+          # @!attribute [rw] fail_open
+          #   @return [::Boolean]
+          #     Optional. If an error occurs during the policy check, fail open and do
+          #     not trigger the guardrail.
+          # @!attribute [rw] allow_short_utterance
+          #   @return [::Boolean]
+          #     Optional. By default, the LLM policy check is bypassed for short
+          #     utterances. Enabling this setting applies the policy check to all
+          #     utterances, including those that would normally be skipped.
+          class LlmPolicy
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Defines when to apply the policy check during the conversation.
+            module PolicyScope
+              # Policy scope is not specified.
+              POLICY_SCOPE_UNSPECIFIED = 0
+
+              # Policy check is triggered on user input.
+              USER_QUERY = 1
+
+              # Policy check is triggered on agent response. Applying this policy
+              # scope will introduce additional latency before the agent can respond.
+              AGENT_RESPONSE = 2
+
+              # Policy check is triggered on both user input and agent response.
+              # Applying this policy scope will introduce additional latency before
+              # the agent can respond.
+              USER_QUERY_AND_AGENT_RESPONSE = 3
+            end
+          end
+
+          # Model safety settings overrides. When this is set, it will override the
+          # default settings and trigger the guardrail if the response is considered
+          # unsafe.
+          # @!attribute [rw] safety_settings
+          #   @return [::Array<::Google::Cloud::Ces::V1beta::Guardrail::ModelSafety::SafetySetting>]
+          #     Required. List of safety settings.
+          class ModelSafety
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Safety setting.
+            # @!attribute [rw] category
+            #   @return [::Google::Cloud::Ces::V1beta::Guardrail::ModelSafety::HarmCategory]
+            #     Required. The harm category.
+            # @!attribute [rw] threshold
+            #   @return [::Google::Cloud::Ces::V1beta::Guardrail::ModelSafety::HarmBlockThreshold]
+            #     Required. The harm block threshold.
+            class SafetySetting
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Harm category.
+            module HarmCategory
+              # The harm category is unspecified.
+              HARM_CATEGORY_UNSPECIFIED = 0
+
+              # The harm category is hate speech.
+              HARM_CATEGORY_HATE_SPEECH = 1
+
+              # The harm category is dangerous content.
+              HARM_CATEGORY_DANGEROUS_CONTENT = 2
+
+              # The harm category is harassment.
+              HARM_CATEGORY_HARASSMENT = 3
+
+              # The harm category is sexually explicit content.
+              HARM_CATEGORY_SEXUALLY_EXPLICIT = 4
+            end
+
+            # Probability based thresholds levels for blocking.
+            module HarmBlockThreshold
+              # Unspecified harm block threshold.
+              HARM_BLOCK_THRESHOLD_UNSPECIFIED = 0
+
+              # Block low threshold and above (i.e. block more).
+              BLOCK_LOW_AND_ABOVE = 1
+
+              # Block medium threshold and above.
+              BLOCK_MEDIUM_AND_ABOVE = 2
+
+              # Block only high threshold (i.e. block less).
+              BLOCK_ONLY_HIGH = 3
+
+              # Block none.
+              BLOCK_NONE = 4
+
+              # Turn off the safety filter.
+              OFF = 5
+            end
+          end
+
+          # Guardrail that blocks the conversation based on the code callbacks
+          # provided.
+          # @!attribute [rw] before_agent_callback
+          #   @return [::Google::Cloud::Ces::V1beta::Callback]
+          #     Optional. The callback to execute before the agent is called.
+          #     Each callback function is expected to return a structure (e.g., a dict or
+          #     object) containing at least:
+          #       - 'decision': Either 'OK' or 'TRIGGER'.
+          #       - 'reason': A string explaining the decision.
+          #     A 'TRIGGER' decision may halt further processing.
+          # @!attribute [rw] after_agent_callback
+          #   @return [::Google::Cloud::Ces::V1beta::Callback]
+          #     Optional. The callback to execute after the agent is called.
+          #     Each callback function is expected to return a structure (e.g., a dict or
+          #     object) containing at least:
+          #       - 'decision': Either 'OK' or 'TRIGGER'.
+          #       - 'reason': A string explaining the decision.
+          #     A 'TRIGGER' decision may halt further processing.
+          # @!attribute [rw] before_model_callback
+          #   @return [::Google::Cloud::Ces::V1beta::Callback]
+          #     Optional. The callback to execute before the model is called. If there
+          #     are multiple calls to the model, the callback will be executed multiple
+          #     times. Each callback function is expected to return a structure (e.g., a
+          #     dict or object) containing at least:
+          #       - 'decision': Either 'OK' or 'TRIGGER'.
+          #       - 'reason': A string explaining the decision.
+          #     A 'TRIGGER' decision may halt further processing.
+          # @!attribute [rw] after_model_callback
+          #   @return [::Google::Cloud::Ces::V1beta::Callback]
+          #     Optional. The callback to execute after the model is called. If there are
+          #     multiple calls to the model, the callback will be executed multiple
+          #     times. Each callback function is expected to return a structure (e.g., a
+          #     dict or object) containing at least:
+          #       - 'decision': Either 'OK' or 'TRIGGER'.
+          #       - 'reason': A string explaining the decision.
+          #     A 'TRIGGER' decision may halt further processing.
+          class CodeCallback
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,110 @@
+# 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
+        # An MCP tool.
+        # See https://modelcontextprotocol.io/specification/2025-06-18/server/tools for
+        # more details.
+        # @!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.
+        # @!attribute [rw] input_schema
+        #   @return [::Google::Cloud::Ces::V1beta::Schema]
+        #     Optional. The schema of the input arguments of the MCP tool.
+        # @!attribute [rw] output_schema
+        #   @return [::Google::Cloud::Ces::V1beta::Schema]
+        #     Optional. The schema of the output arguments of the MCP tool.
+        # @!attribute [rw] server_address
+        #   @return [::String]
+        #     Required. The server address of the MCP server, e.g.,
+        #     "https://example.com/mcp/". If the server is built with the MCP SDK, the
+        #     url should be suffixed with
+        #     "/mcp/". Only Streamable HTTP transport based servers are supported. This
+        #     is the same as the server_address in the McpToolset. See
+        #     https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http
+        #     for more details.
+        # @!attribute [rw] api_authentication
+        #   @return [::Google::Cloud::Ces::V1beta::ApiAuthentication]
+        #     Optional. Authentication information required to execute the tool against
+        #     the MCP server. For bearer token authentication, the token applies only to
+        #     tool execution, not to listing tools. This requires that tools can be
+        #     listed without authentication.
+        # @!attribute [rw] tls_config
+        #   @return [::Google::Cloud::Ces::V1beta::TlsConfig]
+        #     Optional. The TLS configuration. Includes the custom server certificates
+        #     that the client should trust.
+        # @!attribute [rw] service_directory_config
+        #   @return [::Google::Cloud::Ces::V1beta::ServiceDirectoryConfig]
+        #     Optional. Service Directory configuration for VPC-SC, used to resolve
+        #     service names within a perimeter.
+        # @!attribute [rw] custom_headers
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. The custom headers to send in the request to the MCP server. The
+        #     values must be in the format `$context.variables.<name_of_variable>` and
+        #     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::V1beta::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
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class CustomHeadersEntry
+            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
+  end
+end

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

@@ -0,0 +1,118 @@
+# 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
+        # A toolset that contains a list of tools that are offered by the MCP
+        # server.
+        # @!attribute [rw] server_address
+        #   @return [::String]
+        #     Required. The address of the MCP server, for example,
+        #     "https://example.com/mcp/". If the server is built with the MCP SDK, the
+        #     url should be suffixed with
+        #     "/mcp/". Only Streamable HTTP transport based servers are supported. See
+        #     https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http
+        #     for more details.
+        # @!attribute [rw] api_authentication
+        #   @return [::Google::Cloud::Ces::V1beta::ApiAuthentication]
+        #     Optional. Authentication information required to access tools and execute a
+        #     tool against the MCP server. For bearer token authentication, the token
+        #     applies only to tool execution, not to listing tools. This requires that
+        #     tools can be listed without authentication.
+        # @!attribute [rw] service_directory_config
+        #   @return [::Google::Cloud::Ces::V1beta::ServiceDirectoryConfig]
+        #     Optional. Service Directory configuration for VPC-SC, used to resolve
+        #     service names within a perimeter.
+        # @!attribute [rw] tls_config
+        #   @return [::Google::Cloud::Ces::V1beta::TlsConfig]
+        #     Optional. The TLS configuration. Includes the custom server certificates
+        #     that the client should trust.
+        # @!attribute [rw] custom_headers
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. The custom headers to send in the request to the MCP server. The
+        #     values must be in the format `$context.variables.<name_of_variable>` and
+        #     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::V1beta::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
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class CustomHeadersEntry
+            include ::Google::Protobuf::MessageExts
+            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::V1beta::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::V1beta::Schema]
+        #     Output only. The schema of the input arguments of the MCP tool.
+        # @!attribute [r] output_schema
+        #   @return [::Google::Cloud::Ces::V1beta::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
+end

data/proto_docs/google/cloud/ces/v1beta/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 V1beta
+        # 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::V1beta::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