google-cloud-ces-v1 1.5.0

// 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.
//
// Code generated by sidekick. DO NOT EDIT.

#![allow(rustdoc::bare_urls)]
#![allow(rustdoc::broken_intra_doc_links)]
#![allow(rustdoc::invalid_html_tags)]
#![allow(rustdoc::redundant_explicit_links)]
#![no_implicit_prelude]
extern crate async_trait;
extern crate bytes;
extern crate gaxi;
extern crate google_cloud_gax;
extern crate google_cloud_location;
extern crate google_cloud_longrunning;
extern crate google_cloud_lro;
extern crate serde;
extern crate serde_json;
extern crate serde_with;
extern crate std;
extern crate tracing;
extern crate wkt;

mod debug;
mod deserialize;
mod serialize;

/// An agent acts as the fundamental building block that provides instructions to
/// the Large Language Model (LLM) for executing specific tasks.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Agent {
    /// Identifier. The unique identifier of the agent.
    /// Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
    pub name: std::string::String,

    /// Required. Display name of the agent.
    pub display_name: std::string::String,

    /// Optional. Human-readable description of the agent.
    pub description: std::string::String,

    /// Optional. Configurations for the LLM model.
    pub model_settings: std::option::Option<crate::model::ModelSettings>,

    /// Optional. Instructions for the LLM model to guide the agent's behavior.
    pub instruction: std::string::String,

    /// Optional. List of available tools for the agent.
    /// Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
    pub tools: std::vec::Vec<std::string::String>,

    /// Optional. List of child agents in the agent tree.
    /// Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
    pub child_agents: std::vec::Vec<std::string::String>,

    /// Optional. The callbacks to execute before the agent is called.
    /// The provided callbacks are executed sequentially in the exact order they
    /// are given in the list. If a callback returns an overridden response,
    /// execution stops and any remaining callbacks are skipped.
    pub before_agent_callbacks: std::vec::Vec<crate::model::Callback>,

    /// Optional. The callbacks to execute after the agent is called.
    /// The provided callbacks are executed sequentially in the exact order they
    /// are given in the list. If a callback returns an overridden response,
    /// execution stops and any remaining callbacks are skipped.
    pub after_agent_callbacks: std::vec::Vec<crate::model::Callback>,

    /// Optional. The callbacks to execute before the model is called. If there are
    /// multiple calls to the model, the callback will be executed multiple times.
    /// The provided callbacks are executed sequentially in the exact order they
    /// are given in the list. If a callback returns an overridden response,
    /// execution stops and any remaining callbacks are skipped.
    pub before_model_callbacks: std::vec::Vec<crate::model::Callback>,

    /// Optional. The callbacks to execute after the model is called. If there are
    /// multiple calls to the model, the callback will be executed multiple times.
    /// The provided callbacks are executed sequentially in the exact order they
    /// are given in the list. If a callback returns an overridden response,
    /// execution stops and any remaining callbacks are skipped.
    pub after_model_callbacks: std::vec::Vec<crate::model::Callback>,

    /// Optional. The callbacks to execute before the tool is invoked. If there are
    /// multiple tool invocations, the callback will be executed multiple times.
    /// The provided callbacks are executed sequentially in the exact order they
    /// are given in the list. If a callback returns an overridden response,
    /// execution stops and any remaining callbacks are skipped.
    pub before_tool_callbacks: std::vec::Vec<crate::model::Callback>,

    /// Optional. The callbacks to execute after the tool is invoked. If there are
    /// multiple tool invocations, the callback will be executed multiple times.
    /// The provided callbacks are executed sequentially in the exact order they
    /// are given in the list. If a callback returns an overridden response,
    /// execution stops and any remaining callbacks are skipped.
    pub after_tool_callbacks: std::vec::Vec<crate::model::Callback>,

    /// Output only. Timestamp when the agent was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Timestamp when the agent was last updated.
    pub update_time: std::option::Option<wkt::Timestamp>,

    /// Optional. List of guardrails for the agent.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}`
    pub guardrails: std::vec::Vec<std::string::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.
    pub etag: std::string::String,

    /// Optional. List of toolsets for the agent.
    pub toolsets: std::vec::Vec<crate::model::agent::AgentToolset>,

    /// Output only. If the agent is generated by the LLM assistant, this field
    /// contains a descriptive summary of the generation.
    pub generated_summary: std::string::String,

    /// Optional. Agent transfer rules.
    /// If multiple rules match, the first one in the list will be used.
    pub transfer_rules: std::vec::Vec<crate::model::TransferRule>,

    /// Output only. Misconfigurations or errors in the agent that may affect agent
    /// quality.
    pub validation_errors: std::vec::Vec<std::string::String>,

    /// The type of agent.
    pub agent_type: std::option::Option<crate::model::agent::AgentType>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Agent {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Agent::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = Agent::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::Agent::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// let x = Agent::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::Agent::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// let x = Agent::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [model_settings][crate::model::Agent::model_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::ModelSettings;
    /// let x = Agent::new().set_model_settings(ModelSettings::default()/* use setters */);
    /// ```
    pub fn set_model_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ModelSettings>,
    {
        self.model_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [model_settings][crate::model::Agent::model_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::ModelSettings;
    /// let x = Agent::new().set_or_clear_model_settings(Some(ModelSettings::default()/* use setters */));
    /// let x = Agent::new().set_or_clear_model_settings(None::<ModelSettings>);
    /// ```
    pub fn set_or_clear_model_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ModelSettings>,
    {
        self.model_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [instruction][crate::model::Agent::instruction].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// let x = Agent::new().set_instruction("example");
    /// ```
    pub fn set_instruction<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.instruction = v.into();
        self
    }

    /// Sets the value of [tools][crate::model::Agent::tools].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// let x = Agent::new().set_tools(["a", "b", "c"]);
    /// ```
    pub fn set_tools<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.tools = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [child_agents][crate::model::Agent::child_agents].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// let x = Agent::new().set_child_agents(["a", "b", "c"]);
    /// ```
    pub fn set_child_agents<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.child_agents = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [before_agent_callbacks][crate::model::Agent::before_agent_callbacks].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::Callback;
    /// let x = Agent::new()
    ///     .set_before_agent_callbacks([
    ///         Callback::default()/* use setters */,
    ///         Callback::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_before_agent_callbacks<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Callback>,
    {
        use std::iter::Iterator;
        self.before_agent_callbacks = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [after_agent_callbacks][crate::model::Agent::after_agent_callbacks].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::Callback;
    /// let x = Agent::new()
    ///     .set_after_agent_callbacks([
    ///         Callback::default()/* use setters */,
    ///         Callback::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_after_agent_callbacks<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Callback>,
    {
        use std::iter::Iterator;
        self.after_agent_callbacks = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [before_model_callbacks][crate::model::Agent::before_model_callbacks].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::Callback;
    /// let x = Agent::new()
    ///     .set_before_model_callbacks([
    ///         Callback::default()/* use setters */,
    ///         Callback::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_before_model_callbacks<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Callback>,
    {
        use std::iter::Iterator;
        self.before_model_callbacks = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [after_model_callbacks][crate::model::Agent::after_model_callbacks].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::Callback;
    /// let x = Agent::new()
    ///     .set_after_model_callbacks([
    ///         Callback::default()/* use setters */,
    ///         Callback::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_after_model_callbacks<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Callback>,
    {
        use std::iter::Iterator;
        self.after_model_callbacks = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [before_tool_callbacks][crate::model::Agent::before_tool_callbacks].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::Callback;
    /// let x = Agent::new()
    ///     .set_before_tool_callbacks([
    ///         Callback::default()/* use setters */,
    ///         Callback::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_before_tool_callbacks<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Callback>,
    {
        use std::iter::Iterator;
        self.before_tool_callbacks = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [after_tool_callbacks][crate::model::Agent::after_tool_callbacks].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::Callback;
    /// let x = Agent::new()
    ///     .set_after_tool_callbacks([
    ///         Callback::default()/* use setters */,
    ///         Callback::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_after_tool_callbacks<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Callback>,
    {
        use std::iter::Iterator;
        self.after_tool_callbacks = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [create_time][crate::model::Agent::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use wkt::Timestamp;
    /// let x = Agent::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::Agent::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use wkt::Timestamp;
    /// let x = Agent::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = Agent::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::Agent::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use wkt::Timestamp;
    /// let x = Agent::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::Agent::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use wkt::Timestamp;
    /// let x = Agent::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = Agent::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [guardrails][crate::model::Agent::guardrails].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// let x = Agent::new().set_guardrails(["a", "b", "c"]);
    /// ```
    pub fn set_guardrails<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.guardrails = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [etag][crate::model::Agent::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// let x = Agent::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }

    /// Sets the value of [toolsets][crate::model::Agent::toolsets].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::agent::AgentToolset;
    /// let x = Agent::new()
    ///     .set_toolsets([
    ///         AgentToolset::default()/* use setters */,
    ///         AgentToolset::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_toolsets<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::agent::AgentToolset>,
    {
        use std::iter::Iterator;
        self.toolsets = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [generated_summary][crate::model::Agent::generated_summary].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// let x = Agent::new().set_generated_summary("example");
    /// ```
    pub fn set_generated_summary<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.generated_summary = v.into();
        self
    }

    /// Sets the value of [transfer_rules][crate::model::Agent::transfer_rules].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::TransferRule;
    /// let x = Agent::new()
    ///     .set_transfer_rules([
    ///         TransferRule::default()/* use setters */,
    ///         TransferRule::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_transfer_rules<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::TransferRule>,
    {
        use std::iter::Iterator;
        self.transfer_rules = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [validation_errors][crate::model::Agent::validation_errors].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// let x = Agent::new().set_validation_errors(["a", "b", "c"]);
    /// ```
    pub fn set_validation_errors<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.validation_errors = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [agent_type][crate::model::Agent::agent_type].
    ///
    /// Note that all the setters affecting `agent_type` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::agent::LlmAgent;
    /// let x = Agent::new().set_agent_type(Some(
    ///     google_cloud_ces_v1::model::agent::AgentType::LlmAgent(LlmAgent::default().into())));
    /// ```
    pub fn set_agent_type<
        T: std::convert::Into<std::option::Option<crate::model::agent::AgentType>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.agent_type = v.into();
        self
    }

    /// The value of [agent_type][crate::model::Agent::agent_type]
    /// if it holds a `LlmAgent`, `None` if the field is not set or
    /// holds a different branch.
    pub fn llm_agent(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::agent::LlmAgent>> {
        #[allow(unreachable_patterns)]
        self.agent_type.as_ref().and_then(|v| match v {
            crate::model::agent::AgentType::LlmAgent(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [agent_type][crate::model::Agent::agent_type]
    /// to hold a `LlmAgent`.
    ///
    /// Note that all the setters affecting `agent_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::agent::LlmAgent;
    /// let x = Agent::new().set_llm_agent(LlmAgent::default()/* use setters */);
    /// assert!(x.llm_agent().is_some());
    /// assert!(x.remote_dialogflow_agent().is_none());
    /// ```
    pub fn set_llm_agent<T: std::convert::Into<std::boxed::Box<crate::model::agent::LlmAgent>>>(
        mut self,
        v: T,
    ) -> Self {
        self.agent_type =
            std::option::Option::Some(crate::model::agent::AgentType::LlmAgent(v.into()));
        self
    }

    /// The value of [agent_type][crate::model::Agent::agent_type]
    /// if it holds a `RemoteDialogflowAgent`, `None` if the field is not set or
    /// holds a different branch.
    pub fn remote_dialogflow_agent(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::agent::RemoteDialogflowAgent>> {
        #[allow(unreachable_patterns)]
        self.agent_type.as_ref().and_then(|v| match v {
            crate::model::agent::AgentType::RemoteDialogflowAgent(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [agent_type][crate::model::Agent::agent_type]
    /// to hold a `RemoteDialogflowAgent`.
    ///
    /// Note that all the setters affecting `agent_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Agent;
    /// use google_cloud_ces_v1::model::agent::RemoteDialogflowAgent;
    /// let x = Agent::new().set_remote_dialogflow_agent(RemoteDialogflowAgent::default()/* use setters */);
    /// assert!(x.remote_dialogflow_agent().is_some());
    /// assert!(x.llm_agent().is_none());
    /// ```
    pub fn set_remote_dialogflow_agent<
        T: std::convert::Into<std::boxed::Box<crate::model::agent::RemoteDialogflowAgent>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.agent_type = std::option::Option::Some(
            crate::model::agent::AgentType::RemoteDialogflowAgent(v.into()),
        );
        self
    }
}

impl wkt::message::Message for Agent {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Agent"
    }
}

/// Defines additional types related to [Agent].
pub mod agent {
    #[allow(unused_imports)]
    use super::*;

    /// Default agent type. The agent uses instructions and callbacks specified in
    /// the agent to perform the task using a large language model.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct LlmAgent {
        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl LlmAgent {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }
    }

    impl wkt::message::Message for LlmAgent {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Agent.LlmAgent"
        }
    }

    /// The agent which will transfer execution to a remote
    /// [Dialogflow
    /// CX](https://docs.cloud.google.com/dialogflow/cx/docs/concept/agent) agent.
    /// The Dialogflow agent will process subsequent user queries until the session
    /// ends or flow ends, and the control is transferred back to the parent CES
    /// agent.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct RemoteDialogflowAgent {
        /// Required. The
        /// [Dialogflow](https://docs.cloud.google.com/dialogflow/cx/docs/concept/agent)
        /// agent resource name.
        /// Format: `projects/{project}/locations/{location}/agents/{agent}`
        pub agent: std::string::String,

        /// Optional. The flow ID of the flow in the Dialogflow agent.
        pub flow_id: std::string::String,

        /// Optional. The environment ID of the Dialogflow agent to be used for the
        /// agent execution. If not specified, the draft environment will be used.
        pub environment_id: std::string::String,

        /// Optional. The mapping of the app variables names to the Dialogflow
        /// session parameters names to be sent to the Dialogflow agent as input.
        pub input_variable_mapping:
            std::collections::HashMap<std::string::String, std::string::String>,

        /// Optional. The mapping of the Dialogflow session parameters names to the
        /// app variables names to be sent back to the CES agent after the Dialogflow
        /// agent execution ends.
        pub output_variable_mapping:
            std::collections::HashMap<std::string::String, std::string::String>,

        /// Optional. Indicates whether to respect the message-level interruption
        /// settings configured in the Dialogflow agent.
        ///
        /// * If false: all response messages from the Dialogflow agent follow the
        ///   app-level barge-in settings.
        /// * If true: only response messages with
        ///   [`allow_playback_interruption`](https://docs.cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#text)
        ///   set to true will be interruptable, all other messages follow the
        ///   app-level barge-in settings.
        pub respect_response_interruption_settings: bool,

        /// Optional. The name of the variable that contains the language code to be
        /// used for the Dialogflow session. If unspecified, the default language
        /// code of the Dialogflow agent will be used.
        pub language_code_variable: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl RemoteDialogflowAgent {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [agent][crate::model::agent::RemoteDialogflowAgent::agent].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::agent::RemoteDialogflowAgent;
        /// let x = RemoteDialogflowAgent::new().set_agent("example");
        /// ```
        pub fn set_agent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.agent = v.into();
            self
        }

        /// Sets the value of [flow_id][crate::model::agent::RemoteDialogflowAgent::flow_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::agent::RemoteDialogflowAgent;
        /// let x = RemoteDialogflowAgent::new().set_flow_id("example");
        /// ```
        pub fn set_flow_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.flow_id = v.into();
            self
        }

        /// Sets the value of [environment_id][crate::model::agent::RemoteDialogflowAgent::environment_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::agent::RemoteDialogflowAgent;
        /// let x = RemoteDialogflowAgent::new().set_environment_id("example");
        /// ```
        pub fn set_environment_id<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.environment_id = v.into();
            self
        }

        /// Sets the value of [input_variable_mapping][crate::model::agent::RemoteDialogflowAgent::input_variable_mapping].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::agent::RemoteDialogflowAgent;
        /// let x = RemoteDialogflowAgent::new().set_input_variable_mapping([
        ///     ("key0", "abc"),
        ///     ("key1", "xyz"),
        /// ]);
        /// ```
        pub fn set_input_variable_mapping<T, K, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = (K, V)>,
            K: std::convert::Into<std::string::String>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.input_variable_mapping =
                v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
            self
        }

        /// Sets the value of [output_variable_mapping][crate::model::agent::RemoteDialogflowAgent::output_variable_mapping].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::agent::RemoteDialogflowAgent;
        /// let x = RemoteDialogflowAgent::new().set_output_variable_mapping([
        ///     ("key0", "abc"),
        ///     ("key1", "xyz"),
        /// ]);
        /// ```
        pub fn set_output_variable_mapping<T, K, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = (K, V)>,
            K: std::convert::Into<std::string::String>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.output_variable_mapping =
                v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
            self
        }

        /// Sets the value of [respect_response_interruption_settings][crate::model::agent::RemoteDialogflowAgent::respect_response_interruption_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::agent::RemoteDialogflowAgent;
        /// let x = RemoteDialogflowAgent::new().set_respect_response_interruption_settings(true);
        /// ```
        pub fn set_respect_response_interruption_settings<T: std::convert::Into<bool>>(
            mut self,
            v: T,
        ) -> Self {
            self.respect_response_interruption_settings = v.into();
            self
        }

        /// Sets the value of [language_code_variable][crate::model::agent::RemoteDialogflowAgent::language_code_variable].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::agent::RemoteDialogflowAgent;
        /// let x = RemoteDialogflowAgent::new().set_language_code_variable("example");
        /// ```
        pub fn set_language_code_variable<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.language_code_variable = v.into();
            self
        }
    }

    impl wkt::message::Message for RemoteDialogflowAgent {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Agent.RemoteDialogflowAgent"
        }
    }

    /// A toolset with a selection of its tools.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct AgentToolset {
        /// Required. The resource name of the toolset.
        /// Format:
        /// `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`
        pub toolset: std::string::String,

        /// Optional. The tools IDs to filter the toolset.
        pub tool_ids: std::vec::Vec<std::string::String>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl AgentToolset {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [toolset][crate::model::agent::AgentToolset::toolset].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::agent::AgentToolset;
        /// # let project_id = "project_id";
        /// # let location_id = "location_id";
        /// # let app_id = "app_id";
        /// # let toolset_id = "toolset_id";
        /// let x = AgentToolset::new().set_toolset(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/toolsets/{toolset_id}"));
        /// ```
        pub fn set_toolset<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.toolset = v.into();
            self
        }

        /// Sets the value of [tool_ids][crate::model::agent::AgentToolset::tool_ids].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::agent::AgentToolset;
        /// let x = AgentToolset::new().set_tool_ids(["a", "b", "c"]);
        /// ```
        pub fn set_tool_ids<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.tool_ids = v.into_iter().map(|i| i.into()).collect();
            self
        }
    }

    impl wkt::message::Message for AgentToolset {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Agent.AgentToolset"
        }
    }

    /// The type of agent.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum AgentType {
        /// Optional. The default agent type.
        LlmAgent(std::boxed::Box<crate::model::agent::LlmAgent>),
        /// Optional. The remote
        /// [Dialogflow](https://cloud.google.com/dialogflow/cx/docs/concept/console-conversational-agents)
        /// agent to be used for the agent execution. If this field is set, all other
        /// agent level properties will be ignored.
        ///
        /// Note: If the Dialogflow agent is in a different project from the app, you
        /// should grant `roles/dialogflow.client` to the CES service agent
        /// `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com`.
        RemoteDialogflowAgent(std::boxed::Box<crate::model::agent::RemoteDialogflowAgent>),
    }
}

/// AgentCard conveys key information about a remote agent.
/// It is a trimmed version of the AgentCard defined in the A2A protocol
/// <https://a2a-protocol.org/dev/specification/#441-agentcard>
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AgentCard {
    /// Required. A human-readable name for the agent.
    pub name: std::string::String,

    /// Required. A description of the agent's domain of action/solution space.
    pub description: std::string::String,

    /// Required. Ordered list of supported interfaces. The first entry is
    /// preferred.
    pub supported_interfaces: std::vec::Vec<crate::model::AgentInterface>,

    /// Required. The version of the agent.
    pub version: std::string::String,

    /// Required. Skills represent a unit of ability an agent can perform. This may
    /// somewhat abstract but represents a more focused set of actions that the
    /// agent is highly likely to succeed at.
    pub skills: std::vec::Vec<crate::model::AgentSkill>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AgentCard {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::AgentCard::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentCard;
    /// let x = AgentCard::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::AgentCard::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentCard;
    /// let x = AgentCard::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [supported_interfaces][crate::model::AgentCard::supported_interfaces].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentCard;
    /// use google_cloud_ces_v1::model::AgentInterface;
    /// let x = AgentCard::new()
    ///     .set_supported_interfaces([
    ///         AgentInterface::default()/* use setters */,
    ///         AgentInterface::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_supported_interfaces<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::AgentInterface>,
    {
        use std::iter::Iterator;
        self.supported_interfaces = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [version][crate::model::AgentCard::version].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentCard;
    /// let x = AgentCard::new().set_version("example");
    /// ```
    pub fn set_version<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.version = v.into();
        self
    }

    /// Sets the value of [skills][crate::model::AgentCard::skills].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentCard;
    /// use google_cloud_ces_v1::model::AgentSkill;
    /// let x = AgentCard::new()
    ///     .set_skills([
    ///         AgentSkill::default()/* use setters */,
    ///         AgentSkill::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_skills<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::AgentSkill>,
    {
        use std::iter::Iterator;
        self.skills = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for AgentCard {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AgentCard"
    }
}

/// Declares a combination of a target URL, transport and protocol version for
/// interacting with the agent. This allows agents to expose the same
/// functionality over multiple protocol binding mechanisms.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AgentInterface {
    /// Required. The URL where this interface is available. Must be a valid
    /// absolute HTTPS URL in production. Example:
    /// `https://api.example.com/a2a/v1`, `https://grpc.example.com/a2a`
    pub url: std::string::String,

    /// Required. The protocol binding supported at this URL. This is an open form
    /// string, to be easily extended for other protocol bindings. The core ones
    /// officially supported are `JSONRPC`, `GRPC` and `HTTP+JSON`.
    pub protocol_binding: std::string::String,

    /// Tenant ID to be used in the request when calling the agent.
    pub tenant: std::string::String,

    /// Required. The version of the A2A protocol this interface exposes.
    /// Use the latest supported minor version per major version.
    /// Examples: "0.3", "1.0"
    pub protocol_version: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AgentInterface {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [url][crate::model::AgentInterface::url].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentInterface;
    /// let x = AgentInterface::new().set_url("example");
    /// ```
    pub fn set_url<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.url = v.into();
        self
    }

    /// Sets the value of [protocol_binding][crate::model::AgentInterface::protocol_binding].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentInterface;
    /// let x = AgentInterface::new().set_protocol_binding("example");
    /// ```
    pub fn set_protocol_binding<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.protocol_binding = v.into();
        self
    }

    /// Sets the value of [tenant][crate::model::AgentInterface::tenant].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentInterface;
    /// let x = AgentInterface::new().set_tenant("example");
    /// ```
    pub fn set_tenant<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tenant = v.into();
        self
    }

    /// Sets the value of [protocol_version][crate::model::AgentInterface::protocol_version].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentInterface;
    /// let x = AgentInterface::new().set_protocol_version("example");
    /// ```
    pub fn set_protocol_version<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.protocol_version = v.into();
        self
    }
}

impl wkt::message::Message for AgentInterface {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AgentInterface"
    }
}

/// Represents a distinct capability or function that an agent can perform.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AgentSkill {
    /// Required. A unique identifier for the agent's skill.
    pub id: std::string::String,

    /// Required. A human-readable name for the skill.
    pub name: std::string::String,

    /// Required. A detailed description of the skill.
    pub description: std::string::String,

    /// Required. A set of keywords describing the skill's capabilities.
    pub tags: std::vec::Vec<std::string::String>,

    /// Example prompts or scenarios that this skill can handle.
    pub examples: std::vec::Vec<std::string::String>,

    /// The set of supported input media types for this skill, overriding the
    /// agent's defaults.
    pub input_modes: std::vec::Vec<std::string::String>,

    /// The set of supported output media types for this skill, overriding the
    /// agent's defaults.
    pub output_modes: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AgentSkill {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [id][crate::model::AgentSkill::id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentSkill;
    /// let x = AgentSkill::new().set_id("example");
    /// ```
    pub fn set_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.id = v.into();
        self
    }

    /// Sets the value of [name][crate::model::AgentSkill::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentSkill;
    /// let x = AgentSkill::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::AgentSkill::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentSkill;
    /// let x = AgentSkill::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [tags][crate::model::AgentSkill::tags].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentSkill;
    /// let x = AgentSkill::new().set_tags(["a", "b", "c"]);
    /// ```
    pub fn set_tags<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.tags = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [examples][crate::model::AgentSkill::examples].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentSkill;
    /// let x = AgentSkill::new().set_examples(["a", "b", "c"]);
    /// ```
    pub fn set_examples<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.examples = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [input_modes][crate::model::AgentSkill::input_modes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentSkill;
    /// let x = AgentSkill::new().set_input_modes(["a", "b", "c"]);
    /// ```
    pub fn set_input_modes<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.input_modes = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [output_modes][crate::model::AgentSkill::output_modes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentSkill;
    /// let x = AgentSkill::new().set_output_modes(["a", "b", "c"]);
    /// ```
    pub fn set_output_modes<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.output_modes = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for AgentSkill {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AgentSkill"
    }
}

/// Represents a tool that allows the agent to call another remote agent.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RemoteAgentTool {
    /// Required. The name of the tool.
    pub name: std::string::String,

    /// Required. The description of the tool.
    pub description: std::string::String,

    /// Required. The agent card of the remote agent that this tool invokes.
    pub agent_card: std::option::Option<crate::model::AgentCard>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RemoteAgentTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::RemoteAgentTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RemoteAgentTool;
    /// let x = RemoteAgentTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::RemoteAgentTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RemoteAgentTool;
    /// let x = RemoteAgentTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [agent_card][crate::model::RemoteAgentTool::agent_card].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RemoteAgentTool;
    /// use google_cloud_ces_v1::model::AgentCard;
    /// let x = RemoteAgentTool::new().set_agent_card(AgentCard::default()/* use setters */);
    /// ```
    pub fn set_agent_card<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::AgentCard>,
    {
        self.agent_card = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [agent_card][crate::model::RemoteAgentTool::agent_card].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RemoteAgentTool;
    /// use google_cloud_ces_v1::model::AgentCard;
    /// let x = RemoteAgentTool::new().set_or_clear_agent_card(Some(AgentCard::default()/* use setters */));
    /// let x = RemoteAgentTool::new().set_or_clear_agent_card(None::<AgentCard>);
    /// ```
    pub fn set_or_clear_agent_card<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::AgentCard>,
    {
        self.agent_card = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for RemoteAgentTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RemoteAgentTool"
    }
}

/// Request message for
/// [AgentService.ListApps][google.cloud.ces.v1.AgentService.ListApps].
///
/// [google.cloud.ces.v1.AgentService.ListApps]: crate::client::AgentService::list_apps
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListAppsRequest {
    /// Required. The resource name of the location to list apps from.
    pub parent: std::string::String,

    /// Optional. Requested page size. Server may return fewer items than
    /// requested. If unspecified, server will pick an appropriate default.
    pub page_size: i32,

    /// Optional. The
    /// [next_page_token][google.cloud.ces.v1.ListAppsResponse.next_page_token]
    /// value returned from a previous list
    /// [AgentService.ListApps][google.cloud.ces.v1.AgentService.ListApps] call.
    ///
    /// [google.cloud.ces.v1.AgentService.ListApps]: crate::client::AgentService::list_apps
    /// [google.cloud.ces.v1.ListAppsResponse.next_page_token]: crate::model::ListAppsResponse::next_page_token
    pub page_token: std::string::String,

    /// Optional. Filter to be applied when listing the apps.
    /// See <https://google.aip.dev/160> for more details.
    pub filter: std::string::String,

    /// Optional. Field to sort by. Only "name" and "create_time" is supported.
    /// See <https://google.aip.dev/132#ordering> for more details.
    pub order_by: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListAppsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListAppsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// let x = ListAppsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListAppsRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppsRequest;
    /// let x = ListAppsRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListAppsRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppsRequest;
    /// let x = ListAppsRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [filter][crate::model::ListAppsRequest::filter].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppsRequest;
    /// let x = ListAppsRequest::new().set_filter("example");
    /// ```
    pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.filter = v.into();
        self
    }

    /// Sets the value of [order_by][crate::model::ListAppsRequest::order_by].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppsRequest;
    /// let x = ListAppsRequest::new().set_order_by("example");
    /// ```
    pub fn set_order_by<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.order_by = v.into();
        self
    }
}

impl wkt::message::Message for ListAppsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListAppsRequest"
    }
}

/// Response message for
/// [AgentService.ListApps][google.cloud.ces.v1.AgentService.ListApps].
///
/// [google.cloud.ces.v1.AgentService.ListApps]: crate::client::AgentService::list_apps
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListAppsResponse {
    /// The list of apps.
    pub apps: std::vec::Vec<crate::model::App>,

    /// A token that can be sent as
    /// [ListAppsRequest.page_token][google.cloud.ces.v1.ListAppsRequest.page_token]
    /// to retrieve the next page. Absence of this field indicates there are no
    /// subsequent pages.
    ///
    /// [google.cloud.ces.v1.ListAppsRequest.page_token]: crate::model::ListAppsRequest::page_token
    pub next_page_token: std::string::String,

    /// Unordered list. Locations that could not be reached.
    pub unreachable: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListAppsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [apps][crate::model::ListAppsResponse::apps].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppsResponse;
    /// use google_cloud_ces_v1::model::App;
    /// let x = ListAppsResponse::new()
    ///     .set_apps([
    ///         App::default()/* use setters */,
    ///         App::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_apps<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::App>,
    {
        use std::iter::Iterator;
        self.apps = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListAppsResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppsResponse;
    /// let x = ListAppsResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }

    /// Sets the value of [unreachable][crate::model::ListAppsResponse::unreachable].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppsResponse;
    /// let x = ListAppsResponse::new().set_unreachable(["a", "b", "c"]);
    /// ```
    pub fn set_unreachable<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.unreachable = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for ListAppsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListAppsResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListAppsResponse {
    type PageItem = crate::model::App;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.apps
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetApp][google.cloud.ces.v1.AgentService.GetApp].
///
/// [google.cloud.ces.v1.AgentService.GetApp]: crate::client::AgentService::get_app
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetAppRequest {
    /// Required. The resource name of the app to retrieve.
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetAppRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetAppRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetAppRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = GetAppRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetAppRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetAppRequest"
    }
}

/// Request message for
/// [AgentService.CreateApp][google.cloud.ces.v1.AgentService.CreateApp].
///
/// [google.cloud.ces.v1.AgentService.CreateApp]: crate::client::AgentService::create_app
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CreateAppRequest {
    /// Required. The resource name of the location to create an app in.
    pub parent: std::string::String,

    /// Optional. The ID to use for the app, which will become the final component
    /// of the app's resource name. If not provided, a unique ID will be
    /// automatically assigned for the app.
    pub app_id: std::string::String,

    /// Required. The app to create.
    pub app: std::option::Option<crate::model::App>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CreateAppRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::CreateAppRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAppRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// let x = CreateAppRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [app_id][crate::model::CreateAppRequest::app_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAppRequest;
    /// let x = CreateAppRequest::new().set_app_id("example");
    /// ```
    pub fn set_app_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.app_id = v.into();
        self
    }

    /// Sets the value of [app][crate::model::CreateAppRequest::app].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAppRequest;
    /// use google_cloud_ces_v1::model::App;
    /// let x = CreateAppRequest::new().set_app(App::default()/* use setters */);
    /// ```
    pub fn set_app<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::App>,
    {
        self.app = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [app][crate::model::CreateAppRequest::app].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAppRequest;
    /// use google_cloud_ces_v1::model::App;
    /// let x = CreateAppRequest::new().set_or_clear_app(Some(App::default()/* use setters */));
    /// let x = CreateAppRequest::new().set_or_clear_app(None::<App>);
    /// ```
    pub fn set_or_clear_app<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::App>,
    {
        self.app = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for CreateAppRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CreateAppRequest"
    }
}

/// Request message for
/// [AgentService.UpdateApp][google.cloud.ces.v1.AgentService.UpdateApp].
///
/// [google.cloud.ces.v1.AgentService.UpdateApp]: crate::client::AgentService::update_app
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct UpdateAppRequest {
    /// Required. The app to update.
    pub app: std::option::Option<crate::model::App>,

    /// Optional. Field mask is used to control which fields get updated. If the
    /// mask is not present, all fields will be updated.
    pub update_mask: std::option::Option<wkt::FieldMask>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl UpdateAppRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [app][crate::model::UpdateAppRequest::app].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateAppRequest;
    /// use google_cloud_ces_v1::model::App;
    /// let x = UpdateAppRequest::new().set_app(App::default()/* use setters */);
    /// ```
    pub fn set_app<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::App>,
    {
        self.app = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [app][crate::model::UpdateAppRequest::app].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateAppRequest;
    /// use google_cloud_ces_v1::model::App;
    /// let x = UpdateAppRequest::new().set_or_clear_app(Some(App::default()/* use setters */));
    /// let x = UpdateAppRequest::new().set_or_clear_app(None::<App>);
    /// ```
    pub fn set_or_clear_app<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::App>,
    {
        self.app = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_mask][crate::model::UpdateAppRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateAppRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateAppRequest::new().set_update_mask(FieldMask::default()/* use setters */);
    /// ```
    pub fn set_update_mask<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_mask][crate::model::UpdateAppRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateAppRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateAppRequest::new().set_or_clear_update_mask(Some(FieldMask::default()/* use setters */));
    /// let x = UpdateAppRequest::new().set_or_clear_update_mask(None::<FieldMask>);
    /// ```
    pub fn set_or_clear_update_mask<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for UpdateAppRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.UpdateAppRequest"
    }
}

/// Request message for
/// [AgentService.DeleteApp][google.cloud.ces.v1.AgentService.DeleteApp].
///
/// [google.cloud.ces.v1.AgentService.DeleteApp]: crate::client::AgentService::delete_app
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DeleteAppRequest {
    /// Required. The resource name of the app to delete.
    pub name: std::string::String,

    /// Optional. The current etag of the app. If an etag is not provided, the
    /// deletion will overwrite any concurrent changes. If an etag is provided and
    /// does not match the current etag of the app, deletion will be blocked and an
    /// ABORTED error will be returned.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DeleteAppRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DeleteAppRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteAppRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = DeleteAppRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [etag][crate::model::DeleteAppRequest::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteAppRequest;
    /// let x = DeleteAppRequest::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for DeleteAppRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DeleteAppRequest"
    }
}

/// Request message for
/// [AgentService.ExportApp][google.cloud.ces.v1.AgentService.ExportApp].
///
/// [google.cloud.ces.v1.AgentService.ExportApp]: crate::client::AgentService::export_app
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ExportAppRequest {
    /// Required. The resource name of the app to export.
    pub name: std::string::String,

    /// Required. The format to export the app in.
    pub export_format: crate::model::export_app_request::ExportFormat,

    /// Optional. The [Google Cloud
    /// Storage](https://cloud.google.com/storage/docs/) URI to which to export the
    /// app. The format of this URI must be `gs://<bucket-name>/<object-name>`. The
    /// exported app archive will be written directly to the specified GCS object.
    pub gcs_uri: std::string::String,

    /// Optional. The resource name of the app version to export.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/versions/{version}`.
    pub app_version: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ExportAppRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::ExportAppRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExportAppRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ExportAppRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [export_format][crate::model::ExportAppRequest::export_format].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExportAppRequest;
    /// use google_cloud_ces_v1::model::export_app_request::ExportFormat;
    /// let x0 = ExportAppRequest::new().set_export_format(ExportFormat::Json);
    /// let x1 = ExportAppRequest::new().set_export_format(ExportFormat::Yaml);
    /// ```
    pub fn set_export_format<
        T: std::convert::Into<crate::model::export_app_request::ExportFormat>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.export_format = v.into();
        self
    }

    /// Sets the value of [gcs_uri][crate::model::ExportAppRequest::gcs_uri].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExportAppRequest;
    /// let x = ExportAppRequest::new().set_gcs_uri("example");
    /// ```
    pub fn set_gcs_uri<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.gcs_uri = v.into();
        self
    }

    /// Sets the value of [app_version][crate::model::ExportAppRequest::app_version].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExportAppRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let version_id = "version_id";
    /// let x = ExportAppRequest::new().set_app_version(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/versions/{version_id}"));
    /// ```
    pub fn set_app_version<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.app_version = v.into();
        self
    }
}

impl wkt::message::Message for ExportAppRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ExportAppRequest"
    }
}

/// Defines additional types related to [ExportAppRequest].
pub mod export_app_request {
    #[allow(unused_imports)]
    use super::*;

    /// Export format for the app.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ExportFormat {
        /// The export format is unspecified.
        Unspecified,
        /// The export format is JSON.
        Json,
        /// The export format is YAML.
        Yaml,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [ExportFormat::value] or
        /// [ExportFormat::name].
        UnknownValue(export_format::UnknownValue),
    }

    #[doc(hidden)]
    pub mod export_format {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl ExportFormat {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Json => std::option::Option::Some(1),
                Self::Yaml => std::option::Option::Some(2),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("EXPORT_FORMAT_UNSPECIFIED"),
                Self::Json => std::option::Option::Some("JSON"),
                Self::Yaml => std::option::Option::Some("YAML"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for ExportFormat {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for ExportFormat {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for ExportFormat {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Json,
                2 => Self::Yaml,
                _ => Self::UnknownValue(export_format::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for ExportFormat {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "EXPORT_FORMAT_UNSPECIFIED" => Self::Unspecified,
                "JSON" => Self::Json,
                "YAML" => Self::Yaml,
                _ => Self::UnknownValue(export_format::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for ExportFormat {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Json => serializer.serialize_i32(1),
                Self::Yaml => serializer.serialize_i32(2),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for ExportFormat {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<ExportFormat>::new(
                ".google.cloud.ces.v1.ExportAppRequest.ExportFormat",
            ))
        }
    }
}

/// Response message for
/// [AgentService.ExportApp][google.cloud.ces.v1.AgentService.ExportApp].
///
/// [google.cloud.ces.v1.AgentService.ExportApp]: crate::client::AgentService::export_app
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ExportAppResponse {
    /// The exported app.
    pub app: std::option::Option<crate::model::export_app_response::App>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ExportAppResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [app][crate::model::ExportAppResponse::app].
    ///
    /// Note that all the setters affecting `app` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExportAppResponse;
    /// use google_cloud_ces_v1::model::export_app_response::App;
    /// let x = ExportAppResponse::new().set_app(Some(App::AppContent(bytes::Bytes::from_static(b"example"))));
    /// ```
    pub fn set_app<
        T: std::convert::Into<std::option::Option<crate::model::export_app_response::App>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.app = v.into();
        self
    }

    /// The value of [app][crate::model::ExportAppResponse::app]
    /// if it holds a `AppContent`, `None` if the field is not set or
    /// holds a different branch.
    pub fn app_content(&self) -> std::option::Option<&::bytes::Bytes> {
        #[allow(unreachable_patterns)]
        self.app.as_ref().and_then(|v| match v {
            crate::model::export_app_response::App::AppContent(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [app][crate::model::ExportAppResponse::app]
    /// to hold a `AppContent`.
    ///
    /// Note that all the setters affecting `app` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExportAppResponse;
    /// let x = ExportAppResponse::new().set_app_content(bytes::Bytes::from_static(b"example"));
    /// assert!(x.app_content().is_some());
    /// assert!(x.app_uri().is_none());
    /// ```
    pub fn set_app_content<T: std::convert::Into<::bytes::Bytes>>(mut self, v: T) -> Self {
        self.app =
            std::option::Option::Some(crate::model::export_app_response::App::AppContent(v.into()));
        self
    }

    /// The value of [app][crate::model::ExportAppResponse::app]
    /// if it holds a `AppUri`, `None` if the field is not set or
    /// holds a different branch.
    pub fn app_uri(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.app.as_ref().and_then(|v| match v {
            crate::model::export_app_response::App::AppUri(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [app][crate::model::ExportAppResponse::app]
    /// to hold a `AppUri`.
    ///
    /// Note that all the setters affecting `app` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExportAppResponse;
    /// let x = ExportAppResponse::new().set_app_uri("example");
    /// assert!(x.app_uri().is_some());
    /// assert!(x.app_content().is_none());
    /// ```
    pub fn set_app_uri<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.app =
            std::option::Option::Some(crate::model::export_app_response::App::AppUri(v.into()));
        self
    }
}

impl wkt::message::Message for ExportAppResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ExportAppResponse"
    }
}

/// Defines additional types related to [ExportAppResponse].
pub mod export_app_response {
    #[allow(unused_imports)]
    use super::*;

    /// The exported app.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum App {
        /// App folder compressed as a zip file.
        AppContent(::bytes::Bytes),
        /// The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI
        /// to which the app was exported.
        AppUri(std::string::String),
    }
}

/// Request message for
/// [AgentService.ImportApp][google.cloud.ces.v1.AgentService.ImportApp].
///
/// [google.cloud.ces.v1.AgentService.ImportApp]: crate::client::AgentService::import_app
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ImportAppRequest {
    /// Required. The parent resource name with the location of the app to import.
    pub parent: std::string::String,

    /// Optional. The display name of the app to import.
    ///
    /// * If the app is created on import, and the display name is specified,
    ///   the imported app will use this display name. If a conflict is detected
    ///   with an existing app, a timestamp will be appended to the display name
    ///   to make it unique.
    /// * If the app is a reimport, this field should not be set. Providing a
    ///   display name during reimport will result in an INVALID_ARGUMENT error.
    pub display_name: std::string::String,

    /// Optional. The ID to use for the imported app.
    ///
    /// * If not specified, a unique ID will be automatically assigned for
    ///   the app.
    /// * Otherwise, the imported app will use this ID as the final component of
    ///   its resource name. If an app with the same ID already exists at the
    ///   specified location in the project, the content of the existing app will be
    ///   replaced.
    pub app_id: std::string::String,

    /// Optional. Options governing the import process for the app.
    pub import_options: std::option::Option<crate::model::import_app_request::ImportOptions>,

    /// Optional. Flag for overriding the app lock during import.
    /// If set to true, the import process will ignore the app lock.
    pub ignore_app_lock: bool,

    /// The app to import.
    pub app: std::option::Option<crate::model::import_app_request::App>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ImportAppRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ImportAppRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// let x = ImportAppRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::ImportAppRequest::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppRequest;
    /// let x = ImportAppRequest::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [app_id][crate::model::ImportAppRequest::app_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppRequest;
    /// let x = ImportAppRequest::new().set_app_id("example");
    /// ```
    pub fn set_app_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.app_id = v.into();
        self
    }

    /// Sets the value of [import_options][crate::model::ImportAppRequest::import_options].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppRequest;
    /// use google_cloud_ces_v1::model::import_app_request::ImportOptions;
    /// let x = ImportAppRequest::new().set_import_options(ImportOptions::default()/* use setters */);
    /// ```
    pub fn set_import_options<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::import_app_request::ImportOptions>,
    {
        self.import_options = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [import_options][crate::model::ImportAppRequest::import_options].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppRequest;
    /// use google_cloud_ces_v1::model::import_app_request::ImportOptions;
    /// let x = ImportAppRequest::new().set_or_clear_import_options(Some(ImportOptions::default()/* use setters */));
    /// let x = ImportAppRequest::new().set_or_clear_import_options(None::<ImportOptions>);
    /// ```
    pub fn set_or_clear_import_options<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::import_app_request::ImportOptions>,
    {
        self.import_options = v.map(|x| x.into());
        self
    }

    /// Sets the value of [ignore_app_lock][crate::model::ImportAppRequest::ignore_app_lock].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppRequest;
    /// let x = ImportAppRequest::new().set_ignore_app_lock(true);
    /// ```
    pub fn set_ignore_app_lock<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.ignore_app_lock = v.into();
        self
    }

    /// Sets the value of [app][crate::model::ImportAppRequest::app].
    ///
    /// Note that all the setters affecting `app` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppRequest;
    /// use google_cloud_ces_v1::model::import_app_request::App;
    /// let x = ImportAppRequest::new().set_app(Some(App::GcsUri("example".to_string())));
    /// ```
    pub fn set_app<
        T: std::convert::Into<std::option::Option<crate::model::import_app_request::App>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.app = v.into();
        self
    }

    /// The value of [app][crate::model::ImportAppRequest::app]
    /// if it holds a `GcsUri`, `None` if the field is not set or
    /// holds a different branch.
    pub fn gcs_uri(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.app.as_ref().and_then(|v| match v {
            crate::model::import_app_request::App::GcsUri(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [app][crate::model::ImportAppRequest::app]
    /// to hold a `GcsUri`.
    ///
    /// Note that all the setters affecting `app` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppRequest;
    /// let x = ImportAppRequest::new().set_gcs_uri("example");
    /// assert!(x.gcs_uri().is_some());
    /// assert!(x.app_content().is_none());
    /// ```
    pub fn set_gcs_uri<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.app =
            std::option::Option::Some(crate::model::import_app_request::App::GcsUri(v.into()));
        self
    }

    /// The value of [app][crate::model::ImportAppRequest::app]
    /// if it holds a `AppContent`, `None` if the field is not set or
    /// holds a different branch.
    pub fn app_content(&self) -> std::option::Option<&::bytes::Bytes> {
        #[allow(unreachable_patterns)]
        self.app.as_ref().and_then(|v| match v {
            crate::model::import_app_request::App::AppContent(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [app][crate::model::ImportAppRequest::app]
    /// to hold a `AppContent`.
    ///
    /// Note that all the setters affecting `app` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppRequest;
    /// let x = ImportAppRequest::new().set_app_content(bytes::Bytes::from_static(b"example"));
    /// assert!(x.app_content().is_some());
    /// assert!(x.gcs_uri().is_none());
    /// ```
    pub fn set_app_content<T: std::convert::Into<::bytes::Bytes>>(mut self, v: T) -> Self {
        self.app =
            std::option::Option::Some(crate::model::import_app_request::App::AppContent(v.into()));
        self
    }
}

impl wkt::message::Message for ImportAppRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ImportAppRequest"
    }
}

/// Defines additional types related to [ImportAppRequest].
pub mod import_app_request {
    #[allow(unused_imports)]
    use super::*;

    /// Configuration options for the app import process.
    /// These options control how the import behaves, particularly when
    /// conflicts arise with existing app data.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct ImportOptions {
        /// Optional. The strategy to use when resolving conflicts during import.
        pub conflict_resolution_strategy:
            crate::model::import_app_request::import_options::ConflictResolutionStrategy,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl ImportOptions {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [conflict_resolution_strategy][crate::model::import_app_request::ImportOptions::conflict_resolution_strategy].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::import_app_request::ImportOptions;
        /// use google_cloud_ces_v1::model::import_app_request::import_options::ConflictResolutionStrategy;
        /// let x0 = ImportOptions::new().set_conflict_resolution_strategy(ConflictResolutionStrategy::Replace);
        /// let x1 = ImportOptions::new().set_conflict_resolution_strategy(ConflictResolutionStrategy::Overwrite);
        /// ```
        pub fn set_conflict_resolution_strategy<
            T: std::convert::Into<
                    crate::model::import_app_request::import_options::ConflictResolutionStrategy,
                >,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.conflict_resolution_strategy = v.into();
            self
        }
    }

    impl wkt::message::Message for ImportOptions {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.ImportAppRequest.ImportOptions"
        }
    }

    /// Defines additional types related to [ImportOptions].
    pub mod import_options {
        #[allow(unused_imports)]
        use super::*;

        /// Defines the strategy for handling conflicts when an app with the same ID
        /// already exists, or when imported resources (like Agents, Tools, etc.)
        /// have the same display names as existing resources within that app.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum ConflictResolutionStrategy {
            /// The conflict resolution strategy is unspecified.
            Unspecified,
            /// Replace existing data with imported data.
            /// If an app with the same `app_id` already exists, its content will be
            /// updated based on the imported app.
            ///
            /// - Resources (App, Agents, Tools, Examples, Guardrails, Toolsets) in the
            ///   imported app that have the same display name as existing resources
            ///   will overwrite the existing ones.
            /// - Imported resources with new display names will be created.
            /// - Existing resources that do not have a matching display name in the
            ///   imported app will remain untouched.
            Replace,
            /// Overwrite existing data with imported data.
            /// If an app with the same `app_id` already exists, its content will be
            /// overwritten with the imported app.
            ///
            /// - Existing resources (Agents, Tools, Examples, Guardrails, Toolsets) in
            ///   the app will be deleted.
            /// - Imported resources will be created as new resources.
            Overwrite,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [ConflictResolutionStrategy::value] or
            /// [ConflictResolutionStrategy::name].
            UnknownValue(conflict_resolution_strategy::UnknownValue),
        }

        #[doc(hidden)]
        pub mod conflict_resolution_strategy {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl ConflictResolutionStrategy {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::Replace => std::option::Option::Some(1),
                    Self::Overwrite => std::option::Option::Some(2),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => {
                        std::option::Option::Some("CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED")
                    }
                    Self::Replace => std::option::Option::Some("REPLACE"),
                    Self::Overwrite => std::option::Option::Some("OVERWRITE"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for ConflictResolutionStrategy {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for ConflictResolutionStrategy {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for ConflictResolutionStrategy {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::Replace,
                    2 => Self::Overwrite,
                    _ => Self::UnknownValue(conflict_resolution_strategy::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for ConflictResolutionStrategy {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED" => Self::Unspecified,
                    "REPLACE" => Self::Replace,
                    "OVERWRITE" => Self::Overwrite,
                    _ => Self::UnknownValue(conflict_resolution_strategy::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for ConflictResolutionStrategy {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::Replace => serializer.serialize_i32(1),
                    Self::Overwrite => serializer.serialize_i32(2),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for ConflictResolutionStrategy {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<ConflictResolutionStrategy>::new(
                    ".google.cloud.ces.v1.ImportAppRequest.ImportOptions.ConflictResolutionStrategy"))
            }
        }
    }

    /// The app to import.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum App {
        /// The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI
        /// from which to import app. The format of this URI must be
        /// `gs://<bucket-name>/<object-name>`.
        GcsUri(std::string::String),
        /// Raw bytes representing the compressed zip file with the app folder
        /// structure.
        AppContent(::bytes::Bytes),
    }
}

/// Response message for
/// [AgentService.ImportApp][google.cloud.ces.v1.AgentService.ImportApp].
///
/// [google.cloud.ces.v1.AgentService.ImportApp]: crate::client::AgentService::import_app
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ImportAppResponse {
    /// The resource name of the app that was imported.
    pub name: std::string::String,

    /// Warning messages generated during the import process.
    /// If errors occur for specific resources, they will not be included in the
    /// imported app and the error will be mentioned here.
    pub warnings: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ImportAppResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::ImportAppResponse::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppResponse;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ImportAppResponse::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [warnings][crate::model::ImportAppResponse::warnings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ImportAppResponse;
    /// let x = ImportAppResponse::new().set_warnings(["a", "b", "c"]);
    /// ```
    pub fn set_warnings<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.warnings = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for ImportAppResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ImportAppResponse"
    }
}

/// Request message for
/// [AgentService.ListAgents][google.cloud.ces.v1.AgentService.ListAgents].
///
/// [google.cloud.ces.v1.AgentService.ListAgents]: crate::client::AgentService::list_agents
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListAgentsRequest {
    /// Required. The resource name of the app to list agents from.
    pub parent: std::string::String,

    /// Optional. Requested page size. Server may return fewer items than
    /// requested. If unspecified, server will pick an appropriate default.
    pub page_size: i32,

    /// Optional. The
    /// [next_page_token][google.cloud.ces.v1.ListAgentsResponse.next_page_token]
    /// value returned from a previous list
    /// [AgentService.ListAgents][google.cloud.ces.v1.AgentService.ListAgents]
    /// call.
    ///
    /// [google.cloud.ces.v1.AgentService.ListAgents]: crate::client::AgentService::list_agents
    /// [google.cloud.ces.v1.ListAgentsResponse.next_page_token]: crate::model::ListAgentsResponse::next_page_token
    pub page_token: std::string::String,

    /// Optional. Filter to be applied when listing the agents.
    /// See <https://google.aip.dev/160> for more details.
    pub filter: std::string::String,

    /// Optional. Field to sort by. Only "name" and "create_time" is supported.
    /// See <https://google.aip.dev/132#ordering> for more details.
    pub order_by: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListAgentsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListAgentsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAgentsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ListAgentsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListAgentsRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAgentsRequest;
    /// let x = ListAgentsRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListAgentsRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAgentsRequest;
    /// let x = ListAgentsRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [filter][crate::model::ListAgentsRequest::filter].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAgentsRequest;
    /// let x = ListAgentsRequest::new().set_filter("example");
    /// ```
    pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.filter = v.into();
        self
    }

    /// Sets the value of [order_by][crate::model::ListAgentsRequest::order_by].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAgentsRequest;
    /// let x = ListAgentsRequest::new().set_order_by("example");
    /// ```
    pub fn set_order_by<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.order_by = v.into();
        self
    }
}

impl wkt::message::Message for ListAgentsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListAgentsRequest"
    }
}

/// Response message for
/// [AgentService.ListAgents][google.cloud.ces.v1.AgentService.ListAgents].
///
/// [google.cloud.ces.v1.AgentService.ListAgents]: crate::client::AgentService::list_agents
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListAgentsResponse {
    /// The list of agents.
    pub agents: std::vec::Vec<crate::model::Agent>,

    /// A token that can be sent as
    /// [ListAgentsRequest.page_token][google.cloud.ces.v1.ListAgentsRequest.page_token]
    /// to retrieve the next page. Absence of this field indicates there are no
    /// subsequent pages.
    ///
    /// [google.cloud.ces.v1.ListAgentsRequest.page_token]: crate::model::ListAgentsRequest::page_token
    pub next_page_token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListAgentsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [agents][crate::model::ListAgentsResponse::agents].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAgentsResponse;
    /// use google_cloud_ces_v1::model::Agent;
    /// let x = ListAgentsResponse::new()
    ///     .set_agents([
    ///         Agent::default()/* use setters */,
    ///         Agent::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_agents<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Agent>,
    {
        use std::iter::Iterator;
        self.agents = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListAgentsResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAgentsResponse;
    /// let x = ListAgentsResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }
}

impl wkt::message::Message for ListAgentsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListAgentsResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListAgentsResponse {
    type PageItem = crate::model::Agent;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.agents
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetAgent][google.cloud.ces.v1.AgentService.GetAgent].
///
/// [google.cloud.ces.v1.AgentService.GetAgent]: crate::client::AgentService::get_agent
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetAgentRequest {
    /// Required. The resource name of the agent to retrieve.
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetAgentRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetAgentRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetAgentRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = GetAgentRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetAgentRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetAgentRequest"
    }
}

/// Request message for
/// [AgentService.CreateAgent][google.cloud.ces.v1.AgentService.CreateAgent].
///
/// [google.cloud.ces.v1.AgentService.CreateAgent]: crate::client::AgentService::create_agent
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CreateAgentRequest {
    /// Required. The resource name of the app to create an agent in.
    pub parent: std::string::String,

    /// Optional. The ID to use for the agent, which will become the final
    /// component of the agent's resource name. If not provided, a unique ID will
    /// be automatically assigned for the agent.
    pub agent_id: std::string::String,

    /// Required. The agent to create.
    pub agent: std::option::Option<crate::model::Agent>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CreateAgentRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::CreateAgentRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAgentRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = CreateAgentRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [agent_id][crate::model::CreateAgentRequest::agent_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAgentRequest;
    /// let x = CreateAgentRequest::new().set_agent_id("example");
    /// ```
    pub fn set_agent_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.agent_id = v.into();
        self
    }

    /// Sets the value of [agent][crate::model::CreateAgentRequest::agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAgentRequest;
    /// use google_cloud_ces_v1::model::Agent;
    /// let x = CreateAgentRequest::new().set_agent(Agent::default()/* use setters */);
    /// ```
    pub fn set_agent<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Agent>,
    {
        self.agent = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [agent][crate::model::CreateAgentRequest::agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAgentRequest;
    /// use google_cloud_ces_v1::model::Agent;
    /// let x = CreateAgentRequest::new().set_or_clear_agent(Some(Agent::default()/* use setters */));
    /// let x = CreateAgentRequest::new().set_or_clear_agent(None::<Agent>);
    /// ```
    pub fn set_or_clear_agent<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Agent>,
    {
        self.agent = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for CreateAgentRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CreateAgentRequest"
    }
}

/// Request message for
/// [AgentService.UpdateAgent][google.cloud.ces.v1.AgentService.UpdateAgent].
///
/// [google.cloud.ces.v1.AgentService.UpdateAgent]: crate::client::AgentService::update_agent
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct UpdateAgentRequest {
    /// Required. The agent to update.
    pub agent: std::option::Option<crate::model::Agent>,

    /// Optional. Field mask is used to control which fields get updated. If the
    /// mask is not present, all fields will be updated.
    pub update_mask: std::option::Option<wkt::FieldMask>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl UpdateAgentRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [agent][crate::model::UpdateAgentRequest::agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateAgentRequest;
    /// use google_cloud_ces_v1::model::Agent;
    /// let x = UpdateAgentRequest::new().set_agent(Agent::default()/* use setters */);
    /// ```
    pub fn set_agent<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Agent>,
    {
        self.agent = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [agent][crate::model::UpdateAgentRequest::agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateAgentRequest;
    /// use google_cloud_ces_v1::model::Agent;
    /// let x = UpdateAgentRequest::new().set_or_clear_agent(Some(Agent::default()/* use setters */));
    /// let x = UpdateAgentRequest::new().set_or_clear_agent(None::<Agent>);
    /// ```
    pub fn set_or_clear_agent<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Agent>,
    {
        self.agent = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_mask][crate::model::UpdateAgentRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateAgentRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateAgentRequest::new().set_update_mask(FieldMask::default()/* use setters */);
    /// ```
    pub fn set_update_mask<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_mask][crate::model::UpdateAgentRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateAgentRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateAgentRequest::new().set_or_clear_update_mask(Some(FieldMask::default()/* use setters */));
    /// let x = UpdateAgentRequest::new().set_or_clear_update_mask(None::<FieldMask>);
    /// ```
    pub fn set_or_clear_update_mask<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for UpdateAgentRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.UpdateAgentRequest"
    }
}

/// Request message for
/// [AgentService.DeleteAgent][google.cloud.ces.v1.AgentService.DeleteAgent].
///
/// [google.cloud.ces.v1.AgentService.DeleteAgent]: crate::client::AgentService::delete_agent
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DeleteAgentRequest {
    /// Required. The resource name of the agent to delete.
    pub name: std::string::String,

    /// Optional. Indicates whether to forcefully delete the agent, even if it is
    /// still referenced by other app/agents/examples.
    ///
    /// * If `force = false`, the deletion fails if other agents/examples
    ///   reference it.
    /// * If `force = true`, delete the agent and remove it from all referencing
    ///   apps/agents/examples.
    pub force: bool,

    /// Optional. The current etag of the agent. If an etag is not provided, the
    /// deletion will overwrite any concurrent changes. If an etag is provided and
    /// does not match the current etag of the agent, deletion will be blocked and
    /// an ABORTED error will be returned.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DeleteAgentRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DeleteAgentRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteAgentRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = DeleteAgentRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [force][crate::model::DeleteAgentRequest::force].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteAgentRequest;
    /// let x = DeleteAgentRequest::new().set_force(true);
    /// ```
    pub fn set_force<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.force = v.into();
        self
    }

    /// Sets the value of [etag][crate::model::DeleteAgentRequest::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteAgentRequest;
    /// let x = DeleteAgentRequest::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for DeleteAgentRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DeleteAgentRequest"
    }
}

/// Represents the metadata of the long-running operation.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct OperationMetadata {
    /// Output only. The time the operation was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. The time the operation finished running.
    pub end_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Human-readable status of the operation, if any.
    pub status_message: std::string::String,

    /// Output only. Identifies whether the user has requested cancellation of the
    /// operation. Operations that have been cancelled successfully have
    /// [google.longrunning.Operation.error][google.longrunning.Operation.error]
    /// value with a [google.rpc.Status.code][google.rpc.Status.code] of `1`,
    /// corresponding to `Code.CANCELLED`.
    ///
    /// [google.longrunning.Operation.error]: google_cloud_longrunning::model::Operation::result
    /// [google.rpc.Status.code]: google_cloud_rpc::model::Status::code
    pub requested_cancellation: bool,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl OperationMetadata {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [create_time][crate::model::OperationMetadata::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OperationMetadata;
    /// use wkt::Timestamp;
    /// let x = OperationMetadata::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::OperationMetadata::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OperationMetadata;
    /// use wkt::Timestamp;
    /// let x = OperationMetadata::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = OperationMetadata::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [end_time][crate::model::OperationMetadata::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OperationMetadata;
    /// use wkt::Timestamp;
    /// let x = OperationMetadata::new().set_end_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_end_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [end_time][crate::model::OperationMetadata::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OperationMetadata;
    /// use wkt::Timestamp;
    /// let x = OperationMetadata::new().set_or_clear_end_time(Some(Timestamp::default()/* use setters */));
    /// let x = OperationMetadata::new().set_or_clear_end_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_end_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [status_message][crate::model::OperationMetadata::status_message].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OperationMetadata;
    /// let x = OperationMetadata::new().set_status_message("example");
    /// ```
    pub fn set_status_message<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.status_message = v.into();
        self
    }

    /// Sets the value of [requested_cancellation][crate::model::OperationMetadata::requested_cancellation].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OperationMetadata;
    /// let x = OperationMetadata::new().set_requested_cancellation(true);
    /// ```
    pub fn set_requested_cancellation<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.requested_cancellation = v.into();
        self
    }
}

impl wkt::message::Message for OperationMetadata {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.OperationMetadata"
    }
}

/// Request message for
/// [AgentService.ListExamples][google.cloud.ces.v1.AgentService.ListExamples].
///
/// [google.cloud.ces.v1.AgentService.ListExamples]: crate::client::AgentService::list_examples
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListExamplesRequest {
    /// Required. The resource name of the app to list examples from.
    pub parent: std::string::String,

    /// Optional. Requested page size. Server may return fewer items than
    /// requested. If unspecified, server will pick an appropriate default.
    pub page_size: i32,

    /// Optional. The
    /// [next_page_token][google.cloud.ces.v1.ListExamplesResponse.next_page_token]
    /// value returned from a previous list
    /// [AgentService.ListExamples][google.cloud.ces.v1.AgentService.ListExamples]
    /// call.
    ///
    /// [google.cloud.ces.v1.AgentService.ListExamples]: crate::client::AgentService::list_examples
    /// [google.cloud.ces.v1.ListExamplesResponse.next_page_token]: crate::model::ListExamplesResponse::next_page_token
    pub page_token: std::string::String,

    /// Optional. Filter to be applied when listing the examples.
    /// See <https://google.aip.dev/160> for more details.
    pub filter: std::string::String,

    /// Optional. Field to sort by. Only "name" and "create_time" is supported.
    /// See <https://google.aip.dev/132#ordering> for more details.
    pub order_by: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListExamplesRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListExamplesRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListExamplesRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ListExamplesRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListExamplesRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListExamplesRequest;
    /// let x = ListExamplesRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListExamplesRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListExamplesRequest;
    /// let x = ListExamplesRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [filter][crate::model::ListExamplesRequest::filter].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListExamplesRequest;
    /// let x = ListExamplesRequest::new().set_filter("example");
    /// ```
    pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.filter = v.into();
        self
    }

    /// Sets the value of [order_by][crate::model::ListExamplesRequest::order_by].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListExamplesRequest;
    /// let x = ListExamplesRequest::new().set_order_by("example");
    /// ```
    pub fn set_order_by<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.order_by = v.into();
        self
    }
}

impl wkt::message::Message for ListExamplesRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListExamplesRequest"
    }
}

/// Response message for
/// [AgentService.ListExamples][google.cloud.ces.v1.AgentService.ListExamples].
///
/// [google.cloud.ces.v1.AgentService.ListExamples]: crate::client::AgentService::list_examples
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListExamplesResponse {
    /// The list of examples.
    pub examples: std::vec::Vec<crate::model::Example>,

    /// A token that can be sent as
    /// [ListExamplesRequest.page_token][google.cloud.ces.v1.ListExamplesRequest.page_token]
    /// to retrieve the next page. Absence of this field indicates there are no
    /// subsequent pages.
    ///
    /// [google.cloud.ces.v1.ListExamplesRequest.page_token]: crate::model::ListExamplesRequest::page_token
    pub next_page_token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListExamplesResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [examples][crate::model::ListExamplesResponse::examples].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListExamplesResponse;
    /// use google_cloud_ces_v1::model::Example;
    /// let x = ListExamplesResponse::new()
    ///     .set_examples([
    ///         Example::default()/* use setters */,
    ///         Example::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_examples<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Example>,
    {
        use std::iter::Iterator;
        self.examples = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListExamplesResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListExamplesResponse;
    /// let x = ListExamplesResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }
}

impl wkt::message::Message for ListExamplesResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListExamplesResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListExamplesResponse {
    type PageItem = crate::model::Example;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.examples
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetExample][google.cloud.ces.v1.AgentService.GetExample].
///
/// [google.cloud.ces.v1.AgentService.GetExample]: crate::client::AgentService::get_example
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetExampleRequest {
    /// Required. The resource name of the example to retrieve.
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetExampleRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetExampleRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetExampleRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let example_id = "example_id";
    /// let x = GetExampleRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/examples/{example_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetExampleRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetExampleRequest"
    }
}

/// Request message for
/// [AgentService.CreateExample][google.cloud.ces.v1.AgentService.CreateExample].
///
/// [google.cloud.ces.v1.AgentService.CreateExample]: crate::client::AgentService::create_example
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CreateExampleRequest {
    /// Required. The resource name of the app to create an example in.
    pub parent: std::string::String,

    /// Optional. The ID to use for the example, which will become the final
    /// component of the example's resource name. If not provided, a unique ID will
    /// be automatically assigned for the example.
    pub example_id: std::string::String,

    /// Required. The example to create.
    pub example: std::option::Option<crate::model::Example>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CreateExampleRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::CreateExampleRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateExampleRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = CreateExampleRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [example_id][crate::model::CreateExampleRequest::example_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateExampleRequest;
    /// let x = CreateExampleRequest::new().set_example_id("example");
    /// ```
    pub fn set_example_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.example_id = v.into();
        self
    }

    /// Sets the value of [example][crate::model::CreateExampleRequest::example].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateExampleRequest;
    /// use google_cloud_ces_v1::model::Example;
    /// let x = CreateExampleRequest::new().set_example(Example::default()/* use setters */);
    /// ```
    pub fn set_example<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Example>,
    {
        self.example = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [example][crate::model::CreateExampleRequest::example].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateExampleRequest;
    /// use google_cloud_ces_v1::model::Example;
    /// let x = CreateExampleRequest::new().set_or_clear_example(Some(Example::default()/* use setters */));
    /// let x = CreateExampleRequest::new().set_or_clear_example(None::<Example>);
    /// ```
    pub fn set_or_clear_example<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Example>,
    {
        self.example = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for CreateExampleRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CreateExampleRequest"
    }
}

/// Request message for
/// [AgentService.UpdateExample][google.cloud.ces.v1.AgentService.UpdateExample].
///
/// [google.cloud.ces.v1.AgentService.UpdateExample]: crate::client::AgentService::update_example
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct UpdateExampleRequest {
    /// Required. The example to update.
    pub example: std::option::Option<crate::model::Example>,

    /// Optional. Field mask is used to control which fields get updated. If the
    /// mask is not present, all fields will be updated.
    pub update_mask: std::option::Option<wkt::FieldMask>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl UpdateExampleRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [example][crate::model::UpdateExampleRequest::example].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateExampleRequest;
    /// use google_cloud_ces_v1::model::Example;
    /// let x = UpdateExampleRequest::new().set_example(Example::default()/* use setters */);
    /// ```
    pub fn set_example<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Example>,
    {
        self.example = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [example][crate::model::UpdateExampleRequest::example].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateExampleRequest;
    /// use google_cloud_ces_v1::model::Example;
    /// let x = UpdateExampleRequest::new().set_or_clear_example(Some(Example::default()/* use setters */));
    /// let x = UpdateExampleRequest::new().set_or_clear_example(None::<Example>);
    /// ```
    pub fn set_or_clear_example<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Example>,
    {
        self.example = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_mask][crate::model::UpdateExampleRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateExampleRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateExampleRequest::new().set_update_mask(FieldMask::default()/* use setters */);
    /// ```
    pub fn set_update_mask<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_mask][crate::model::UpdateExampleRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateExampleRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateExampleRequest::new().set_or_clear_update_mask(Some(FieldMask::default()/* use setters */));
    /// let x = UpdateExampleRequest::new().set_or_clear_update_mask(None::<FieldMask>);
    /// ```
    pub fn set_or_clear_update_mask<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for UpdateExampleRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.UpdateExampleRequest"
    }
}

/// Request message for
/// [AgentService.DeleteExample][google.cloud.ces.v1.AgentService.DeleteExample].
///
/// [google.cloud.ces.v1.AgentService.DeleteExample]: crate::client::AgentService::delete_example
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DeleteExampleRequest {
    /// Required. The resource name of the example to delete.
    pub name: std::string::String,

    /// Optional. The current etag of the example. If an etag is not provided, the
    /// deletion will overwrite any concurrent changes. If an etag is provided and
    /// does not match the current etag of the example, deletion will be blocked
    /// and an ABORTED error will be returned.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DeleteExampleRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DeleteExampleRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteExampleRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let example_id = "example_id";
    /// let x = DeleteExampleRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/examples/{example_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [etag][crate::model::DeleteExampleRequest::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteExampleRequest;
    /// let x = DeleteExampleRequest::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for DeleteExampleRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DeleteExampleRequest"
    }
}

/// Request message for
/// [AgentService.ListTools][google.cloud.ces.v1.AgentService.ListTools].
///
/// [google.cloud.ces.v1.AgentService.ListTools]: crate::client::AgentService::list_tools
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListToolsRequest {
    /// Required. The resource name of the app to list tools from.
    pub parent: std::string::String,

    /// Optional. Requested page size. Server may return fewer items than
    /// requested. If unspecified, server will pick an appropriate default.
    pub page_size: i32,

    /// Optional. The
    /// [next_page_token][google.cloud.ces.v1.ListToolsResponse.next_page_token]
    /// value returned from a previous list
    /// [AgentService.ListTools][google.cloud.ces.v1.AgentService.ListTools] call.
    ///
    /// [google.cloud.ces.v1.AgentService.ListTools]: crate::client::AgentService::list_tools
    /// [google.cloud.ces.v1.ListToolsResponse.next_page_token]: crate::model::ListToolsResponse::next_page_token
    pub page_token: std::string::String,

    /// Optional. Filter to be applied when listing the tools. Use
    /// "include_system_tools=true" to include system tools in the response. See
    /// <https://google.aip.dev/160> for more details.
    pub filter: std::string::String,

    /// Optional. Field to sort by. Only "name" and "create_time" is supported.
    /// See <https://google.aip.dev/132#ordering> for more details.
    pub order_by: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListToolsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListToolsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ListToolsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListToolsRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsRequest;
    /// let x = ListToolsRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListToolsRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsRequest;
    /// let x = ListToolsRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [filter][crate::model::ListToolsRequest::filter].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsRequest;
    /// let x = ListToolsRequest::new().set_filter("example");
    /// ```
    pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.filter = v.into();
        self
    }

    /// Sets the value of [order_by][crate::model::ListToolsRequest::order_by].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsRequest;
    /// let x = ListToolsRequest::new().set_order_by("example");
    /// ```
    pub fn set_order_by<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.order_by = v.into();
        self
    }
}

impl wkt::message::Message for ListToolsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListToolsRequest"
    }
}

/// Response message for
/// [AgentService.ListTools][google.cloud.ces.v1.AgentService.ListTools].
///
/// [google.cloud.ces.v1.AgentService.ListTools]: crate::client::AgentService::list_tools
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListToolsResponse {
    /// The list of tools.
    pub tools: std::vec::Vec<crate::model::Tool>,

    /// A token that can be sent as
    /// [ListToolsRequest.page_token][google.cloud.ces.v1.ListToolsRequest.page_token]
    /// to retrieve the next page. Absence of this field indicates there are no
    /// subsequent pages.
    ///
    /// [google.cloud.ces.v1.ListToolsRequest.page_token]: crate::model::ListToolsRequest::page_token
    pub next_page_token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListToolsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [tools][crate::model::ListToolsResponse::tools].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsResponse;
    /// use google_cloud_ces_v1::model::Tool;
    /// let x = ListToolsResponse::new()
    ///     .set_tools([
    ///         Tool::default()/* use setters */,
    ///         Tool::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_tools<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Tool>,
    {
        use std::iter::Iterator;
        self.tools = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListToolsResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsResponse;
    /// let x = ListToolsResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }
}

impl wkt::message::Message for ListToolsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListToolsResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListToolsResponse {
    type PageItem = crate::model::Tool;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.tools
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetTool][google.cloud.ces.v1.AgentService.GetTool].
///
/// [google.cloud.ces.v1.AgentService.GetTool]: crate::client::AgentService::get_tool
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetToolRequest {
    /// Required. The resource name of the tool to retrieve.
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetToolRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetToolRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetToolRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = GetToolRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetToolRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetToolRequest"
    }
}

/// Request message for
/// [AgentService.CreateTool][google.cloud.ces.v1.AgentService.CreateTool].
///
/// [google.cloud.ces.v1.AgentService.CreateTool]: crate::client::AgentService::create_tool
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CreateToolRequest {
    /// Required. The resource name of the app to create a tool in.
    pub parent: std::string::String,

    /// Optional. The ID to use for the tool, which will become the final component
    /// of the tool's resource name. If not provided, a unique ID will be
    /// automatically assigned for the tool.
    pub tool_id: std::string::String,

    /// Required. The tool to create.
    pub tool: std::option::Option<crate::model::Tool>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CreateToolRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::CreateToolRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateToolRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = CreateToolRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [tool_id][crate::model::CreateToolRequest::tool_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateToolRequest;
    /// let x = CreateToolRequest::new().set_tool_id("example");
    /// ```
    pub fn set_tool_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool_id = v.into();
        self
    }

    /// Sets the value of [tool][crate::model::CreateToolRequest::tool].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateToolRequest;
    /// use google_cloud_ces_v1::model::Tool;
    /// let x = CreateToolRequest::new().set_tool(Tool::default()/* use setters */);
    /// ```
    pub fn set_tool<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Tool>,
    {
        self.tool = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [tool][crate::model::CreateToolRequest::tool].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateToolRequest;
    /// use google_cloud_ces_v1::model::Tool;
    /// let x = CreateToolRequest::new().set_or_clear_tool(Some(Tool::default()/* use setters */));
    /// let x = CreateToolRequest::new().set_or_clear_tool(None::<Tool>);
    /// ```
    pub fn set_or_clear_tool<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Tool>,
    {
        self.tool = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for CreateToolRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CreateToolRequest"
    }
}

/// Request message for
/// [AgentService.UpdateTool][google.cloud.ces.v1.AgentService.UpdateTool].
///
/// [google.cloud.ces.v1.AgentService.UpdateTool]: crate::client::AgentService::update_tool
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct UpdateToolRequest {
    /// Required. The tool to update.
    pub tool: std::option::Option<crate::model::Tool>,

    /// Optional. Field mask is used to control which fields get updated. If the
    /// mask is not present, all fields will be updated.
    pub update_mask: std::option::Option<wkt::FieldMask>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl UpdateToolRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [tool][crate::model::UpdateToolRequest::tool].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateToolRequest;
    /// use google_cloud_ces_v1::model::Tool;
    /// let x = UpdateToolRequest::new().set_tool(Tool::default()/* use setters */);
    /// ```
    pub fn set_tool<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Tool>,
    {
        self.tool = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [tool][crate::model::UpdateToolRequest::tool].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateToolRequest;
    /// use google_cloud_ces_v1::model::Tool;
    /// let x = UpdateToolRequest::new().set_or_clear_tool(Some(Tool::default()/* use setters */));
    /// let x = UpdateToolRequest::new().set_or_clear_tool(None::<Tool>);
    /// ```
    pub fn set_or_clear_tool<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Tool>,
    {
        self.tool = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_mask][crate::model::UpdateToolRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateToolRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateToolRequest::new().set_update_mask(FieldMask::default()/* use setters */);
    /// ```
    pub fn set_update_mask<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_mask][crate::model::UpdateToolRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateToolRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateToolRequest::new().set_or_clear_update_mask(Some(FieldMask::default()/* use setters */));
    /// let x = UpdateToolRequest::new().set_or_clear_update_mask(None::<FieldMask>);
    /// ```
    pub fn set_or_clear_update_mask<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for UpdateToolRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.UpdateToolRequest"
    }
}

/// Request message for
/// [AgentService.DeleteTool][google.cloud.ces.v1.AgentService.DeleteTool].
///
/// [google.cloud.ces.v1.AgentService.DeleteTool]: crate::client::AgentService::delete_tool
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DeleteToolRequest {
    /// Required. The resource name of the tool to delete.
    pub name: std::string::String,

    /// Optional. Indicates whether to forcefully delete the tool, even if it is
    /// still referenced by agents/examples.
    ///
    /// * If `force = false`, the deletion will fail if any agents still
    ///   reference the tool.
    /// * If `force = true`, all existing references from agents will be removed
    ///   and the tool will be deleted.
    pub force: bool,

    /// Optional. The current etag of the tool. If an etag is not provided, the
    /// deletion will overwrite any concurrent changes. If an etag is provided and
    /// does not match the current etag of the tool, deletion will be blocked and
    /// an ABORTED error will be returned.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DeleteToolRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DeleteToolRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteToolRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = DeleteToolRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [force][crate::model::DeleteToolRequest::force].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteToolRequest;
    /// let x = DeleteToolRequest::new().set_force(true);
    /// ```
    pub fn set_force<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.force = v.into();
        self
    }

    /// Sets the value of [etag][crate::model::DeleteToolRequest::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteToolRequest;
    /// let x = DeleteToolRequest::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for DeleteToolRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DeleteToolRequest"
    }
}

/// Request message for
/// [AgentService.ListConversations][google.cloud.ces.v1.AgentService.ListConversations].
///
/// [google.cloud.ces.v1.AgentService.ListConversations]: crate::client::AgentService::list_conversations
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListConversationsRequest {
    /// Required. The resource name of the app to list conversations from.
    pub parent: std::string::String,

    /// Optional. Requested page size. Server may return fewer items than
    /// requested. If unspecified, server will pick an appropriate default.
    pub page_size: i32,

    /// Optional. The
    /// [next_page_token][google.cloud.ces.v1.ListConversationsResponse.next_page_token]
    /// value returned from a previous list
    /// [AgentService.ListConversations][google.cloud.ces.v1.AgentService.ListConversations]
    /// call.
    ///
    /// [google.cloud.ces.v1.AgentService.ListConversations]: crate::client::AgentService::list_conversations
    /// [google.cloud.ces.v1.ListConversationsResponse.next_page_token]: crate::model::ListConversationsResponse::next_page_token
    pub page_token: std::string::String,

    /// Optional. Filter to be applied when listing the conversations.
    /// See <https://google.aip.dev/160> for more details.
    pub filter: std::string::String,

    /// Optional. Indicate the source of the conversation. If not set, Source.Live
    /// will be applied by default. Will be deprecated in favor of `sources` field.
    pub source: crate::model::conversation::Source,

    /// Optional. Indicate the sources of the conversations. If not set, all
    /// available sources will be applied by default.
    pub sources: std::vec::Vec<crate::model::conversation::Source>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListConversationsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListConversationsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListConversationsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ListConversationsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListConversationsRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListConversationsRequest;
    /// let x = ListConversationsRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListConversationsRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListConversationsRequest;
    /// let x = ListConversationsRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [filter][crate::model::ListConversationsRequest::filter].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListConversationsRequest;
    /// let x = ListConversationsRequest::new().set_filter("example");
    /// ```
    pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.filter = v.into();
        self
    }

    /// Sets the value of [source][crate::model::ListConversationsRequest::source].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListConversationsRequest;
    /// use google_cloud_ces_v1::model::conversation::Source;
    /// let x0 = ListConversationsRequest::new().set_source(Source::Live);
    /// let x1 = ListConversationsRequest::new().set_source(Source::Simulator);
    /// let x2 = ListConversationsRequest::new().set_source(Source::Eval);
    /// ```
    pub fn set_source<T: std::convert::Into<crate::model::conversation::Source>>(
        mut self,
        v: T,
    ) -> Self {
        self.source = v.into();
        self
    }

    /// Sets the value of [sources][crate::model::ListConversationsRequest::sources].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListConversationsRequest;
    /// use google_cloud_ces_v1::model::conversation::Source;
    /// let x = ListConversationsRequest::new().set_sources([
    ///     Source::Live,
    ///     Source::Simulator,
    ///     Source::Eval,
    /// ]);
    /// ```
    pub fn set_sources<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::conversation::Source>,
    {
        use std::iter::Iterator;
        self.sources = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for ListConversationsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListConversationsRequest"
    }
}

/// Response message for
/// [AgentService.ListConversations][google.cloud.ces.v1.AgentService.ListConversations].
///
/// [google.cloud.ces.v1.AgentService.ListConversations]: crate::client::AgentService::list_conversations
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListConversationsResponse {
    /// The list of conversations.
    pub conversations: std::vec::Vec<crate::model::Conversation>,

    /// A token that can be sent as
    /// [ListConversationsRequest.page_token][google.cloud.ces.v1.ListConversationsRequest.page_token]
    /// to retrieve the next page. Absence of this field indicates there are no
    /// subsequent pages.
    ///
    /// [google.cloud.ces.v1.ListConversationsRequest.page_token]: crate::model::ListConversationsRequest::page_token
    pub next_page_token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListConversationsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [conversations][crate::model::ListConversationsResponse::conversations].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListConversationsResponse;
    /// use google_cloud_ces_v1::model::Conversation;
    /// let x = ListConversationsResponse::new()
    ///     .set_conversations([
    ///         Conversation::default()/* use setters */,
    ///         Conversation::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_conversations<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Conversation>,
    {
        use std::iter::Iterator;
        self.conversations = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListConversationsResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListConversationsResponse;
    /// let x = ListConversationsResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }
}

impl wkt::message::Message for ListConversationsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListConversationsResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListConversationsResponse {
    type PageItem = crate::model::Conversation;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.conversations
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetConversation][google.cloud.ces.v1.AgentService.GetConversation].
///
/// [google.cloud.ces.v1.AgentService.GetConversation]: crate::client::AgentService::get_conversation
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetConversationRequest {
    /// Required. The resource name of the conversation to retrieve.
    pub name: std::string::String,

    /// Optional. Indicate the source of the conversation. If not set, all source
    /// will be searched.
    #[deprecated]
    pub source: crate::model::conversation::Source,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetConversationRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetConversationRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetConversationRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let conversation_id = "conversation_id";
    /// let x = GetConversationRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/conversations/{conversation_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [source][crate::model::GetConversationRequest::source].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetConversationRequest;
    /// use google_cloud_ces_v1::model::conversation::Source;
    /// let x0 = GetConversationRequest::new().set_source(Source::Live);
    /// let x1 = GetConversationRequest::new().set_source(Source::Simulator);
    /// let x2 = GetConversationRequest::new().set_source(Source::Eval);
    /// ```
    #[deprecated]
    pub fn set_source<T: std::convert::Into<crate::model::conversation::Source>>(
        mut self,
        v: T,
    ) -> Self {
        self.source = v.into();
        self
    }
}

impl wkt::message::Message for GetConversationRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetConversationRequest"
    }
}

/// Request message for
/// [AgentService.DeleteConversation][google.cloud.ces.v1.AgentService.DeleteConversation].
///
/// [google.cloud.ces.v1.AgentService.DeleteConversation]: crate::client::AgentService::delete_conversation
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DeleteConversationRequest {
    /// Required. The resource name of the conversation to delete.
    pub name: std::string::String,

    /// Optional. Indicate the source of the conversation. If not set, Source.Live
    /// will be applied by default.
    #[deprecated]
    pub source: crate::model::conversation::Source,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DeleteConversationRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DeleteConversationRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteConversationRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let conversation_id = "conversation_id";
    /// let x = DeleteConversationRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/conversations/{conversation_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [source][crate::model::DeleteConversationRequest::source].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteConversationRequest;
    /// use google_cloud_ces_v1::model::conversation::Source;
    /// let x0 = DeleteConversationRequest::new().set_source(Source::Live);
    /// let x1 = DeleteConversationRequest::new().set_source(Source::Simulator);
    /// let x2 = DeleteConversationRequest::new().set_source(Source::Eval);
    /// ```
    #[deprecated]
    pub fn set_source<T: std::convert::Into<crate::model::conversation::Source>>(
        mut self,
        v: T,
    ) -> Self {
        self.source = v.into();
        self
    }
}

impl wkt::message::Message for DeleteConversationRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DeleteConversationRequest"
    }
}

/// Request message for
/// [AgentService.BatchDeleteConversations][google.cloud.ces.v1.AgentService.BatchDeleteConversations].
///
/// [google.cloud.ces.v1.AgentService.BatchDeleteConversations]: crate::client::AgentService::batch_delete_conversations
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct BatchDeleteConversationsRequest {
    /// Required. The resource name of the app to delete conversations from.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}`
    pub parent: std::string::String,

    /// Required. The resource names of the conversations to delete.
    pub conversations: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl BatchDeleteConversationsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::BatchDeleteConversationsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BatchDeleteConversationsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = BatchDeleteConversationsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [conversations][crate::model::BatchDeleteConversationsRequest::conversations].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BatchDeleteConversationsRequest;
    /// let x = BatchDeleteConversationsRequest::new().set_conversations(["a", "b", "c"]);
    /// ```
    pub fn set_conversations<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.conversations = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for BatchDeleteConversationsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.BatchDeleteConversationsRequest"
    }
}

/// Response message for
/// [AgentService.BatchDeleteConversations][google.cloud.ces.v1.AgentService.BatchDeleteConversations].
///
/// [google.cloud.ces.v1.AgentService.BatchDeleteConversations]: crate::client::AgentService::batch_delete_conversations
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct BatchDeleteConversationsResponse {
    /// The list of conversations that were successfully deleted.
    pub deleted_conversations: std::vec::Vec<std::string::String>,

    /// The list of conversations that failed to be deleted.
    pub failed_conversations: std::vec::Vec<std::string::String>,

    /// Optional. A list of error messages associated with conversations that
    /// failed to be deleted.
    pub error_messages: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl BatchDeleteConversationsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [deleted_conversations][crate::model::BatchDeleteConversationsResponse::deleted_conversations].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BatchDeleteConversationsResponse;
    /// let x = BatchDeleteConversationsResponse::new().set_deleted_conversations(["a", "b", "c"]);
    /// ```
    pub fn set_deleted_conversations<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.deleted_conversations = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [failed_conversations][crate::model::BatchDeleteConversationsResponse::failed_conversations].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BatchDeleteConversationsResponse;
    /// let x = BatchDeleteConversationsResponse::new().set_failed_conversations(["a", "b", "c"]);
    /// ```
    pub fn set_failed_conversations<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.failed_conversations = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [error_messages][crate::model::BatchDeleteConversationsResponse::error_messages].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BatchDeleteConversationsResponse;
    /// let x = BatchDeleteConversationsResponse::new().set_error_messages(["a", "b", "c"]);
    /// ```
    pub fn set_error_messages<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.error_messages = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for BatchDeleteConversationsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.BatchDeleteConversationsResponse"
    }
}

/// Request message for
/// [AgentService.ListGuardrails][google.cloud.ces.v1.AgentService.ListGuardrails].
///
/// [google.cloud.ces.v1.AgentService.ListGuardrails]: crate::client::AgentService::list_guardrails
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListGuardrailsRequest {
    /// Required. The resource name of the app to list guardrails from.
    pub parent: std::string::String,

    /// Optional. Requested page size. Server may return fewer items than
    /// requested. If unspecified, server will pick an appropriate default.
    pub page_size: i32,

    /// Optional. The
    /// [next_page_token][google.cloud.ces.v1.ListGuardrailsResponse.next_page_token]
    /// value returned from a previous list
    /// [AgentService.ListGuardrails][google.cloud.ces.v1.AgentService.ListGuardrails]
    /// call.
    ///
    /// [google.cloud.ces.v1.AgentService.ListGuardrails]: crate::client::AgentService::list_guardrails
    /// [google.cloud.ces.v1.ListGuardrailsResponse.next_page_token]: crate::model::ListGuardrailsResponse::next_page_token
    pub page_token: std::string::String,

    /// Optional. Filter to be applied when listing the guardrails.
    /// See <https://google.aip.dev/160> for more details.
    pub filter: std::string::String,

    /// Optional. Field to sort by. Only "name" and "create_time" is supported.
    /// See <https://google.aip.dev/132#ordering> for more details.
    pub order_by: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListGuardrailsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListGuardrailsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListGuardrailsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ListGuardrailsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListGuardrailsRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListGuardrailsRequest;
    /// let x = ListGuardrailsRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListGuardrailsRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListGuardrailsRequest;
    /// let x = ListGuardrailsRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [filter][crate::model::ListGuardrailsRequest::filter].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListGuardrailsRequest;
    /// let x = ListGuardrailsRequest::new().set_filter("example");
    /// ```
    pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.filter = v.into();
        self
    }

    /// Sets the value of [order_by][crate::model::ListGuardrailsRequest::order_by].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListGuardrailsRequest;
    /// let x = ListGuardrailsRequest::new().set_order_by("example");
    /// ```
    pub fn set_order_by<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.order_by = v.into();
        self
    }
}

impl wkt::message::Message for ListGuardrailsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListGuardrailsRequest"
    }
}

/// Response message for
/// [AgentService.ListGuardrails][google.cloud.ces.v1.AgentService.ListGuardrails].
///
/// [google.cloud.ces.v1.AgentService.ListGuardrails]: crate::client::AgentService::list_guardrails
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListGuardrailsResponse {
    /// The list of guardrails.
    pub guardrails: std::vec::Vec<crate::model::Guardrail>,

    /// A token that can be sent as
    /// [ListGuardrailsRequest.page_token][google.cloud.ces.v1.ListGuardrailsRequest.page_token]
    /// to retrieve the next page. Absence of this field indicates there are no
    /// subsequent pages.
    ///
    /// [google.cloud.ces.v1.ListGuardrailsRequest.page_token]: crate::model::ListGuardrailsRequest::page_token
    pub next_page_token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListGuardrailsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [guardrails][crate::model::ListGuardrailsResponse::guardrails].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListGuardrailsResponse;
    /// use google_cloud_ces_v1::model::Guardrail;
    /// let x = ListGuardrailsResponse::new()
    ///     .set_guardrails([
    ///         Guardrail::default()/* use setters */,
    ///         Guardrail::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_guardrails<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Guardrail>,
    {
        use std::iter::Iterator;
        self.guardrails = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListGuardrailsResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListGuardrailsResponse;
    /// let x = ListGuardrailsResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }
}

impl wkt::message::Message for ListGuardrailsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListGuardrailsResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListGuardrailsResponse {
    type PageItem = crate::model::Guardrail;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.guardrails
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetGuardrail][google.cloud.ces.v1.AgentService.GetGuardrail].
///
/// [google.cloud.ces.v1.AgentService.GetGuardrail]: crate::client::AgentService::get_guardrail
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetGuardrailRequest {
    /// Required. The resource name of the guardrail to retrieve.
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetGuardrailRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetGuardrailRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetGuardrailRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let guardrail_id = "guardrail_id";
    /// let x = GetGuardrailRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/guardrails/{guardrail_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetGuardrailRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetGuardrailRequest"
    }
}

/// Request message for
/// [AgentService.CreateGuardrail][google.cloud.ces.v1.AgentService.CreateGuardrail].
///
/// [google.cloud.ces.v1.AgentService.CreateGuardrail]: crate::client::AgentService::create_guardrail
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CreateGuardrailRequest {
    /// Required. The resource name of the app to create a guardrail in.
    pub parent: std::string::String,

    /// Optional. The ID to use for the guardrail, which will become the final
    /// component of the guardrail's resource name. If not provided, a unique ID
    /// will be automatically assigned for the guardrail.
    pub guardrail_id: std::string::String,

    /// Required. The guardrail to create.
    pub guardrail: std::option::Option<crate::model::Guardrail>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CreateGuardrailRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::CreateGuardrailRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateGuardrailRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = CreateGuardrailRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [guardrail_id][crate::model::CreateGuardrailRequest::guardrail_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateGuardrailRequest;
    /// let x = CreateGuardrailRequest::new().set_guardrail_id("example");
    /// ```
    pub fn set_guardrail_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.guardrail_id = v.into();
        self
    }

    /// Sets the value of [guardrail][crate::model::CreateGuardrailRequest::guardrail].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateGuardrailRequest;
    /// use google_cloud_ces_v1::model::Guardrail;
    /// let x = CreateGuardrailRequest::new().set_guardrail(Guardrail::default()/* use setters */);
    /// ```
    pub fn set_guardrail<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Guardrail>,
    {
        self.guardrail = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [guardrail][crate::model::CreateGuardrailRequest::guardrail].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateGuardrailRequest;
    /// use google_cloud_ces_v1::model::Guardrail;
    /// let x = CreateGuardrailRequest::new().set_or_clear_guardrail(Some(Guardrail::default()/* use setters */));
    /// let x = CreateGuardrailRequest::new().set_or_clear_guardrail(None::<Guardrail>);
    /// ```
    pub fn set_or_clear_guardrail<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Guardrail>,
    {
        self.guardrail = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for CreateGuardrailRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CreateGuardrailRequest"
    }
}

/// Request message for
/// [AgentService.UpdateGuardrail][google.cloud.ces.v1.AgentService.UpdateGuardrail].
///
/// [google.cloud.ces.v1.AgentService.UpdateGuardrail]: crate::client::AgentService::update_guardrail
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct UpdateGuardrailRequest {
    /// Required. The guardrail to update.
    pub guardrail: std::option::Option<crate::model::Guardrail>,

    /// Optional. Field mask is used to control which fields get updated. If the
    /// mask is not present, all fields will be updated.
    pub update_mask: std::option::Option<wkt::FieldMask>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl UpdateGuardrailRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [guardrail][crate::model::UpdateGuardrailRequest::guardrail].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateGuardrailRequest;
    /// use google_cloud_ces_v1::model::Guardrail;
    /// let x = UpdateGuardrailRequest::new().set_guardrail(Guardrail::default()/* use setters */);
    /// ```
    pub fn set_guardrail<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Guardrail>,
    {
        self.guardrail = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [guardrail][crate::model::UpdateGuardrailRequest::guardrail].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateGuardrailRequest;
    /// use google_cloud_ces_v1::model::Guardrail;
    /// let x = UpdateGuardrailRequest::new().set_or_clear_guardrail(Some(Guardrail::default()/* use setters */));
    /// let x = UpdateGuardrailRequest::new().set_or_clear_guardrail(None::<Guardrail>);
    /// ```
    pub fn set_or_clear_guardrail<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Guardrail>,
    {
        self.guardrail = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_mask][crate::model::UpdateGuardrailRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateGuardrailRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateGuardrailRequest::new().set_update_mask(FieldMask::default()/* use setters */);
    /// ```
    pub fn set_update_mask<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_mask][crate::model::UpdateGuardrailRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateGuardrailRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateGuardrailRequest::new().set_or_clear_update_mask(Some(FieldMask::default()/* use setters */));
    /// let x = UpdateGuardrailRequest::new().set_or_clear_update_mask(None::<FieldMask>);
    /// ```
    pub fn set_or_clear_update_mask<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for UpdateGuardrailRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.UpdateGuardrailRequest"
    }
}

/// Request message for
/// [AgentService.DeleteGuardrail][google.cloud.ces.v1.AgentService.DeleteGuardrail].
///
/// [google.cloud.ces.v1.AgentService.DeleteGuardrail]: crate::client::AgentService::delete_guardrail
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DeleteGuardrailRequest {
    /// Required. The resource name of the guardrail to delete.
    pub name: std::string::String,

    /// Optional. Indicates whether to forcefully delete the guardrail, even if it
    /// is still referenced by app/agents.
    ///
    /// * If `force = false`, the deletion fails if any apps/agents still
    ///   reference the guardrail.
    /// * If `force = true`, all existing references from apps/agents will be
    ///   removed and the guardrail will be deleted.
    pub force: bool,

    /// Optional. The current etag of the guardrail. If an etag is not provided,
    /// the deletion will overwrite any concurrent changes. If an etag is provided
    /// and does not match the current etag of the guardrail, deletion will be
    /// blocked and an ABORTED error will be returned.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DeleteGuardrailRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DeleteGuardrailRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteGuardrailRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let guardrail_id = "guardrail_id";
    /// let x = DeleteGuardrailRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/guardrails/{guardrail_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [force][crate::model::DeleteGuardrailRequest::force].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteGuardrailRequest;
    /// let x = DeleteGuardrailRequest::new().set_force(true);
    /// ```
    pub fn set_force<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.force = v.into();
        self
    }

    /// Sets the value of [etag][crate::model::DeleteGuardrailRequest::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteGuardrailRequest;
    /// let x = DeleteGuardrailRequest::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for DeleteGuardrailRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DeleteGuardrailRequest"
    }
}

/// Request message for
/// [AgentService.ListDeployments][google.cloud.ces.v1.AgentService.ListDeployments].
///
/// [google.cloud.ces.v1.AgentService.ListDeployments]: crate::client::AgentService::list_deployments
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListDeploymentsRequest {
    /// Required. The parent app.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}`
    pub parent: std::string::String,

    /// Optional. The maximum number of deployments to return. The service may
    /// return fewer than this value. If unspecified, at most 50 deployments will
    /// be returned. The maximum value is 1000; values above 1000 will be coerced
    /// to 1000.
    pub page_size: i32,

    /// Optional. A page token, received from a previous `ListDeployments` call.
    /// Provide this to retrieve the subsequent page.
    ///
    /// When paginating, all other parameters provided to `ListDeployments` must
    /// match the call that provided the page token.
    pub page_token: std::string::String,

    /// Optional. Field to sort by. Only "name" and "create_time" is supported.
    /// See <https://google.aip.dev/132#ordering> for more details.
    pub order_by: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListDeploymentsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListDeploymentsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListDeploymentsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ListDeploymentsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListDeploymentsRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListDeploymentsRequest;
    /// let x = ListDeploymentsRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListDeploymentsRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListDeploymentsRequest;
    /// let x = ListDeploymentsRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [order_by][crate::model::ListDeploymentsRequest::order_by].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListDeploymentsRequest;
    /// let x = ListDeploymentsRequest::new().set_order_by("example");
    /// ```
    pub fn set_order_by<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.order_by = v.into();
        self
    }
}

impl wkt::message::Message for ListDeploymentsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListDeploymentsRequest"
    }
}

/// Response message for
/// [AgentService.ListDeployments][google.cloud.ces.v1.AgentService.ListDeployments].
///
/// [google.cloud.ces.v1.AgentService.ListDeployments]: crate::client::AgentService::list_deployments
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListDeploymentsResponse {
    /// The list of deployments.
    pub deployments: std::vec::Vec<crate::model::Deployment>,

    /// A token, which can be sent as `page_token` to retrieve the next page.
    /// If this field is omitted, there are no subsequent pages.
    pub next_page_token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListDeploymentsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [deployments][crate::model::ListDeploymentsResponse::deployments].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListDeploymentsResponse;
    /// use google_cloud_ces_v1::model::Deployment;
    /// let x = ListDeploymentsResponse::new()
    ///     .set_deployments([
    ///         Deployment::default()/* use setters */,
    ///         Deployment::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_deployments<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Deployment>,
    {
        use std::iter::Iterator;
        self.deployments = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListDeploymentsResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListDeploymentsResponse;
    /// let x = ListDeploymentsResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }
}

impl wkt::message::Message for ListDeploymentsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListDeploymentsResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListDeploymentsResponse {
    type PageItem = crate::model::Deployment;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.deployments
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetDeployment][google.cloud.ces.v1.AgentService.GetDeployment].
///
/// [google.cloud.ces.v1.AgentService.GetDeployment]: crate::client::AgentService::get_deployment
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetDeploymentRequest {
    /// Required. The name of the deployment.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetDeploymentRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetDeploymentRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetDeploymentRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let deployment_id = "deployment_id";
    /// let x = GetDeploymentRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/deployments/{deployment_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetDeploymentRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetDeploymentRequest"
    }
}

/// Request message for
/// [AgentService.CreateDeployment][google.cloud.ces.v1.AgentService.CreateDeployment].
///
/// [google.cloud.ces.v1.AgentService.CreateDeployment]: crate::client::AgentService::create_deployment
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CreateDeploymentRequest {
    /// Required. The parent app.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}`
    pub parent: std::string::String,

    /// Optional. The ID to use for the deployment, which will become the final
    /// component of the deployment's resource name. If not provided, a unique ID
    /// will be automatically assigned for the deployment.
    pub deployment_id: std::string::String,

    /// Required. The deployment to create.
    pub deployment: std::option::Option<crate::model::Deployment>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CreateDeploymentRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::CreateDeploymentRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateDeploymentRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = CreateDeploymentRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [deployment_id][crate::model::CreateDeploymentRequest::deployment_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateDeploymentRequest;
    /// let x = CreateDeploymentRequest::new().set_deployment_id("example");
    /// ```
    pub fn set_deployment_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.deployment_id = v.into();
        self
    }

    /// Sets the value of [deployment][crate::model::CreateDeploymentRequest::deployment].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateDeploymentRequest;
    /// use google_cloud_ces_v1::model::Deployment;
    /// let x = CreateDeploymentRequest::new().set_deployment(Deployment::default()/* use setters */);
    /// ```
    pub fn set_deployment<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Deployment>,
    {
        self.deployment = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [deployment][crate::model::CreateDeploymentRequest::deployment].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateDeploymentRequest;
    /// use google_cloud_ces_v1::model::Deployment;
    /// let x = CreateDeploymentRequest::new().set_or_clear_deployment(Some(Deployment::default()/* use setters */));
    /// let x = CreateDeploymentRequest::new().set_or_clear_deployment(None::<Deployment>);
    /// ```
    pub fn set_or_clear_deployment<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Deployment>,
    {
        self.deployment = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for CreateDeploymentRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CreateDeploymentRequest"
    }
}

/// Request message for
/// [AgentService.UpdateDeployment][google.cloud.ces.v1.AgentService.UpdateDeployment].
///
/// [google.cloud.ces.v1.AgentService.UpdateDeployment]: crate::client::AgentService::update_deployment
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct UpdateDeploymentRequest {
    /// Required. The deployment to update.
    pub deployment: std::option::Option<crate::model::Deployment>,

    /// Optional. The list of fields to update.
    pub update_mask: std::option::Option<wkt::FieldMask>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl UpdateDeploymentRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [deployment][crate::model::UpdateDeploymentRequest::deployment].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateDeploymentRequest;
    /// use google_cloud_ces_v1::model::Deployment;
    /// let x = UpdateDeploymentRequest::new().set_deployment(Deployment::default()/* use setters */);
    /// ```
    pub fn set_deployment<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Deployment>,
    {
        self.deployment = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [deployment][crate::model::UpdateDeploymentRequest::deployment].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateDeploymentRequest;
    /// use google_cloud_ces_v1::model::Deployment;
    /// let x = UpdateDeploymentRequest::new().set_or_clear_deployment(Some(Deployment::default()/* use setters */));
    /// let x = UpdateDeploymentRequest::new().set_or_clear_deployment(None::<Deployment>);
    /// ```
    pub fn set_or_clear_deployment<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Deployment>,
    {
        self.deployment = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_mask][crate::model::UpdateDeploymentRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateDeploymentRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateDeploymentRequest::new().set_update_mask(FieldMask::default()/* use setters */);
    /// ```
    pub fn set_update_mask<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_mask][crate::model::UpdateDeploymentRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateDeploymentRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateDeploymentRequest::new().set_or_clear_update_mask(Some(FieldMask::default()/* use setters */));
    /// let x = UpdateDeploymentRequest::new().set_or_clear_update_mask(None::<FieldMask>);
    /// ```
    pub fn set_or_clear_update_mask<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for UpdateDeploymentRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.UpdateDeploymentRequest"
    }
}

/// Request message for
/// [AgentService.DeleteDeployment][google.cloud.ces.v1.AgentService.DeleteDeployment].
///
/// [google.cloud.ces.v1.AgentService.DeleteDeployment]: crate::client::AgentService::delete_deployment
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DeleteDeploymentRequest {
    /// Required. The name of the deployment to delete.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`
    pub name: std::string::String,

    /// Optional. The etag of the deployment.
    /// If an etag is provided and does not match the current etag of the
    /// deployment, deletion will be blocked and an ABORTED error will be returned.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DeleteDeploymentRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DeleteDeploymentRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteDeploymentRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let deployment_id = "deployment_id";
    /// let x = DeleteDeploymentRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/deployments/{deployment_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [etag][crate::model::DeleteDeploymentRequest::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteDeploymentRequest;
    /// let x = DeleteDeploymentRequest::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for DeleteDeploymentRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DeleteDeploymentRequest"
    }
}

/// Request message for
/// [AgentService.ListToolsets][google.cloud.ces.v1.AgentService.ListToolsets].
///
/// [google.cloud.ces.v1.AgentService.ListToolsets]: crate::client::AgentService::list_toolsets
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListToolsetsRequest {
    /// Required. The resource name of the app to list toolsets from.
    pub parent: std::string::String,

    /// Optional. Requested page size. Server may return fewer items than
    /// requested. If unspecified, server will pick an appropriate default.
    pub page_size: i32,

    /// Optional. The
    /// [next_page_token][google.cloud.ces.v1.ListToolsetsResponse.next_page_token]
    /// value returned from a previous list
    /// [AgentService.ListToolsets][google.cloud.ces.v1.AgentService.ListToolsets]
    /// call.
    ///
    /// [google.cloud.ces.v1.AgentService.ListToolsets]: crate::client::AgentService::list_toolsets
    /// [google.cloud.ces.v1.ListToolsetsResponse.next_page_token]: crate::model::ListToolsetsResponse::next_page_token
    pub page_token: std::string::String,

    /// Optional. Filter to be applied when listing the toolsets.
    /// See <https://google.aip.dev/160> for more details.
    pub filter: std::string::String,

    /// Optional. Field to sort by. Only "name" and "create_time" is supported.
    /// See <https://google.aip.dev/132#ordering> for more details.
    pub order_by: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListToolsetsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListToolsetsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsetsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ListToolsetsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListToolsetsRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsetsRequest;
    /// let x = ListToolsetsRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListToolsetsRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsetsRequest;
    /// let x = ListToolsetsRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [filter][crate::model::ListToolsetsRequest::filter].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsetsRequest;
    /// let x = ListToolsetsRequest::new().set_filter("example");
    /// ```
    pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.filter = v.into();
        self
    }

    /// Sets the value of [order_by][crate::model::ListToolsetsRequest::order_by].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsetsRequest;
    /// let x = ListToolsetsRequest::new().set_order_by("example");
    /// ```
    pub fn set_order_by<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.order_by = v.into();
        self
    }
}

impl wkt::message::Message for ListToolsetsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListToolsetsRequest"
    }
}

/// Response message for
/// [AgentService.ListToolsets][google.cloud.ces.v1.AgentService.ListToolsets].
///
/// [google.cloud.ces.v1.AgentService.ListToolsets]: crate::client::AgentService::list_toolsets
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListToolsetsResponse {
    /// The list of toolsets.
    pub toolsets: std::vec::Vec<crate::model::Toolset>,

    /// A token that can be sent as
    /// [ListToolsetsRequest.page_token][google.cloud.ces.v1.ListToolsetsRequest.page_token]
    /// to retrieve the next page. Absence of this field indicates there are no
    /// subsequent pages.
    ///
    /// [google.cloud.ces.v1.ListToolsetsRequest.page_token]: crate::model::ListToolsetsRequest::page_token
    pub next_page_token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListToolsetsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [toolsets][crate::model::ListToolsetsResponse::toolsets].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsetsResponse;
    /// use google_cloud_ces_v1::model::Toolset;
    /// let x = ListToolsetsResponse::new()
    ///     .set_toolsets([
    ///         Toolset::default()/* use setters */,
    ///         Toolset::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_toolsets<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Toolset>,
    {
        use std::iter::Iterator;
        self.toolsets = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListToolsetsResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListToolsetsResponse;
    /// let x = ListToolsetsResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }
}

impl wkt::message::Message for ListToolsetsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListToolsetsResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListToolsetsResponse {
    type PageItem = crate::model::Toolset;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.toolsets
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetToolset][google.cloud.ces.v1.AgentService.GetToolset].
///
/// [google.cloud.ces.v1.AgentService.GetToolset]: crate::client::AgentService::get_toolset
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetToolsetRequest {
    /// Required. The resource name of the toolset to retrieve.
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetToolsetRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetToolsetRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetToolsetRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let toolset_id = "toolset_id";
    /// let x = GetToolsetRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/toolsets/{toolset_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetToolsetRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetToolsetRequest"
    }
}

/// Request message for
/// [AgentService.CreateToolset][google.cloud.ces.v1.AgentService.CreateToolset].
///
/// [google.cloud.ces.v1.AgentService.CreateToolset]: crate::client::AgentService::create_toolset
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CreateToolsetRequest {
    /// Required. The resource name of the app to create a toolset in.
    pub parent: std::string::String,

    /// Optional. The ID to use for the toolset, which will become the final
    /// component of the toolset's resource name. If not provided, a unique ID will
    /// be automatically assigned for the toolset.
    pub toolset_id: std::string::String,

    /// Required. The toolset to create.
    pub toolset: std::option::Option<crate::model::Toolset>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CreateToolsetRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::CreateToolsetRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateToolsetRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = CreateToolsetRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [toolset_id][crate::model::CreateToolsetRequest::toolset_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateToolsetRequest;
    /// let x = CreateToolsetRequest::new().set_toolset_id("example");
    /// ```
    pub fn set_toolset_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.toolset_id = v.into();
        self
    }

    /// Sets the value of [toolset][crate::model::CreateToolsetRequest::toolset].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateToolsetRequest;
    /// use google_cloud_ces_v1::model::Toolset;
    /// let x = CreateToolsetRequest::new().set_toolset(Toolset::default()/* use setters */);
    /// ```
    pub fn set_toolset<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Toolset>,
    {
        self.toolset = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [toolset][crate::model::CreateToolsetRequest::toolset].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateToolsetRequest;
    /// use google_cloud_ces_v1::model::Toolset;
    /// let x = CreateToolsetRequest::new().set_or_clear_toolset(Some(Toolset::default()/* use setters */));
    /// let x = CreateToolsetRequest::new().set_or_clear_toolset(None::<Toolset>);
    /// ```
    pub fn set_or_clear_toolset<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Toolset>,
    {
        self.toolset = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for CreateToolsetRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CreateToolsetRequest"
    }
}

/// Request message for
/// [AgentService.UpdateToolset][google.cloud.ces.v1.AgentService.UpdateToolset].
///
/// [google.cloud.ces.v1.AgentService.UpdateToolset]: crate::client::AgentService::update_toolset
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct UpdateToolsetRequest {
    /// Required. The toolset to update.
    pub toolset: std::option::Option<crate::model::Toolset>,

    /// Optional. Field mask is used to control which fields get updated. If the
    /// mask is not present, all fields will be updated.
    pub update_mask: std::option::Option<wkt::FieldMask>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl UpdateToolsetRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [toolset][crate::model::UpdateToolsetRequest::toolset].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateToolsetRequest;
    /// use google_cloud_ces_v1::model::Toolset;
    /// let x = UpdateToolsetRequest::new().set_toolset(Toolset::default()/* use setters */);
    /// ```
    pub fn set_toolset<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Toolset>,
    {
        self.toolset = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [toolset][crate::model::UpdateToolsetRequest::toolset].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateToolsetRequest;
    /// use google_cloud_ces_v1::model::Toolset;
    /// let x = UpdateToolsetRequest::new().set_or_clear_toolset(Some(Toolset::default()/* use setters */));
    /// let x = UpdateToolsetRequest::new().set_or_clear_toolset(None::<Toolset>);
    /// ```
    pub fn set_or_clear_toolset<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Toolset>,
    {
        self.toolset = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_mask][crate::model::UpdateToolsetRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateToolsetRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateToolsetRequest::new().set_update_mask(FieldMask::default()/* use setters */);
    /// ```
    pub fn set_update_mask<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_mask][crate::model::UpdateToolsetRequest::update_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::UpdateToolsetRequest;
    /// use wkt::FieldMask;
    /// let x = UpdateToolsetRequest::new().set_or_clear_update_mask(Some(FieldMask::default()/* use setters */));
    /// let x = UpdateToolsetRequest::new().set_or_clear_update_mask(None::<FieldMask>);
    /// ```
    pub fn set_or_clear_update_mask<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.update_mask = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for UpdateToolsetRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.UpdateToolsetRequest"
    }
}

/// Request message for
/// [AgentService.DeleteToolset][google.cloud.ces.v1.AgentService.DeleteToolset].
///
/// [google.cloud.ces.v1.AgentService.DeleteToolset]: crate::client::AgentService::delete_toolset
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DeleteToolsetRequest {
    /// Required. The resource name of the toolset to delete.
    pub name: std::string::String,

    /// Optional. Indicates whether to forcefully delete the toolset, even if it is
    /// still referenced by app/agents.
    ///
    /// * If `force = false`, the deletion fails if any agents still
    ///   reference the toolset.
    /// * If `force = true`, all existing references from agents will be
    ///   removed and the toolset will be deleted.
    pub force: bool,

    /// Optional. The current etag of the toolset. If an etag is not provided, the
    /// deletion will overwrite any concurrent changes. If an etag is provided and
    /// does not match the current etag of the toolset, deletion will be blocked
    /// and an ABORTED error will be returned.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DeleteToolsetRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DeleteToolsetRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteToolsetRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let toolset_id = "toolset_id";
    /// let x = DeleteToolsetRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/toolsets/{toolset_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [force][crate::model::DeleteToolsetRequest::force].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteToolsetRequest;
    /// let x = DeleteToolsetRequest::new().set_force(true);
    /// ```
    pub fn set_force<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.force = v.into();
        self
    }

    /// Sets the value of [etag][crate::model::DeleteToolsetRequest::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteToolsetRequest;
    /// let x = DeleteToolsetRequest::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for DeleteToolsetRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DeleteToolsetRequest"
    }
}

/// Request message for
/// [AgentService.ListAppVersions][google.cloud.ces.v1.AgentService.ListAppVersions].
///
/// [google.cloud.ces.v1.AgentService.ListAppVersions]: crate::client::AgentService::list_app_versions
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListAppVersionsRequest {
    /// Required. The resource name of the app to list app versions from.
    pub parent: std::string::String,

    /// Optional. Requested page size. Server may return fewer items than
    /// requested. If unspecified, server will pick an appropriate default.
    pub page_size: i32,

    /// Optional. The
    /// [next_page_token][google.cloud.ces.v1.ListAppVersionsResponse.next_page_token]
    /// value returned from a previous list
    /// [AgentService.ListAppVersions][google.cloud.ces.v1.AgentService.ListAppVersions]
    /// call.
    ///
    /// [google.cloud.ces.v1.AgentService.ListAppVersions]: crate::client::AgentService::list_app_versions
    /// [google.cloud.ces.v1.ListAppVersionsResponse.next_page_token]: crate::model::ListAppVersionsResponse::next_page_token
    pub page_token: std::string::String,

    /// Optional. Filter to be applied when listing the app versions.
    /// See <https://google.aip.dev/160> for more details.
    pub filter: std::string::String,

    /// Optional. Field to sort by. Only "name" and "create_time" is supported.
    /// See <https://google.aip.dev/132#ordering> for more details.
    pub order_by: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListAppVersionsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListAppVersionsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppVersionsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ListAppVersionsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListAppVersionsRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppVersionsRequest;
    /// let x = ListAppVersionsRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListAppVersionsRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppVersionsRequest;
    /// let x = ListAppVersionsRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [filter][crate::model::ListAppVersionsRequest::filter].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppVersionsRequest;
    /// let x = ListAppVersionsRequest::new().set_filter("example");
    /// ```
    pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.filter = v.into();
        self
    }

    /// Sets the value of [order_by][crate::model::ListAppVersionsRequest::order_by].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppVersionsRequest;
    /// let x = ListAppVersionsRequest::new().set_order_by("example");
    /// ```
    pub fn set_order_by<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.order_by = v.into();
        self
    }
}

impl wkt::message::Message for ListAppVersionsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListAppVersionsRequest"
    }
}

/// Response message for
/// [AgentService.ListAppVersions][google.cloud.ces.v1.AgentService.ListAppVersions].
///
/// [google.cloud.ces.v1.AgentService.ListAppVersions]: crate::client::AgentService::list_app_versions
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListAppVersionsResponse {
    /// The list of app versions.
    pub app_versions: std::vec::Vec<crate::model::AppVersion>,

    /// A token that can be sent as
    /// [ListAppVersionsRequest.page_token][google.cloud.ces.v1.ListAppVersionsRequest.page_token]
    /// to retrieve the next page. Absence of this field indicates there are no
    /// subsequent pages.
    ///
    /// [google.cloud.ces.v1.ListAppVersionsRequest.page_token]: crate::model::ListAppVersionsRequest::page_token
    pub next_page_token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListAppVersionsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [app_versions][crate::model::ListAppVersionsResponse::app_versions].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppVersionsResponse;
    /// use google_cloud_ces_v1::model::AppVersion;
    /// let x = ListAppVersionsResponse::new()
    ///     .set_app_versions([
    ///         AppVersion::default()/* use setters */,
    ///         AppVersion::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_app_versions<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::AppVersion>,
    {
        use std::iter::Iterator;
        self.app_versions = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListAppVersionsResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListAppVersionsResponse;
    /// let x = ListAppVersionsResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }
}

impl wkt::message::Message for ListAppVersionsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListAppVersionsResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListAppVersionsResponse {
    type PageItem = crate::model::AppVersion;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.app_versions
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetAppVersion][google.cloud.ces.v1.AgentService.GetAppVersion].
///
/// [google.cloud.ces.v1.AgentService.GetAppVersion]: crate::client::AgentService::get_app_version
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetAppVersionRequest {
    /// Required. The resource name of the app version to retrieve.
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetAppVersionRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetAppVersionRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetAppVersionRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let version_id = "version_id";
    /// let x = GetAppVersionRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/versions/{version_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetAppVersionRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetAppVersionRequest"
    }
}

/// Request message for
/// [AgentService.DeleteAppVersion][google.cloud.ces.v1.AgentService.DeleteAppVersion].
///
/// [google.cloud.ces.v1.AgentService.DeleteAppVersion]: crate::client::AgentService::delete_app_version
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DeleteAppVersionRequest {
    /// Required. The resource name of the app version to delete.
    pub name: std::string::String,

    /// Optional. The current etag of the app version. If an etag is not provided,
    /// the deletion will overwrite any concurrent changes. If an etag is provided
    /// and does not match the current etag of the app version, deletion will be
    /// blocked and an ABORTED error will be returned.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DeleteAppVersionRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DeleteAppVersionRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteAppVersionRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let version_id = "version_id";
    /// let x = DeleteAppVersionRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/versions/{version_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [etag][crate::model::DeleteAppVersionRequest::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DeleteAppVersionRequest;
    /// let x = DeleteAppVersionRequest::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for DeleteAppVersionRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DeleteAppVersionRequest"
    }
}

/// Request message for
/// [AgentService.CreateAppVersion][google.cloud.ces.v1.AgentService.CreateAppVersion]
///
/// [google.cloud.ces.v1.AgentService.CreateAppVersion]: crate::client::AgentService::create_app_version
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CreateAppVersionRequest {
    /// Required. The resource name of the app to create an app version in.
    pub parent: std::string::String,

    /// Optional. The ID to use for the app version, which will become the final
    /// component of the app version's resource name. If not provided, a unique ID
    /// will be automatically assigned for the app version.
    pub app_version_id: std::string::String,

    /// Required. The app version to create.
    pub app_version: std::option::Option<crate::model::AppVersion>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CreateAppVersionRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::CreateAppVersionRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAppVersionRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = CreateAppVersionRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [app_version_id][crate::model::CreateAppVersionRequest::app_version_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAppVersionRequest;
    /// let x = CreateAppVersionRequest::new().set_app_version_id("example");
    /// ```
    pub fn set_app_version_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.app_version_id = v.into();
        self
    }

    /// Sets the value of [app_version][crate::model::CreateAppVersionRequest::app_version].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAppVersionRequest;
    /// use google_cloud_ces_v1::model::AppVersion;
    /// let x = CreateAppVersionRequest::new().set_app_version(AppVersion::default()/* use setters */);
    /// ```
    pub fn set_app_version<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::AppVersion>,
    {
        self.app_version = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [app_version][crate::model::CreateAppVersionRequest::app_version].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CreateAppVersionRequest;
    /// use google_cloud_ces_v1::model::AppVersion;
    /// let x = CreateAppVersionRequest::new().set_or_clear_app_version(Some(AppVersion::default()/* use setters */));
    /// let x = CreateAppVersionRequest::new().set_or_clear_app_version(None::<AppVersion>);
    /// ```
    pub fn set_or_clear_app_version<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::AppVersion>,
    {
        self.app_version = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for CreateAppVersionRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CreateAppVersionRequest"
    }
}

/// Request message for
/// [AgentService.RestoreAppVersion][google.cloud.ces.v1.AgentService.RestoreAppVersion]
///
/// [google.cloud.ces.v1.AgentService.RestoreAppVersion]: crate::client::AgentService::restore_app_version
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RestoreAppVersionRequest {
    /// Required. The resource name of the app version to restore.
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RestoreAppVersionRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::RestoreAppVersionRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RestoreAppVersionRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let version_id = "version_id";
    /// let x = RestoreAppVersionRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/versions/{version_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for RestoreAppVersionRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RestoreAppVersionRequest"
    }
}

/// Response message for
/// [AgentService.RestoreAppVersion][google.cloud.ces.v1.AgentService.RestoreAppVersion]
///
/// [google.cloud.ces.v1.AgentService.RestoreAppVersion]: crate::client::AgentService::restore_app_version
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RestoreAppVersionResponse {
    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RestoreAppVersionResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }
}

impl wkt::message::Message for RestoreAppVersionResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RestoreAppVersionResponse"
    }
}

/// Request message for
/// [AgentService.ListChangelogs][google.cloud.ces.v1.AgentService.ListChangelogs].
///
/// [google.cloud.ces.v1.AgentService.ListChangelogs]: crate::client::AgentService::list_changelogs
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListChangelogsRequest {
    /// Required. The resource name of the app to list changelogs from.
    pub parent: std::string::String,

    /// Optional. Requested page size. Server may return fewer items than
    /// requested. If unspecified, server will pick an appropriate default.
    pub page_size: i32,

    /// Optional. The
    /// [next_page_token][google.cloud.ces.v1.ListChangelogsResponse.next_page_token]
    /// value returned from a previous list
    /// [AgentService.ListChangelogs][google.cloud.ces.v1.AgentService.ListChangelogs]
    /// call.
    ///
    /// [google.cloud.ces.v1.AgentService.ListChangelogs]: crate::client::AgentService::list_changelogs
    /// [google.cloud.ces.v1.ListChangelogsResponse.next_page_token]: crate::model::ListChangelogsResponse::next_page_token
    pub page_token: std::string::String,

    /// Optional. Filter to be applied when listing the changelogs.
    /// See <https://google.aip.dev/160> for more details.
    ///
    /// The filter string can be used to filter by `action`, `resource_type`,
    /// `resource_name`, `author`, and `create_time`.
    /// The `:` comparator can be used for case-insensitive partial matching on
    /// string fields, while `=` performs an exact case-sensitive match.
    ///
    /// Examples:
    ///
    /// * `action:update` (case-insensitive partial match)
    /// * `action="Create"` (case-sensitive exact match)
    /// * `resource_type:agent`
    /// * `resource_name:my-agent`
    /// * `author:me@example.com`
    /// * `create_time > "2025-01-01T00:00:00Z"`
    /// * `create_time <= "2025-01-01T00:00:00Z" AND resource_type:tool`
    pub filter: std::string::String,

    /// Optional. Field to sort by. Only "name" and "create_time" is supported.
    /// See <https://google.aip.dev/132#ordering> for more details.
    pub order_by: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListChangelogsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ListChangelogsRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListChangelogsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ListChangelogsRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [page_size][crate::model::ListChangelogsRequest::page_size].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListChangelogsRequest;
    /// let x = ListChangelogsRequest::new().set_page_size(42);
    /// ```
    pub fn set_page_size<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.page_size = v.into();
        self
    }

    /// Sets the value of [page_token][crate::model::ListChangelogsRequest::page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListChangelogsRequest;
    /// let x = ListChangelogsRequest::new().set_page_token("example");
    /// ```
    pub fn set_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.page_token = v.into();
        self
    }

    /// Sets the value of [filter][crate::model::ListChangelogsRequest::filter].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListChangelogsRequest;
    /// let x = ListChangelogsRequest::new().set_filter("example");
    /// ```
    pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.filter = v.into();
        self
    }

    /// Sets the value of [order_by][crate::model::ListChangelogsRequest::order_by].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListChangelogsRequest;
    /// let x = ListChangelogsRequest::new().set_order_by("example");
    /// ```
    pub fn set_order_by<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.order_by = v.into();
        self
    }
}

impl wkt::message::Message for ListChangelogsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListChangelogsRequest"
    }
}

/// Response message for
/// [AgentService.ListChangelogs][google.cloud.ces.v1.AgentService.ListChangelogs].
///
/// [google.cloud.ces.v1.AgentService.ListChangelogs]: crate::client::AgentService::list_changelogs
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ListChangelogsResponse {
    /// The list of changelogs.
    pub changelogs: std::vec::Vec<crate::model::Changelog>,

    /// A token that can be sent as
    /// [ListChangelogsRequest.page_token][google.cloud.ces.v1.ListChangelogsRequest.page_token]
    /// to retrieve the next page. Absence of this field indicates there are no
    /// subsequent pages.
    ///
    /// [google.cloud.ces.v1.ListChangelogsRequest.page_token]: crate::model::ListChangelogsRequest::page_token
    pub next_page_token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ListChangelogsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [changelogs][crate::model::ListChangelogsResponse::changelogs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListChangelogsResponse;
    /// use google_cloud_ces_v1::model::Changelog;
    /// let x = ListChangelogsResponse::new()
    ///     .set_changelogs([
    ///         Changelog::default()/* use setters */,
    ///         Changelog::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_changelogs<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Changelog>,
    {
        use std::iter::Iterator;
        self.changelogs = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [next_page_token][crate::model::ListChangelogsResponse::next_page_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ListChangelogsResponse;
    /// let x = ListChangelogsResponse::new().set_next_page_token("example");
    /// ```
    pub fn set_next_page_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.next_page_token = v.into();
        self
    }
}

impl wkt::message::Message for ListChangelogsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ListChangelogsResponse"
    }
}

#[doc(hidden)]
impl google_cloud_gax::paginator::internal::PageableResponse for ListChangelogsResponse {
    type PageItem = crate::model::Changelog;

    fn items(self) -> std::vec::Vec<Self::PageItem> {
        self.changelogs
    }

    fn next_page_token(&self) -> std::string::String {
        use std::clone::Clone;
        self.next_page_token.clone()
    }
}

/// Request message for
/// [AgentService.GetChangelog][google.cloud.ces.v1.AgentService.GetChangelog].
///
/// [google.cloud.ces.v1.AgentService.GetChangelog]: crate::client::AgentService::get_changelog
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetChangelogRequest {
    /// Required. The resource name of the changelog to retrieve.
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetChangelogRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetChangelogRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GetChangelogRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let changelog_id = "changelog_id";
    /// let x = GetChangelogRequest::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/changelogs/{changelog_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetChangelogRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GetChangelogRequest"
    }
}

/// Represents a tool that allows the agent to call another agent.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AgentTool {
    /// Required. The name of the agent tool.
    pub name: std::string::String,

    /// Optional. Description of the tool's purpose.
    pub description: std::string::String,

    /// Optional. The resource name of the root agent that is the entry point of
    /// the tool. Format: `projects/{project}/locations/{location}/agents/{agent}`
    pub root_agent: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AgentTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::AgentTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentTool;
    /// let x = AgentTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::AgentTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentTool;
    /// let x = AgentTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [root_agent][crate::model::AgentTool::root_agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentTool;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = AgentTool::new().set_root_agent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_root_agent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.root_agent = v.into();
        self
    }
}

impl wkt::message::Message for AgentTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AgentTool"
    }
}

/// Expression condition based on session state.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ExpressionCondition {
    /// Required. The string representation of cloud.api.Expression condition.
    pub expression: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ExpressionCondition {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [expression][crate::model::ExpressionCondition::expression].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExpressionCondition;
    /// let x = ExpressionCondition::new().set_expression("example");
    /// ```
    pub fn set_expression<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.expression = v.into();
        self
    }
}

impl wkt::message::Message for ExpressionCondition {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ExpressionCondition"
    }
}

/// Python code block to evaluate the condition.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct PythonCodeCondition {
    /// Required. The python code to execute.
    pub python_code: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl PythonCodeCondition {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [python_code][crate::model::PythonCodeCondition::python_code].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::PythonCodeCondition;
    /// let x = PythonCodeCondition::new().set_python_code("example");
    /// ```
    pub fn set_python_code<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.python_code = v.into();
        self
    }
}

impl wkt::message::Message for PythonCodeCondition {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.PythonCodeCondition"
    }
}

/// Rule for transferring to a specific agent.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct TransferRule {
    /// Required. The resource name of the child agent the rule applies to.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
    pub child_agent: std::string::String,

    /// Required. The direction of the transfer.
    pub direction: crate::model::transfer_rule::Direction,

    /// The rule type.
    pub rule_type: std::option::Option<crate::model::transfer_rule::RuleType>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl TransferRule {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [child_agent][crate::model::TransferRule::child_agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TransferRule;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = TransferRule::new().set_child_agent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_child_agent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.child_agent = v.into();
        self
    }

    /// Sets the value of [direction][crate::model::TransferRule::direction].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TransferRule;
    /// use google_cloud_ces_v1::model::transfer_rule::Direction;
    /// let x0 = TransferRule::new().set_direction(Direction::ParentToChild);
    /// let x1 = TransferRule::new().set_direction(Direction::ChildToParent);
    /// ```
    pub fn set_direction<T: std::convert::Into<crate::model::transfer_rule::Direction>>(
        mut self,
        v: T,
    ) -> Self {
        self.direction = v.into();
        self
    }

    /// Sets the value of [rule_type][crate::model::TransferRule::rule_type].
    ///
    /// Note that all the setters affecting `rule_type` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TransferRule;
    /// use google_cloud_ces_v1::model::transfer_rule::DeterministicTransfer;
    /// let x = TransferRule::new().set_rule_type(Some(
    ///     google_cloud_ces_v1::model::transfer_rule::RuleType::DeterministicTransfer(DeterministicTransfer::default().into())));
    /// ```
    pub fn set_rule_type<
        T: std::convert::Into<std::option::Option<crate::model::transfer_rule::RuleType>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.rule_type = v.into();
        self
    }

    /// The value of [rule_type][crate::model::TransferRule::rule_type]
    /// if it holds a `DeterministicTransfer`, `None` if the field is not set or
    /// holds a different branch.
    pub fn deterministic_transfer(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::transfer_rule::DeterministicTransfer>>
    {
        #[allow(unreachable_patterns)]
        self.rule_type.as_ref().and_then(|v| match v {
            crate::model::transfer_rule::RuleType::DeterministicTransfer(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [rule_type][crate::model::TransferRule::rule_type]
    /// to hold a `DeterministicTransfer`.
    ///
    /// Note that all the setters affecting `rule_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TransferRule;
    /// use google_cloud_ces_v1::model::transfer_rule::DeterministicTransfer;
    /// let x = TransferRule::new().set_deterministic_transfer(DeterministicTransfer::default()/* use setters */);
    /// assert!(x.deterministic_transfer().is_some());
    /// assert!(x.disable_planner_transfer().is_none());
    /// ```
    pub fn set_deterministic_transfer<
        T: std::convert::Into<std::boxed::Box<crate::model::transfer_rule::DeterministicTransfer>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.rule_type = std::option::Option::Some(
            crate::model::transfer_rule::RuleType::DeterministicTransfer(v.into()),
        );
        self
    }

    /// The value of [rule_type][crate::model::TransferRule::rule_type]
    /// if it holds a `DisablePlannerTransfer`, `None` if the field is not set or
    /// holds a different branch.
    pub fn disable_planner_transfer(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::transfer_rule::DisablePlannerTransfer>>
    {
        #[allow(unreachable_patterns)]
        self.rule_type.as_ref().and_then(|v| match v {
            crate::model::transfer_rule::RuleType::DisablePlannerTransfer(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [rule_type][crate::model::TransferRule::rule_type]
    /// to hold a `DisablePlannerTransfer`.
    ///
    /// Note that all the setters affecting `rule_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TransferRule;
    /// use google_cloud_ces_v1::model::transfer_rule::DisablePlannerTransfer;
    /// let x = TransferRule::new().set_disable_planner_transfer(DisablePlannerTransfer::default()/* use setters */);
    /// assert!(x.disable_planner_transfer().is_some());
    /// assert!(x.deterministic_transfer().is_none());
    /// ```
    pub fn set_disable_planner_transfer<
        T: std::convert::Into<std::boxed::Box<crate::model::transfer_rule::DisablePlannerTransfer>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.rule_type = std::option::Option::Some(
            crate::model::transfer_rule::RuleType::DisablePlannerTransfer(v.into()),
        );
        self
    }
}

impl wkt::message::Message for TransferRule {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.TransferRule"
    }
}

/// Defines additional types related to [TransferRule].
pub mod transfer_rule {
    #[allow(unused_imports)]
    use super::*;

    /// Deterministic transfer rule. When the condition evaluates to true, the
    /// transfer occurs.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct DeterministicTransfer {
        /// The condition to evaluate.
        pub condition_type:
            std::option::Option<crate::model::transfer_rule::deterministic_transfer::ConditionType>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl DeterministicTransfer {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [condition_type][crate::model::transfer_rule::DeterministicTransfer::condition_type].
        ///
        /// Note that all the setters affecting `condition_type` are mutually
        /// exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::transfer_rule::DeterministicTransfer;
        /// use google_cloud_ces_v1::model::ExpressionCondition;
        /// let x = DeterministicTransfer::new().set_condition_type(Some(
        ///     google_cloud_ces_v1::model::transfer_rule::deterministic_transfer::ConditionType::ExpressionCondition(ExpressionCondition::default().into())));
        /// ```
        pub fn set_condition_type<
            T: std::convert::Into<
                    std::option::Option<
                        crate::model::transfer_rule::deterministic_transfer::ConditionType,
                    >,
                >,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.condition_type = v.into();
            self
        }

        /// The value of [condition_type][crate::model::transfer_rule::DeterministicTransfer::condition_type]
        /// if it holds a `ExpressionCondition`, `None` if the field is not set or
        /// holds a different branch.
        pub fn expression_condition(
            &self,
        ) -> std::option::Option<&std::boxed::Box<crate::model::ExpressionCondition>> {
            #[allow(unreachable_patterns)]
            self.condition_type.as_ref().and_then(|v| match v {
                crate::model::transfer_rule::deterministic_transfer::ConditionType::ExpressionCondition(v) => std::option::Option::Some(v),
                _ => std::option::Option::None,
            })
        }

        /// Sets the value of [condition_type][crate::model::transfer_rule::DeterministicTransfer::condition_type]
        /// to hold a `ExpressionCondition`.
        ///
        /// Note that all the setters affecting `condition_type` are
        /// mutually exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::transfer_rule::DeterministicTransfer;
        /// use google_cloud_ces_v1::model::ExpressionCondition;
        /// let x = DeterministicTransfer::new().set_expression_condition(ExpressionCondition::default()/* use setters */);
        /// assert!(x.expression_condition().is_some());
        /// assert!(x.python_code_condition().is_none());
        /// ```
        pub fn set_expression_condition<
            T: std::convert::Into<std::boxed::Box<crate::model::ExpressionCondition>>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.condition_type = std::option::Option::Some(
                crate::model::transfer_rule::deterministic_transfer::ConditionType::ExpressionCondition(
                    v.into()
                )
            );
            self
        }

        /// The value of [condition_type][crate::model::transfer_rule::DeterministicTransfer::condition_type]
        /// if it holds a `PythonCodeCondition`, `None` if the field is not set or
        /// holds a different branch.
        pub fn python_code_condition(
            &self,
        ) -> std::option::Option<&std::boxed::Box<crate::model::PythonCodeCondition>> {
            #[allow(unreachable_patterns)]
            self.condition_type.as_ref().and_then(|v| match v {
                crate::model::transfer_rule::deterministic_transfer::ConditionType::PythonCodeCondition(v) => std::option::Option::Some(v),
                _ => std::option::Option::None,
            })
        }

        /// Sets the value of [condition_type][crate::model::transfer_rule::DeterministicTransfer::condition_type]
        /// to hold a `PythonCodeCondition`.
        ///
        /// Note that all the setters affecting `condition_type` are
        /// mutually exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::transfer_rule::DeterministicTransfer;
        /// use google_cloud_ces_v1::model::PythonCodeCondition;
        /// let x = DeterministicTransfer::new().set_python_code_condition(PythonCodeCondition::default()/* use setters */);
        /// assert!(x.python_code_condition().is_some());
        /// assert!(x.expression_condition().is_none());
        /// ```
        pub fn set_python_code_condition<
            T: std::convert::Into<std::boxed::Box<crate::model::PythonCodeCondition>>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.condition_type = std::option::Option::Some(
                crate::model::transfer_rule::deterministic_transfer::ConditionType::PythonCodeCondition(
                    v.into()
                )
            );
            self
        }
    }

    impl wkt::message::Message for DeterministicTransfer {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.TransferRule.DeterministicTransfer"
        }
    }

    /// Defines additional types related to [DeterministicTransfer].
    pub mod deterministic_transfer {
        #[allow(unused_imports)]
        use super::*;

        /// The condition to evaluate.
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum ConditionType {
            /// Optional. A rule that evaluates a session state condition.
            /// If the condition evaluates to true, the transfer occurs.
            ExpressionCondition(std::boxed::Box<crate::model::ExpressionCondition>),
            /// Optional. A rule that uses Python code block to evaluate the
            /// conditions. If the condition evaluates to true, the transfer occurs.
            PythonCodeCondition(std::boxed::Box<crate::model::PythonCodeCondition>),
        }
    }

    /// A rule that prevents the planner from transferring to the target agent.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct DisablePlannerTransfer {
        /// Required. If the condition evaluates to true, planner will not be allowed
        /// to transfer to the target agent.
        pub expression_condition: std::option::Option<crate::model::ExpressionCondition>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl DisablePlannerTransfer {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [expression_condition][crate::model::transfer_rule::DisablePlannerTransfer::expression_condition].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::transfer_rule::DisablePlannerTransfer;
        /// use google_cloud_ces_v1::model::ExpressionCondition;
        /// let x = DisablePlannerTransfer::new().set_expression_condition(ExpressionCondition::default()/* use setters */);
        /// ```
        pub fn set_expression_condition<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::ExpressionCondition>,
        {
            self.expression_condition = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [expression_condition][crate::model::transfer_rule::DisablePlannerTransfer::expression_condition].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::transfer_rule::DisablePlannerTransfer;
        /// use google_cloud_ces_v1::model::ExpressionCondition;
        /// let x = DisablePlannerTransfer::new().set_or_clear_expression_condition(Some(ExpressionCondition::default()/* use setters */));
        /// let x = DisablePlannerTransfer::new().set_or_clear_expression_condition(None::<ExpressionCondition>);
        /// ```
        pub fn set_or_clear_expression_condition<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::ExpressionCondition>,
        {
            self.expression_condition = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for DisablePlannerTransfer {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.TransferRule.DisablePlannerTransfer"
        }
    }

    /// The direction of the transfer.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum Direction {
        /// Unspecified direction.
        Unspecified,
        /// Transfer from the parent agent to the child agent.
        ParentToChild,
        /// Transfer from the child agent to the parent agent.
        ChildToParent,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [Direction::value] or
        /// [Direction::name].
        UnknownValue(direction::UnknownValue),
    }

    #[doc(hidden)]
    pub mod direction {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl Direction {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::ParentToChild => std::option::Option::Some(1),
                Self::ChildToParent => std::option::Option::Some(2),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("DIRECTION_UNSPECIFIED"),
                Self::ParentToChild => std::option::Option::Some("PARENT_TO_CHILD"),
                Self::ChildToParent => std::option::Option::Some("CHILD_TO_PARENT"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for Direction {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for Direction {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for Direction {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::ParentToChild,
                2 => Self::ChildToParent,
                _ => Self::UnknownValue(direction::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for Direction {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "DIRECTION_UNSPECIFIED" => Self::Unspecified,
                "PARENT_TO_CHILD" => Self::ParentToChild,
                "CHILD_TO_PARENT" => Self::ChildToParent,
                _ => Self::UnknownValue(direction::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for Direction {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::ParentToChild => serializer.serialize_i32(1),
                Self::ChildToParent => serializer.serialize_i32(2),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for Direction {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<Direction>::new(
                ".google.cloud.ces.v1.TransferRule.Direction",
            ))
        }
    }

    /// The rule type.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum RuleType {
        /// Optional. A rule that immediately transfers to the target agent when the
        /// condition is met.
        DeterministicTransfer(std::boxed::Box<crate::model::transfer_rule::DeterministicTransfer>),
        /// Optional. Rule that prevents the planner from transferring to the target
        /// agent.
        DisablePlannerTransfer(
            std::boxed::Box<crate::model::transfer_rule::DisablePlannerTransfer>,
        ),
    }
}

/// An app serves as a top-level container for a group of agents, including the
/// root agent and its sub-agents, along with their associated configurations.
/// These agents work together to achieve specific goals within the app's
/// context.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct App {
    /// Identifier. The unique identifier of the app.
    /// Format: `projects/{project}/locations/{location}/apps/{app}`
    pub name: std::string::String,

    /// Required. Display name of the app.
    pub display_name: std::string::String,

    /// Optional. Human-readable description of the app.
    pub description: std::string::String,

    /// Optional. Whether the app is pinned in the app list.
    pub pinned: bool,

    /// Optional. The root agent is the entry point of the app.
    /// Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
    pub root_agent: std::string::String,

    /// Optional. Language settings of the app.
    pub language_settings: std::option::Option<crate::model::LanguageSettings>,

    /// Optional. TimeZone settings of the app.
    pub time_zone_settings: std::option::Option<crate::model::TimeZoneSettings>,

    /// Optional. Audio processing configuration of the app.
    pub audio_processing_config: std::option::Option<crate::model::AudioProcessingConfig>,

    /// Optional. Logging settings of the app.
    pub logging_settings: std::option::Option<crate::model::LoggingSettings>,

    /// Optional. Error handling settings of the app.
    pub error_handling_settings: std::option::Option<crate::model::ErrorHandlingSettings>,

    /// Optional. The default LLM model settings for the app.
    /// Individual resources (e.g. agents, guardrails) can override these
    /// configurations as needed.
    pub model_settings: std::option::Option<crate::model::ModelSettings>,

    /// Optional. The tool execution mode for the app. If not provided, will
    /// default to PARALLEL.
    pub tool_execution_mode: crate::model::app::ToolExecutionMode,

    /// Optional. The evaluation thresholds for the app.
    pub evaluation_metrics_thresholds:
        std::option::Option<crate::model::EvaluationMetricsThresholds>,

    /// Optional. The declarations of the variables.
    pub variable_declarations: std::vec::Vec<crate::model::app::VariableDeclaration>,

    /// Output only. The declarations of predefined variables for the app.
    pub predefined_variable_declarations: std::vec::Vec<crate::model::app::VariableDeclaration>,

    /// Optional. Instructions for all the agents in the app.
    /// You can use this instruction to set up a stable identity or personality
    /// across all the agents.
    pub global_instruction: std::string::String,

    /// Optional. List of guardrails for the app.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}`
    pub guardrails: std::vec::Vec<std::string::String>,

    /// Optional. The data store settings for the app.
    pub data_store_settings: std::option::Option<crate::model::DataStoreSettings>,

    /// Optional. The default channel profile used by the app.
    pub default_channel_profile: std::option::Option<crate::model::ChannelProfile>,

    /// Optional. Metadata about the app. This field can be used to store
    /// additional information relevant to the app's details or intended usages.
    pub metadata: std::collections::HashMap<std::string::String, std::string::String>,

    /// Output only. Timestamp when the app was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Timestamp when the app was last updated.
    pub update_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Etag used to ensure the object hasn't changed during a
    /// read-modify-write operation. If the etag is empty, the update will
    /// overwrite any concurrent changes.
    pub etag: std::string::String,

    /// Output only. Number of deployments in the app.
    pub deployment_count: i32,

    /// Optional. The default client certificate settings for the app.
    pub client_certificate_settings: std::option::Option<crate::model::ClientCertificateSettings>,

    /// Optional. VPC-SC settings for the app.
    pub vpc_sc_settings: std::option::Option<crate::model::VpcScSettings>,

    /// Optional. Indicates whether the app is locked for changes. If the app is
    /// locked, modifications to the app resources will be rejected.
    pub locked: bool,

    /// Output only. Misconfigurations or warnings in the app.
    pub validation_errors: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl App {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::App::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = App::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::App::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::App::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [pinned][crate::model::App::pinned].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_pinned(true);
    /// ```
    pub fn set_pinned<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.pinned = v.into();
        self
    }

    /// Sets the value of [root_agent][crate::model::App::root_agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = App::new().set_root_agent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_root_agent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.root_agent = v.into();
        self
    }

    /// Sets the value of [language_settings][crate::model::App::language_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::LanguageSettings;
    /// let x = App::new().set_language_settings(LanguageSettings::default()/* use setters */);
    /// ```
    pub fn set_language_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::LanguageSettings>,
    {
        self.language_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [language_settings][crate::model::App::language_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::LanguageSettings;
    /// let x = App::new().set_or_clear_language_settings(Some(LanguageSettings::default()/* use setters */));
    /// let x = App::new().set_or_clear_language_settings(None::<LanguageSettings>);
    /// ```
    pub fn set_or_clear_language_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::LanguageSettings>,
    {
        self.language_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [time_zone_settings][crate::model::App::time_zone_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::TimeZoneSettings;
    /// let x = App::new().set_time_zone_settings(TimeZoneSettings::default()/* use setters */);
    /// ```
    pub fn set_time_zone_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TimeZoneSettings>,
    {
        self.time_zone_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [time_zone_settings][crate::model::App::time_zone_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::TimeZoneSettings;
    /// let x = App::new().set_or_clear_time_zone_settings(Some(TimeZoneSettings::default()/* use setters */));
    /// let x = App::new().set_or_clear_time_zone_settings(None::<TimeZoneSettings>);
    /// ```
    pub fn set_or_clear_time_zone_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TimeZoneSettings>,
    {
        self.time_zone_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [audio_processing_config][crate::model::App::audio_processing_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::AudioProcessingConfig;
    /// let x = App::new().set_audio_processing_config(AudioProcessingConfig::default()/* use setters */);
    /// ```
    pub fn set_audio_processing_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::AudioProcessingConfig>,
    {
        self.audio_processing_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [audio_processing_config][crate::model::App::audio_processing_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::AudioProcessingConfig;
    /// let x = App::new().set_or_clear_audio_processing_config(Some(AudioProcessingConfig::default()/* use setters */));
    /// let x = App::new().set_or_clear_audio_processing_config(None::<AudioProcessingConfig>);
    /// ```
    pub fn set_or_clear_audio_processing_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::AudioProcessingConfig>,
    {
        self.audio_processing_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [logging_settings][crate::model::App::logging_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::LoggingSettings;
    /// let x = App::new().set_logging_settings(LoggingSettings::default()/* use setters */);
    /// ```
    pub fn set_logging_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::LoggingSettings>,
    {
        self.logging_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [logging_settings][crate::model::App::logging_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::LoggingSettings;
    /// let x = App::new().set_or_clear_logging_settings(Some(LoggingSettings::default()/* use setters */));
    /// let x = App::new().set_or_clear_logging_settings(None::<LoggingSettings>);
    /// ```
    pub fn set_or_clear_logging_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::LoggingSettings>,
    {
        self.logging_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [error_handling_settings][crate::model::App::error_handling_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::ErrorHandlingSettings;
    /// let x = App::new().set_error_handling_settings(ErrorHandlingSettings::default()/* use setters */);
    /// ```
    pub fn set_error_handling_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ErrorHandlingSettings>,
    {
        self.error_handling_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [error_handling_settings][crate::model::App::error_handling_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::ErrorHandlingSettings;
    /// let x = App::new().set_or_clear_error_handling_settings(Some(ErrorHandlingSettings::default()/* use setters */));
    /// let x = App::new().set_or_clear_error_handling_settings(None::<ErrorHandlingSettings>);
    /// ```
    pub fn set_or_clear_error_handling_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ErrorHandlingSettings>,
    {
        self.error_handling_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [model_settings][crate::model::App::model_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::ModelSettings;
    /// let x = App::new().set_model_settings(ModelSettings::default()/* use setters */);
    /// ```
    pub fn set_model_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ModelSettings>,
    {
        self.model_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [model_settings][crate::model::App::model_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::ModelSettings;
    /// let x = App::new().set_or_clear_model_settings(Some(ModelSettings::default()/* use setters */));
    /// let x = App::new().set_or_clear_model_settings(None::<ModelSettings>);
    /// ```
    pub fn set_or_clear_model_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ModelSettings>,
    {
        self.model_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tool_execution_mode][crate::model::App::tool_execution_mode].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::app::ToolExecutionMode;
    /// let x0 = App::new().set_tool_execution_mode(ToolExecutionMode::Parallel);
    /// let x1 = App::new().set_tool_execution_mode(ToolExecutionMode::Sequential);
    /// ```
    pub fn set_tool_execution_mode<T: std::convert::Into<crate::model::app::ToolExecutionMode>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_execution_mode = v.into();
        self
    }

    /// Sets the value of [evaluation_metrics_thresholds][crate::model::App::evaluation_metrics_thresholds].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::EvaluationMetricsThresholds;
    /// let x = App::new().set_evaluation_metrics_thresholds(EvaluationMetricsThresholds::default()/* use setters */);
    /// ```
    pub fn set_evaluation_metrics_thresholds<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::EvaluationMetricsThresholds>,
    {
        self.evaluation_metrics_thresholds = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [evaluation_metrics_thresholds][crate::model::App::evaluation_metrics_thresholds].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::EvaluationMetricsThresholds;
    /// let x = App::new().set_or_clear_evaluation_metrics_thresholds(Some(EvaluationMetricsThresholds::default()/* use setters */));
    /// let x = App::new().set_or_clear_evaluation_metrics_thresholds(None::<EvaluationMetricsThresholds>);
    /// ```
    pub fn set_or_clear_evaluation_metrics_thresholds<T>(
        mut self,
        v: std::option::Option<T>,
    ) -> Self
    where
        T: std::convert::Into<crate::model::EvaluationMetricsThresholds>,
    {
        self.evaluation_metrics_thresholds = v.map(|x| x.into());
        self
    }

    /// Sets the value of [variable_declarations][crate::model::App::variable_declarations].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::app::VariableDeclaration;
    /// let x = App::new()
    ///     .set_variable_declarations([
    ///         VariableDeclaration::default()/* use setters */,
    ///         VariableDeclaration::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_variable_declarations<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::app::VariableDeclaration>,
    {
        use std::iter::Iterator;
        self.variable_declarations = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [predefined_variable_declarations][crate::model::App::predefined_variable_declarations].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::app::VariableDeclaration;
    /// let x = App::new()
    ///     .set_predefined_variable_declarations([
    ///         VariableDeclaration::default()/* use setters */,
    ///         VariableDeclaration::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_predefined_variable_declarations<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::app::VariableDeclaration>,
    {
        use std::iter::Iterator;
        self.predefined_variable_declarations = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [global_instruction][crate::model::App::global_instruction].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_global_instruction("example");
    /// ```
    pub fn set_global_instruction<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.global_instruction = v.into();
        self
    }

    /// Sets the value of [guardrails][crate::model::App::guardrails].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_guardrails(["a", "b", "c"]);
    /// ```
    pub fn set_guardrails<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.guardrails = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [data_store_settings][crate::model::App::data_store_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::DataStoreSettings;
    /// let x = App::new().set_data_store_settings(DataStoreSettings::default()/* use setters */);
    /// ```
    pub fn set_data_store_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::DataStoreSettings>,
    {
        self.data_store_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [data_store_settings][crate::model::App::data_store_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::DataStoreSettings;
    /// let x = App::new().set_or_clear_data_store_settings(Some(DataStoreSettings::default()/* use setters */));
    /// let x = App::new().set_or_clear_data_store_settings(None::<DataStoreSettings>);
    /// ```
    pub fn set_or_clear_data_store_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::DataStoreSettings>,
    {
        self.data_store_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [default_channel_profile][crate::model::App::default_channel_profile].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::ChannelProfile;
    /// let x = App::new().set_default_channel_profile(ChannelProfile::default()/* use setters */);
    /// ```
    pub fn set_default_channel_profile<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ChannelProfile>,
    {
        self.default_channel_profile = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [default_channel_profile][crate::model::App::default_channel_profile].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::ChannelProfile;
    /// let x = App::new().set_or_clear_default_channel_profile(Some(ChannelProfile::default()/* use setters */));
    /// let x = App::new().set_or_clear_default_channel_profile(None::<ChannelProfile>);
    /// ```
    pub fn set_or_clear_default_channel_profile<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ChannelProfile>,
    {
        self.default_channel_profile = v.map(|x| x.into());
        self
    }

    /// Sets the value of [metadata][crate::model::App::metadata].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_metadata([
    ///     ("key0", "abc"),
    ///     ("key1", "xyz"),
    /// ]);
    /// ```
    pub fn set_metadata<T, K, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = (K, V)>,
        K: std::convert::Into<std::string::String>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.metadata = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
        self
    }

    /// Sets the value of [create_time][crate::model::App::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use wkt::Timestamp;
    /// let x = App::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::App::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use wkt::Timestamp;
    /// let x = App::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = App::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::App::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use wkt::Timestamp;
    /// let x = App::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::App::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use wkt::Timestamp;
    /// let x = App::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = App::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [etag][crate::model::App::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }

    /// Sets the value of [deployment_count][crate::model::App::deployment_count].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_deployment_count(42);
    /// ```
    pub fn set_deployment_count<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.deployment_count = v.into();
        self
    }

    /// Sets the value of [client_certificate_settings][crate::model::App::client_certificate_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::ClientCertificateSettings;
    /// let x = App::new().set_client_certificate_settings(ClientCertificateSettings::default()/* use setters */);
    /// ```
    pub fn set_client_certificate_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ClientCertificateSettings>,
    {
        self.client_certificate_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [client_certificate_settings][crate::model::App::client_certificate_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::ClientCertificateSettings;
    /// let x = App::new().set_or_clear_client_certificate_settings(Some(ClientCertificateSettings::default()/* use setters */));
    /// let x = App::new().set_or_clear_client_certificate_settings(None::<ClientCertificateSettings>);
    /// ```
    pub fn set_or_clear_client_certificate_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ClientCertificateSettings>,
    {
        self.client_certificate_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [vpc_sc_settings][crate::model::App::vpc_sc_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::VpcScSettings;
    /// let x = App::new().set_vpc_sc_settings(VpcScSettings::default()/* use setters */);
    /// ```
    pub fn set_vpc_sc_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::VpcScSettings>,
    {
        self.vpc_sc_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [vpc_sc_settings][crate::model::App::vpc_sc_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// use google_cloud_ces_v1::model::VpcScSettings;
    /// let x = App::new().set_or_clear_vpc_sc_settings(Some(VpcScSettings::default()/* use setters */));
    /// let x = App::new().set_or_clear_vpc_sc_settings(None::<VpcScSettings>);
    /// ```
    pub fn set_or_clear_vpc_sc_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::VpcScSettings>,
    {
        self.vpc_sc_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [locked][crate::model::App::locked].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_locked(true);
    /// ```
    pub fn set_locked<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.locked = v.into();
        self
    }

    /// Sets the value of [validation_errors][crate::model::App::validation_errors].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::App;
    /// let x = App::new().set_validation_errors(["a", "b", "c"]);
    /// ```
    pub fn set_validation_errors<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.validation_errors = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for App {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.App"
    }
}

/// Defines additional types related to [App].
pub mod app {
    #[allow(unused_imports)]
    use super::*;

    /// Defines the structure and metadata for a variable.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct VariableDeclaration {
        /// Required. The name of the variable. The name must start with a letter or
        /// underscore and contain only letters, numbers, or underscores.
        pub name: std::string::String,

        /// Required. The description of the variable.
        pub description: std::string::String,

        /// Required. The schema of the variable.
        pub schema: std::option::Option<crate::model::Schema>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl VariableDeclaration {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [name][crate::model::app::VariableDeclaration::name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::app::VariableDeclaration;
        /// let x = VariableDeclaration::new().set_name("example");
        /// ```
        pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.name = v.into();
            self
        }

        /// Sets the value of [description][crate::model::app::VariableDeclaration::description].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::app::VariableDeclaration;
        /// let x = VariableDeclaration::new().set_description("example");
        /// ```
        pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.description = v.into();
            self
        }

        /// Sets the value of [schema][crate::model::app::VariableDeclaration::schema].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::app::VariableDeclaration;
        /// use google_cloud_ces_v1::model::Schema;
        /// let x = VariableDeclaration::new().set_schema(Schema::default()/* use setters */);
        /// ```
        pub fn set_schema<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::Schema>,
        {
            self.schema = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [schema][crate::model::app::VariableDeclaration::schema].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::app::VariableDeclaration;
        /// use google_cloud_ces_v1::model::Schema;
        /// let x = VariableDeclaration::new().set_or_clear_schema(Some(Schema::default()/* use setters */));
        /// let x = VariableDeclaration::new().set_or_clear_schema(None::<Schema>);
        /// ```
        pub fn set_or_clear_schema<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::Schema>,
        {
            self.schema = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for VariableDeclaration {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.App.VariableDeclaration"
        }
    }

    /// Defines the tool execution behavior if there are **multiple** tools being
    /// selected by the agent **at the same time**.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolExecutionMode {
        /// Unspecified tool execution mode. Default to PARALLEL.
        Unspecified,
        /// If there are multiple tools being selected, they will be executed in
        /// parallel, with the same
        /// [ToolContext](https://google.github.io/adk-docs/context/#the-different-types-of-context).
        Parallel,
        /// If there are multiple tools being selected, they will be executed
        /// sequentially. The next tool will only be executed after the previous tool
        /// completes and it can see updated
        /// [ToolContext](https://google.github.io/adk-docs/context/#the-different-types-of-context)
        /// from the previous tool.
        Sequential,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [ToolExecutionMode::value] or
        /// [ToolExecutionMode::name].
        UnknownValue(tool_execution_mode::UnknownValue),
    }

    #[doc(hidden)]
    pub mod tool_execution_mode {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl ToolExecutionMode {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Parallel => std::option::Option::Some(1),
                Self::Sequential => std::option::Option::Some(2),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("TOOL_EXECUTION_MODE_UNSPECIFIED"),
                Self::Parallel => std::option::Option::Some("PARALLEL"),
                Self::Sequential => std::option::Option::Some("SEQUENTIAL"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for ToolExecutionMode {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for ToolExecutionMode {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for ToolExecutionMode {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Parallel,
                2 => Self::Sequential,
                _ => Self::UnknownValue(tool_execution_mode::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for ToolExecutionMode {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "TOOL_EXECUTION_MODE_UNSPECIFIED" => Self::Unspecified,
                "PARALLEL" => Self::Parallel,
                "SEQUENTIAL" => Self::Sequential,
                _ => Self::UnknownValue(tool_execution_mode::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for ToolExecutionMode {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Parallel => serializer.serialize_i32(1),
                Self::Sequential => serializer.serialize_i32(2),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for ToolExecutionMode {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<ToolExecutionMode>::new(
                ".google.cloud.ces.v1.App.ToolExecutionMode",
            ))
        }
    }
}

/// TimeZone settings of the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct TimeZoneSettings {
    /// Optional. The time zone of the app from the [time zone
    /// database](https://www.iana.org/time-zones), e.g., America/Los_Angeles,
    /// Europe/Paris.
    pub time_zone: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl TimeZoneSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [time_zone][crate::model::TimeZoneSettings::time_zone].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TimeZoneSettings;
    /// let x = TimeZoneSettings::new().set_time_zone("example");
    /// ```
    pub fn set_time_zone<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.time_zone = v.into();
        self
    }
}

impl wkt::message::Message for TimeZoneSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.TimeZoneSettings"
    }
}

/// Language settings of the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct LanguageSettings {
    /// Optional. The default language code of the app.
    pub default_language_code: std::string::String,

    /// Optional. List of languages codes supported by the app, in addition to the
    /// `default_language_code`.
    pub supported_language_codes: std::vec::Vec<std::string::String>,

    /// Optional. Enables multilingual support. If true, agents in the app will use
    /// pre-built instructions to improve handling of multilingual input.
    pub enable_multilingual_support: bool,

    /// Optional. Deprecated: This feature is no longer supported. Use
    /// `enable_multilingual_support` instead to improve handling of multilingual
    /// input.
    /// The action to perform when an agent receives input in an unsupported
    /// language.
    ///
    /// This can be a predefined action or a custom tool call.
    /// Valid values are:
    ///
    /// - A tool's full resource name, which triggers a specific tool execution.
    /// - A predefined system action, such as "escalate" or "exit", which triggers
    ///   an [EndSession][google.cloud.ces.v1.EndSession] signal with corresponding
    ///   [metadata][google.cloud.ces.v1.EndSession.metadata] to terminate the
    ///   conversation.
    ///
    /// [google.cloud.ces.v1.EndSession]: crate::model::EndSession
    /// [google.cloud.ces.v1.EndSession.metadata]: crate::model::EndSession::metadata
    #[deprecated]
    pub fallback_action: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl LanguageSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [default_language_code][crate::model::LanguageSettings::default_language_code].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LanguageSettings;
    /// let x = LanguageSettings::new().set_default_language_code("example");
    /// ```
    pub fn set_default_language_code<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.default_language_code = v.into();
        self
    }

    /// Sets the value of [supported_language_codes][crate::model::LanguageSettings::supported_language_codes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LanguageSettings;
    /// let x = LanguageSettings::new().set_supported_language_codes(["a", "b", "c"]);
    /// ```
    pub fn set_supported_language_codes<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.supported_language_codes = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [enable_multilingual_support][crate::model::LanguageSettings::enable_multilingual_support].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LanguageSettings;
    /// let x = LanguageSettings::new().set_enable_multilingual_support(true);
    /// ```
    pub fn set_enable_multilingual_support<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.enable_multilingual_support = v.into();
        self
    }

    /// Sets the value of [fallback_action][crate::model::LanguageSettings::fallback_action].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LanguageSettings;
    /// let x = LanguageSettings::new().set_fallback_action("example");
    /// ```
    #[deprecated]
    pub fn set_fallback_action<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.fallback_action = v.into();
        self
    }
}

impl wkt::message::Message for LanguageSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.LanguageSettings"
    }
}

/// Configuration for how the input and output audio should be processed and
/// delivered.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AudioProcessingConfig {
    /// Optional. Configuration of how the agent response should be synthesized,
    /// mapping from the language code to
    /// [SynthesizeSpeechConfig][google.cloud.ces.v1.SynthesizeSpeechConfig].
    ///
    /// If the configuration for the specified language code is not found, the
    /// configuration for the root language code will be used. For example, if the
    /// map contains "en-us" and "en", and the specified language code is "en-gb",
    /// then "en" configuration will be used.
    ///
    /// Note: Language code is case-insensitive.
    ///
    /// [google.cloud.ces.v1.SynthesizeSpeechConfig]: crate::model::SynthesizeSpeechConfig
    pub synthesize_speech_configs:
        std::collections::HashMap<std::string::String, crate::model::SynthesizeSpeechConfig>,

    /// Optional. Configures the agent behavior for the user barge-in activities.
    pub barge_in_config: std::option::Option<crate::model::BargeInConfig>,

    /// Optional. The duration of user inactivity (no speech or interaction) before
    /// the agent prompts the user for reengagement. If not set, the agent will not
    /// prompt the user for reengagement.
    pub inactivity_timeout: std::option::Option<wkt::Duration>,

    /// Optional. Configuration for the ambient sound to be played with the
    /// synthesized agent response, to enhance the naturalness of the conversation.
    pub ambient_sound_config: std::option::Option<crate::model::AmbientSoundConfig>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AudioProcessingConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [synthesize_speech_configs][crate::model::AudioProcessingConfig::synthesize_speech_configs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AudioProcessingConfig;
    /// use google_cloud_ces_v1::model::SynthesizeSpeechConfig;
    /// let x = AudioProcessingConfig::new().set_synthesize_speech_configs([
    ///     ("key0", SynthesizeSpeechConfig::default()/* use setters */),
    ///     ("key1", SynthesizeSpeechConfig::default()/* use (different) setters */),
    /// ]);
    /// ```
    pub fn set_synthesize_speech_configs<T, K, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = (K, V)>,
        K: std::convert::Into<std::string::String>,
        V: std::convert::Into<crate::model::SynthesizeSpeechConfig>,
    {
        use std::iter::Iterator;
        self.synthesize_speech_configs = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
        self
    }

    /// Sets the value of [barge_in_config][crate::model::AudioProcessingConfig::barge_in_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AudioProcessingConfig;
    /// use google_cloud_ces_v1::model::BargeInConfig;
    /// let x = AudioProcessingConfig::new().set_barge_in_config(BargeInConfig::default()/* use setters */);
    /// ```
    pub fn set_barge_in_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::BargeInConfig>,
    {
        self.barge_in_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [barge_in_config][crate::model::AudioProcessingConfig::barge_in_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AudioProcessingConfig;
    /// use google_cloud_ces_v1::model::BargeInConfig;
    /// let x = AudioProcessingConfig::new().set_or_clear_barge_in_config(Some(BargeInConfig::default()/* use setters */));
    /// let x = AudioProcessingConfig::new().set_or_clear_barge_in_config(None::<BargeInConfig>);
    /// ```
    pub fn set_or_clear_barge_in_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::BargeInConfig>,
    {
        self.barge_in_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [inactivity_timeout][crate::model::AudioProcessingConfig::inactivity_timeout].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AudioProcessingConfig;
    /// use wkt::Duration;
    /// let x = AudioProcessingConfig::new().set_inactivity_timeout(Duration::default()/* use setters */);
    /// ```
    pub fn set_inactivity_timeout<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.inactivity_timeout = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [inactivity_timeout][crate::model::AudioProcessingConfig::inactivity_timeout].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AudioProcessingConfig;
    /// use wkt::Duration;
    /// let x = AudioProcessingConfig::new().set_or_clear_inactivity_timeout(Some(Duration::default()/* use setters */));
    /// let x = AudioProcessingConfig::new().set_or_clear_inactivity_timeout(None::<Duration>);
    /// ```
    pub fn set_or_clear_inactivity_timeout<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.inactivity_timeout = v.map(|x| x.into());
        self
    }

    /// Sets the value of [ambient_sound_config][crate::model::AudioProcessingConfig::ambient_sound_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AudioProcessingConfig;
    /// use google_cloud_ces_v1::model::AmbientSoundConfig;
    /// let x = AudioProcessingConfig::new().set_ambient_sound_config(AmbientSoundConfig::default()/* use setters */);
    /// ```
    pub fn set_ambient_sound_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::AmbientSoundConfig>,
    {
        self.ambient_sound_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [ambient_sound_config][crate::model::AudioProcessingConfig::ambient_sound_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AudioProcessingConfig;
    /// use google_cloud_ces_v1::model::AmbientSoundConfig;
    /// let x = AudioProcessingConfig::new().set_or_clear_ambient_sound_config(Some(AmbientSoundConfig::default()/* use setters */));
    /// let x = AudioProcessingConfig::new().set_or_clear_ambient_sound_config(None::<AmbientSoundConfig>);
    /// ```
    pub fn set_or_clear_ambient_sound_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::AmbientSoundConfig>,
    {
        self.ambient_sound_config = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for AudioProcessingConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AudioProcessingConfig"
    }
}

/// Configuration for the ambient sound to be played with the synthesized agent
/// response, to enhance the naturalness of the conversation.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AmbientSoundConfig {
    /// Optional. Volume gain (in dB) of the normal native volume supported by
    /// ambient noise, in the range [-96.0, 16.0]. If unset, or set to a value of
    /// 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB)
    /// will play at approximately half the amplitude of the normal native signal
    /// amplitude. A value of +6.0 (dB) will play at approximately twice the
    /// amplitude of the normal native signal amplitude. We strongly recommend not
    /// to exceed +10 (dB) as there's usually no effective increase in loudness for
    /// any value greater than that.
    pub volume_gain_db: f64,

    /// Ambient noise to be played with the synthesized agent response, to
    /// enhance the naturalness of the conversation.
    pub source: std::option::Option<crate::model::ambient_sound_config::Source>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AmbientSoundConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [volume_gain_db][crate::model::AmbientSoundConfig::volume_gain_db].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AmbientSoundConfig;
    /// let x = AmbientSoundConfig::new().set_volume_gain_db(42.0);
    /// ```
    pub fn set_volume_gain_db<T: std::convert::Into<f64>>(mut self, v: T) -> Self {
        self.volume_gain_db = v.into();
        self
    }

    /// Sets the value of [source][crate::model::AmbientSoundConfig::source].
    ///
    /// Note that all the setters affecting `source` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AmbientSoundConfig;
    /// use google_cloud_ces_v1::model::ambient_sound_config::Source;
    /// let x = AmbientSoundConfig::new().set_source(Some(Source::GcsUri("example".to_string())));
    /// ```
    pub fn set_source<
        T: std::convert::Into<std::option::Option<crate::model::ambient_sound_config::Source>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.source = v.into();
        self
    }

    /// The value of [source][crate::model::AmbientSoundConfig::source]
    /// if it holds a `PrebuiltAmbientNoise`, `None` if the field is not set or
    /// holds a different branch.
    #[deprecated]
    pub fn prebuilt_ambient_noise(
        &self,
    ) -> std::option::Option<&crate::model::ambient_sound_config::PrebuiltAmbientNoise> {
        #[allow(unreachable_patterns)]
        self.source.as_ref().and_then(|v| match v {
            crate::model::ambient_sound_config::Source::PrebuiltAmbientNoise(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [source][crate::model::AmbientSoundConfig::source]
    /// to hold a `PrebuiltAmbientNoise`.
    ///
    /// Note that all the setters affecting `source` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AmbientSoundConfig;
    /// use google_cloud_ces_v1::model::ambient_sound_config::PrebuiltAmbientNoise;
    /// let x0 = AmbientSoundConfig::new().set_prebuilt_ambient_noise(PrebuiltAmbientNoise::RetailStore);
    /// let x1 = AmbientSoundConfig::new().set_prebuilt_ambient_noise(PrebuiltAmbientNoise::ConventionHall);
    /// let x2 = AmbientSoundConfig::new().set_prebuilt_ambient_noise(PrebuiltAmbientNoise::Outdoor);
    /// assert!(x0.prebuilt_ambient_noise().is_some());
    /// assert!(x0.gcs_uri().is_none());
    /// assert!(x0.prebuilt_ambient_sound().is_none());
    /// assert!(x1.prebuilt_ambient_noise().is_some());
    /// assert!(x1.gcs_uri().is_none());
    /// assert!(x1.prebuilt_ambient_sound().is_none());
    /// assert!(x2.prebuilt_ambient_noise().is_some());
    /// assert!(x2.gcs_uri().is_none());
    /// assert!(x2.prebuilt_ambient_sound().is_none());
    /// ```
    #[deprecated]
    pub fn set_prebuilt_ambient_noise<
        T: std::convert::Into<crate::model::ambient_sound_config::PrebuiltAmbientNoise>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.source = std::option::Option::Some(
            crate::model::ambient_sound_config::Source::PrebuiltAmbientNoise(v.into()),
        );
        self
    }

    /// The value of [source][crate::model::AmbientSoundConfig::source]
    /// if it holds a `GcsUri`, `None` if the field is not set or
    /// holds a different branch.
    pub fn gcs_uri(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.source.as_ref().and_then(|v| match v {
            crate::model::ambient_sound_config::Source::GcsUri(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [source][crate::model::AmbientSoundConfig::source]
    /// to hold a `GcsUri`.
    ///
    /// Note that all the setters affecting `source` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AmbientSoundConfig;
    /// let x = AmbientSoundConfig::new().set_gcs_uri("example");
    /// assert!(x.gcs_uri().is_some());
    /// assert!(x.prebuilt_ambient_noise().is_none());
    /// assert!(x.prebuilt_ambient_sound().is_none());
    /// ```
    pub fn set_gcs_uri<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.source =
            std::option::Option::Some(crate::model::ambient_sound_config::Source::GcsUri(v.into()));
        self
    }

    /// The value of [source][crate::model::AmbientSoundConfig::source]
    /// if it holds a `PrebuiltAmbientSound`, `None` if the field is not set or
    /// holds a different branch.
    pub fn prebuilt_ambient_sound(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.source.as_ref().and_then(|v| match v {
            crate::model::ambient_sound_config::Source::PrebuiltAmbientSound(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [source][crate::model::AmbientSoundConfig::source]
    /// to hold a `PrebuiltAmbientSound`.
    ///
    /// Note that all the setters affecting `source` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AmbientSoundConfig;
    /// let x = AmbientSoundConfig::new().set_prebuilt_ambient_sound("example");
    /// assert!(x.prebuilt_ambient_sound().is_some());
    /// assert!(x.prebuilt_ambient_noise().is_none());
    /// assert!(x.gcs_uri().is_none());
    /// ```
    pub fn set_prebuilt_ambient_sound<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.source = std::option::Option::Some(
            crate::model::ambient_sound_config::Source::PrebuiltAmbientSound(v.into()),
        );
        self
    }
}

impl wkt::message::Message for AmbientSoundConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AmbientSoundConfig"
    }
}

/// Defines additional types related to [AmbientSoundConfig].
pub mod ambient_sound_config {
    #[allow(unused_imports)]
    use super::*;

    /// Prebuilt ambient noise.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum PrebuiltAmbientNoise {
        /// Not specified.
        Unspecified,
        /// Ambient noise of a retail store.
        RetailStore,
        /// Ambient noise of a convention hall.
        ConventionHall,
        /// Ambient noise of a street.
        Outdoor,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [PrebuiltAmbientNoise::value] or
        /// [PrebuiltAmbientNoise::name].
        UnknownValue(prebuilt_ambient_noise::UnknownValue),
    }

    #[doc(hidden)]
    pub mod prebuilt_ambient_noise {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl PrebuiltAmbientNoise {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::RetailStore => std::option::Option::Some(1),
                Self::ConventionHall => std::option::Option::Some(2),
                Self::Outdoor => std::option::Option::Some(3),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => {
                    std::option::Option::Some("PREBUILT_AMBIENT_NOISE_UNSPECIFIED")
                }
                Self::RetailStore => std::option::Option::Some("RETAIL_STORE"),
                Self::ConventionHall => std::option::Option::Some("CONVENTION_HALL"),
                Self::Outdoor => std::option::Option::Some("OUTDOOR"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for PrebuiltAmbientNoise {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for PrebuiltAmbientNoise {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for PrebuiltAmbientNoise {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::RetailStore,
                2 => Self::ConventionHall,
                3 => Self::Outdoor,
                _ => Self::UnknownValue(prebuilt_ambient_noise::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for PrebuiltAmbientNoise {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "PREBUILT_AMBIENT_NOISE_UNSPECIFIED" => Self::Unspecified,
                "RETAIL_STORE" => Self::RetailStore,
                "CONVENTION_HALL" => Self::ConventionHall,
                "OUTDOOR" => Self::Outdoor,
                _ => Self::UnknownValue(prebuilt_ambient_noise::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for PrebuiltAmbientNoise {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::RetailStore => serializer.serialize_i32(1),
                Self::ConventionHall => serializer.serialize_i32(2),
                Self::Outdoor => serializer.serialize_i32(3),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for PrebuiltAmbientNoise {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<PrebuiltAmbientNoise>::new(
                ".google.cloud.ces.v1.AmbientSoundConfig.PrebuiltAmbientNoise",
            ))
        }
    }

    /// Ambient noise to be played with the synthesized agent response, to
    /// enhance the naturalness of the conversation.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum Source {
        /// Optional. Deprecated: `prebuilt_ambient_noise` is deprecated in favor of
        /// `prebuilt_ambient_sound`.
        #[deprecated]
        PrebuiltAmbientNoise(crate::model::ambient_sound_config::PrebuiltAmbientNoise),
        /// Optional. Ambient noise as a mono-channel, 16kHz WAV file stored in
        /// [Cloud Storage](https://cloud.google.com/storage).
        ///
        /// Note: Please make sure the CES service agent
        /// `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com` has
        /// `storage.objects.get` permission to the Cloud Storage object.
        GcsUri(std::string::String),
        /// Optional. Name of the prebuilt ambient sound.
        /// Valid values are:
        ///
        /// - "coffee_shop"
        /// - "keyboard"
        /// - "keypad"
        /// - "hum"
        /// - "office_1"
        /// - "office_2"
        /// - "office_3"
        /// - "room_1"
        /// - "room_2"
        /// - "room_3"
        /// - "room_4"
        /// - "room_5"
        /// - "air_conditioner"
        PrebuiltAmbientSound(std::string::String),
    }
}

/// Configuration for how the user barge-in activities should be handled.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct BargeInConfig {
    /// Optional. Deprecated: `disable_barge_in` is deprecated in favor of
    /// [`disable_barge_in_control`][google.cloud.ces.v1.ChannelProfile.disable_barge_in_control]
    /// in ChannelProfile.
    ///
    /// Disables user barge-in while the agent is speaking. If true, user input
    /// during agent response playback will be ignored.
    ///
    /// [google.cloud.ces.v1.ChannelProfile.disable_barge_in_control]: crate::model::ChannelProfile::disable_barge_in_control
    #[deprecated]
    pub disable_barge_in: bool,

    /// Optional. If enabled, the agent will adapt its next response based on the
    /// assumption that the user hasn't heard the full preceding agent message.
    /// This should not be used in scenarios where agent responses are displayed
    /// visually.
    pub barge_in_awareness: bool,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl BargeInConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [disable_barge_in][crate::model::BargeInConfig::disable_barge_in].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BargeInConfig;
    /// let x = BargeInConfig::new().set_disable_barge_in(true);
    /// ```
    #[deprecated]
    pub fn set_disable_barge_in<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.disable_barge_in = v.into();
        self
    }

    /// Sets the value of [barge_in_awareness][crate::model::BargeInConfig::barge_in_awareness].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BargeInConfig;
    /// let x = BargeInConfig::new().set_barge_in_awareness(true);
    /// ```
    pub fn set_barge_in_awareness<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.barge_in_awareness = v.into();
        self
    }
}

impl wkt::message::Message for BargeInConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.BargeInConfig"
    }
}

/// Configuration for how the agent response should be synthesized.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct SynthesizeSpeechConfig {
    /// Optional. The name of the voice. If not set, the service will choose a
    /// voice based on the other parameters such as language_code.
    ///
    /// For the list of available voices, please refer to [Supported voices and
    /// languages](https://cloud.google.com/text-to-speech/docs/voices) from Cloud
    /// Text-to-Speech.
    pub voice: std::string::String,

    /// Optional. The Cloud Storage URI to the audio sample for voice cloning. The
    /// audio sample should be a mono-channel, 24kHz WAV file.
    ///
    /// Note: Please make sure the CES service agent
    /// `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com` has
    /// `storage.objects.get` permission to the Cloud Storage object.
    pub voice_sample_gcs_uri: std::string::String,

    /// Optional. The speaking rate/speed in the range [0.25, 2.0]. 1.0 is the
    /// normal native speed supported by the specific voice. 2.0 is twice as fast,
    /// and 0.5 is half as fast. Values outside of the range [0.25, 2.0] will
    /// return an error.
    pub speaking_rate: f64,

    /// Optional. The model used to synthesize audio.
    /// Currently supported values:
    ///
    /// - "gemini-3.1-flash-tts-preview"
    ///   If empty, Chirp3-HD is used.
    pub model: std::string::String,

    /// Optional. The instruction used to synthesize speech when using a generative
    /// model.
    pub instruction: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl SynthesizeSpeechConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [voice][crate::model::SynthesizeSpeechConfig::voice].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SynthesizeSpeechConfig;
    /// let x = SynthesizeSpeechConfig::new().set_voice("example");
    /// ```
    pub fn set_voice<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.voice = v.into();
        self
    }

    /// Sets the value of [voice_sample_gcs_uri][crate::model::SynthesizeSpeechConfig::voice_sample_gcs_uri].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SynthesizeSpeechConfig;
    /// let x = SynthesizeSpeechConfig::new().set_voice_sample_gcs_uri("example");
    /// ```
    pub fn set_voice_sample_gcs_uri<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.voice_sample_gcs_uri = v.into();
        self
    }

    /// Sets the value of [speaking_rate][crate::model::SynthesizeSpeechConfig::speaking_rate].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SynthesizeSpeechConfig;
    /// let x = SynthesizeSpeechConfig::new().set_speaking_rate(42.0);
    /// ```
    pub fn set_speaking_rate<T: std::convert::Into<f64>>(mut self, v: T) -> Self {
        self.speaking_rate = v.into();
        self
    }

    /// Sets the value of [model][crate::model::SynthesizeSpeechConfig::model].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SynthesizeSpeechConfig;
    /// let x = SynthesizeSpeechConfig::new().set_model("example");
    /// ```
    pub fn set_model<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.model = v.into();
        self
    }

    /// Sets the value of [instruction][crate::model::SynthesizeSpeechConfig::instruction].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SynthesizeSpeechConfig;
    /// let x = SynthesizeSpeechConfig::new().set_instruction("example");
    /// ```
    pub fn set_instruction<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.instruction = v.into();
        self
    }
}

impl wkt::message::Message for SynthesizeSpeechConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.SynthesizeSpeechConfig"
    }
}

/// Settings to describe the conversation data collection behaviors for LLM
/// analysis metrics pipeline.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct MetricAnalysisSettings {
    /// Optional. Whether to collect conversation data for llm analysis metrics. If
    /// true, conversation data will not be collected for llm analysis metrics;
    /// otherwise, conversation data will be collected.
    pub llm_metrics_opted_out: bool,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl MetricAnalysisSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [llm_metrics_opted_out][crate::model::MetricAnalysisSettings::llm_metrics_opted_out].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MetricAnalysisSettings;
    /// let x = MetricAnalysisSettings::new().set_llm_metrics_opted_out(true);
    /// ```
    pub fn set_llm_metrics_opted_out<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.llm_metrics_opted_out = v.into();
        self
    }
}

impl wkt::message::Message for MetricAnalysisSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.MetricAnalysisSettings"
    }
}

/// Settings to describe the logging behaviors for the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct LoggingSettings {
    /// Optional. Configuration for how sensitive data should be redacted.
    pub redaction_config: std::option::Option<crate::model::RedactionConfig>,

    /// Optional. Configuration for how audio interactions should be recorded. The
    /// audio is subject to redaction as configured in
    /// [RedactionConfig][google.cloud.ces.v1.LoggingSettings.redaction_config].
    ///
    /// [google.cloud.ces.v1.LoggingSettings.redaction_config]: crate::model::LoggingSettings::redaction_config
    pub audio_recording_config: std::option::Option<crate::model::AudioRecordingConfig>,

    /// Optional. Configures an additional recording of unredacted audio. This can
    /// be used to maintain a raw audio copy when audio redaction is
    /// [enabled][google.cloud.ces.v1.RedactionConfig.enable_redaction], typically
    /// for auditing or monitoring purposes.
    ///
    /// [google.cloud.ces.v1.RedactionConfig.enable_redaction]: crate::model::RedactionConfig::enable_redaction
    pub unredacted_audio_recording_config: std::option::Option<crate::model::AudioRecordingConfig>,

    /// Optional. Configures the BigQuery export behaviors for the app. The
    /// conversation data is subject to redaction as configured in
    /// [RedactionConfig][google.cloud.ces.v1.LoggingSettings.redaction_config].
    ///
    /// [google.cloud.ces.v1.LoggingSettings.redaction_config]: crate::model::LoggingSettings::redaction_config
    pub bigquery_export_settings: std::option::Option<crate::model::BigQueryExportSettings>,

    /// Optional. Configures the BigQuery export behaviors for the app.
    /// The unredacted conversation data will be exported to BigQuery tables if it
    /// is enabled.
    pub unredacted_bigquery_export_settings:
        std::option::Option<crate::model::BigQueryExportSettings>,

    /// Optional. Settings to describe the Cloud Logging behaviors for the app.
    pub cloud_logging_settings: std::option::Option<crate::model::CloudLoggingSettings>,

    /// Optional. Settings to describe the conversation logging behaviors for the
    /// app.
    pub conversation_logging_settings:
        std::option::Option<crate::model::ConversationLoggingSettings>,

    /// Optional. Configuration for how audio interactions should be recorded for
    /// the evaluation. By default, audio recording is not enabled for evaluation
    /// sessions.
    pub evaluation_audio_recording_config: std::option::Option<crate::model::AudioRecordingConfig>,

    /// Optional. Settings to describe the conversation data collection behaviors
    /// for the LLM analysis pipeline for the app.
    pub metric_analysis_settings: std::option::Option<crate::model::MetricAnalysisSettings>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl LoggingSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [redaction_config][crate::model::LoggingSettings::redaction_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::RedactionConfig;
    /// let x = LoggingSettings::new().set_redaction_config(RedactionConfig::default()/* use setters */);
    /// ```
    pub fn set_redaction_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::RedactionConfig>,
    {
        self.redaction_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [redaction_config][crate::model::LoggingSettings::redaction_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::RedactionConfig;
    /// let x = LoggingSettings::new().set_or_clear_redaction_config(Some(RedactionConfig::default()/* use setters */));
    /// let x = LoggingSettings::new().set_or_clear_redaction_config(None::<RedactionConfig>);
    /// ```
    pub fn set_or_clear_redaction_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::RedactionConfig>,
    {
        self.redaction_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [audio_recording_config][crate::model::LoggingSettings::audio_recording_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::AudioRecordingConfig;
    /// let x = LoggingSettings::new().set_audio_recording_config(AudioRecordingConfig::default()/* use setters */);
    /// ```
    pub fn set_audio_recording_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::AudioRecordingConfig>,
    {
        self.audio_recording_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [audio_recording_config][crate::model::LoggingSettings::audio_recording_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::AudioRecordingConfig;
    /// let x = LoggingSettings::new().set_or_clear_audio_recording_config(Some(AudioRecordingConfig::default()/* use setters */));
    /// let x = LoggingSettings::new().set_or_clear_audio_recording_config(None::<AudioRecordingConfig>);
    /// ```
    pub fn set_or_clear_audio_recording_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::AudioRecordingConfig>,
    {
        self.audio_recording_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [unredacted_audio_recording_config][crate::model::LoggingSettings::unredacted_audio_recording_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::AudioRecordingConfig;
    /// let x = LoggingSettings::new().set_unredacted_audio_recording_config(AudioRecordingConfig::default()/* use setters */);
    /// ```
    pub fn set_unredacted_audio_recording_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::AudioRecordingConfig>,
    {
        self.unredacted_audio_recording_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [unredacted_audio_recording_config][crate::model::LoggingSettings::unredacted_audio_recording_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::AudioRecordingConfig;
    /// let x = LoggingSettings::new().set_or_clear_unredacted_audio_recording_config(Some(AudioRecordingConfig::default()/* use setters */));
    /// let x = LoggingSettings::new().set_or_clear_unredacted_audio_recording_config(None::<AudioRecordingConfig>);
    /// ```
    pub fn set_or_clear_unredacted_audio_recording_config<T>(
        mut self,
        v: std::option::Option<T>,
    ) -> Self
    where
        T: std::convert::Into<crate::model::AudioRecordingConfig>,
    {
        self.unredacted_audio_recording_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [bigquery_export_settings][crate::model::LoggingSettings::bigquery_export_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::BigQueryExportSettings;
    /// let x = LoggingSettings::new().set_bigquery_export_settings(BigQueryExportSettings::default()/* use setters */);
    /// ```
    pub fn set_bigquery_export_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::BigQueryExportSettings>,
    {
        self.bigquery_export_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [bigquery_export_settings][crate::model::LoggingSettings::bigquery_export_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::BigQueryExportSettings;
    /// let x = LoggingSettings::new().set_or_clear_bigquery_export_settings(Some(BigQueryExportSettings::default()/* use setters */));
    /// let x = LoggingSettings::new().set_or_clear_bigquery_export_settings(None::<BigQueryExportSettings>);
    /// ```
    pub fn set_or_clear_bigquery_export_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::BigQueryExportSettings>,
    {
        self.bigquery_export_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [unredacted_bigquery_export_settings][crate::model::LoggingSettings::unredacted_bigquery_export_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::BigQueryExportSettings;
    /// let x = LoggingSettings::new().set_unredacted_bigquery_export_settings(BigQueryExportSettings::default()/* use setters */);
    /// ```
    pub fn set_unredacted_bigquery_export_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::BigQueryExportSettings>,
    {
        self.unredacted_bigquery_export_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [unredacted_bigquery_export_settings][crate::model::LoggingSettings::unredacted_bigquery_export_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::BigQueryExportSettings;
    /// let x = LoggingSettings::new().set_or_clear_unredacted_bigquery_export_settings(Some(BigQueryExportSettings::default()/* use setters */));
    /// let x = LoggingSettings::new().set_or_clear_unredacted_bigquery_export_settings(None::<BigQueryExportSettings>);
    /// ```
    pub fn set_or_clear_unredacted_bigquery_export_settings<T>(
        mut self,
        v: std::option::Option<T>,
    ) -> Self
    where
        T: std::convert::Into<crate::model::BigQueryExportSettings>,
    {
        self.unredacted_bigquery_export_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [cloud_logging_settings][crate::model::LoggingSettings::cloud_logging_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::CloudLoggingSettings;
    /// let x = LoggingSettings::new().set_cloud_logging_settings(CloudLoggingSettings::default()/* use setters */);
    /// ```
    pub fn set_cloud_logging_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::CloudLoggingSettings>,
    {
        self.cloud_logging_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [cloud_logging_settings][crate::model::LoggingSettings::cloud_logging_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::CloudLoggingSettings;
    /// let x = LoggingSettings::new().set_or_clear_cloud_logging_settings(Some(CloudLoggingSettings::default()/* use setters */));
    /// let x = LoggingSettings::new().set_or_clear_cloud_logging_settings(None::<CloudLoggingSettings>);
    /// ```
    pub fn set_or_clear_cloud_logging_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::CloudLoggingSettings>,
    {
        self.cloud_logging_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [conversation_logging_settings][crate::model::LoggingSettings::conversation_logging_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::ConversationLoggingSettings;
    /// let x = LoggingSettings::new().set_conversation_logging_settings(ConversationLoggingSettings::default()/* use setters */);
    /// ```
    pub fn set_conversation_logging_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ConversationLoggingSettings>,
    {
        self.conversation_logging_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [conversation_logging_settings][crate::model::LoggingSettings::conversation_logging_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::ConversationLoggingSettings;
    /// let x = LoggingSettings::new().set_or_clear_conversation_logging_settings(Some(ConversationLoggingSettings::default()/* use setters */));
    /// let x = LoggingSettings::new().set_or_clear_conversation_logging_settings(None::<ConversationLoggingSettings>);
    /// ```
    pub fn set_or_clear_conversation_logging_settings<T>(
        mut self,
        v: std::option::Option<T>,
    ) -> Self
    where
        T: std::convert::Into<crate::model::ConversationLoggingSettings>,
    {
        self.conversation_logging_settings = v.map(|x| x.into());
        self
    }

    /// Sets the value of [evaluation_audio_recording_config][crate::model::LoggingSettings::evaluation_audio_recording_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::AudioRecordingConfig;
    /// let x = LoggingSettings::new().set_evaluation_audio_recording_config(AudioRecordingConfig::default()/* use setters */);
    /// ```
    pub fn set_evaluation_audio_recording_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::AudioRecordingConfig>,
    {
        self.evaluation_audio_recording_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [evaluation_audio_recording_config][crate::model::LoggingSettings::evaluation_audio_recording_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::AudioRecordingConfig;
    /// let x = LoggingSettings::new().set_or_clear_evaluation_audio_recording_config(Some(AudioRecordingConfig::default()/* use setters */));
    /// let x = LoggingSettings::new().set_or_clear_evaluation_audio_recording_config(None::<AudioRecordingConfig>);
    /// ```
    pub fn set_or_clear_evaluation_audio_recording_config<T>(
        mut self,
        v: std::option::Option<T>,
    ) -> Self
    where
        T: std::convert::Into<crate::model::AudioRecordingConfig>,
    {
        self.evaluation_audio_recording_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [metric_analysis_settings][crate::model::LoggingSettings::metric_analysis_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::MetricAnalysisSettings;
    /// let x = LoggingSettings::new().set_metric_analysis_settings(MetricAnalysisSettings::default()/* use setters */);
    /// ```
    pub fn set_metric_analysis_settings<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::MetricAnalysisSettings>,
    {
        self.metric_analysis_settings = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [metric_analysis_settings][crate::model::LoggingSettings::metric_analysis_settings].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::LoggingSettings;
    /// use google_cloud_ces_v1::model::MetricAnalysisSettings;
    /// let x = LoggingSettings::new().set_or_clear_metric_analysis_settings(Some(MetricAnalysisSettings::default()/* use setters */));
    /// let x = LoggingSettings::new().set_or_clear_metric_analysis_settings(None::<MetricAnalysisSettings>);
    /// ```
    pub fn set_or_clear_metric_analysis_settings<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::MetricAnalysisSettings>,
    {
        self.metric_analysis_settings = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for LoggingSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.LoggingSettings"
    }
}

/// Settings to describe how errors should be handled in the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ErrorHandlingSettings {
    /// Optional. The strategy to use for error handling.
    pub error_handling_strategy: crate::model::error_handling_settings::ErrorHandlingStrategy,

    /// Optional. Configuration for handling fallback responses.
    pub fallback_response_config:
        std::option::Option<crate::model::error_handling_settings::FallbackResponseConfig>,

    /// Optional. Configuration for ending the session in case of system errors
    /// (e.g. LLM errors).
    pub end_session_config:
        std::option::Option<crate::model::error_handling_settings::EndSessionConfig>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ErrorHandlingSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [error_handling_strategy][crate::model::ErrorHandlingSettings::error_handling_strategy].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ErrorHandlingSettings;
    /// use google_cloud_ces_v1::model::error_handling_settings::ErrorHandlingStrategy;
    /// let x0 = ErrorHandlingSettings::new().set_error_handling_strategy(ErrorHandlingStrategy::None);
    /// let x1 = ErrorHandlingSettings::new().set_error_handling_strategy(ErrorHandlingStrategy::FallbackResponse);
    /// let x2 = ErrorHandlingSettings::new().set_error_handling_strategy(ErrorHandlingStrategy::EndSession);
    /// ```
    pub fn set_error_handling_strategy<
        T: std::convert::Into<crate::model::error_handling_settings::ErrorHandlingStrategy>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.error_handling_strategy = v.into();
        self
    }

    /// Sets the value of [fallback_response_config][crate::model::ErrorHandlingSettings::fallback_response_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ErrorHandlingSettings;
    /// use google_cloud_ces_v1::model::error_handling_settings::FallbackResponseConfig;
    /// let x = ErrorHandlingSettings::new().set_fallback_response_config(FallbackResponseConfig::default()/* use setters */);
    /// ```
    pub fn set_fallback_response_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::error_handling_settings::FallbackResponseConfig>,
    {
        self.fallback_response_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [fallback_response_config][crate::model::ErrorHandlingSettings::fallback_response_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ErrorHandlingSettings;
    /// use google_cloud_ces_v1::model::error_handling_settings::FallbackResponseConfig;
    /// let x = ErrorHandlingSettings::new().set_or_clear_fallback_response_config(Some(FallbackResponseConfig::default()/* use setters */));
    /// let x = ErrorHandlingSettings::new().set_or_clear_fallback_response_config(None::<FallbackResponseConfig>);
    /// ```
    pub fn set_or_clear_fallback_response_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::error_handling_settings::FallbackResponseConfig>,
    {
        self.fallback_response_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [end_session_config][crate::model::ErrorHandlingSettings::end_session_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ErrorHandlingSettings;
    /// use google_cloud_ces_v1::model::error_handling_settings::EndSessionConfig;
    /// let x = ErrorHandlingSettings::new().set_end_session_config(EndSessionConfig::default()/* use setters */);
    /// ```
    pub fn set_end_session_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::error_handling_settings::EndSessionConfig>,
    {
        self.end_session_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [end_session_config][crate::model::ErrorHandlingSettings::end_session_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ErrorHandlingSettings;
    /// use google_cloud_ces_v1::model::error_handling_settings::EndSessionConfig;
    /// let x = ErrorHandlingSettings::new().set_or_clear_end_session_config(Some(EndSessionConfig::default()/* use setters */));
    /// let x = ErrorHandlingSettings::new().set_or_clear_end_session_config(None::<EndSessionConfig>);
    /// ```
    pub fn set_or_clear_end_session_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::error_handling_settings::EndSessionConfig>,
    {
        self.end_session_config = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for ErrorHandlingSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ErrorHandlingSettings"
    }
}

/// Defines additional types related to [ErrorHandlingSettings].
pub mod error_handling_settings {
    #[allow(unused_imports)]
    use super::*;

    /// Configuration for handling fallback responses.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct FallbackResponseConfig {
        /// Optional. The fallback messages in case of system errors (e.g. LLM
        /// errors), mapped by [supported language
        /// code](https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference/language).
        pub custom_fallback_messages:
            std::collections::HashMap<std::string::String, std::string::String>,

        /// Optional. The maximum number of fallback attempts to make before the
        /// agent emitting [EndSession][google.cloud.ces.v1.EndSession] Signal.
        ///
        /// [google.cloud.ces.v1.EndSession]: crate::model::EndSession
        pub max_fallback_attempts: i32,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl FallbackResponseConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [custom_fallback_messages][crate::model::error_handling_settings::FallbackResponseConfig::custom_fallback_messages].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::error_handling_settings::FallbackResponseConfig;
        /// let x = FallbackResponseConfig::new().set_custom_fallback_messages([
        ///     ("key0", "abc"),
        ///     ("key1", "xyz"),
        /// ]);
        /// ```
        pub fn set_custom_fallback_messages<T, K, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = (K, V)>,
            K: std::convert::Into<std::string::String>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.custom_fallback_messages =
                v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
            self
        }

        /// Sets the value of [max_fallback_attempts][crate::model::error_handling_settings::FallbackResponseConfig::max_fallback_attempts].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::error_handling_settings::FallbackResponseConfig;
        /// let x = FallbackResponseConfig::new().set_max_fallback_attempts(42);
        /// ```
        pub fn set_max_fallback_attempts<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
            self.max_fallback_attempts = v.into();
            self
        }
    }

    impl wkt::message::Message for FallbackResponseConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.ErrorHandlingSettings.FallbackResponseConfig"
        }
    }

    /// Configuration for ending the session in case of system errors (e.g. LLM
    /// errors).
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct EndSessionConfig {
        /// Optional. Whether to escalate the session in
        /// [EndSession][google.cloud.ces.v1.EndSession]. If session is escalated,
        /// [metadata in EndSession][google.cloud.ces.v1.EndSession.metadata] will
        /// contain `session_escalated = true`. See
        /// <https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/deploy/google-telephony-platform#transfer_a_call_to_a_human_agent>
        /// for details.
        ///
        /// [google.cloud.ces.v1.EndSession]: crate::model::EndSession
        /// [google.cloud.ces.v1.EndSession.metadata]: crate::model::EndSession::metadata
        pub escalate_session: std::option::Option<bool>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl EndSessionConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [escalate_session][crate::model::error_handling_settings::EndSessionConfig::escalate_session].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::error_handling_settings::EndSessionConfig;
        /// let x = EndSessionConfig::new().set_escalate_session(true);
        /// ```
        pub fn set_escalate_session<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<bool>,
        {
            self.escalate_session = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [escalate_session][crate::model::error_handling_settings::EndSessionConfig::escalate_session].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::error_handling_settings::EndSessionConfig;
        /// let x = EndSessionConfig::new().set_or_clear_escalate_session(Some(false));
        /// let x = EndSessionConfig::new().set_or_clear_escalate_session(None::<bool>);
        /// ```
        pub fn set_or_clear_escalate_session<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<bool>,
        {
            self.escalate_session = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for EndSessionConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.ErrorHandlingSettings.EndSessionConfig"
        }
    }

    /// Defines the strategy for handling errors.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ErrorHandlingStrategy {
        /// Unspecified error handling strategy.
        Unspecified,
        /// No specific handling is enabled.
        None,
        /// A fallback message will be returned to the user in case of
        /// system errors (e.g. LLM errors).
        FallbackResponse,
        /// An [EndSession][google.cloud.ces.v1.EndSession] signal will be emitted in
        /// case of system errors (e.g. LLM errors).
        ///
        /// [google.cloud.ces.v1.EndSession]: crate::model::EndSession
        EndSession,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [ErrorHandlingStrategy::value] or
        /// [ErrorHandlingStrategy::name].
        UnknownValue(error_handling_strategy::UnknownValue),
    }

    #[doc(hidden)]
    pub mod error_handling_strategy {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl ErrorHandlingStrategy {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::None => std::option::Option::Some(1),
                Self::FallbackResponse => std::option::Option::Some(2),
                Self::EndSession => std::option::Option::Some(3),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => {
                    std::option::Option::Some("ERROR_HANDLING_STRATEGY_UNSPECIFIED")
                }
                Self::None => std::option::Option::Some("NONE"),
                Self::FallbackResponse => std::option::Option::Some("FALLBACK_RESPONSE"),
                Self::EndSession => std::option::Option::Some("END_SESSION"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for ErrorHandlingStrategy {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for ErrorHandlingStrategy {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for ErrorHandlingStrategy {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::None,
                2 => Self::FallbackResponse,
                3 => Self::EndSession,
                _ => Self::UnknownValue(error_handling_strategy::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for ErrorHandlingStrategy {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "ERROR_HANDLING_STRATEGY_UNSPECIFIED" => Self::Unspecified,
                "NONE" => Self::None,
                "FALLBACK_RESPONSE" => Self::FallbackResponse,
                "END_SESSION" => Self::EndSession,
                _ => Self::UnknownValue(error_handling_strategy::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for ErrorHandlingStrategy {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::None => serializer.serialize_i32(1),
                Self::FallbackResponse => serializer.serialize_i32(2),
                Self::EndSession => serializer.serialize_i32(3),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for ErrorHandlingStrategy {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<ErrorHandlingStrategy>::new(
                ".google.cloud.ces.v1.ErrorHandlingSettings.ErrorHandlingStrategy",
            ))
        }
    }
}

/// Threshold settings for metrics in an Evaluation.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct EvaluationMetricsThresholds {
    /// Optional. The golden evaluation metrics thresholds.
    pub golden_evaluation_metrics_thresholds: std::option::Option<
        crate::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds,
    >,

    /// Optional. Deprecated: Use `golden_hallucination_metric_behavior` instead.
    /// The hallucination metric behavior is currently used for golden evaluations.
    #[deprecated]
    pub hallucination_metric_behavior:
        crate::model::evaluation_metrics_thresholds::HallucinationMetricBehavior,

    /// Optional. The hallucination metric behavior for golden evaluations.
    pub golden_hallucination_metric_behavior:
        crate::model::evaluation_metrics_thresholds::HallucinationMetricBehavior,

    /// Optional. The hallucination metric behavior for scenario evaluations.
    pub scenario_hallucination_metric_behavior:
        crate::model::evaluation_metrics_thresholds::HallucinationMetricBehavior,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl EvaluationMetricsThresholds {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [golden_evaluation_metrics_thresholds][crate::model::EvaluationMetricsThresholds::golden_evaluation_metrics_thresholds].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EvaluationMetricsThresholds;
    /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds;
    /// let x = EvaluationMetricsThresholds::new().set_golden_evaluation_metrics_thresholds(GoldenEvaluationMetricsThresholds::default()/* use setters */);
    /// ```
    pub fn set_golden_evaluation_metrics_thresholds<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<
                crate::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds,
            >,
    {
        self.golden_evaluation_metrics_thresholds = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [golden_evaluation_metrics_thresholds][crate::model::EvaluationMetricsThresholds::golden_evaluation_metrics_thresholds].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EvaluationMetricsThresholds;
    /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds;
    /// let x = EvaluationMetricsThresholds::new().set_or_clear_golden_evaluation_metrics_thresholds(Some(GoldenEvaluationMetricsThresholds::default()/* use setters */));
    /// let x = EvaluationMetricsThresholds::new().set_or_clear_golden_evaluation_metrics_thresholds(None::<GoldenEvaluationMetricsThresholds>);
    /// ```
    pub fn set_or_clear_golden_evaluation_metrics_thresholds<T>(
        mut self,
        v: std::option::Option<T>,
    ) -> Self
    where
        T: std::convert::Into<
                crate::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds,
            >,
    {
        self.golden_evaluation_metrics_thresholds = v.map(|x| x.into());
        self
    }

    /// Sets the value of [hallucination_metric_behavior][crate::model::EvaluationMetricsThresholds::hallucination_metric_behavior].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EvaluationMetricsThresholds;
    /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::HallucinationMetricBehavior;
    /// let x0 = EvaluationMetricsThresholds::new().set_hallucination_metric_behavior(HallucinationMetricBehavior::Disabled);
    /// let x1 = EvaluationMetricsThresholds::new().set_hallucination_metric_behavior(HallucinationMetricBehavior::Enabled);
    /// ```
    #[deprecated]
    pub fn set_hallucination_metric_behavior<
        T: std::convert::Into<
                crate::model::evaluation_metrics_thresholds::HallucinationMetricBehavior,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.hallucination_metric_behavior = v.into();
        self
    }

    /// Sets the value of [golden_hallucination_metric_behavior][crate::model::EvaluationMetricsThresholds::golden_hallucination_metric_behavior].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EvaluationMetricsThresholds;
    /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::HallucinationMetricBehavior;
    /// let x0 = EvaluationMetricsThresholds::new().set_golden_hallucination_metric_behavior(HallucinationMetricBehavior::Disabled);
    /// let x1 = EvaluationMetricsThresholds::new().set_golden_hallucination_metric_behavior(HallucinationMetricBehavior::Enabled);
    /// ```
    pub fn set_golden_hallucination_metric_behavior<
        T: std::convert::Into<
                crate::model::evaluation_metrics_thresholds::HallucinationMetricBehavior,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.golden_hallucination_metric_behavior = v.into();
        self
    }

    /// Sets the value of [scenario_hallucination_metric_behavior][crate::model::EvaluationMetricsThresholds::scenario_hallucination_metric_behavior].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EvaluationMetricsThresholds;
    /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::HallucinationMetricBehavior;
    /// let x0 = EvaluationMetricsThresholds::new().set_scenario_hallucination_metric_behavior(HallucinationMetricBehavior::Disabled);
    /// let x1 = EvaluationMetricsThresholds::new().set_scenario_hallucination_metric_behavior(HallucinationMetricBehavior::Enabled);
    /// ```
    pub fn set_scenario_hallucination_metric_behavior<
        T: std::convert::Into<
                crate::model::evaluation_metrics_thresholds::HallucinationMetricBehavior,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.scenario_hallucination_metric_behavior = v.into();
        self
    }
}

impl wkt::message::Message for EvaluationMetricsThresholds {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.EvaluationMetricsThresholds"
    }
}

/// Defines additional types related to [EvaluationMetricsThresholds].
pub mod evaluation_metrics_thresholds {
    #[allow(unused_imports)]
    use super::*;

    /// Settings for golden evaluations.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct GoldenEvaluationMetricsThresholds {

        /// Optional. The turn level metrics thresholds.
        pub turn_level_metrics_thresholds: std::option::Option<crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds>,

        /// Optional. The expectation level metrics thresholds.
        pub expectation_level_metrics_thresholds: std::option::Option<crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::ExpectationLevelMetricsThresholds>,

        /// Optional. The tool matching settings. An
        /// extra tool call is a tool call that is present in the execution but does
        /// not match any tool call in the golden expectation.
        pub tool_matching_settings: std::option::Option<crate::model::evaluation_metrics_thresholds::ToolMatchingSettings>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl GoldenEvaluationMetricsThresholds {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [turn_level_metrics_thresholds][crate::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds::turn_level_metrics_thresholds].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds;
        /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds;
        /// let x = GoldenEvaluationMetricsThresholds::new().set_turn_level_metrics_thresholds(TurnLevelMetricsThresholds::default()/* use setters */);
        /// ```
        pub fn set_turn_level_metrics_thresholds<T>(mut self, v: T) -> Self
        where T: std::convert::Into<crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds>
        {
            self.turn_level_metrics_thresholds = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [turn_level_metrics_thresholds][crate::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds::turn_level_metrics_thresholds].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds;
        /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds;
        /// let x = GoldenEvaluationMetricsThresholds::new().set_or_clear_turn_level_metrics_thresholds(Some(TurnLevelMetricsThresholds::default()/* use setters */));
        /// let x = GoldenEvaluationMetricsThresholds::new().set_or_clear_turn_level_metrics_thresholds(None::<TurnLevelMetricsThresholds>);
        /// ```
        pub fn set_or_clear_turn_level_metrics_thresholds<T>(mut self, v: std::option::Option<T>) -> Self
        where T: std::convert::Into<crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds>
        {
            self.turn_level_metrics_thresholds = v.map(|x| x.into());
            self
        }

        /// Sets the value of [expectation_level_metrics_thresholds][crate::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds::expectation_level_metrics_thresholds].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds;
        /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::ExpectationLevelMetricsThresholds;
        /// let x = GoldenEvaluationMetricsThresholds::new().set_expectation_level_metrics_thresholds(ExpectationLevelMetricsThresholds::default()/* use setters */);
        /// ```
        pub fn set_expectation_level_metrics_thresholds<T>(mut self, v: T) -> Self
        where T: std::convert::Into<crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::ExpectationLevelMetricsThresholds>
        {
            self.expectation_level_metrics_thresholds = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [expectation_level_metrics_thresholds][crate::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds::expectation_level_metrics_thresholds].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds;
        /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::ExpectationLevelMetricsThresholds;
        /// let x = GoldenEvaluationMetricsThresholds::new().set_or_clear_expectation_level_metrics_thresholds(Some(ExpectationLevelMetricsThresholds::default()/* use setters */));
        /// let x = GoldenEvaluationMetricsThresholds::new().set_or_clear_expectation_level_metrics_thresholds(None::<ExpectationLevelMetricsThresholds>);
        /// ```
        pub fn set_or_clear_expectation_level_metrics_thresholds<T>(mut self, v: std::option::Option<T>) -> Self
        where T: std::convert::Into<crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::ExpectationLevelMetricsThresholds>
        {
            self.expectation_level_metrics_thresholds = v.map(|x| x.into());
            self
        }

        /// Sets the value of [tool_matching_settings][crate::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds::tool_matching_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds;
        /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::ToolMatchingSettings;
        /// let x = GoldenEvaluationMetricsThresholds::new().set_tool_matching_settings(ToolMatchingSettings::default()/* use setters */);
        /// ```
        pub fn set_tool_matching_settings<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<
                    crate::model::evaluation_metrics_thresholds::ToolMatchingSettings,
                >,
        {
            self.tool_matching_settings = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [tool_matching_settings][crate::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds::tool_matching_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::GoldenEvaluationMetricsThresholds;
        /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::ToolMatchingSettings;
        /// let x = GoldenEvaluationMetricsThresholds::new().set_or_clear_tool_matching_settings(Some(ToolMatchingSettings::default()/* use setters */));
        /// let x = GoldenEvaluationMetricsThresholds::new().set_or_clear_tool_matching_settings(None::<ToolMatchingSettings>);
        /// ```
        pub fn set_or_clear_tool_matching_settings<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<
                    crate::model::evaluation_metrics_thresholds::ToolMatchingSettings,
                >,
        {
            self.tool_matching_settings = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for GoldenEvaluationMetricsThresholds {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds"
        }
    }

    /// Defines additional types related to [GoldenEvaluationMetricsThresholds].
    pub mod golden_evaluation_metrics_thresholds {
        #[allow(unused_imports)]
        use super::*;

        /// Turn level metrics thresholds.
        #[derive(Clone, Default, PartialEq)]
        #[non_exhaustive]
        pub struct TurnLevelMetricsThresholds {

            /// Optional. The success threshold for semantic similarity. Must be an
            /// integer between 0 and 4. Default is >= 3.
            pub semantic_similarity_success_threshold: std::option::Option<i32>,

            /// Optional. The success threshold for overall tool invocation
            /// correctness. Must be a float between 0 and 1. Default is 1.0.
            pub overall_tool_invocation_correctness_threshold: std::option::Option<f32>,

            /// Optional. The semantic similarity channel to use for evaluation.
            pub semantic_similarity_channel: crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::turn_level_metrics_thresholds::SemanticSimilarityChannel,

            pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
        }

        impl TurnLevelMetricsThresholds {
            /// Creates a new default instance.
            pub fn new() -> Self {
                std::default::Default::default()
            }

            /// Sets the value of [semantic_similarity_success_threshold][crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds::semantic_similarity_success_threshold].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds;
            /// let x = TurnLevelMetricsThresholds::new().set_semantic_similarity_success_threshold(42);
            /// ```
            pub fn set_semantic_similarity_success_threshold<T>(mut self, v: T) -> Self
            where
                T: std::convert::Into<i32>,
            {
                self.semantic_similarity_success_threshold = std::option::Option::Some(v.into());
                self
            }

            /// Sets or clears the value of [semantic_similarity_success_threshold][crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds::semantic_similarity_success_threshold].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds;
            /// let x = TurnLevelMetricsThresholds::new().set_or_clear_semantic_similarity_success_threshold(Some(42));
            /// let x = TurnLevelMetricsThresholds::new().set_or_clear_semantic_similarity_success_threshold(None::<i32>);
            /// ```
            pub fn set_or_clear_semantic_similarity_success_threshold<T>(
                mut self,
                v: std::option::Option<T>,
            ) -> Self
            where
                T: std::convert::Into<i32>,
            {
                self.semantic_similarity_success_threshold = v.map(|x| x.into());
                self
            }

            /// Sets the value of [overall_tool_invocation_correctness_threshold][crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds::overall_tool_invocation_correctness_threshold].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds;
            /// let x = TurnLevelMetricsThresholds::new().set_overall_tool_invocation_correctness_threshold(42.0);
            /// ```
            pub fn set_overall_tool_invocation_correctness_threshold<T>(mut self, v: T) -> Self
            where
                T: std::convert::Into<f32>,
            {
                self.overall_tool_invocation_correctness_threshold =
                    std::option::Option::Some(v.into());
                self
            }

            /// Sets or clears the value of [overall_tool_invocation_correctness_threshold][crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds::overall_tool_invocation_correctness_threshold].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds;
            /// let x = TurnLevelMetricsThresholds::new().set_or_clear_overall_tool_invocation_correctness_threshold(Some(42.0));
            /// let x = TurnLevelMetricsThresholds::new().set_or_clear_overall_tool_invocation_correctness_threshold(None::<f32>);
            /// ```
            pub fn set_or_clear_overall_tool_invocation_correctness_threshold<T>(
                mut self,
                v: std::option::Option<T>,
            ) -> Self
            where
                T: std::convert::Into<f32>,
            {
                self.overall_tool_invocation_correctness_threshold = v.map(|x| x.into());
                self
            }

            /// Sets the value of [semantic_similarity_channel][crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds::semantic_similarity_channel].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::TurnLevelMetricsThresholds;
            /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::turn_level_metrics_thresholds::SemanticSimilarityChannel;
            /// let x0 = TurnLevelMetricsThresholds::new().set_semantic_similarity_channel(SemanticSimilarityChannel::Text);
            /// let x1 = TurnLevelMetricsThresholds::new().set_semantic_similarity_channel(SemanticSimilarityChannel::Audio);
            /// ```
            pub fn set_semantic_similarity_channel<T: std::convert::Into<crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::turn_level_metrics_thresholds::SemanticSimilarityChannel>>(mut self, v: T) -> Self{
                self.semantic_similarity_channel = v.into();
                self
            }
        }

        impl wkt::message::Message for TurnLevelMetricsThresholds {
            fn typename() -> &'static str {
                "type.googleapis.com/google.cloud.ces.v1.EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds"
            }
        }

        /// Defines additional types related to [TurnLevelMetricsThresholds].
        pub mod turn_level_metrics_thresholds {
            #[allow(unused_imports)]
            use super::*;

            /// Semantic similarity channel to use.
            ///
            /// # Working with unknown values
            ///
            /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
            /// additional enum variants at any time. Adding new variants is not considered
            /// a breaking change. Applications should write their code in anticipation of:
            ///
            /// - New values appearing in future releases of the client library, **and**
            /// - New values received dynamically, without application changes.
            ///
            /// Please consult the [Working with enums] section in the user guide for some
            /// guidelines.
            ///
            /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
            #[derive(Clone, Debug, PartialEq)]
            #[non_exhaustive]
            pub enum SemanticSimilarityChannel {
                /// Metric unspecified. Defaults to TEXT.
                Unspecified,
                /// Use text semantic similarity.
                Text,
                /// Use audio semantic similarity.
                Audio,
                /// If set, the enum was initialized with an unknown value.
                ///
                /// Applications can examine the value using [SemanticSimilarityChannel::value] or
                /// [SemanticSimilarityChannel::name].
                UnknownValue(semantic_similarity_channel::UnknownValue),
            }

            #[doc(hidden)]
            pub mod semantic_similarity_channel {
                #[allow(unused_imports)]
                use super::*;
                #[derive(Clone, Debug, PartialEq)]
                pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
            }

            impl SemanticSimilarityChannel {
                /// Gets the enum value.
                ///
                /// Returns `None` if the enum contains an unknown value deserialized from
                /// the string representation of enums.
                pub fn value(&self) -> std::option::Option<i32> {
                    match self {
                        Self::Unspecified => std::option::Option::Some(0),
                        Self::Text => std::option::Option::Some(1),
                        Self::Audio => std::option::Option::Some(2),
                        Self::UnknownValue(u) => u.0.value(),
                    }
                }

                /// Gets the enum value as a string.
                ///
                /// Returns `None` if the enum contains an unknown value deserialized from
                /// the integer representation of enums.
                pub fn name(&self) -> std::option::Option<&str> {
                    match self {
                        Self::Unspecified => {
                            std::option::Option::Some("SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED")
                        }
                        Self::Text => std::option::Option::Some("TEXT"),
                        Self::Audio => std::option::Option::Some("AUDIO"),
                        Self::UnknownValue(u) => u.0.name(),
                    }
                }
            }

            impl std::default::Default for SemanticSimilarityChannel {
                fn default() -> Self {
                    use std::convert::From;
                    Self::from(0)
                }
            }

            impl std::fmt::Display for SemanticSimilarityChannel {
                fn fmt(
                    &self,
                    f: &mut std::fmt::Formatter<'_>,
                ) -> std::result::Result<(), std::fmt::Error> {
                    wkt::internal::display_enum(f, self.name(), self.value())
                }
            }

            impl std::convert::From<i32> for SemanticSimilarityChannel {
                fn from(value: i32) -> Self {
                    match value {
                        0 => Self::Unspecified,
                        1 => Self::Text,
                        2 => Self::Audio,
                        _ => Self::UnknownValue(semantic_similarity_channel::UnknownValue(
                            wkt::internal::UnknownEnumValue::Integer(value),
                        )),
                    }
                }
            }

            impl std::convert::From<&str> for SemanticSimilarityChannel {
                fn from(value: &str) -> Self {
                    use std::string::ToString;
                    match value {
                        "SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED" => Self::Unspecified,
                        "TEXT" => Self::Text,
                        "AUDIO" => Self::Audio,
                        _ => Self::UnknownValue(semantic_similarity_channel::UnknownValue(
                            wkt::internal::UnknownEnumValue::String(value.to_string()),
                        )),
                    }
                }
            }

            impl serde::ser::Serialize for SemanticSimilarityChannel {
                fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
                where
                    S: serde::Serializer,
                {
                    match self {
                        Self::Unspecified => serializer.serialize_i32(0),
                        Self::Text => serializer.serialize_i32(1),
                        Self::Audio => serializer.serialize_i32(2),
                        Self::UnknownValue(u) => u.0.serialize(serializer),
                    }
                }
            }

            impl<'de> serde::de::Deserialize<'de> for SemanticSimilarityChannel {
                fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
                where
                    D: serde::Deserializer<'de>,
                {
                    deserializer.deserialize_any(wkt::internal::EnumVisitor::<SemanticSimilarityChannel>::new(
                        ".google.cloud.ces.v1.EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds.SemanticSimilarityChannel"))
                }
            }
        }

        /// Expectation level metrics thresholds.
        #[derive(Clone, Default, PartialEq)]
        #[non_exhaustive]
        pub struct ExpectationLevelMetricsThresholds {
            /// Optional. The success threshold for individual tool invocation
            /// parameter correctness. Must be a float between 0 and 1. Default is 1.0.
            pub tool_invocation_parameter_correctness_threshold: std::option::Option<f32>,

            pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
        }

        impl ExpectationLevelMetricsThresholds {
            /// Creates a new default instance.
            pub fn new() -> Self {
                std::default::Default::default()
            }

            /// Sets the value of [tool_invocation_parameter_correctness_threshold][crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::ExpectationLevelMetricsThresholds::tool_invocation_parameter_correctness_threshold].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::ExpectationLevelMetricsThresholds;
            /// let x = ExpectationLevelMetricsThresholds::new().set_tool_invocation_parameter_correctness_threshold(42.0);
            /// ```
            pub fn set_tool_invocation_parameter_correctness_threshold<T>(mut self, v: T) -> Self
            where
                T: std::convert::Into<f32>,
            {
                self.tool_invocation_parameter_correctness_threshold =
                    std::option::Option::Some(v.into());
                self
            }

            /// Sets or clears the value of [tool_invocation_parameter_correctness_threshold][crate::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::ExpectationLevelMetricsThresholds::tool_invocation_parameter_correctness_threshold].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::golden_evaluation_metrics_thresholds::ExpectationLevelMetricsThresholds;
            /// let x = ExpectationLevelMetricsThresholds::new().set_or_clear_tool_invocation_parameter_correctness_threshold(Some(42.0));
            /// let x = ExpectationLevelMetricsThresholds::new().set_or_clear_tool_invocation_parameter_correctness_threshold(None::<f32>);
            /// ```
            pub fn set_or_clear_tool_invocation_parameter_correctness_threshold<T>(
                mut self,
                v: std::option::Option<T>,
            ) -> Self
            where
                T: std::convert::Into<f32>,
            {
                self.tool_invocation_parameter_correctness_threshold = v.map(|x| x.into());
                self
            }
        }

        impl wkt::message::Message for ExpectationLevelMetricsThresholds {
            fn typename() -> &'static str {
                "type.googleapis.com/google.cloud.ces.v1.EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.ExpectationLevelMetricsThresholds"
            }
        }
    }

    /// Settings for matching tool calls.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct ToolMatchingSettings {

        /// Optional. Behavior for extra tool calls.
        /// Defaults to FAIL.
        pub extra_tool_call_behavior: crate::model::evaluation_metrics_thresholds::tool_matching_settings::ExtraToolCallBehavior,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl ToolMatchingSettings {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [extra_tool_call_behavior][crate::model::evaluation_metrics_thresholds::ToolMatchingSettings::extra_tool_call_behavior].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::evaluation_metrics_thresholds::ToolMatchingSettings;
        /// use google_cloud_ces_v1::model::evaluation_metrics_thresholds::tool_matching_settings::ExtraToolCallBehavior;
        /// let x0 = ToolMatchingSettings::new().set_extra_tool_call_behavior(ExtraToolCallBehavior::Fail);
        /// let x1 = ToolMatchingSettings::new().set_extra_tool_call_behavior(ExtraToolCallBehavior::Allow);
        /// ```
        pub fn set_extra_tool_call_behavior<T: std::convert::Into<crate::model::evaluation_metrics_thresholds::tool_matching_settings::ExtraToolCallBehavior>>(mut self, v: T) -> Self{
            self.extra_tool_call_behavior = v.into();
            self
        }
    }

    impl wkt::message::Message for ToolMatchingSettings {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.EvaluationMetricsThresholds.ToolMatchingSettings"
        }
    }

    /// Defines additional types related to [ToolMatchingSettings].
    pub mod tool_matching_settings {
        #[allow(unused_imports)]
        use super::*;

        /// Defines the behavior when an extra tool call is encountered. An extra
        /// tool call is a tool call that is present in the execution but does not
        /// match any tool call in the golden expectation.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum ExtraToolCallBehavior {
            /// Unspecified behavior. Defaults to FAIL.
            Unspecified,
            /// Fail the evaluation if an extra tool call is encountered.
            Fail,
            /// Allow the extra tool call.
            Allow,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [ExtraToolCallBehavior::value] or
            /// [ExtraToolCallBehavior::name].
            UnknownValue(extra_tool_call_behavior::UnknownValue),
        }

        #[doc(hidden)]
        pub mod extra_tool_call_behavior {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl ExtraToolCallBehavior {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::Fail => std::option::Option::Some(1),
                    Self::Allow => std::option::Option::Some(2),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => {
                        std::option::Option::Some("EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED")
                    }
                    Self::Fail => std::option::Option::Some("FAIL"),
                    Self::Allow => std::option::Option::Some("ALLOW"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for ExtraToolCallBehavior {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for ExtraToolCallBehavior {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for ExtraToolCallBehavior {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::Fail,
                    2 => Self::Allow,
                    _ => Self::UnknownValue(extra_tool_call_behavior::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for ExtraToolCallBehavior {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED" => Self::Unspecified,
                    "FAIL" => Self::Fail,
                    "ALLOW" => Self::Allow,
                    _ => Self::UnknownValue(extra_tool_call_behavior::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for ExtraToolCallBehavior {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::Fail => serializer.serialize_i32(1),
                    Self::Allow => serializer.serialize_i32(2),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for ExtraToolCallBehavior {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<ExtraToolCallBehavior>::new(
                    ".google.cloud.ces.v1.EvaluationMetricsThresholds.ToolMatchingSettings.ExtraToolCallBehavior"))
            }
        }
    }

    /// The hallucination metric behavior. Regardless of the behavior, the metric
    /// will always be calculated. The difference is that when disabled, the
    /// metric is not used to calculate the overall evaluation score.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum HallucinationMetricBehavior {
        /// Unspecified hallucination metric behavior.
        Unspecified,
        /// Disable hallucination metric.
        Disabled,
        /// Enable hallucination metric.
        Enabled,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [HallucinationMetricBehavior::value] or
        /// [HallucinationMetricBehavior::name].
        UnknownValue(hallucination_metric_behavior::UnknownValue),
    }

    #[doc(hidden)]
    pub mod hallucination_metric_behavior {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl HallucinationMetricBehavior {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Disabled => std::option::Option::Some(1),
                Self::Enabled => std::option::Option::Some(2),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => {
                    std::option::Option::Some("HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED")
                }
                Self::Disabled => std::option::Option::Some("DISABLED"),
                Self::Enabled => std::option::Option::Some("ENABLED"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for HallucinationMetricBehavior {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for HallucinationMetricBehavior {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for HallucinationMetricBehavior {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Disabled,
                2 => Self::Enabled,
                _ => Self::UnknownValue(hallucination_metric_behavior::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for HallucinationMetricBehavior {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED" => Self::Unspecified,
                "DISABLED" => Self::Disabled,
                "ENABLED" => Self::Enabled,
                _ => Self::UnknownValue(hallucination_metric_behavior::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for HallucinationMetricBehavior {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Disabled => serializer.serialize_i32(1),
                Self::Enabled => serializer.serialize_i32(2),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for HallucinationMetricBehavior {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(
                wkt::internal::EnumVisitor::<HallucinationMetricBehavior>::new(
                    ".google.cloud.ces.v1.EvaluationMetricsThresholds.HallucinationMetricBehavior",
                ),
            )
        }
    }
}

/// Settings for custom client certificates.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ClientCertificateSettings {
    /// Required. The TLS certificate encoded in PEM format. This string must
    /// include the begin header and end footer lines.
    pub tls_certificate: std::string::String,

    /// Required. The name of the SecretManager secret version resource storing the
    /// private key encoded in PEM format.
    /// Format: `projects/{project}/secrets/{secret}/versions/{version}`
    pub private_key: std::string::String,

    /// Optional. The name of the SecretManager secret version resource storing the
    /// passphrase to decrypt the private key. Should be left unset if the private
    /// key is not encrypted.
    /// Format: `projects/{project}/secrets/{secret}/versions/{version}`
    pub passphrase: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ClientCertificateSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [tls_certificate][crate::model::ClientCertificateSettings::tls_certificate].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ClientCertificateSettings;
    /// let x = ClientCertificateSettings::new().set_tls_certificate("example");
    /// ```
    pub fn set_tls_certificate<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tls_certificate = v.into();
        self
    }

    /// Sets the value of [private_key][crate::model::ClientCertificateSettings::private_key].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ClientCertificateSettings;
    /// let x = ClientCertificateSettings::new().set_private_key("example");
    /// ```
    pub fn set_private_key<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.private_key = v.into();
        self
    }

    /// Sets the value of [passphrase][crate::model::ClientCertificateSettings::passphrase].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ClientCertificateSettings;
    /// let x = ClientCertificateSettings::new().set_passphrase("example");
    /// ```
    pub fn set_passphrase<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.passphrase = v.into();
        self
    }
}

impl wkt::message::Message for ClientCertificateSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ClientCertificateSettings"
    }
}

/// VPC-SC settings for the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct VpcScSettings {
    /// Optional. The allowed HTTP(s) origins that OpenAPI tools in the App are
    /// able to directly call when VPC Service Controls are enabled. These strings
    /// must match the origin exactly, including the port if specified. For
    /// example, `https://example.com` or "<https://example.com>:443". This list does
    /// not yet apply to Python tools that may make direct HTTP calls.
    pub allowed_origins: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl VpcScSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [allowed_origins][crate::model::VpcScSettings::allowed_origins].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::VpcScSettings;
    /// let x = VpcScSettings::new().set_allowed_origins(["a", "b", "c"]);
    /// ```
    pub fn set_allowed_origins<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.allowed_origins = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for VpcScSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.VpcScSettings"
    }
}

/// Settings to describe the conversation logging behaviors for the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ConversationLoggingSettings {
    /// Optional. Whether to disable conversation logging for the sessions.
    pub disable_conversation_logging: bool,

    /// Optional. Controls the retention window for the conversation.
    /// If not set, the conversation will be retained for 365 days.
    pub retention_window: std::option::Option<wkt::Duration>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ConversationLoggingSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [disable_conversation_logging][crate::model::ConversationLoggingSettings::disable_conversation_logging].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConversationLoggingSettings;
    /// let x = ConversationLoggingSettings::new().set_disable_conversation_logging(true);
    /// ```
    pub fn set_disable_conversation_logging<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.disable_conversation_logging = v.into();
        self
    }

    /// Sets the value of [retention_window][crate::model::ConversationLoggingSettings::retention_window].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConversationLoggingSettings;
    /// use wkt::Duration;
    /// let x = ConversationLoggingSettings::new().set_retention_window(Duration::default()/* use setters */);
    /// ```
    pub fn set_retention_window<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.retention_window = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [retention_window][crate::model::ConversationLoggingSettings::retention_window].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConversationLoggingSettings;
    /// use wkt::Duration;
    /// let x = ConversationLoggingSettings::new().set_or_clear_retention_window(Some(Duration::default()/* use setters */));
    /// let x = ConversationLoggingSettings::new().set_or_clear_retention_window(None::<Duration>);
    /// ```
    pub fn set_or_clear_retention_window<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.retention_window = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for ConversationLoggingSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ConversationLoggingSettings"
    }
}

/// Settings to describe the Cloud Logging behaviors for the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CloudLoggingSettings {
    /// Optional. Whether to enable Cloud Logging for the sessions.
    pub enable_cloud_logging: bool,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CloudLoggingSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [enable_cloud_logging][crate::model::CloudLoggingSettings::enable_cloud_logging].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CloudLoggingSettings;
    /// let x = CloudLoggingSettings::new().set_enable_cloud_logging(true);
    /// ```
    pub fn set_enable_cloud_logging<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.enable_cloud_logging = v.into();
        self
    }
}

impl wkt::message::Message for CloudLoggingSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CloudLoggingSettings"
    }
}

/// Configuration for how the audio interactions should be recorded.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AudioRecordingConfig {
    /// Optional. The [Cloud Storage](https://cloud.google.com/storage) bucket to
    /// store the session audio recordings. The URI must start with "gs://".
    ///
    /// Please choose a bucket location that meets your data residency
    /// requirements.
    ///
    /// Note: If the Cloud Storage bucket is in a different project from the app,
    /// you should grant `storage.objects.create` permission to the CES service
    /// agent `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com`.
    pub gcs_bucket: std::string::String,

    /// Optional. The Cloud Storage path prefix for audio recordings.
    ///
    /// This prefix can include the following placeholders, which will be
    /// dynamically substituted at serving time:
    ///
    /// - $project:   project ID
    /// - $location:  app location
    /// - $app:       app ID
    /// - $date:      session date in YYYY-MM-DD format
    /// - $session:   session ID
    ///
    /// If the path prefix is not specified, the default prefix
    /// `$project/$location/$app/$date/$session/` will be used.
    pub gcs_path_prefix: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AudioRecordingConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [gcs_bucket][crate::model::AudioRecordingConfig::gcs_bucket].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AudioRecordingConfig;
    /// let x = AudioRecordingConfig::new().set_gcs_bucket("example");
    /// ```
    pub fn set_gcs_bucket<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.gcs_bucket = v.into();
        self
    }

    /// Sets the value of [gcs_path_prefix][crate::model::AudioRecordingConfig::gcs_path_prefix].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AudioRecordingConfig;
    /// let x = AudioRecordingConfig::new().set_gcs_path_prefix("example");
    /// ```
    pub fn set_gcs_path_prefix<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.gcs_path_prefix = v.into();
        self
    }
}

impl wkt::message::Message for AudioRecordingConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AudioRecordingConfig"
    }
}

/// Configuration to instruct how sensitive data should be handled.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RedactionConfig {
    /// Optional. If true, redaction will be applied in various logging scenarios,
    /// including conversation history, Cloud Logging and audio recording.
    pub enable_redaction: bool,

    /// Optional. [DLP](https://cloud.google.com/dlp/docs) inspect template name to
    /// configure detection of sensitive data types.
    ///
    /// Format:
    /// `projects/{project}/locations/{location}/inspectTemplates/{inspect_template}`
    pub inspect_template: std::string::String,

    /// Optional. [DLP](https://cloud.google.com/dlp/docs) deidentify template name
    /// to instruct on how to de-identify content.
    ///
    /// Format:
    /// `projects/{project}/locations/{location}/deidentifyTemplates/{deidentify_template}`
    pub deidentify_template: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RedactionConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [enable_redaction][crate::model::RedactionConfig::enable_redaction].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RedactionConfig;
    /// let x = RedactionConfig::new().set_enable_redaction(true);
    /// ```
    pub fn set_enable_redaction<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.enable_redaction = v.into();
        self
    }

    /// Sets the value of [inspect_template][crate::model::RedactionConfig::inspect_template].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RedactionConfig;
    /// let x = RedactionConfig::new().set_inspect_template("example");
    /// ```
    pub fn set_inspect_template<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.inspect_template = v.into();
        self
    }

    /// Sets the value of [deidentify_template][crate::model::RedactionConfig::deidentify_template].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RedactionConfig;
    /// let x = RedactionConfig::new().set_deidentify_template("example");
    /// ```
    pub fn set_deidentify_template<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.deidentify_template = v.into();
        self
    }
}

impl wkt::message::Message for RedactionConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RedactionConfig"
    }
}

/// Data store related settings for the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DataStoreSettings {
    /// Output only. The engines for the app.
    pub engines: std::vec::Vec<crate::model::data_store_settings::Engine>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DataStoreSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [engines][crate::model::DataStoreSettings::engines].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStoreSettings;
    /// use google_cloud_ces_v1::model::data_store_settings::Engine;
    /// let x = DataStoreSettings::new()
    ///     .set_engines([
    ///         Engine::default()/* use setters */,
    ///         Engine::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_engines<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::data_store_settings::Engine>,
    {
        use std::iter::Iterator;
        self.engines = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for DataStoreSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DataStoreSettings"
    }
}

/// Defines additional types related to [DataStoreSettings].
pub mod data_store_settings {
    #[allow(unused_imports)]
    use super::*;

    /// An engine to which the data stores are connected.
    /// See Vertex AI Search:
    /// <https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction>.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct Engine {
        /// Output only. The resource name of the engine.
        /// Format:
        /// `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`
        pub name: std::string::String,

        /// Output only. The type of the engine.
        pub r#type: crate::model::data_store_settings::engine::Type,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl Engine {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [name][crate::model::data_store_settings::Engine::name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_settings::Engine;
        /// let x = Engine::new().set_name("example");
        /// ```
        pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.name = v.into();
            self
        }

        /// Sets the value of [r#type][crate::model::data_store_settings::Engine::type].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_settings::Engine;
        /// use google_cloud_ces_v1::model::data_store_settings::engine::Type;
        /// let x0 = Engine::new().set_type(Type::EngineTypeSearch);
        /// let x1 = Engine::new().set_type(Type::EngineTypeChat);
        /// ```
        pub fn set_type<T: std::convert::Into<crate::model::data_store_settings::engine::Type>>(
            mut self,
            v: T,
        ) -> Self {
            self.r#type = v.into();
            self
        }
    }

    impl wkt::message::Message for Engine {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStoreSettings.Engine"
        }
    }

    /// Defines additional types related to [Engine].
    pub mod engine {
        #[allow(unused_imports)]
        use super::*;

        /// The type of the engine.
        /// See the documentation available at
        /// <https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1/SolutionType>
        /// and
        /// <https://cloud.google.com/generative-ai-app-builder/docs/create-datastore-ingest>.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum Type {
            /// Unspecified engine type.
            Unspecified,
            /// The SOLUTION_TYPE_SEARCH engine for the app. All connector data stores
            /// added to the app will be added to this engine.
            EngineTypeSearch,
            /// Chat engine type.
            /// The SOLUTION_TYPE_CHAT engine for the app. All connector data stores
            /// added to the app will be added to this engine.
            EngineTypeChat,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [Type::value] or
            /// [Type::name].
            UnknownValue(r#type::UnknownValue),
        }

        #[doc(hidden)]
        pub mod r#type {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl Type {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::EngineTypeSearch => std::option::Option::Some(1),
                    Self::EngineTypeChat => std::option::Option::Some(2),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("TYPE_UNSPECIFIED"),
                    Self::EngineTypeSearch => std::option::Option::Some("ENGINE_TYPE_SEARCH"),
                    Self::EngineTypeChat => std::option::Option::Some("ENGINE_TYPE_CHAT"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for Type {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for Type {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for Type {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::EngineTypeSearch,
                    2 => Self::EngineTypeChat,
                    _ => Self::UnknownValue(r#type::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for Type {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "TYPE_UNSPECIFIED" => Self::Unspecified,
                    "ENGINE_TYPE_SEARCH" => Self::EngineTypeSearch,
                    "ENGINE_TYPE_CHAT" => Self::EngineTypeChat,
                    _ => Self::UnknownValue(r#type::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for Type {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::EngineTypeSearch => serializer.serialize_i32(1),
                    Self::EngineTypeChat => serializer.serialize_i32(2),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for Type {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<Type>::new(
                    ".google.cloud.ces.v1.DataStoreSettings.Engine.Type",
                ))
            }
        }
    }
}

/// A snapshot of the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AppSnapshot {
    /// Optional. The basic settings for the app.
    pub app: std::option::Option<crate::model::App>,

    /// Optional. List of agents in the app.
    pub agents: std::vec::Vec<crate::model::Agent>,

    /// Optional. List of tools in the app.
    pub tools: std::vec::Vec<crate::model::Tool>,

    /// Optional. List of examples in the app.
    pub examples: std::vec::Vec<crate::model::Example>,

    /// Optional. List of guardrails in the app.
    pub guardrails: std::vec::Vec<crate::model::Guardrail>,

    /// Optional. List of toolsets in the app.
    pub toolsets: std::vec::Vec<crate::model::Toolset>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AppSnapshot {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [app][crate::model::AppSnapshot::app].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppSnapshot;
    /// use google_cloud_ces_v1::model::App;
    /// let x = AppSnapshot::new().set_app(App::default()/* use setters */);
    /// ```
    pub fn set_app<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::App>,
    {
        self.app = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [app][crate::model::AppSnapshot::app].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppSnapshot;
    /// use google_cloud_ces_v1::model::App;
    /// let x = AppSnapshot::new().set_or_clear_app(Some(App::default()/* use setters */));
    /// let x = AppSnapshot::new().set_or_clear_app(None::<App>);
    /// ```
    pub fn set_or_clear_app<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::App>,
    {
        self.app = v.map(|x| x.into());
        self
    }

    /// Sets the value of [agents][crate::model::AppSnapshot::agents].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppSnapshot;
    /// use google_cloud_ces_v1::model::Agent;
    /// let x = AppSnapshot::new()
    ///     .set_agents([
    ///         Agent::default()/* use setters */,
    ///         Agent::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_agents<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Agent>,
    {
        use std::iter::Iterator;
        self.agents = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [tools][crate::model::AppSnapshot::tools].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppSnapshot;
    /// use google_cloud_ces_v1::model::Tool;
    /// let x = AppSnapshot::new()
    ///     .set_tools([
    ///         Tool::default()/* use setters */,
    ///         Tool::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_tools<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Tool>,
    {
        use std::iter::Iterator;
        self.tools = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [examples][crate::model::AppSnapshot::examples].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppSnapshot;
    /// use google_cloud_ces_v1::model::Example;
    /// let x = AppSnapshot::new()
    ///     .set_examples([
    ///         Example::default()/* use setters */,
    ///         Example::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_examples<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Example>,
    {
        use std::iter::Iterator;
        self.examples = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [guardrails][crate::model::AppSnapshot::guardrails].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppSnapshot;
    /// use google_cloud_ces_v1::model::Guardrail;
    /// let x = AppSnapshot::new()
    ///     .set_guardrails([
    ///         Guardrail::default()/* use setters */,
    ///         Guardrail::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_guardrails<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Guardrail>,
    {
        use std::iter::Iterator;
        self.guardrails = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [toolsets][crate::model::AppSnapshot::toolsets].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppSnapshot;
    /// use google_cloud_ces_v1::model::Toolset;
    /// let x = AppSnapshot::new()
    ///     .set_toolsets([
    ///         Toolset::default()/* use setters */,
    ///         Toolset::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_toolsets<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Toolset>,
    {
        use std::iter::Iterator;
        self.toolsets = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for AppSnapshot {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AppSnapshot"
    }
}

/// In Customer Engagement Suite (CES), an app version is a snapshot of the app
/// at a specific point in time. It is immutable and cannot be modified once
/// created.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AppVersion {
    /// Identifier. The unique identifier of the app version.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/versions/{version}`
    pub name: std::string::String,

    /// Optional. The display name of the app version.
    pub display_name: std::string::String,

    /// Optional. The description of the app version.
    pub description: std::string::String,

    /// Output only. Email of the user who created the app version.
    pub creator: std::string::String,

    /// Output only. Timestamp when the app version was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. The snapshot of the app when the version is created.
    pub snapshot: std::option::Option<crate::model::AppSnapshot>,

    /// Output only. Etag used to ensure the object hasn't changed during a
    /// read-modify-write operation. If the etag is empty, the update will
    /// overwrite any concurrent changes.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AppVersion {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::AppVersion::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppVersion;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let version_id = "version_id";
    /// let x = AppVersion::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/versions/{version_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::AppVersion::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppVersion;
    /// let x = AppVersion::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::AppVersion::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppVersion;
    /// let x = AppVersion::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [creator][crate::model::AppVersion::creator].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppVersion;
    /// let x = AppVersion::new().set_creator("example");
    /// ```
    pub fn set_creator<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.creator = v.into();
        self
    }

    /// Sets the value of [create_time][crate::model::AppVersion::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppVersion;
    /// use wkt::Timestamp;
    /// let x = AppVersion::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::AppVersion::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppVersion;
    /// use wkt::Timestamp;
    /// let x = AppVersion::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = AppVersion::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [snapshot][crate::model::AppVersion::snapshot].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppVersion;
    /// use google_cloud_ces_v1::model::AppSnapshot;
    /// let x = AppVersion::new().set_snapshot(AppSnapshot::default()/* use setters */);
    /// ```
    pub fn set_snapshot<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::AppSnapshot>,
    {
        self.snapshot = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [snapshot][crate::model::AppVersion::snapshot].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppVersion;
    /// use google_cloud_ces_v1::model::AppSnapshot;
    /// let x = AppVersion::new().set_or_clear_snapshot(Some(AppSnapshot::default()/* use setters */));
    /// let x = AppVersion::new().set_or_clear_snapshot(None::<AppSnapshot>);
    /// ```
    pub fn set_or_clear_snapshot<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::AppSnapshot>,
    {
        self.snapshot = v.map(|x| x.into());
        self
    }

    /// Sets the value of [etag][crate::model::AppVersion::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AppVersion;
    /// let x = AppVersion::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for AppVersion {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AppVersion"
    }
}

/// Configurations for authentication with API key.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ApiKeyConfig {
    /// Required. The parameter name or the header name of the API key.
    /// E.g., If the API request is "<https://example.com/act?X-Api-Key=>\<API
    /// KEY\>", "X-Api-Key" would be the parameter name.
    pub key_name: std::string::String,

    /// Required. The name of the SecretManager secret version resource storing the
    /// API key. Format: `projects/{project}/secrets/{secret}/versions/{version}`
    ///
    /// Note: You should grant `roles/secretmanager.secretAccessor` role to the CES
    /// service agent
    /// `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com`.
    pub api_key_secret_version: std::string::String,

    /// Required. Key location in the request.
    pub request_location: crate::model::api_key_config::RequestLocation,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ApiKeyConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [key_name][crate::model::ApiKeyConfig::key_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ApiKeyConfig;
    /// let x = ApiKeyConfig::new().set_key_name("example");
    /// ```
    pub fn set_key_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.key_name = v.into();
        self
    }

    /// Sets the value of [api_key_secret_version][crate::model::ApiKeyConfig::api_key_secret_version].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ApiKeyConfig;
    /// let x = ApiKeyConfig::new().set_api_key_secret_version("example");
    /// ```
    pub fn set_api_key_secret_version<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.api_key_secret_version = v.into();
        self
    }

    /// Sets the value of [request_location][crate::model::ApiKeyConfig::request_location].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ApiKeyConfig;
    /// use google_cloud_ces_v1::model::api_key_config::RequestLocation;
    /// let x0 = ApiKeyConfig::new().set_request_location(RequestLocation::Header);
    /// let x1 = ApiKeyConfig::new().set_request_location(RequestLocation::QueryString);
    /// ```
    pub fn set_request_location<
        T: std::convert::Into<crate::model::api_key_config::RequestLocation>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.request_location = v.into();
        self
    }
}

impl wkt::message::Message for ApiKeyConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ApiKeyConfig"
    }
}

/// Defines additional types related to [ApiKeyConfig].
pub mod api_key_config {
    #[allow(unused_imports)]
    use super::*;

    /// The location of the API key in the request.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum RequestLocation {
        /// Unspecified. This value should not be used.
        Unspecified,
        /// Represents the key in http header.
        Header,
        /// Represents the key in query string.
        QueryString,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [RequestLocation::value] or
        /// [RequestLocation::name].
        UnknownValue(request_location::UnknownValue),
    }

    #[doc(hidden)]
    pub mod request_location {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl RequestLocation {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Header => std::option::Option::Some(1),
                Self::QueryString => std::option::Option::Some(2),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("REQUEST_LOCATION_UNSPECIFIED"),
                Self::Header => std::option::Option::Some("HEADER"),
                Self::QueryString => std::option::Option::Some("QUERY_STRING"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for RequestLocation {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for RequestLocation {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for RequestLocation {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Header,
                2 => Self::QueryString,
                _ => Self::UnknownValue(request_location::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for RequestLocation {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "REQUEST_LOCATION_UNSPECIFIED" => Self::Unspecified,
                "HEADER" => Self::Header,
                "QUERY_STRING" => Self::QueryString,
                _ => Self::UnknownValue(request_location::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for RequestLocation {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Header => serializer.serialize_i32(1),
                Self::QueryString => serializer.serialize_i32(2),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for RequestLocation {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<RequestLocation>::new(
                ".google.cloud.ces.v1.ApiKeyConfig.RequestLocation",
            ))
        }
    }
}

/// Configurations for authentication with OAuth.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct OAuthConfig {
    /// Required. OAuth grant types.
    pub oauth_grant_type: crate::model::o_auth_config::OauthGrantType,

    /// Required. The client ID from the OAuth provider.
    pub client_id: std::string::String,

    /// Required. The name of the SecretManager secret version resource storing the
    /// client secret.
    /// Format: `projects/{project}/secrets/{secret}/versions/{version}`
    ///
    /// Note: You should grant `roles/secretmanager.secretAccessor` role to the CES
    /// service agent
    /// `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com`.
    pub client_secret_version: std::string::String,

    /// Required. The token endpoint in the OAuth provider to exchange for an
    /// access token.
    pub token_endpoint: std::string::String,

    /// Optional. The OAuth scopes to grant.
    pub scopes: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl OAuthConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [oauth_grant_type][crate::model::OAuthConfig::oauth_grant_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OAuthConfig;
    /// use google_cloud_ces_v1::model::o_auth_config::OauthGrantType;
    /// let x0 = OAuthConfig::new().set_oauth_grant_type(OauthGrantType::ClientCredential);
    /// ```
    pub fn set_oauth_grant_type<
        T: std::convert::Into<crate::model::o_auth_config::OauthGrantType>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.oauth_grant_type = v.into();
        self
    }

    /// Sets the value of [client_id][crate::model::OAuthConfig::client_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OAuthConfig;
    /// let x = OAuthConfig::new().set_client_id("example");
    /// ```
    pub fn set_client_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.client_id = v.into();
        self
    }

    /// Sets the value of [client_secret_version][crate::model::OAuthConfig::client_secret_version].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OAuthConfig;
    /// let x = OAuthConfig::new().set_client_secret_version("example");
    /// ```
    pub fn set_client_secret_version<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.client_secret_version = v.into();
        self
    }

    /// Sets the value of [token_endpoint][crate::model::OAuthConfig::token_endpoint].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OAuthConfig;
    /// let x = OAuthConfig::new().set_token_endpoint("example");
    /// ```
    pub fn set_token_endpoint<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.token_endpoint = v.into();
        self
    }

    /// Sets the value of [scopes][crate::model::OAuthConfig::scopes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OAuthConfig;
    /// let x = OAuthConfig::new().set_scopes(["a", "b", "c"]);
    /// ```
    pub fn set_scopes<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.scopes = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for OAuthConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.OAuthConfig"
    }
}

/// Defines additional types related to [OAuthConfig].
pub mod o_auth_config {
    #[allow(unused_imports)]
    use super::*;

    /// OAuth grant types. Only [client credential
    /// grant](https://oauth.net/2/grant-types/client-credentials) is supported.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum OauthGrantType {
        /// Unspecified. Defaults to CLIENT_CREDENTIAL.
        Unspecified,
        /// Represents the [client credential
        /// flow](https://oauth.net/2/grant-types/client-credentials).
        ClientCredential,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [OauthGrantType::value] or
        /// [OauthGrantType::name].
        UnknownValue(oauth_grant_type::UnknownValue),
    }

    #[doc(hidden)]
    pub mod oauth_grant_type {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl OauthGrantType {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::ClientCredential => std::option::Option::Some(1),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("OAUTH_GRANT_TYPE_UNSPECIFIED"),
                Self::ClientCredential => std::option::Option::Some("CLIENT_CREDENTIAL"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for OauthGrantType {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for OauthGrantType {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for OauthGrantType {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::ClientCredential,
                _ => Self::UnknownValue(oauth_grant_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for OauthGrantType {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "OAUTH_GRANT_TYPE_UNSPECIFIED" => Self::Unspecified,
                "CLIENT_CREDENTIAL" => Self::ClientCredential,
                _ => Self::UnknownValue(oauth_grant_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for OauthGrantType {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::ClientCredential => serializer.serialize_i32(1),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for OauthGrantType {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<OauthGrantType>::new(
                ".google.cloud.ces.v1.OAuthConfig.OauthGrantType",
            ))
        }
    }
}

/// Configurations for authentication with [ID
/// token](https://cloud.google.com/docs/authentication/token-types#id) generated
/// from service agent.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ServiceAgentIdTokenAuthConfig {
    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ServiceAgentIdTokenAuthConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }
}

impl wkt::message::Message for ServiceAgentIdTokenAuthConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ServiceAgentIdTokenAuthConfig"
    }
}

/// Configurations for authentication using a custom service account.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ServiceAccountAuthConfig {
    /// Required. The email address of the service account used for authentication.
    /// CES uses this service account to exchange an access token and the access
    /// token is then sent in the `Authorization` header of the request.
    ///
    /// The service account must have the
    /// `roles/iam.serviceAccountTokenCreator` role granted to the
    /// CES service agent
    /// `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com`.
    pub service_account: std::string::String,

    /// Optional. The OAuth scopes to grant. If not specified, the default scope
    /// `<https://www.googleapis.com/auth/cloud-platform>` is used.
    pub scopes: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ServiceAccountAuthConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [service_account][crate::model::ServiceAccountAuthConfig::service_account].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ServiceAccountAuthConfig;
    /// let x = ServiceAccountAuthConfig::new().set_service_account("example");
    /// ```
    pub fn set_service_account<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.service_account = v.into();
        self
    }

    /// Sets the value of [scopes][crate::model::ServiceAccountAuthConfig::scopes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ServiceAccountAuthConfig;
    /// let x = ServiceAccountAuthConfig::new().set_scopes(["a", "b", "c"]);
    /// ```
    pub fn set_scopes<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.scopes = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for ServiceAccountAuthConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ServiceAccountAuthConfig"
    }
}

/// Configurations for authentication with a bearer token.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct BearerTokenConfig {
    /// Required. The bearer token.
    /// Must be in the format `$context.variables.<name_of_variable>`.
    pub token: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl BearerTokenConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [token][crate::model::BearerTokenConfig::token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BearerTokenConfig;
    /// let x = BearerTokenConfig::new().set_token("example");
    /// ```
    pub fn set_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.token = v.into();
        self
    }
}

impl wkt::message::Message for BearerTokenConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.BearerTokenConfig"
    }
}

/// End-user authentication configuration used for Connection calls.
/// The field values must be the names of context variables in the format
/// `$context.variables.<name_of_variable>`.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct EndUserAuthConfig {
    /// The auth configuration.
    pub auth_config: std::option::Option<crate::model::end_user_auth_config::AuthConfig>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl EndUserAuthConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [auth_config][crate::model::EndUserAuthConfig::auth_config].
    ///
    /// Note that all the setters affecting `auth_config` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EndUserAuthConfig;
    /// use google_cloud_ces_v1::model::end_user_auth_config::Oauth2AuthCodeConfig;
    /// let x = EndUserAuthConfig::new().set_auth_config(Some(
    ///     google_cloud_ces_v1::model::end_user_auth_config::AuthConfig::Oauth2AuthCodeConfig(Oauth2AuthCodeConfig::default().into())));
    /// ```
    pub fn set_auth_config<
        T: std::convert::Into<std::option::Option<crate::model::end_user_auth_config::AuthConfig>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.auth_config = v.into();
        self
    }

    /// The value of [auth_config][crate::model::EndUserAuthConfig::auth_config]
    /// if it holds a `Oauth2AuthCodeConfig`, `None` if the field is not set or
    /// holds a different branch.
    pub fn oauth2_auth_code_config(
        &self,
    ) -> std::option::Option<
        &std::boxed::Box<crate::model::end_user_auth_config::Oauth2AuthCodeConfig>,
    > {
        #[allow(unreachable_patterns)]
        self.auth_config.as_ref().and_then(|v| match v {
            crate::model::end_user_auth_config::AuthConfig::Oauth2AuthCodeConfig(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [auth_config][crate::model::EndUserAuthConfig::auth_config]
    /// to hold a `Oauth2AuthCodeConfig`.
    ///
    /// Note that all the setters affecting `auth_config` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EndUserAuthConfig;
    /// use google_cloud_ces_v1::model::end_user_auth_config::Oauth2AuthCodeConfig;
    /// let x = EndUserAuthConfig::new().set_oauth2_auth_code_config(Oauth2AuthCodeConfig::default()/* use setters */);
    /// assert!(x.oauth2_auth_code_config().is_some());
    /// assert!(x.oauth2_jwt_bearer_config().is_none());
    /// ```
    pub fn set_oauth2_auth_code_config<
        T: std::convert::Into<
                std::boxed::Box<crate::model::end_user_auth_config::Oauth2AuthCodeConfig>,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.auth_config = std::option::Option::Some(
            crate::model::end_user_auth_config::AuthConfig::Oauth2AuthCodeConfig(v.into()),
        );
        self
    }

    /// The value of [auth_config][crate::model::EndUserAuthConfig::auth_config]
    /// if it holds a `Oauth2JwtBearerConfig`, `None` if the field is not set or
    /// holds a different branch.
    pub fn oauth2_jwt_bearer_config(
        &self,
    ) -> std::option::Option<
        &std::boxed::Box<crate::model::end_user_auth_config::Oauth2JwtBearerConfig>,
    > {
        #[allow(unreachable_patterns)]
        self.auth_config.as_ref().and_then(|v| match v {
            crate::model::end_user_auth_config::AuthConfig::Oauth2JwtBearerConfig(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [auth_config][crate::model::EndUserAuthConfig::auth_config]
    /// to hold a `Oauth2JwtBearerConfig`.
    ///
    /// Note that all the setters affecting `auth_config` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EndUserAuthConfig;
    /// use google_cloud_ces_v1::model::end_user_auth_config::Oauth2JwtBearerConfig;
    /// let x = EndUserAuthConfig::new().set_oauth2_jwt_bearer_config(Oauth2JwtBearerConfig::default()/* use setters */);
    /// assert!(x.oauth2_jwt_bearer_config().is_some());
    /// assert!(x.oauth2_auth_code_config().is_none());
    /// ```
    pub fn set_oauth2_jwt_bearer_config<
        T: std::convert::Into<
                std::boxed::Box<crate::model::end_user_auth_config::Oauth2JwtBearerConfig>,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.auth_config = std::option::Option::Some(
            crate::model::end_user_auth_config::AuthConfig::Oauth2JwtBearerConfig(v.into()),
        );
        self
    }
}

impl wkt::message::Message for EndUserAuthConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.EndUserAuthConfig"
    }
}

/// Defines additional types related to [EndUserAuthConfig].
pub mod end_user_auth_config {
    #[allow(unused_imports)]
    use super::*;

    /// Oauth 2.0 Authorization Code authentication configuration.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct Oauth2AuthCodeConfig {
        /// Required. Oauth token parameter name to pass through.
        /// Must be in the format `$context.variables.<name_of_variable>`.
        pub oauth_token: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl Oauth2AuthCodeConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [oauth_token][crate::model::end_user_auth_config::Oauth2AuthCodeConfig::oauth_token].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::end_user_auth_config::Oauth2AuthCodeConfig;
        /// let x = Oauth2AuthCodeConfig::new().set_oauth_token("example");
        /// ```
        pub fn set_oauth_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.oauth_token = v.into();
            self
        }
    }

    impl wkt::message::Message for Oauth2AuthCodeConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.EndUserAuthConfig.Oauth2AuthCodeConfig"
        }
    }

    /// JWT Profile Oauth 2.0 Authorization Grant authentication configuration.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct Oauth2JwtBearerConfig {
        /// Required. Issuer parameter name to pass through.
        /// Must be in the format `$context.variables.<name_of_variable>`.
        pub issuer: std::string::String,

        /// Required. Subject parameter name to pass through.
        /// Must be in the format `$context.variables.<name_of_variable>`.
        pub subject: std::string::String,

        /// Required. Client parameter name to pass through.
        /// Must be in the format `$context.variables.<name_of_variable>`.
        pub client_key: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl Oauth2JwtBearerConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [issuer][crate::model::end_user_auth_config::Oauth2JwtBearerConfig::issuer].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::end_user_auth_config::Oauth2JwtBearerConfig;
        /// let x = Oauth2JwtBearerConfig::new().set_issuer("example");
        /// ```
        pub fn set_issuer<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.issuer = v.into();
            self
        }

        /// Sets the value of [subject][crate::model::end_user_auth_config::Oauth2JwtBearerConfig::subject].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::end_user_auth_config::Oauth2JwtBearerConfig;
        /// let x = Oauth2JwtBearerConfig::new().set_subject("example");
        /// ```
        pub fn set_subject<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.subject = v.into();
            self
        }

        /// Sets the value of [client_key][crate::model::end_user_auth_config::Oauth2JwtBearerConfig::client_key].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::end_user_auth_config::Oauth2JwtBearerConfig;
        /// let x = Oauth2JwtBearerConfig::new().set_client_key("example");
        /// ```
        pub fn set_client_key<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.client_key = v.into();
            self
        }
    }

    impl wkt::message::Message for Oauth2JwtBearerConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.EndUserAuthConfig.Oauth2JwtBearerConfig"
        }
    }

    /// The auth configuration.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum AuthConfig {
        /// Oauth 2.0 Authorization Code authentication.
        Oauth2AuthCodeConfig(
            std::boxed::Box<crate::model::end_user_auth_config::Oauth2AuthCodeConfig>,
        ),
        /// JWT Profile Oauth 2.0 Authorization Grant authentication.
        Oauth2JwtBearerConfig(
            std::boxed::Box<crate::model::end_user_auth_config::Oauth2JwtBearerConfig>,
        ),
    }
}

/// Authentication information required for API calls.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ApiAuthentication {
    /// The auth configuration.
    pub auth_config: std::option::Option<crate::model::api_authentication::AuthConfig>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ApiAuthentication {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [auth_config][crate::model::ApiAuthentication::auth_config].
    ///
    /// Note that all the setters affecting `auth_config` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ApiAuthentication;
    /// use google_cloud_ces_v1::model::ApiKeyConfig;
    /// let x = ApiAuthentication::new().set_auth_config(Some(
    ///     google_cloud_ces_v1::model::api_authentication::AuthConfig::ApiKeyConfig(ApiKeyConfig::default().into())));
    /// ```
    pub fn set_auth_config<
        T: std::convert::Into<std::option::Option<crate::model::api_authentication::AuthConfig>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.auth_config = v.into();
        self
    }

    /// The value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// if it holds a `ApiKeyConfig`, `None` if the field is not set or
    /// holds a different branch.
    pub fn api_key_config(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::ApiKeyConfig>> {
        #[allow(unreachable_patterns)]
        self.auth_config.as_ref().and_then(|v| match v {
            crate::model::api_authentication::AuthConfig::ApiKeyConfig(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// to hold a `ApiKeyConfig`.
    ///
    /// Note that all the setters affecting `auth_config` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ApiAuthentication;
    /// use google_cloud_ces_v1::model::ApiKeyConfig;
    /// let x = ApiAuthentication::new().set_api_key_config(ApiKeyConfig::default()/* use setters */);
    /// assert!(x.api_key_config().is_some());
    /// assert!(x.oauth_config().is_none());
    /// assert!(x.service_agent_id_token_auth_config().is_none());
    /// assert!(x.service_account_auth_config().is_none());
    /// assert!(x.bearer_token_config().is_none());
    /// ```
    pub fn set_api_key_config<
        T: std::convert::Into<std::boxed::Box<crate::model::ApiKeyConfig>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.auth_config = std::option::Option::Some(
            crate::model::api_authentication::AuthConfig::ApiKeyConfig(v.into()),
        );
        self
    }

    /// The value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// if it holds a `OauthConfig`, `None` if the field is not set or
    /// holds a different branch.
    pub fn oauth_config(&self) -> std::option::Option<&std::boxed::Box<crate::model::OAuthConfig>> {
        #[allow(unreachable_patterns)]
        self.auth_config.as_ref().and_then(|v| match v {
            crate::model::api_authentication::AuthConfig::OauthConfig(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// to hold a `OauthConfig`.
    ///
    /// Note that all the setters affecting `auth_config` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ApiAuthentication;
    /// use google_cloud_ces_v1::model::OAuthConfig;
    /// let x = ApiAuthentication::new().set_oauth_config(OAuthConfig::default()/* use setters */);
    /// assert!(x.oauth_config().is_some());
    /// assert!(x.api_key_config().is_none());
    /// assert!(x.service_agent_id_token_auth_config().is_none());
    /// assert!(x.service_account_auth_config().is_none());
    /// assert!(x.bearer_token_config().is_none());
    /// ```
    pub fn set_oauth_config<T: std::convert::Into<std::boxed::Box<crate::model::OAuthConfig>>>(
        mut self,
        v: T,
    ) -> Self {
        self.auth_config = std::option::Option::Some(
            crate::model::api_authentication::AuthConfig::OauthConfig(v.into()),
        );
        self
    }

    /// The value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// if it holds a `ServiceAgentIdTokenAuthConfig`, `None` if the field is not set or
    /// holds a different branch.
    pub fn service_agent_id_token_auth_config(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::ServiceAgentIdTokenAuthConfig>> {
        #[allow(unreachable_patterns)]
        self.auth_config.as_ref().and_then(|v| match v {
            crate::model::api_authentication::AuthConfig::ServiceAgentIdTokenAuthConfig(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// to hold a `ServiceAgentIdTokenAuthConfig`.
    ///
    /// Note that all the setters affecting `auth_config` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ApiAuthentication;
    /// use google_cloud_ces_v1::model::ServiceAgentIdTokenAuthConfig;
    /// let x = ApiAuthentication::new().set_service_agent_id_token_auth_config(ServiceAgentIdTokenAuthConfig::default()/* use setters */);
    /// assert!(x.service_agent_id_token_auth_config().is_some());
    /// assert!(x.api_key_config().is_none());
    /// assert!(x.oauth_config().is_none());
    /// assert!(x.service_account_auth_config().is_none());
    /// assert!(x.bearer_token_config().is_none());
    /// ```
    pub fn set_service_agent_id_token_auth_config<
        T: std::convert::Into<std::boxed::Box<crate::model::ServiceAgentIdTokenAuthConfig>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.auth_config = std::option::Option::Some(
            crate::model::api_authentication::AuthConfig::ServiceAgentIdTokenAuthConfig(v.into()),
        );
        self
    }

    /// The value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// if it holds a `ServiceAccountAuthConfig`, `None` if the field is not set or
    /// holds a different branch.
    pub fn service_account_auth_config(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::ServiceAccountAuthConfig>> {
        #[allow(unreachable_patterns)]
        self.auth_config.as_ref().and_then(|v| match v {
            crate::model::api_authentication::AuthConfig::ServiceAccountAuthConfig(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// to hold a `ServiceAccountAuthConfig`.
    ///
    /// Note that all the setters affecting `auth_config` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ApiAuthentication;
    /// use google_cloud_ces_v1::model::ServiceAccountAuthConfig;
    /// let x = ApiAuthentication::new().set_service_account_auth_config(ServiceAccountAuthConfig::default()/* use setters */);
    /// assert!(x.service_account_auth_config().is_some());
    /// assert!(x.api_key_config().is_none());
    /// assert!(x.oauth_config().is_none());
    /// assert!(x.service_agent_id_token_auth_config().is_none());
    /// assert!(x.bearer_token_config().is_none());
    /// ```
    pub fn set_service_account_auth_config<
        T: std::convert::Into<std::boxed::Box<crate::model::ServiceAccountAuthConfig>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.auth_config = std::option::Option::Some(
            crate::model::api_authentication::AuthConfig::ServiceAccountAuthConfig(v.into()),
        );
        self
    }

    /// The value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// if it holds a `BearerTokenConfig`, `None` if the field is not set or
    /// holds a different branch.
    pub fn bearer_token_config(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::BearerTokenConfig>> {
        #[allow(unreachable_patterns)]
        self.auth_config.as_ref().and_then(|v| match v {
            crate::model::api_authentication::AuthConfig::BearerTokenConfig(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [auth_config][crate::model::ApiAuthentication::auth_config]
    /// to hold a `BearerTokenConfig`.
    ///
    /// Note that all the setters affecting `auth_config` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ApiAuthentication;
    /// use google_cloud_ces_v1::model::BearerTokenConfig;
    /// let x = ApiAuthentication::new().set_bearer_token_config(BearerTokenConfig::default()/* use setters */);
    /// assert!(x.bearer_token_config().is_some());
    /// assert!(x.api_key_config().is_none());
    /// assert!(x.oauth_config().is_none());
    /// assert!(x.service_agent_id_token_auth_config().is_none());
    /// assert!(x.service_account_auth_config().is_none());
    /// ```
    pub fn set_bearer_token_config<
        T: std::convert::Into<std::boxed::Box<crate::model::BearerTokenConfig>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.auth_config = std::option::Option::Some(
            crate::model::api_authentication::AuthConfig::BearerTokenConfig(v.into()),
        );
        self
    }
}

impl wkt::message::Message for ApiAuthentication {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ApiAuthentication"
    }
}

/// Defines additional types related to [ApiAuthentication].
pub mod api_authentication {
    #[allow(unused_imports)]
    use super::*;

    /// The auth configuration.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum AuthConfig {
        /// Optional. Config for API key auth.
        ApiKeyConfig(std::boxed::Box<crate::model::ApiKeyConfig>),
        /// Optional. Config for OAuth.
        OauthConfig(std::boxed::Box<crate::model::OAuthConfig>),
        /// Optional. Config for ID token auth generated from CES service agent.
        ServiceAgentIdTokenAuthConfig(std::boxed::Box<crate::model::ServiceAgentIdTokenAuthConfig>),
        /// Optional. Config for service account authentication.
        ServiceAccountAuthConfig(std::boxed::Box<crate::model::ServiceAccountAuthConfig>),
        /// Optional. Config for bearer token auth.
        BearerTokenConfig(std::boxed::Box<crate::model::BearerTokenConfig>),
    }
}

/// Settings to describe the BigQuery export behaviors for the app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct BigQueryExportSettings {
    /// Optional. Indicates whether the BigQuery export is enabled.
    pub enabled: bool,

    /// Optional. The **project ID** of the BigQuery dataset to export the data to.
    ///
    /// Note: If the BigQuery dataset is in a different project from the app,
    /// you should grant `roles/bigquery.admin` role to the CES service agent
    /// `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com`.
    pub project: std::string::String,

    /// Optional. The BigQuery **dataset ID** to export the data to.
    pub dataset: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl BigQueryExportSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [enabled][crate::model::BigQueryExportSettings::enabled].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BigQueryExportSettings;
    /// let x = BigQueryExportSettings::new().set_enabled(true);
    /// ```
    pub fn set_enabled<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.enabled = v.into();
        self
    }

    /// Sets the value of [project][crate::model::BigQueryExportSettings::project].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BigQueryExportSettings;
    /// let x = BigQueryExportSettings::new().set_project("example");
    /// ```
    pub fn set_project<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.project = v.into();
        self
    }

    /// Sets the value of [dataset][crate::model::BigQueryExportSettings::dataset].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BigQueryExportSettings;
    /// let x = BigQueryExportSettings::new().set_dataset("example");
    /// ```
    pub fn set_dataset<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.dataset = v.into();
        self
    }
}

impl wkt::message::Message for BigQueryExportSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.BigQueryExportSettings"
    }
}

/// Changelogs represent a change made to the app or to an resource within the
/// app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Changelog {
    /// Identifier. The unique identifier of the changelog.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}`
    pub name: std::string::String,

    /// Output only. Email address of the change author.
    pub author: std::string::String,

    /// Output only. Display name of the change. It typically should be the display
    /// name of the resource that was changed.
    pub display_name: std::string::String,

    /// Output only. Description of the change. which typically captures the
    /// changed fields in the resource.
    pub description: std::string::String,

    /// Output only. The resource that was changed.
    pub resource: std::string::String,

    /// Output only. The type of the resource that was changed.
    pub resource_type: std::string::String,

    /// Output only. The action that was performed on the resource.
    pub action: std::string::String,

    /// Output only. The original resource before the change.
    pub original_resource: std::option::Option<wkt::Struct>,

    /// Output only. The new resource after the change.
    pub new_resource: std::option::Option<wkt::Struct>,

    /// Output only. The dependent resources that were changed.
    pub dependent_resources: std::vec::Vec<wkt::Struct>,

    /// Output only. The time when the change was made.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. The monotonically increasing sequence number of the changelog.
    pub sequence_number: i64,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Changelog {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Changelog::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let changelog_id = "changelog_id";
    /// let x = Changelog::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/changelogs/{changelog_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [author][crate::model::Changelog::author].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// let x = Changelog::new().set_author("example");
    /// ```
    pub fn set_author<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.author = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::Changelog::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// let x = Changelog::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::Changelog::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// let x = Changelog::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [resource][crate::model::Changelog::resource].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// let x = Changelog::new().set_resource("example");
    /// ```
    pub fn set_resource<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.resource = v.into();
        self
    }

    /// Sets the value of [resource_type][crate::model::Changelog::resource_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// let x = Changelog::new().set_resource_type("example");
    /// ```
    pub fn set_resource_type<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.resource_type = v.into();
        self
    }

    /// Sets the value of [action][crate::model::Changelog::action].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// let x = Changelog::new().set_action("example");
    /// ```
    pub fn set_action<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.action = v.into();
        self
    }

    /// Sets the value of [original_resource][crate::model::Changelog::original_resource].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// use wkt::Struct;
    /// let x = Changelog::new().set_original_resource(Struct::default()/* use setters */);
    /// ```
    pub fn set_original_resource<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.original_resource = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [original_resource][crate::model::Changelog::original_resource].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// use wkt::Struct;
    /// let x = Changelog::new().set_or_clear_original_resource(Some(Struct::default()/* use setters */));
    /// let x = Changelog::new().set_or_clear_original_resource(None::<Struct>);
    /// ```
    pub fn set_or_clear_original_resource<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.original_resource = v.map(|x| x.into());
        self
    }

    /// Sets the value of [new_resource][crate::model::Changelog::new_resource].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// use wkt::Struct;
    /// let x = Changelog::new().set_new_resource(Struct::default()/* use setters */);
    /// ```
    pub fn set_new_resource<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.new_resource = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [new_resource][crate::model::Changelog::new_resource].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// use wkt::Struct;
    /// let x = Changelog::new().set_or_clear_new_resource(Some(Struct::default()/* use setters */));
    /// let x = Changelog::new().set_or_clear_new_resource(None::<Struct>);
    /// ```
    pub fn set_or_clear_new_resource<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.new_resource = v.map(|x| x.into());
        self
    }

    /// Sets the value of [dependent_resources][crate::model::Changelog::dependent_resources].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// use wkt::Struct;
    /// let x = Changelog::new()
    ///     .set_dependent_resources([
    ///         Struct::default()/* use setters */,
    ///         Struct::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_dependent_resources<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<wkt::Struct>,
    {
        use std::iter::Iterator;
        self.dependent_resources = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [create_time][crate::model::Changelog::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// use wkt::Timestamp;
    /// let x = Changelog::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::Changelog::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// use wkt::Timestamp;
    /// let x = Changelog::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = Changelog::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [sequence_number][crate::model::Changelog::sequence_number].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Changelog;
    /// let x = Changelog::new().set_sequence_number(42);
    /// ```
    pub fn set_sequence_number<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
        self.sequence_number = v.into();
        self
    }
}

impl wkt::message::Message for Changelog {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Changelog"
    }
}

/// Represents a client-side function that the agent can invoke. When the
/// tool is chosen by the agent, control is handed off to the client.
/// The client is responsible for executing the function and returning the result
/// as a [ToolResponse][google.cloud.ces.v1.ToolResponse] to continue the
/// interaction with the agent.
///
/// [google.cloud.ces.v1.ToolResponse]: crate::model::ToolResponse
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ClientFunction {
    /// Required. The function name.
    pub name: std::string::String,

    /// Optional. The function description.
    pub description: std::string::String,

    /// Optional. The schema of the function parameters.
    pub parameters: std::option::Option<crate::model::Schema>,

    /// Optional. The schema of the function response.
    pub response: std::option::Option<crate::model::Schema>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ClientFunction {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::ClientFunction::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ClientFunction;
    /// let x = ClientFunction::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::ClientFunction::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ClientFunction;
    /// let x = ClientFunction::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [parameters][crate::model::ClientFunction::parameters].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ClientFunction;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = ClientFunction::new().set_parameters(Schema::default()/* use setters */);
    /// ```
    pub fn set_parameters<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.parameters = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [parameters][crate::model::ClientFunction::parameters].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ClientFunction;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = ClientFunction::new().set_or_clear_parameters(Some(Schema::default()/* use setters */));
    /// let x = ClientFunction::new().set_or_clear_parameters(None::<Schema>);
    /// ```
    pub fn set_or_clear_parameters<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.parameters = v.map(|x| x.into());
        self
    }

    /// Sets the value of [response][crate::model::ClientFunction::response].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ClientFunction;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = ClientFunction::new().set_response(Schema::default()/* use setters */);
    /// ```
    pub fn set_response<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.response = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [response][crate::model::ClientFunction::response].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ClientFunction;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = ClientFunction::new().set_or_clear_response(Some(Schema::default()/* use setters */));
    /// let x = ClientFunction::new().set_or_clear_response(None::<Schema>);
    /// ```
    pub fn set_or_clear_response<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.response = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for ClientFunction {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ClientFunction"
    }
}

/// A callback defines the custom logic to be executed at various stages of
/// agent interaction.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Callback {
    /// Optional. Human-readable description of the callback.
    pub description: std::string::String,

    /// Optional. Whether the callback is disabled. Disabled callbacks are ignored
    /// by the agent.
    pub disabled: bool,

    /// Optional. If enabled, the callback will also be executed on intermediate
    /// model outputs. This setting only affects after model callback.
    /// **ENABLE WITH CAUTION**. Typically after model callback only needs to be
    /// executed after receiving all model responses. Enabling proactive execution
    /// may have negative implication on the execution cost and latency, and
    /// should only be enabled in rare situations.
    pub proactive_execution_enabled: bool,

    /// The callback to execute.
    pub callback: std::option::Option<crate::model::callback::Callback>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Callback {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [description][crate::model::Callback::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Callback;
    /// let x = Callback::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [disabled][crate::model::Callback::disabled].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Callback;
    /// let x = Callback::new().set_disabled(true);
    /// ```
    pub fn set_disabled<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.disabled = v.into();
        self
    }

    /// Sets the value of [proactive_execution_enabled][crate::model::Callback::proactive_execution_enabled].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Callback;
    /// let x = Callback::new().set_proactive_execution_enabled(true);
    /// ```
    pub fn set_proactive_execution_enabled<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.proactive_execution_enabled = v.into();
        self
    }

    /// Sets the value of [callback][crate::model::Callback::callback].
    ///
    /// Note that all the setters affecting `callback` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Callback;
    /// use google_cloud_ces_v1::model::callback::Callback as CallbackOneOf;
    /// let x = Callback::new().set_callback(Some(CallbackOneOf::PythonCode("example".to_string())));
    /// ```
    pub fn set_callback<
        T: std::convert::Into<std::option::Option<crate::model::callback::Callback>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.callback = v.into();
        self
    }

    /// The value of [callback][crate::model::Callback::callback]
    /// if it holds a `PythonCode`, `None` if the field is not set or
    /// holds a different branch.
    pub fn python_code(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.callback.as_ref().and_then(|v| match v {
            crate::model::callback::Callback::PythonCode(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [callback][crate::model::Callback::callback]
    /// to hold a `PythonCode`.
    ///
    /// Note that all the setters affecting `callback` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Callback;
    /// let x = Callback::new().set_python_code("example");
    /// assert!(x.python_code().is_some());
    /// ```
    pub fn set_python_code<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.callback =
            std::option::Option::Some(crate::model::callback::Callback::PythonCode(v.into()));
        self
    }
}

impl wkt::message::Message for Callback {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Callback"
    }
}

/// Defines additional types related to [Callback].
pub mod callback {
    #[allow(unused_imports)]
    use super::*;

    /// The callback to execute.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum Callback {
        /// Required. The python code to execute for the callback.
        PythonCode(std::string::String),
    }
}

/// Model settings contains various configurations for the LLM model.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ModelSettings {
    /// Optional. The LLM model that the agent should use.
    /// If not set, the agent will inherit the model from its parent agent.
    pub model: std::string::String,

    /// Optional. If set, this temperature will be used for the LLM model.
    /// Temperature controls the randomness of the model's responses. Lower
    /// temperatures produce responses that are more predictable. Higher
    /// temperatures produce responses that are more creative.
    pub temperature: std::option::Option<f64>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ModelSettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [model][crate::model::ModelSettings::model].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ModelSettings;
    /// let x = ModelSettings::new().set_model("example");
    /// ```
    pub fn set_model<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.model = v.into();
        self
    }

    /// Sets the value of [temperature][crate::model::ModelSettings::temperature].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ModelSettings;
    /// let x = ModelSettings::new().set_temperature(42.0);
    /// ```
    pub fn set_temperature<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<f64>,
    {
        self.temperature = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [temperature][crate::model::ModelSettings::temperature].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ModelSettings;
    /// let x = ModelSettings::new().set_or_clear_temperature(Some(42.0));
    /// let x = ModelSettings::new().set_or_clear_temperature(None::<f32>);
    /// ```
    pub fn set_or_clear_temperature<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<f64>,
    {
        self.temperature = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for ModelSettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ModelSettings"
    }
}

/// Action that is taken when a certain precondition is met.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct TriggerAction {
    /// The action to take.
    pub action: std::option::Option<crate::model::trigger_action::Action>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl TriggerAction {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [action][crate::model::TriggerAction::action].
    ///
    /// Note that all the setters affecting `action` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TriggerAction;
    /// use google_cloud_ces_v1::model::trigger_action::RespondImmediately;
    /// let x = TriggerAction::new().set_action(Some(
    ///     google_cloud_ces_v1::model::trigger_action::Action::RespondImmediately(RespondImmediately::default().into())));
    /// ```
    pub fn set_action<
        T: std::convert::Into<std::option::Option<crate::model::trigger_action::Action>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.action = v.into();
        self
    }

    /// The value of [action][crate::model::TriggerAction::action]
    /// if it holds a `RespondImmediately`, `None` if the field is not set or
    /// holds a different branch.
    pub fn respond_immediately(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::trigger_action::RespondImmediately>>
    {
        #[allow(unreachable_patterns)]
        self.action.as_ref().and_then(|v| match v {
            crate::model::trigger_action::Action::RespondImmediately(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [action][crate::model::TriggerAction::action]
    /// to hold a `RespondImmediately`.
    ///
    /// Note that all the setters affecting `action` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TriggerAction;
    /// use google_cloud_ces_v1::model::trigger_action::RespondImmediately;
    /// let x = TriggerAction::new().set_respond_immediately(RespondImmediately::default()/* use setters */);
    /// assert!(x.respond_immediately().is_some());
    /// assert!(x.transfer_agent().is_none());
    /// assert!(x.generative_answer().is_none());
    /// ```
    pub fn set_respond_immediately<
        T: std::convert::Into<std::boxed::Box<crate::model::trigger_action::RespondImmediately>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.action = std::option::Option::Some(
            crate::model::trigger_action::Action::RespondImmediately(v.into()),
        );
        self
    }

    /// The value of [action][crate::model::TriggerAction::action]
    /// if it holds a `TransferAgent`, `None` if the field is not set or
    /// holds a different branch.
    pub fn transfer_agent(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::trigger_action::TransferAgent>> {
        #[allow(unreachable_patterns)]
        self.action.as_ref().and_then(|v| match v {
            crate::model::trigger_action::Action::TransferAgent(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [action][crate::model::TriggerAction::action]
    /// to hold a `TransferAgent`.
    ///
    /// Note that all the setters affecting `action` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TriggerAction;
    /// use google_cloud_ces_v1::model::trigger_action::TransferAgent;
    /// let x = TriggerAction::new().set_transfer_agent(TransferAgent::default()/* use setters */);
    /// assert!(x.transfer_agent().is_some());
    /// assert!(x.respond_immediately().is_none());
    /// assert!(x.generative_answer().is_none());
    /// ```
    pub fn set_transfer_agent<
        T: std::convert::Into<std::boxed::Box<crate::model::trigger_action::TransferAgent>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.action = std::option::Option::Some(
            crate::model::trigger_action::Action::TransferAgent(v.into()),
        );
        self
    }

    /// The value of [action][crate::model::TriggerAction::action]
    /// if it holds a `GenerativeAnswer`, `None` if the field is not set or
    /// holds a different branch.
    pub fn generative_answer(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::trigger_action::GenerativeAnswer>> {
        #[allow(unreachable_patterns)]
        self.action.as_ref().and_then(|v| match v {
            crate::model::trigger_action::Action::GenerativeAnswer(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [action][crate::model::TriggerAction::action]
    /// to hold a `GenerativeAnswer`.
    ///
    /// Note that all the setters affecting `action` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TriggerAction;
    /// use google_cloud_ces_v1::model::trigger_action::GenerativeAnswer;
    /// let x = TriggerAction::new().set_generative_answer(GenerativeAnswer::default()/* use setters */);
    /// assert!(x.generative_answer().is_some());
    /// assert!(x.respond_immediately().is_none());
    /// assert!(x.transfer_agent().is_none());
    /// ```
    pub fn set_generative_answer<
        T: std::convert::Into<std::boxed::Box<crate::model::trigger_action::GenerativeAnswer>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.action = std::option::Option::Some(
            crate::model::trigger_action::Action::GenerativeAnswer(v.into()),
        );
        self
    }
}

impl wkt::message::Message for TriggerAction {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.TriggerAction"
    }
}

/// Defines additional types related to [TriggerAction].
pub mod trigger_action {
    #[allow(unused_imports)]
    use super::*;

    /// Represents a response from the agent.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct Response {
        /// Required. Text for the agent to respond with.
        pub text: std::string::String,

        /// Optional. Whether the response is disabled. Disabled responses are not
        /// used by the agent.
        pub disabled: bool,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl Response {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [text][crate::model::trigger_action::Response::text].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::trigger_action::Response;
        /// let x = Response::new().set_text("example");
        /// ```
        pub fn set_text<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.text = v.into();
            self
        }

        /// Sets the value of [disabled][crate::model::trigger_action::Response::disabled].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::trigger_action::Response;
        /// let x = Response::new().set_disabled(true);
        /// ```
        pub fn set_disabled<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
            self.disabled = v.into();
            self
        }
    }

    impl wkt::message::Message for Response {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.TriggerAction.Response"
        }
    }

    /// The agent will immediately respond with a preconfigured response.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct RespondImmediately {
        /// Required. The canned responses for the agent to choose from. The response
        /// is chosen randomly.
        pub responses: std::vec::Vec<crate::model::trigger_action::Response>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl RespondImmediately {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [responses][crate::model::trigger_action::RespondImmediately::responses].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::trigger_action::RespondImmediately;
        /// use google_cloud_ces_v1::model::trigger_action::Response;
        /// let x = RespondImmediately::new()
        ///     .set_responses([
        ///         Response::default()/* use setters */,
        ///         Response::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_responses<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::trigger_action::Response>,
        {
            use std::iter::Iterator;
            self.responses = v.into_iter().map(|i| i.into()).collect();
            self
        }
    }

    impl wkt::message::Message for RespondImmediately {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.TriggerAction.RespondImmediately"
        }
    }

    /// The agent will immediately respond with a generative answer.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct GenerativeAnswer {
        /// Required. The prompt to use for the generative answer.
        pub prompt: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl GenerativeAnswer {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [prompt][crate::model::trigger_action::GenerativeAnswer::prompt].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::trigger_action::GenerativeAnswer;
        /// let x = GenerativeAnswer::new().set_prompt("example");
        /// ```
        pub fn set_prompt<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.prompt = v.into();
            self
        }
    }

    impl wkt::message::Message for GenerativeAnswer {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.TriggerAction.GenerativeAnswer"
        }
    }

    /// The agent will transfer the conversation to a different agent.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct TransferAgent {
        /// Required. The name of the agent to transfer the conversation to. The
        /// agent must be in the same app as the current agent. Format:
        /// `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
        pub agent: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl TransferAgent {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [agent][crate::model::trigger_action::TransferAgent::agent].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::trigger_action::TransferAgent;
        /// # let project_id = "project_id";
        /// # let location_id = "location_id";
        /// # let app_id = "app_id";
        /// # let agent_id = "agent_id";
        /// let x = TransferAgent::new().set_agent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
        /// ```
        pub fn set_agent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.agent = v.into();
            self
        }
    }

    impl wkt::message::Message for TransferAgent {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.TriggerAction.TransferAgent"
        }
    }

    /// The action to take.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum Action {
        /// Optional. Immediately respond with a preconfigured response.
        RespondImmediately(std::boxed::Box<crate::model::trigger_action::RespondImmediately>),
        /// Optional. Transfer the conversation to a different agent.
        TransferAgent(std::boxed::Box<crate::model::trigger_action::TransferAgent>),
        /// Optional. Respond with a generative answer.
        GenerativeAnswer(std::boxed::Box<crate::model::trigger_action::GenerativeAnswer>),
    }
}

/// The TLS configuration.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct TlsConfig {
    /// Required. Specifies a list of allowed custom CA certificates for HTTPS
    /// verification.
    pub ca_certs: std::vec::Vec<crate::model::tls_config::CaCert>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl TlsConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [ca_certs][crate::model::TlsConfig::ca_certs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::TlsConfig;
    /// use google_cloud_ces_v1::model::tls_config::CaCert;
    /// let x = TlsConfig::new()
    ///     .set_ca_certs([
    ///         CaCert::default()/* use setters */,
    ///         CaCert::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_ca_certs<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::tls_config::CaCert>,
    {
        use std::iter::Iterator;
        self.ca_certs = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for TlsConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.TlsConfig"
    }
}

/// Defines additional types related to [TlsConfig].
pub mod tls_config {
    #[allow(unused_imports)]
    use super::*;

    /// The CA certificate.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct CaCert {
        /// Required. The name of the allowed custom CA certificates. This
        /// can be used to disambiguate the custom CA certificates.
        pub display_name: std::string::String,

        /// Required. The allowed custom CA certificates (in DER format) for
        /// HTTPS verification. This overrides the default SSL trust store. If this
        /// is empty or unspecified, CES will use Google's default trust
        /// store to verify certificates. N.B. Make sure the HTTPS server
        /// certificates are signed with "subject alt name". For instance a
        /// certificate can be self-signed using the following command:
        ///
        /// ```norust
        ///    openssl x509 -req -days 200 -in example.com.csr \
        ///      -signkey example.com.key \
        ///      -out example.com.crt \
        ///      -extfile <(printf "\nsubjectAltName='DNS:www.example.com'")
        /// ```
        pub cert: ::bytes::Bytes,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl CaCert {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [display_name][crate::model::tls_config::CaCert::display_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::tls_config::CaCert;
        /// let x = CaCert::new().set_display_name("example");
        /// ```
        pub fn set_display_name<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.display_name = v.into();
            self
        }

        /// Sets the value of [cert][crate::model::tls_config::CaCert::cert].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::tls_config::CaCert;
        /// let x = CaCert::new().set_cert(bytes::Bytes::from_static(b"example"));
        /// ```
        pub fn set_cert<T: std::convert::Into<::bytes::Bytes>>(mut self, v: T) -> Self {
            self.cert = v.into();
            self
        }
    }

    impl wkt::message::Message for CaCert {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.TlsConfig.CaCert"
        }
    }
}

/// Configuration for tools using Service Directory.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ServiceDirectoryConfig {
    /// Required. The name of [Service
    /// Directory](https://cloud.google.com/service-directory) service.
    /// Format:
    /// `projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}`.
    /// Location of the service directory must be the same as the location of the
    /// app.
    pub service: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ServiceDirectoryConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [service][crate::model::ServiceDirectoryConfig::service].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = ServiceDirectoryConfig::new().set_service("example");
    /// ```
    pub fn set_service<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.service = v.into();
        self
    }
}

impl wkt::message::Message for ServiceDirectoryConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ServiceDirectoryConfig"
    }
}

/// A ChannelProfile configures the agent's behavior for a specific communication
/// channel, such as web UI or telephony.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ChannelProfile {
    /// Optional. The unique identifier of the channel profile.
    pub profile_id: std::string::String,

    /// Optional. The type of the channel profile.
    pub channel_type: crate::model::channel_profile::ChannelType,

    /// Optional. The persona property of the channel profile.
    pub persona_property: std::option::Option<crate::model::channel_profile::PersonaProperty>,

    /// Optional. Whether to disable DTMF (dual-tone multi-frequency).
    pub disable_dtmf: bool,

    /// Optional. Whether to disable user barge-in control in the conversation.
    ///
    /// - **true**: User interruptions are disabled while the agent is speaking.
    /// - **false**: The agent retains automatic control over when the user can
    ///   interrupt.
    pub disable_barge_in_control: bool,

    /// Optional. The configuration for the web widget.
    pub web_widget_config: std::option::Option<crate::model::channel_profile::WebWidgetConfig>,

    /// Optional. The noise suppression level of the channel profile.
    /// Available values are "low", "moderate", "high", "very_high".
    pub noise_suppression_level: std::string::String,

    /// Optional. Configuration specific to WhatsApp deployments.
    pub whatsapp_config: std::option::Option<crate::model::channel_profile::WhatsAppConfig>,

    /// Optional. Configuration specific to Instagram deployments.
    pub instagram_config: std::option::Option<crate::model::channel_profile::InstagramConfig>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ChannelProfile {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [profile_id][crate::model::ChannelProfile::profile_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// let x = ChannelProfile::new().set_profile_id("example");
    /// ```
    pub fn set_profile_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.profile_id = v.into();
        self
    }

    /// Sets the value of [channel_type][crate::model::ChannelProfile::channel_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// use google_cloud_ces_v1::model::channel_profile::ChannelType;
    /// let x0 = ChannelProfile::new().set_channel_type(ChannelType::WebUi);
    /// let x1 = ChannelProfile::new().set_channel_type(ChannelType::Api);
    /// let x2 = ChannelProfile::new().set_channel_type(ChannelType::Twilio);
    /// ```
    pub fn set_channel_type<T: std::convert::Into<crate::model::channel_profile::ChannelType>>(
        mut self,
        v: T,
    ) -> Self {
        self.channel_type = v.into();
        self
    }

    /// Sets the value of [persona_property][crate::model::ChannelProfile::persona_property].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// use google_cloud_ces_v1::model::channel_profile::PersonaProperty;
    /// let x = ChannelProfile::new().set_persona_property(PersonaProperty::default()/* use setters */);
    /// ```
    pub fn set_persona_property<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::channel_profile::PersonaProperty>,
    {
        self.persona_property = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [persona_property][crate::model::ChannelProfile::persona_property].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// use google_cloud_ces_v1::model::channel_profile::PersonaProperty;
    /// let x = ChannelProfile::new().set_or_clear_persona_property(Some(PersonaProperty::default()/* use setters */));
    /// let x = ChannelProfile::new().set_or_clear_persona_property(None::<PersonaProperty>);
    /// ```
    pub fn set_or_clear_persona_property<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::channel_profile::PersonaProperty>,
    {
        self.persona_property = v.map(|x| x.into());
        self
    }

    /// Sets the value of [disable_dtmf][crate::model::ChannelProfile::disable_dtmf].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// let x = ChannelProfile::new().set_disable_dtmf(true);
    /// ```
    pub fn set_disable_dtmf<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.disable_dtmf = v.into();
        self
    }

    /// Sets the value of [disable_barge_in_control][crate::model::ChannelProfile::disable_barge_in_control].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// let x = ChannelProfile::new().set_disable_barge_in_control(true);
    /// ```
    pub fn set_disable_barge_in_control<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.disable_barge_in_control = v.into();
        self
    }

    /// Sets the value of [web_widget_config][crate::model::ChannelProfile::web_widget_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// use google_cloud_ces_v1::model::channel_profile::WebWidgetConfig;
    /// let x = ChannelProfile::new().set_web_widget_config(WebWidgetConfig::default()/* use setters */);
    /// ```
    pub fn set_web_widget_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::channel_profile::WebWidgetConfig>,
    {
        self.web_widget_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [web_widget_config][crate::model::ChannelProfile::web_widget_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// use google_cloud_ces_v1::model::channel_profile::WebWidgetConfig;
    /// let x = ChannelProfile::new().set_or_clear_web_widget_config(Some(WebWidgetConfig::default()/* use setters */));
    /// let x = ChannelProfile::new().set_or_clear_web_widget_config(None::<WebWidgetConfig>);
    /// ```
    pub fn set_or_clear_web_widget_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::channel_profile::WebWidgetConfig>,
    {
        self.web_widget_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [noise_suppression_level][crate::model::ChannelProfile::noise_suppression_level].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// let x = ChannelProfile::new().set_noise_suppression_level("example");
    /// ```
    pub fn set_noise_suppression_level<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.noise_suppression_level = v.into();
        self
    }

    /// Sets the value of [whatsapp_config][crate::model::ChannelProfile::whatsapp_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// use google_cloud_ces_v1::model::channel_profile::WhatsAppConfig;
    /// let x = ChannelProfile::new().set_whatsapp_config(WhatsAppConfig::default()/* use setters */);
    /// ```
    pub fn set_whatsapp_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::channel_profile::WhatsAppConfig>,
    {
        self.whatsapp_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [whatsapp_config][crate::model::ChannelProfile::whatsapp_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// use google_cloud_ces_v1::model::channel_profile::WhatsAppConfig;
    /// let x = ChannelProfile::new().set_or_clear_whatsapp_config(Some(WhatsAppConfig::default()/* use setters */));
    /// let x = ChannelProfile::new().set_or_clear_whatsapp_config(None::<WhatsAppConfig>);
    /// ```
    pub fn set_or_clear_whatsapp_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::channel_profile::WhatsAppConfig>,
    {
        self.whatsapp_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [instagram_config][crate::model::ChannelProfile::instagram_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// use google_cloud_ces_v1::model::channel_profile::InstagramConfig;
    /// let x = ChannelProfile::new().set_instagram_config(InstagramConfig::default()/* use setters */);
    /// ```
    pub fn set_instagram_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::channel_profile::InstagramConfig>,
    {
        self.instagram_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [instagram_config][crate::model::ChannelProfile::instagram_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ChannelProfile;
    /// use google_cloud_ces_v1::model::channel_profile::InstagramConfig;
    /// let x = ChannelProfile::new().set_or_clear_instagram_config(Some(InstagramConfig::default()/* use setters */));
    /// let x = ChannelProfile::new().set_or_clear_instagram_config(None::<InstagramConfig>);
    /// ```
    pub fn set_or_clear_instagram_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::channel_profile::InstagramConfig>,
    {
        self.instagram_config = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for ChannelProfile {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ChannelProfile"
    }
}

/// Defines additional types related to [ChannelProfile].
pub mod channel_profile {
    #[allow(unused_imports)]
    use super::*;

    /// Represents the persona property of a channel.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct PersonaProperty {
        /// Optional. The persona of the channel.
        pub persona: crate::model::channel_profile::persona_property::Persona,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl PersonaProperty {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [persona][crate::model::channel_profile::PersonaProperty::persona].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::PersonaProperty;
        /// use google_cloud_ces_v1::model::channel_profile::persona_property::Persona;
        /// let x0 = PersonaProperty::new().set_persona(Persona::Concise);
        /// let x1 = PersonaProperty::new().set_persona(Persona::Chatty);
        /// ```
        pub fn set_persona<
            T: std::convert::Into<crate::model::channel_profile::persona_property::Persona>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.persona = v.into();
            self
        }
    }

    impl wkt::message::Message for PersonaProperty {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.ChannelProfile.PersonaProperty"
        }
    }

    /// Defines additional types related to [PersonaProperty].
    pub mod persona_property {
        #[allow(unused_imports)]
        use super::*;

        /// The persona of the channel.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum Persona {
            /// UNKNOWN persona.
            Unknown,
            /// The agent keeps the responses concise and to the point
            Concise,
            /// The agent provides additional context, explanations, and details
            Chatty,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [Persona::value] or
            /// [Persona::name].
            UnknownValue(persona::UnknownValue),
        }

        #[doc(hidden)]
        pub mod persona {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl Persona {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unknown => std::option::Option::Some(0),
                    Self::Concise => std::option::Option::Some(1),
                    Self::Chatty => std::option::Option::Some(2),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unknown => std::option::Option::Some("UNKNOWN"),
                    Self::Concise => std::option::Option::Some("CONCISE"),
                    Self::Chatty => std::option::Option::Some("CHATTY"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for Persona {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for Persona {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for Persona {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unknown,
                    1 => Self::Concise,
                    2 => Self::Chatty,
                    _ => Self::UnknownValue(persona::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for Persona {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "UNKNOWN" => Self::Unknown,
                    "CONCISE" => Self::Concise,
                    "CHATTY" => Self::Chatty,
                    _ => Self::UnknownValue(persona::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for Persona {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unknown => serializer.serialize_i32(0),
                    Self::Concise => serializer.serialize_i32(1),
                    Self::Chatty => serializer.serialize_i32(2),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for Persona {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<Persona>::new(
                    ".google.cloud.ces.v1.ChannelProfile.PersonaProperty.Persona",
                ))
            }
        }
    }

    /// Message for configuration for the web widget.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct WebWidgetConfig {
        /// Optional. The modality of the web widget.
        pub modality: crate::model::channel_profile::web_widget_config::Modality,

        /// Optional. The theme of the web widget.
        pub theme: crate::model::channel_profile::web_widget_config::Theme,

        /// Optional. The title of the web widget.
        pub web_widget_title: std::string::String,

        /// Optional. The security settings of the web widget.
        pub security_settings:
            std::option::Option<crate::model::channel_profile::web_widget_config::SecuritySettings>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl WebWidgetConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [modality][crate::model::channel_profile::WebWidgetConfig::modality].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WebWidgetConfig;
        /// use google_cloud_ces_v1::model::channel_profile::web_widget_config::Modality;
        /// let x0 = WebWidgetConfig::new().set_modality(Modality::ChatAndVoice);
        /// let x1 = WebWidgetConfig::new().set_modality(Modality::VoiceOnly);
        /// let x2 = WebWidgetConfig::new().set_modality(Modality::ChatOnly);
        /// ```
        pub fn set_modality<
            T: std::convert::Into<crate::model::channel_profile::web_widget_config::Modality>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.modality = v.into();
            self
        }

        /// Sets the value of [theme][crate::model::channel_profile::WebWidgetConfig::theme].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WebWidgetConfig;
        /// use google_cloud_ces_v1::model::channel_profile::web_widget_config::Theme;
        /// let x0 = WebWidgetConfig::new().set_theme(Theme::Light);
        /// let x1 = WebWidgetConfig::new().set_theme(Theme::Dark);
        /// ```
        pub fn set_theme<
            T: std::convert::Into<crate::model::channel_profile::web_widget_config::Theme>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.theme = v.into();
            self
        }

        /// Sets the value of [web_widget_title][crate::model::channel_profile::WebWidgetConfig::web_widget_title].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WebWidgetConfig;
        /// let x = WebWidgetConfig::new().set_web_widget_title("example");
        /// ```
        pub fn set_web_widget_title<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.web_widget_title = v.into();
            self
        }

        /// Sets the value of [security_settings][crate::model::channel_profile::WebWidgetConfig::security_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WebWidgetConfig;
        /// use google_cloud_ces_v1::model::channel_profile::web_widget_config::SecuritySettings;
        /// let x = WebWidgetConfig::new().set_security_settings(SecuritySettings::default()/* use setters */);
        /// ```
        pub fn set_security_settings<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<
                    crate::model::channel_profile::web_widget_config::SecuritySettings,
                >,
        {
            self.security_settings = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [security_settings][crate::model::channel_profile::WebWidgetConfig::security_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WebWidgetConfig;
        /// use google_cloud_ces_v1::model::channel_profile::web_widget_config::SecuritySettings;
        /// let x = WebWidgetConfig::new().set_or_clear_security_settings(Some(SecuritySettings::default()/* use setters */));
        /// let x = WebWidgetConfig::new().set_or_clear_security_settings(None::<SecuritySettings>);
        /// ```
        pub fn set_or_clear_security_settings<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<
                    crate::model::channel_profile::web_widget_config::SecuritySettings,
                >,
        {
            self.security_settings = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for WebWidgetConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.ChannelProfile.WebWidgetConfig"
        }
    }

    /// Defines additional types related to [WebWidgetConfig].
    pub mod web_widget_config {
        #[allow(unused_imports)]
        use super::*;

        /// Security settings for the web widget.
        #[derive(Clone, Default, PartialEq)]
        #[non_exhaustive]
        pub struct SecuritySettings {
            /// Optional. Indicates whether public access to the web widget is enabled.
            /// If `true`, the web widget will be publicly accessible.
            /// If `false`, the web widget must be integrated with your own
            /// authentication and authorization system to return valid credentials for
            /// accessing the CES agent.
            pub enable_public_access: bool,

            /// Optional. Indicates whether origin check for the web widget is enabled.
            /// If `true`, the web widget will check the origin of the website that
            /// loads the web widget and only allow it to be loaded in the same origin
            /// or any of the allowed origins.
            pub enable_origin_check: bool,

            /// Optional. The origins that are allowed to host the web widget. An
            /// origin is defined by RFC 6454. If empty, all origins are allowed. A
            /// maximum of 100 origins is allowed. Example: `https://example.com`
            pub allowed_origins: std::vec::Vec<std::string::String>,

            /// Optional. Indicates whether reCAPTCHA verification for the web widget
            /// is enabled.
            pub enable_recaptcha: bool,

            pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
        }

        impl SecuritySettings {
            /// Creates a new default instance.
            pub fn new() -> Self {
                std::default::Default::default()
            }

            /// Sets the value of [enable_public_access][crate::model::channel_profile::web_widget_config::SecuritySettings::enable_public_access].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::channel_profile::web_widget_config::SecuritySettings;
            /// let x = SecuritySettings::new().set_enable_public_access(true);
            /// ```
            pub fn set_enable_public_access<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
                self.enable_public_access = v.into();
                self
            }

            /// Sets the value of [enable_origin_check][crate::model::channel_profile::web_widget_config::SecuritySettings::enable_origin_check].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::channel_profile::web_widget_config::SecuritySettings;
            /// let x = SecuritySettings::new().set_enable_origin_check(true);
            /// ```
            pub fn set_enable_origin_check<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
                self.enable_origin_check = v.into();
                self
            }

            /// Sets the value of [allowed_origins][crate::model::channel_profile::web_widget_config::SecuritySettings::allowed_origins].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::channel_profile::web_widget_config::SecuritySettings;
            /// let x = SecuritySettings::new().set_allowed_origins(["a", "b", "c"]);
            /// ```
            pub fn set_allowed_origins<T, V>(mut self, v: T) -> Self
            where
                T: std::iter::IntoIterator<Item = V>,
                V: std::convert::Into<std::string::String>,
            {
                use std::iter::Iterator;
                self.allowed_origins = v.into_iter().map(|i| i.into()).collect();
                self
            }

            /// Sets the value of [enable_recaptcha][crate::model::channel_profile::web_widget_config::SecuritySettings::enable_recaptcha].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::channel_profile::web_widget_config::SecuritySettings;
            /// let x = SecuritySettings::new().set_enable_recaptcha(true);
            /// ```
            pub fn set_enable_recaptcha<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
                self.enable_recaptcha = v.into();
                self
            }
        }

        impl wkt::message::Message for SecuritySettings {
            fn typename() -> &'static str {
                "type.googleapis.com/google.cloud.ces.v1.ChannelProfile.WebWidgetConfig.SecuritySettings"
            }
        }

        /// Modality of the web widget.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum Modality {
            /// Unknown modality.
            Unspecified,
            /// Widget supports both chat and voice input.
            ChatAndVoice,
            /// Widget supports only voice input.
            VoiceOnly,
            /// Widget supports only chat input.
            ChatOnly,
            /// Widget supports chat, voice, and video input.
            ChatVoiceAndVideo,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [Modality::value] or
            /// [Modality::name].
            UnknownValue(modality::UnknownValue),
        }

        #[doc(hidden)]
        pub mod modality {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl Modality {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::ChatAndVoice => std::option::Option::Some(1),
                    Self::VoiceOnly => std::option::Option::Some(2),
                    Self::ChatOnly => std::option::Option::Some(3),
                    Self::ChatVoiceAndVideo => std::option::Option::Some(4),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("MODALITY_UNSPECIFIED"),
                    Self::ChatAndVoice => std::option::Option::Some("CHAT_AND_VOICE"),
                    Self::VoiceOnly => std::option::Option::Some("VOICE_ONLY"),
                    Self::ChatOnly => std::option::Option::Some("CHAT_ONLY"),
                    Self::ChatVoiceAndVideo => std::option::Option::Some("CHAT_VOICE_AND_VIDEO"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for Modality {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for Modality {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for Modality {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::ChatAndVoice,
                    2 => Self::VoiceOnly,
                    3 => Self::ChatOnly,
                    4 => Self::ChatVoiceAndVideo,
                    _ => Self::UnknownValue(modality::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for Modality {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "MODALITY_UNSPECIFIED" => Self::Unspecified,
                    "CHAT_AND_VOICE" => Self::ChatAndVoice,
                    "VOICE_ONLY" => Self::VoiceOnly,
                    "CHAT_ONLY" => Self::ChatOnly,
                    "CHAT_VOICE_AND_VIDEO" => Self::ChatVoiceAndVideo,
                    _ => Self::UnknownValue(modality::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for Modality {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::ChatAndVoice => serializer.serialize_i32(1),
                    Self::VoiceOnly => serializer.serialize_i32(2),
                    Self::ChatOnly => serializer.serialize_i32(3),
                    Self::ChatVoiceAndVideo => serializer.serialize_i32(4),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for Modality {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<Modality>::new(
                    ".google.cloud.ces.v1.ChannelProfile.WebWidgetConfig.Modality",
                ))
            }
        }

        /// Theme of the web widget.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum Theme {
            /// Unknown theme.
            Unspecified,
            /// Light theme.
            Light,
            /// Dark theme.
            Dark,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [Theme::value] or
            /// [Theme::name].
            UnknownValue(theme::UnknownValue),
        }

        #[doc(hidden)]
        pub mod theme {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl Theme {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::Light => std::option::Option::Some(1),
                    Self::Dark => std::option::Option::Some(2),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("THEME_UNSPECIFIED"),
                    Self::Light => std::option::Option::Some("LIGHT"),
                    Self::Dark => std::option::Option::Some("DARK"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for Theme {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for Theme {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for Theme {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::Light,
                    2 => Self::Dark,
                    _ => Self::UnknownValue(theme::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for Theme {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "THEME_UNSPECIFIED" => Self::Unspecified,
                    "LIGHT" => Self::Light,
                    "DARK" => Self::Dark,
                    _ => Self::UnknownValue(theme::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for Theme {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::Light => serializer.serialize_i32(1),
                    Self::Dark => serializer.serialize_i32(2),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for Theme {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<Theme>::new(
                    ".google.cloud.ces.v1.ChannelProfile.WebWidgetConfig.Theme",
                ))
            }
        }
    }

    /// Configuration specific to WhatsApp deployments.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct WhatsAppConfig {
        /// Required. The WhatsApp Business Account ID.
        pub waba_id: std::string::String,

        /// Required. The Meta phone number ID.
        pub phone_number_id: std::string::String,

        /// Optional. The phone number in E.164 format.
        pub phone_number: std::string::String,

        /// Output only. The fetched Meta business page name.
        pub display_name: std::string::String,

        /// Output only. The fetched Meta business profile thumbnail URL.
        pub thumbnail_url: std::string::String,

        /// Output only. The description of the Meta business page or profile.
        pub description: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl WhatsAppConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [waba_id][crate::model::channel_profile::WhatsAppConfig::waba_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WhatsAppConfig;
        /// let x = WhatsAppConfig::new().set_waba_id("example");
        /// ```
        pub fn set_waba_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.waba_id = v.into();
            self
        }

        /// Sets the value of [phone_number_id][crate::model::channel_profile::WhatsAppConfig::phone_number_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WhatsAppConfig;
        /// let x = WhatsAppConfig::new().set_phone_number_id("example");
        /// ```
        pub fn set_phone_number_id<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.phone_number_id = v.into();
            self
        }

        /// Sets the value of [phone_number][crate::model::channel_profile::WhatsAppConfig::phone_number].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WhatsAppConfig;
        /// let x = WhatsAppConfig::new().set_phone_number("example");
        /// ```
        pub fn set_phone_number<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.phone_number = v.into();
            self
        }

        /// Sets the value of [display_name][crate::model::channel_profile::WhatsAppConfig::display_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WhatsAppConfig;
        /// let x = WhatsAppConfig::new().set_display_name("example");
        /// ```
        pub fn set_display_name<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.display_name = v.into();
            self
        }

        /// Sets the value of [thumbnail_url][crate::model::channel_profile::WhatsAppConfig::thumbnail_url].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WhatsAppConfig;
        /// let x = WhatsAppConfig::new().set_thumbnail_url("example");
        /// ```
        pub fn set_thumbnail_url<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.thumbnail_url = v.into();
            self
        }

        /// Sets the value of [description][crate::model::channel_profile::WhatsAppConfig::description].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::WhatsAppConfig;
        /// let x = WhatsAppConfig::new().set_description("example");
        /// ```
        pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.description = v.into();
            self
        }
    }

    impl wkt::message::Message for WhatsAppConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.ChannelProfile.WhatsAppConfig"
        }
    }

    /// Configuration specific to Instagram deployments.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct InstagramConfig {
        /// Required. The Instagram Account ID.
        pub instagram_account_id: std::string::String,

        /// Output only. The fetched Meta business page name.
        pub display_name: std::string::String,

        /// Output only. The fetched Meta business profile thumbnail URL.
        pub thumbnail_url: std::string::String,

        /// Output only. The description of the Meta business page or profile.
        pub description: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl InstagramConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [instagram_account_id][crate::model::channel_profile::InstagramConfig::instagram_account_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::InstagramConfig;
        /// let x = InstagramConfig::new().set_instagram_account_id("example");
        /// ```
        pub fn set_instagram_account_id<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.instagram_account_id = v.into();
            self
        }

        /// Sets the value of [display_name][crate::model::channel_profile::InstagramConfig::display_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::InstagramConfig;
        /// let x = InstagramConfig::new().set_display_name("example");
        /// ```
        pub fn set_display_name<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.display_name = v.into();
            self
        }

        /// Sets the value of [thumbnail_url][crate::model::channel_profile::InstagramConfig::thumbnail_url].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::InstagramConfig;
        /// let x = InstagramConfig::new().set_thumbnail_url("example");
        /// ```
        pub fn set_thumbnail_url<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.thumbnail_url = v.into();
            self
        }

        /// Sets the value of [description][crate::model::channel_profile::InstagramConfig::description].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::channel_profile::InstagramConfig;
        /// let x = InstagramConfig::new().set_description("example");
        /// ```
        pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.description = v.into();
            self
        }
    }

    impl wkt::message::Message for InstagramConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.ChannelProfile.InstagramConfig"
        }
    }

    /// The type of the channel profile.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ChannelType {
        /// Unknown channel type.
        Unknown,
        /// Web UI channel.
        WebUi,
        /// API channel.
        Api,
        /// Twilio channel.
        Twilio,
        /// Google Telephony Platform channel.
        GoogleTelephonyPlatform,
        /// Contact Center as a Service (CCaaS) channel.
        ContactCenterAsAService,
        /// Contact Center as a Service (CCaaS Chat) channel.
        ContactCenterAsAServiceChat,
        /// Five9 channel.
        Five9,
        /// Third party contact center integration channel.
        ContactCenterIntegration,
        /// WhatsApp channel.
        Whatsapp,
        /// Instagram channel.
        Instagram,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [ChannelType::value] or
        /// [ChannelType::name].
        UnknownValue(channel_type::UnknownValue),
    }

    #[doc(hidden)]
    pub mod channel_type {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl ChannelType {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unknown => std::option::Option::Some(0),
                Self::WebUi => std::option::Option::Some(2),
                Self::Api => std::option::Option::Some(3),
                Self::Twilio => std::option::Option::Some(4),
                Self::GoogleTelephonyPlatform => std::option::Option::Some(5),
                Self::ContactCenterAsAService => std::option::Option::Some(6),
                Self::ContactCenterAsAServiceChat => std::option::Option::Some(11),
                Self::Five9 => std::option::Option::Some(7),
                Self::ContactCenterIntegration => std::option::Option::Some(8),
                Self::Whatsapp => std::option::Option::Some(9),
                Self::Instagram => std::option::Option::Some(10),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unknown => std::option::Option::Some("UNKNOWN"),
                Self::WebUi => std::option::Option::Some("WEB_UI"),
                Self::Api => std::option::Option::Some("API"),
                Self::Twilio => std::option::Option::Some("TWILIO"),
                Self::GoogleTelephonyPlatform => {
                    std::option::Option::Some("GOOGLE_TELEPHONY_PLATFORM")
                }
                Self::ContactCenterAsAService => {
                    std::option::Option::Some("CONTACT_CENTER_AS_A_SERVICE")
                }
                Self::ContactCenterAsAServiceChat => {
                    std::option::Option::Some("CONTACT_CENTER_AS_A_SERVICE_CHAT")
                }
                Self::Five9 => std::option::Option::Some("FIVE9"),
                Self::ContactCenterIntegration => {
                    std::option::Option::Some("CONTACT_CENTER_INTEGRATION")
                }
                Self::Whatsapp => std::option::Option::Some("WHATSAPP"),
                Self::Instagram => std::option::Option::Some("INSTAGRAM"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for ChannelType {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for ChannelType {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for ChannelType {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unknown,
                2 => Self::WebUi,
                3 => Self::Api,
                4 => Self::Twilio,
                5 => Self::GoogleTelephonyPlatform,
                6 => Self::ContactCenterAsAService,
                7 => Self::Five9,
                8 => Self::ContactCenterIntegration,
                9 => Self::Whatsapp,
                10 => Self::Instagram,
                11 => Self::ContactCenterAsAServiceChat,
                _ => Self::UnknownValue(channel_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for ChannelType {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "UNKNOWN" => Self::Unknown,
                "WEB_UI" => Self::WebUi,
                "API" => Self::Api,
                "TWILIO" => Self::Twilio,
                "GOOGLE_TELEPHONY_PLATFORM" => Self::GoogleTelephonyPlatform,
                "CONTACT_CENTER_AS_A_SERVICE" => Self::ContactCenterAsAService,
                "CONTACT_CENTER_AS_A_SERVICE_CHAT" => Self::ContactCenterAsAServiceChat,
                "FIVE9" => Self::Five9,
                "CONTACT_CENTER_INTEGRATION" => Self::ContactCenterIntegration,
                "WHATSAPP" => Self::Whatsapp,
                "INSTAGRAM" => Self::Instagram,
                _ => Self::UnknownValue(channel_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for ChannelType {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unknown => serializer.serialize_i32(0),
                Self::WebUi => serializer.serialize_i32(2),
                Self::Api => serializer.serialize_i32(3),
                Self::Twilio => serializer.serialize_i32(4),
                Self::GoogleTelephonyPlatform => serializer.serialize_i32(5),
                Self::ContactCenterAsAService => serializer.serialize_i32(6),
                Self::ContactCenterAsAServiceChat => serializer.serialize_i32(11),
                Self::Five9 => serializer.serialize_i32(7),
                Self::ContactCenterIntegration => serializer.serialize_i32(8),
                Self::Whatsapp => serializer.serialize_i32(9),
                Self::Instagram => serializer.serialize_i32(10),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for ChannelType {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<ChannelType>::new(
                ".google.cloud.ces.v1.ChannelProfile.ChannelType",
            ))
        }
    }
}

/// A span is a unit of work or a single operation during the request processing.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Span {
    /// Output only. The name of the span.
    pub name: std::string::String,

    /// Output only. The start time of the span.
    pub start_time: std::option::Option<wkt::Timestamp>,

    /// Output only. The end time of the span.
    pub end_time: std::option::Option<wkt::Timestamp>,

    /// Output only. The duration of the span.
    pub duration: std::option::Option<wkt::Duration>,

    /// Output only. Key-value attributes associated with the span.
    pub attributes: std::option::Option<wkt::Struct>,

    /// Output only. The child spans that are nested under this span.
    pub child_spans: std::vec::Vec<crate::model::Span>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Span {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Span::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// let x = Span::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [start_time][crate::model::Span::start_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// use wkt::Timestamp;
    /// let x = Span::new().set_start_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_start_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.start_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [start_time][crate::model::Span::start_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// use wkt::Timestamp;
    /// let x = Span::new().set_or_clear_start_time(Some(Timestamp::default()/* use setters */));
    /// let x = Span::new().set_or_clear_start_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_start_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.start_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [end_time][crate::model::Span::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// use wkt::Timestamp;
    /// let x = Span::new().set_end_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_end_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [end_time][crate::model::Span::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// use wkt::Timestamp;
    /// let x = Span::new().set_or_clear_end_time(Some(Timestamp::default()/* use setters */));
    /// let x = Span::new().set_or_clear_end_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_end_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [duration][crate::model::Span::duration].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// use wkt::Duration;
    /// let x = Span::new().set_duration(Duration::default()/* use setters */);
    /// ```
    pub fn set_duration<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.duration = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [duration][crate::model::Span::duration].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// use wkt::Duration;
    /// let x = Span::new().set_or_clear_duration(Some(Duration::default()/* use setters */));
    /// let x = Span::new().set_or_clear_duration(None::<Duration>);
    /// ```
    pub fn set_or_clear_duration<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.duration = v.map(|x| x.into());
        self
    }

    /// Sets the value of [attributes][crate::model::Span::attributes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// use wkt::Struct;
    /// let x = Span::new().set_attributes(Struct::default()/* use setters */);
    /// ```
    pub fn set_attributes<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.attributes = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [attributes][crate::model::Span::attributes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// use wkt::Struct;
    /// let x = Span::new().set_or_clear_attributes(Some(Struct::default()/* use setters */));
    /// let x = Span::new().set_or_clear_attributes(None::<Struct>);
    /// ```
    pub fn set_or_clear_attributes<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.attributes = v.map(|x| x.into());
        self
    }

    /// Sets the value of [child_spans][crate::model::Span::child_spans].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Span;
    /// let x = Span::new()
    ///     .set_child_spans([
    ///         Span::default()/* use setters */,
    ///         Span::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_child_spans<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Span>,
    {
        use std::iter::Iterator;
        self.child_spans = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for Span {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Span"
    }
}

/// Configuration of an Action for the tool to use.
/// Note: This can be either an Action or an Operation. See
/// <https://cloud.google.com/integration-connectors/docs/entities-operation-action>
/// for details.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Action {
    /// Optional. Entity fields to use as inputs for the operation.
    /// If no fields are specified, all fields of the Entity will be used.
    pub input_fields: std::vec::Vec<std::string::String>,

    /// Optional. Entity fields to return from the operation.
    /// If no fields are specified, all fields of the Entity will be returned.
    pub output_fields: std::vec::Vec<std::string::String>,

    /// Specification for an action to configure for the tool to use.
    pub action_spec: std::option::Option<crate::model::action::ActionSpec>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Action {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [input_fields][crate::model::Action::input_fields].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Action;
    /// let x = Action::new().set_input_fields(["a", "b", "c"]);
    /// ```
    pub fn set_input_fields<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.input_fields = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [output_fields][crate::model::Action::output_fields].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Action;
    /// let x = Action::new().set_output_fields(["a", "b", "c"]);
    /// ```
    pub fn set_output_fields<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.output_fields = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [action_spec][crate::model::Action::action_spec].
    ///
    /// Note that all the setters affecting `action_spec` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Action;
    /// use google_cloud_ces_v1::model::action::ActionSpec;
    /// let x = Action::new().set_action_spec(Some(ActionSpec::ConnectionActionId("example".to_string())));
    /// ```
    pub fn set_action_spec<
        T: std::convert::Into<std::option::Option<crate::model::action::ActionSpec>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.action_spec = v.into();
        self
    }

    /// The value of [action_spec][crate::model::Action::action_spec]
    /// if it holds a `ConnectionActionId`, `None` if the field is not set or
    /// holds a different branch.
    pub fn connection_action_id(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.action_spec.as_ref().and_then(|v| match v {
            crate::model::action::ActionSpec::ConnectionActionId(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [action_spec][crate::model::Action::action_spec]
    /// to hold a `ConnectionActionId`.
    ///
    /// Note that all the setters affecting `action_spec` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Action;
    /// let x = Action::new().set_connection_action_id("example");
    /// assert!(x.connection_action_id().is_some());
    /// assert!(x.entity_operation().is_none());
    /// ```
    pub fn set_connection_action_id<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.action_spec = std::option::Option::Some(
            crate::model::action::ActionSpec::ConnectionActionId(v.into()),
        );
        self
    }

    /// The value of [action_spec][crate::model::Action::action_spec]
    /// if it holds a `EntityOperation`, `None` if the field is not set or
    /// holds a different branch.
    pub fn entity_operation(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::action::EntityOperation>> {
        #[allow(unreachable_patterns)]
        self.action_spec.as_ref().and_then(|v| match v {
            crate::model::action::ActionSpec::EntityOperation(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [action_spec][crate::model::Action::action_spec]
    /// to hold a `EntityOperation`.
    ///
    /// Note that all the setters affecting `action_spec` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Action;
    /// use google_cloud_ces_v1::model::action::EntityOperation;
    /// let x = Action::new().set_entity_operation(EntityOperation::default()/* use setters */);
    /// assert!(x.entity_operation().is_some());
    /// assert!(x.connection_action_id().is_none());
    /// ```
    pub fn set_entity_operation<
        T: std::convert::Into<std::boxed::Box<crate::model::action::EntityOperation>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.action_spec =
            std::option::Option::Some(crate::model::action::ActionSpec::EntityOperation(v.into()));
        self
    }
}

impl wkt::message::Message for Action {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Action"
    }
}

/// Defines additional types related to [Action].
pub mod action {
    #[allow(unused_imports)]
    use super::*;

    /// Entity CRUD operation specification.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct EntityOperation {
        /// Required. ID of the entity.
        pub entity_id: std::string::String,

        /// Required. Operation to perform on the entity.
        pub operation: crate::model::action::entity_operation::OperationType,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl EntityOperation {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [entity_id][crate::model::action::EntityOperation::entity_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::action::EntityOperation;
        /// let x = EntityOperation::new().set_entity_id("example");
        /// ```
        pub fn set_entity_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.entity_id = v.into();
            self
        }

        /// Sets the value of [operation][crate::model::action::EntityOperation::operation].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::action::EntityOperation;
        /// use google_cloud_ces_v1::model::action::entity_operation::OperationType;
        /// let x0 = EntityOperation::new().set_operation(OperationType::List);
        /// let x1 = EntityOperation::new().set_operation(OperationType::Get);
        /// let x2 = EntityOperation::new().set_operation(OperationType::Create);
        /// ```
        pub fn set_operation<
            T: std::convert::Into<crate::model::action::entity_operation::OperationType>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.operation = v.into();
            self
        }
    }

    impl wkt::message::Message for EntityOperation {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Action.EntityOperation"
        }
    }

    /// Defines additional types related to [EntityOperation].
    pub mod entity_operation {
        #[allow(unused_imports)]
        use super::*;

        /// The operation to perform on the entity.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum OperationType {
            /// Operation type unspecified. Invalid, ConnectorTool create/update
            /// will fail.
            Unspecified,
            /// List operation.
            List,
            /// Get operation.
            Get,
            /// Create operation.
            Create,
            /// Update operation.
            Update,
            /// Delete operation.
            Delete,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [OperationType::value] or
            /// [OperationType::name].
            UnknownValue(operation_type::UnknownValue),
        }

        #[doc(hidden)]
        pub mod operation_type {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl OperationType {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::List => std::option::Option::Some(1),
                    Self::Get => std::option::Option::Some(2),
                    Self::Create => std::option::Option::Some(3),
                    Self::Update => std::option::Option::Some(4),
                    Self::Delete => std::option::Option::Some(5),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("OPERATION_TYPE_UNSPECIFIED"),
                    Self::List => std::option::Option::Some("LIST"),
                    Self::Get => std::option::Option::Some("GET"),
                    Self::Create => std::option::Option::Some("CREATE"),
                    Self::Update => std::option::Option::Some("UPDATE"),
                    Self::Delete => std::option::Option::Some("DELETE"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for OperationType {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for OperationType {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for OperationType {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::List,
                    2 => Self::Get,
                    3 => Self::Create,
                    4 => Self::Update,
                    5 => Self::Delete,
                    _ => Self::UnknownValue(operation_type::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for OperationType {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "OPERATION_TYPE_UNSPECIFIED" => Self::Unspecified,
                    "LIST" => Self::List,
                    "GET" => Self::Get,
                    "CREATE" => Self::Create,
                    "UPDATE" => Self::Update,
                    "DELETE" => Self::Delete,
                    _ => Self::UnknownValue(operation_type::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for OperationType {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::List => serializer.serialize_i32(1),
                    Self::Get => serializer.serialize_i32(2),
                    Self::Create => serializer.serialize_i32(3),
                    Self::Update => serializer.serialize_i32(4),
                    Self::Delete => serializer.serialize_i32(5),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for OperationType {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<OperationType>::new(
                    ".google.cloud.ces.v1.Action.EntityOperation.OperationType",
                ))
            }
        }
    }

    /// Specification for an action to configure for the tool to use.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ActionSpec {
        /// ID of a Connection action for the tool to use.
        ConnectionActionId(std::string::String),
        /// Entity operation configuration for the tool to use.
        EntityOperation(std::boxed::Box<crate::model::action::EntityOperation>),
    }
}

/// A ConnectorTool allows connections to different integrations.
/// See: <https://cloud.google.com/integration-connectors/docs/overview>.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ConnectorTool {
    /// Required. The full resource name of the referenced Integration Connectors
    /// Connection.
    /// Format:
    /// `projects/{project}/locations/{location}/connections/{connection}`
    pub connection: std::string::String,

    /// Required. Action for the tool to use.
    pub action: std::option::Option<crate::model::Action>,

    /// Optional. Configures how authentication is handled in Integration
    /// Connectors. By default, an admin authentication is passed in the
    /// Integration Connectors API requests. You can override it with a different
    /// end-user authentication config.
    /// **Note**: The Connection must have authentication override enabled in
    /// order to specify an EUC configuration here - otherwise, the ConnectorTool
    /// creation will fail. See
    /// <https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override>
    /// for details.
    pub auth_config: std::option::Option<crate::model::EndUserAuthConfig>,

    /// Optional. The name of the tool that can be used by the Agent to decide
    /// whether to call this ConnectorTool.
    pub name: std::string::String,

    /// Optional. The description of the tool that can be used by the Agent to
    /// decide whether to call this ConnectorTool.
    pub description: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ConnectorTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [connection][crate::model::ConnectorTool::connection].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorTool;
    /// let x = ConnectorTool::new().set_connection("example");
    /// ```
    pub fn set_connection<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.connection = v.into();
        self
    }

    /// Sets the value of [action][crate::model::ConnectorTool::action].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorTool;
    /// use google_cloud_ces_v1::model::Action;
    /// let x = ConnectorTool::new().set_action(Action::default()/* use setters */);
    /// ```
    pub fn set_action<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Action>,
    {
        self.action = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [action][crate::model::ConnectorTool::action].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorTool;
    /// use google_cloud_ces_v1::model::Action;
    /// let x = ConnectorTool::new().set_or_clear_action(Some(Action::default()/* use setters */));
    /// let x = ConnectorTool::new().set_or_clear_action(None::<Action>);
    /// ```
    pub fn set_or_clear_action<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Action>,
    {
        self.action = v.map(|x| x.into());
        self
    }

    /// Sets the value of [auth_config][crate::model::ConnectorTool::auth_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorTool;
    /// use google_cloud_ces_v1::model::EndUserAuthConfig;
    /// let x = ConnectorTool::new().set_auth_config(EndUserAuthConfig::default()/* use setters */);
    /// ```
    pub fn set_auth_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::EndUserAuthConfig>,
    {
        self.auth_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [auth_config][crate::model::ConnectorTool::auth_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorTool;
    /// use google_cloud_ces_v1::model::EndUserAuthConfig;
    /// let x = ConnectorTool::new().set_or_clear_auth_config(Some(EndUserAuthConfig::default()/* use setters */));
    /// let x = ConnectorTool::new().set_or_clear_auth_config(None::<EndUserAuthConfig>);
    /// ```
    pub fn set_or_clear_auth_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::EndUserAuthConfig>,
    {
        self.auth_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [name][crate::model::ConnectorTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorTool;
    /// let x = ConnectorTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::ConnectorTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorTool;
    /// let x = ConnectorTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }
}

impl wkt::message::Message for ConnectorTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ConnectorTool"
    }
}

/// A toolset that generates tools from an Integration Connectors Connection.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ConnectorToolset {
    /// Required. The full resource name of the referenced Integration Connectors
    /// Connection.
    /// Format:
    /// `projects/{project}/locations/{location}/connections/{connection}`
    pub connection: std::string::String,

    /// Optional. Configures how authentication is handled in Integration
    /// Connectors. By default, an admin authentication is passed in the
    /// Integration Connectors API requests. You can override it with a different
    /// end-user authentication config.
    /// **Note**: The Connection must have authentication override enabled in
    /// order to specify an EUC configuration here - otherwise, the Toolset
    /// creation will fail. See:
    /// <https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override>
    pub auth_config: std::option::Option<crate::model::EndUserAuthConfig>,

    /// Required. The list of connector actions/entity operations to generate tools
    /// for.
    pub connector_actions: std::vec::Vec<crate::model::Action>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ConnectorToolset {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [connection][crate::model::ConnectorToolset::connection].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorToolset;
    /// let x = ConnectorToolset::new().set_connection("example");
    /// ```
    pub fn set_connection<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.connection = v.into();
        self
    }

    /// Sets the value of [auth_config][crate::model::ConnectorToolset::auth_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorToolset;
    /// use google_cloud_ces_v1::model::EndUserAuthConfig;
    /// let x = ConnectorToolset::new().set_auth_config(EndUserAuthConfig::default()/* use setters */);
    /// ```
    pub fn set_auth_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::EndUserAuthConfig>,
    {
        self.auth_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [auth_config][crate::model::ConnectorToolset::auth_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorToolset;
    /// use google_cloud_ces_v1::model::EndUserAuthConfig;
    /// let x = ConnectorToolset::new().set_or_clear_auth_config(Some(EndUserAuthConfig::default()/* use setters */));
    /// let x = ConnectorToolset::new().set_or_clear_auth_config(None::<EndUserAuthConfig>);
    /// ```
    pub fn set_or_clear_auth_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::EndUserAuthConfig>,
    {
        self.auth_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [connector_actions][crate::model::ConnectorToolset::connector_actions].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ConnectorToolset;
    /// use google_cloud_ces_v1::model::Action;
    /// let x = ConnectorToolset::new()
    ///     .set_connector_actions([
    ///         Action::default()/* use setters */,
    ///         Action::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_connector_actions<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Action>,
    {
        use std::iter::Iterator;
        self.connector_actions = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for ConnectorToolset {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ConnectorToolset"
    }
}

/// A conversation represents an interaction between an end user and the CES app.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Conversation {
    /// Identifier. The unique identifier of the conversation.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}`
    pub name: std::string::String,

    /// Output only. Timestamp when the conversation was created.
    pub start_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Timestamp when the conversation was completed.
    pub end_time: std::option::Option<wkt::Timestamp>,

    /// Required. The turns in the conversation.
    pub turns: std::vec::Vec<crate::model::conversation::Turn>,

    /// Output only. The number of turns in the conversation.
    pub turn_count: i32,

    /// DEPRECATED. Please use
    /// [input_types][google.cloud.ces.v1.Conversation.input_types] instead.
    ///
    /// [google.cloud.ces.v1.Conversation.input_types]: crate::model::Conversation::input_types
    #[deprecated]
    pub channel_type: crate::model::conversation::ChannelType,

    /// Output only. Indicate the source of the conversation.
    pub source: crate::model::conversation::Source,

    /// Output only. The input types of the conversation.
    pub input_types: std::vec::Vec<crate::model::conversation::InputType>,

    /// Output only. The agent that initially handles the conversation. If not
    /// specified, the conversation is handled by the root agent. Format:
    /// `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
    pub entry_agent: std::string::String,

    /// Output only. The deployment of the app used for processing the
    /// conversation. Format:
    /// `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`
    pub deployment: std::string::String,

    /// Output only. The version of the app used for processing the conversation.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/versions/{version}`
    pub app_version: std::string::String,

    /// Output only. The language code of the conversation.
    pub language_code: std::string::String,

    /// Deprecated. Use turns instead.
    #[deprecated]
    pub messages: std::vec::Vec<crate::model::Message>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Conversation {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Conversation::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let conversation_id = "conversation_id";
    /// let x = Conversation::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/conversations/{conversation_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [start_time][crate::model::Conversation::start_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// use wkt::Timestamp;
    /// let x = Conversation::new().set_start_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_start_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.start_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [start_time][crate::model::Conversation::start_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// use wkt::Timestamp;
    /// let x = Conversation::new().set_or_clear_start_time(Some(Timestamp::default()/* use setters */));
    /// let x = Conversation::new().set_or_clear_start_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_start_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.start_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [end_time][crate::model::Conversation::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// use wkt::Timestamp;
    /// let x = Conversation::new().set_end_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_end_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [end_time][crate::model::Conversation::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// use wkt::Timestamp;
    /// let x = Conversation::new().set_or_clear_end_time(Some(Timestamp::default()/* use setters */));
    /// let x = Conversation::new().set_or_clear_end_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_end_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [turns][crate::model::Conversation::turns].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// use google_cloud_ces_v1::model::conversation::Turn;
    /// let x = Conversation::new()
    ///     .set_turns([
    ///         Turn::default()/* use setters */,
    ///         Turn::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_turns<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::conversation::Turn>,
    {
        use std::iter::Iterator;
        self.turns = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [turn_count][crate::model::Conversation::turn_count].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// let x = Conversation::new().set_turn_count(42);
    /// ```
    pub fn set_turn_count<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.turn_count = v.into();
        self
    }

    /// Sets the value of [channel_type][crate::model::Conversation::channel_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// use google_cloud_ces_v1::model::conversation::ChannelType;
    /// let x0 = Conversation::new().set_channel_type(ChannelType::Text);
    /// let x1 = Conversation::new().set_channel_type(ChannelType::Audio);
    /// let x2 = Conversation::new().set_channel_type(ChannelType::Multimodal);
    /// ```
    #[deprecated]
    pub fn set_channel_type<T: std::convert::Into<crate::model::conversation::ChannelType>>(
        mut self,
        v: T,
    ) -> Self {
        self.channel_type = v.into();
        self
    }

    /// Sets the value of [source][crate::model::Conversation::source].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// use google_cloud_ces_v1::model::conversation::Source;
    /// let x0 = Conversation::new().set_source(Source::Live);
    /// let x1 = Conversation::new().set_source(Source::Simulator);
    /// let x2 = Conversation::new().set_source(Source::Eval);
    /// ```
    pub fn set_source<T: std::convert::Into<crate::model::conversation::Source>>(
        mut self,
        v: T,
    ) -> Self {
        self.source = v.into();
        self
    }

    /// Sets the value of [input_types][crate::model::Conversation::input_types].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// use google_cloud_ces_v1::model::conversation::InputType;
    /// let x = Conversation::new().set_input_types([
    ///     InputType::Text,
    ///     InputType::Event,
    ///     InputType::Audio,
    /// ]);
    /// ```
    pub fn set_input_types<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::conversation::InputType>,
    {
        use std::iter::Iterator;
        self.input_types = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [entry_agent][crate::model::Conversation::entry_agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = Conversation::new().set_entry_agent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_entry_agent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.entry_agent = v.into();
        self
    }

    /// Sets the value of [deployment][crate::model::Conversation::deployment].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let deployment_id = "deployment_id";
    /// let x = Conversation::new().set_deployment(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/deployments/{deployment_id}"));
    /// ```
    pub fn set_deployment<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.deployment = v.into();
        self
    }

    /// Sets the value of [app_version][crate::model::Conversation::app_version].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let version_id = "version_id";
    /// let x = Conversation::new().set_app_version(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/versions/{version_id}"));
    /// ```
    pub fn set_app_version<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.app_version = v.into();
        self
    }

    /// Sets the value of [language_code][crate::model::Conversation::language_code].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// let x = Conversation::new().set_language_code("example");
    /// ```
    pub fn set_language_code<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.language_code = v.into();
        self
    }

    /// Sets the value of [messages][crate::model::Conversation::messages].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Conversation;
    /// use google_cloud_ces_v1::model::Message;
    /// let x = Conversation::new()
    ///     .set_messages([
    ///         Message::default()/* use setters */,
    ///         Message::default()/* use (different) setters */,
    ///     ]);
    /// ```
    #[deprecated]
    pub fn set_messages<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Message>,
    {
        use std::iter::Iterator;
        self.messages = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for Conversation {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Conversation"
    }
}

/// Defines additional types related to [Conversation].
pub mod conversation {
    #[allow(unused_imports)]
    use super::*;

    /// All information about a single turn in the conversation.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct Turn {
        /// Optional. List of messages in the conversation turn, including user
        /// input, agent responses and intermediate events during the processing.
        pub messages: std::vec::Vec<crate::model::Message>,

        /// Optional. The root span of the action processing.
        pub root_span: std::option::Option<crate::model::Span>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl Turn {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [messages][crate::model::conversation::Turn::messages].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::conversation::Turn;
        /// use google_cloud_ces_v1::model::Message;
        /// let x = Turn::new()
        ///     .set_messages([
        ///         Message::default()/* use setters */,
        ///         Message::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_messages<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::Message>,
        {
            use std::iter::Iterator;
            self.messages = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [root_span][crate::model::conversation::Turn::root_span].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::conversation::Turn;
        /// use google_cloud_ces_v1::model::Span;
        /// let x = Turn::new().set_root_span(Span::default()/* use setters */);
        /// ```
        pub fn set_root_span<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::Span>,
        {
            self.root_span = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [root_span][crate::model::conversation::Turn::root_span].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::conversation::Turn;
        /// use google_cloud_ces_v1::model::Span;
        /// let x = Turn::new().set_or_clear_root_span(Some(Span::default()/* use setters */));
        /// let x = Turn::new().set_or_clear_root_span(None::<Span>);
        /// ```
        pub fn set_or_clear_root_span<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::Span>,
        {
            self.root_span = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for Turn {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Conversation.Turn"
        }
    }

    /// The channel type of the conversation.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ChannelType {
        /// Unspecified channel type.
        Unspecified,
        /// The conversation only contains text messages between the end user and the
        /// agent.
        Text,
        /// The conversation contains audio messages between the end user and the
        /// agent.
        Audio,
        /// The conversation multi-modal messages (e.g. image) between the end user
        /// and the agent.
        Multimodal,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [ChannelType::value] or
        /// [ChannelType::name].
        UnknownValue(channel_type::UnknownValue),
    }

    #[doc(hidden)]
    pub mod channel_type {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl ChannelType {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Text => std::option::Option::Some(1),
                Self::Audio => std::option::Option::Some(2),
                Self::Multimodal => std::option::Option::Some(3),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("CHANNEL_TYPE_UNSPECIFIED"),
                Self::Text => std::option::Option::Some("TEXT"),
                Self::Audio => std::option::Option::Some("AUDIO"),
                Self::Multimodal => std::option::Option::Some("MULTIMODAL"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for ChannelType {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for ChannelType {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for ChannelType {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Text,
                2 => Self::Audio,
                3 => Self::Multimodal,
                _ => Self::UnknownValue(channel_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for ChannelType {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "CHANNEL_TYPE_UNSPECIFIED" => Self::Unspecified,
                "TEXT" => Self::Text,
                "AUDIO" => Self::Audio,
                "MULTIMODAL" => Self::Multimodal,
                _ => Self::UnknownValue(channel_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for ChannelType {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Text => serializer.serialize_i32(1),
                Self::Audio => serializer.serialize_i32(2),
                Self::Multimodal => serializer.serialize_i32(3),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for ChannelType {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<ChannelType>::new(
                ".google.cloud.ces.v1.Conversation.ChannelType",
            ))
        }
    }

    /// The source of the conversation.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum Source {
        /// Unspecified source.
        Unspecified,
        /// The conversation is from the live end user.
        Live,
        /// The conversation is from the simulator.
        Simulator,
        /// The conversation is from the evaluation.
        Eval,
        /// The conversation is from an agent tool. Agent tool runs the agent in a
        /// separate session, which is persisted for testing and debugging purposes.
        AgentTool,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [Source::value] or
        /// [Source::name].
        UnknownValue(source::UnknownValue),
    }

    #[doc(hidden)]
    pub mod source {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl Source {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Live => std::option::Option::Some(1),
                Self::Simulator => std::option::Option::Some(2),
                Self::Eval => std::option::Option::Some(3),
                Self::AgentTool => std::option::Option::Some(4),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("SOURCE_UNSPECIFIED"),
                Self::Live => std::option::Option::Some("LIVE"),
                Self::Simulator => std::option::Option::Some("SIMULATOR"),
                Self::Eval => std::option::Option::Some("EVAL"),
                Self::AgentTool => std::option::Option::Some("AGENT_TOOL"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for Source {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for Source {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for Source {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Live,
                2 => Self::Simulator,
                3 => Self::Eval,
                4 => Self::AgentTool,
                _ => Self::UnknownValue(source::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for Source {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "SOURCE_UNSPECIFIED" => Self::Unspecified,
                "LIVE" => Self::Live,
                "SIMULATOR" => Self::Simulator,
                "EVAL" => Self::Eval,
                "AGENT_TOOL" => Self::AgentTool,
                _ => Self::UnknownValue(source::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for Source {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Live => serializer.serialize_i32(1),
                Self::Simulator => serializer.serialize_i32(2),
                Self::Eval => serializer.serialize_i32(3),
                Self::AgentTool => serializer.serialize_i32(4),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for Source {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<Source>::new(
                ".google.cloud.ces.v1.Conversation.Source",
            ))
        }
    }

    /// Type of the input message.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum InputType {
        /// Unspecified input type.
        Unspecified,
        /// Text input.
        Text,
        /// Event input.
        Event,
        /// Audio input.
        Audio,
        /// Image input.
        Image,
        /// Blob input.
        Blob,
        /// Client function tool response input.
        ToolResponse,
        /// Variables input.
        Variables,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [InputType::value] or
        /// [InputType::name].
        UnknownValue(input_type::UnknownValue),
    }

    #[doc(hidden)]
    pub mod input_type {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl InputType {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Text => std::option::Option::Some(1),
                Self::Event => std::option::Option::Some(7),
                Self::Audio => std::option::Option::Some(2),
                Self::Image => std::option::Option::Some(3),
                Self::Blob => std::option::Option::Some(4),
                Self::ToolResponse => std::option::Option::Some(5),
                Self::Variables => std::option::Option::Some(6),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("INPUT_TYPE_UNSPECIFIED"),
                Self::Text => std::option::Option::Some("INPUT_TYPE_TEXT"),
                Self::Event => std::option::Option::Some("INPUT_TYPE_EVENT"),
                Self::Audio => std::option::Option::Some("INPUT_TYPE_AUDIO"),
                Self::Image => std::option::Option::Some("INPUT_TYPE_IMAGE"),
                Self::Blob => std::option::Option::Some("INPUT_TYPE_BLOB"),
                Self::ToolResponse => std::option::Option::Some("INPUT_TYPE_TOOL_RESPONSE"),
                Self::Variables => std::option::Option::Some("INPUT_TYPE_VARIABLES"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for InputType {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for InputType {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for InputType {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Text,
                2 => Self::Audio,
                3 => Self::Image,
                4 => Self::Blob,
                5 => Self::ToolResponse,
                6 => Self::Variables,
                7 => Self::Event,
                _ => Self::UnknownValue(input_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for InputType {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "INPUT_TYPE_UNSPECIFIED" => Self::Unspecified,
                "INPUT_TYPE_TEXT" => Self::Text,
                "INPUT_TYPE_EVENT" => Self::Event,
                "INPUT_TYPE_AUDIO" => Self::Audio,
                "INPUT_TYPE_IMAGE" => Self::Image,
                "INPUT_TYPE_BLOB" => Self::Blob,
                "INPUT_TYPE_TOOL_RESPONSE" => Self::ToolResponse,
                "INPUT_TYPE_VARIABLES" => Self::Variables,
                _ => Self::UnknownValue(input_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for InputType {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Text => serializer.serialize_i32(1),
                Self::Event => serializer.serialize_i32(7),
                Self::Audio => serializer.serialize_i32(2),
                Self::Image => serializer.serialize_i32(3),
                Self::Blob => serializer.serialize_i32(4),
                Self::ToolResponse => serializer.serialize_i32(5),
                Self::Variables => serializer.serialize_i32(6),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for InputType {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<InputType>::new(
                ".google.cloud.ces.v1.Conversation.InputType",
            ))
        }
    }
}

/// A DataStore resource in Vertex AI Search.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DataStore {
    /// Required. Full resource name of the DataStore.
    /// Format:
    /// `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}`
    pub name: std::string::String,

    /// Output only. The type of the data store. This field is readonly and
    /// populated by the server.
    pub r#type: crate::model::data_store::DataStoreType,

    /// Output only. The document processing mode for the data store connection.
    /// Only set for PUBLIC_WEB and UNSTRUCTURED data stores.
    pub document_processing_mode: crate::model::data_store::DocumentProcessingMode,

    /// Output only. The display name of the data store.
    pub display_name: std::string::String,

    /// Output only. Timestamp when the data store was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. The connector config for the data store connection.
    pub connector_config: std::option::Option<crate::model::data_store::ConnectorConfig>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DataStore {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DataStore::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStore;
    /// let x = DataStore::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [r#type][crate::model::DataStore::type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStore;
    /// use google_cloud_ces_v1::model::data_store::DataStoreType;
    /// let x0 = DataStore::new().set_type(DataStoreType::PublicWeb);
    /// let x1 = DataStore::new().set_type(DataStoreType::Unstructured);
    /// let x2 = DataStore::new().set_type(DataStoreType::Faq);
    /// ```
    pub fn set_type<T: std::convert::Into<crate::model::data_store::DataStoreType>>(
        mut self,
        v: T,
    ) -> Self {
        self.r#type = v.into();
        self
    }

    /// Sets the value of [document_processing_mode][crate::model::DataStore::document_processing_mode].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStore;
    /// use google_cloud_ces_v1::model::data_store::DocumentProcessingMode;
    /// let x0 = DataStore::new().set_document_processing_mode(DocumentProcessingMode::Documents);
    /// let x1 = DataStore::new().set_document_processing_mode(DocumentProcessingMode::Chunks);
    /// ```
    pub fn set_document_processing_mode<
        T: std::convert::Into<crate::model::data_store::DocumentProcessingMode>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.document_processing_mode = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::DataStore::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStore;
    /// let x = DataStore::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [create_time][crate::model::DataStore::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStore;
    /// use wkt::Timestamp;
    /// let x = DataStore::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::DataStore::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStore;
    /// use wkt::Timestamp;
    /// let x = DataStore::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = DataStore::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [connector_config][crate::model::DataStore::connector_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStore;
    /// use google_cloud_ces_v1::model::data_store::ConnectorConfig;
    /// let x = DataStore::new().set_connector_config(ConnectorConfig::default()/* use setters */);
    /// ```
    pub fn set_connector_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::data_store::ConnectorConfig>,
    {
        self.connector_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [connector_config][crate::model::DataStore::connector_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStore;
    /// use google_cloud_ces_v1::model::data_store::ConnectorConfig;
    /// let x = DataStore::new().set_or_clear_connector_config(Some(ConnectorConfig::default()/* use setters */));
    /// let x = DataStore::new().set_or_clear_connector_config(None::<ConnectorConfig>);
    /// ```
    pub fn set_or_clear_connector_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::data_store::ConnectorConfig>,
    {
        self.connector_config = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for DataStore {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DataStore"
    }
}

/// Defines additional types related to [DataStore].
pub mod data_store {
    #[allow(unused_imports)]
    use super::*;

    /// The connector config for the data store connection.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct ConnectorConfig {
        /// Resource name of the collection the data store belongs to.
        pub collection: std::string::String,

        /// Display name of the collection the data store belongs to.
        pub collection_display_name: std::string::String,

        /// The name of the data source.
        /// Example: `salesforce`, `jira`, `confluence`, `bigquery`.
        pub data_source: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl ConnectorConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [collection][crate::model::data_store::ConnectorConfig::collection].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store::ConnectorConfig;
        /// let x = ConnectorConfig::new().set_collection("example");
        /// ```
        pub fn set_collection<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.collection = v.into();
            self
        }

        /// Sets the value of [collection_display_name][crate::model::data_store::ConnectorConfig::collection_display_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store::ConnectorConfig;
        /// let x = ConnectorConfig::new().set_collection_display_name("example");
        /// ```
        pub fn set_collection_display_name<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.collection_display_name = v.into();
            self
        }

        /// Sets the value of [data_source][crate::model::data_store::ConnectorConfig::data_source].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store::ConnectorConfig;
        /// let x = ConnectorConfig::new().set_data_source("example");
        /// ```
        pub fn set_data_source<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.data_source = v.into();
            self
        }
    }

    impl wkt::message::Message for ConnectorConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStore.ConnectorConfig"
        }
    }

    /// The type of the data store.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum DataStoreType {
        /// Not specified. This value indicates that the data store type is not
        /// specified, so it will not be used during search.
        Unspecified,
        /// A data store that contains public web content.
        PublicWeb,
        /// A data store that contains unstructured private data.
        Unstructured,
        /// A data store that contains structured data used as FAQ.
        Faq,
        /// A data store that is a connector to a first-party or a third-party
        /// service.
        Connector,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [DataStoreType::value] or
        /// [DataStoreType::name].
        UnknownValue(data_store_type::UnknownValue),
    }

    #[doc(hidden)]
    pub mod data_store_type {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl DataStoreType {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::PublicWeb => std::option::Option::Some(1),
                Self::Unstructured => std::option::Option::Some(2),
                Self::Faq => std::option::Option::Some(3),
                Self::Connector => std::option::Option::Some(4),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("DATA_STORE_TYPE_UNSPECIFIED"),
                Self::PublicWeb => std::option::Option::Some("PUBLIC_WEB"),
                Self::Unstructured => std::option::Option::Some("UNSTRUCTURED"),
                Self::Faq => std::option::Option::Some("FAQ"),
                Self::Connector => std::option::Option::Some("CONNECTOR"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for DataStoreType {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for DataStoreType {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for DataStoreType {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::PublicWeb,
                2 => Self::Unstructured,
                3 => Self::Faq,
                4 => Self::Connector,
                _ => Self::UnknownValue(data_store_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for DataStoreType {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "DATA_STORE_TYPE_UNSPECIFIED" => Self::Unspecified,
                "PUBLIC_WEB" => Self::PublicWeb,
                "UNSTRUCTURED" => Self::Unstructured,
                "FAQ" => Self::Faq,
                "CONNECTOR" => Self::Connector,
                _ => Self::UnknownValue(data_store_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for DataStoreType {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::PublicWeb => serializer.serialize_i32(1),
                Self::Unstructured => serializer.serialize_i32(2),
                Self::Faq => serializer.serialize_i32(3),
                Self::Connector => serializer.serialize_i32(4),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for DataStoreType {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<DataStoreType>::new(
                ".google.cloud.ces.v1.DataStore.DataStoreType",
            ))
        }
    }

    /// The document processing mode of the data store.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum DocumentProcessingMode {
        /// Not specified.
        Unspecified,
        /// Documents are processed as documents.
        Documents,
        /// Documents are converted to chunks.
        Chunks,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [DocumentProcessingMode::value] or
        /// [DocumentProcessingMode::name].
        UnknownValue(document_processing_mode::UnknownValue),
    }

    #[doc(hidden)]
    pub mod document_processing_mode {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl DocumentProcessingMode {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Documents => std::option::Option::Some(1),
                Self::Chunks => std::option::Option::Some(2),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => {
                    std::option::Option::Some("DOCUMENT_PROCESSING_MODE_UNSPECIFIED")
                }
                Self::Documents => std::option::Option::Some("DOCUMENTS"),
                Self::Chunks => std::option::Option::Some("CHUNKS"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for DocumentProcessingMode {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for DocumentProcessingMode {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for DocumentProcessingMode {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Documents,
                2 => Self::Chunks,
                _ => Self::UnknownValue(document_processing_mode::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for DocumentProcessingMode {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "DOCUMENT_PROCESSING_MODE_UNSPECIFIED" => Self::Unspecified,
                "DOCUMENTS" => Self::Documents,
                "CHUNKS" => Self::Chunks,
                _ => Self::UnknownValue(document_processing_mode::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for DocumentProcessingMode {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Documents => serializer.serialize_i32(1),
                Self::Chunks => serializer.serialize_i32(2),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for DocumentProcessingMode {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<DocumentProcessingMode>::new(
                ".google.cloud.ces.v1.DataStore.DocumentProcessingMode",
            ))
        }
    }
}

/// Tool to retrieve from Vertex AI Search datastore or engine for grounding.
/// Accepts either a datastore or an engine, but not both.
/// See Vertex AI Search:
/// <https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction>.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct DataStoreTool {
    /// Required. The data store tool name.
    pub name: std::string::String,

    /// Optional. The tool description.
    pub description: std::string::String,

    /// Optional. Boost specification to boost certain documents.
    pub boost_specs: std::vec::Vec<crate::model::data_store_tool::BoostSpecs>,

    /// Optional. The modality configs for the data store.
    pub modality_configs: std::vec::Vec<crate::model::data_store_tool::ModalityConfig>,

    /// Optional. The filter parameter behavior.
    pub filter_parameter_behavior: crate::model::data_store_tool::FilterParameterBehavior,

    /// Defines the search source, either a single DataStore or an Engine.
    pub search_source: std::option::Option<crate::model::data_store_tool::SearchSource>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl DataStoreTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::DataStoreTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStoreTool;
    /// let x = DataStoreTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::DataStoreTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStoreTool;
    /// let x = DataStoreTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [boost_specs][crate::model::DataStoreTool::boost_specs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStoreTool;
    /// use google_cloud_ces_v1::model::data_store_tool::BoostSpecs;
    /// let x = DataStoreTool::new()
    ///     .set_boost_specs([
    ///         BoostSpecs::default()/* use setters */,
    ///         BoostSpecs::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_boost_specs<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::data_store_tool::BoostSpecs>,
    {
        use std::iter::Iterator;
        self.boost_specs = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [modality_configs][crate::model::DataStoreTool::modality_configs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStoreTool;
    /// use google_cloud_ces_v1::model::data_store_tool::ModalityConfig;
    /// let x = DataStoreTool::new()
    ///     .set_modality_configs([
    ///         ModalityConfig::default()/* use setters */,
    ///         ModalityConfig::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_modality_configs<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::data_store_tool::ModalityConfig>,
    {
        use std::iter::Iterator;
        self.modality_configs = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [filter_parameter_behavior][crate::model::DataStoreTool::filter_parameter_behavior].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStoreTool;
    /// use google_cloud_ces_v1::model::data_store_tool::FilterParameterBehavior;
    /// let x0 = DataStoreTool::new().set_filter_parameter_behavior(FilterParameterBehavior::AlwaysInclude);
    /// let x1 = DataStoreTool::new().set_filter_parameter_behavior(FilterParameterBehavior::NeverInclude);
    /// ```
    pub fn set_filter_parameter_behavior<
        T: std::convert::Into<crate::model::data_store_tool::FilterParameterBehavior>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.filter_parameter_behavior = v.into();
        self
    }

    /// Sets the value of [search_source][crate::model::DataStoreTool::search_source].
    ///
    /// Note that all the setters affecting `search_source` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStoreTool;
    /// use google_cloud_ces_v1::model::data_store_tool::DataStoreSource;
    /// let x = DataStoreTool::new().set_search_source(Some(
    ///     google_cloud_ces_v1::model::data_store_tool::SearchSource::DataStoreSource(DataStoreSource::default().into())));
    /// ```
    pub fn set_search_source<
        T: std::convert::Into<std::option::Option<crate::model::data_store_tool::SearchSource>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.search_source = v.into();
        self
    }

    /// The value of [search_source][crate::model::DataStoreTool::search_source]
    /// if it holds a `DataStoreSource`, `None` if the field is not set or
    /// holds a different branch.
    pub fn data_store_source(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::data_store_tool::DataStoreSource>> {
        #[allow(unreachable_patterns)]
        self.search_source.as_ref().and_then(|v| match v {
            crate::model::data_store_tool::SearchSource::DataStoreSource(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [search_source][crate::model::DataStoreTool::search_source]
    /// to hold a `DataStoreSource`.
    ///
    /// Note that all the setters affecting `search_source` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStoreTool;
    /// use google_cloud_ces_v1::model::data_store_tool::DataStoreSource;
    /// let x = DataStoreTool::new().set_data_store_source(DataStoreSource::default()/* use setters */);
    /// assert!(x.data_store_source().is_some());
    /// assert!(x.engine_source().is_none());
    /// ```
    pub fn set_data_store_source<
        T: std::convert::Into<std::boxed::Box<crate::model::data_store_tool::DataStoreSource>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.search_source = std::option::Option::Some(
            crate::model::data_store_tool::SearchSource::DataStoreSource(v.into()),
        );
        self
    }

    /// The value of [search_source][crate::model::DataStoreTool::search_source]
    /// if it holds a `EngineSource`, `None` if the field is not set or
    /// holds a different branch.
    pub fn engine_source(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::data_store_tool::EngineSource>> {
        #[allow(unreachable_patterns)]
        self.search_source.as_ref().and_then(|v| match v {
            crate::model::data_store_tool::SearchSource::EngineSource(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [search_source][crate::model::DataStoreTool::search_source]
    /// to hold a `EngineSource`.
    ///
    /// Note that all the setters affecting `search_source` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::DataStoreTool;
    /// use google_cloud_ces_v1::model::data_store_tool::EngineSource;
    /// let x = DataStoreTool::new().set_engine_source(EngineSource::default()/* use setters */);
    /// assert!(x.engine_source().is_some());
    /// assert!(x.data_store_source().is_none());
    /// ```
    pub fn set_engine_source<
        T: std::convert::Into<std::boxed::Box<crate::model::data_store_tool::EngineSource>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.search_source = std::option::Option::Some(
            crate::model::data_store_tool::SearchSource::EngineSource(v.into()),
        );
        self
    }
}

impl wkt::message::Message for DataStoreTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.DataStoreTool"
    }
}

/// Defines additional types related to [DataStoreTool].
pub mod data_store_tool {
    #[allow(unused_imports)]
    use super::*;

    /// Rewriter configuration.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct RewriterConfig {
        /// Required. Configurations for the LLM model.
        pub model_settings: std::option::Option<crate::model::ModelSettings>,

        /// Optional. The prompt definition. If not set, default prompt will be used.
        pub prompt: std::string::String,

        /// Optional. Whether the rewriter is disabled.
        pub disabled: bool,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl RewriterConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [model_settings][crate::model::data_store_tool::RewriterConfig::model_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::RewriterConfig;
        /// use google_cloud_ces_v1::model::ModelSettings;
        /// let x = RewriterConfig::new().set_model_settings(ModelSettings::default()/* use setters */);
        /// ```
        pub fn set_model_settings<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::ModelSettings>,
        {
            self.model_settings = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [model_settings][crate::model::data_store_tool::RewriterConfig::model_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::RewriterConfig;
        /// use google_cloud_ces_v1::model::ModelSettings;
        /// let x = RewriterConfig::new().set_or_clear_model_settings(Some(ModelSettings::default()/* use setters */));
        /// let x = RewriterConfig::new().set_or_clear_model_settings(None::<ModelSettings>);
        /// ```
        pub fn set_or_clear_model_settings<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::ModelSettings>,
        {
            self.model_settings = v.map(|x| x.into());
            self
        }

        /// Sets the value of [prompt][crate::model::data_store_tool::RewriterConfig::prompt].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::RewriterConfig;
        /// let x = RewriterConfig::new().set_prompt("example");
        /// ```
        pub fn set_prompt<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.prompt = v.into();
            self
        }

        /// Sets the value of [disabled][crate::model::data_store_tool::RewriterConfig::disabled].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::RewriterConfig;
        /// let x = RewriterConfig::new().set_disabled(true);
        /// ```
        pub fn set_disabled<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
            self.disabled = v.into();
            self
        }
    }

    impl wkt::message::Message for RewriterConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.RewriterConfig"
        }
    }

    /// Summarization configuration.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct SummarizationConfig {
        /// Optional. Configurations for the LLM model.
        pub model_settings: std::option::Option<crate::model::ModelSettings>,

        /// Optional. The prompt definition. If not set, default prompt will be used.
        pub prompt: std::string::String,

        /// Optional. Whether summarization is disabled.
        pub disabled: bool,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl SummarizationConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [model_settings][crate::model::data_store_tool::SummarizationConfig::model_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::SummarizationConfig;
        /// use google_cloud_ces_v1::model::ModelSettings;
        /// let x = SummarizationConfig::new().set_model_settings(ModelSettings::default()/* use setters */);
        /// ```
        pub fn set_model_settings<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::ModelSettings>,
        {
            self.model_settings = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [model_settings][crate::model::data_store_tool::SummarizationConfig::model_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::SummarizationConfig;
        /// use google_cloud_ces_v1::model::ModelSettings;
        /// let x = SummarizationConfig::new().set_or_clear_model_settings(Some(ModelSettings::default()/* use setters */));
        /// let x = SummarizationConfig::new().set_or_clear_model_settings(None::<ModelSettings>);
        /// ```
        pub fn set_or_clear_model_settings<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::ModelSettings>,
        {
            self.model_settings = v.map(|x| x.into());
            self
        }

        /// Sets the value of [prompt][crate::model::data_store_tool::SummarizationConfig::prompt].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::SummarizationConfig;
        /// let x = SummarizationConfig::new().set_prompt("example");
        /// ```
        pub fn set_prompt<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.prompt = v.into();
            self
        }

        /// Sets the value of [disabled][crate::model::data_store_tool::SummarizationConfig::disabled].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::SummarizationConfig;
        /// let x = SummarizationConfig::new().set_disabled(true);
        /// ```
        pub fn set_disabled<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
            self.disabled = v.into();
            self
        }
    }

    impl wkt::message::Message for SummarizationConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.SummarizationConfig"
        }
    }

    /// Grounding configuration.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct GroundingConfig {
        /// Optional. The groundedness threshold of the answer based on the retrieved
        /// sources. The value has a configurable range of [1, 5]. The level is used
        /// to threshold the groundedness of the answer, meaning that all responses
        /// with a groundedness score below the threshold will fall back to returning
        /// relevant snippets only.
        ///
        /// For example, a level of 3 means that the groundedness score must be
        /// 3 or higher for the response to be returned.
        pub grounding_level: f32,

        /// Optional. Whether grounding is disabled.
        pub disabled: bool,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl GroundingConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [grounding_level][crate::model::data_store_tool::GroundingConfig::grounding_level].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::GroundingConfig;
        /// let x = GroundingConfig::new().set_grounding_level(42.0);
        /// ```
        pub fn set_grounding_level<T: std::convert::Into<f32>>(mut self, v: T) -> Self {
            self.grounding_level = v.into();
            self
        }

        /// Sets the value of [disabled][crate::model::data_store_tool::GroundingConfig::disabled].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::GroundingConfig;
        /// let x = GroundingConfig::new().set_disabled(true);
        /// ```
        pub fn set_disabled<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
            self.disabled = v.into();
            self
        }
    }

    impl wkt::message::Message for GroundingConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.GroundingConfig"
        }
    }

    /// Configuration for searching within a specific DataStore.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct DataStoreSource {
        /// Optional. Filter specification for the DataStore.
        /// See:
        /// <https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata>
        pub filter: std::string::String,

        /// Optional. The data store.
        pub data_store: std::option::Option<crate::model::DataStore>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl DataStoreSource {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [filter][crate::model::data_store_tool::DataStoreSource::filter].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::DataStoreSource;
        /// let x = DataStoreSource::new().set_filter("example");
        /// ```
        pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.filter = v.into();
            self
        }

        /// Sets the value of [data_store][crate::model::data_store_tool::DataStoreSource::data_store].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::DataStoreSource;
        /// use google_cloud_ces_v1::model::DataStore;
        /// let x = DataStoreSource::new().set_data_store(DataStore::default()/* use setters */);
        /// ```
        pub fn set_data_store<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::DataStore>,
        {
            self.data_store = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [data_store][crate::model::data_store_tool::DataStoreSource::data_store].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::DataStoreSource;
        /// use google_cloud_ces_v1::model::DataStore;
        /// let x = DataStoreSource::new().set_or_clear_data_store(Some(DataStore::default()/* use setters */));
        /// let x = DataStoreSource::new().set_or_clear_data_store(None::<DataStore>);
        /// ```
        pub fn set_or_clear_data_store<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::DataStore>,
        {
            self.data_store = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for DataStoreSource {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.DataStoreSource"
        }
    }

    /// Configuration for searching within an Engine, potentially targeting
    /// specific DataStores.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct EngineSource {
        /// Required. Full resource name of the Engine.
        /// Format:
        /// `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`
        pub engine: std::string::String,

        /// Optional. Use to target specific DataStores within the Engine.
        /// If empty, the search applies to all DataStores associated with the
        /// Engine.
        pub data_store_sources: std::vec::Vec<crate::model::data_store_tool::DataStoreSource>,

        /// Optional. A filter applied to the search across the Engine. Not relevant
        /// and not used if 'data_store_sources' is provided. See:
        /// <https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata>
        pub filter: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl EngineSource {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [engine][crate::model::data_store_tool::EngineSource::engine].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::EngineSource;
        /// let x = EngineSource::new().set_engine("example");
        /// ```
        pub fn set_engine<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.engine = v.into();
            self
        }

        /// Sets the value of [data_store_sources][crate::model::data_store_tool::EngineSource::data_store_sources].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::EngineSource;
        /// use google_cloud_ces_v1::model::data_store_tool::DataStoreSource;
        /// let x = EngineSource::new()
        ///     .set_data_store_sources([
        ///         DataStoreSource::default()/* use setters */,
        ///         DataStoreSource::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_data_store_sources<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::data_store_tool::DataStoreSource>,
        {
            use std::iter::Iterator;
            self.data_store_sources = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [filter][crate::model::data_store_tool::EngineSource::filter].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::EngineSource;
        /// let x = EngineSource::new().set_filter("example");
        /// ```
        pub fn set_filter<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.filter = v.into();
            self
        }
    }

    impl wkt::message::Message for EngineSource {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.EngineSource"
        }
    }

    /// Boost specifications to boost certain documents.
    /// For more information, please refer to
    /// <https://cloud.google.com/generative-ai-app-builder/docs/boosting>.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct BoostSpecs {
        /// Required. The Data Store where the boosting configuration is applied.
        /// Full resource name of DataStore, such as
        /// projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}.
        pub data_stores: std::vec::Vec<std::string::String>,

        /// Required. A list of boosting specifications.
        pub spec: std::vec::Vec<crate::model::data_store_tool::BoostSpec>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl BoostSpecs {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [data_stores][crate::model::data_store_tool::BoostSpecs::data_stores].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::BoostSpecs;
        /// let x = BoostSpecs::new().set_data_stores(["a", "b", "c"]);
        /// ```
        pub fn set_data_stores<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.data_stores = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [spec][crate::model::data_store_tool::BoostSpecs::spec].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::BoostSpecs;
        /// use google_cloud_ces_v1::model::data_store_tool::BoostSpec;
        /// let x = BoostSpecs::new()
        ///     .set_spec([
        ///         BoostSpec::default()/* use setters */,
        ///         BoostSpec::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_spec<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::data_store_tool::BoostSpec>,
        {
            use std::iter::Iterator;
            self.spec = v.into_iter().map(|i| i.into()).collect();
            self
        }
    }

    impl wkt::message::Message for BoostSpecs {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.BoostSpecs"
        }
    }

    /// Boost specification to boost certain documents.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct BoostSpec {
        /// Required. A list of boosting specifications.
        pub condition_boost_specs:
            std::vec::Vec<crate::model::data_store_tool::boost_spec::ConditionBoostSpec>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl BoostSpec {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [condition_boost_specs][crate::model::data_store_tool::BoostSpec::condition_boost_specs].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::BoostSpec;
        /// use google_cloud_ces_v1::model::data_store_tool::boost_spec::ConditionBoostSpec;
        /// let x = BoostSpec::new()
        ///     .set_condition_boost_specs([
        ///         ConditionBoostSpec::default()/* use setters */,
        ///         ConditionBoostSpec::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_condition_boost_specs<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::data_store_tool::boost_spec::ConditionBoostSpec>,
        {
            use std::iter::Iterator;
            self.condition_boost_specs = v.into_iter().map(|i| i.into()).collect();
            self
        }
    }

    impl wkt::message::Message for BoostSpec {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.BoostSpec"
        }
    }

    /// Defines additional types related to [BoostSpec].
    pub mod boost_spec {
        #[allow(unused_imports)]
        use super::*;

        /// Boost specification for a condition.
        #[derive(Clone, Default, PartialEq)]
        #[non_exhaustive]
        pub struct ConditionBoostSpec {
            /// Required. An expression which specifies a boost condition. The syntax
            /// is the same as filter expression syntax. Currently, the only supported
            /// condition is a list of BCP-47 lang codes. Example: To boost suggestions
            /// in languages en or fr: (lang_code: ANY("en", "fr"))
            pub condition: std::string::String,

            /// Optional. Strength of the boost, which should be in [-1, 1]. Negative
            /// boost means demotion. Default is 0.0.
            ///
            /// Setting to 1.0 gives the suggestions a big promotion. However, it does
            /// not necessarily mean that the top result will be a boosted suggestion.
            ///
            /// Setting to -1.0 gives the suggestions a big demotion. However, other
            /// suggestions that are relevant might still be shown.
            ///
            /// Setting to 0.0 means no boost applied. The boosting condition is
            /// ignored.
            pub boost: f32,

            /// Optional. Complex specification for custom ranking based on customer
            /// defined attribute value.
            pub boost_control_spec: std::option::Option<
                crate::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec,
            >,

            pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
        }

        impl ConditionBoostSpec {
            /// Creates a new default instance.
            pub fn new() -> Self {
                std::default::Default::default()
            }

            /// Sets the value of [condition][crate::model::data_store_tool::boost_spec::ConditionBoostSpec::condition].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::ConditionBoostSpec;
            /// let x = ConditionBoostSpec::new().set_condition("example");
            /// ```
            pub fn set_condition<T: std::convert::Into<std::string::String>>(
                mut self,
                v: T,
            ) -> Self {
                self.condition = v.into();
                self
            }

            /// Sets the value of [boost][crate::model::data_store_tool::boost_spec::ConditionBoostSpec::boost].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::ConditionBoostSpec;
            /// let x = ConditionBoostSpec::new().set_boost(42.0);
            /// ```
            pub fn set_boost<T: std::convert::Into<f32>>(mut self, v: T) -> Self {
                self.boost = v.into();
                self
            }

            /// Sets the value of [boost_control_spec][crate::model::data_store_tool::boost_spec::ConditionBoostSpec::boost_control_spec].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::ConditionBoostSpec;
            /// use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec;
            /// let x = ConditionBoostSpec::new().set_boost_control_spec(BoostControlSpec::default()/* use setters */);
            /// ```
            pub fn set_boost_control_spec<T>(mut self, v: T) -> Self
            where T: std::convert::Into<crate::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec>
            {
                self.boost_control_spec = std::option::Option::Some(v.into());
                self
            }

            /// Sets or clears the value of [boost_control_spec][crate::model::data_store_tool::boost_spec::ConditionBoostSpec::boost_control_spec].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::ConditionBoostSpec;
            /// use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec;
            /// let x = ConditionBoostSpec::new().set_or_clear_boost_control_spec(Some(BoostControlSpec::default()/* use setters */));
            /// let x = ConditionBoostSpec::new().set_or_clear_boost_control_spec(None::<BoostControlSpec>);
            /// ```
            pub fn set_or_clear_boost_control_spec<T>(mut self, v: std::option::Option<T>) -> Self
            where T: std::convert::Into<crate::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec>
            {
                self.boost_control_spec = v.map(|x| x.into());
                self
            }
        }

        impl wkt::message::Message for ConditionBoostSpec {
            fn typename() -> &'static str {
                "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.BoostSpec.ConditionBoostSpec"
            }
        }

        /// Defines additional types related to [ConditionBoostSpec].
        pub mod condition_boost_spec {
            #[allow(unused_imports)]
            use super::*;

            /// Specification for custom ranking based on customer specified attribute
            /// value. It provides more controls for customized ranking than the simple
            /// (condition, boost) combination above.
            #[derive(Clone, Default, PartialEq)]
            #[non_exhaustive]
            pub struct BoostControlSpec {

                /// Optional. The name of the field whose value will be used to determine
                /// the boost amount.
                pub field_name: std::string::String,

                /// Optional. The attribute type to be used to determine the boost
                /// amount. The attribute value can be derived from the field value of
                /// the specified field_name. In the case of numerical it is
                /// straightforward i.e. attribute_value = numerical_field_value. In the
                /// case of freshness however, attribute_value = (time.now() -
                /// datetime_field_value).
                pub attribute_type: crate::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::AttributeType,

                /// Optional. The interpolation type to be applied to connect the control
                /// points listed below.
                pub interpolation_type: crate::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::InterpolationType,

                /// Optional. The control points used to define the curve. The monotonic
                /// function (defined through the interpolation_type above) passes
                /// through the control points listed here.
                pub control_points: std::vec::Vec<crate::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::ControlPoint>,

                pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
            }

            impl BoostControlSpec {
                /// Creates a new default instance.
                pub fn new() -> Self {
                    std::default::Default::default()
                }

                /// Sets the value of [field_name][crate::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec::field_name].
                ///
                /// # Example
                /// ```ignore,no_run
                /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec;
                /// let x = BoostControlSpec::new().set_field_name("example");
                /// ```
                pub fn set_field_name<T: std::convert::Into<std::string::String>>(
                    mut self,
                    v: T,
                ) -> Self {
                    self.field_name = v.into();
                    self
                }

                /// Sets the value of [attribute_type][crate::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec::attribute_type].
                ///
                /// # Example
                /// ```ignore,no_run
                /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec;
                /// use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::AttributeType;
                /// let x0 = BoostControlSpec::new().set_attribute_type(AttributeType::Numerical);
                /// let x1 = BoostControlSpec::new().set_attribute_type(AttributeType::Freshness);
                /// ```
                pub fn set_attribute_type<T: std::convert::Into<crate::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::AttributeType>>(mut self, v: T) -> Self{
                    self.attribute_type = v.into();
                    self
                }

                /// Sets the value of [interpolation_type][crate::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec::interpolation_type].
                ///
                /// # Example
                /// ```ignore,no_run
                /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec;
                /// use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::InterpolationType;
                /// let x0 = BoostControlSpec::new().set_interpolation_type(InterpolationType::Linear);
                /// ```
                pub fn set_interpolation_type<T: std::convert::Into<crate::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::InterpolationType>>(mut self, v: T) -> Self{
                    self.interpolation_type = v.into();
                    self
                }

                /// Sets the value of [control_points][crate::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec::control_points].
                ///
                /// # Example
                /// ```ignore,no_run
                /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::BoostControlSpec;
                /// use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::ControlPoint;
                /// let x = BoostControlSpec::new()
                ///     .set_control_points([
                ///         ControlPoint::default()/* use setters */,
                ///         ControlPoint::default()/* use (different) setters */,
                ///     ]);
                /// ```
                pub fn set_control_points<T, V>(mut self, v: T) -> Self
                where
                    T: std::iter::IntoIterator<Item = V>,
                    V: std::convert::Into<crate::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::ControlPoint>
                {
                    use std::iter::Iterator;
                    self.control_points = v.into_iter().map(|i| i.into()).collect();
                    self
                }
            }

            impl wkt::message::Message for BoostControlSpec {
                fn typename() -> &'static str {
                    "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.BoostSpec.ConditionBoostSpec.BoostControlSpec"
                }
            }

            /// Defines additional types related to [BoostControlSpec].
            pub mod boost_control_spec {
                #[allow(unused_imports)]
                use super::*;

                /// The control points used to define the curve. The curve defined
                /// through these control points can only be monotonically increasing
                /// or decreasing(constant values are acceptable).
                #[derive(Clone, Default, PartialEq)]
                #[non_exhaustive]
                pub struct ControlPoint {
                    /// Optional. Can be one of:
                    ///
                    /// 1. The numerical field value.
                    /// 1. The duration spec for freshness:
                    ///    The value must be formatted as an XSD `dayTimeDuration` value (a
                    ///    restricted subset of an ISO 8601 duration value). The pattern for
                    ///    this is: `[nD][T[nH][nM][nS]]`.
                    pub attribute_value: std::string::String,

                    /// Optional. The value between -1 to 1 by which to boost the score if
                    /// the attribute_value evaluates to the value specified above.
                    pub boost_amount: f32,

                    pub(crate) _unknown_fields:
                        serde_json::Map<std::string::String, serde_json::Value>,
                }

                impl ControlPoint {
                    /// Creates a new default instance.
                    pub fn new() -> Self {
                        std::default::Default::default()
                    }

                    /// Sets the value of [attribute_value][crate::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::ControlPoint::attribute_value].
                    ///
                    /// # Example
                    /// ```ignore,no_run
                    /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::ControlPoint;
                    /// let x = ControlPoint::new().set_attribute_value("example");
                    /// ```
                    pub fn set_attribute_value<T: std::convert::Into<std::string::String>>(
                        mut self,
                        v: T,
                    ) -> Self {
                        self.attribute_value = v.into();
                        self
                    }

                    /// Sets the value of [boost_amount][crate::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::ControlPoint::boost_amount].
                    ///
                    /// # Example
                    /// ```ignore,no_run
                    /// # use google_cloud_ces_v1::model::data_store_tool::boost_spec::condition_boost_spec::boost_control_spec::ControlPoint;
                    /// let x = ControlPoint::new().set_boost_amount(42.0);
                    /// ```
                    pub fn set_boost_amount<T: std::convert::Into<f32>>(mut self, v: T) -> Self {
                        self.boost_amount = v.into();
                        self
                    }
                }

                impl wkt::message::Message for ControlPoint {
                    fn typename() -> &'static str {
                        "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.BoostSpec.ConditionBoostSpec.BoostControlSpec.ControlPoint"
                    }
                }

                /// The attribute(or function) for which the custom ranking is to be
                /// applied.
                ///
                /// # Working with unknown values
                ///
                /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
                /// additional enum variants at any time. Adding new variants is not considered
                /// a breaking change. Applications should write their code in anticipation of:
                ///
                /// - New values appearing in future releases of the client library, **and**
                /// - New values received dynamically, without application changes.
                ///
                /// Please consult the [Working with enums] section in the user guide for some
                /// guidelines.
                ///
                /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
                #[derive(Clone, Debug, PartialEq)]
                #[non_exhaustive]
                pub enum AttributeType {
                    /// Unspecified AttributeType.
                    Unspecified,
                    /// The value of the numerical field will be used to dynamically update
                    /// the boost amount. In this case, the attribute_value (the x value)
                    /// of the control point will be the actual value of the numerical
                    /// field for which the boost_amount is specified.
                    Numerical,
                    /// For the freshness use case the attribute value will be the duration
                    /// between the current time and the date in the datetime field
                    /// specified. The value must be formatted as an XSD `dayTimeDuration`
                    /// value (a restricted subset of an ISO 8601 duration value). The
                    /// pattern for this is: `[nD][T[nH][nM][nS]]`.
                    /// E.g. `5D`, `3DT12H30M`, `T24H`.
                    Freshness,
                    /// If set, the enum was initialized with an unknown value.
                    ///
                    /// Applications can examine the value using [AttributeType::value] or
                    /// [AttributeType::name].
                    UnknownValue(attribute_type::UnknownValue),
                }

                #[doc(hidden)]
                pub mod attribute_type {
                    #[allow(unused_imports)]
                    use super::*;
                    #[derive(Clone, Debug, PartialEq)]
                    pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
                }

                impl AttributeType {
                    /// Gets the enum value.
                    ///
                    /// Returns `None` if the enum contains an unknown value deserialized from
                    /// the string representation of enums.
                    pub fn value(&self) -> std::option::Option<i32> {
                        match self {
                            Self::Unspecified => std::option::Option::Some(0),
                            Self::Numerical => std::option::Option::Some(1),
                            Self::Freshness => std::option::Option::Some(2),
                            Self::UnknownValue(u) => u.0.value(),
                        }
                    }

                    /// Gets the enum value as a string.
                    ///
                    /// Returns `None` if the enum contains an unknown value deserialized from
                    /// the integer representation of enums.
                    pub fn name(&self) -> std::option::Option<&str> {
                        match self {
                            Self::Unspecified => {
                                std::option::Option::Some("ATTRIBUTE_TYPE_UNSPECIFIED")
                            }
                            Self::Numerical => std::option::Option::Some("NUMERICAL"),
                            Self::Freshness => std::option::Option::Some("FRESHNESS"),
                            Self::UnknownValue(u) => u.0.name(),
                        }
                    }
                }

                impl std::default::Default for AttributeType {
                    fn default() -> Self {
                        use std::convert::From;
                        Self::from(0)
                    }
                }

                impl std::fmt::Display for AttributeType {
                    fn fmt(
                        &self,
                        f: &mut std::fmt::Formatter<'_>,
                    ) -> std::result::Result<(), std::fmt::Error> {
                        wkt::internal::display_enum(f, self.name(), self.value())
                    }
                }

                impl std::convert::From<i32> for AttributeType {
                    fn from(value: i32) -> Self {
                        match value {
                            0 => Self::Unspecified,
                            1 => Self::Numerical,
                            2 => Self::Freshness,
                            _ => Self::UnknownValue(attribute_type::UnknownValue(
                                wkt::internal::UnknownEnumValue::Integer(value),
                            )),
                        }
                    }
                }

                impl std::convert::From<&str> for AttributeType {
                    fn from(value: &str) -> Self {
                        use std::string::ToString;
                        match value {
                            "ATTRIBUTE_TYPE_UNSPECIFIED" => Self::Unspecified,
                            "NUMERICAL" => Self::Numerical,
                            "FRESHNESS" => Self::Freshness,
                            _ => Self::UnknownValue(attribute_type::UnknownValue(
                                wkt::internal::UnknownEnumValue::String(value.to_string()),
                            )),
                        }
                    }
                }

                impl serde::ser::Serialize for AttributeType {
                    fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
                    where
                        S: serde::Serializer,
                    {
                        match self {
                            Self::Unspecified => serializer.serialize_i32(0),
                            Self::Numerical => serializer.serialize_i32(1),
                            Self::Freshness => serializer.serialize_i32(2),
                            Self::UnknownValue(u) => u.0.serialize(serializer),
                        }
                    }
                }

                impl<'de> serde::de::Deserialize<'de> for AttributeType {
                    fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
                    where
                        D: serde::Deserializer<'de>,
                    {
                        deserializer.deserialize_any(wkt::internal::EnumVisitor::<AttributeType>::new(
                            ".google.cloud.ces.v1.DataStoreTool.BoostSpec.ConditionBoostSpec.BoostControlSpec.AttributeType"))
                    }
                }

                /// The interpolation type to be applied. Default will be linear
                /// (Piecewise Linear).
                ///
                /// # Working with unknown values
                ///
                /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
                /// additional enum variants at any time. Adding new variants is not considered
                /// a breaking change. Applications should write their code in anticipation of:
                ///
                /// - New values appearing in future releases of the client library, **and**
                /// - New values received dynamically, without application changes.
                ///
                /// Please consult the [Working with enums] section in the user guide for some
                /// guidelines.
                ///
                /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
                #[derive(Clone, Debug, PartialEq)]
                #[non_exhaustive]
                pub enum InterpolationType {
                    /// Interpolation type is unspecified. In this case, it defaults to
                    /// Linear.
                    Unspecified,
                    /// Piecewise linear interpolation will be applied.
                    Linear,
                    /// If set, the enum was initialized with an unknown value.
                    ///
                    /// Applications can examine the value using [InterpolationType::value] or
                    /// [InterpolationType::name].
                    UnknownValue(interpolation_type::UnknownValue),
                }

                #[doc(hidden)]
                pub mod interpolation_type {
                    #[allow(unused_imports)]
                    use super::*;
                    #[derive(Clone, Debug, PartialEq)]
                    pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
                }

                impl InterpolationType {
                    /// Gets the enum value.
                    ///
                    /// Returns `None` if the enum contains an unknown value deserialized from
                    /// the string representation of enums.
                    pub fn value(&self) -> std::option::Option<i32> {
                        match self {
                            Self::Unspecified => std::option::Option::Some(0),
                            Self::Linear => std::option::Option::Some(1),
                            Self::UnknownValue(u) => u.0.value(),
                        }
                    }

                    /// Gets the enum value as a string.
                    ///
                    /// Returns `None` if the enum contains an unknown value deserialized from
                    /// the integer representation of enums.
                    pub fn name(&self) -> std::option::Option<&str> {
                        match self {
                            Self::Unspecified => {
                                std::option::Option::Some("INTERPOLATION_TYPE_UNSPECIFIED")
                            }
                            Self::Linear => std::option::Option::Some("LINEAR"),
                            Self::UnknownValue(u) => u.0.name(),
                        }
                    }
                }

                impl std::default::Default for InterpolationType {
                    fn default() -> Self {
                        use std::convert::From;
                        Self::from(0)
                    }
                }

                impl std::fmt::Display for InterpolationType {
                    fn fmt(
                        &self,
                        f: &mut std::fmt::Formatter<'_>,
                    ) -> std::result::Result<(), std::fmt::Error> {
                        wkt::internal::display_enum(f, self.name(), self.value())
                    }
                }

                impl std::convert::From<i32> for InterpolationType {
                    fn from(value: i32) -> Self {
                        match value {
                            0 => Self::Unspecified,
                            1 => Self::Linear,
                            _ => Self::UnknownValue(interpolation_type::UnknownValue(
                                wkt::internal::UnknownEnumValue::Integer(value),
                            )),
                        }
                    }
                }

                impl std::convert::From<&str> for InterpolationType {
                    fn from(value: &str) -> Self {
                        use std::string::ToString;
                        match value {
                            "INTERPOLATION_TYPE_UNSPECIFIED" => Self::Unspecified,
                            "LINEAR" => Self::Linear,
                            _ => Self::UnknownValue(interpolation_type::UnknownValue(
                                wkt::internal::UnknownEnumValue::String(value.to_string()),
                            )),
                        }
                    }
                }

                impl serde::ser::Serialize for InterpolationType {
                    fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
                    where
                        S: serde::Serializer,
                    {
                        match self {
                            Self::Unspecified => serializer.serialize_i32(0),
                            Self::Linear => serializer.serialize_i32(1),
                            Self::UnknownValue(u) => u.0.serialize(serializer),
                        }
                    }
                }

                impl<'de> serde::de::Deserialize<'de> for InterpolationType {
                    fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
                    where
                        D: serde::Deserializer<'de>,
                    {
                        deserializer.deserialize_any(wkt::internal::EnumVisitor::<InterpolationType>::new(
                            ".google.cloud.ces.v1.DataStoreTool.BoostSpec.ConditionBoostSpec.BoostControlSpec.InterpolationType"))
                    }
                }
            }
        }
    }

    /// If specified, will apply the given configuration for the specified
    /// modality.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct ModalityConfig {
        /// Required. The modality type.
        pub modality_type: crate::model::data_store_tool::modality_config::ModalityType,

        /// Optional. The rewriter config.
        pub rewriter_config: std::option::Option<crate::model::data_store_tool::RewriterConfig>,

        /// Optional. The summarization config.
        pub summarization_config:
            std::option::Option<crate::model::data_store_tool::SummarizationConfig>,

        /// Optional. The grounding configuration.
        pub grounding_config: std::option::Option<crate::model::data_store_tool::GroundingConfig>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl ModalityConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [modality_type][crate::model::data_store_tool::ModalityConfig::modality_type].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::ModalityConfig;
        /// use google_cloud_ces_v1::model::data_store_tool::modality_config::ModalityType;
        /// let x0 = ModalityConfig::new().set_modality_type(ModalityType::Text);
        /// let x1 = ModalityConfig::new().set_modality_type(ModalityType::Audio);
        /// ```
        pub fn set_modality_type<
            T: std::convert::Into<crate::model::data_store_tool::modality_config::ModalityType>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.modality_type = v.into();
            self
        }

        /// Sets the value of [rewriter_config][crate::model::data_store_tool::ModalityConfig::rewriter_config].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::ModalityConfig;
        /// use google_cloud_ces_v1::model::data_store_tool::RewriterConfig;
        /// let x = ModalityConfig::new().set_rewriter_config(RewriterConfig::default()/* use setters */);
        /// ```
        pub fn set_rewriter_config<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::data_store_tool::RewriterConfig>,
        {
            self.rewriter_config = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [rewriter_config][crate::model::data_store_tool::ModalityConfig::rewriter_config].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::ModalityConfig;
        /// use google_cloud_ces_v1::model::data_store_tool::RewriterConfig;
        /// let x = ModalityConfig::new().set_or_clear_rewriter_config(Some(RewriterConfig::default()/* use setters */));
        /// let x = ModalityConfig::new().set_or_clear_rewriter_config(None::<RewriterConfig>);
        /// ```
        pub fn set_or_clear_rewriter_config<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::data_store_tool::RewriterConfig>,
        {
            self.rewriter_config = v.map(|x| x.into());
            self
        }

        /// Sets the value of [summarization_config][crate::model::data_store_tool::ModalityConfig::summarization_config].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::ModalityConfig;
        /// use google_cloud_ces_v1::model::data_store_tool::SummarizationConfig;
        /// let x = ModalityConfig::new().set_summarization_config(SummarizationConfig::default()/* use setters */);
        /// ```
        pub fn set_summarization_config<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::data_store_tool::SummarizationConfig>,
        {
            self.summarization_config = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [summarization_config][crate::model::data_store_tool::ModalityConfig::summarization_config].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::ModalityConfig;
        /// use google_cloud_ces_v1::model::data_store_tool::SummarizationConfig;
        /// let x = ModalityConfig::new().set_or_clear_summarization_config(Some(SummarizationConfig::default()/* use setters */));
        /// let x = ModalityConfig::new().set_or_clear_summarization_config(None::<SummarizationConfig>);
        /// ```
        pub fn set_or_clear_summarization_config<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::data_store_tool::SummarizationConfig>,
        {
            self.summarization_config = v.map(|x| x.into());
            self
        }

        /// Sets the value of [grounding_config][crate::model::data_store_tool::ModalityConfig::grounding_config].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::ModalityConfig;
        /// use google_cloud_ces_v1::model::data_store_tool::GroundingConfig;
        /// let x = ModalityConfig::new().set_grounding_config(GroundingConfig::default()/* use setters */);
        /// ```
        pub fn set_grounding_config<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::data_store_tool::GroundingConfig>,
        {
            self.grounding_config = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [grounding_config][crate::model::data_store_tool::ModalityConfig::grounding_config].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::data_store_tool::ModalityConfig;
        /// use google_cloud_ces_v1::model::data_store_tool::GroundingConfig;
        /// let x = ModalityConfig::new().set_or_clear_grounding_config(Some(GroundingConfig::default()/* use setters */));
        /// let x = ModalityConfig::new().set_or_clear_grounding_config(None::<GroundingConfig>);
        /// ```
        pub fn set_or_clear_grounding_config<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::data_store_tool::GroundingConfig>,
        {
            self.grounding_config = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for ModalityConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.DataStoreTool.ModalityConfig"
        }
    }

    /// Defines additional types related to [ModalityConfig].
    pub mod modality_config {
        #[allow(unused_imports)]
        use super::*;

        /// The modality type.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum ModalityType {
            /// Unspecified modality type.
            Unspecified,
            /// Text modality.
            Text,
            /// Audio modality.
            Audio,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [ModalityType::value] or
            /// [ModalityType::name].
            UnknownValue(modality_type::UnknownValue),
        }

        #[doc(hidden)]
        pub mod modality_type {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl ModalityType {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::Text => std::option::Option::Some(1),
                    Self::Audio => std::option::Option::Some(2),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("MODALITY_TYPE_UNSPECIFIED"),
                    Self::Text => std::option::Option::Some("TEXT"),
                    Self::Audio => std::option::Option::Some("AUDIO"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for ModalityType {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for ModalityType {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for ModalityType {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::Text,
                    2 => Self::Audio,
                    _ => Self::UnknownValue(modality_type::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for ModalityType {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "MODALITY_TYPE_UNSPECIFIED" => Self::Unspecified,
                    "TEXT" => Self::Text,
                    "AUDIO" => Self::Audio,
                    _ => Self::UnknownValue(modality_type::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for ModalityType {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::Text => serializer.serialize_i32(1),
                    Self::Audio => serializer.serialize_i32(2),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for ModalityType {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<ModalityType>::new(
                    ".google.cloud.ces.v1.DataStoreTool.ModalityConfig.ModalityType",
                ))
            }
        }
    }

    /// Filter parameter behavior.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum FilterParameterBehavior {
        /// Default filter behavior.
        /// Include filter parameter for connector datastores.
        /// For the rest of the datastore types, the filter input parameter is
        /// omitted.
        Unspecified,
        /// Always include filter parameter for all datastore types.
        AlwaysInclude,
        /// The filter parameter is never included in the list of tool parameters,
        /// regardless of the datastore type.
        NeverInclude,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [FilterParameterBehavior::value] or
        /// [FilterParameterBehavior::name].
        UnknownValue(filter_parameter_behavior::UnknownValue),
    }

    #[doc(hidden)]
    pub mod filter_parameter_behavior {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl FilterParameterBehavior {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::AlwaysInclude => std::option::Option::Some(2),
                Self::NeverInclude => std::option::Option::Some(3),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => {
                    std::option::Option::Some("FILTER_PARAMETER_BEHAVIOR_UNSPECIFIED")
                }
                Self::AlwaysInclude => std::option::Option::Some("ALWAYS_INCLUDE"),
                Self::NeverInclude => std::option::Option::Some("NEVER_INCLUDE"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for FilterParameterBehavior {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for FilterParameterBehavior {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for FilterParameterBehavior {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                2 => Self::AlwaysInclude,
                3 => Self::NeverInclude,
                _ => Self::UnknownValue(filter_parameter_behavior::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for FilterParameterBehavior {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "FILTER_PARAMETER_BEHAVIOR_UNSPECIFIED" => Self::Unspecified,
                "ALWAYS_INCLUDE" => Self::AlwaysInclude,
                "NEVER_INCLUDE" => Self::NeverInclude,
                _ => Self::UnknownValue(filter_parameter_behavior::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for FilterParameterBehavior {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::AlwaysInclude => serializer.serialize_i32(2),
                Self::NeverInclude => serializer.serialize_i32(3),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for FilterParameterBehavior {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(
                wkt::internal::EnumVisitor::<FilterParameterBehavior>::new(
                    ".google.cloud.ces.v1.DataStoreTool.FilterParameterBehavior",
                ),
            )
        }
    }

    /// Defines the search source, either a single DataStore or an Engine.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum SearchSource {
        /// Optional. Search within a single specific DataStore.
        DataStoreSource(std::boxed::Box<crate::model::data_store_tool::DataStoreSource>),
        /// Optional. Search within an Engine (potentially across multiple
        /// DataStores).
        EngineSource(std::boxed::Box<crate::model::data_store_tool::EngineSource>),
    }
}

/// Experiment for the deployment.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ExperimentConfig {
    /// Optional. Version release for the experiment.
    pub version_release: std::option::Option<crate::model::experiment_config::VersionRelease>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ExperimentConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [version_release][crate::model::ExperimentConfig::version_release].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExperimentConfig;
    /// use google_cloud_ces_v1::model::experiment_config::VersionRelease;
    /// let x = ExperimentConfig::new().set_version_release(VersionRelease::default()/* use setters */);
    /// ```
    pub fn set_version_release<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::experiment_config::VersionRelease>,
    {
        self.version_release = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [version_release][crate::model::ExperimentConfig::version_release].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExperimentConfig;
    /// use google_cloud_ces_v1::model::experiment_config::VersionRelease;
    /// let x = ExperimentConfig::new().set_or_clear_version_release(Some(VersionRelease::default()/* use setters */));
    /// let x = ExperimentConfig::new().set_or_clear_version_release(None::<VersionRelease>);
    /// ```
    pub fn set_or_clear_version_release<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::experiment_config::VersionRelease>,
    {
        self.version_release = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for ExperimentConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ExperimentConfig"
    }
}

/// Defines additional types related to [ExperimentConfig].
pub mod experiment_config {
    #[allow(unused_imports)]
    use super::*;

    /// Version release for the experiment.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct VersionRelease {
        /// Optional. State of the version release.
        pub state: crate::model::experiment_config::State,

        /// Optional. Traffic allocations for the version release.
        pub traffic_allocations:
            std::vec::Vec<crate::model::experiment_config::version_release::TrafficAllocation>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl VersionRelease {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [state][crate::model::experiment_config::VersionRelease::state].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::experiment_config::VersionRelease;
        /// use google_cloud_ces_v1::model::experiment_config::State;
        /// let x0 = VersionRelease::new().set_state(State::Pending);
        /// let x1 = VersionRelease::new().set_state(State::Running);
        /// let x2 = VersionRelease::new().set_state(State::Done);
        /// ```
        pub fn set_state<T: std::convert::Into<crate::model::experiment_config::State>>(
            mut self,
            v: T,
        ) -> Self {
            self.state = v.into();
            self
        }

        /// Sets the value of [traffic_allocations][crate::model::experiment_config::VersionRelease::traffic_allocations].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::experiment_config::VersionRelease;
        /// use google_cloud_ces_v1::model::experiment_config::version_release::TrafficAllocation;
        /// let x = VersionRelease::new()
        ///     .set_traffic_allocations([
        ///         TrafficAllocation::default()/* use setters */,
        ///         TrafficAllocation::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_traffic_allocations<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<
                    crate::model::experiment_config::version_release::TrafficAllocation,
                >,
        {
            use std::iter::Iterator;
            self.traffic_allocations = v.into_iter().map(|i| i.into()).collect();
            self
        }
    }

    impl wkt::message::Message for VersionRelease {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.ExperimentConfig.VersionRelease"
        }
    }

    /// Defines additional types related to [VersionRelease].
    pub mod version_release {
        #[allow(unused_imports)]
        use super::*;

        /// Traffic allocation for the version release.
        #[derive(Clone, Default, PartialEq)]
        #[non_exhaustive]
        pub struct TrafficAllocation {
            /// Optional. Id of the traffic allocation.
            /// Free format string, up to 128 characters.
            pub id: std::string::String,

            /// Optional. Traffic percentage of the traffic allocation.
            /// Must be between 0 and 100.
            pub traffic_percentage: i32,

            /// Optional. App version of the traffic allocation.
            /// Format:
            /// `projects/{project}/locations/{location}/apps/{app}/versions/{version}`
            pub app_version: std::string::String,

            pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
        }

        impl TrafficAllocation {
            /// Creates a new default instance.
            pub fn new() -> Self {
                std::default::Default::default()
            }

            /// Sets the value of [id][crate::model::experiment_config::version_release::TrafficAllocation::id].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::experiment_config::version_release::TrafficAllocation;
            /// let x = TrafficAllocation::new().set_id("example");
            /// ```
            pub fn set_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
                self.id = v.into();
                self
            }

            /// Sets the value of [traffic_percentage][crate::model::experiment_config::version_release::TrafficAllocation::traffic_percentage].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::experiment_config::version_release::TrafficAllocation;
            /// let x = TrafficAllocation::new().set_traffic_percentage(42);
            /// ```
            pub fn set_traffic_percentage<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
                self.traffic_percentage = v.into();
                self
            }

            /// Sets the value of [app_version][crate::model::experiment_config::version_release::TrafficAllocation::app_version].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::experiment_config::version_release::TrafficAllocation;
            /// # let project_id = "project_id";
            /// # let location_id = "location_id";
            /// # let app_id = "app_id";
            /// # let version_id = "version_id";
            /// let x = TrafficAllocation::new().set_app_version(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/versions/{version_id}"));
            /// ```
            pub fn set_app_version<T: std::convert::Into<std::string::String>>(
                mut self,
                v: T,
            ) -> Self {
                self.app_version = v.into();
                self
            }
        }

        impl wkt::message::Message for TrafficAllocation {
            fn typename() -> &'static str {
                "type.googleapis.com/google.cloud.ces.v1.ExperimentConfig.VersionRelease.TrafficAllocation"
            }
        }
    }

    /// State of the experiment.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum State {
        /// Unspecified state.
        Unspecified,
        /// Deprecated: This state is no longer used.
        Pending,
        /// Running state. Experiment is running and valid.
        Running,
        /// Deprecated: This state is no longer used.
        Done,
        /// Deprecated: This state is no longer used.
        Expired,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [State::value] or
        /// [State::name].
        UnknownValue(state::UnknownValue),
    }

    #[doc(hidden)]
    pub mod state {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl State {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Pending => std::option::Option::Some(1),
                Self::Running => std::option::Option::Some(2),
                Self::Done => std::option::Option::Some(3),
                Self::Expired => std::option::Option::Some(4),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("STATE_UNSPECIFIED"),
                Self::Pending => std::option::Option::Some("PENDING"),
                Self::Running => std::option::Option::Some("RUNNING"),
                Self::Done => std::option::Option::Some("DONE"),
                Self::Expired => std::option::Option::Some("EXPIRED"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for State {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for State {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for State {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Pending,
                2 => Self::Running,
                3 => Self::Done,
                4 => Self::Expired,
                _ => Self::UnknownValue(state::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for State {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "STATE_UNSPECIFIED" => Self::Unspecified,
                "PENDING" => Self::Pending,
                "RUNNING" => Self::Running,
                "DONE" => Self::Done,
                "EXPIRED" => Self::Expired,
                _ => Self::UnknownValue(state::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for State {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Pending => serializer.serialize_i32(1),
                Self::Running => serializer.serialize_i32(2),
                Self::Done => serializer.serialize_i32(3),
                Self::Expired => serializer.serialize_i32(4),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for State {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<State>::new(
                ".google.cloud.ces.v1.ExperimentConfig.State",
            ))
        }
    }
}

/// A deployment represents an immutable, queryable version of the app.
/// It is used to deploy an app version with a specific channel profile.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Deployment {
    /// Identifier. The resource name of the deployment.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`
    pub name: std::string::String,

    /// Required. Display name of the deployment.
    pub display_name: std::string::String,

    /// Optional. The resource name of the app version to deploy.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/versions/{version}`
    /// Use `projects/{project}/locations/{location}/apps/{app}/versions/-` to use
    /// the draft app.
    pub app_version: std::string::String,

    /// Required. The channel profile used in the deployment.
    pub channel_profile: std::option::Option<crate::model::ChannelProfile>,

    /// Output only. Timestamp when this deployment was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Timestamp when this deployment was last updated.
    pub update_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Etag used to ensure the object hasn't changed during a
    /// read-modify-write operation. If the etag is empty, the update will
    /// overwrite any concurrent changes.
    pub etag: std::string::String,

    /// Optional. Experiment configuration for the deployment.
    pub experiment_config: std::option::Option<crate::model::ExperimentConfig>,

    /// Optional. Input only. Ephemeral WhatsApp credentials required when
    /// configuring a WhatsApp channel profile.
    pub whatsapp_credentials: std::option::Option<crate::model::WhatsAppCredentials>,

    /// Optional. Input only. Ephemeral Instagram credentials required when
    /// configuring a Instagram channel profile.
    pub instagram_credentials: std::option::Option<crate::model::InstagramCredentials>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Deployment {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Deployment::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let deployment_id = "deployment_id";
    /// let x = Deployment::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/deployments/{deployment_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::Deployment::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// let x = Deployment::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [app_version][crate::model::Deployment::app_version].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let version_id = "version_id";
    /// let x = Deployment::new().set_app_version(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/versions/{version_id}"));
    /// ```
    pub fn set_app_version<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.app_version = v.into();
        self
    }

    /// Sets the value of [channel_profile][crate::model::Deployment::channel_profile].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use google_cloud_ces_v1::model::ChannelProfile;
    /// let x = Deployment::new().set_channel_profile(ChannelProfile::default()/* use setters */);
    /// ```
    pub fn set_channel_profile<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ChannelProfile>,
    {
        self.channel_profile = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [channel_profile][crate::model::Deployment::channel_profile].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use google_cloud_ces_v1::model::ChannelProfile;
    /// let x = Deployment::new().set_or_clear_channel_profile(Some(ChannelProfile::default()/* use setters */));
    /// let x = Deployment::new().set_or_clear_channel_profile(None::<ChannelProfile>);
    /// ```
    pub fn set_or_clear_channel_profile<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ChannelProfile>,
    {
        self.channel_profile = v.map(|x| x.into());
        self
    }

    /// Sets the value of [create_time][crate::model::Deployment::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use wkt::Timestamp;
    /// let x = Deployment::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::Deployment::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use wkt::Timestamp;
    /// let x = Deployment::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = Deployment::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::Deployment::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use wkt::Timestamp;
    /// let x = Deployment::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::Deployment::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use wkt::Timestamp;
    /// let x = Deployment::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = Deployment::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [etag][crate::model::Deployment::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// let x = Deployment::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }

    /// Sets the value of [experiment_config][crate::model::Deployment::experiment_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use google_cloud_ces_v1::model::ExperimentConfig;
    /// let x = Deployment::new().set_experiment_config(ExperimentConfig::default()/* use setters */);
    /// ```
    pub fn set_experiment_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ExperimentConfig>,
    {
        self.experiment_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [experiment_config][crate::model::Deployment::experiment_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use google_cloud_ces_v1::model::ExperimentConfig;
    /// let x = Deployment::new().set_or_clear_experiment_config(Some(ExperimentConfig::default()/* use setters */));
    /// let x = Deployment::new().set_or_clear_experiment_config(None::<ExperimentConfig>);
    /// ```
    pub fn set_or_clear_experiment_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ExperimentConfig>,
    {
        self.experiment_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [whatsapp_credentials][crate::model::Deployment::whatsapp_credentials].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use google_cloud_ces_v1::model::WhatsAppCredentials;
    /// let x = Deployment::new().set_whatsapp_credentials(WhatsAppCredentials::default()/* use setters */);
    /// ```
    pub fn set_whatsapp_credentials<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::WhatsAppCredentials>,
    {
        self.whatsapp_credentials = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [whatsapp_credentials][crate::model::Deployment::whatsapp_credentials].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use google_cloud_ces_v1::model::WhatsAppCredentials;
    /// let x = Deployment::new().set_or_clear_whatsapp_credentials(Some(WhatsAppCredentials::default()/* use setters */));
    /// let x = Deployment::new().set_or_clear_whatsapp_credentials(None::<WhatsAppCredentials>);
    /// ```
    pub fn set_or_clear_whatsapp_credentials<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::WhatsAppCredentials>,
    {
        self.whatsapp_credentials = v.map(|x| x.into());
        self
    }

    /// Sets the value of [instagram_credentials][crate::model::Deployment::instagram_credentials].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use google_cloud_ces_v1::model::InstagramCredentials;
    /// let x = Deployment::new().set_instagram_credentials(InstagramCredentials::default()/* use setters */);
    /// ```
    pub fn set_instagram_credentials<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::InstagramCredentials>,
    {
        self.instagram_credentials = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [instagram_credentials][crate::model::Deployment::instagram_credentials].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Deployment;
    /// use google_cloud_ces_v1::model::InstagramCredentials;
    /// let x = Deployment::new().set_or_clear_instagram_credentials(Some(InstagramCredentials::default()/* use setters */));
    /// let x = Deployment::new().set_or_clear_instagram_credentials(None::<InstagramCredentials>);
    /// ```
    pub fn set_or_clear_instagram_credentials<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::InstagramCredentials>,
    {
        self.instagram_credentials = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for Deployment {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Deployment"
    }
}

/// Ephemeral Meta credentials for WhatsApp native integration.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct WhatsAppCredentials {
    /// Required. The Meta auth code provided by the embedded signup flow.
    pub auth_code: std::string::String,

    /// Required. The 6-digit PIN created by the user for two-step verification.
    pub pin: std::string::String,

    /// Required. The phone number to register with WhatsApp.
    pub phone_number: std::string::String,

    /// Required. The Business Account ID to use for the phone number.
    pub business_account_id: std::string::String,

    /// Required. The WhatsApp Business Account ID.
    pub waba_id: std::string::String,

    /// Required. The Conversation Profile ID to use for the deployment.
    pub conversation_profile_id: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl WhatsAppCredentials {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [auth_code][crate::model::WhatsAppCredentials::auth_code].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WhatsAppCredentials;
    /// let x = WhatsAppCredentials::new().set_auth_code("example");
    /// ```
    pub fn set_auth_code<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.auth_code = v.into();
        self
    }

    /// Sets the value of [pin][crate::model::WhatsAppCredentials::pin].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WhatsAppCredentials;
    /// let x = WhatsAppCredentials::new().set_pin("example");
    /// ```
    pub fn set_pin<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.pin = v.into();
        self
    }

    /// Sets the value of [phone_number][crate::model::WhatsAppCredentials::phone_number].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WhatsAppCredentials;
    /// let x = WhatsAppCredentials::new().set_phone_number("example");
    /// ```
    pub fn set_phone_number<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.phone_number = v.into();
        self
    }

    /// Sets the value of [business_account_id][crate::model::WhatsAppCredentials::business_account_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WhatsAppCredentials;
    /// let x = WhatsAppCredentials::new().set_business_account_id("example");
    /// ```
    pub fn set_business_account_id<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.business_account_id = v.into();
        self
    }

    /// Sets the value of [waba_id][crate::model::WhatsAppCredentials::waba_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WhatsAppCredentials;
    /// let x = WhatsAppCredentials::new().set_waba_id("example");
    /// ```
    pub fn set_waba_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.waba_id = v.into();
        self
    }

    /// Sets the value of [conversation_profile_id][crate::model::WhatsAppCredentials::conversation_profile_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WhatsAppCredentials;
    /// let x = WhatsAppCredentials::new().set_conversation_profile_id("example");
    /// ```
    pub fn set_conversation_profile_id<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.conversation_profile_id = v.into();
        self
    }
}

impl wkt::message::Message for WhatsAppCredentials {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.WhatsAppCredentials"
    }
}

/// Ephemeral Meta credentials for Instagram native integration.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct InstagramCredentials {
    /// Required. The Meta auth code provided by the embedded signup flow.
    pub auth_code: std::string::String,

    /// Required. The Conversation Profile ID to use for the deployment.
    pub conversation_profile_id: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl InstagramCredentials {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [auth_code][crate::model::InstagramCredentials::auth_code].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::InstagramCredentials;
    /// let x = InstagramCredentials::new().set_auth_code("example");
    /// ```
    pub fn set_auth_code<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.auth_code = v.into();
        self
    }

    /// Sets the value of [conversation_profile_id][crate::model::InstagramCredentials::conversation_profile_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::InstagramCredentials;
    /// let x = InstagramCredentials::new().set_conversation_profile_id("example");
    /// ```
    pub fn set_conversation_profile_id<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.conversation_profile_id = v.into();
        self
    }
}

impl wkt::message::Message for InstagramCredentials {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.InstagramCredentials"
    }
}

/// An example represents a sample conversation between the user and the
/// agent(s).
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Example {
    /// Identifier. The unique identifier of the example.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/examples/{example}`
    pub name: std::string::String,

    /// Required. Display name of the example.
    pub display_name: std::string::String,

    /// Optional. Human-readable description of the example.
    pub description: std::string::String,

    /// Optional. The agent that initially handles the conversation. If not
    /// specified, the example represents a conversation that is handled by the
    /// root agent. Format:
    /// `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
    pub entry_agent: std::string::String,

    /// Optional. The collection of messages that make up the conversation.
    pub messages: std::vec::Vec<crate::model::Message>,

    /// Output only. Timestamp when the example was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Timestamp when the example was last updated.
    pub update_time: std::option::Option<wkt::Timestamp>,

    /// Output only. The example may become invalid if referencing resources are
    /// deleted. Invalid examples will not be used as few-shot examples.
    pub invalid: bool,

    /// 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.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Example {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Example::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let example_id = "example_id";
    /// let x = Example::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/examples/{example_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::Example::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// let x = Example::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::Example::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// let x = Example::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [entry_agent][crate::model::Example::entry_agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = Example::new().set_entry_agent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_entry_agent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.entry_agent = v.into();
        self
    }

    /// Sets the value of [messages][crate::model::Example::messages].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// use google_cloud_ces_v1::model::Message;
    /// let x = Example::new()
    ///     .set_messages([
    ///         Message::default()/* use setters */,
    ///         Message::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_messages<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Message>,
    {
        use std::iter::Iterator;
        self.messages = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [create_time][crate::model::Example::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// use wkt::Timestamp;
    /// let x = Example::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::Example::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// use wkt::Timestamp;
    /// let x = Example::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = Example::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::Example::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// use wkt::Timestamp;
    /// let x = Example::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::Example::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// use wkt::Timestamp;
    /// let x = Example::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = Example::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [invalid][crate::model::Example::invalid].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// let x = Example::new().set_invalid(true);
    /// ```
    pub fn set_invalid<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.invalid = v.into();
        self
    }

    /// Sets the value of [etag][crate::model::Example::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Example;
    /// let x = Example::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for Example {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Example"
    }
}

/// A message within a conversation.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Message {
    /// Optional. The role within the conversation, e.g., user, agent.
    pub role: std::string::String,

    /// Optional. Content of the message as a series of chunks.
    pub chunks: std::vec::Vec<crate::model::Chunk>,

    /// Optional. Timestamp when the message was sent or received. Should not be
    /// used if the message is part of an [example][google.cloud.ces.v1.Example].
    ///
    /// [google.cloud.ces.v1.Example]: crate::model::Example
    pub event_time: std::option::Option<wkt::Timestamp>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Message {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [role][crate::model::Message::role].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Message;
    /// let x = Message::new().set_role("example");
    /// ```
    pub fn set_role<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.role = v.into();
        self
    }

    /// Sets the value of [chunks][crate::model::Message::chunks].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Message;
    /// use google_cloud_ces_v1::model::Chunk;
    /// let x = Message::new()
    ///     .set_chunks([
    ///         Chunk::default()/* use setters */,
    ///         Chunk::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_chunks<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Chunk>,
    {
        use std::iter::Iterator;
        self.chunks = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [event_time][crate::model::Message::event_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Message;
    /// use wkt::Timestamp;
    /// let x = Message::new().set_event_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_event_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.event_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [event_time][crate::model::Message::event_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Message;
    /// use wkt::Timestamp;
    /// let x = Message::new().set_or_clear_event_time(Some(Timestamp::default()/* use setters */));
    /// let x = Message::new().set_or_clear_event_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_event_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.event_time = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for Message {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Message"
    }
}

/// A chunk of content within a message.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Chunk {
    /// Chunk data.
    pub data: std::option::Option<crate::model::chunk::Data>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Chunk {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [data][crate::model::Chunk::data].
    ///
    /// Note that all the setters affecting `data` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// use google_cloud_ces_v1::model::chunk::Data;
    /// let x = Chunk::new().set_data(Some(Data::Text("example".to_string())));
    /// ```
    pub fn set_data<T: std::convert::Into<std::option::Option<crate::model::chunk::Data>>>(
        mut self,
        v: T,
    ) -> Self {
        self.data = v.into();
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `Text`, `None` if the field is not set or
    /// holds a different branch.
    pub fn text(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::Text(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `Text`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// let x = Chunk::new().set_text("example");
    /// assert!(x.text().is_some());
    /// assert!(x.transcript().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.payload().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.tool_call().is_none());
    /// assert!(x.tool_response().is_none());
    /// assert!(x.agent_transfer().is_none());
    /// assert!(x.updated_variables().is_none());
    /// assert!(x.default_variables().is_none());
    /// ```
    pub fn set_text<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.data = std::option::Option::Some(crate::model::chunk::Data::Text(v.into()));
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `Transcript`, `None` if the field is not set or
    /// holds a different branch.
    pub fn transcript(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::Transcript(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `Transcript`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// let x = Chunk::new().set_transcript("example");
    /// assert!(x.transcript().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.payload().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.tool_call().is_none());
    /// assert!(x.tool_response().is_none());
    /// assert!(x.agent_transfer().is_none());
    /// assert!(x.updated_variables().is_none());
    /// assert!(x.default_variables().is_none());
    /// ```
    pub fn set_transcript<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.data = std::option::Option::Some(crate::model::chunk::Data::Transcript(v.into()));
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `Blob`, `None` if the field is not set or
    /// holds a different branch.
    pub fn blob(&self) -> std::option::Option<&std::boxed::Box<crate::model::Blob>> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::Blob(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `Blob`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// use google_cloud_ces_v1::model::Blob;
    /// let x = Chunk::new().set_blob(Blob::default()/* use setters */);
    /// assert!(x.blob().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.transcript().is_none());
    /// assert!(x.payload().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.tool_call().is_none());
    /// assert!(x.tool_response().is_none());
    /// assert!(x.agent_transfer().is_none());
    /// assert!(x.updated_variables().is_none());
    /// assert!(x.default_variables().is_none());
    /// ```
    pub fn set_blob<T: std::convert::Into<std::boxed::Box<crate::model::Blob>>>(
        mut self,
        v: T,
    ) -> Self {
        self.data = std::option::Option::Some(crate::model::chunk::Data::Blob(v.into()));
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `Payload`, `None` if the field is not set or
    /// holds a different branch.
    pub fn payload(&self) -> std::option::Option<&std::boxed::Box<wkt::Struct>> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::Payload(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `Payload`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// use wkt::Struct;
    /// let x = Chunk::new().set_payload(Struct::default()/* use setters */);
    /// assert!(x.payload().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.transcript().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.tool_call().is_none());
    /// assert!(x.tool_response().is_none());
    /// assert!(x.agent_transfer().is_none());
    /// assert!(x.updated_variables().is_none());
    /// assert!(x.default_variables().is_none());
    /// ```
    pub fn set_payload<T: std::convert::Into<std::boxed::Box<wkt::Struct>>>(
        mut self,
        v: T,
    ) -> Self {
        self.data = std::option::Option::Some(crate::model::chunk::Data::Payload(v.into()));
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `Image`, `None` if the field is not set or
    /// holds a different branch.
    pub fn image(&self) -> std::option::Option<&std::boxed::Box<crate::model::Image>> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::Image(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `Image`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// use google_cloud_ces_v1::model::Image;
    /// let x = Chunk::new().set_image(Image::default()/* use setters */);
    /// assert!(x.image().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.transcript().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.payload().is_none());
    /// assert!(x.tool_call().is_none());
    /// assert!(x.tool_response().is_none());
    /// assert!(x.agent_transfer().is_none());
    /// assert!(x.updated_variables().is_none());
    /// assert!(x.default_variables().is_none());
    /// ```
    pub fn set_image<T: std::convert::Into<std::boxed::Box<crate::model::Image>>>(
        mut self,
        v: T,
    ) -> Self {
        self.data = std::option::Option::Some(crate::model::chunk::Data::Image(v.into()));
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `ToolCall`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool_call(&self) -> std::option::Option<&std::boxed::Box<crate::model::ToolCall>> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::ToolCall(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `ToolCall`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// use google_cloud_ces_v1::model::ToolCall;
    /// let x = Chunk::new().set_tool_call(ToolCall::default()/* use setters */);
    /// assert!(x.tool_call().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.transcript().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.payload().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.tool_response().is_none());
    /// assert!(x.agent_transfer().is_none());
    /// assert!(x.updated_variables().is_none());
    /// assert!(x.default_variables().is_none());
    /// ```
    pub fn set_tool_call<T: std::convert::Into<std::boxed::Box<crate::model::ToolCall>>>(
        mut self,
        v: T,
    ) -> Self {
        self.data = std::option::Option::Some(crate::model::chunk::Data::ToolCall(v.into()));
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `ToolResponse`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool_response(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::ToolResponse>> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::ToolResponse(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `ToolResponse`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// use google_cloud_ces_v1::model::ToolResponse;
    /// let x = Chunk::new().set_tool_response(ToolResponse::default()/* use setters */);
    /// assert!(x.tool_response().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.transcript().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.payload().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.tool_call().is_none());
    /// assert!(x.agent_transfer().is_none());
    /// assert!(x.updated_variables().is_none());
    /// assert!(x.default_variables().is_none());
    /// ```
    pub fn set_tool_response<T: std::convert::Into<std::boxed::Box<crate::model::ToolResponse>>>(
        mut self,
        v: T,
    ) -> Self {
        self.data = std::option::Option::Some(crate::model::chunk::Data::ToolResponse(v.into()));
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `AgentTransfer`, `None` if the field is not set or
    /// holds a different branch.
    pub fn agent_transfer(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::AgentTransfer>> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::AgentTransfer(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `AgentTransfer`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// use google_cloud_ces_v1::model::AgentTransfer;
    /// let x = Chunk::new().set_agent_transfer(AgentTransfer::default()/* use setters */);
    /// assert!(x.agent_transfer().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.transcript().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.payload().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.tool_call().is_none());
    /// assert!(x.tool_response().is_none());
    /// assert!(x.updated_variables().is_none());
    /// assert!(x.default_variables().is_none());
    /// ```
    pub fn set_agent_transfer<
        T: std::convert::Into<std::boxed::Box<crate::model::AgentTransfer>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.data = std::option::Option::Some(crate::model::chunk::Data::AgentTransfer(v.into()));
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `UpdatedVariables`, `None` if the field is not set or
    /// holds a different branch.
    pub fn updated_variables(&self) -> std::option::Option<&std::boxed::Box<wkt::Struct>> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::UpdatedVariables(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `UpdatedVariables`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// use wkt::Struct;
    /// let x = Chunk::new().set_updated_variables(Struct::default()/* use setters */);
    /// assert!(x.updated_variables().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.transcript().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.payload().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.tool_call().is_none());
    /// assert!(x.tool_response().is_none());
    /// assert!(x.agent_transfer().is_none());
    /// assert!(x.default_variables().is_none());
    /// ```
    pub fn set_updated_variables<T: std::convert::Into<std::boxed::Box<wkt::Struct>>>(
        mut self,
        v: T,
    ) -> Self {
        self.data =
            std::option::Option::Some(crate::model::chunk::Data::UpdatedVariables(v.into()));
        self
    }

    /// The value of [data][crate::model::Chunk::data]
    /// if it holds a `DefaultVariables`, `None` if the field is not set or
    /// holds a different branch.
    pub fn default_variables(&self) -> std::option::Option<&std::boxed::Box<wkt::Struct>> {
        #[allow(unreachable_patterns)]
        self.data.as_ref().and_then(|v| match v {
            crate::model::chunk::Data::DefaultVariables(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [data][crate::model::Chunk::data]
    /// to hold a `DefaultVariables`.
    ///
    /// Note that all the setters affecting `data` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Chunk;
    /// use wkt::Struct;
    /// let x = Chunk::new().set_default_variables(Struct::default()/* use setters */);
    /// assert!(x.default_variables().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.transcript().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.payload().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.tool_call().is_none());
    /// assert!(x.tool_response().is_none());
    /// assert!(x.agent_transfer().is_none());
    /// assert!(x.updated_variables().is_none());
    /// ```
    pub fn set_default_variables<T: std::convert::Into<std::boxed::Box<wkt::Struct>>>(
        mut self,
        v: T,
    ) -> Self {
        self.data =
            std::option::Option::Some(crate::model::chunk::Data::DefaultVariables(v.into()));
        self
    }
}

impl wkt::message::Message for Chunk {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Chunk"
    }
}

/// Defines additional types related to [Chunk].
pub mod chunk {
    #[allow(unused_imports)]
    use super::*;

    /// Chunk data.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum Data {
        /// Optional. Text data.
        Text(std::string::String),
        /// Optional. Transcript associated with the audio.
        Transcript(std::string::String),
        /// Optional. Blob data.
        Blob(std::boxed::Box<crate::model::Blob>),
        /// Optional. Custom payload data.
        Payload(std::boxed::Box<wkt::Struct>),
        /// Optional. Image data.
        Image(std::boxed::Box<crate::model::Image>),
        /// Optional. Tool execution request.
        ToolCall(std::boxed::Box<crate::model::ToolCall>),
        /// Optional. Tool execution response.
        ToolResponse(std::boxed::Box<crate::model::ToolResponse>),
        /// Optional. Agent transfer event.
        AgentTransfer(std::boxed::Box<crate::model::AgentTransfer>),
        /// A struct represents variables that were updated in the conversation,
        /// keyed by variable names.
        UpdatedVariables(std::boxed::Box<wkt::Struct>),
        /// A struct represents default variables at the start of the conversation,
        /// keyed by variable names.
        DefaultVariables(std::boxed::Box<wkt::Struct>),
    }
}

/// Represents a blob input or output in the conversation.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Blob {
    /// Required. The IANA standard MIME type of the source data.
    pub mime_type: std::string::String,

    /// Required. Raw bytes of the blob.
    pub data: ::bytes::Bytes,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Blob {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [mime_type][crate::model::Blob::mime_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Blob;
    /// let x = Blob::new().set_mime_type("example");
    /// ```
    pub fn set_mime_type<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.mime_type = v.into();
        self
    }

    /// Sets the value of [data][crate::model::Blob::data].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Blob;
    /// let x = Blob::new().set_data(bytes::Bytes::from_static(b"example"));
    /// ```
    pub fn set_data<T: std::convert::Into<::bytes::Bytes>>(mut self, v: T) -> Self {
        self.data = v.into();
        self
    }
}

impl wkt::message::Message for Blob {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Blob"
    }
}

/// Represents an image input or output in the conversation.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Image {
    /// Required. The IANA standard MIME type of the source data.
    /// Supported image types includes:
    ///
    /// * image/png
    /// * image/jpeg
    /// * image/webp
    pub mime_type: std::string::String,

    /// Required. Raw bytes of the image.
    pub data: ::bytes::Bytes,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Image {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [mime_type][crate::model::Image::mime_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Image;
    /// let x = Image::new().set_mime_type("example");
    /// ```
    pub fn set_mime_type<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.mime_type = v.into();
        self
    }

    /// Sets the value of [data][crate::model::Image::data].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Image;
    /// let x = Image::new().set_data(bytes::Bytes::from_static(b"example"));
    /// ```
    pub fn set_data<T: std::convert::Into<::bytes::Bytes>>(mut self, v: T) -> Self {
        self.data = v.into();
        self
    }
}

impl wkt::message::Message for Image {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Image"
    }
}

/// Request for the client or the agent to execute the specified tool.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ToolCall {
    /// Optional. The unique identifier of the tool call. If populated, the client
    /// should return the execution result with the matching ID in
    /// [ToolResponse][google.cloud.ces.v1.ToolResponse.id].
    ///
    /// [google.cloud.ces.v1.ToolResponse.id]: crate::model::ToolResponse::id
    pub id: std::string::String,

    /// Output only. Display name of the tool.
    pub display_name: std::string::String,

    /// Optional. The input parameters and values for the tool in JSON object
    /// format.
    pub args: std::option::Option<wkt::Struct>,

    /// The identifier of the tool to execute. It could be either a persisted tool
    /// or a tool from a toolset.
    pub tool_identifier: std::option::Option<crate::model::tool_call::ToolIdentifier>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ToolCall {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [id][crate::model::ToolCall::id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolCall;
    /// let x = ToolCall::new().set_id("example");
    /// ```
    pub fn set_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.id = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::ToolCall::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolCall;
    /// let x = ToolCall::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [args][crate::model::ToolCall::args].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolCall;
    /// use wkt::Struct;
    /// let x = ToolCall::new().set_args(Struct::default()/* use setters */);
    /// ```
    pub fn set_args<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.args = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [args][crate::model::ToolCall::args].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolCall;
    /// use wkt::Struct;
    /// let x = ToolCall::new().set_or_clear_args(Some(Struct::default()/* use setters */));
    /// let x = ToolCall::new().set_or_clear_args(None::<Struct>);
    /// ```
    pub fn set_or_clear_args<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.args = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tool_identifier][crate::model::ToolCall::tool_identifier].
    ///
    /// Note that all the setters affecting `tool_identifier` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolCall;
    /// use google_cloud_ces_v1::model::tool_call::ToolIdentifier;
    /// let x = ToolCall::new().set_tool_identifier(Some(ToolIdentifier::Tool("example".to_string())));
    /// ```
    pub fn set_tool_identifier<
        T: std::convert::Into<std::option::Option<crate::model::tool_call::ToolIdentifier>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = v.into();
        self
    }

    /// The value of [tool_identifier][crate::model::ToolCall::tool_identifier]
    /// if it holds a `Tool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::tool_call::ToolIdentifier::Tool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::ToolCall::tool_identifier]
    /// to hold a `Tool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolCall;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = ToolCall::new().set_tool(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// assert!(x.tool().is_some());
    /// assert!(x.toolset_tool().is_none());
    /// ```
    pub fn set_tool<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool_identifier =
            std::option::Option::Some(crate::model::tool_call::ToolIdentifier::Tool(v.into()));
        self
    }

    /// The value of [tool_identifier][crate::model::ToolCall::tool_identifier]
    /// if it holds a `ToolsetTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn toolset_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::ToolsetTool>> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::tool_call::ToolIdentifier::ToolsetTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::ToolCall::tool_identifier]
    /// to hold a `ToolsetTool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolCall;
    /// use google_cloud_ces_v1::model::ToolsetTool;
    /// let x = ToolCall::new().set_toolset_tool(ToolsetTool::default()/* use setters */);
    /// assert!(x.toolset_tool().is_some());
    /// assert!(x.tool().is_none());
    /// ```
    pub fn set_toolset_tool<T: std::convert::Into<std::boxed::Box<crate::model::ToolsetTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::tool_call::ToolIdentifier::ToolsetTool(v.into()),
        );
        self
    }
}

impl wkt::message::Message for ToolCall {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ToolCall"
    }
}

/// Defines additional types related to [ToolCall].
pub mod tool_call {
    #[allow(unused_imports)]
    use super::*;

    /// The identifier of the tool to execute. It could be either a persisted tool
    /// or a tool from a toolset.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolIdentifier {
        /// Optional. The name of the tool to execute.
        /// Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
        Tool(std::string::String),
        /// Optional. The toolset tool to execute.
        ToolsetTool(std::boxed::Box<crate::model::ToolsetTool>),
    }
}

/// The execution result of a specific tool from the client or the agent.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ToolResponse {
    /// Optional. The matching ID of the [tool call][google.cloud.ces.v1.ToolCall]
    /// the response is for.
    ///
    /// [google.cloud.ces.v1.ToolCall]: crate::model::ToolCall
    pub id: std::string::String,

    /// Output only. Display name of the tool.
    pub display_name: std::string::String,

    /// Required. The tool execution result in JSON object format.
    /// Use "output" key to specify tool response and "error" key to specify
    /// error details (if any). If "output" and "error" keys are not specified,
    /// then whole "response" is treated as tool execution result.
    pub response: std::option::Option<wkt::Struct>,

    /// The identifier of the tool that got executed. It could be either a
    /// persisted tool or a tool from a toolset.
    pub tool_identifier: std::option::Option<crate::model::tool_response::ToolIdentifier>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ToolResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [id][crate::model::ToolResponse::id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolResponse;
    /// let x = ToolResponse::new().set_id("example");
    /// ```
    pub fn set_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.id = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::ToolResponse::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolResponse;
    /// let x = ToolResponse::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [response][crate::model::ToolResponse::response].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolResponse;
    /// use wkt::Struct;
    /// let x = ToolResponse::new().set_response(Struct::default()/* use setters */);
    /// ```
    pub fn set_response<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.response = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [response][crate::model::ToolResponse::response].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolResponse;
    /// use wkt::Struct;
    /// let x = ToolResponse::new().set_or_clear_response(Some(Struct::default()/* use setters */));
    /// let x = ToolResponse::new().set_or_clear_response(None::<Struct>);
    /// ```
    pub fn set_or_clear_response<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.response = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tool_identifier][crate::model::ToolResponse::tool_identifier].
    ///
    /// Note that all the setters affecting `tool_identifier` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolResponse;
    /// use google_cloud_ces_v1::model::tool_response::ToolIdentifier;
    /// let x = ToolResponse::new().set_tool_identifier(Some(ToolIdentifier::Tool("example".to_string())));
    /// ```
    pub fn set_tool_identifier<
        T: std::convert::Into<std::option::Option<crate::model::tool_response::ToolIdentifier>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = v.into();
        self
    }

    /// The value of [tool_identifier][crate::model::ToolResponse::tool_identifier]
    /// if it holds a `Tool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::tool_response::ToolIdentifier::Tool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::ToolResponse::tool_identifier]
    /// to hold a `Tool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolResponse;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = ToolResponse::new().set_tool(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// assert!(x.tool().is_some());
    /// assert!(x.toolset_tool().is_none());
    /// ```
    pub fn set_tool<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool_identifier =
            std::option::Option::Some(crate::model::tool_response::ToolIdentifier::Tool(v.into()));
        self
    }

    /// The value of [tool_identifier][crate::model::ToolResponse::tool_identifier]
    /// if it holds a `ToolsetTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn toolset_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::ToolsetTool>> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::tool_response::ToolIdentifier::ToolsetTool(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::ToolResponse::tool_identifier]
    /// to hold a `ToolsetTool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolResponse;
    /// use google_cloud_ces_v1::model::ToolsetTool;
    /// let x = ToolResponse::new().set_toolset_tool(ToolsetTool::default()/* use setters */);
    /// assert!(x.toolset_tool().is_some());
    /// assert!(x.tool().is_none());
    /// ```
    pub fn set_toolset_tool<T: std::convert::Into<std::boxed::Box<crate::model::ToolsetTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::tool_response::ToolIdentifier::ToolsetTool(v.into()),
        );
        self
    }
}

impl wkt::message::Message for ToolResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ToolResponse"
    }
}

/// Defines additional types related to [ToolResponse].
pub mod tool_response {
    #[allow(unused_imports)]
    use super::*;

    /// The identifier of the tool that got executed. It could be either a
    /// persisted tool or a tool from a toolset.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolIdentifier {
        /// Optional. The name of the tool to execute.
        /// Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
        Tool(std::string::String),
        /// Optional. The toolset tool that got executed.
        ToolsetTool(std::boxed::Box<crate::model::ToolsetTool>),
    }
}

/// Represents an event indicating the transfer of a conversation to a different
/// agent.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AgentTransfer {
    /// Required. The agent to which the conversation is being transferred. The
    /// agent will handle the conversation from this point forward. Format:
    /// `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
    pub target_agent: std::string::String,

    /// Output only. Display name of the agent.
    pub display_name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AgentTransfer {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [target_agent][crate::model::AgentTransfer::target_agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentTransfer;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = AgentTransfer::new().set_target_agent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_target_agent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.target_agent = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::AgentTransfer::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::AgentTransfer;
    /// let x = AgentTransfer::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }
}

impl wkt::message::Message for AgentTransfer {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.AgentTransfer"
    }
}

/// A code block to be executed instead of a real tool call.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CodeBlock {
    /// Required. Python code which will be invoked in tool fake mode.
    /// Expected Python function signature -
    /// To catch all tool calls:
    /// def fake_tool_call(tool: Tool, input: dict[str, Any],
    /// callback_context: CallbackContext) -> Optional[dict[str, Any]]:
    /// To catch a specific tool call:
    /// def fake_{tool_id}(tool: Tool, input: dict[str, Any],
    /// callback_context: CallbackContext) -> Optional[dict[str, Any]]:
    /// If the function returns None, the real tool will be invoked instead.
    pub python_code: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CodeBlock {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [python_code][crate::model::CodeBlock::python_code].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::CodeBlock;
    /// let x = CodeBlock::new().set_python_code("example");
    /// ```
    pub fn set_python_code<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.python_code = v.into();
        self
    }
}

impl wkt::message::Message for CodeBlock {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.CodeBlock"
    }
}

/// Configuration for tool behavior in fake mode.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ToolFakeConfig {
    /// Optional. Whether the tool is using fake mode.
    pub enable_fake_mode: bool,

    /// The response is either static or it is provided by a python function.
    pub tool_response: std::option::Option<crate::model::tool_fake_config::ToolResponse>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ToolFakeConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [enable_fake_mode][crate::model::ToolFakeConfig::enable_fake_mode].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolFakeConfig;
    /// let x = ToolFakeConfig::new().set_enable_fake_mode(true);
    /// ```
    pub fn set_enable_fake_mode<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.enable_fake_mode = v.into();
        self
    }

    /// Sets the value of [tool_response][crate::model::ToolFakeConfig::tool_response].
    ///
    /// Note that all the setters affecting `tool_response` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolFakeConfig;
    /// use google_cloud_ces_v1::model::CodeBlock;
    /// let x = ToolFakeConfig::new().set_tool_response(Some(
    ///     google_cloud_ces_v1::model::tool_fake_config::ToolResponse::CodeBlock(CodeBlock::default().into())));
    /// ```
    pub fn set_tool_response<
        T: std::convert::Into<std::option::Option<crate::model::tool_fake_config::ToolResponse>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_response = v.into();
        self
    }

    /// The value of [tool_response][crate::model::ToolFakeConfig::tool_response]
    /// if it holds a `CodeBlock`, `None` if the field is not set or
    /// holds a different branch.
    pub fn code_block(&self) -> std::option::Option<&std::boxed::Box<crate::model::CodeBlock>> {
        #[allow(unreachable_patterns)]
        self.tool_response.as_ref().and_then(|v| match v {
            crate::model::tool_fake_config::ToolResponse::CodeBlock(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_response][crate::model::ToolFakeConfig::tool_response]
    /// to hold a `CodeBlock`.
    ///
    /// Note that all the setters affecting `tool_response` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolFakeConfig;
    /// use google_cloud_ces_v1::model::CodeBlock;
    /// let x = ToolFakeConfig::new().set_code_block(CodeBlock::default()/* use setters */);
    /// assert!(x.code_block().is_some());
    /// ```
    pub fn set_code_block<T: std::convert::Into<std::boxed::Box<crate::model::CodeBlock>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_response = std::option::Option::Some(
            crate::model::tool_fake_config::ToolResponse::CodeBlock(v.into()),
        );
        self
    }
}

impl wkt::message::Message for ToolFakeConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ToolFakeConfig"
    }
}

/// Defines additional types related to [ToolFakeConfig].
pub mod tool_fake_config {
    #[allow(unused_imports)]
    use super::*;

    /// The response is either static or it is provided by a python function.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolResponse {
        /// Optional. Code block which will be executed instead of a real tool call.
        CodeBlock(std::boxed::Box<crate::model::CodeBlock>),
    }
}

/// The file search tool allows the agent to search across the files uploaded by
/// the app/agent developer. It has presets to give relatively good quality
/// search over the uploaded files and summarization of the retrieved results.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct FileSearchTool {
    /// Optional. The type of the corpus. Default is FULLY_MANAGED.
    pub corpus_type: crate::model::file_search_tool::CorpusType,

    /// Required. The tool name.
    pub name: std::string::String,

    /// Optional. The tool description.
    pub description: std::string::String,

    /// Optional. The corpus where files are stored.
    /// Format:
    /// projects/{project}/locations/{location}/ragCorpora/{rag_corpus}
    pub file_corpus: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl FileSearchTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [corpus_type][crate::model::FileSearchTool::corpus_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::FileSearchTool;
    /// use google_cloud_ces_v1::model::file_search_tool::CorpusType;
    /// let x0 = FileSearchTool::new().set_corpus_type(CorpusType::UserOwned);
    /// let x1 = FileSearchTool::new().set_corpus_type(CorpusType::FullyManaged);
    /// ```
    pub fn set_corpus_type<T: std::convert::Into<crate::model::file_search_tool::CorpusType>>(
        mut self,
        v: T,
    ) -> Self {
        self.corpus_type = v.into();
        self
    }

    /// Sets the value of [name][crate::model::FileSearchTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::FileSearchTool;
    /// let x = FileSearchTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::FileSearchTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::FileSearchTool;
    /// let x = FileSearchTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [file_corpus][crate::model::FileSearchTool::file_corpus].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::FileSearchTool;
    /// let x = FileSearchTool::new().set_file_corpus("example");
    /// ```
    pub fn set_file_corpus<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.file_corpus = v.into();
        self
    }
}

impl wkt::message::Message for FileSearchTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.FileSearchTool"
    }
}

/// Defines additional types related to [FileSearchTool].
pub mod file_search_tool {
    #[allow(unused_imports)]
    use super::*;

    /// The type of the Vertex RAG corpus.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum CorpusType {
        /// Unspecified corpus type.
        Unspecified,
        /// The corpus is created and owned by the user.
        UserOwned,
        /// The corpus is created by the agent.
        FullyManaged,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [CorpusType::value] or
        /// [CorpusType::name].
        UnknownValue(corpus_type::UnknownValue),
    }

    #[doc(hidden)]
    pub mod corpus_type {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl CorpusType {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::UserOwned => std::option::Option::Some(1),
                Self::FullyManaged => std::option::Option::Some(2),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("CORPUS_TYPE_UNSPECIFIED"),
                Self::UserOwned => std::option::Option::Some("USER_OWNED"),
                Self::FullyManaged => std::option::Option::Some("FULLY_MANAGED"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for CorpusType {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for CorpusType {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for CorpusType {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::UserOwned,
                2 => Self::FullyManaged,
                _ => Self::UnknownValue(corpus_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for CorpusType {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "CORPUS_TYPE_UNSPECIFIED" => Self::Unspecified,
                "USER_OWNED" => Self::UserOwned,
                "FULLY_MANAGED" => Self::FullyManaged,
                _ => Self::UnknownValue(corpus_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for CorpusType {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::UserOwned => serializer.serialize_i32(1),
                Self::FullyManaged => serializer.serialize_i32(2),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for CorpusType {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<CorpusType>::new(
                ".google.cloud.ces.v1.FileSearchTool.CorpusType",
            ))
        }
    }
}

/// Represents a tool to perform Google web searches for grounding.
/// See
/// <https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool#google-search>.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GoogleSearchTool {
    /// Required. The name of the tool.
    pub name: std::string::String,

    /// Optional. Description of the tool's purpose.
    pub description: std::string::String,

    /// Optional. Content will be fetched directly from these URLs for context and
    /// grounding. Example: `https://example.com/path.html`. A maximum of 20 URLs
    /// are allowed.
    pub context_urls: std::vec::Vec<std::string::String>,

    /// Optional. Specifies domains to restrict search results to.
    /// Example: "example.com", "another.site". A maximum of 20 domains can be
    /// specified.
    pub preferred_domains: std::vec::Vec<std::string::String>,

    /// Optional. List of domains to be excluded from the search results.
    /// Example: "example.com".
    /// A maximum of 2000 domains can be excluded.
    pub exclude_domains: std::vec::Vec<std::string::String>,

    /// Optional. Prompt instructions passed to planner on how the search results
    /// should be processed for text and voice.
    pub prompt_config: std::option::Option<crate::model::google_search_tool::PromptConfig>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GoogleSearchTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GoogleSearchTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GoogleSearchTool;
    /// let x = GoogleSearchTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::GoogleSearchTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GoogleSearchTool;
    /// let x = GoogleSearchTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [context_urls][crate::model::GoogleSearchTool::context_urls].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GoogleSearchTool;
    /// let x = GoogleSearchTool::new().set_context_urls(["a", "b", "c"]);
    /// ```
    pub fn set_context_urls<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.context_urls = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [preferred_domains][crate::model::GoogleSearchTool::preferred_domains].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GoogleSearchTool;
    /// let x = GoogleSearchTool::new().set_preferred_domains(["a", "b", "c"]);
    /// ```
    pub fn set_preferred_domains<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.preferred_domains = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [exclude_domains][crate::model::GoogleSearchTool::exclude_domains].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GoogleSearchTool;
    /// let x = GoogleSearchTool::new().set_exclude_domains(["a", "b", "c"]);
    /// ```
    pub fn set_exclude_domains<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.exclude_domains = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [prompt_config][crate::model::GoogleSearchTool::prompt_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GoogleSearchTool;
    /// use google_cloud_ces_v1::model::google_search_tool::PromptConfig;
    /// let x = GoogleSearchTool::new().set_prompt_config(PromptConfig::default()/* use setters */);
    /// ```
    pub fn set_prompt_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::google_search_tool::PromptConfig>,
    {
        self.prompt_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [prompt_config][crate::model::GoogleSearchTool::prompt_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GoogleSearchTool;
    /// use google_cloud_ces_v1::model::google_search_tool::PromptConfig;
    /// let x = GoogleSearchTool::new().set_or_clear_prompt_config(Some(PromptConfig::default()/* use setters */));
    /// let x = GoogleSearchTool::new().set_or_clear_prompt_config(None::<PromptConfig>);
    /// ```
    pub fn set_or_clear_prompt_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::google_search_tool::PromptConfig>,
    {
        self.prompt_config = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for GoogleSearchTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GoogleSearchTool"
    }
}

/// Defines additional types related to [GoogleSearchTool].
pub mod google_search_tool {
    #[allow(unused_imports)]
    use super::*;

    /// Prompt settings used by the model when processing or summarizing the
    /// google search results.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct PromptConfig {
        /// Optional. Defines the prompt used for the system instructions when
        /// interacting with the agent in chat conversations. If not set, default
        /// prompt will be used.
        pub text_prompt: std::string::String,

        /// Optional. Defines the prompt used for the system instructions when
        /// interacting with the agent in voice conversations. If not set, default
        /// prompt will be used.
        pub voice_prompt: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl PromptConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [text_prompt][crate::model::google_search_tool::PromptConfig::text_prompt].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::google_search_tool::PromptConfig;
        /// let x = PromptConfig::new().set_text_prompt("example");
        /// ```
        pub fn set_text_prompt<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.text_prompt = v.into();
            self
        }

        /// Sets the value of [voice_prompt][crate::model::google_search_tool::PromptConfig::voice_prompt].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::google_search_tool::PromptConfig;
        /// let x = PromptConfig::new().set_voice_prompt("example");
        /// ```
        pub fn set_voice_prompt<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.voice_prompt = v.into();
            self
        }
    }

    impl wkt::message::Message for PromptConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.GoogleSearchTool.PromptConfig"
        }
    }
}

/// Guardrail contains a list of checks and balances to keep the agents safe and
/// secure.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Guardrail {
    /// Identifier. The unique identifier of the guardrail.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}`
    pub name: std::string::String,

    /// Required. Display name of the guardrail.
    pub display_name: std::string::String,

    /// Optional. Description of the guardrail.
    pub description: std::string::String,

    /// Optional. Whether the guardrail is enabled.
    pub enabled: bool,

    /// Optional. Action to take when the guardrail is triggered.
    pub action: std::option::Option<crate::model::TriggerAction>,

    /// Output only. Timestamp when the guardrail was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Timestamp when the guardrail was last updated.
    pub update_time: std::option::Option<wkt::Timestamp>,

    /// 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.
    pub etag: std::string::String,

    /// Guardrail type.
    pub guardrail_type: std::option::Option<crate::model::guardrail::GuardrailType>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Guardrail {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Guardrail::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let guardrail_id = "guardrail_id";
    /// let x = Guardrail::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/guardrails/{guardrail_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::Guardrail::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// let x = Guardrail::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::Guardrail::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// let x = Guardrail::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [enabled][crate::model::Guardrail::enabled].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// let x = Guardrail::new().set_enabled(true);
    /// ```
    pub fn set_enabled<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.enabled = v.into();
        self
    }

    /// Sets the value of [action][crate::model::Guardrail::action].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use google_cloud_ces_v1::model::TriggerAction;
    /// let x = Guardrail::new().set_action(TriggerAction::default()/* use setters */);
    /// ```
    pub fn set_action<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TriggerAction>,
    {
        self.action = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [action][crate::model::Guardrail::action].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use google_cloud_ces_v1::model::TriggerAction;
    /// let x = Guardrail::new().set_or_clear_action(Some(TriggerAction::default()/* use setters */));
    /// let x = Guardrail::new().set_or_clear_action(None::<TriggerAction>);
    /// ```
    pub fn set_or_clear_action<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TriggerAction>,
    {
        self.action = v.map(|x| x.into());
        self
    }

    /// Sets the value of [create_time][crate::model::Guardrail::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use wkt::Timestamp;
    /// let x = Guardrail::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::Guardrail::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use wkt::Timestamp;
    /// let x = Guardrail::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = Guardrail::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::Guardrail::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use wkt::Timestamp;
    /// let x = Guardrail::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::Guardrail::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use wkt::Timestamp;
    /// let x = Guardrail::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = Guardrail::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [etag][crate::model::Guardrail::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// let x = Guardrail::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }

    /// Sets the value of [guardrail_type][crate::model::Guardrail::guardrail_type].
    ///
    /// Note that all the setters affecting `guardrail_type` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use google_cloud_ces_v1::model::guardrail::ContentFilter;
    /// let x = Guardrail::new().set_guardrail_type(Some(
    ///     google_cloud_ces_v1::model::guardrail::GuardrailType::ContentFilter(ContentFilter::default().into())));
    /// ```
    pub fn set_guardrail_type<
        T: std::convert::Into<std::option::Option<crate::model::guardrail::GuardrailType>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.guardrail_type = v.into();
        self
    }

    /// The value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// if it holds a `ContentFilter`, `None` if the field is not set or
    /// holds a different branch.
    pub fn content_filter(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::guardrail::ContentFilter>> {
        #[allow(unreachable_patterns)]
        self.guardrail_type.as_ref().and_then(|v| match v {
            crate::model::guardrail::GuardrailType::ContentFilter(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// to hold a `ContentFilter`.
    ///
    /// Note that all the setters affecting `guardrail_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use google_cloud_ces_v1::model::guardrail::ContentFilter;
    /// let x = Guardrail::new().set_content_filter(ContentFilter::default()/* use setters */);
    /// assert!(x.content_filter().is_some());
    /// assert!(x.llm_prompt_security().is_none());
    /// assert!(x.llm_policy().is_none());
    /// assert!(x.model_safety().is_none());
    /// assert!(x.code_callback().is_none());
    /// ```
    pub fn set_content_filter<
        T: std::convert::Into<std::boxed::Box<crate::model::guardrail::ContentFilter>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.guardrail_type = std::option::Option::Some(
            crate::model::guardrail::GuardrailType::ContentFilter(v.into()),
        );
        self
    }

    /// The value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// if it holds a `LlmPromptSecurity`, `None` if the field is not set or
    /// holds a different branch.
    pub fn llm_prompt_security(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::guardrail::LlmPromptSecurity>> {
        #[allow(unreachable_patterns)]
        self.guardrail_type.as_ref().and_then(|v| match v {
            crate::model::guardrail::GuardrailType::LlmPromptSecurity(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// to hold a `LlmPromptSecurity`.
    ///
    /// Note that all the setters affecting `guardrail_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use google_cloud_ces_v1::model::guardrail::LlmPromptSecurity;
    /// let x = Guardrail::new().set_llm_prompt_security(LlmPromptSecurity::default()/* use setters */);
    /// assert!(x.llm_prompt_security().is_some());
    /// assert!(x.content_filter().is_none());
    /// assert!(x.llm_policy().is_none());
    /// assert!(x.model_safety().is_none());
    /// assert!(x.code_callback().is_none());
    /// ```
    pub fn set_llm_prompt_security<
        T: std::convert::Into<std::boxed::Box<crate::model::guardrail::LlmPromptSecurity>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.guardrail_type = std::option::Option::Some(
            crate::model::guardrail::GuardrailType::LlmPromptSecurity(v.into()),
        );
        self
    }

    /// The value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// if it holds a `LlmPolicy`, `None` if the field is not set or
    /// holds a different branch.
    pub fn llm_policy(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::guardrail::LlmPolicy>> {
        #[allow(unreachable_patterns)]
        self.guardrail_type.as_ref().and_then(|v| match v {
            crate::model::guardrail::GuardrailType::LlmPolicy(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// to hold a `LlmPolicy`.
    ///
    /// Note that all the setters affecting `guardrail_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use google_cloud_ces_v1::model::guardrail::LlmPolicy;
    /// let x = Guardrail::new().set_llm_policy(LlmPolicy::default()/* use setters */);
    /// assert!(x.llm_policy().is_some());
    /// assert!(x.content_filter().is_none());
    /// assert!(x.llm_prompt_security().is_none());
    /// assert!(x.model_safety().is_none());
    /// assert!(x.code_callback().is_none());
    /// ```
    pub fn set_llm_policy<
        T: std::convert::Into<std::boxed::Box<crate::model::guardrail::LlmPolicy>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.guardrail_type =
            std::option::Option::Some(crate::model::guardrail::GuardrailType::LlmPolicy(v.into()));
        self
    }

    /// The value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// if it holds a `ModelSafety`, `None` if the field is not set or
    /// holds a different branch.
    pub fn model_safety(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::guardrail::ModelSafety>> {
        #[allow(unreachable_patterns)]
        self.guardrail_type.as_ref().and_then(|v| match v {
            crate::model::guardrail::GuardrailType::ModelSafety(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// to hold a `ModelSafety`.
    ///
    /// Note that all the setters affecting `guardrail_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use google_cloud_ces_v1::model::guardrail::ModelSafety;
    /// let x = Guardrail::new().set_model_safety(ModelSafety::default()/* use setters */);
    /// assert!(x.model_safety().is_some());
    /// assert!(x.content_filter().is_none());
    /// assert!(x.llm_prompt_security().is_none());
    /// assert!(x.llm_policy().is_none());
    /// assert!(x.code_callback().is_none());
    /// ```
    pub fn set_model_safety<
        T: std::convert::Into<std::boxed::Box<crate::model::guardrail::ModelSafety>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.guardrail_type = std::option::Option::Some(
            crate::model::guardrail::GuardrailType::ModelSafety(v.into()),
        );
        self
    }

    /// The value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// if it holds a `CodeCallback`, `None` if the field is not set or
    /// holds a different branch.
    pub fn code_callback(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::guardrail::CodeCallback>> {
        #[allow(unreachable_patterns)]
        self.guardrail_type.as_ref().and_then(|v| match v {
            crate::model::guardrail::GuardrailType::CodeCallback(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [guardrail_type][crate::model::Guardrail::guardrail_type]
    /// to hold a `CodeCallback`.
    ///
    /// Note that all the setters affecting `guardrail_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Guardrail;
    /// use google_cloud_ces_v1::model::guardrail::CodeCallback;
    /// let x = Guardrail::new().set_code_callback(CodeCallback::default()/* use setters */);
    /// assert!(x.code_callback().is_some());
    /// assert!(x.content_filter().is_none());
    /// assert!(x.llm_prompt_security().is_none());
    /// assert!(x.llm_policy().is_none());
    /// assert!(x.model_safety().is_none());
    /// ```
    pub fn set_code_callback<
        T: std::convert::Into<std::boxed::Box<crate::model::guardrail::CodeCallback>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.guardrail_type = std::option::Option::Some(
            crate::model::guardrail::GuardrailType::CodeCallback(v.into()),
        );
        self
    }
}

impl wkt::message::Message for Guardrail {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Guardrail"
    }
}

/// Defines additional types related to [Guardrail].
pub mod guardrail {
    #[allow(unused_imports)]
    use super::*;

    /// Guardrail that bans certain content from being used in the conversation.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct ContentFilter {
        /// Optional. List of banned phrases. Applies to both user inputs and agent
        /// responses.
        pub banned_contents: std::vec::Vec<std::string::String>,

        /// Optional. List of banned phrases. Applies only to user inputs.
        pub banned_contents_in_user_input: std::vec::Vec<std::string::String>,

        /// Optional. List of banned phrases. Applies only to agent responses.
        pub banned_contents_in_agent_response: std::vec::Vec<std::string::String>,

        /// Required. Match type for the content filter.
        pub match_type: crate::model::guardrail::content_filter::MatchType,

        /// Optional. If true, diacritics are ignored during matching.
        pub disregard_diacritics: bool,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl ContentFilter {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [banned_contents][crate::model::guardrail::ContentFilter::banned_contents].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::ContentFilter;
        /// let x = ContentFilter::new().set_banned_contents(["a", "b", "c"]);
        /// ```
        pub fn set_banned_contents<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.banned_contents = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [banned_contents_in_user_input][crate::model::guardrail::ContentFilter::banned_contents_in_user_input].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::ContentFilter;
        /// let x = ContentFilter::new().set_banned_contents_in_user_input(["a", "b", "c"]);
        /// ```
        pub fn set_banned_contents_in_user_input<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.banned_contents_in_user_input = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [banned_contents_in_agent_response][crate::model::guardrail::ContentFilter::banned_contents_in_agent_response].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::ContentFilter;
        /// let x = ContentFilter::new().set_banned_contents_in_agent_response(["a", "b", "c"]);
        /// ```
        pub fn set_banned_contents_in_agent_response<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.banned_contents_in_agent_response = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [match_type][crate::model::guardrail::ContentFilter::match_type].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::ContentFilter;
        /// use google_cloud_ces_v1::model::guardrail::content_filter::MatchType;
        /// let x0 = ContentFilter::new().set_match_type(MatchType::SimpleStringMatch);
        /// let x1 = ContentFilter::new().set_match_type(MatchType::WordBoundaryStringMatch);
        /// let x2 = ContentFilter::new().set_match_type(MatchType::RegexpMatch);
        /// ```
        pub fn set_match_type<
            T: std::convert::Into<crate::model::guardrail::content_filter::MatchType>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.match_type = v.into();
            self
        }

        /// Sets the value of [disregard_diacritics][crate::model::guardrail::ContentFilter::disregard_diacritics].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::ContentFilter;
        /// let x = ContentFilter::new().set_disregard_diacritics(true);
        /// ```
        pub fn set_disregard_diacritics<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
            self.disregard_diacritics = v.into();
            self
        }
    }

    impl wkt::message::Message for ContentFilter {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Guardrail.ContentFilter"
        }
    }

    /// Defines additional types related to [ContentFilter].
    pub mod content_filter {
        #[allow(unused_imports)]
        use super::*;

        /// Match type for the content filter.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum MatchType {
            /// Match type is not specified.
            Unspecified,
            /// Content is matched for substrings character by character.
            SimpleStringMatch,
            /// Content only matches if the pattern found in the text is
            /// surrounded by word delimiters. Banned phrases can also contain word
            /// delimiters.
            WordBoundaryStringMatch,
            /// Content is matched using regular expression syntax.
            RegexpMatch,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [MatchType::value] or
            /// [MatchType::name].
            UnknownValue(match_type::UnknownValue),
        }

        #[doc(hidden)]
        pub mod match_type {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl MatchType {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::SimpleStringMatch => std::option::Option::Some(1),
                    Self::WordBoundaryStringMatch => std::option::Option::Some(2),
                    Self::RegexpMatch => std::option::Option::Some(3),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("MATCH_TYPE_UNSPECIFIED"),
                    Self::SimpleStringMatch => std::option::Option::Some("SIMPLE_STRING_MATCH"),
                    Self::WordBoundaryStringMatch => {
                        std::option::Option::Some("WORD_BOUNDARY_STRING_MATCH")
                    }
                    Self::RegexpMatch => std::option::Option::Some("REGEXP_MATCH"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for MatchType {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for MatchType {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for MatchType {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::SimpleStringMatch,
                    2 => Self::WordBoundaryStringMatch,
                    3 => Self::RegexpMatch,
                    _ => Self::UnknownValue(match_type::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for MatchType {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "MATCH_TYPE_UNSPECIFIED" => Self::Unspecified,
                    "SIMPLE_STRING_MATCH" => Self::SimpleStringMatch,
                    "WORD_BOUNDARY_STRING_MATCH" => Self::WordBoundaryStringMatch,
                    "REGEXP_MATCH" => Self::RegexpMatch,
                    _ => Self::UnknownValue(match_type::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for MatchType {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::SimpleStringMatch => serializer.serialize_i32(1),
                    Self::WordBoundaryStringMatch => serializer.serialize_i32(2),
                    Self::RegexpMatch => serializer.serialize_i32(3),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for MatchType {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<MatchType>::new(
                    ".google.cloud.ces.v1.Guardrail.ContentFilter.MatchType",
                ))
            }
        }
    }

    /// Guardrail that blocks the conversation if the input is considered unsafe
    /// based on the LLM classification.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct LlmPromptSecurity {
        /// 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.
        pub fail_open: bool,

        /// Defines the security configuration mode.
        /// The user must choose one of the following configurations.
        pub security_config:
            std::option::Option<crate::model::guardrail::llm_prompt_security::SecurityConfig>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl LlmPromptSecurity {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [fail_open][crate::model::guardrail::LlmPromptSecurity::fail_open].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPromptSecurity;
        /// let x = LlmPromptSecurity::new().set_fail_open(true);
        /// ```
        pub fn set_fail_open<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
            self.fail_open = v.into();
            self
        }

        /// Sets the value of [security_config][crate::model::guardrail::LlmPromptSecurity::security_config].
        ///
        /// Note that all the setters affecting `security_config` are mutually
        /// exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPromptSecurity;
        /// use google_cloud_ces_v1::model::guardrail::llm_prompt_security::DefaultSecuritySettings;
        /// let x = LlmPromptSecurity::new().set_security_config(Some(
        ///     google_cloud_ces_v1::model::guardrail::llm_prompt_security::SecurityConfig::DefaultSettings(DefaultSecuritySettings::default().into())));
        /// ```
        pub fn set_security_config<
            T: std::convert::Into<
                    std::option::Option<
                        crate::model::guardrail::llm_prompt_security::SecurityConfig,
                    >,
                >,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.security_config = v.into();
            self
        }

        /// The value of [security_config][crate::model::guardrail::LlmPromptSecurity::security_config]
        /// if it holds a `DefaultSettings`, `None` if the field is not set or
        /// holds a different branch.
        pub fn default_settings(
            &self,
        ) -> std::option::Option<
            &std::boxed::Box<crate::model::guardrail::llm_prompt_security::DefaultSecuritySettings>,
        > {
            #[allow(unreachable_patterns)]
            self.security_config.as_ref().and_then(|v| match v {
                crate::model::guardrail::llm_prompt_security::SecurityConfig::DefaultSettings(
                    v,
                ) => std::option::Option::Some(v),
                _ => std::option::Option::None,
            })
        }

        /// Sets the value of [security_config][crate::model::guardrail::LlmPromptSecurity::security_config]
        /// to hold a `DefaultSettings`.
        ///
        /// Note that all the setters affecting `security_config` are
        /// mutually exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPromptSecurity;
        /// use google_cloud_ces_v1::model::guardrail::llm_prompt_security::DefaultSecuritySettings;
        /// let x = LlmPromptSecurity::new().set_default_settings(DefaultSecuritySettings::default()/* use setters */);
        /// assert!(x.default_settings().is_some());
        /// assert!(x.custom_policy().is_none());
        /// ```
        pub fn set_default_settings<
            T: std::convert::Into<
                    std::boxed::Box<
                        crate::model::guardrail::llm_prompt_security::DefaultSecuritySettings,
                    >,
                >,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.security_config = std::option::Option::Some(
                crate::model::guardrail::llm_prompt_security::SecurityConfig::DefaultSettings(
                    v.into(),
                ),
            );
            self
        }

        /// The value of [security_config][crate::model::guardrail::LlmPromptSecurity::security_config]
        /// if it holds a `CustomPolicy`, `None` if the field is not set or
        /// holds a different branch.
        pub fn custom_policy(
            &self,
        ) -> std::option::Option<&std::boxed::Box<crate::model::guardrail::LlmPolicy>> {
            #[allow(unreachable_patterns)]
            self.security_config.as_ref().and_then(|v| match v {
                crate::model::guardrail::llm_prompt_security::SecurityConfig::CustomPolicy(v) => {
                    std::option::Option::Some(v)
                }
                _ => std::option::Option::None,
            })
        }

        /// Sets the value of [security_config][crate::model::guardrail::LlmPromptSecurity::security_config]
        /// to hold a `CustomPolicy`.
        ///
        /// Note that all the setters affecting `security_config` are
        /// mutually exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPromptSecurity;
        /// use google_cloud_ces_v1::model::guardrail::LlmPolicy;
        /// let x = LlmPromptSecurity::new().set_custom_policy(LlmPolicy::default()/* use setters */);
        /// assert!(x.custom_policy().is_some());
        /// assert!(x.default_settings().is_none());
        /// ```
        pub fn set_custom_policy<
            T: std::convert::Into<std::boxed::Box<crate::model::guardrail::LlmPolicy>>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.security_config = std::option::Option::Some(
                crate::model::guardrail::llm_prompt_security::SecurityConfig::CustomPolicy(
                    v.into(),
                ),
            );
            self
        }
    }

    impl wkt::message::Message for LlmPromptSecurity {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Guardrail.LlmPromptSecurity"
        }
    }

    /// Defines additional types related to [LlmPromptSecurity].
    pub mod llm_prompt_security {
        #[allow(unused_imports)]
        use super::*;

        /// Configuration for default system security settings.
        #[derive(Clone, Default, PartialEq)]
        #[non_exhaustive]
        pub struct DefaultSecuritySettings {
            /// 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.
            pub default_prompt_template: std::string::String,

            pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
        }

        impl DefaultSecuritySettings {
            /// Creates a new default instance.
            pub fn new() -> Self {
                std::default::Default::default()
            }

            /// Sets the value of [default_prompt_template][crate::model::guardrail::llm_prompt_security::DefaultSecuritySettings::default_prompt_template].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::guardrail::llm_prompt_security::DefaultSecuritySettings;
            /// let x = DefaultSecuritySettings::new().set_default_prompt_template("example");
            /// ```
            pub fn set_default_prompt_template<T: std::convert::Into<std::string::String>>(
                mut self,
                v: T,
            ) -> Self {
                self.default_prompt_template = v.into();
                self
            }
        }

        impl wkt::message::Message for DefaultSecuritySettings {
            fn typename() -> &'static str {
                "type.googleapis.com/google.cloud.ces.v1.Guardrail.LlmPromptSecurity.DefaultSecuritySettings"
            }
        }

        /// Defines the security configuration mode.
        /// The user must choose one of the following configurations.
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum SecurityConfig {
            /// Optional. Use the system's predefined default security settings.
            /// To select this mode, include an empty 'default_settings' message
            /// in the request. The 'default_prompt_template' field within
            /// will be populated by the server in the response.
            DefaultSettings(
                std::boxed::Box<
                    crate::model::guardrail::llm_prompt_security::DefaultSecuritySettings,
                >,
            ),
            /// Optional. Use a user-defined LlmPolicy to configure the security
            /// guardrail.
            CustomPolicy(std::boxed::Box<crate::model::guardrail::LlmPolicy>),
        }
    }

    /// Guardrail that blocks the conversation if the LLM response is considered
    /// violating the policy based on the LLM classification.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct LlmPolicy {
        /// Optional. When checking this policy, consider the last 'n' messages in
        /// the conversation. When not set a default value of 10 will be used.
        pub max_conversation_messages: i32,

        /// Optional. Model settings.
        pub model_settings: std::option::Option<crate::model::ModelSettings>,

        /// Required. Policy prompt.
        pub prompt: std::string::String,

        /// 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.
        pub policy_scope: crate::model::guardrail::llm_policy::PolicyScope,

        /// Optional. If an error occurs during the policy check, fail open and do
        /// not trigger the guardrail.
        pub fail_open: bool,

        /// 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.
        pub allow_short_utterance: bool,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl LlmPolicy {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [max_conversation_messages][crate::model::guardrail::LlmPolicy::max_conversation_messages].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPolicy;
        /// let x = LlmPolicy::new().set_max_conversation_messages(42);
        /// ```
        pub fn set_max_conversation_messages<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
            self.max_conversation_messages = v.into();
            self
        }

        /// Sets the value of [model_settings][crate::model::guardrail::LlmPolicy::model_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPolicy;
        /// use google_cloud_ces_v1::model::ModelSettings;
        /// let x = LlmPolicy::new().set_model_settings(ModelSettings::default()/* use setters */);
        /// ```
        pub fn set_model_settings<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::ModelSettings>,
        {
            self.model_settings = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [model_settings][crate::model::guardrail::LlmPolicy::model_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPolicy;
        /// use google_cloud_ces_v1::model::ModelSettings;
        /// let x = LlmPolicy::new().set_or_clear_model_settings(Some(ModelSettings::default()/* use setters */));
        /// let x = LlmPolicy::new().set_or_clear_model_settings(None::<ModelSettings>);
        /// ```
        pub fn set_or_clear_model_settings<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::ModelSettings>,
        {
            self.model_settings = v.map(|x| x.into());
            self
        }

        /// Sets the value of [prompt][crate::model::guardrail::LlmPolicy::prompt].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPolicy;
        /// let x = LlmPolicy::new().set_prompt("example");
        /// ```
        pub fn set_prompt<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.prompt = v.into();
            self
        }

        /// Sets the value of [policy_scope][crate::model::guardrail::LlmPolicy::policy_scope].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPolicy;
        /// use google_cloud_ces_v1::model::guardrail::llm_policy::PolicyScope;
        /// let x0 = LlmPolicy::new().set_policy_scope(PolicyScope::UserQuery);
        /// let x1 = LlmPolicy::new().set_policy_scope(PolicyScope::AgentResponse);
        /// let x2 = LlmPolicy::new().set_policy_scope(PolicyScope::UserQueryAndAgentResponse);
        /// ```
        pub fn set_policy_scope<
            T: std::convert::Into<crate::model::guardrail::llm_policy::PolicyScope>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.policy_scope = v.into();
            self
        }

        /// Sets the value of [fail_open][crate::model::guardrail::LlmPolicy::fail_open].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPolicy;
        /// let x = LlmPolicy::new().set_fail_open(true);
        /// ```
        pub fn set_fail_open<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
            self.fail_open = v.into();
            self
        }

        /// Sets the value of [allow_short_utterance][crate::model::guardrail::LlmPolicy::allow_short_utterance].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::LlmPolicy;
        /// let x = LlmPolicy::new().set_allow_short_utterance(true);
        /// ```
        pub fn set_allow_short_utterance<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
            self.allow_short_utterance = v.into();
            self
        }
    }

    impl wkt::message::Message for LlmPolicy {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Guardrail.LlmPolicy"
        }
    }

    /// Defines additional types related to [LlmPolicy].
    pub mod llm_policy {
        #[allow(unused_imports)]
        use super::*;

        /// Defines when to apply the policy check during the conversation.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum PolicyScope {
            /// Policy scope is not specified.
            Unspecified,
            /// Policy check is triggered on user input.
            UserQuery,
            /// Policy check is triggered on agent response. Applying this policy
            /// scope will introduce additional latency before the agent can respond.
            AgentResponse,
            /// Policy check is triggered on both user input and agent response.
            /// Applying this policy scope will introduce additional latency before
            /// the agent can respond.
            UserQueryAndAgentResponse,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [PolicyScope::value] or
            /// [PolicyScope::name].
            UnknownValue(policy_scope::UnknownValue),
        }

        #[doc(hidden)]
        pub mod policy_scope {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl PolicyScope {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::UserQuery => std::option::Option::Some(1),
                    Self::AgentResponse => std::option::Option::Some(2),
                    Self::UserQueryAndAgentResponse => std::option::Option::Some(3),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("POLICY_SCOPE_UNSPECIFIED"),
                    Self::UserQuery => std::option::Option::Some("USER_QUERY"),
                    Self::AgentResponse => std::option::Option::Some("AGENT_RESPONSE"),
                    Self::UserQueryAndAgentResponse => {
                        std::option::Option::Some("USER_QUERY_AND_AGENT_RESPONSE")
                    }
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for PolicyScope {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for PolicyScope {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for PolicyScope {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::UserQuery,
                    2 => Self::AgentResponse,
                    3 => Self::UserQueryAndAgentResponse,
                    _ => Self::UnknownValue(policy_scope::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for PolicyScope {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "POLICY_SCOPE_UNSPECIFIED" => Self::Unspecified,
                    "USER_QUERY" => Self::UserQuery,
                    "AGENT_RESPONSE" => Self::AgentResponse,
                    "USER_QUERY_AND_AGENT_RESPONSE" => Self::UserQueryAndAgentResponse,
                    _ => Self::UnknownValue(policy_scope::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for PolicyScope {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::UserQuery => serializer.serialize_i32(1),
                    Self::AgentResponse => serializer.serialize_i32(2),
                    Self::UserQueryAndAgentResponse => serializer.serialize_i32(3),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for PolicyScope {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<PolicyScope>::new(
                    ".google.cloud.ces.v1.Guardrail.LlmPolicy.PolicyScope",
                ))
            }
        }
    }

    /// Model safety settings overrides. When this is set, it will override the
    /// default settings and trigger the guardrail if the response is considered
    /// unsafe.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct ModelSafety {
        /// Required. List of safety settings.
        pub safety_settings: std::vec::Vec<crate::model::guardrail::model_safety::SafetySetting>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl ModelSafety {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [safety_settings][crate::model::guardrail::ModelSafety::safety_settings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::ModelSafety;
        /// use google_cloud_ces_v1::model::guardrail::model_safety::SafetySetting;
        /// let x = ModelSafety::new()
        ///     .set_safety_settings([
        ///         SafetySetting::default()/* use setters */,
        ///         SafetySetting::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_safety_settings<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::guardrail::model_safety::SafetySetting>,
        {
            use std::iter::Iterator;
            self.safety_settings = v.into_iter().map(|i| i.into()).collect();
            self
        }
    }

    impl wkt::message::Message for ModelSafety {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Guardrail.ModelSafety"
        }
    }

    /// Defines additional types related to [ModelSafety].
    pub mod model_safety {
        #[allow(unused_imports)]
        use super::*;

        /// Safety setting.
        #[derive(Clone, Default, PartialEq)]
        #[non_exhaustive]
        pub struct SafetySetting {
            /// Required. The harm category.
            pub category: crate::model::guardrail::model_safety::HarmCategory,

            /// Required. The harm block threshold.
            pub threshold: crate::model::guardrail::model_safety::HarmBlockThreshold,

            pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
        }

        impl SafetySetting {
            /// Creates a new default instance.
            pub fn new() -> Self {
                std::default::Default::default()
            }

            /// Sets the value of [category][crate::model::guardrail::model_safety::SafetySetting::category].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::guardrail::model_safety::SafetySetting;
            /// use google_cloud_ces_v1::model::guardrail::model_safety::HarmCategory;
            /// let x0 = SafetySetting::new().set_category(HarmCategory::HateSpeech);
            /// let x1 = SafetySetting::new().set_category(HarmCategory::DangerousContent);
            /// let x2 = SafetySetting::new().set_category(HarmCategory::Harassment);
            /// ```
            pub fn set_category<
                T: std::convert::Into<crate::model::guardrail::model_safety::HarmCategory>,
            >(
                mut self,
                v: T,
            ) -> Self {
                self.category = v.into();
                self
            }

            /// Sets the value of [threshold][crate::model::guardrail::model_safety::SafetySetting::threshold].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_ces_v1::model::guardrail::model_safety::SafetySetting;
            /// use google_cloud_ces_v1::model::guardrail::model_safety::HarmBlockThreshold;
            /// let x0 = SafetySetting::new().set_threshold(HarmBlockThreshold::BlockLowAndAbove);
            /// let x1 = SafetySetting::new().set_threshold(HarmBlockThreshold::BlockMediumAndAbove);
            /// let x2 = SafetySetting::new().set_threshold(HarmBlockThreshold::BlockOnlyHigh);
            /// ```
            pub fn set_threshold<
                T: std::convert::Into<crate::model::guardrail::model_safety::HarmBlockThreshold>,
            >(
                mut self,
                v: T,
            ) -> Self {
                self.threshold = v.into();
                self
            }
        }

        impl wkt::message::Message for SafetySetting {
            fn typename() -> &'static str {
                "type.googleapis.com/google.cloud.ces.v1.Guardrail.ModelSafety.SafetySetting"
            }
        }

        /// Harm category.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum HarmCategory {
            /// The harm category is unspecified.
            Unspecified,
            /// The harm category is hate speech.
            HateSpeech,
            /// The harm category is dangerous content.
            DangerousContent,
            /// The harm category is harassment.
            Harassment,
            /// The harm category is sexually explicit content.
            SexuallyExplicit,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [HarmCategory::value] or
            /// [HarmCategory::name].
            UnknownValue(harm_category::UnknownValue),
        }

        #[doc(hidden)]
        pub mod harm_category {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl HarmCategory {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::HateSpeech => std::option::Option::Some(1),
                    Self::DangerousContent => std::option::Option::Some(2),
                    Self::Harassment => std::option::Option::Some(3),
                    Self::SexuallyExplicit => std::option::Option::Some(4),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("HARM_CATEGORY_UNSPECIFIED"),
                    Self::HateSpeech => std::option::Option::Some("HARM_CATEGORY_HATE_SPEECH"),
                    Self::DangerousContent => {
                        std::option::Option::Some("HARM_CATEGORY_DANGEROUS_CONTENT")
                    }
                    Self::Harassment => std::option::Option::Some("HARM_CATEGORY_HARASSMENT"),
                    Self::SexuallyExplicit => {
                        std::option::Option::Some("HARM_CATEGORY_SEXUALLY_EXPLICIT")
                    }
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for HarmCategory {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for HarmCategory {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for HarmCategory {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::HateSpeech,
                    2 => Self::DangerousContent,
                    3 => Self::Harassment,
                    4 => Self::SexuallyExplicit,
                    _ => Self::UnknownValue(harm_category::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for HarmCategory {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "HARM_CATEGORY_UNSPECIFIED" => Self::Unspecified,
                    "HARM_CATEGORY_HATE_SPEECH" => Self::HateSpeech,
                    "HARM_CATEGORY_DANGEROUS_CONTENT" => Self::DangerousContent,
                    "HARM_CATEGORY_HARASSMENT" => Self::Harassment,
                    "HARM_CATEGORY_SEXUALLY_EXPLICIT" => Self::SexuallyExplicit,
                    _ => Self::UnknownValue(harm_category::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for HarmCategory {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::HateSpeech => serializer.serialize_i32(1),
                    Self::DangerousContent => serializer.serialize_i32(2),
                    Self::Harassment => serializer.serialize_i32(3),
                    Self::SexuallyExplicit => serializer.serialize_i32(4),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for HarmCategory {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<HarmCategory>::new(
                    ".google.cloud.ces.v1.Guardrail.ModelSafety.HarmCategory",
                ))
            }
        }

        /// Probability based thresholds levels for blocking.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum HarmBlockThreshold {
            /// Unspecified harm block threshold.
            Unspecified,
            /// Block low threshold and above (i.e. block more).
            BlockLowAndAbove,
            /// Block medium threshold and above.
            BlockMediumAndAbove,
            /// Block only high threshold (i.e. block less).
            BlockOnlyHigh,
            /// Block none.
            BlockNone,
            /// Turn off the safety filter.
            Off,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [HarmBlockThreshold::value] or
            /// [HarmBlockThreshold::name].
            UnknownValue(harm_block_threshold::UnknownValue),
        }

        #[doc(hidden)]
        pub mod harm_block_threshold {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl HarmBlockThreshold {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::BlockLowAndAbove => std::option::Option::Some(1),
                    Self::BlockMediumAndAbove => std::option::Option::Some(2),
                    Self::BlockOnlyHigh => std::option::Option::Some(3),
                    Self::BlockNone => std::option::Option::Some(4),
                    Self::Off => std::option::Option::Some(5),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => {
                        std::option::Option::Some("HARM_BLOCK_THRESHOLD_UNSPECIFIED")
                    }
                    Self::BlockLowAndAbove => std::option::Option::Some("BLOCK_LOW_AND_ABOVE"),
                    Self::BlockMediumAndAbove => {
                        std::option::Option::Some("BLOCK_MEDIUM_AND_ABOVE")
                    }
                    Self::BlockOnlyHigh => std::option::Option::Some("BLOCK_ONLY_HIGH"),
                    Self::BlockNone => std::option::Option::Some("BLOCK_NONE"),
                    Self::Off => std::option::Option::Some("OFF"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for HarmBlockThreshold {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for HarmBlockThreshold {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for HarmBlockThreshold {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::BlockLowAndAbove,
                    2 => Self::BlockMediumAndAbove,
                    3 => Self::BlockOnlyHigh,
                    4 => Self::BlockNone,
                    5 => Self::Off,
                    _ => Self::UnknownValue(harm_block_threshold::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for HarmBlockThreshold {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "HARM_BLOCK_THRESHOLD_UNSPECIFIED" => Self::Unspecified,
                    "BLOCK_LOW_AND_ABOVE" => Self::BlockLowAndAbove,
                    "BLOCK_MEDIUM_AND_ABOVE" => Self::BlockMediumAndAbove,
                    "BLOCK_ONLY_HIGH" => Self::BlockOnlyHigh,
                    "BLOCK_NONE" => Self::BlockNone,
                    "OFF" => Self::Off,
                    _ => Self::UnknownValue(harm_block_threshold::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for HarmBlockThreshold {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::BlockLowAndAbove => serializer.serialize_i32(1),
                    Self::BlockMediumAndAbove => serializer.serialize_i32(2),
                    Self::BlockOnlyHigh => serializer.serialize_i32(3),
                    Self::BlockNone => serializer.serialize_i32(4),
                    Self::Off => serializer.serialize_i32(5),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for HarmBlockThreshold {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<HarmBlockThreshold>::new(
                    ".google.cloud.ces.v1.Guardrail.ModelSafety.HarmBlockThreshold",
                ))
            }
        }
    }

    /// Guardrail that blocks the conversation based on the code callbacks
    /// provided.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct CodeCallback {
        /// 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.
        pub before_agent_callback: std::option::Option<crate::model::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.
        pub after_agent_callback: std::option::Option<crate::model::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.
        pub before_model_callback: std::option::Option<crate::model::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.
        pub after_model_callback: std::option::Option<crate::model::Callback>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl CodeCallback {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [before_agent_callback][crate::model::guardrail::CodeCallback::before_agent_callback].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::CodeCallback;
        /// use google_cloud_ces_v1::model::Callback;
        /// let x = CodeCallback::new().set_before_agent_callback(Callback::default()/* use setters */);
        /// ```
        pub fn set_before_agent_callback<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::Callback>,
        {
            self.before_agent_callback = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [before_agent_callback][crate::model::guardrail::CodeCallback::before_agent_callback].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::CodeCallback;
        /// use google_cloud_ces_v1::model::Callback;
        /// let x = CodeCallback::new().set_or_clear_before_agent_callback(Some(Callback::default()/* use setters */));
        /// let x = CodeCallback::new().set_or_clear_before_agent_callback(None::<Callback>);
        /// ```
        pub fn set_or_clear_before_agent_callback<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::Callback>,
        {
            self.before_agent_callback = v.map(|x| x.into());
            self
        }

        /// Sets the value of [after_agent_callback][crate::model::guardrail::CodeCallback::after_agent_callback].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::CodeCallback;
        /// use google_cloud_ces_v1::model::Callback;
        /// let x = CodeCallback::new().set_after_agent_callback(Callback::default()/* use setters */);
        /// ```
        pub fn set_after_agent_callback<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::Callback>,
        {
            self.after_agent_callback = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [after_agent_callback][crate::model::guardrail::CodeCallback::after_agent_callback].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::CodeCallback;
        /// use google_cloud_ces_v1::model::Callback;
        /// let x = CodeCallback::new().set_or_clear_after_agent_callback(Some(Callback::default()/* use setters */));
        /// let x = CodeCallback::new().set_or_clear_after_agent_callback(None::<Callback>);
        /// ```
        pub fn set_or_clear_after_agent_callback<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::Callback>,
        {
            self.after_agent_callback = v.map(|x| x.into());
            self
        }

        /// Sets the value of [before_model_callback][crate::model::guardrail::CodeCallback::before_model_callback].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::CodeCallback;
        /// use google_cloud_ces_v1::model::Callback;
        /// let x = CodeCallback::new().set_before_model_callback(Callback::default()/* use setters */);
        /// ```
        pub fn set_before_model_callback<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::Callback>,
        {
            self.before_model_callback = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [before_model_callback][crate::model::guardrail::CodeCallback::before_model_callback].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::CodeCallback;
        /// use google_cloud_ces_v1::model::Callback;
        /// let x = CodeCallback::new().set_or_clear_before_model_callback(Some(Callback::default()/* use setters */));
        /// let x = CodeCallback::new().set_or_clear_before_model_callback(None::<Callback>);
        /// ```
        pub fn set_or_clear_before_model_callback<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::Callback>,
        {
            self.before_model_callback = v.map(|x| x.into());
            self
        }

        /// Sets the value of [after_model_callback][crate::model::guardrail::CodeCallback::after_model_callback].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::CodeCallback;
        /// use google_cloud_ces_v1::model::Callback;
        /// let x = CodeCallback::new().set_after_model_callback(Callback::default()/* use setters */);
        /// ```
        pub fn set_after_model_callback<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::Callback>,
        {
            self.after_model_callback = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [after_model_callback][crate::model::guardrail::CodeCallback::after_model_callback].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::guardrail::CodeCallback;
        /// use google_cloud_ces_v1::model::Callback;
        /// let x = CodeCallback::new().set_or_clear_after_model_callback(Some(Callback::default()/* use setters */));
        /// let x = CodeCallback::new().set_or_clear_after_model_callback(None::<Callback>);
        /// ```
        pub fn set_or_clear_after_model_callback<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::Callback>,
        {
            self.after_model_callback = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for CodeCallback {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Guardrail.CodeCallback"
        }
    }

    /// Guardrail type.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum GuardrailType {
        /// Optional. Guardrail that bans certain content from being used in the
        /// conversation.
        ContentFilter(std::boxed::Box<crate::model::guardrail::ContentFilter>),
        /// Optional. Guardrail that blocks the conversation if the prompt is
        /// considered unsafe based on the LLM classification.
        LlmPromptSecurity(std::boxed::Box<crate::model::guardrail::LlmPromptSecurity>),
        /// Optional. Guardrail that blocks the conversation if the LLM response is
        /// considered violating the policy based on the LLM classification.
        LlmPolicy(std::boxed::Box<crate::model::guardrail::LlmPolicy>),
        /// Optional. Guardrail that blocks the conversation if the LLM response is
        /// considered unsafe based on the model safety settings.
        ModelSafety(std::boxed::Box<crate::model::guardrail::ModelSafety>),
        /// Optional. Guardrail that potentially blocks the conversation based on the
        /// result of the callback execution.
        CodeCallback(std::boxed::Box<crate::model::guardrail::CodeCallback>),
    }
}

/// An MCP tool.
/// See <https://modelcontextprotocol.io/specification/2025-06-18/server/tools> for
/// more details.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct McpTool {
    /// Required. The name of the MCP tool.
    pub name: std::string::String,

    /// Optional. The name override of the MCP tool.
    /// This is populated if the name was overridden by a Toolset override.
    pub name_override: std::string::String,

    /// Optional. The description of the MCP tool.
    pub description: std::string::String,

    /// Optional. The schema of the input arguments of the MCP tool.
    pub input_schema: std::option::Option<crate::model::Schema>,

    /// Optional. The schema of the output arguments of the MCP tool.
    pub output_schema: std::option::Option<crate::model::Schema>,

    /// Required. The server address of the MCP server, e.g.,
    /// `https://example.com/mcp/`. If the server is built with the MCP SDK, the
    /// url should be suffixed with
    /// "/mcp/". Only Streamable HTTP transport based servers are supported. This
    /// is the same as the server_address in the McpToolset. See
    /// <https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http>
    /// for more details.
    pub server_address: std::string::String,

    /// 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.
    pub api_authentication: std::option::Option<crate::model::ApiAuthentication>,

    /// Optional. The TLS configuration. Includes the custom server certificates
    /// that the client should trust.
    pub tls_config: std::option::Option<crate::model::TlsConfig>,

    /// Optional. Service Directory configuration for VPC-SC, used to resolve
    /// service names within a perimeter.
    pub service_directory_config: std::option::Option<crate::model::ServiceDirectoryConfig>,

    /// 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.
    pub custom_headers: std::collections::HashMap<std::string::String, std::string::String>,

    /// Output only. The dynamic availability state of the tool on the external
    /// server.
    pub state: crate::model::mcp_tool::State,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl McpTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::McpTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// let x = McpTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [name_override][crate::model::McpTool::name_override].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// let x = McpTool::new().set_name_override("example");
    /// ```
    pub fn set_name_override<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name_override = v.into();
        self
    }

    /// Sets the value of [description][crate::model::McpTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// let x = McpTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [input_schema][crate::model::McpTool::input_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = McpTool::new().set_input_schema(Schema::default()/* use setters */);
    /// ```
    pub fn set_input_schema<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.input_schema = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [input_schema][crate::model::McpTool::input_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = McpTool::new().set_or_clear_input_schema(Some(Schema::default()/* use setters */));
    /// let x = McpTool::new().set_or_clear_input_schema(None::<Schema>);
    /// ```
    pub fn set_or_clear_input_schema<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.input_schema = v.map(|x| x.into());
        self
    }

    /// Sets the value of [output_schema][crate::model::McpTool::output_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = McpTool::new().set_output_schema(Schema::default()/* use setters */);
    /// ```
    pub fn set_output_schema<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.output_schema = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [output_schema][crate::model::McpTool::output_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = McpTool::new().set_or_clear_output_schema(Some(Schema::default()/* use setters */));
    /// let x = McpTool::new().set_or_clear_output_schema(None::<Schema>);
    /// ```
    pub fn set_or_clear_output_schema<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.output_schema = v.map(|x| x.into());
        self
    }

    /// Sets the value of [server_address][crate::model::McpTool::server_address].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// let x = McpTool::new().set_server_address("example");
    /// ```
    pub fn set_server_address<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.server_address = v.into();
        self
    }

    /// Sets the value of [api_authentication][crate::model::McpTool::api_authentication].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::ApiAuthentication;
    /// let x = McpTool::new().set_api_authentication(ApiAuthentication::default()/* use setters */);
    /// ```
    pub fn set_api_authentication<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ApiAuthentication>,
    {
        self.api_authentication = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [api_authentication][crate::model::McpTool::api_authentication].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::ApiAuthentication;
    /// let x = McpTool::new().set_or_clear_api_authentication(Some(ApiAuthentication::default()/* use setters */));
    /// let x = McpTool::new().set_or_clear_api_authentication(None::<ApiAuthentication>);
    /// ```
    pub fn set_or_clear_api_authentication<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ApiAuthentication>,
    {
        self.api_authentication = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tls_config][crate::model::McpTool::tls_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::TlsConfig;
    /// let x = McpTool::new().set_tls_config(TlsConfig::default()/* use setters */);
    /// ```
    pub fn set_tls_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TlsConfig>,
    {
        self.tls_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [tls_config][crate::model::McpTool::tls_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::TlsConfig;
    /// let x = McpTool::new().set_or_clear_tls_config(Some(TlsConfig::default()/* use setters */));
    /// let x = McpTool::new().set_or_clear_tls_config(None::<TlsConfig>);
    /// ```
    pub fn set_or_clear_tls_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TlsConfig>,
    {
        self.tls_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [service_directory_config][crate::model::McpTool::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = McpTool::new().set_service_directory_config(ServiceDirectoryConfig::default()/* use setters */);
    /// ```
    pub fn set_service_directory_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [service_directory_config][crate::model::McpTool::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = McpTool::new().set_or_clear_service_directory_config(Some(ServiceDirectoryConfig::default()/* use setters */));
    /// let x = McpTool::new().set_or_clear_service_directory_config(None::<ServiceDirectoryConfig>);
    /// ```
    pub fn set_or_clear_service_directory_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [custom_headers][crate::model::McpTool::custom_headers].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// let x = McpTool::new().set_custom_headers([
    ///     ("key0", "abc"),
    ///     ("key1", "xyz"),
    /// ]);
    /// ```
    pub fn set_custom_headers<T, K, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = (K, V)>,
        K: std::convert::Into<std::string::String>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.custom_headers = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
        self
    }

    /// Sets the value of [state][crate::model::McpTool::state].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpTool;
    /// use google_cloud_ces_v1::model::mcp_tool::State;
    /// let x0 = McpTool::new().set_state(State::Active);
    /// let x1 = McpTool::new().set_state(State::Inactive);
    /// let x2 = McpTool::new().set_state(State::Stale);
    /// ```
    pub fn set_state<T: std::convert::Into<crate::model::mcp_tool::State>>(mut self, v: T) -> Self {
        self.state = v.into();
        self
    }
}

impl wkt::message::Message for McpTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.McpTool"
    }
}

/// Defines additional types related to [McpTool].
pub mod mcp_tool {
    #[allow(unused_imports)]
    use super::*;

    /// Represents the dynamic availability state of the tool.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum State {
        /// Default state.
        Unspecified,
        /// The tool is available and actively offered by the server.
        Active,
        /// The tool is configured or pinned, but currently not offered by the
        /// server.
        Inactive,
        /// The tool exists on the server, but does not match the version on the
        /// server.
        Stale,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [State::value] or
        /// [State::name].
        UnknownValue(state::UnknownValue),
    }

    #[doc(hidden)]
    pub mod state {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl State {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Active => std::option::Option::Some(1),
                Self::Inactive => std::option::Option::Some(2),
                Self::Stale => std::option::Option::Some(3),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("STATE_UNSPECIFIED"),
                Self::Active => std::option::Option::Some("ACTIVE"),
                Self::Inactive => std::option::Option::Some("INACTIVE"),
                Self::Stale => std::option::Option::Some("STALE"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for State {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for State {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for State {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Active,
                2 => Self::Inactive,
                3 => Self::Stale,
                _ => Self::UnknownValue(state::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for State {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "STATE_UNSPECIFIED" => Self::Unspecified,
                "ACTIVE" => Self::Active,
                "INACTIVE" => Self::Inactive,
                "STALE" => Self::Stale,
                _ => Self::UnknownValue(state::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for State {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Active => serializer.serialize_i32(1),
                Self::Inactive => serializer.serialize_i32(2),
                Self::Stale => serializer.serialize_i32(3),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for State {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<State>::new(
                ".google.cloud.ces.v1.McpTool.State",
            ))
        }
    }
}

/// A toolset that contains a list of tools that are offered by the MCP
/// server.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct McpToolset {
    /// 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.
    pub server_address: std::string::String,

    /// 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.
    pub api_authentication: std::option::Option<crate::model::ApiAuthentication>,

    /// Optional. Service Directory configuration for VPC-SC, used to resolve
    /// service names within a perimeter.
    pub service_directory_config: std::option::Option<crate::model::ServiceDirectoryConfig>,

    /// Optional. The TLS configuration. Includes the custom server certificates
    /// that the client should trust.
    pub tls_config: std::option::Option<crate::model::TlsConfig>,

    /// 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.
    pub custom_headers: std::collections::HashMap<std::string::String, std::string::String>,

    /// 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.
    pub tool_overrides: std::vec::Vec<crate::model::McpToolOverride>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl McpToolset {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [server_address][crate::model::McpToolset::server_address].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolset;
    /// let x = McpToolset::new().set_server_address("example");
    /// ```
    pub fn set_server_address<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.server_address = v.into();
        self
    }

    /// Sets the value of [api_authentication][crate::model::McpToolset::api_authentication].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolset;
    /// use google_cloud_ces_v1::model::ApiAuthentication;
    /// let x = McpToolset::new().set_api_authentication(ApiAuthentication::default()/* use setters */);
    /// ```
    pub fn set_api_authentication<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ApiAuthentication>,
    {
        self.api_authentication = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [api_authentication][crate::model::McpToolset::api_authentication].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolset;
    /// use google_cloud_ces_v1::model::ApiAuthentication;
    /// let x = McpToolset::new().set_or_clear_api_authentication(Some(ApiAuthentication::default()/* use setters */));
    /// let x = McpToolset::new().set_or_clear_api_authentication(None::<ApiAuthentication>);
    /// ```
    pub fn set_or_clear_api_authentication<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ApiAuthentication>,
    {
        self.api_authentication = v.map(|x| x.into());
        self
    }

    /// Sets the value of [service_directory_config][crate::model::McpToolset::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolset;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = McpToolset::new().set_service_directory_config(ServiceDirectoryConfig::default()/* use setters */);
    /// ```
    pub fn set_service_directory_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [service_directory_config][crate::model::McpToolset::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolset;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = McpToolset::new().set_or_clear_service_directory_config(Some(ServiceDirectoryConfig::default()/* use setters */));
    /// let x = McpToolset::new().set_or_clear_service_directory_config(None::<ServiceDirectoryConfig>);
    /// ```
    pub fn set_or_clear_service_directory_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tls_config][crate::model::McpToolset::tls_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolset;
    /// use google_cloud_ces_v1::model::TlsConfig;
    /// let x = McpToolset::new().set_tls_config(TlsConfig::default()/* use setters */);
    /// ```
    pub fn set_tls_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TlsConfig>,
    {
        self.tls_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [tls_config][crate::model::McpToolset::tls_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolset;
    /// use google_cloud_ces_v1::model::TlsConfig;
    /// let x = McpToolset::new().set_or_clear_tls_config(Some(TlsConfig::default()/* use setters */));
    /// let x = McpToolset::new().set_or_clear_tls_config(None::<TlsConfig>);
    /// ```
    pub fn set_or_clear_tls_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TlsConfig>,
    {
        self.tls_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [custom_headers][crate::model::McpToolset::custom_headers].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolset;
    /// let x = McpToolset::new().set_custom_headers([
    ///     ("key0", "abc"),
    ///     ("key1", "xyz"),
    /// ]);
    /// ```
    pub fn set_custom_headers<T, K, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = (K, V)>,
        K: std::convert::Into<std::string::String>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.custom_headers = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
        self
    }

    /// Sets the value of [tool_overrides][crate::model::McpToolset::tool_overrides].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolset;
    /// use google_cloud_ces_v1::model::McpToolOverride;
    /// let x = McpToolset::new()
    ///     .set_tool_overrides([
    ///         McpToolOverride::default()/* use setters */,
    ///         McpToolOverride::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_tool_overrides<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::McpToolOverride>,
    {
        use std::iter::Iterator;
        self.tool_overrides = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for McpToolset {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.McpToolset"
    }
}

/// Overrides associated with a given tool in a Toolset.
/// This enables "pinning" or "overriding" of tool definitions from the external
/// dynamic server.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct McpToolOverride {
    /// Required. The original name of the tool as it is emitted by the MCP server.
    pub tool: std::string::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.
    pub name_override: std::string::String,

    /// Optional. If present, this tool uses this description instead of the
    /// original description from the server.
    pub description_override: std::string::String,

    /// 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.
    pub snapshot: std::option::Option<crate::model::McpToolDefinition>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl McpToolOverride {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [tool][crate::model::McpToolOverride::tool].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolOverride;
    /// let x = McpToolOverride::new().set_tool("example");
    /// ```
    pub fn set_tool<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool = v.into();
        self
    }

    /// Sets the value of [name_override][crate::model::McpToolOverride::name_override].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolOverride;
    /// let x = McpToolOverride::new().set_name_override("example");
    /// ```
    pub fn set_name_override<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name_override = v.into();
        self
    }

    /// Sets the value of [description_override][crate::model::McpToolOverride::description_override].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolOverride;
    /// let x = McpToolOverride::new().set_description_override("example");
    /// ```
    pub fn set_description_override<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.description_override = v.into();
        self
    }

    /// Sets the value of [snapshot][crate::model::McpToolOverride::snapshot].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolOverride;
    /// use google_cloud_ces_v1::model::McpToolDefinition;
    /// let x = McpToolOverride::new().set_snapshot(McpToolDefinition::default()/* use setters */);
    /// ```
    pub fn set_snapshot<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::McpToolDefinition>,
    {
        self.snapshot = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [snapshot][crate::model::McpToolOverride::snapshot].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolOverride;
    /// use google_cloud_ces_v1::model::McpToolDefinition;
    /// let x = McpToolOverride::new().set_or_clear_snapshot(Some(McpToolDefinition::default()/* use setters */));
    /// let x = McpToolOverride::new().set_or_clear_snapshot(None::<McpToolDefinition>);
    /// ```
    pub fn set_or_clear_snapshot<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::McpToolDefinition>,
    {
        self.snapshot = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for McpToolOverride {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.McpToolOverride"
    }
}

/// Container for a tool's core definition elements that are snapshot.
/// Schemas in the snapshot are used as-is and cannot be overridden.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct McpToolDefinition {
    /// Output only. The description of the MCP tool. This can be overridden
    /// by `description_override` in `McpToolOverride`.
    pub description: std::string::String,

    /// Output only. The schema of the input arguments of the MCP tool.
    pub input_schema: std::option::Option<crate::model::Schema>,

    /// Output only. The schema of the output arguments of the MCP tool.
    pub output_schema: std::option::Option<crate::model::Schema>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl McpToolDefinition {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [description][crate::model::McpToolDefinition::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolDefinition;
    /// let x = McpToolDefinition::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [input_schema][crate::model::McpToolDefinition::input_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolDefinition;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = McpToolDefinition::new().set_input_schema(Schema::default()/* use setters */);
    /// ```
    pub fn set_input_schema<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.input_schema = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [input_schema][crate::model::McpToolDefinition::input_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolDefinition;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = McpToolDefinition::new().set_or_clear_input_schema(Some(Schema::default()/* use setters */));
    /// let x = McpToolDefinition::new().set_or_clear_input_schema(None::<Schema>);
    /// ```
    pub fn set_or_clear_input_schema<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.input_schema = v.map(|x| x.into());
        self
    }

    /// Sets the value of [output_schema][crate::model::McpToolDefinition::output_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolDefinition;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = McpToolDefinition::new().set_output_schema(Schema::default()/* use setters */);
    /// ```
    pub fn set_output_schema<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.output_schema = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [output_schema][crate::model::McpToolDefinition::output_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::McpToolDefinition;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = McpToolDefinition::new().set_or_clear_output_schema(Some(Schema::default()/* use setters */));
    /// let x = McpToolDefinition::new().set_or_clear_output_schema(None::<Schema>);
    /// ```
    pub fn set_or_clear_output_schema<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.output_schema = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for McpToolDefinition {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.McpToolDefinition"
    }
}

/// 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.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct MockedToolCall {
    /// Optional. Deprecated. Use tool_identifier instead.
    #[deprecated]
    pub tool: std::string::String,

    /// 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.
    pub expected_args_pattern: std::option::Option<wkt::Struct>,

    /// Optional. The mock response / output to return if the tool call args /
    /// inputs match the pattern.
    pub mock_response: std::option::Option<wkt::Struct>,

    /// The identifier of the tool to mock.
    pub tool_identifier: std::option::Option<crate::model::mocked_tool_call::ToolIdentifier>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl MockedToolCall {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [tool][crate::model::MockedToolCall::tool].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockedToolCall;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = MockedToolCall::new().set_tool(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// ```
    #[deprecated]
    pub fn set_tool<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool = v.into();
        self
    }

    /// Sets the value of [expected_args_pattern][crate::model::MockedToolCall::expected_args_pattern].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockedToolCall;
    /// use wkt::Struct;
    /// let x = MockedToolCall::new().set_expected_args_pattern(Struct::default()/* use setters */);
    /// ```
    pub fn set_expected_args_pattern<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.expected_args_pattern = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [expected_args_pattern][crate::model::MockedToolCall::expected_args_pattern].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockedToolCall;
    /// use wkt::Struct;
    /// let x = MockedToolCall::new().set_or_clear_expected_args_pattern(Some(Struct::default()/* use setters */));
    /// let x = MockedToolCall::new().set_or_clear_expected_args_pattern(None::<Struct>);
    /// ```
    pub fn set_or_clear_expected_args_pattern<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.expected_args_pattern = v.map(|x| x.into());
        self
    }

    /// Sets the value of [mock_response][crate::model::MockedToolCall::mock_response].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockedToolCall;
    /// use wkt::Struct;
    /// let x = MockedToolCall::new().set_mock_response(Struct::default()/* use setters */);
    /// ```
    pub fn set_mock_response<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.mock_response = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [mock_response][crate::model::MockedToolCall::mock_response].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockedToolCall;
    /// use wkt::Struct;
    /// let x = MockedToolCall::new().set_or_clear_mock_response(Some(Struct::default()/* use setters */));
    /// let x = MockedToolCall::new().set_or_clear_mock_response(None::<Struct>);
    /// ```
    pub fn set_or_clear_mock_response<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.mock_response = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tool_identifier][crate::model::MockedToolCall::tool_identifier].
    ///
    /// Note that all the setters affecting `tool_identifier` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockedToolCall;
    /// use google_cloud_ces_v1::model::mocked_tool_call::ToolIdentifier;
    /// let x = MockedToolCall::new().set_tool_identifier(Some(ToolIdentifier::ToolId("example".to_string())));
    /// ```
    pub fn set_tool_identifier<
        T: std::convert::Into<std::option::Option<crate::model::mocked_tool_call::ToolIdentifier>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = v.into();
        self
    }

    /// The value of [tool_identifier][crate::model::MockedToolCall::tool_identifier]
    /// if it holds a `ToolId`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool_id(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::mocked_tool_call::ToolIdentifier::ToolId(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::MockedToolCall::tool_identifier]
    /// to hold a `ToolId`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockedToolCall;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = MockedToolCall::new().set_tool_id(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// assert!(x.tool_id().is_some());
    /// assert!(x.toolset().is_none());
    /// ```
    pub fn set_tool_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::mocked_tool_call::ToolIdentifier::ToolId(v.into()),
        );
        self
    }

    /// The value of [tool_identifier][crate::model::MockedToolCall::tool_identifier]
    /// if it holds a `Toolset`, `None` if the field is not set or
    /// holds a different branch.
    pub fn toolset(&self) -> std::option::Option<&std::boxed::Box<crate::model::ToolsetTool>> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::mocked_tool_call::ToolIdentifier::Toolset(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::MockedToolCall::tool_identifier]
    /// to hold a `Toolset`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockedToolCall;
    /// use google_cloud_ces_v1::model::ToolsetTool;
    /// let x = MockedToolCall::new().set_toolset(ToolsetTool::default()/* use setters */);
    /// assert!(x.toolset().is_some());
    /// assert!(x.tool_id().is_none());
    /// ```
    pub fn set_toolset<T: std::convert::Into<std::boxed::Box<crate::model::ToolsetTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::mocked_tool_call::ToolIdentifier::Toolset(v.into()),
        );
        self
    }
}

impl wkt::message::Message for MockedToolCall {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.MockedToolCall"
    }
}

/// Defines additional types related to [MockedToolCall].
pub mod mocked_tool_call {
    #[allow(unused_imports)]
    use super::*;

    /// The identifier of the tool to mock.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolIdentifier {
        /// Optional. The name of the tool to mock.
        /// Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
        ToolId(std::string::String),
        /// Optional. The toolset to mock.
        Toolset(std::boxed::Box<crate::model::ToolsetTool>),
    }
}

/// Represents an Omnichannel resource.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Omnichannel {
    /// Identifier. The unique identifier of the omnichannel resource.
    /// Format:
    /// `projects/{project}/locations/{location}/omnichannels/{omnichannel}`
    pub name: std::string::String,

    /// Required. Display name of the omnichannel resource.
    pub display_name: std::string::String,

    /// Optional. Human-readable description of the omnichannel resource.
    pub description: std::string::String,

    /// Output only. Timestamp when the omnichannel resource was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Timestamp when the omnichannel resource was last updated.
    pub update_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Etag used to ensure the object hasn't changed during a
    /// read-modify-write operation.
    pub etag: std::string::String,

    /// Optional. The integration config for the omnichannel resource.
    pub integration_config: std::option::Option<crate::model::OmnichannelIntegrationConfig>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Omnichannel {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Omnichannel::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let omnichannel_id = "omnichannel_id";
    /// let x = Omnichannel::new().set_name(format!("projects/{project_id}/locations/{location_id}/omnichannels/{omnichannel_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::Omnichannel::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// let x = Omnichannel::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::Omnichannel::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// let x = Omnichannel::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [create_time][crate::model::Omnichannel::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// use wkt::Timestamp;
    /// let x = Omnichannel::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::Omnichannel::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// use wkt::Timestamp;
    /// let x = Omnichannel::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = Omnichannel::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::Omnichannel::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// use wkt::Timestamp;
    /// let x = Omnichannel::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::Omnichannel::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// use wkt::Timestamp;
    /// let x = Omnichannel::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = Omnichannel::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [etag][crate::model::Omnichannel::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// let x = Omnichannel::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }

    /// Sets the value of [integration_config][crate::model::Omnichannel::integration_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// use google_cloud_ces_v1::model::OmnichannelIntegrationConfig;
    /// let x = Omnichannel::new().set_integration_config(OmnichannelIntegrationConfig::default()/* use setters */);
    /// ```
    pub fn set_integration_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::OmnichannelIntegrationConfig>,
    {
        self.integration_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [integration_config][crate::model::Omnichannel::integration_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Omnichannel;
    /// use google_cloud_ces_v1::model::OmnichannelIntegrationConfig;
    /// let x = Omnichannel::new().set_or_clear_integration_config(Some(OmnichannelIntegrationConfig::default()/* use setters */));
    /// let x = Omnichannel::new().set_or_clear_integration_config(None::<OmnichannelIntegrationConfig>);
    /// ```
    pub fn set_or_clear_integration_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::OmnichannelIntegrationConfig>,
    {
        self.integration_config = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for Omnichannel {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Omnichannel"
    }
}

/// OmnichannelIntegrationConfig contains all App integration configs.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct OmnichannelIntegrationConfig {
    /// Optional. Various of configuration for handling App events.
    pub channel_configs: std::collections::HashMap<
        std::string::String,
        crate::model::omnichannel_integration_config::ChannelConfig,
    >,

    /// Optional. Various of subscribers configs.
    pub subscriber_configs: std::collections::HashMap<
        std::string::String,
        crate::model::omnichannel_integration_config::SubscriberConfig,
    >,

    /// Optional. The key of routing_configs is a key of `app_configs`, value is a
    /// `RoutingConfig`, which contains subscriber's key.
    pub routing_configs: std::collections::HashMap<
        std::string::String,
        crate::model::omnichannel_integration_config::RoutingConfig,
    >,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl OmnichannelIntegrationConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [channel_configs][crate::model::OmnichannelIntegrationConfig::channel_configs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OmnichannelIntegrationConfig;
    /// use google_cloud_ces_v1::model::omnichannel_integration_config::ChannelConfig;
    /// let x = OmnichannelIntegrationConfig::new().set_channel_configs([
    ///     ("key0", ChannelConfig::default()/* use setters */),
    ///     ("key1", ChannelConfig::default()/* use (different) setters */),
    /// ]);
    /// ```
    pub fn set_channel_configs<T, K, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = (K, V)>,
        K: std::convert::Into<std::string::String>,
        V: std::convert::Into<crate::model::omnichannel_integration_config::ChannelConfig>,
    {
        use std::iter::Iterator;
        self.channel_configs = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
        self
    }

    /// Sets the value of [subscriber_configs][crate::model::OmnichannelIntegrationConfig::subscriber_configs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OmnichannelIntegrationConfig;
    /// use google_cloud_ces_v1::model::omnichannel_integration_config::SubscriberConfig;
    /// let x = OmnichannelIntegrationConfig::new().set_subscriber_configs([
    ///     ("key0", SubscriberConfig::default()/* use setters */),
    ///     ("key1", SubscriberConfig::default()/* use (different) setters */),
    /// ]);
    /// ```
    pub fn set_subscriber_configs<T, K, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = (K, V)>,
        K: std::convert::Into<std::string::String>,
        V: std::convert::Into<crate::model::omnichannel_integration_config::SubscriberConfig>,
    {
        use std::iter::Iterator;
        self.subscriber_configs = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
        self
    }

    /// Sets the value of [routing_configs][crate::model::OmnichannelIntegrationConfig::routing_configs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OmnichannelIntegrationConfig;
    /// use google_cloud_ces_v1::model::omnichannel_integration_config::RoutingConfig;
    /// let x = OmnichannelIntegrationConfig::new().set_routing_configs([
    ///     ("key0", RoutingConfig::default()/* use setters */),
    ///     ("key1", RoutingConfig::default()/* use (different) setters */),
    /// ]);
    /// ```
    pub fn set_routing_configs<T, K, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = (K, V)>,
        K: std::convert::Into<std::string::String>,
        V: std::convert::Into<crate::model::omnichannel_integration_config::RoutingConfig>,
    {
        use std::iter::Iterator;
        self.routing_configs = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
        self
    }
}

impl wkt::message::Message for OmnichannelIntegrationConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.OmnichannelIntegrationConfig"
    }
}

/// Defines additional types related to [OmnichannelIntegrationConfig].
pub mod omnichannel_integration_config {
    #[allow(unused_imports)]
    use super::*;

    /// ChannelConfig contains config for various of app integration.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct ChannelConfig {
        /// The config for the app.
        pub channel_config: std::option::Option<
            crate::model::omnichannel_integration_config::channel_config::ChannelConfig,
        >,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl ChannelConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [channel_config][crate::model::omnichannel_integration_config::ChannelConfig::channel_config].
        ///
        /// Note that all the setters affecting `channel_config` are mutually
        /// exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::ChannelConfig;
        /// use google_cloud_ces_v1::model::omnichannel_integration_config::WhatsappConfig;
        /// let x = ChannelConfig::new().set_channel_config(Some(
        ///     google_cloud_ces_v1::model::omnichannel_integration_config::channel_config::ChannelConfig::WhatsappConfig(WhatsappConfig::default().into())));
        /// ```
        pub fn set_channel_config<
            T: std::convert::Into<
                    std::option::Option<
                        crate::model::omnichannel_integration_config::channel_config::ChannelConfig,
                    >,
                >,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.channel_config = v.into();
            self
        }

        /// The value of [channel_config][crate::model::omnichannel_integration_config::ChannelConfig::channel_config]
        /// if it holds a `WhatsappConfig`, `None` if the field is not set or
        /// holds a different branch.
        pub fn whatsapp_config(
            &self,
        ) -> std::option::Option<
            &std::boxed::Box<crate::model::omnichannel_integration_config::WhatsappConfig>,
        > {
            #[allow(unreachable_patterns)]
            self.channel_config.as_ref().and_then(|v| match v {
                crate::model::omnichannel_integration_config::channel_config::ChannelConfig::WhatsappConfig(v) => std::option::Option::Some(v),
                _ => std::option::Option::None,
            })
        }

        /// Sets the value of [channel_config][crate::model::omnichannel_integration_config::ChannelConfig::channel_config]
        /// to hold a `WhatsappConfig`.
        ///
        /// Note that all the setters affecting `channel_config` are
        /// mutually exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::ChannelConfig;
        /// use google_cloud_ces_v1::model::omnichannel_integration_config::WhatsappConfig;
        /// let x = ChannelConfig::new().set_whatsapp_config(WhatsappConfig::default()/* use setters */);
        /// assert!(x.whatsapp_config().is_some());
        /// ```
        pub fn set_whatsapp_config<
            T: std::convert::Into<
                    std::boxed::Box<crate::model::omnichannel_integration_config::WhatsappConfig>,
                >,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.channel_config = std::option::Option::Some(
                crate::model::omnichannel_integration_config::channel_config::ChannelConfig::WhatsappConfig(
                    v.into()
                )
            );
            self
        }
    }

    impl wkt::message::Message for ChannelConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.OmnichannelIntegrationConfig.ChannelConfig"
        }
    }

    /// Defines additional types related to [ChannelConfig].
    pub mod channel_config {
        #[allow(unused_imports)]
        use super::*;

        /// The config for the app.
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum ChannelConfig {
            /// WhatsApp config.
            WhatsappConfig(
                std::boxed::Box<crate::model::omnichannel_integration_config::WhatsappConfig>,
            ),
        }
    }

    /// How Omnichannel should receive/reply events from WhatsApp.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct WhatsappConfig {
        /// The Phone Number ID associated with the WhatsApp Business Account.
        pub phone_number_id: std::string::String,

        /// The phone number used for sending/receiving messages.
        pub phone_number: std::string::String,

        /// The customer's WhatsApp Business Account (WABA) ID.
        pub whatsapp_business_account_id: std::string::String,

        /// The verify token configured in the Meta App Dashboard for webhook
        /// verification.
        pub webhook_verify_token: std::string::String,

        /// The access token for authenticating API calls to the WhatsApp Cloud API.
        /// <https://developers.facebook.com/docs/whatsapp/business-management-api/get-started/#business-integration-system-user-access-tokens>
        pub whatsapp_business_token: std::string::String,

        /// The Meta Business Portfolio (MBP) ID.
        /// <https://www.facebook.com/business/help/1710077379203657>
        pub meta_business_portfolio_id: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl WhatsappConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [phone_number_id][crate::model::omnichannel_integration_config::WhatsappConfig::phone_number_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::WhatsappConfig;
        /// let x = WhatsappConfig::new().set_phone_number_id("example");
        /// ```
        pub fn set_phone_number_id<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.phone_number_id = v.into();
            self
        }

        /// Sets the value of [phone_number][crate::model::omnichannel_integration_config::WhatsappConfig::phone_number].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::WhatsappConfig;
        /// let x = WhatsappConfig::new().set_phone_number("example");
        /// ```
        pub fn set_phone_number<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.phone_number = v.into();
            self
        }

        /// Sets the value of [whatsapp_business_account_id][crate::model::omnichannel_integration_config::WhatsappConfig::whatsapp_business_account_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::WhatsappConfig;
        /// let x = WhatsappConfig::new().set_whatsapp_business_account_id("example");
        /// ```
        pub fn set_whatsapp_business_account_id<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.whatsapp_business_account_id = v.into();
            self
        }

        /// Sets the value of [webhook_verify_token][crate::model::omnichannel_integration_config::WhatsappConfig::webhook_verify_token].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::WhatsappConfig;
        /// let x = WhatsappConfig::new().set_webhook_verify_token("example");
        /// ```
        pub fn set_webhook_verify_token<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.webhook_verify_token = v.into();
            self
        }

        /// Sets the value of [whatsapp_business_token][crate::model::omnichannel_integration_config::WhatsappConfig::whatsapp_business_token].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::WhatsappConfig;
        /// let x = WhatsappConfig::new().set_whatsapp_business_token("example");
        /// ```
        pub fn set_whatsapp_business_token<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.whatsapp_business_token = v.into();
            self
        }

        /// Sets the value of [meta_business_portfolio_id][crate::model::omnichannel_integration_config::WhatsappConfig::meta_business_portfolio_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::WhatsappConfig;
        /// let x = WhatsappConfig::new().set_meta_business_portfolio_id("example");
        /// ```
        pub fn set_meta_business_portfolio_id<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.meta_business_portfolio_id = v.into();
            self
        }
    }

    impl wkt::message::Message for WhatsappConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.OmnichannelIntegrationConfig.WhatsappConfig"
        }
    }

    /// Configs of subscribers.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct SubscriberConfig {
        /// The config for the subscriber.
        pub subscriber_config: std::option::Option<
            crate::model::omnichannel_integration_config::subscriber_config::SubscriberConfig,
        >,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl SubscriberConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [subscriber_config][crate::model::omnichannel_integration_config::SubscriberConfig::subscriber_config].
        ///
        /// Note that all the setters affecting `subscriber_config` are mutually
        /// exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::SubscriberConfig;
        /// use google_cloud_ces_v1::model::omnichannel_integration_config::CesAppConfig;
        /// let x = SubscriberConfig::new().set_subscriber_config(Some(
        ///     google_cloud_ces_v1::model::omnichannel_integration_config::subscriber_config::SubscriberConfig::CesAppConfig(CesAppConfig::default().into())));
        /// ```
        pub fn set_subscriber_config<T: std::convert::Into<std::option::Option<crate::model::omnichannel_integration_config::subscriber_config::SubscriberConfig>>>(mut self, v: T) -> Self
        {
            self.subscriber_config = v.into();
            self
        }

        /// The value of [subscriber_config][crate::model::omnichannel_integration_config::SubscriberConfig::subscriber_config]
        /// if it holds a `CesAppConfig`, `None` if the field is not set or
        /// holds a different branch.
        pub fn ces_app_config(
            &self,
        ) -> std::option::Option<
            &std::boxed::Box<crate::model::omnichannel_integration_config::CesAppConfig>,
        > {
            #[allow(unreachable_patterns)]
            self.subscriber_config.as_ref().and_then(|v| match v {
                crate::model::omnichannel_integration_config::subscriber_config::SubscriberConfig::CesAppConfig(v) => std::option::Option::Some(v),
                _ => std::option::Option::None,
            })
        }

        /// Sets the value of [subscriber_config][crate::model::omnichannel_integration_config::SubscriberConfig::subscriber_config]
        /// to hold a `CesAppConfig`.
        ///
        /// Note that all the setters affecting `subscriber_config` are
        /// mutually exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::SubscriberConfig;
        /// use google_cloud_ces_v1::model::omnichannel_integration_config::CesAppConfig;
        /// let x = SubscriberConfig::new().set_ces_app_config(CesAppConfig::default()/* use setters */);
        /// assert!(x.ces_app_config().is_some());
        /// ```
        pub fn set_ces_app_config<
            T: std::convert::Into<
                    std::boxed::Box<crate::model::omnichannel_integration_config::CesAppConfig>,
                >,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.subscriber_config = std::option::Option::Some(
                crate::model::omnichannel_integration_config::subscriber_config::SubscriberConfig::CesAppConfig(
                    v.into()
                )
            );
            self
        }
    }

    impl wkt::message::Message for SubscriberConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.OmnichannelIntegrationConfig.SubscriberConfig"
        }
    }

    /// Defines additional types related to [SubscriberConfig].
    pub mod subscriber_config {
        #[allow(unused_imports)]
        use super::*;

        /// The config for the subscriber.
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum SubscriberConfig {
            /// Ces app config.
            CesAppConfig(
                std::boxed::Box<crate::model::omnichannel_integration_config::CesAppConfig>,
            ),
        }
    }

    /// Configs for CES app.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct CesAppConfig {
        /// The unique identifier of the CES app.
        /// Format: `projects/{project}/locations/{location}/apps/{app}`
        pub app: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl CesAppConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [app][crate::model::omnichannel_integration_config::CesAppConfig::app].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::CesAppConfig;
        /// # let project_id = "project_id";
        /// # let location_id = "location_id";
        /// # let app_id = "app_id";
        /// let x = CesAppConfig::new().set_app(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
        /// ```
        pub fn set_app<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.app = v.into();
            self
        }
    }

    impl wkt::message::Message for CesAppConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.OmnichannelIntegrationConfig.CesAppConfig"
        }
    }

    /// Routing config specify how/who to route app events to a subscriber.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct RoutingConfig {
        /// The key of the subscriber.
        pub subscriber_key: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl RoutingConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [subscriber_key][crate::model::omnichannel_integration_config::RoutingConfig::subscriber_key].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::omnichannel_integration_config::RoutingConfig;
        /// let x = RoutingConfig::new().set_subscriber_key("example");
        /// ```
        pub fn set_subscriber_key<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.subscriber_key = v.into();
            self
        }
    }

    impl wkt::message::Message for RoutingConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.OmnichannelIntegrationConfig.RoutingConfig"
        }
    }
}

/// Represents the metadata of the long-running operation.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct OmnichannelOperationMetadata {
    /// Output only. The time the operation was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. The time the operation finished running.
    pub end_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Human-readable status of the operation, if any.
    pub status_message: std::string::String,

    /// Output only. Identifies whether the user has requested cancellation of the
    /// operation.
    pub requested_cancellation: bool,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl OmnichannelOperationMetadata {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [create_time][crate::model::OmnichannelOperationMetadata::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OmnichannelOperationMetadata;
    /// use wkt::Timestamp;
    /// let x = OmnichannelOperationMetadata::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::OmnichannelOperationMetadata::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OmnichannelOperationMetadata;
    /// use wkt::Timestamp;
    /// let x = OmnichannelOperationMetadata::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = OmnichannelOperationMetadata::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [end_time][crate::model::OmnichannelOperationMetadata::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OmnichannelOperationMetadata;
    /// use wkt::Timestamp;
    /// let x = OmnichannelOperationMetadata::new().set_end_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_end_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [end_time][crate::model::OmnichannelOperationMetadata::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OmnichannelOperationMetadata;
    /// use wkt::Timestamp;
    /// let x = OmnichannelOperationMetadata::new().set_or_clear_end_time(Some(Timestamp::default()/* use setters */));
    /// let x = OmnichannelOperationMetadata::new().set_or_clear_end_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_end_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [status_message][crate::model::OmnichannelOperationMetadata::status_message].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OmnichannelOperationMetadata;
    /// let x = OmnichannelOperationMetadata::new().set_status_message("example");
    /// ```
    pub fn set_status_message<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.status_message = v.into();
        self
    }

    /// Sets the value of [requested_cancellation][crate::model::OmnichannelOperationMetadata::requested_cancellation].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OmnichannelOperationMetadata;
    /// let x = OmnichannelOperationMetadata::new().set_requested_cancellation(true);
    /// ```
    pub fn set_requested_cancellation<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.requested_cancellation = v.into();
        self
    }
}

impl wkt::message::Message for OmnichannelOperationMetadata {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.OmnichannelOperationMetadata"
    }
}

/// A remote API tool defined by an OpenAPI schema.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct OpenApiTool {
    /// Required. The OpenAPI schema in JSON or YAML format.
    pub open_api_schema: std::string::String,

    /// Optional. The name of the tool. If not provided, the name of the tool will
    /// be derived from the OpenAPI schema, from `operation.operationId`.
    pub name: std::string::String,

    /// Optional. The description of the tool. If not provided, the description of
    /// the tool will be derived from the OpenAPI schema, from
    /// `operation.description` or `operation.summary`.
    pub description: std::string::String,

    /// Optional. Authentication information required by the API.
    pub api_authentication: std::option::Option<crate::model::ApiAuthentication>,

    /// Optional. The TLS configuration. Includes the custom server certificates
    /// that the client will trust.
    pub tls_config: std::option::Option<crate::model::TlsConfig>,

    /// Optional. Service Directory configuration.
    pub service_directory_config: std::option::Option<crate::model::ServiceDirectoryConfig>,

    /// Optional. If true, the agent will ignore unknown fields in the API
    /// response.
    pub ignore_unknown_fields: bool,

    /// Optional. The server URL of the Open API schema.
    /// This field is only set in tools in the environment dependencies during the
    /// export process if the schema contains a server url. During the import
    /// process, if this url is present in the environment dependencies and the
    /// schema has the $env_var placeholder, it will replace the placeholder in the
    /// schema.
    pub url: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl OpenApiTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [open_api_schema][crate::model::OpenApiTool::open_api_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// let x = OpenApiTool::new().set_open_api_schema("example");
    /// ```
    pub fn set_open_api_schema<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.open_api_schema = v.into();
        self
    }

    /// Sets the value of [name][crate::model::OpenApiTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// let x = OpenApiTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::OpenApiTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// let x = OpenApiTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [api_authentication][crate::model::OpenApiTool::api_authentication].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// use google_cloud_ces_v1::model::ApiAuthentication;
    /// let x = OpenApiTool::new().set_api_authentication(ApiAuthentication::default()/* use setters */);
    /// ```
    pub fn set_api_authentication<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ApiAuthentication>,
    {
        self.api_authentication = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [api_authentication][crate::model::OpenApiTool::api_authentication].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// use google_cloud_ces_v1::model::ApiAuthentication;
    /// let x = OpenApiTool::new().set_or_clear_api_authentication(Some(ApiAuthentication::default()/* use setters */));
    /// let x = OpenApiTool::new().set_or_clear_api_authentication(None::<ApiAuthentication>);
    /// ```
    pub fn set_or_clear_api_authentication<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ApiAuthentication>,
    {
        self.api_authentication = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tls_config][crate::model::OpenApiTool::tls_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// use google_cloud_ces_v1::model::TlsConfig;
    /// let x = OpenApiTool::new().set_tls_config(TlsConfig::default()/* use setters */);
    /// ```
    pub fn set_tls_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TlsConfig>,
    {
        self.tls_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [tls_config][crate::model::OpenApiTool::tls_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// use google_cloud_ces_v1::model::TlsConfig;
    /// let x = OpenApiTool::new().set_or_clear_tls_config(Some(TlsConfig::default()/* use setters */));
    /// let x = OpenApiTool::new().set_or_clear_tls_config(None::<TlsConfig>);
    /// ```
    pub fn set_or_clear_tls_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TlsConfig>,
    {
        self.tls_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [service_directory_config][crate::model::OpenApiTool::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = OpenApiTool::new().set_service_directory_config(ServiceDirectoryConfig::default()/* use setters */);
    /// ```
    pub fn set_service_directory_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [service_directory_config][crate::model::OpenApiTool::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = OpenApiTool::new().set_or_clear_service_directory_config(Some(ServiceDirectoryConfig::default()/* use setters */));
    /// let x = OpenApiTool::new().set_or_clear_service_directory_config(None::<ServiceDirectoryConfig>);
    /// ```
    pub fn set_or_clear_service_directory_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [ignore_unknown_fields][crate::model::OpenApiTool::ignore_unknown_fields].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// let x = OpenApiTool::new().set_ignore_unknown_fields(true);
    /// ```
    pub fn set_ignore_unknown_fields<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.ignore_unknown_fields = v.into();
        self
    }

    /// Sets the value of [url][crate::model::OpenApiTool::url].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiTool;
    /// let x = OpenApiTool::new().set_url("example");
    /// ```
    pub fn set_url<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.url = v.into();
        self
    }
}

impl wkt::message::Message for OpenApiTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.OpenApiTool"
    }
}

/// A toolset that contains a list of tools that are defined by an OpenAPI
/// schema.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct OpenApiToolset {
    /// Required. The OpenAPI schema of the toolset.
    pub open_api_schema: std::string::String,

    /// Optional. Authentication information required by the API.
    pub api_authentication: std::option::Option<crate::model::ApiAuthentication>,

    /// Optional. The TLS configuration. Includes the custom server certificates
    pub tls_config: std::option::Option<crate::model::TlsConfig>,

    /// Optional. Service Directory configuration.
    pub service_directory_config: std::option::Option<crate::model::ServiceDirectoryConfig>,

    /// Optional. If true, the agent will ignore unknown fields in the API response
    /// for all operations defined in the OpenAPI schema.
    pub ignore_unknown_fields: bool,

    /// Optional. The server URL of the Open API schema.
    /// This field is only set in toolsets in the environment dependencies during
    /// the export process if the schema contains a server url. During the import
    /// process, if this url is present in the environment dependencies and the
    /// schema has the $env_var placeholder, it will replace the placeholder in the
    /// schema.
    pub url: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl OpenApiToolset {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [open_api_schema][crate::model::OpenApiToolset::open_api_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiToolset;
    /// let x = OpenApiToolset::new().set_open_api_schema("example");
    /// ```
    pub fn set_open_api_schema<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.open_api_schema = v.into();
        self
    }

    /// Sets the value of [api_authentication][crate::model::OpenApiToolset::api_authentication].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiToolset;
    /// use google_cloud_ces_v1::model::ApiAuthentication;
    /// let x = OpenApiToolset::new().set_api_authentication(ApiAuthentication::default()/* use setters */);
    /// ```
    pub fn set_api_authentication<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ApiAuthentication>,
    {
        self.api_authentication = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [api_authentication][crate::model::OpenApiToolset::api_authentication].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiToolset;
    /// use google_cloud_ces_v1::model::ApiAuthentication;
    /// let x = OpenApiToolset::new().set_or_clear_api_authentication(Some(ApiAuthentication::default()/* use setters */));
    /// let x = OpenApiToolset::new().set_or_clear_api_authentication(None::<ApiAuthentication>);
    /// ```
    pub fn set_or_clear_api_authentication<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ApiAuthentication>,
    {
        self.api_authentication = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tls_config][crate::model::OpenApiToolset::tls_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiToolset;
    /// use google_cloud_ces_v1::model::TlsConfig;
    /// let x = OpenApiToolset::new().set_tls_config(TlsConfig::default()/* use setters */);
    /// ```
    pub fn set_tls_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TlsConfig>,
    {
        self.tls_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [tls_config][crate::model::OpenApiToolset::tls_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiToolset;
    /// use google_cloud_ces_v1::model::TlsConfig;
    /// let x = OpenApiToolset::new().set_or_clear_tls_config(Some(TlsConfig::default()/* use setters */));
    /// let x = OpenApiToolset::new().set_or_clear_tls_config(None::<TlsConfig>);
    /// ```
    pub fn set_or_clear_tls_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TlsConfig>,
    {
        self.tls_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [service_directory_config][crate::model::OpenApiToolset::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiToolset;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = OpenApiToolset::new().set_service_directory_config(ServiceDirectoryConfig::default()/* use setters */);
    /// ```
    pub fn set_service_directory_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [service_directory_config][crate::model::OpenApiToolset::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiToolset;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = OpenApiToolset::new().set_or_clear_service_directory_config(Some(ServiceDirectoryConfig::default()/* use setters */));
    /// let x = OpenApiToolset::new().set_or_clear_service_directory_config(None::<ServiceDirectoryConfig>);
    /// ```
    pub fn set_or_clear_service_directory_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [ignore_unknown_fields][crate::model::OpenApiToolset::ignore_unknown_fields].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiToolset;
    /// let x = OpenApiToolset::new().set_ignore_unknown_fields(true);
    /// ```
    pub fn set_ignore_unknown_fields<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.ignore_unknown_fields = v.into();
        self
    }

    /// Sets the value of [url][crate::model::OpenApiToolset::url].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OpenApiToolset;
    /// let x = OpenApiToolset::new().set_url("example");
    /// ```
    pub fn set_url<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.url = v.into();
        self
    }
}

impl wkt::message::Message for OpenApiToolset {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.OpenApiToolset"
    }
}

/// A Python function tool.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct PythonFunction {
    /// Optional. The name of the Python function to execute. Must match a Python
    /// function name defined in the python code. Case sensitive. If the name is
    /// not provided, the first function defined in the python code will be used.
    pub name: std::string::String,

    /// Optional. The Python code to execute for the tool.
    pub python_code: std::string::String,

    /// Output only. The description of the Python function, parsed from the python
    /// code's docstring.
    pub description: std::string::String,

    /// Optional. Service Directory configuration for the tool.
    pub service_directory_config: std::option::Option<crate::model::ServiceDirectoryConfig>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl PythonFunction {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::PythonFunction::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::PythonFunction;
    /// let x = PythonFunction::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [python_code][crate::model::PythonFunction::python_code].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::PythonFunction;
    /// let x = PythonFunction::new().set_python_code("example");
    /// ```
    pub fn set_python_code<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.python_code = v.into();
        self
    }

    /// Sets the value of [description][crate::model::PythonFunction::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::PythonFunction;
    /// let x = PythonFunction::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [service_directory_config][crate::model::PythonFunction::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::PythonFunction;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = PythonFunction::new().set_service_directory_config(ServiceDirectoryConfig::default()/* use setters */);
    /// ```
    pub fn set_service_directory_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [service_directory_config][crate::model::PythonFunction::service_directory_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::PythonFunction;
    /// use google_cloud_ces_v1::model::ServiceDirectoryConfig;
    /// let x = PythonFunction::new().set_or_clear_service_directory_config(Some(ServiceDirectoryConfig::default()/* use setters */));
    /// let x = PythonFunction::new().set_or_clear_service_directory_config(None::<ServiceDirectoryConfig>);
    /// ```
    pub fn set_or_clear_service_directory_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ServiceDirectoryConfig>,
    {
        self.service_directory_config = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for PythonFunction {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.PythonFunction"
    }
}

/// Represents a select subset of an OpenAPI 3.0 schema object.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Schema {
    /// Required. The type of the data.
    pub r#type: crate::model::schema::Type,

    /// Optional. Properties of Type.OBJECT.
    pub properties: std::collections::HashMap<std::string::String, crate::model::Schema>,

    /// Optional. Required properties of Type.OBJECT.
    pub required: std::vec::Vec<std::string::String>,

    /// Optional. The description of the data.
    pub description: std::string::String,

    /// Optional. Schema of the elements of Type.ARRAY.
    pub items: std::option::Option<std::boxed::Box<crate::model::Schema>>,

    /// Optional. Indicates if the value may be null.
    pub nullable: bool,

    /// Optional. Indicate the items in the array must be unique. Only applies to
    /// TYPE.ARRAY.
    pub unique_items: bool,

    /// Optional. Schemas of initial elements of Type.ARRAY.
    pub prefix_items: std::vec::Vec<crate::model::Schema>,

    /// Optional. Can either be a boolean or an object, controls the presence of
    /// additional properties.
    pub additional_properties: std::option::Option<std::boxed::Box<crate::model::Schema>>,

    /// Optional. The value should be validated against any (one or more) of the
    /// subschemas in the list.
    pub any_of: std::vec::Vec<crate::model::Schema>,

    /// Optional. Possible values of the element of primitive type with enum
    /// format. Examples:
    ///
    /// 1. We can define direction as :
    ///    {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}
    /// 1. We can define apartment number as :
    ///    {type:INTEGER, format:enum, enum:["101", "201", "301"]}
    pub r#enum: std::vec::Vec<std::string::String>,

    /// Optional. Default value of the data.
    pub default: std::option::Option<wkt::Value>,

    /// Optional. Allows indirect references between schema nodes. The value should
    /// be a valid reference to a child of the root `defs`.
    ///
    /// For example, the following schema defines a reference to a schema node
    /// named "Pet":
    ///
    /// ```norust
    /// type: object
    /// properties:
    ///   pet:
    ///     ref: #/defs/Pet
    /// defs:
    ///   Pet:
    ///     type: object
    ///     properties:
    ///       name:
    ///         type: string
    /// ```
    ///
    /// The value of the "pet" property is a reference to the schema node
    /// named "Pet".
    /// See details in
    /// <https://json-schema.org/understanding-json-schema/structuring>.
    pub r#ref: std::string::String,

    /// Optional. A map of definitions for use by `ref`. Only allowed at the root
    /// of the schema.
    pub defs: std::collections::HashMap<std::string::String, crate::model::Schema>,

    /// Optional. The title of the schema.
    pub title: std::string::String,

    /// Optional. Minimum number of the elements for Type.ARRAY.
    pub min_items: i64,

    /// Optional. Maximum number of the elements for Type.ARRAY.
    pub max_items: i64,

    /// Optional. Minimum value for Type.INTEGER and Type.NUMBER.
    pub minimum: std::option::Option<f64>,

    /// Optional. Maximum value for Type.INTEGER and Type.NUMBER.
    pub maximum: std::option::Option<f64>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Schema {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [r#type][crate::model::Schema::type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// use google_cloud_ces_v1::model::schema::Type;
    /// let x0 = Schema::new().set_type(Type::String);
    /// let x1 = Schema::new().set_type(Type::Integer);
    /// let x2 = Schema::new().set_type(Type::Number);
    /// ```
    pub fn set_type<T: std::convert::Into<crate::model::schema::Type>>(mut self, v: T) -> Self {
        self.r#type = v.into();
        self
    }

    /// Sets the value of [properties][crate::model::Schema::properties].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_properties([
    ///     ("key0", Schema::default()/* use setters */),
    ///     ("key1", Schema::default()/* use (different) setters */),
    /// ]);
    /// ```
    pub fn set_properties<T, K, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = (K, V)>,
        K: std::convert::Into<std::string::String>,
        V: std::convert::Into<crate::model::Schema>,
    {
        use std::iter::Iterator;
        self.properties = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
        self
    }

    /// Sets the value of [required][crate::model::Schema::required].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_required(["a", "b", "c"]);
    /// ```
    pub fn set_required<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.required = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [description][crate::model::Schema::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [items][crate::model::Schema::items].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_items(Schema::default()/* use setters */);
    /// ```
    pub fn set_items<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.items = std::option::Option::Some(std::boxed::Box::new(v.into()));
        self
    }

    /// Sets or clears the value of [items][crate::model::Schema::items].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_or_clear_items(Some(Schema::default()/* use setters */));
    /// let x = Schema::new().set_or_clear_items(None::<Schema>);
    /// ```
    pub fn set_or_clear_items<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.items = v.map(|x| std::boxed::Box::new(x.into()));
        self
    }

    /// Sets the value of [nullable][crate::model::Schema::nullable].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_nullable(true);
    /// ```
    pub fn set_nullable<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.nullable = v.into();
        self
    }

    /// Sets the value of [unique_items][crate::model::Schema::unique_items].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_unique_items(true);
    /// ```
    pub fn set_unique_items<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.unique_items = v.into();
        self
    }

    /// Sets the value of [prefix_items][crate::model::Schema::prefix_items].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new()
    ///     .set_prefix_items([
    ///         Schema::default()/* use setters */,
    ///         Schema::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_prefix_items<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Schema>,
    {
        use std::iter::Iterator;
        self.prefix_items = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [additional_properties][crate::model::Schema::additional_properties].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_additional_properties(Schema::default()/* use setters */);
    /// ```
    pub fn set_additional_properties<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.additional_properties = std::option::Option::Some(std::boxed::Box::new(v.into()));
        self
    }

    /// Sets or clears the value of [additional_properties][crate::model::Schema::additional_properties].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_or_clear_additional_properties(Some(Schema::default()/* use setters */));
    /// let x = Schema::new().set_or_clear_additional_properties(None::<Schema>);
    /// ```
    pub fn set_or_clear_additional_properties<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.additional_properties = v.map(|x| std::boxed::Box::new(x.into()));
        self
    }

    /// Sets the value of [any_of][crate::model::Schema::any_of].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new()
    ///     .set_any_of([
    ///         Schema::default()/* use setters */,
    ///         Schema::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_any_of<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Schema>,
    {
        use std::iter::Iterator;
        self.any_of = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [r#enum][crate::model::Schema::enum].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_enum(["a", "b", "c"]);
    /// ```
    pub fn set_enum<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.r#enum = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [default][crate::model::Schema::default].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// use wkt::Value;
    /// let x = Schema::new().set_default(Value::default()/* use setters */);
    /// ```
    pub fn set_default<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Value>,
    {
        self.default = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [default][crate::model::Schema::default].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// use wkt::Value;
    /// let x = Schema::new().set_or_clear_default(Some(Value::default()/* use setters */));
    /// let x = Schema::new().set_or_clear_default(None::<Value>);
    /// ```
    pub fn set_or_clear_default<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Value>,
    {
        self.default = v.map(|x| x.into());
        self
    }

    /// Sets the value of [r#ref][crate::model::Schema::ref].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_ref("example");
    /// ```
    pub fn set_ref<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.r#ref = v.into();
        self
    }

    /// Sets the value of [defs][crate::model::Schema::defs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_defs([
    ///     ("key0", Schema::default()/* use setters */),
    ///     ("key1", Schema::default()/* use (different) setters */),
    /// ]);
    /// ```
    pub fn set_defs<T, K, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = (K, V)>,
        K: std::convert::Into<std::string::String>,
        V: std::convert::Into<crate::model::Schema>,
    {
        use std::iter::Iterator;
        self.defs = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
        self
    }

    /// Sets the value of [title][crate::model::Schema::title].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_title("example");
    /// ```
    pub fn set_title<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.title = v.into();
        self
    }

    /// Sets the value of [min_items][crate::model::Schema::min_items].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_min_items(42);
    /// ```
    pub fn set_min_items<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
        self.min_items = v.into();
        self
    }

    /// Sets the value of [max_items][crate::model::Schema::max_items].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_max_items(42);
    /// ```
    pub fn set_max_items<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
        self.max_items = v.into();
        self
    }

    /// Sets the value of [minimum][crate::model::Schema::minimum].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_minimum(42.0);
    /// ```
    pub fn set_minimum<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<f64>,
    {
        self.minimum = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [minimum][crate::model::Schema::minimum].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_or_clear_minimum(Some(42.0));
    /// let x = Schema::new().set_or_clear_minimum(None::<f32>);
    /// ```
    pub fn set_or_clear_minimum<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<f64>,
    {
        self.minimum = v.map(|x| x.into());
        self
    }

    /// Sets the value of [maximum][crate::model::Schema::maximum].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_maximum(42.0);
    /// ```
    pub fn set_maximum<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<f64>,
    {
        self.maximum = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [maximum][crate::model::Schema::maximum].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Schema;
    /// let x = Schema::new().set_or_clear_maximum(Some(42.0));
    /// let x = Schema::new().set_or_clear_maximum(None::<f32>);
    /// ```
    pub fn set_or_clear_maximum<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<f64>,
    {
        self.maximum = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for Schema {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Schema"
    }
}

/// Defines additional types related to [Schema].
pub mod schema {
    #[allow(unused_imports)]
    use super::*;

    /// OpenAPI data types.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum Type {
        /// Type unspecified.
        Unspecified,
        /// String type.
        String,
        /// Integer type.
        Integer,
        /// Number type.
        Number,
        /// Boolean type.
        Boolean,
        /// Object type.
        Object,
        /// Array type.
        Array,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [Type::value] or
        /// [Type::name].
        UnknownValue(r#type::UnknownValue),
    }

    #[doc(hidden)]
    pub mod r#type {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl Type {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::String => std::option::Option::Some(1),
                Self::Integer => std::option::Option::Some(2),
                Self::Number => std::option::Option::Some(3),
                Self::Boolean => std::option::Option::Some(4),
                Self::Object => std::option::Option::Some(5),
                Self::Array => std::option::Option::Some(6),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("TYPE_UNSPECIFIED"),
                Self::String => std::option::Option::Some("STRING"),
                Self::Integer => std::option::Option::Some("INTEGER"),
                Self::Number => std::option::Option::Some("NUMBER"),
                Self::Boolean => std::option::Option::Some("BOOLEAN"),
                Self::Object => std::option::Option::Some("OBJECT"),
                Self::Array => std::option::Option::Some("ARRAY"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for Type {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for Type {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for Type {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::String,
                2 => Self::Integer,
                3 => Self::Number,
                4 => Self::Boolean,
                5 => Self::Object,
                6 => Self::Array,
                _ => Self::UnknownValue(r#type::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for Type {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "TYPE_UNSPECIFIED" => Self::Unspecified,
                "STRING" => Self::String,
                "INTEGER" => Self::Integer,
                "NUMBER" => Self::Number,
                "BOOLEAN" => Self::Boolean,
                "OBJECT" => Self::Object,
                "ARRAY" => Self::Array,
                _ => Self::UnknownValue(r#type::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for Type {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::String => serializer.serialize_i32(1),
                Self::Integer => serializer.serialize_i32(2),
                Self::Number => serializer.serialize_i32(3),
                Self::Boolean => serializer.serialize_i32(4),
                Self::Object => serializer.serialize_i32(5),
                Self::Array => serializer.serialize_i32(6),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for Type {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<Type>::new(
                ".google.cloud.ces.v1.Schema.Type",
            ))
        }
    }
}

/// Search suggestions from [Google Search
/// Tool][google.cloud.ces.v1.GoogleSearchTool].
///
/// [google.cloud.ces.v1.GoogleSearchTool]: crate::model::GoogleSearchTool
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GoogleSearchSuggestions {
    /// Compliant HTML and CSS styling for search suggestions.
    /// The provided HTML and CSS automatically adapts to your device settings,
    /// displaying in either light or dark mode indicated by
    /// `@media(prefers-color-scheme)`.
    pub htmls: std::vec::Vec<std::string::String>,

    /// List of queries used to perform the google search along with the search
    /// result URIs forming the search suggestions.
    pub web_search_queries: std::vec::Vec<crate::model::WebSearchQuery>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GoogleSearchSuggestions {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [htmls][crate::model::GoogleSearchSuggestions::htmls].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GoogleSearchSuggestions;
    /// let x = GoogleSearchSuggestions::new().set_htmls(["a", "b", "c"]);
    /// ```
    pub fn set_htmls<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.htmls = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [web_search_queries][crate::model::GoogleSearchSuggestions::web_search_queries].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GoogleSearchSuggestions;
    /// use google_cloud_ces_v1::model::WebSearchQuery;
    /// let x = GoogleSearchSuggestions::new()
    ///     .set_web_search_queries([
    ///         WebSearchQuery::default()/* use setters */,
    ///         WebSearchQuery::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_web_search_queries<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::WebSearchQuery>,
    {
        use std::iter::Iterator;
        self.web_search_queries = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for GoogleSearchSuggestions {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GoogleSearchSuggestions"
    }
}

/// Represents a single web search query and its associated search uri.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct WebSearchQuery {
    /// The search query text.
    pub query: std::string::String,

    /// The URI to the Google Search results page for the query.
    pub uri: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl WebSearchQuery {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [query][crate::model::WebSearchQuery::query].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WebSearchQuery;
    /// let x = WebSearchQuery::new().set_query("example");
    /// ```
    pub fn set_query<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.query = v.into();
        self
    }

    /// Sets the value of [uri][crate::model::WebSearchQuery::uri].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WebSearchQuery;
    /// let x = WebSearchQuery::new().set_uri("example");
    /// ```
    pub fn set_uri<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.uri = v.into();
        self
    }
}

impl wkt::message::Message for WebSearchQuery {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.WebSearchQuery"
    }
}

/// Project/Location level security settings for CES.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct SecuritySettings {
    /// Identifier. The unique identifier of the security settings.
    /// Format: `projects/{project}/locations/{location}/securitySettings`
    pub name: std::string::String,

    /// Optional. Endpoint control related settings.
    pub endpoint_control_policy: std::option::Option<crate::model::EndpointControlPolicy>,

    /// Output only. Create time of the security settings.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Last update time of the security settings.
    pub update_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Etag of the security settings.
    pub etag: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl SecuritySettings {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::SecuritySettings::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SecuritySettings;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// let x = SecuritySettings::new().set_name(format!("projects/{project_id}/locations/{location_id}/securitySettings"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [endpoint_control_policy][crate::model::SecuritySettings::endpoint_control_policy].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SecuritySettings;
    /// use google_cloud_ces_v1::model::EndpointControlPolicy;
    /// let x = SecuritySettings::new().set_endpoint_control_policy(EndpointControlPolicy::default()/* use setters */);
    /// ```
    pub fn set_endpoint_control_policy<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::EndpointControlPolicy>,
    {
        self.endpoint_control_policy = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [endpoint_control_policy][crate::model::SecuritySettings::endpoint_control_policy].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SecuritySettings;
    /// use google_cloud_ces_v1::model::EndpointControlPolicy;
    /// let x = SecuritySettings::new().set_or_clear_endpoint_control_policy(Some(EndpointControlPolicy::default()/* use setters */));
    /// let x = SecuritySettings::new().set_or_clear_endpoint_control_policy(None::<EndpointControlPolicy>);
    /// ```
    pub fn set_or_clear_endpoint_control_policy<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::EndpointControlPolicy>,
    {
        self.endpoint_control_policy = v.map(|x| x.into());
        self
    }

    /// Sets the value of [create_time][crate::model::SecuritySettings::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SecuritySettings;
    /// use wkt::Timestamp;
    /// let x = SecuritySettings::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::SecuritySettings::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SecuritySettings;
    /// use wkt::Timestamp;
    /// let x = SecuritySettings::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = SecuritySettings::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::SecuritySettings::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SecuritySettings;
    /// use wkt::Timestamp;
    /// let x = SecuritySettings::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::SecuritySettings::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SecuritySettings;
    /// use wkt::Timestamp;
    /// let x = SecuritySettings::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = SecuritySettings::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [etag][crate::model::SecuritySettings::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SecuritySettings;
    /// let x = SecuritySettings::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }
}

impl wkt::message::Message for SecuritySettings {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.SecuritySettings"
    }
}

/// Defines project/location level endpoint control policy.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct EndpointControlPolicy {
    /// Optional. The scope in which this policy's allowed_origins list is
    /// enforced.
    pub enforcement_scope: crate::model::endpoint_control_policy::EnforcementScope,

    /// Optional. The allowed HTTP(s) origins that tools in the App are able to
    /// directly call. The enforcement depends on the value of
    /// enforcement_scope and the VPC-SC status of the project.
    /// If a port number is not provided, all ports will be allowed. Otherwise,
    /// the port number must match exactly. For example, `https://example.com`
    /// will match "<https://example.com>:443" and any other port.
    /// "<https://example.com>:443" will only match "<https://example.com>:443".
    pub allowed_origins: std::vec::Vec<std::string::String>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl EndpointControlPolicy {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [enforcement_scope][crate::model::EndpointControlPolicy::enforcement_scope].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EndpointControlPolicy;
    /// use google_cloud_ces_v1::model::endpoint_control_policy::EnforcementScope;
    /// let x0 = EndpointControlPolicy::new().set_enforcement_scope(EnforcementScope::VpcscOnly);
    /// let x1 = EndpointControlPolicy::new().set_enforcement_scope(EnforcementScope::Always);
    /// ```
    pub fn set_enforcement_scope<
        T: std::convert::Into<crate::model::endpoint_control_policy::EnforcementScope>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.enforcement_scope = v.into();
        self
    }

    /// Sets the value of [allowed_origins][crate::model::EndpointControlPolicy::allowed_origins].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EndpointControlPolicy;
    /// let x = EndpointControlPolicy::new().set_allowed_origins(["a", "b", "c"]);
    /// ```
    pub fn set_allowed_origins<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.allowed_origins = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for EndpointControlPolicy {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.EndpointControlPolicy"
    }
}

/// Defines additional types related to [EndpointControlPolicy].
pub mod endpoint_control_policy {
    #[allow(unused_imports)]
    use super::*;

    /// Defines the scope in which this policy's allowed_origins list is
    /// enforced.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum EnforcementScope {
        /// Unspecified. This policy will be treated as VPCSC_ONLY.
        Unspecified,
        /// This policy applies only when VPC-SC is active.
        VpcscOnly,
        /// This policy ALWAYS applies, regardless of VPC-SC status.
        Always,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [EnforcementScope::value] or
        /// [EnforcementScope::name].
        UnknownValue(enforcement_scope::UnknownValue),
    }

    #[doc(hidden)]
    pub mod enforcement_scope {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl EnforcementScope {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::VpcscOnly => std::option::Option::Some(1),
                Self::Always => std::option::Option::Some(2),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("ENFORCEMENT_SCOPE_UNSPECIFIED"),
                Self::VpcscOnly => std::option::Option::Some("VPCSC_ONLY"),
                Self::Always => std::option::Option::Some("ALWAYS"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for EnforcementScope {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for EnforcementScope {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for EnforcementScope {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::VpcscOnly,
                2 => Self::Always,
                _ => Self::UnknownValue(enforcement_scope::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for EnforcementScope {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "ENFORCEMENT_SCOPE_UNSPECIFIED" => Self::Unspecified,
                "VPCSC_ONLY" => Self::VpcscOnly,
                "ALWAYS" => Self::Always,
                _ => Self::UnknownValue(enforcement_scope::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for EnforcementScope {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::VpcscOnly => serializer.serialize_i32(1),
                Self::Always => serializer.serialize_i32(2),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for EnforcementScope {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<EnforcementScope>::new(
                ".google.cloud.ces.v1.EndpointControlPolicy.EnforcementScope",
            ))
        }
    }
}

/// Mock tool calls configuration for the session.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct MockConfig {
    /// Optional. All tool calls to mock for the duration of the session.
    pub mocked_tool_calls: std::vec::Vec<crate::model::MockedToolCall>,

    /// Required. Beavhior for tool calls that don't match any args patterns in
    /// mocked_tool_calls.
    pub unmatched_tool_call_behavior: crate::model::mock_config::UnmatchedToolCallBehavior,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl MockConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [mocked_tool_calls][crate::model::MockConfig::mocked_tool_calls].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockConfig;
    /// use google_cloud_ces_v1::model::MockedToolCall;
    /// let x = MockConfig::new()
    ///     .set_mocked_tool_calls([
    ///         MockedToolCall::default()/* use setters */,
    ///         MockedToolCall::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_mocked_tool_calls<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::MockedToolCall>,
    {
        use std::iter::Iterator;
        self.mocked_tool_calls = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [unmatched_tool_call_behavior][crate::model::MockConfig::unmatched_tool_call_behavior].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::MockConfig;
    /// use google_cloud_ces_v1::model::mock_config::UnmatchedToolCallBehavior;
    /// let x0 = MockConfig::new().set_unmatched_tool_call_behavior(UnmatchedToolCallBehavior::Fail);
    /// let x1 = MockConfig::new().set_unmatched_tool_call_behavior(UnmatchedToolCallBehavior::PassThrough);
    /// ```
    pub fn set_unmatched_tool_call_behavior<
        T: std::convert::Into<crate::model::mock_config::UnmatchedToolCallBehavior>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.unmatched_tool_call_behavior = v.into();
        self
    }
}

impl wkt::message::Message for MockConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.MockConfig"
    }
}

/// Defines additional types related to [MockConfig].
pub mod mock_config {
    #[allow(unused_imports)]
    use super::*;

    /// What to do when a tool call doesn't match any mocked tool calls.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum UnmatchedToolCallBehavior {
        /// Default value. This value is unused.
        Unspecified,
        /// Throw an error for any tool calls that don't match a mock expected input
        /// pattern.
        Fail,
        /// For unmatched tool calls, pass the tool call through to real tool.
        PassThrough,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [UnmatchedToolCallBehavior::value] or
        /// [UnmatchedToolCallBehavior::name].
        UnknownValue(unmatched_tool_call_behavior::UnknownValue),
    }

    #[doc(hidden)]
    pub mod unmatched_tool_call_behavior {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl UnmatchedToolCallBehavior {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Fail => std::option::Option::Some(1),
                Self::PassThrough => std::option::Option::Some(2),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => {
                    std::option::Option::Some("UNMATCHED_TOOL_CALL_BEHAVIOR_UNSPECIFIED")
                }
                Self::Fail => std::option::Option::Some("FAIL"),
                Self::PassThrough => std::option::Option::Some("PASS_THROUGH"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for UnmatchedToolCallBehavior {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for UnmatchedToolCallBehavior {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for UnmatchedToolCallBehavior {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Fail,
                2 => Self::PassThrough,
                _ => Self::UnknownValue(unmatched_tool_call_behavior::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for UnmatchedToolCallBehavior {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "UNMATCHED_TOOL_CALL_BEHAVIOR_UNSPECIFIED" => Self::Unspecified,
                "FAIL" => Self::Fail,
                "PASS_THROUGH" => Self::PassThrough,
                _ => Self::UnknownValue(unmatched_tool_call_behavior::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for UnmatchedToolCallBehavior {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Fail => serializer.serialize_i32(1),
                Self::PassThrough => serializer.serialize_i32(2),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for UnmatchedToolCallBehavior {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(
                wkt::internal::EnumVisitor::<UnmatchedToolCallBehavior>::new(
                    ".google.cloud.ces.v1.MockConfig.UnmatchedToolCallBehavior",
                ),
            )
        }
    }
}

/// InputAudioConfig configures how the CES agent should interpret the incoming
/// audio data.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct InputAudioConfig {
    /// Required. The encoding of the input audio data.
    pub audio_encoding: crate::model::AudioEncoding,

    /// Required. The sample rate (in Hertz) of the input audio data.
    pub sample_rate_hertz: i32,

    /// Optional. Whether to enable noise suppression on the input audio.
    /// Available values are "low", "moderate", "high", "very_high".
    pub noise_suppression_level: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl InputAudioConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [audio_encoding][crate::model::InputAudioConfig::audio_encoding].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::InputAudioConfig;
    /// use google_cloud_ces_v1::model::AudioEncoding;
    /// let x0 = InputAudioConfig::new().set_audio_encoding(AudioEncoding::Linear16);
    /// let x1 = InputAudioConfig::new().set_audio_encoding(AudioEncoding::Mulaw);
    /// let x2 = InputAudioConfig::new().set_audio_encoding(AudioEncoding::Alaw);
    /// ```
    pub fn set_audio_encoding<T: std::convert::Into<crate::model::AudioEncoding>>(
        mut self,
        v: T,
    ) -> Self {
        self.audio_encoding = v.into();
        self
    }

    /// Sets the value of [sample_rate_hertz][crate::model::InputAudioConfig::sample_rate_hertz].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::InputAudioConfig;
    /// let x = InputAudioConfig::new().set_sample_rate_hertz(42);
    /// ```
    pub fn set_sample_rate_hertz<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.sample_rate_hertz = v.into();
        self
    }

    /// Sets the value of [noise_suppression_level][crate::model::InputAudioConfig::noise_suppression_level].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::InputAudioConfig;
    /// let x = InputAudioConfig::new().set_noise_suppression_level("example");
    /// ```
    pub fn set_noise_suppression_level<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.noise_suppression_level = v.into();
        self
    }
}

impl wkt::message::Message for InputAudioConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.InputAudioConfig"
    }
}

/// OutputAudioConfig configures how the CES agent should synthesize outgoing
/// audio responses.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct OutputAudioConfig {
    /// Required. The encoding of the output audio data.
    pub audio_encoding: crate::model::AudioEncoding,

    /// Required. The sample rate (in Hertz) of the output audio data.
    pub sample_rate_hertz: i32,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl OutputAudioConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [audio_encoding][crate::model::OutputAudioConfig::audio_encoding].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OutputAudioConfig;
    /// use google_cloud_ces_v1::model::AudioEncoding;
    /// let x0 = OutputAudioConfig::new().set_audio_encoding(AudioEncoding::Linear16);
    /// let x1 = OutputAudioConfig::new().set_audio_encoding(AudioEncoding::Mulaw);
    /// let x2 = OutputAudioConfig::new().set_audio_encoding(AudioEncoding::Alaw);
    /// ```
    pub fn set_audio_encoding<T: std::convert::Into<crate::model::AudioEncoding>>(
        mut self,
        v: T,
    ) -> Self {
        self.audio_encoding = v.into();
        self
    }

    /// Sets the value of [sample_rate_hertz][crate::model::OutputAudioConfig::sample_rate_hertz].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::OutputAudioConfig;
    /// let x = OutputAudioConfig::new().set_sample_rate_hertz(42);
    /// ```
    pub fn set_sample_rate_hertz<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.sample_rate_hertz = v.into();
        self
    }
}

impl wkt::message::Message for OutputAudioConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.OutputAudioConfig"
    }
}

/// The configuration for the session.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct SessionConfig {
    /// Required. The unique identifier of the session.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/sessions/{session}`
    pub session: std::string::String,

    /// Optional. Configuration for processing the input audio.
    pub input_audio_config: std::option::Option<crate::model::InputAudioConfig>,

    /// Optional. Configuration for generating the output audio.
    pub output_audio_config: std::option::Option<crate::model::OutputAudioConfig>,

    /// Optional. The historical context of the session, including user inputs,
    /// agent responses, and other messages. Typically, CES agent would manage
    /// session automatically so client doesn't need to explicitly populate this
    /// field. However, client can optionally override the historical contexts to
    /// force the session start from certain state.
    pub historical_contexts: std::vec::Vec<crate::model::Message>,

    /// Optional. The entry agent to handle the session. If not specified, the
    /// session will be handled by the [root
    /// agent][google.cloud.ces.v1.App.root_agent] of the app. Format:
    /// `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
    ///
    /// [google.cloud.ces.v1.App.root_agent]: crate::model::App::root_agent
    pub entry_agent: std::string::String,

    /// Optional. The deployment of the app to use for the session.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`
    pub deployment: std::string::String,

    /// Optional. The time zone of the user. If provided, the agent will use the
    /// time zone for date and time related variables. Otherwise, the agent will
    /// use the time zone specified in the App.time_zone_settings.
    ///
    /// The format is the IANA Time Zone Database time zone, e.g.
    /// "America/Los_Angeles".
    pub time_zone: std::string::String,

    /// Optional. Whether to use tool fakes for the session.
    /// If this field is set, the agent will attempt use tool fakes instead of
    /// calling the real tools.
    pub use_tool_fakes: bool,

    /// Optional.
    /// [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters)
    /// to send to the remote
    /// [Dialogflow](https://cloud.google.com/dialogflow/cx/docs/concept/console-conversational-agents)
    /// agent when the session control is transferred to the remote agent.
    pub remote_dialogflow_query_parameters:
        std::option::Option<crate::model::session_config::RemoteDialogflowQueryParameters>,

    /// Optional. Whether to enable streaming text outputs from the model.
    /// By default, text outputs from the model are collected before sending to the
    /// client.
    /// NOTE: This is only supported for text (non-voice) sessions via
    /// [StreamRunSession][google.cloud.ces.v1.SessionService.StreamRunSession] or
    /// [BidiRunSession][google.cloud.ces.v1.SessionService.BidiRunSession].
    pub enable_text_streaming: bool,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl SessionConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [session][crate::model::SessionConfig::session].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// let x = SessionConfig::new().set_session("example");
    /// ```
    pub fn set_session<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.session = v.into();
        self
    }

    /// Sets the value of [input_audio_config][crate::model::SessionConfig::input_audio_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// use google_cloud_ces_v1::model::InputAudioConfig;
    /// let x = SessionConfig::new().set_input_audio_config(InputAudioConfig::default()/* use setters */);
    /// ```
    pub fn set_input_audio_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::InputAudioConfig>,
    {
        self.input_audio_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [input_audio_config][crate::model::SessionConfig::input_audio_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// use google_cloud_ces_v1::model::InputAudioConfig;
    /// let x = SessionConfig::new().set_or_clear_input_audio_config(Some(InputAudioConfig::default()/* use setters */));
    /// let x = SessionConfig::new().set_or_clear_input_audio_config(None::<InputAudioConfig>);
    /// ```
    pub fn set_or_clear_input_audio_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::InputAudioConfig>,
    {
        self.input_audio_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [output_audio_config][crate::model::SessionConfig::output_audio_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// use google_cloud_ces_v1::model::OutputAudioConfig;
    /// let x = SessionConfig::new().set_output_audio_config(OutputAudioConfig::default()/* use setters */);
    /// ```
    pub fn set_output_audio_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::OutputAudioConfig>,
    {
        self.output_audio_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [output_audio_config][crate::model::SessionConfig::output_audio_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// use google_cloud_ces_v1::model::OutputAudioConfig;
    /// let x = SessionConfig::new().set_or_clear_output_audio_config(Some(OutputAudioConfig::default()/* use setters */));
    /// let x = SessionConfig::new().set_or_clear_output_audio_config(None::<OutputAudioConfig>);
    /// ```
    pub fn set_or_clear_output_audio_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::OutputAudioConfig>,
    {
        self.output_audio_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [historical_contexts][crate::model::SessionConfig::historical_contexts].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// use google_cloud_ces_v1::model::Message;
    /// let x = SessionConfig::new()
    ///     .set_historical_contexts([
    ///         Message::default()/* use setters */,
    ///         Message::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_historical_contexts<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Message>,
    {
        use std::iter::Iterator;
        self.historical_contexts = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [entry_agent][crate::model::SessionConfig::entry_agent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let agent_id = "agent_id";
    /// let x = SessionConfig::new().set_entry_agent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/agents/{agent_id}"));
    /// ```
    pub fn set_entry_agent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.entry_agent = v.into();
        self
    }

    /// Sets the value of [deployment][crate::model::SessionConfig::deployment].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// let x = SessionConfig::new().set_deployment("example");
    /// ```
    pub fn set_deployment<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.deployment = v.into();
        self
    }

    /// Sets the value of [time_zone][crate::model::SessionConfig::time_zone].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// let x = SessionConfig::new().set_time_zone("example");
    /// ```
    pub fn set_time_zone<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.time_zone = v.into();
        self
    }

    /// Sets the value of [use_tool_fakes][crate::model::SessionConfig::use_tool_fakes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// let x = SessionConfig::new().set_use_tool_fakes(true);
    /// ```
    pub fn set_use_tool_fakes<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.use_tool_fakes = v.into();
        self
    }

    /// Sets the value of [remote_dialogflow_query_parameters][crate::model::SessionConfig::remote_dialogflow_query_parameters].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// use google_cloud_ces_v1::model::session_config::RemoteDialogflowQueryParameters;
    /// let x = SessionConfig::new().set_remote_dialogflow_query_parameters(RemoteDialogflowQueryParameters::default()/* use setters */);
    /// ```
    pub fn set_remote_dialogflow_query_parameters<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::session_config::RemoteDialogflowQueryParameters>,
    {
        self.remote_dialogflow_query_parameters = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [remote_dialogflow_query_parameters][crate::model::SessionConfig::remote_dialogflow_query_parameters].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// use google_cloud_ces_v1::model::session_config::RemoteDialogflowQueryParameters;
    /// let x = SessionConfig::new().set_or_clear_remote_dialogflow_query_parameters(Some(RemoteDialogflowQueryParameters::default()/* use setters */));
    /// let x = SessionConfig::new().set_or_clear_remote_dialogflow_query_parameters(None::<RemoteDialogflowQueryParameters>);
    /// ```
    pub fn set_or_clear_remote_dialogflow_query_parameters<T>(
        mut self,
        v: std::option::Option<T>,
    ) -> Self
    where
        T: std::convert::Into<crate::model::session_config::RemoteDialogflowQueryParameters>,
    {
        self.remote_dialogflow_query_parameters = v.map(|x| x.into());
        self
    }

    /// Sets the value of [enable_text_streaming][crate::model::SessionConfig::enable_text_streaming].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionConfig;
    /// let x = SessionConfig::new().set_enable_text_streaming(true);
    /// ```
    pub fn set_enable_text_streaming<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.enable_text_streaming = v.into();
        self
    }
}

impl wkt::message::Message for SessionConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.SessionConfig"
    }
}

/// Defines additional types related to [SessionConfig].
pub mod session_config {
    #[allow(unused_imports)]
    use super::*;

    /// [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters)
    /// to send to the remote
    /// [Dialogflow](https://cloud.google.com/dialogflow/cx/docs/concept/console-conversational-agents)
    /// agent when the session control is transferred to the remote agent.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct RemoteDialogflowQueryParameters {
        /// Optional. The HTTP headers to be sent as webhook_headers in
        /// [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters).
        pub webhook_headers: std::collections::HashMap<std::string::String, std::string::String>,

        /// Optional. The payload to be sent in
        /// [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters).
        pub payload: std::option::Option<wkt::Struct>,

        /// Optional. The end user metadata to be sent in
        /// [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters).
        pub end_user_metadata: std::option::Option<wkt::Struct>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl RemoteDialogflowQueryParameters {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [webhook_headers][crate::model::session_config::RemoteDialogflowQueryParameters::webhook_headers].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::session_config::RemoteDialogflowQueryParameters;
        /// let x = RemoteDialogflowQueryParameters::new().set_webhook_headers([
        ///     ("key0", "abc"),
        ///     ("key1", "xyz"),
        /// ]);
        /// ```
        pub fn set_webhook_headers<T, K, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = (K, V)>,
            K: std::convert::Into<std::string::String>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.webhook_headers = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
            self
        }

        /// Sets the value of [payload][crate::model::session_config::RemoteDialogflowQueryParameters::payload].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::session_config::RemoteDialogflowQueryParameters;
        /// use wkt::Struct;
        /// let x = RemoteDialogflowQueryParameters::new().set_payload(Struct::default()/* use setters */);
        /// ```
        pub fn set_payload<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<wkt::Struct>,
        {
            self.payload = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [payload][crate::model::session_config::RemoteDialogflowQueryParameters::payload].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::session_config::RemoteDialogflowQueryParameters;
        /// use wkt::Struct;
        /// let x = RemoteDialogflowQueryParameters::new().set_or_clear_payload(Some(Struct::default()/* use setters */));
        /// let x = RemoteDialogflowQueryParameters::new().set_or_clear_payload(None::<Struct>);
        /// ```
        pub fn set_or_clear_payload<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<wkt::Struct>,
        {
            self.payload = v.map(|x| x.into());
            self
        }

        /// Sets the value of [end_user_metadata][crate::model::session_config::RemoteDialogflowQueryParameters::end_user_metadata].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::session_config::RemoteDialogflowQueryParameters;
        /// use wkt::Struct;
        /// let x = RemoteDialogflowQueryParameters::new().set_end_user_metadata(Struct::default()/* use setters */);
        /// ```
        pub fn set_end_user_metadata<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<wkt::Struct>,
        {
            self.end_user_metadata = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [end_user_metadata][crate::model::session_config::RemoteDialogflowQueryParameters::end_user_metadata].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::session_config::RemoteDialogflowQueryParameters;
        /// use wkt::Struct;
        /// let x = RemoteDialogflowQueryParameters::new().set_or_clear_end_user_metadata(Some(Struct::default()/* use setters */));
        /// let x = RemoteDialogflowQueryParameters::new().set_or_clear_end_user_metadata(None::<Struct>);
        /// ```
        pub fn set_or_clear_end_user_metadata<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<wkt::Struct>,
        {
            self.end_user_metadata = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for RemoteDialogflowQueryParameters {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.SessionConfig.RemoteDialogflowQueryParameters"
        }
    }
}

/// Request for the client to execute the tools and return the execution results
/// before continuing the session.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ToolCalls {
    /// Optional. The list of tool calls to execute.
    pub tool_calls: std::vec::Vec<crate::model::ToolCall>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ToolCalls {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [tool_calls][crate::model::ToolCalls::tool_calls].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolCalls;
    /// use google_cloud_ces_v1::model::ToolCall;
    /// let x = ToolCalls::new()
    ///     .set_tool_calls([
    ///         ToolCall::default()/* use setters */,
    ///         ToolCall::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_tool_calls<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::ToolCall>,
    {
        use std::iter::Iterator;
        self.tool_calls = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for ToolCalls {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ToolCalls"
    }
}

/// Execution results for the requested tool calls from the client.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ToolResponses {
    /// Optional. The list of tool execution results.
    pub tool_responses: std::vec::Vec<crate::model::ToolResponse>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ToolResponses {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [tool_responses][crate::model::ToolResponses::tool_responses].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolResponses;
    /// use google_cloud_ces_v1::model::ToolResponse;
    /// let x = ToolResponses::new()
    ///     .set_tool_responses([
    ///         ToolResponse::default()/* use setters */,
    ///         ToolResponse::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_tool_responses<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::ToolResponse>,
    {
        use std::iter::Iterator;
        self.tool_responses = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for ToolResponses {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ToolResponses"
    }
}

/// Citations associated with the agent response.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Citations {
    /// List of cited pieces of information.
    pub cited_chunks: std::vec::Vec<crate::model::citations::CitedChunk>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Citations {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [cited_chunks][crate::model::Citations::cited_chunks].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Citations;
    /// use google_cloud_ces_v1::model::citations::CitedChunk;
    /// let x = Citations::new()
    ///     .set_cited_chunks([
    ///         CitedChunk::default()/* use setters */,
    ///         CitedChunk::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_cited_chunks<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::citations::CitedChunk>,
    {
        use std::iter::Iterator;
        self.cited_chunks = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for Citations {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Citations"
    }
}

/// Defines additional types related to [Citations].
pub mod citations {
    #[allow(unused_imports)]
    use super::*;

    /// Piece of cited information.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct CitedChunk {
        /// URI used for citation.
        pub uri: std::string::String,

        /// Title of the cited document.
        pub title: std::string::String,

        /// Text used for citation.
        pub text: std::string::String,

        /// Whether this citation requires attribution to be shown to the end users.
        pub requires_attribution: bool,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl CitedChunk {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [uri][crate::model::citations::CitedChunk::uri].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::citations::CitedChunk;
        /// let x = CitedChunk::new().set_uri("example");
        /// ```
        pub fn set_uri<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.uri = v.into();
            self
        }

        /// Sets the value of [title][crate::model::citations::CitedChunk::title].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::citations::CitedChunk;
        /// let x = CitedChunk::new().set_title("example");
        /// ```
        pub fn set_title<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.title = v.into();
            self
        }

        /// Sets the value of [text][crate::model::citations::CitedChunk::text].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::citations::CitedChunk;
        /// let x = CitedChunk::new().set_text("example");
        /// ```
        pub fn set_text<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.text = v.into();
            self
        }

        /// Sets the value of [requires_attribution][crate::model::citations::CitedChunk::requires_attribution].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::citations::CitedChunk;
        /// let x = CitedChunk::new().set_requires_attribution(true);
        /// ```
        pub fn set_requires_attribution<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
            self.requires_attribution = v.into();
            self
        }
    }

    impl wkt::message::Message for CitedChunk {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.Citations.CitedChunk"
        }
    }
}

/// Event input.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Event {
    /// Required. The name of the event.
    pub event: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Event {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [event][crate::model::Event::event].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Event;
    /// let x = Event::new().set_event("example");
    /// ```
    pub fn set_event<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.event = v.into();
        self
    }
}

impl wkt::message::Message for Event {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Event"
    }
}

/// Input for the session.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct SessionInput {
    /// Optional. A flag to indicate if the current message is a fragment of a
    /// larger input in the bidi streaming session.
    ///
    /// When set to `true`, the agent defers processing until it receives a
    /// subsequent message where `will_continue` is `false`, or until the system
    /// detects an endpoint in the audio input.
    ///
    /// NOTE: This field does not apply to audio and DTMF inputs, as they are
    /// always processed automatically based on the endpointing signal.
    pub will_continue: bool,

    /// The type of the input.
    pub input_type: std::option::Option<crate::model::session_input::InputType>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl SessionInput {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [will_continue][crate::model::SessionInput::will_continue].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// let x = SessionInput::new().set_will_continue(true);
    /// ```
    pub fn set_will_continue<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.will_continue = v.into();
        self
    }

    /// Sets the value of [input_type][crate::model::SessionInput::input_type].
    ///
    /// Note that all the setters affecting `input_type` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// use google_cloud_ces_v1::model::session_input::InputType;
    /// let x = SessionInput::new().set_input_type(Some(InputType::Text("example".to_string())));
    /// ```
    pub fn set_input_type<
        T: std::convert::Into<std::option::Option<crate::model::session_input::InputType>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.input_type = v.into();
        self
    }

    /// The value of [input_type][crate::model::SessionInput::input_type]
    /// if it holds a `Text`, `None` if the field is not set or
    /// holds a different branch.
    pub fn text(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.input_type.as_ref().and_then(|v| match v {
            crate::model::session_input::InputType::Text(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [input_type][crate::model::SessionInput::input_type]
    /// to hold a `Text`.
    ///
    /// Note that all the setters affecting `input_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// let x = SessionInput::new().set_text("example");
    /// assert!(x.text().is_some());
    /// assert!(x.dtmf().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_responses().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.variables().is_none());
    /// assert!(x.event().is_none());
    /// ```
    pub fn set_text<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.input_type =
            std::option::Option::Some(crate::model::session_input::InputType::Text(v.into()));
        self
    }

    /// The value of [input_type][crate::model::SessionInput::input_type]
    /// if it holds a `Dtmf`, `None` if the field is not set or
    /// holds a different branch.
    pub fn dtmf(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.input_type.as_ref().and_then(|v| match v {
            crate::model::session_input::InputType::Dtmf(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [input_type][crate::model::SessionInput::input_type]
    /// to hold a `Dtmf`.
    ///
    /// Note that all the setters affecting `input_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// let x = SessionInput::new().set_dtmf("example");
    /// assert!(x.dtmf().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_responses().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.variables().is_none());
    /// assert!(x.event().is_none());
    /// ```
    pub fn set_dtmf<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.input_type =
            std::option::Option::Some(crate::model::session_input::InputType::Dtmf(v.into()));
        self
    }

    /// The value of [input_type][crate::model::SessionInput::input_type]
    /// if it holds a `Audio`, `None` if the field is not set or
    /// holds a different branch.
    pub fn audio(&self) -> std::option::Option<&::bytes::Bytes> {
        #[allow(unreachable_patterns)]
        self.input_type.as_ref().and_then(|v| match v {
            crate::model::session_input::InputType::Audio(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [input_type][crate::model::SessionInput::input_type]
    /// to hold a `Audio`.
    ///
    /// Note that all the setters affecting `input_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// let x = SessionInput::new().set_audio(bytes::Bytes::from_static(b"example"));
    /// assert!(x.audio().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.dtmf().is_none());
    /// assert!(x.tool_responses().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.variables().is_none());
    /// assert!(x.event().is_none());
    /// ```
    pub fn set_audio<T: std::convert::Into<::bytes::Bytes>>(mut self, v: T) -> Self {
        self.input_type =
            std::option::Option::Some(crate::model::session_input::InputType::Audio(v.into()));
        self
    }

    /// The value of [input_type][crate::model::SessionInput::input_type]
    /// if it holds a `ToolResponses`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool_responses(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::ToolResponses>> {
        #[allow(unreachable_patterns)]
        self.input_type.as_ref().and_then(|v| match v {
            crate::model::session_input::InputType::ToolResponses(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [input_type][crate::model::SessionInput::input_type]
    /// to hold a `ToolResponses`.
    ///
    /// Note that all the setters affecting `input_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// use google_cloud_ces_v1::model::ToolResponses;
    /// let x = SessionInput::new().set_tool_responses(ToolResponses::default()/* use setters */);
    /// assert!(x.tool_responses().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.dtmf().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.variables().is_none());
    /// assert!(x.event().is_none());
    /// ```
    pub fn set_tool_responses<
        T: std::convert::Into<std::boxed::Box<crate::model::ToolResponses>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.input_type = std::option::Option::Some(
            crate::model::session_input::InputType::ToolResponses(v.into()),
        );
        self
    }

    /// The value of [input_type][crate::model::SessionInput::input_type]
    /// if it holds a `Image`, `None` if the field is not set or
    /// holds a different branch.
    pub fn image(&self) -> std::option::Option<&std::boxed::Box<crate::model::Image>> {
        #[allow(unreachable_patterns)]
        self.input_type.as_ref().and_then(|v| match v {
            crate::model::session_input::InputType::Image(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [input_type][crate::model::SessionInput::input_type]
    /// to hold a `Image`.
    ///
    /// Note that all the setters affecting `input_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// use google_cloud_ces_v1::model::Image;
    /// let x = SessionInput::new().set_image(Image::default()/* use setters */);
    /// assert!(x.image().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.dtmf().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_responses().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.variables().is_none());
    /// assert!(x.event().is_none());
    /// ```
    pub fn set_image<T: std::convert::Into<std::boxed::Box<crate::model::Image>>>(
        mut self,
        v: T,
    ) -> Self {
        self.input_type =
            std::option::Option::Some(crate::model::session_input::InputType::Image(v.into()));
        self
    }

    /// The value of [input_type][crate::model::SessionInput::input_type]
    /// if it holds a `Blob`, `None` if the field is not set or
    /// holds a different branch.
    pub fn blob(&self) -> std::option::Option<&std::boxed::Box<crate::model::Blob>> {
        #[allow(unreachable_patterns)]
        self.input_type.as_ref().and_then(|v| match v {
            crate::model::session_input::InputType::Blob(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [input_type][crate::model::SessionInput::input_type]
    /// to hold a `Blob`.
    ///
    /// Note that all the setters affecting `input_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// use google_cloud_ces_v1::model::Blob;
    /// let x = SessionInput::new().set_blob(Blob::default()/* use setters */);
    /// assert!(x.blob().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.dtmf().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_responses().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.variables().is_none());
    /// assert!(x.event().is_none());
    /// ```
    pub fn set_blob<T: std::convert::Into<std::boxed::Box<crate::model::Blob>>>(
        mut self,
        v: T,
    ) -> Self {
        self.input_type =
            std::option::Option::Some(crate::model::session_input::InputType::Blob(v.into()));
        self
    }

    /// The value of [input_type][crate::model::SessionInput::input_type]
    /// if it holds a `Variables`, `None` if the field is not set or
    /// holds a different branch.
    pub fn variables(&self) -> std::option::Option<&std::boxed::Box<wkt::Struct>> {
        #[allow(unreachable_patterns)]
        self.input_type.as_ref().and_then(|v| match v {
            crate::model::session_input::InputType::Variables(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [input_type][crate::model::SessionInput::input_type]
    /// to hold a `Variables`.
    ///
    /// Note that all the setters affecting `input_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// use wkt::Struct;
    /// let x = SessionInput::new().set_variables(Struct::default()/* use setters */);
    /// assert!(x.variables().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.dtmf().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_responses().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.event().is_none());
    /// ```
    pub fn set_variables<T: std::convert::Into<std::boxed::Box<wkt::Struct>>>(
        mut self,
        v: T,
    ) -> Self {
        self.input_type =
            std::option::Option::Some(crate::model::session_input::InputType::Variables(v.into()));
        self
    }

    /// The value of [input_type][crate::model::SessionInput::input_type]
    /// if it holds a `Event`, `None` if the field is not set or
    /// holds a different branch.
    pub fn event(&self) -> std::option::Option<&std::boxed::Box<crate::model::Event>> {
        #[allow(unreachable_patterns)]
        self.input_type.as_ref().and_then(|v| match v {
            crate::model::session_input::InputType::Event(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [input_type][crate::model::SessionInput::input_type]
    /// to hold a `Event`.
    ///
    /// Note that all the setters affecting `input_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionInput;
    /// use google_cloud_ces_v1::model::Event;
    /// let x = SessionInput::new().set_event(Event::default()/* use setters */);
    /// assert!(x.event().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.dtmf().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_responses().is_none());
    /// assert!(x.image().is_none());
    /// assert!(x.blob().is_none());
    /// assert!(x.variables().is_none());
    /// ```
    pub fn set_event<T: std::convert::Into<std::boxed::Box<crate::model::Event>>>(
        mut self,
        v: T,
    ) -> Self {
        self.input_type =
            std::option::Option::Some(crate::model::session_input::InputType::Event(v.into()));
        self
    }
}

impl wkt::message::Message for SessionInput {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.SessionInput"
    }
}

/// Defines additional types related to [SessionInput].
pub mod session_input {
    #[allow(unused_imports)]
    use super::*;

    /// The type of the input.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum InputType {
        /// Optional. Text data from the end user.
        Text(std::string::String),
        /// Optional. DTMF digits from the end user.
        Dtmf(std::string::String),
        /// Optional. Audio data from the end user.
        Audio(::bytes::Bytes),
        /// Optional. Execution results for the tool calls from the client.
        ToolResponses(std::boxed::Box<crate::model::ToolResponses>),
        /// Optional. Image data from the end user.
        Image(std::boxed::Box<crate::model::Image>),
        /// Optional. Blob data from the end user.
        Blob(std::boxed::Box<crate::model::Blob>),
        /// Optional. Contextual variables for the session, keyed by name. Only
        /// variables declared in the app will be used by the CES agent.
        ///
        /// Unrecognized variables will still be sent to the [Dialogflow
        /// agent][Agent.RemoteDialogflowAgent] as additional session parameters.
        ///
        /// [Agent.RemoteDialogflowAgent]: crate::model::agent::RemoteDialogflowAgent
        Variables(std::boxed::Box<wkt::Struct>),
        /// Optional. Event input.
        Event(std::boxed::Box<crate::model::Event>),
    }
}

/// Output for the session.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct SessionOutput {
    /// Indicates the sequential order of conversation turn to which this output
    /// belongs to, starting from 1.
    pub turn_index: i32,

    /// If true, the CES agent has detected the end of the current conversation
    /// turn and will provide no further output for this turn.
    pub turn_completed: bool,

    /// Optional. Diagnostic information contains execution details during the
    /// processing of the input. Only populated in the last SessionOutput (with
    /// `turn_completed=true`) for each turn.
    pub diagnostic_info: std::option::Option<crate::model::session_output::DiagnosticInfo>,

    /// Context messages for external supervision guardrails.
    pub context: std::vec::Vec<wkt::Any>,

    /// The type of the output.
    pub output_type: std::option::Option<crate::model::session_output::OutputType>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl SessionOutput {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [turn_index][crate::model::SessionOutput::turn_index].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// let x = SessionOutput::new().set_turn_index(42);
    /// ```
    pub fn set_turn_index<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.turn_index = v.into();
        self
    }

    /// Sets the value of [turn_completed][crate::model::SessionOutput::turn_completed].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// let x = SessionOutput::new().set_turn_completed(true);
    /// ```
    pub fn set_turn_completed<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.turn_completed = v.into();
        self
    }

    /// Sets the value of [diagnostic_info][crate::model::SessionOutput::diagnostic_info].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// use google_cloud_ces_v1::model::session_output::DiagnosticInfo;
    /// let x = SessionOutput::new().set_diagnostic_info(DiagnosticInfo::default()/* use setters */);
    /// ```
    pub fn set_diagnostic_info<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::session_output::DiagnosticInfo>,
    {
        self.diagnostic_info = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [diagnostic_info][crate::model::SessionOutput::diagnostic_info].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// use google_cloud_ces_v1::model::session_output::DiagnosticInfo;
    /// let x = SessionOutput::new().set_or_clear_diagnostic_info(Some(DiagnosticInfo::default()/* use setters */));
    /// let x = SessionOutput::new().set_or_clear_diagnostic_info(None::<DiagnosticInfo>);
    /// ```
    pub fn set_or_clear_diagnostic_info<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::session_output::DiagnosticInfo>,
    {
        self.diagnostic_info = v.map(|x| x.into());
        self
    }

    /// Sets the value of [context][crate::model::SessionOutput::context].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// use wkt::Any;
    /// let x = SessionOutput::new()
    ///     .set_context([
    ///         Any::default()/* use setters */,
    ///         Any::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_context<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<wkt::Any>,
    {
        use std::iter::Iterator;
        self.context = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [output_type][crate::model::SessionOutput::output_type].
    ///
    /// Note that all the setters affecting `output_type` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// use google_cloud_ces_v1::model::session_output::OutputType;
    /// let x = SessionOutput::new().set_output_type(Some(OutputType::Text("example".to_string())));
    /// ```
    pub fn set_output_type<
        T: std::convert::Into<std::option::Option<crate::model::session_output::OutputType>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.output_type = v.into();
        self
    }

    /// The value of [output_type][crate::model::SessionOutput::output_type]
    /// if it holds a `Text`, `None` if the field is not set or
    /// holds a different branch.
    pub fn text(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.output_type.as_ref().and_then(|v| match v {
            crate::model::session_output::OutputType::Text(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [output_type][crate::model::SessionOutput::output_type]
    /// to hold a `Text`.
    ///
    /// Note that all the setters affecting `output_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// let x = SessionOutput::new().set_text("example");
    /// assert!(x.text().is_some());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_calls().is_none());
    /// assert!(x.citations().is_none());
    /// assert!(x.google_search_suggestions().is_none());
    /// assert!(x.end_session().is_none());
    /// assert!(x.payload().is_none());
    /// ```
    pub fn set_text<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.output_type =
            std::option::Option::Some(crate::model::session_output::OutputType::Text(v.into()));
        self
    }

    /// The value of [output_type][crate::model::SessionOutput::output_type]
    /// if it holds a `Audio`, `None` if the field is not set or
    /// holds a different branch.
    pub fn audio(&self) -> std::option::Option<&::bytes::Bytes> {
        #[allow(unreachable_patterns)]
        self.output_type.as_ref().and_then(|v| match v {
            crate::model::session_output::OutputType::Audio(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [output_type][crate::model::SessionOutput::output_type]
    /// to hold a `Audio`.
    ///
    /// Note that all the setters affecting `output_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// let x = SessionOutput::new().set_audio(bytes::Bytes::from_static(b"example"));
    /// assert!(x.audio().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.tool_calls().is_none());
    /// assert!(x.citations().is_none());
    /// assert!(x.google_search_suggestions().is_none());
    /// assert!(x.end_session().is_none());
    /// assert!(x.payload().is_none());
    /// ```
    pub fn set_audio<T: std::convert::Into<::bytes::Bytes>>(mut self, v: T) -> Self {
        self.output_type =
            std::option::Option::Some(crate::model::session_output::OutputType::Audio(v.into()));
        self
    }

    /// The value of [output_type][crate::model::SessionOutput::output_type]
    /// if it holds a `ToolCalls`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool_calls(&self) -> std::option::Option<&std::boxed::Box<crate::model::ToolCalls>> {
        #[allow(unreachable_patterns)]
        self.output_type.as_ref().and_then(|v| match v {
            crate::model::session_output::OutputType::ToolCalls(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [output_type][crate::model::SessionOutput::output_type]
    /// to hold a `ToolCalls`.
    ///
    /// Note that all the setters affecting `output_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// use google_cloud_ces_v1::model::ToolCalls;
    /// let x = SessionOutput::new().set_tool_calls(ToolCalls::default()/* use setters */);
    /// assert!(x.tool_calls().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.citations().is_none());
    /// assert!(x.google_search_suggestions().is_none());
    /// assert!(x.end_session().is_none());
    /// assert!(x.payload().is_none());
    /// ```
    pub fn set_tool_calls<T: std::convert::Into<std::boxed::Box<crate::model::ToolCalls>>>(
        mut self,
        v: T,
    ) -> Self {
        self.output_type = std::option::Option::Some(
            crate::model::session_output::OutputType::ToolCalls(v.into()),
        );
        self
    }

    /// The value of [output_type][crate::model::SessionOutput::output_type]
    /// if it holds a `Citations`, `None` if the field is not set or
    /// holds a different branch.
    pub fn citations(&self) -> std::option::Option<&std::boxed::Box<crate::model::Citations>> {
        #[allow(unreachable_patterns)]
        self.output_type.as_ref().and_then(|v| match v {
            crate::model::session_output::OutputType::Citations(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [output_type][crate::model::SessionOutput::output_type]
    /// to hold a `Citations`.
    ///
    /// Note that all the setters affecting `output_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// use google_cloud_ces_v1::model::Citations;
    /// let x = SessionOutput::new().set_citations(Citations::default()/* use setters */);
    /// assert!(x.citations().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_calls().is_none());
    /// assert!(x.google_search_suggestions().is_none());
    /// assert!(x.end_session().is_none());
    /// assert!(x.payload().is_none());
    /// ```
    pub fn set_citations<T: std::convert::Into<std::boxed::Box<crate::model::Citations>>>(
        mut self,
        v: T,
    ) -> Self {
        self.output_type = std::option::Option::Some(
            crate::model::session_output::OutputType::Citations(v.into()),
        );
        self
    }

    /// The value of [output_type][crate::model::SessionOutput::output_type]
    /// if it holds a `GoogleSearchSuggestions`, `None` if the field is not set or
    /// holds a different branch.
    pub fn google_search_suggestions(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::GoogleSearchSuggestions>> {
        #[allow(unreachable_patterns)]
        self.output_type.as_ref().and_then(|v| match v {
            crate::model::session_output::OutputType::GoogleSearchSuggestions(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [output_type][crate::model::SessionOutput::output_type]
    /// to hold a `GoogleSearchSuggestions`.
    ///
    /// Note that all the setters affecting `output_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// use google_cloud_ces_v1::model::GoogleSearchSuggestions;
    /// let x = SessionOutput::new().set_google_search_suggestions(GoogleSearchSuggestions::default()/* use setters */);
    /// assert!(x.google_search_suggestions().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_calls().is_none());
    /// assert!(x.citations().is_none());
    /// assert!(x.end_session().is_none());
    /// assert!(x.payload().is_none());
    /// ```
    pub fn set_google_search_suggestions<
        T: std::convert::Into<std::boxed::Box<crate::model::GoogleSearchSuggestions>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.output_type = std::option::Option::Some(
            crate::model::session_output::OutputType::GoogleSearchSuggestions(v.into()),
        );
        self
    }

    /// The value of [output_type][crate::model::SessionOutput::output_type]
    /// if it holds a `EndSession`, `None` if the field is not set or
    /// holds a different branch.
    pub fn end_session(&self) -> std::option::Option<&std::boxed::Box<crate::model::EndSession>> {
        #[allow(unreachable_patterns)]
        self.output_type.as_ref().and_then(|v| match v {
            crate::model::session_output::OutputType::EndSession(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [output_type][crate::model::SessionOutput::output_type]
    /// to hold a `EndSession`.
    ///
    /// Note that all the setters affecting `output_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// use google_cloud_ces_v1::model::EndSession;
    /// let x = SessionOutput::new().set_end_session(EndSession::default()/* use setters */);
    /// assert!(x.end_session().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_calls().is_none());
    /// assert!(x.citations().is_none());
    /// assert!(x.google_search_suggestions().is_none());
    /// assert!(x.payload().is_none());
    /// ```
    pub fn set_end_session<T: std::convert::Into<std::boxed::Box<crate::model::EndSession>>>(
        mut self,
        v: T,
    ) -> Self {
        self.output_type = std::option::Option::Some(
            crate::model::session_output::OutputType::EndSession(v.into()),
        );
        self
    }

    /// The value of [output_type][crate::model::SessionOutput::output_type]
    /// if it holds a `Payload`, `None` if the field is not set or
    /// holds a different branch.
    pub fn payload(&self) -> std::option::Option<&std::boxed::Box<wkt::Struct>> {
        #[allow(unreachable_patterns)]
        self.output_type.as_ref().and_then(|v| match v {
            crate::model::session_output::OutputType::Payload(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [output_type][crate::model::SessionOutput::output_type]
    /// to hold a `Payload`.
    ///
    /// Note that all the setters affecting `output_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SessionOutput;
    /// use wkt::Struct;
    /// let x = SessionOutput::new().set_payload(Struct::default()/* use setters */);
    /// assert!(x.payload().is_some());
    /// assert!(x.text().is_none());
    /// assert!(x.audio().is_none());
    /// assert!(x.tool_calls().is_none());
    /// assert!(x.citations().is_none());
    /// assert!(x.google_search_suggestions().is_none());
    /// assert!(x.end_session().is_none());
    /// ```
    pub fn set_payload<T: std::convert::Into<std::boxed::Box<wkt::Struct>>>(
        mut self,
        v: T,
    ) -> Self {
        self.output_type =
            std::option::Option::Some(crate::model::session_output::OutputType::Payload(v.into()));
        self
    }
}

impl wkt::message::Message for SessionOutput {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.SessionOutput"
    }
}

/// Defines additional types related to [SessionOutput].
pub mod session_output {
    #[allow(unused_imports)]
    use super::*;

    /// Contains execution details during the processing.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct DiagnosticInfo {
        /// List of the messages that happened during the processing.
        pub messages: std::vec::Vec<crate::model::Message>,

        /// A trace of the entire request processing, represented as a root span.
        /// This span can contain nested child spans for specific operations.
        pub root_span: std::option::Option<crate::model::Span>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl DiagnosticInfo {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [messages][crate::model::session_output::DiagnosticInfo::messages].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::session_output::DiagnosticInfo;
        /// use google_cloud_ces_v1::model::Message;
        /// let x = DiagnosticInfo::new()
        ///     .set_messages([
        ///         Message::default()/* use setters */,
        ///         Message::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_messages<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::Message>,
        {
            use std::iter::Iterator;
            self.messages = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [root_span][crate::model::session_output::DiagnosticInfo::root_span].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::session_output::DiagnosticInfo;
        /// use google_cloud_ces_v1::model::Span;
        /// let x = DiagnosticInfo::new().set_root_span(Span::default()/* use setters */);
        /// ```
        pub fn set_root_span<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::Span>,
        {
            self.root_span = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [root_span][crate::model::session_output::DiagnosticInfo::root_span].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::session_output::DiagnosticInfo;
        /// use google_cloud_ces_v1::model::Span;
        /// let x = DiagnosticInfo::new().set_or_clear_root_span(Some(Span::default()/* use setters */));
        /// let x = DiagnosticInfo::new().set_or_clear_root_span(None::<Span>);
        /// ```
        pub fn set_or_clear_root_span<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::Span>,
        {
            self.root_span = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for DiagnosticInfo {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.SessionOutput.DiagnosticInfo"
        }
    }

    /// The type of the output.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum OutputType {
        /// Output text from the CES agent.
        Text(std::string::String),
        /// Output audio from the CES agent.
        Audio(::bytes::Bytes),
        /// Request for the client to execute the tools.
        ToolCalls(std::boxed::Box<crate::model::ToolCalls>),
        /// Citations that provide the source information for the agent's generated
        /// text.
        Citations(std::boxed::Box<crate::model::Citations>),
        /// The suggestions returned from Google Search as a result of invoking the
        /// [GoogleSearchTool][google.cloud.ces.v1.GoogleSearchTool].
        ///
        /// [google.cloud.ces.v1.GoogleSearchTool]: crate::model::GoogleSearchTool
        GoogleSearchSuggestions(std::boxed::Box<crate::model::GoogleSearchSuggestions>),
        /// Indicates the session has ended.
        EndSession(std::boxed::Box<crate::model::EndSession>),
        /// Custom payload with structured output from the CES agent.
        Payload(std::boxed::Box<wkt::Struct>),
    }
}

/// Speech recognition result for the audio input.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RecognitionResult {
    /// Optional. Concatenated user speech segments captured during the current
    /// turn.
    pub transcript: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RecognitionResult {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [transcript][crate::model::RecognitionResult::transcript].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RecognitionResult;
    /// let x = RecognitionResult::new().set_transcript("example");
    /// ```
    pub fn set_transcript<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.transcript = v.into();
        self
    }
}

impl wkt::message::Message for RecognitionResult {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RecognitionResult"
    }
}

/// Indicates the agent's audio response has been interrupted. The client should
/// immediately stop any current audio playback (e.g., due to user barge-in or
/// a new agent response being generated).
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct InterruptionSignal {
    /// Whether the interruption is caused by a user barge-in event.
    pub barge_in: bool,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl InterruptionSignal {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [barge_in][crate::model::InterruptionSignal::barge_in].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::InterruptionSignal;
    /// let x = InterruptionSignal::new().set_barge_in(true);
    /// ```
    pub fn set_barge_in<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.barge_in = v.into();
        self
    }
}

impl wkt::message::Message for InterruptionSignal {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.InterruptionSignal"
    }
}

/// Indicates the session has terminated, due to either successful completion
/// (e.g. user says "Good bye!" ) or an agent escalation.
///
/// The agent will not process any further inputs after session is terminated and
/// the client should half-close and disconnect after receiving all remaining
/// responses from the agent.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct EndSession {
    /// Optional. Provides additional information about the end session signal,
    /// such as the reason for ending the session.
    pub metadata: std::option::Option<wkt::Struct>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl EndSession {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [metadata][crate::model::EndSession::metadata].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EndSession;
    /// use wkt::Struct;
    /// let x = EndSession::new().set_metadata(Struct::default()/* use setters */);
    /// ```
    pub fn set_metadata<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.metadata = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [metadata][crate::model::EndSession::metadata].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::EndSession;
    /// use wkt::Struct;
    /// let x = EndSession::new().set_or_clear_metadata(Some(Struct::default()/* use setters */));
    /// let x = EndSession::new().set_or_clear_metadata(None::<Struct>);
    /// ```
    pub fn set_or_clear_metadata<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.metadata = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for EndSession {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.EndSession"
    }
}

/// Indicates that the server will disconnect soon and the client should
/// half-close and restart the connection.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GoAway {
    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GoAway {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }
}

impl wkt::message::Message for GoAway {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GoAway"
    }
}

/// Request message for
/// [SessionService.RunSession][google.cloud.ces.v1.SessionService.RunSession].
///
/// [google.cloud.ces.v1.SessionService.RunSession]: crate::client::SessionService::run_session
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RunSessionRequest {
    /// Required. The configuration for the session.
    pub config: std::option::Option<crate::model::SessionConfig>,

    /// Required. Inputs for the session.
    pub inputs: std::vec::Vec<crate::model::SessionInput>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RunSessionRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [config][crate::model::RunSessionRequest::config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RunSessionRequest;
    /// use google_cloud_ces_v1::model::SessionConfig;
    /// let x = RunSessionRequest::new().set_config(SessionConfig::default()/* use setters */);
    /// ```
    pub fn set_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::SessionConfig>,
    {
        self.config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [config][crate::model::RunSessionRequest::config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RunSessionRequest;
    /// use google_cloud_ces_v1::model::SessionConfig;
    /// let x = RunSessionRequest::new().set_or_clear_config(Some(SessionConfig::default()/* use setters */));
    /// let x = RunSessionRequest::new().set_or_clear_config(None::<SessionConfig>);
    /// ```
    pub fn set_or_clear_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::SessionConfig>,
    {
        self.config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [inputs][crate::model::RunSessionRequest::inputs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RunSessionRequest;
    /// use google_cloud_ces_v1::model::SessionInput;
    /// let x = RunSessionRequest::new()
    ///     .set_inputs([
    ///         SessionInput::default()/* use setters */,
    ///         SessionInput::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_inputs<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::SessionInput>,
    {
        use std::iter::Iterator;
        self.inputs = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for RunSessionRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RunSessionRequest"
    }
}

/// Response message for
/// [SessionService.RunSession][google.cloud.ces.v1.SessionService.RunSession].
///
/// [google.cloud.ces.v1.SessionService.RunSession]: crate::client::SessionService::run_session
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RunSessionResponse {
    /// Outputs for the session.
    pub outputs: std::vec::Vec<crate::model::SessionOutput>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RunSessionResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [outputs][crate::model::RunSessionResponse::outputs].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RunSessionResponse;
    /// use google_cloud_ces_v1::model::SessionOutput;
    /// let x = RunSessionResponse::new()
    ///     .set_outputs([
    ///         SessionOutput::default()/* use setters */,
    ///         SessionOutput::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_outputs<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::SessionOutput>,
    {
        use std::iter::Iterator;
        self.outputs = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for RunSessionResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RunSessionResponse"
    }
}

/// The top-level message sent by the client for the
/// [SessionService.BidiRunSession][google.cloud.ces.v1.SessionService.BidiRunSession]
/// method.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct BidiSessionClientMessage {
    /// The type of the message.
    pub message_type: std::option::Option<crate::model::bidi_session_client_message::MessageType>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl BidiSessionClientMessage {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [message_type][crate::model::BidiSessionClientMessage::message_type].
    ///
    /// Note that all the setters affecting `message_type` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BidiSessionClientMessage;
    /// use google_cloud_ces_v1::model::SessionConfig;
    /// let x = BidiSessionClientMessage::new().set_message_type(Some(
    ///     google_cloud_ces_v1::model::bidi_session_client_message::MessageType::Config(SessionConfig::default().into())));
    /// ```
    pub fn set_message_type<
        T: std::convert::Into<
                std::option::Option<crate::model::bidi_session_client_message::MessageType>,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.message_type = v.into();
        self
    }

    /// The value of [message_type][crate::model::BidiSessionClientMessage::message_type]
    /// if it holds a `Config`, `None` if the field is not set or
    /// holds a different branch.
    pub fn config(&self) -> std::option::Option<&std::boxed::Box<crate::model::SessionConfig>> {
        #[allow(unreachable_patterns)]
        self.message_type.as_ref().and_then(|v| match v {
            crate::model::bidi_session_client_message::MessageType::Config(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [message_type][crate::model::BidiSessionClientMessage::message_type]
    /// to hold a `Config`.
    ///
    /// Note that all the setters affecting `message_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BidiSessionClientMessage;
    /// use google_cloud_ces_v1::model::SessionConfig;
    /// let x = BidiSessionClientMessage::new().set_config(SessionConfig::default()/* use setters */);
    /// assert!(x.config().is_some());
    /// assert!(x.realtime_input().is_none());
    /// ```
    pub fn set_config<T: std::convert::Into<std::boxed::Box<crate::model::SessionConfig>>>(
        mut self,
        v: T,
    ) -> Self {
        self.message_type = std::option::Option::Some(
            crate::model::bidi_session_client_message::MessageType::Config(v.into()),
        );
        self
    }

    /// The value of [message_type][crate::model::BidiSessionClientMessage::message_type]
    /// if it holds a `RealtimeInput`, `None` if the field is not set or
    /// holds a different branch.
    pub fn realtime_input(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::SessionInput>> {
        #[allow(unreachable_patterns)]
        self.message_type.as_ref().and_then(|v| match v {
            crate::model::bidi_session_client_message::MessageType::RealtimeInput(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [message_type][crate::model::BidiSessionClientMessage::message_type]
    /// to hold a `RealtimeInput`.
    ///
    /// Note that all the setters affecting `message_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BidiSessionClientMessage;
    /// use google_cloud_ces_v1::model::SessionInput;
    /// let x = BidiSessionClientMessage::new().set_realtime_input(SessionInput::default()/* use setters */);
    /// assert!(x.realtime_input().is_some());
    /// assert!(x.config().is_none());
    /// ```
    pub fn set_realtime_input<
        T: std::convert::Into<std::boxed::Box<crate::model::SessionInput>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.message_type = std::option::Option::Some(
            crate::model::bidi_session_client_message::MessageType::RealtimeInput(v.into()),
        );
        self
    }
}

impl wkt::message::Message for BidiSessionClientMessage {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.BidiSessionClientMessage"
    }
}

/// Defines additional types related to [BidiSessionClientMessage].
pub mod bidi_session_client_message {
    #[allow(unused_imports)]
    use super::*;

    /// The type of the message.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum MessageType {
        /// Optional. The initial config message for the session.
        Config(std::boxed::Box<crate::model::SessionConfig>),
        /// Optional. Realtime input for the session.
        RealtimeInput(std::boxed::Box<crate::model::SessionInput>),
    }
}

/// The top-level message returned from
/// [SessionService.BidiRunSession][google.cloud.ces.v1.SessionService.BidiRunSession]
/// method.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct BidiSessionServerMessage {
    /// The type of the message.
    pub message_type: std::option::Option<crate::model::bidi_session_server_message::MessageType>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl BidiSessionServerMessage {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [message_type][crate::model::BidiSessionServerMessage::message_type].
    ///
    /// Note that all the setters affecting `message_type` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BidiSessionServerMessage;
    /// use google_cloud_ces_v1::model::SessionOutput;
    /// let x = BidiSessionServerMessage::new().set_message_type(Some(
    ///     google_cloud_ces_v1::model::bidi_session_server_message::MessageType::SessionOutput(SessionOutput::default().into())));
    /// ```
    pub fn set_message_type<
        T: std::convert::Into<
                std::option::Option<crate::model::bidi_session_server_message::MessageType>,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.message_type = v.into();
        self
    }

    /// The value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// if it holds a `SessionOutput`, `None` if the field is not set or
    /// holds a different branch.
    pub fn session_output(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::SessionOutput>> {
        #[allow(unreachable_patterns)]
        self.message_type.as_ref().and_then(|v| match v {
            crate::model::bidi_session_server_message::MessageType::SessionOutput(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// to hold a `SessionOutput`.
    ///
    /// Note that all the setters affecting `message_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BidiSessionServerMessage;
    /// use google_cloud_ces_v1::model::SessionOutput;
    /// let x = BidiSessionServerMessage::new().set_session_output(SessionOutput::default()/* use setters */);
    /// assert!(x.session_output().is_some());
    /// assert!(x.recognition_result().is_none());
    /// assert!(x.interruption_signal().is_none());
    /// assert!(x.end_session().is_none());
    /// assert!(x.go_away().is_none());
    /// ```
    pub fn set_session_output<
        T: std::convert::Into<std::boxed::Box<crate::model::SessionOutput>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.message_type = std::option::Option::Some(
            crate::model::bidi_session_server_message::MessageType::SessionOutput(v.into()),
        );
        self
    }

    /// The value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// if it holds a `RecognitionResult`, `None` if the field is not set or
    /// holds a different branch.
    pub fn recognition_result(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::RecognitionResult>> {
        #[allow(unreachable_patterns)]
        self.message_type.as_ref().and_then(|v| match v {
            crate::model::bidi_session_server_message::MessageType::RecognitionResult(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// to hold a `RecognitionResult`.
    ///
    /// Note that all the setters affecting `message_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BidiSessionServerMessage;
    /// use google_cloud_ces_v1::model::RecognitionResult;
    /// let x = BidiSessionServerMessage::new().set_recognition_result(RecognitionResult::default()/* use setters */);
    /// assert!(x.recognition_result().is_some());
    /// assert!(x.session_output().is_none());
    /// assert!(x.interruption_signal().is_none());
    /// assert!(x.end_session().is_none());
    /// assert!(x.go_away().is_none());
    /// ```
    pub fn set_recognition_result<
        T: std::convert::Into<std::boxed::Box<crate::model::RecognitionResult>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.message_type = std::option::Option::Some(
            crate::model::bidi_session_server_message::MessageType::RecognitionResult(v.into()),
        );
        self
    }

    /// The value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// if it holds a `InterruptionSignal`, `None` if the field is not set or
    /// holds a different branch.
    pub fn interruption_signal(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::InterruptionSignal>> {
        #[allow(unreachable_patterns)]
        self.message_type.as_ref().and_then(|v| match v {
            crate::model::bidi_session_server_message::MessageType::InterruptionSignal(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// to hold a `InterruptionSignal`.
    ///
    /// Note that all the setters affecting `message_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BidiSessionServerMessage;
    /// use google_cloud_ces_v1::model::InterruptionSignal;
    /// let x = BidiSessionServerMessage::new().set_interruption_signal(InterruptionSignal::default()/* use setters */);
    /// assert!(x.interruption_signal().is_some());
    /// assert!(x.session_output().is_none());
    /// assert!(x.recognition_result().is_none());
    /// assert!(x.end_session().is_none());
    /// assert!(x.go_away().is_none());
    /// ```
    pub fn set_interruption_signal<
        T: std::convert::Into<std::boxed::Box<crate::model::InterruptionSignal>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.message_type = std::option::Option::Some(
            crate::model::bidi_session_server_message::MessageType::InterruptionSignal(v.into()),
        );
        self
    }

    /// The value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// if it holds a `EndSession`, `None` if the field is not set or
    /// holds a different branch.
    pub fn end_session(&self) -> std::option::Option<&std::boxed::Box<crate::model::EndSession>> {
        #[allow(unreachable_patterns)]
        self.message_type.as_ref().and_then(|v| match v {
            crate::model::bidi_session_server_message::MessageType::EndSession(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// to hold a `EndSession`.
    ///
    /// Note that all the setters affecting `message_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BidiSessionServerMessage;
    /// use google_cloud_ces_v1::model::EndSession;
    /// let x = BidiSessionServerMessage::new().set_end_session(EndSession::default()/* use setters */);
    /// assert!(x.end_session().is_some());
    /// assert!(x.session_output().is_none());
    /// assert!(x.recognition_result().is_none());
    /// assert!(x.interruption_signal().is_none());
    /// assert!(x.go_away().is_none());
    /// ```
    pub fn set_end_session<T: std::convert::Into<std::boxed::Box<crate::model::EndSession>>>(
        mut self,
        v: T,
    ) -> Self {
        self.message_type = std::option::Option::Some(
            crate::model::bidi_session_server_message::MessageType::EndSession(v.into()),
        );
        self
    }

    /// The value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// if it holds a `GoAway`, `None` if the field is not set or
    /// holds a different branch.
    pub fn go_away(&self) -> std::option::Option<&std::boxed::Box<crate::model::GoAway>> {
        #[allow(unreachable_patterns)]
        self.message_type.as_ref().and_then(|v| match v {
            crate::model::bidi_session_server_message::MessageType::GoAway(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [message_type][crate::model::BidiSessionServerMessage::message_type]
    /// to hold a `GoAway`.
    ///
    /// Note that all the setters affecting `message_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::BidiSessionServerMessage;
    /// use google_cloud_ces_v1::model::GoAway;
    /// let x = BidiSessionServerMessage::new().set_go_away(GoAway::default()/* use setters */);
    /// assert!(x.go_away().is_some());
    /// assert!(x.session_output().is_none());
    /// assert!(x.recognition_result().is_none());
    /// assert!(x.interruption_signal().is_none());
    /// assert!(x.end_session().is_none());
    /// ```
    pub fn set_go_away<T: std::convert::Into<std::boxed::Box<crate::model::GoAway>>>(
        mut self,
        v: T,
    ) -> Self {
        self.message_type = std::option::Option::Some(
            crate::model::bidi_session_server_message::MessageType::GoAway(v.into()),
        );
        self
    }
}

impl wkt::message::Message for BidiSessionServerMessage {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.BidiSessionServerMessage"
    }
}

/// Defines additional types related to [BidiSessionServerMessage].
pub mod bidi_session_server_message {
    #[allow(unused_imports)]
    use super::*;

    /// The type of the message.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum MessageType {
        /// Optional. Processing result from the CES agent.
        SessionOutput(std::boxed::Box<crate::model::SessionOutput>),
        /// Optional. Realtime speech recognition result for the audio input.
        RecognitionResult(std::boxed::Box<crate::model::RecognitionResult>),
        /// Optional. Indicates the agent's audio response has been interrupted.
        InterruptionSignal(std::boxed::Box<crate::model::InterruptionSignal>),
        /// Optional. Indicates that the session has ended.
        EndSession(std::boxed::Box<crate::model::EndSession>),
        /// Optional. Indicates that the server will disconnect soon and the client
        /// should half-close and restart the connection.
        GoAway(std::boxed::Box<crate::model::GoAway>),
    }
}

/// Pre-defined system tool.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct SystemTool {
    /// Required. The name of the system tool.
    pub name: std::string::String,

    /// Output only. The description of the system tool.
    pub description: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl SystemTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::SystemTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SystemTool;
    /// let x = SystemTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::SystemTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::SystemTool;
    /// let x = SystemTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }
}

impl wkt::message::Message for SystemTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.SystemTool"
    }
}

/// A tool represents an action that the CES agent can take to achieve certain
/// goals.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Tool {
    /// Identifier. The resource name of the tool. Format:
    ///
    /// * `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
    ///   for standalone tools.
    /// * `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}/tools/{tool}`
    ///   for tools retrieved from a toolset.
    ///
    /// These tools are dynamic and output-only; they cannot be referenced directly
    /// where a tool is expected.
    pub name: std::string::String,

    /// Output only. The display name of the tool, derived based on the tool's
    /// type. For example, display name of a [ClientFunction][Tool.ClientFunction]
    /// is derived from its `name` property.
    pub display_name: std::string::String,

    /// Optional. The execution type of the tool.
    pub execution_type: crate::model::ExecutionType,

    /// Optional. The timeout for the tool execution. If not set, the default
    /// timeout is 30 seconds for `SYNCHRONOUS` tools and 60 seconds for
    /// `ASYNCHRONOUS` tools.
    pub timeout: std::option::Option<wkt::Duration>,

    /// Output only. Timestamp when the tool was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Timestamp when the tool was last updated.
    pub update_time: std::option::Option<wkt::Timestamp>,

    /// 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.
    pub etag: std::string::String,

    /// Output only. If the tool is generated by the LLM assistant, this field
    /// contains a descriptive summary of the generation.
    pub generated_summary: std::string::String,

    /// Optional. Configuration for tool behavior in fake mode.
    pub tool_fake_config: std::option::Option<crate::model::ToolFakeConfig>,

    /// The type of the tool.
    pub tool_type: std::option::Option<crate::model::tool::ToolType>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Tool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Tool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = Tool::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::Tool::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// let x = Tool::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [execution_type][crate::model::Tool::execution_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::ExecutionType;
    /// let x0 = Tool::new().set_execution_type(ExecutionType::Synchronous);
    /// let x1 = Tool::new().set_execution_type(ExecutionType::Asynchronous);
    /// ```
    pub fn set_execution_type<T: std::convert::Into<crate::model::ExecutionType>>(
        mut self,
        v: T,
    ) -> Self {
        self.execution_type = v.into();
        self
    }

    /// Sets the value of [timeout][crate::model::Tool::timeout].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use wkt::Duration;
    /// let x = Tool::new().set_timeout(Duration::default()/* use setters */);
    /// ```
    pub fn set_timeout<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.timeout = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [timeout][crate::model::Tool::timeout].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use wkt::Duration;
    /// let x = Tool::new().set_or_clear_timeout(Some(Duration::default()/* use setters */));
    /// let x = Tool::new().set_or_clear_timeout(None::<Duration>);
    /// ```
    pub fn set_or_clear_timeout<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.timeout = v.map(|x| x.into());
        self
    }

    /// Sets the value of [create_time][crate::model::Tool::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use wkt::Timestamp;
    /// let x = Tool::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::Tool::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use wkt::Timestamp;
    /// let x = Tool::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = Tool::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::Tool::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use wkt::Timestamp;
    /// let x = Tool::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::Tool::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use wkt::Timestamp;
    /// let x = Tool::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = Tool::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [etag][crate::model::Tool::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// let x = Tool::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }

    /// Sets the value of [generated_summary][crate::model::Tool::generated_summary].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// let x = Tool::new().set_generated_summary("example");
    /// ```
    pub fn set_generated_summary<T: std::convert::Into<std::string::String>>(
        mut self,
        v: T,
    ) -> Self {
        self.generated_summary = v.into();
        self
    }

    /// Sets the value of [tool_fake_config][crate::model::Tool::tool_fake_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::ToolFakeConfig;
    /// let x = Tool::new().set_tool_fake_config(ToolFakeConfig::default()/* use setters */);
    /// ```
    pub fn set_tool_fake_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ToolFakeConfig>,
    {
        self.tool_fake_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [tool_fake_config][crate::model::Tool::tool_fake_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::ToolFakeConfig;
    /// let x = Tool::new().set_or_clear_tool_fake_config(Some(ToolFakeConfig::default()/* use setters */));
    /// let x = Tool::new().set_or_clear_tool_fake_config(None::<ToolFakeConfig>);
    /// ```
    pub fn set_or_clear_tool_fake_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ToolFakeConfig>,
    {
        self.tool_fake_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type].
    ///
    /// Note that all the setters affecting `tool_type` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::ClientFunction;
    /// let x = Tool::new().set_tool_type(Some(
    ///     google_cloud_ces_v1::model::tool::ToolType::ClientFunction(ClientFunction::default().into())));
    /// ```
    pub fn set_tool_type<
        T: std::convert::Into<std::option::Option<crate::model::tool::ToolType>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type = v.into();
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `ClientFunction`, `None` if the field is not set or
    /// holds a different branch.
    pub fn client_function(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::ClientFunction>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::ClientFunction(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `ClientFunction`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::ClientFunction;
    /// let x = Tool::new().set_client_function(ClientFunction::default()/* use setters */);
    /// assert!(x.client_function().is_some());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_client_function<
        T: std::convert::Into<std::boxed::Box<crate::model::ClientFunction>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::ClientFunction(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `OpenApiTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn open_api_tool(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::OpenApiTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::OpenApiTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `OpenApiTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::OpenApiTool;
    /// let x = Tool::new().set_open_api_tool(OpenApiTool::default()/* use setters */);
    /// assert!(x.open_api_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_open_api_tool<T: std::convert::Into<std::boxed::Box<crate::model::OpenApiTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::OpenApiTool(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `GoogleSearchTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn google_search_tool(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::GoogleSearchTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::GoogleSearchTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `GoogleSearchTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::GoogleSearchTool;
    /// let x = Tool::new().set_google_search_tool(GoogleSearchTool::default()/* use setters */);
    /// assert!(x.google_search_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_google_search_tool<
        T: std::convert::Into<std::boxed::Box<crate::model::GoogleSearchTool>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::GoogleSearchTool(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `ConnectorTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn connector_tool(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::ConnectorTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::ConnectorTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `ConnectorTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::ConnectorTool;
    /// let x = Tool::new().set_connector_tool(ConnectorTool::default()/* use setters */);
    /// assert!(x.connector_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_connector_tool<
        T: std::convert::Into<std::boxed::Box<crate::model::ConnectorTool>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::ConnectorTool(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `DataStoreTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn data_store_tool(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::DataStoreTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::DataStoreTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `DataStoreTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::DataStoreTool;
    /// let x = Tool::new().set_data_store_tool(DataStoreTool::default()/* use setters */);
    /// assert!(x.data_store_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_data_store_tool<
        T: std::convert::Into<std::boxed::Box<crate::model::DataStoreTool>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::DataStoreTool(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `PythonFunction`, `None` if the field is not set or
    /// holds a different branch.
    pub fn python_function(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::PythonFunction>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::PythonFunction(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `PythonFunction`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::PythonFunction;
    /// let x = Tool::new().set_python_function(PythonFunction::default()/* use setters */);
    /// assert!(x.python_function().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_python_function<
        T: std::convert::Into<std::boxed::Box<crate::model::PythonFunction>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::PythonFunction(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `McpTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn mcp_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::McpTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::McpTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `McpTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::McpTool;
    /// let x = Tool::new().set_mcp_tool(McpTool::default()/* use setters */);
    /// assert!(x.mcp_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_mcp_tool<T: std::convert::Into<std::boxed::Box<crate::model::McpTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type = std::option::Option::Some(crate::model::tool::ToolType::McpTool(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `FileSearchTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn file_search_tool(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::FileSearchTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::FileSearchTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `FileSearchTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::FileSearchTool;
    /// let x = Tool::new().set_file_search_tool(FileSearchTool::default()/* use setters */);
    /// assert!(x.file_search_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_file_search_tool<
        T: std::convert::Into<std::boxed::Box<crate::model::FileSearchTool>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::FileSearchTool(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `SystemTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn system_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::SystemTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::SystemTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `SystemTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::SystemTool;
    /// let x = Tool::new().set_system_tool(SystemTool::default()/* use setters */);
    /// assert!(x.system_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_system_tool<T: std::convert::Into<std::boxed::Box<crate::model::SystemTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::SystemTool(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `AgentTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn agent_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::AgentTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::AgentTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `AgentTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::AgentTool;
    /// let x = Tool::new().set_agent_tool(AgentTool::default()/* use setters */);
    /// assert!(x.agent_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_agent_tool<T: std::convert::Into<std::boxed::Box<crate::model::AgentTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::AgentTool(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `WidgetTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn widget_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::WidgetTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::WidgetTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `WidgetTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::WidgetTool;
    /// let x = Tool::new().set_widget_tool(WidgetTool::default()/* use setters */);
    /// assert!(x.widget_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.remote_agent_tool().is_none());
    /// ```
    pub fn set_widget_tool<T: std::convert::Into<std::boxed::Box<crate::model::WidgetTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::WidgetTool(v.into()));
        self
    }

    /// The value of [tool_type][crate::model::Tool::tool_type]
    /// if it holds a `RemoteAgentTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn remote_agent_tool(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::RemoteAgentTool>> {
        #[allow(unreachable_patterns)]
        self.tool_type.as_ref().and_then(|v| match v {
            crate::model::tool::ToolType::RemoteAgentTool(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_type][crate::model::Tool::tool_type]
    /// to hold a `RemoteAgentTool`.
    ///
    /// Note that all the setters affecting `tool_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Tool;
    /// use google_cloud_ces_v1::model::RemoteAgentTool;
    /// let x = Tool::new().set_remote_agent_tool(RemoteAgentTool::default()/* use setters */);
    /// assert!(x.remote_agent_tool().is_some());
    /// assert!(x.client_function().is_none());
    /// assert!(x.open_api_tool().is_none());
    /// assert!(x.google_search_tool().is_none());
    /// assert!(x.connector_tool().is_none());
    /// assert!(x.data_store_tool().is_none());
    /// assert!(x.python_function().is_none());
    /// assert!(x.mcp_tool().is_none());
    /// assert!(x.file_search_tool().is_none());
    /// assert!(x.system_tool().is_none());
    /// assert!(x.agent_tool().is_none());
    /// assert!(x.widget_tool().is_none());
    /// ```
    pub fn set_remote_agent_tool<
        T: std::convert::Into<std::boxed::Box<crate::model::RemoteAgentTool>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_type =
            std::option::Option::Some(crate::model::tool::ToolType::RemoteAgentTool(v.into()));
        self
    }
}

impl wkt::message::Message for Tool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Tool"
    }
}

/// Defines additional types related to [Tool].
pub mod tool {
    #[allow(unused_imports)]
    use super::*;

    /// The type of the tool.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolType {
        /// Optional. The client function.
        ClientFunction(std::boxed::Box<crate::model::ClientFunction>),
        /// Optional. The open API tool.
        OpenApiTool(std::boxed::Box<crate::model::OpenApiTool>),
        /// Optional. The google search tool.
        GoogleSearchTool(std::boxed::Box<crate::model::GoogleSearchTool>),
        /// Optional. The Integration Connector tool.
        ConnectorTool(std::boxed::Box<crate::model::ConnectorTool>),
        /// Optional. The data store tool.
        DataStoreTool(std::boxed::Box<crate::model::DataStoreTool>),
        /// Optional. The python function tool.
        PythonFunction(std::boxed::Box<crate::model::PythonFunction>),
        /// Optional. The MCP tool. An MCP tool cannot be created or updated directly
        /// and is managed by the MCP toolset.
        McpTool(std::boxed::Box<crate::model::McpTool>),
        /// Optional. The file search tool.
        FileSearchTool(std::boxed::Box<crate::model::FileSearchTool>),
        /// Optional. The system tool.
        SystemTool(std::boxed::Box<crate::model::SystemTool>),
        /// Optional. The agent tool.
        AgentTool(std::boxed::Box<crate::model::AgentTool>),
        /// Optional. The widget tool.
        WidgetTool(std::boxed::Box<crate::model::WidgetTool>),
        /// Optional. The remote agent tool.
        RemoteAgentTool(std::boxed::Box<crate::model::RemoteAgentTool>),
    }
}

/// Request message for
/// [ToolService.ExecuteTool][google.cloud.ces.v1.ToolService.ExecuteTool].
///
/// [google.cloud.ces.v1.ToolService.ExecuteTool]: crate::client::ToolService::execute_tool
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ExecuteToolRequest {
    /// Required. The resource name of the app which the tool/toolset belongs to.
    /// Format: `projects/{project}/locations/{location}/apps/{app}`
    pub parent: std::string::String,

    /// Optional. The input parameters and values for the tool in JSON object
    /// format.
    pub args: std::option::Option<wkt::Struct>,

    /// Optional. Mock configuration for the tool execution.
    /// If this field is set, tools that call other tools will be
    /// mocked based on the provided patterns and responses.
    pub mock_config: std::option::Option<crate::model::MockConfig>,

    /// The identifier of the tool to execute. It could be either a persisted tool
    /// or a tool from a toolset.
    pub tool_identifier: std::option::Option<crate::model::execute_tool_request::ToolIdentifier>,

    /// Additional context to be provided for the tool execution
    pub tool_execution_context:
        std::option::Option<crate::model::execute_tool_request::ToolExecutionContext>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ExecuteToolRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::ExecuteToolRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = ExecuteToolRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [args][crate::model::ExecuteToolRequest::args].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// use wkt::Struct;
    /// let x = ExecuteToolRequest::new().set_args(Struct::default()/* use setters */);
    /// ```
    pub fn set_args<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.args = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [args][crate::model::ExecuteToolRequest::args].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// use wkt::Struct;
    /// let x = ExecuteToolRequest::new().set_or_clear_args(Some(Struct::default()/* use setters */));
    /// let x = ExecuteToolRequest::new().set_or_clear_args(None::<Struct>);
    /// ```
    pub fn set_or_clear_args<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.args = v.map(|x| x.into());
        self
    }

    /// Sets the value of [mock_config][crate::model::ExecuteToolRequest::mock_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// use google_cloud_ces_v1::model::MockConfig;
    /// let x = ExecuteToolRequest::new().set_mock_config(MockConfig::default()/* use setters */);
    /// ```
    pub fn set_mock_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::MockConfig>,
    {
        self.mock_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [mock_config][crate::model::ExecuteToolRequest::mock_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// use google_cloud_ces_v1::model::MockConfig;
    /// let x = ExecuteToolRequest::new().set_or_clear_mock_config(Some(MockConfig::default()/* use setters */));
    /// let x = ExecuteToolRequest::new().set_or_clear_mock_config(None::<MockConfig>);
    /// ```
    pub fn set_or_clear_mock_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::MockConfig>,
    {
        self.mock_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tool_identifier][crate::model::ExecuteToolRequest::tool_identifier].
    ///
    /// Note that all the setters affecting `tool_identifier` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// use google_cloud_ces_v1::model::execute_tool_request::ToolIdentifier;
    /// let x = ExecuteToolRequest::new().set_tool_identifier(Some(ToolIdentifier::Tool("example".to_string())));
    /// ```
    pub fn set_tool_identifier<
        T: std::convert::Into<std::option::Option<crate::model::execute_tool_request::ToolIdentifier>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = v.into();
        self
    }

    /// The value of [tool_identifier][crate::model::ExecuteToolRequest::tool_identifier]
    /// if it holds a `Tool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::execute_tool_request::ToolIdentifier::Tool(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::ExecuteToolRequest::tool_identifier]
    /// to hold a `Tool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = ExecuteToolRequest::new().set_tool(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// assert!(x.tool().is_some());
    /// assert!(x.toolset_tool().is_none());
    /// ```
    pub fn set_tool<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::execute_tool_request::ToolIdentifier::Tool(v.into()),
        );
        self
    }

    /// The value of [tool_identifier][crate::model::ExecuteToolRequest::tool_identifier]
    /// if it holds a `ToolsetTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn toolset_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::ToolsetTool>> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::execute_tool_request::ToolIdentifier::ToolsetTool(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::ExecuteToolRequest::tool_identifier]
    /// to hold a `ToolsetTool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// use google_cloud_ces_v1::model::ToolsetTool;
    /// let x = ExecuteToolRequest::new().set_toolset_tool(ToolsetTool::default()/* use setters */);
    /// assert!(x.toolset_tool().is_some());
    /// assert!(x.tool().is_none());
    /// ```
    pub fn set_toolset_tool<T: std::convert::Into<std::boxed::Box<crate::model::ToolsetTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::execute_tool_request::ToolIdentifier::ToolsetTool(v.into()),
        );
        self
    }

    /// Sets the value of [tool_execution_context][crate::model::ExecuteToolRequest::tool_execution_context].
    ///
    /// Note that all the setters affecting `tool_execution_context` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// use wkt::Struct;
    /// let x = ExecuteToolRequest::new().set_tool_execution_context(Some(
    ///     google_cloud_ces_v1::model::execute_tool_request::ToolExecutionContext::Variables(Struct::default().into())));
    /// ```
    pub fn set_tool_execution_context<
        T: std::convert::Into<
                std::option::Option<crate::model::execute_tool_request::ToolExecutionContext>,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_execution_context = v.into();
        self
    }

    /// The value of [tool_execution_context][crate::model::ExecuteToolRequest::tool_execution_context]
    /// if it holds a `Variables`, `None` if the field is not set or
    /// holds a different branch.
    pub fn variables(&self) -> std::option::Option<&std::boxed::Box<wkt::Struct>> {
        #[allow(unreachable_patterns)]
        self.tool_execution_context.as_ref().and_then(|v| match v {
            crate::model::execute_tool_request::ToolExecutionContext::Variables(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_execution_context][crate::model::ExecuteToolRequest::tool_execution_context]
    /// to hold a `Variables`.
    ///
    /// Note that all the setters affecting `tool_execution_context` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// use wkt::Struct;
    /// let x = ExecuteToolRequest::new().set_variables(Struct::default()/* use setters */);
    /// assert!(x.variables().is_some());
    /// assert!(x.context().is_none());
    /// ```
    pub fn set_variables<T: std::convert::Into<std::boxed::Box<wkt::Struct>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_execution_context = std::option::Option::Some(
            crate::model::execute_tool_request::ToolExecutionContext::Variables(v.into()),
        );
        self
    }

    /// The value of [tool_execution_context][crate::model::ExecuteToolRequest::tool_execution_context]
    /// if it holds a `Context`, `None` if the field is not set or
    /// holds a different branch.
    pub fn context(&self) -> std::option::Option<&std::boxed::Box<wkt::Struct>> {
        #[allow(unreachable_patterns)]
        self.tool_execution_context.as_ref().and_then(|v| match v {
            crate::model::execute_tool_request::ToolExecutionContext::Context(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_execution_context][crate::model::ExecuteToolRequest::tool_execution_context]
    /// to hold a `Context`.
    ///
    /// Note that all the setters affecting `tool_execution_context` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolRequest;
    /// use wkt::Struct;
    /// let x = ExecuteToolRequest::new().set_context(Struct::default()/* use setters */);
    /// assert!(x.context().is_some());
    /// assert!(x.variables().is_none());
    /// ```
    pub fn set_context<T: std::convert::Into<std::boxed::Box<wkt::Struct>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_execution_context = std::option::Option::Some(
            crate::model::execute_tool_request::ToolExecutionContext::Context(v.into()),
        );
        self
    }
}

impl wkt::message::Message for ExecuteToolRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ExecuteToolRequest"
    }
}

/// Defines additional types related to [ExecuteToolRequest].
pub mod execute_tool_request {
    #[allow(unused_imports)]
    use super::*;

    /// The identifier of the tool to execute. It could be either a persisted tool
    /// or a tool from a toolset.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolIdentifier {
        /// Optional. The name of the tool to execute.
        /// Format:
        /// projects/{project}/locations/{location}/apps/{app}/tools/{tool}
        Tool(std::string::String),
        /// Optional. The toolset tool to execute. Only one tool should match the
        /// predicate from the toolset. Otherwise, an error will be returned.
        ToolsetTool(std::boxed::Box<crate::model::ToolsetTool>),
    }

    /// Additional context to be provided for the tool execution
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolExecutionContext {
        /// Optional. The variables that are available for the tool execution.
        Variables(std::boxed::Box<wkt::Struct>),
        /// Optional. The
        /// [ToolCallContext](<https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/python#environment>
        /// for details) to be passed to the Python tool.
        Context(std::boxed::Box<wkt::Struct>),
    }
}

/// Response message for
/// [ToolService.ExecuteTool][google.cloud.ces.v1.ToolService.ExecuteTool].
///
/// [google.cloud.ces.v1.ToolService.ExecuteTool]: crate::client::ToolService::execute_tool
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ExecuteToolResponse {
    /// The tool execution result in JSON object format.
    /// Use "output" key to specify tool response and "error" key to specify
    /// error details (if any). If "output" and "error" keys are not specified,
    /// then whole "response" is treated as tool execution result.
    pub response: std::option::Option<wkt::Struct>,

    /// The variable values at the end of the tool execution.
    pub variables: std::option::Option<wkt::Struct>,

    /// Citations that provide the source information for the tool's execution.
    pub citations: std::option::Option<crate::model::Citations>,

    /// The suggestions returned from Google Search as a result of invoking the
    /// Google Search Tool during the tool execution.
    pub google_search_suggestions: std::option::Option<crate::model::GoogleSearchSuggestions>,

    /// The identifier of the tool that got executed.
    pub tool_identifier: std::option::Option<crate::model::execute_tool_response::ToolIdentifier>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ExecuteToolResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [response][crate::model::ExecuteToolResponse::response].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use wkt::Struct;
    /// let x = ExecuteToolResponse::new().set_response(Struct::default()/* use setters */);
    /// ```
    pub fn set_response<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.response = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [response][crate::model::ExecuteToolResponse::response].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use wkt::Struct;
    /// let x = ExecuteToolResponse::new().set_or_clear_response(Some(Struct::default()/* use setters */));
    /// let x = ExecuteToolResponse::new().set_or_clear_response(None::<Struct>);
    /// ```
    pub fn set_or_clear_response<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.response = v.map(|x| x.into());
        self
    }

    /// Sets the value of [variables][crate::model::ExecuteToolResponse::variables].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use wkt::Struct;
    /// let x = ExecuteToolResponse::new().set_variables(Struct::default()/* use setters */);
    /// ```
    pub fn set_variables<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.variables = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [variables][crate::model::ExecuteToolResponse::variables].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use wkt::Struct;
    /// let x = ExecuteToolResponse::new().set_or_clear_variables(Some(Struct::default()/* use setters */));
    /// let x = ExecuteToolResponse::new().set_or_clear_variables(None::<Struct>);
    /// ```
    pub fn set_or_clear_variables<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.variables = v.map(|x| x.into());
        self
    }

    /// Sets the value of [citations][crate::model::ExecuteToolResponse::citations].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use google_cloud_ces_v1::model::Citations;
    /// let x = ExecuteToolResponse::new().set_citations(Citations::default()/* use setters */);
    /// ```
    pub fn set_citations<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Citations>,
    {
        self.citations = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [citations][crate::model::ExecuteToolResponse::citations].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use google_cloud_ces_v1::model::Citations;
    /// let x = ExecuteToolResponse::new().set_or_clear_citations(Some(Citations::default()/* use setters */));
    /// let x = ExecuteToolResponse::new().set_or_clear_citations(None::<Citations>);
    /// ```
    pub fn set_or_clear_citations<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Citations>,
    {
        self.citations = v.map(|x| x.into());
        self
    }

    /// Sets the value of [google_search_suggestions][crate::model::ExecuteToolResponse::google_search_suggestions].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use google_cloud_ces_v1::model::GoogleSearchSuggestions;
    /// let x = ExecuteToolResponse::new().set_google_search_suggestions(GoogleSearchSuggestions::default()/* use setters */);
    /// ```
    pub fn set_google_search_suggestions<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::GoogleSearchSuggestions>,
    {
        self.google_search_suggestions = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [google_search_suggestions][crate::model::ExecuteToolResponse::google_search_suggestions].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use google_cloud_ces_v1::model::GoogleSearchSuggestions;
    /// let x = ExecuteToolResponse::new().set_or_clear_google_search_suggestions(Some(GoogleSearchSuggestions::default()/* use setters */));
    /// let x = ExecuteToolResponse::new().set_or_clear_google_search_suggestions(None::<GoogleSearchSuggestions>);
    /// ```
    pub fn set_or_clear_google_search_suggestions<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::GoogleSearchSuggestions>,
    {
        self.google_search_suggestions = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tool_identifier][crate::model::ExecuteToolResponse::tool_identifier].
    ///
    /// Note that all the setters affecting `tool_identifier` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use google_cloud_ces_v1::model::execute_tool_response::ToolIdentifier;
    /// let x = ExecuteToolResponse::new().set_tool_identifier(Some(ToolIdentifier::Tool("example".to_string())));
    /// ```
    pub fn set_tool_identifier<
        T: std::convert::Into<
                std::option::Option<crate::model::execute_tool_response::ToolIdentifier>,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = v.into();
        self
    }

    /// The value of [tool_identifier][crate::model::ExecuteToolResponse::tool_identifier]
    /// if it holds a `Tool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::execute_tool_response::ToolIdentifier::Tool(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::ExecuteToolResponse::tool_identifier]
    /// to hold a `Tool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = ExecuteToolResponse::new().set_tool(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// assert!(x.tool().is_some());
    /// assert!(x.toolset_tool().is_none());
    /// ```
    pub fn set_tool<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::execute_tool_response::ToolIdentifier::Tool(v.into()),
        );
        self
    }

    /// The value of [tool_identifier][crate::model::ExecuteToolResponse::tool_identifier]
    /// if it holds a `ToolsetTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn toolset_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::ToolsetTool>> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::execute_tool_response::ToolIdentifier::ToolsetTool(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::ExecuteToolResponse::tool_identifier]
    /// to hold a `ToolsetTool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ExecuteToolResponse;
    /// use google_cloud_ces_v1::model::ToolsetTool;
    /// let x = ExecuteToolResponse::new().set_toolset_tool(ToolsetTool::default()/* use setters */);
    /// assert!(x.toolset_tool().is_some());
    /// assert!(x.tool().is_none());
    /// ```
    pub fn set_toolset_tool<T: std::convert::Into<std::boxed::Box<crate::model::ToolsetTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::execute_tool_response::ToolIdentifier::ToolsetTool(v.into()),
        );
        self
    }
}

impl wkt::message::Message for ExecuteToolResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ExecuteToolResponse"
    }
}

/// Defines additional types related to [ExecuteToolResponse].
pub mod execute_tool_response {
    #[allow(unused_imports)]
    use super::*;

    /// The identifier of the tool that got executed.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolIdentifier {
        /// The name of the tool that got executed.
        /// Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
        Tool(std::string::String),
        /// The toolset tool that got executed.
        ToolsetTool(std::boxed::Box<crate::model::ToolsetTool>),
    }
}

/// Request message for
/// [ToolService.RetrieveToolSchema][google.cloud.ces.v1.ToolService.RetrieveToolSchema].
///
/// [google.cloud.ces.v1.ToolService.RetrieveToolSchema]: crate::client::ToolService::retrieve_tool_schema
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RetrieveToolSchemaRequest {
    /// Required. The resource name of the app which the tool/toolset belongs to.
    /// Format: `projects/{project}/locations/{location}/apps/{app}`
    pub parent: std::string::String,

    /// The identifier of the tool to retrieve the schema for. It could be either a
    /// persisted tool or a tool from a toolset.
    pub tool_identifier:
        std::option::Option<crate::model::retrieve_tool_schema_request::ToolIdentifier>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RetrieveToolSchemaRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::RetrieveToolSchemaRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// let x = RetrieveToolSchemaRequest::new().set_parent(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}"));
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [tool_identifier][crate::model::RetrieveToolSchemaRequest::tool_identifier].
    ///
    /// Note that all the setters affecting `tool_identifier` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaRequest;
    /// use google_cloud_ces_v1::model::retrieve_tool_schema_request::ToolIdentifier;
    /// let x = RetrieveToolSchemaRequest::new().set_tool_identifier(Some(ToolIdentifier::Tool("example".to_string())));
    /// ```
    pub fn set_tool_identifier<
        T: std::convert::Into<
                std::option::Option<crate::model::retrieve_tool_schema_request::ToolIdentifier>,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = v.into();
        self
    }

    /// The value of [tool_identifier][crate::model::RetrieveToolSchemaRequest::tool_identifier]
    /// if it holds a `Tool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::retrieve_tool_schema_request::ToolIdentifier::Tool(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::RetrieveToolSchemaRequest::tool_identifier]
    /// to hold a `Tool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = RetrieveToolSchemaRequest::new().set_tool(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// assert!(x.tool().is_some());
    /// assert!(x.toolset_tool().is_none());
    /// ```
    pub fn set_tool<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::retrieve_tool_schema_request::ToolIdentifier::Tool(v.into()),
        );
        self
    }

    /// The value of [tool_identifier][crate::model::RetrieveToolSchemaRequest::tool_identifier]
    /// if it holds a `ToolsetTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn toolset_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::ToolsetTool>> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::retrieve_tool_schema_request::ToolIdentifier::ToolsetTool(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::RetrieveToolSchemaRequest::tool_identifier]
    /// to hold a `ToolsetTool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaRequest;
    /// use google_cloud_ces_v1::model::ToolsetTool;
    /// let x = RetrieveToolSchemaRequest::new().set_toolset_tool(ToolsetTool::default()/* use setters */);
    /// assert!(x.toolset_tool().is_some());
    /// assert!(x.tool().is_none());
    /// ```
    pub fn set_toolset_tool<T: std::convert::Into<std::boxed::Box<crate::model::ToolsetTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::retrieve_tool_schema_request::ToolIdentifier::ToolsetTool(v.into()),
        );
        self
    }
}

impl wkt::message::Message for RetrieveToolSchemaRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RetrieveToolSchemaRequest"
    }
}

/// Defines additional types related to [RetrieveToolSchemaRequest].
pub mod retrieve_tool_schema_request {
    #[allow(unused_imports)]
    use super::*;

    /// The identifier of the tool to retrieve the schema for. It could be either a
    /// persisted tool or a tool from a toolset.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolIdentifier {
        /// Optional. The name of the tool to retrieve the schema for.
        /// Format:
        /// projects/{project}/locations/{location}/apps/{app}/tools/{tool}
        Tool(std::string::String),
        /// Optional. The toolset tool to retrieve the schema for. Only one tool
        /// should match the predicate from the toolset. Otherwise, an error will be
        /// returned.
        ToolsetTool(std::boxed::Box<crate::model::ToolsetTool>),
    }
}

/// Response message for
/// [ToolService.RetrieveToolSchema][google.cloud.ces.v1.ToolService.RetrieveToolSchema].
///
/// [google.cloud.ces.v1.ToolService.RetrieveToolSchema]: crate::client::ToolService::retrieve_tool_schema
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RetrieveToolSchemaResponse {
    /// The schema of the tool input parameters.
    pub input_schema: std::option::Option<crate::model::Schema>,

    /// The schema of the tool output parameters.
    pub output_schema: std::option::Option<crate::model::Schema>,

    /// The identifier of the tool that the schema is for.
    pub tool_identifier:
        std::option::Option<crate::model::retrieve_tool_schema_response::ToolIdentifier>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RetrieveToolSchemaResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [input_schema][crate::model::RetrieveToolSchemaResponse::input_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaResponse;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = RetrieveToolSchemaResponse::new().set_input_schema(Schema::default()/* use setters */);
    /// ```
    pub fn set_input_schema<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.input_schema = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [input_schema][crate::model::RetrieveToolSchemaResponse::input_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaResponse;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = RetrieveToolSchemaResponse::new().set_or_clear_input_schema(Some(Schema::default()/* use setters */));
    /// let x = RetrieveToolSchemaResponse::new().set_or_clear_input_schema(None::<Schema>);
    /// ```
    pub fn set_or_clear_input_schema<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.input_schema = v.map(|x| x.into());
        self
    }

    /// Sets the value of [output_schema][crate::model::RetrieveToolSchemaResponse::output_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaResponse;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = RetrieveToolSchemaResponse::new().set_output_schema(Schema::default()/* use setters */);
    /// ```
    pub fn set_output_schema<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.output_schema = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [output_schema][crate::model::RetrieveToolSchemaResponse::output_schema].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaResponse;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = RetrieveToolSchemaResponse::new().set_or_clear_output_schema(Some(Schema::default()/* use setters */));
    /// let x = RetrieveToolSchemaResponse::new().set_or_clear_output_schema(None::<Schema>);
    /// ```
    pub fn set_or_clear_output_schema<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Schema>,
    {
        self.output_schema = v.map(|x| x.into());
        self
    }

    /// Sets the value of [tool_identifier][crate::model::RetrieveToolSchemaResponse::tool_identifier].
    ///
    /// Note that all the setters affecting `tool_identifier` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaResponse;
    /// use google_cloud_ces_v1::model::retrieve_tool_schema_response::ToolIdentifier;
    /// let x = RetrieveToolSchemaResponse::new().set_tool_identifier(Some(ToolIdentifier::Tool("example".to_string())));
    /// ```
    pub fn set_tool_identifier<
        T: std::convert::Into<
                std::option::Option<crate::model::retrieve_tool_schema_response::ToolIdentifier>,
            >,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = v.into();
        self
    }

    /// The value of [tool_identifier][crate::model::RetrieveToolSchemaResponse::tool_identifier]
    /// if it holds a `Tool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn tool(&self) -> std::option::Option<&std::string::String> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::retrieve_tool_schema_response::ToolIdentifier::Tool(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::RetrieveToolSchemaResponse::tool_identifier]
    /// to hold a `Tool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaResponse;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let tool_id = "tool_id";
    /// let x = RetrieveToolSchemaResponse::new().set_tool(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/tools/{tool_id}"));
    /// assert!(x.tool().is_some());
    /// assert!(x.toolset_tool().is_none());
    /// ```
    pub fn set_tool<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::retrieve_tool_schema_response::ToolIdentifier::Tool(v.into()),
        );
        self
    }

    /// The value of [tool_identifier][crate::model::RetrieveToolSchemaResponse::tool_identifier]
    /// if it holds a `ToolsetTool`, `None` if the field is not set or
    /// holds a different branch.
    pub fn toolset_tool(&self) -> std::option::Option<&std::boxed::Box<crate::model::ToolsetTool>> {
        #[allow(unreachable_patterns)]
        self.tool_identifier.as_ref().and_then(|v| match v {
            crate::model::retrieve_tool_schema_response::ToolIdentifier::ToolsetTool(v) => {
                std::option::Option::Some(v)
            }
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [tool_identifier][crate::model::RetrieveToolSchemaResponse::tool_identifier]
    /// to hold a `ToolsetTool`.
    ///
    /// Note that all the setters affecting `tool_identifier` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolSchemaResponse;
    /// use google_cloud_ces_v1::model::ToolsetTool;
    /// let x = RetrieveToolSchemaResponse::new().set_toolset_tool(ToolsetTool::default()/* use setters */);
    /// assert!(x.toolset_tool().is_some());
    /// assert!(x.tool().is_none());
    /// ```
    pub fn set_toolset_tool<T: std::convert::Into<std::boxed::Box<crate::model::ToolsetTool>>>(
        mut self,
        v: T,
    ) -> Self {
        self.tool_identifier = std::option::Option::Some(
            crate::model::retrieve_tool_schema_response::ToolIdentifier::ToolsetTool(v.into()),
        );
        self
    }
}

impl wkt::message::Message for RetrieveToolSchemaResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RetrieveToolSchemaResponse"
    }
}

/// Defines additional types related to [RetrieveToolSchemaResponse].
pub mod retrieve_tool_schema_response {
    #[allow(unused_imports)]
    use super::*;

    /// The identifier of the tool that the schema is for.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolIdentifier {
        /// The name of the tool that the schema is for.
        /// Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
        Tool(std::string::String),
        /// The toolset tool that the schema is for.
        ToolsetTool(std::boxed::Box<crate::model::ToolsetTool>),
    }
}

/// Request message for
/// [ToolService.RetrieveTools][google.cloud.ces.v1.ToolService.RetrieveTools].
///
/// [google.cloud.ces.v1.ToolService.RetrieveTools]: crate::client::ToolService::retrieve_tools
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RetrieveToolsRequest {
    /// Required. The name of the toolset to retrieve the tools for.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`
    pub toolset: std::string::String,

    /// Optional. The identifiers of the tools to retrieve from the toolset.
    /// If empty, all tools in the toolset will be returned.
    pub tool_ids: std::vec::Vec<std::string::String>,

    /// Optional. If true, the returned tools will contain raw descriptions and
    /// schemas directly from the server, bypassing any stored persistence
    /// configurations (overrides/snapshots).
    pub bypass_persistence_config: bool,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RetrieveToolsRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [toolset][crate::model::RetrieveToolsRequest::toolset].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolsRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let toolset_id = "toolset_id";
    /// let x = RetrieveToolsRequest::new().set_toolset(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/toolsets/{toolset_id}"));
    /// ```
    pub fn set_toolset<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.toolset = v.into();
        self
    }

    /// Sets the value of [tool_ids][crate::model::RetrieveToolsRequest::tool_ids].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolsRequest;
    /// let x = RetrieveToolsRequest::new().set_tool_ids(["a", "b", "c"]);
    /// ```
    pub fn set_tool_ids<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<std::string::String>,
    {
        use std::iter::Iterator;
        self.tool_ids = v.into_iter().map(|i| i.into()).collect();
        self
    }

    /// Sets the value of [bypass_persistence_config][crate::model::RetrieveToolsRequest::bypass_persistence_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolsRequest;
    /// let x = RetrieveToolsRequest::new().set_bypass_persistence_config(true);
    /// ```
    pub fn set_bypass_persistence_config<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.bypass_persistence_config = v.into();
        self
    }
}

impl wkt::message::Message for RetrieveToolsRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RetrieveToolsRequest"
    }
}

/// Response message for
/// [ToolService.RetrieveTools][google.cloud.ces.v1.ToolService.RetrieveTools].
///
/// [google.cloud.ces.v1.ToolService.RetrieveTools]: crate::client::ToolService::retrieve_tools
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct RetrieveToolsResponse {
    /// The list of tools that are included in the specified toolset.
    pub tools: std::vec::Vec<crate::model::Tool>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl RetrieveToolsResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [tools][crate::model::RetrieveToolsResponse::tools].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::RetrieveToolsResponse;
    /// use google_cloud_ces_v1::model::Tool;
    /// let x = RetrieveToolsResponse::new()
    ///     .set_tools([
    ///         Tool::default()/* use setters */,
    ///         Tool::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_tools<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Tool>,
    {
        use std::iter::Iterator;
        self.tools = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for RetrieveToolsResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.RetrieveToolsResponse"
    }
}

/// A toolset represents a group of dynamically managed tools that can be used
/// by the agent.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Toolset {
    /// Identifier. The unique identifier of the toolset.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`
    pub name: std::string::String,

    /// Optional. The display name of the toolset. Must be unique within the same
    /// app.
    pub display_name: std::string::String,

    /// Optional. The description of the toolset.
    pub description: std::string::String,

    /// Optional. The timeout for the toolset execution. If not set, the default
    /// timeout is 30 seconds for `SYNCHRONOUS` toolsets and 60 seconds for
    /// `ASYNCHRONOUS` toolsets.
    pub timeout: std::option::Option<wkt::Duration>,

    /// Output only. Timestamp when the toolset was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Timestamp when the toolset was last updated.
    pub update_time: std::option::Option<wkt::Timestamp>,

    /// 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.
    pub etag: std::string::String,

    /// Optional. The execution type of the tools in the toolset.
    pub execution_type: crate::model::ExecutionType,

    /// Optional. Configuration for tools behavior in fake mode.
    pub tool_fake_config: std::option::Option<crate::model::ToolFakeConfig>,

    /// The type of the toolset.
    pub toolset_type: std::option::Option<crate::model::toolset::ToolsetType>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Toolset {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Toolset::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let toolset_id = "toolset_id";
    /// let x = Toolset::new().set_name(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/toolsets/{toolset_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::Toolset::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// let x = Toolset::new().set_display_name("example");
    /// ```
    pub fn set_display_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.display_name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::Toolset::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// let x = Toolset::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [timeout][crate::model::Toolset::timeout].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use wkt::Duration;
    /// let x = Toolset::new().set_timeout(Duration::default()/* use setters */);
    /// ```
    pub fn set_timeout<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.timeout = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [timeout][crate::model::Toolset::timeout].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use wkt::Duration;
    /// let x = Toolset::new().set_or_clear_timeout(Some(Duration::default()/* use setters */));
    /// let x = Toolset::new().set_or_clear_timeout(None::<Duration>);
    /// ```
    pub fn set_or_clear_timeout<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.timeout = v.map(|x| x.into());
        self
    }

    /// Sets the value of [create_time][crate::model::Toolset::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use wkt::Timestamp;
    /// let x = Toolset::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::Toolset::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use wkt::Timestamp;
    /// let x = Toolset::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = Toolset::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::Toolset::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use wkt::Timestamp;
    /// let x = Toolset::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::Toolset::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use wkt::Timestamp;
    /// let x = Toolset::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = Toolset::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [etag][crate::model::Toolset::etag].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// let x = Toolset::new().set_etag("example");
    /// ```
    pub fn set_etag<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.etag = v.into();
        self
    }

    /// Sets the value of [execution_type][crate::model::Toolset::execution_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use google_cloud_ces_v1::model::ExecutionType;
    /// let x0 = Toolset::new().set_execution_type(ExecutionType::Synchronous);
    /// let x1 = Toolset::new().set_execution_type(ExecutionType::Asynchronous);
    /// ```
    pub fn set_execution_type<T: std::convert::Into<crate::model::ExecutionType>>(
        mut self,
        v: T,
    ) -> Self {
        self.execution_type = v.into();
        self
    }

    /// Sets the value of [tool_fake_config][crate::model::Toolset::tool_fake_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use google_cloud_ces_v1::model::ToolFakeConfig;
    /// let x = Toolset::new().set_tool_fake_config(ToolFakeConfig::default()/* use setters */);
    /// ```
    pub fn set_tool_fake_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::ToolFakeConfig>,
    {
        self.tool_fake_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [tool_fake_config][crate::model::Toolset::tool_fake_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use google_cloud_ces_v1::model::ToolFakeConfig;
    /// let x = Toolset::new().set_or_clear_tool_fake_config(Some(ToolFakeConfig::default()/* use setters */));
    /// let x = Toolset::new().set_or_clear_tool_fake_config(None::<ToolFakeConfig>);
    /// ```
    pub fn set_or_clear_tool_fake_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::ToolFakeConfig>,
    {
        self.tool_fake_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [toolset_type][crate::model::Toolset::toolset_type].
    ///
    /// Note that all the setters affecting `toolset_type` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use google_cloud_ces_v1::model::McpToolset;
    /// let x = Toolset::new().set_toolset_type(Some(
    ///     google_cloud_ces_v1::model::toolset::ToolsetType::McpToolset(McpToolset::default().into())));
    /// ```
    pub fn set_toolset_type<
        T: std::convert::Into<std::option::Option<crate::model::toolset::ToolsetType>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.toolset_type = v.into();
        self
    }

    /// The value of [toolset_type][crate::model::Toolset::toolset_type]
    /// if it holds a `McpToolset`, `None` if the field is not set or
    /// holds a different branch.
    pub fn mcp_toolset(&self) -> std::option::Option<&std::boxed::Box<crate::model::McpToolset>> {
        #[allow(unreachable_patterns)]
        self.toolset_type.as_ref().and_then(|v| match v {
            crate::model::toolset::ToolsetType::McpToolset(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [toolset_type][crate::model::Toolset::toolset_type]
    /// to hold a `McpToolset`.
    ///
    /// Note that all the setters affecting `toolset_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use google_cloud_ces_v1::model::McpToolset;
    /// let x = Toolset::new().set_mcp_toolset(McpToolset::default()/* use setters */);
    /// assert!(x.mcp_toolset().is_some());
    /// assert!(x.open_api_toolset().is_none());
    /// assert!(x.connector_toolset().is_none());
    /// ```
    pub fn set_mcp_toolset<T: std::convert::Into<std::boxed::Box<crate::model::McpToolset>>>(
        mut self,
        v: T,
    ) -> Self {
        self.toolset_type =
            std::option::Option::Some(crate::model::toolset::ToolsetType::McpToolset(v.into()));
        self
    }

    /// The value of [toolset_type][crate::model::Toolset::toolset_type]
    /// if it holds a `OpenApiToolset`, `None` if the field is not set or
    /// holds a different branch.
    pub fn open_api_toolset(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::OpenApiToolset>> {
        #[allow(unreachable_patterns)]
        self.toolset_type.as_ref().and_then(|v| match v {
            crate::model::toolset::ToolsetType::OpenApiToolset(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [toolset_type][crate::model::Toolset::toolset_type]
    /// to hold a `OpenApiToolset`.
    ///
    /// Note that all the setters affecting `toolset_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use google_cloud_ces_v1::model::OpenApiToolset;
    /// let x = Toolset::new().set_open_api_toolset(OpenApiToolset::default()/* use setters */);
    /// assert!(x.open_api_toolset().is_some());
    /// assert!(x.mcp_toolset().is_none());
    /// assert!(x.connector_toolset().is_none());
    /// ```
    pub fn set_open_api_toolset<
        T: std::convert::Into<std::boxed::Box<crate::model::OpenApiToolset>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.toolset_type =
            std::option::Option::Some(crate::model::toolset::ToolsetType::OpenApiToolset(v.into()));
        self
    }

    /// The value of [toolset_type][crate::model::Toolset::toolset_type]
    /// if it holds a `ConnectorToolset`, `None` if the field is not set or
    /// holds a different branch.
    pub fn connector_toolset(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::ConnectorToolset>> {
        #[allow(unreachable_patterns)]
        self.toolset_type.as_ref().and_then(|v| match v {
            crate::model::toolset::ToolsetType::ConnectorToolset(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [toolset_type][crate::model::Toolset::toolset_type]
    /// to hold a `ConnectorToolset`.
    ///
    /// Note that all the setters affecting `toolset_type` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::Toolset;
    /// use google_cloud_ces_v1::model::ConnectorToolset;
    /// let x = Toolset::new().set_connector_toolset(ConnectorToolset::default()/* use setters */);
    /// assert!(x.connector_toolset().is_some());
    /// assert!(x.mcp_toolset().is_none());
    /// assert!(x.open_api_toolset().is_none());
    /// ```
    pub fn set_connector_toolset<
        T: std::convert::Into<std::boxed::Box<crate::model::ConnectorToolset>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.toolset_type = std::option::Option::Some(
            crate::model::toolset::ToolsetType::ConnectorToolset(v.into()),
        );
        self
    }
}

impl wkt::message::Message for Toolset {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.Toolset"
    }
}

/// Defines additional types related to [Toolset].
pub mod toolset {
    #[allow(unused_imports)]
    use super::*;

    /// The type of the toolset.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum ToolsetType {
        /// Optional. A toolset that contains a list of tools that are offered by the
        /// MCP server.
        McpToolset(std::boxed::Box<crate::model::McpToolset>),
        /// Optional. A toolset that contains a list of tools that are defined by an
        /// OpenAPI schema.
        OpenApiToolset(std::boxed::Box<crate::model::OpenApiToolset>),
        /// Optional. A toolset that generates tools from an Integration Connectors
        /// Connection.
        ConnectorToolset(std::boxed::Box<crate::model::ConnectorToolset>),
    }
}

/// A tool that is created from a toolset.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct ToolsetTool {
    /// Required. The resource name of the Toolset from which this tool is derived.
    /// Format:
    /// `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`
    pub toolset: std::string::String,

    /// Optional. The tool ID to filter the tools to retrieve the schema for.
    pub tool_id: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl ToolsetTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [toolset][crate::model::ToolsetTool::toolset].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolsetTool;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let toolset_id = "toolset_id";
    /// let x = ToolsetTool::new().set_toolset(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/toolsets/{toolset_id}"));
    /// ```
    pub fn set_toolset<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.toolset = v.into();
        self
    }

    /// Sets the value of [tool_id][crate::model::ToolsetTool::tool_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::ToolsetTool;
    /// let x = ToolsetTool::new().set_tool_id("example");
    /// ```
    pub fn set_tool_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.tool_id = v.into();
        self
    }
}

impl wkt::message::Message for ToolsetTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.ToolsetTool"
    }
}

/// Request message for
/// [WidgetService.GenerateChatToken][google.cloud.ces.v1.WidgetService.GenerateChatToken].
///
/// [google.cloud.ces.v1.WidgetService.GenerateChatToken]: crate::client::WidgetService::generate_chat_token
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GenerateChatTokenRequest {
    /// Required. The session name to generate the chat token for.
    /// Format:
    /// projects/{project}/locations/{location}/apps/{app}/sessions/{session}
    pub name: std::string::String,

    /// Required. The deployment of the app to use for the session.
    /// Format:
    /// projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
    pub deployment: std::string::String,

    /// Optional. The reCAPTCHA token generated by the client-side chat widget.
    pub recaptcha_token: std::string::String,

    /// Optional. Indicates if live handoff is enabled for the session.
    pub live_handoff_enabled: bool,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GenerateChatTokenRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GenerateChatTokenRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GenerateChatTokenRequest;
    /// let x = GenerateChatTokenRequest::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [deployment][crate::model::GenerateChatTokenRequest::deployment].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GenerateChatTokenRequest;
    /// # let project_id = "project_id";
    /// # let location_id = "location_id";
    /// # let app_id = "app_id";
    /// # let deployment_id = "deployment_id";
    /// let x = GenerateChatTokenRequest::new().set_deployment(format!("projects/{project_id}/locations/{location_id}/apps/{app_id}/deployments/{deployment_id}"));
    /// ```
    pub fn set_deployment<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.deployment = v.into();
        self
    }

    /// Sets the value of [recaptcha_token][crate::model::GenerateChatTokenRequest::recaptcha_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GenerateChatTokenRequest;
    /// let x = GenerateChatTokenRequest::new().set_recaptcha_token("example");
    /// ```
    pub fn set_recaptcha_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.recaptcha_token = v.into();
        self
    }

    /// Sets the value of [live_handoff_enabled][crate::model::GenerateChatTokenRequest::live_handoff_enabled].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GenerateChatTokenRequest;
    /// let x = GenerateChatTokenRequest::new().set_live_handoff_enabled(true);
    /// ```
    pub fn set_live_handoff_enabled<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.live_handoff_enabled = v.into();
        self
    }
}

impl wkt::message::Message for GenerateChatTokenRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GenerateChatTokenRequest"
    }
}

/// Response message for
/// [WidgetService.GenerateChatToken][google.cloud.ces.v1.WidgetService.GenerateChatToken].
///
/// [google.cloud.ces.v1.WidgetService.GenerateChatToken]: crate::client::WidgetService::generate_chat_token
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GenerateChatTokenResponse {
    /// The session scoped token for chat widget to authenticate with Session APIs.
    pub chat_token: std::string::String,

    /// The time at which the chat token expires.
    pub expire_time: std::option::Option<wkt::Timestamp>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GenerateChatTokenResponse {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [chat_token][crate::model::GenerateChatTokenResponse::chat_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GenerateChatTokenResponse;
    /// let x = GenerateChatTokenResponse::new().set_chat_token("example");
    /// ```
    pub fn set_chat_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.chat_token = v.into();
        self
    }

    /// Sets the value of [expire_time][crate::model::GenerateChatTokenResponse::expire_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GenerateChatTokenResponse;
    /// use wkt::Timestamp;
    /// let x = GenerateChatTokenResponse::new().set_expire_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_expire_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.expire_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [expire_time][crate::model::GenerateChatTokenResponse::expire_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::GenerateChatTokenResponse;
    /// use wkt::Timestamp;
    /// let x = GenerateChatTokenResponse::new().set_or_clear_expire_time(Some(Timestamp::default()/* use setters */));
    /// let x = GenerateChatTokenResponse::new().set_or_clear_expire_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_expire_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.expire_time = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for GenerateChatTokenResponse {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.GenerateChatTokenResponse"
    }
}

/// Represents a widget tool that the agent can invoke. When the tool is chosen
/// by the agent, agent will return the widget to the client. The client is
/// responsible for processing the widget and generating the next user query to
/// continue the interaction with the agent.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct WidgetTool {
    /// Required. The display name of the widget tool.
    pub name: std::string::String,

    /// Optional. The description of the widget tool.
    pub description: std::string::String,

    /// Optional. The type of the widget tool. If not specified, the default type
    /// will be CUSTOMIZED.
    pub widget_type: crate::model::widget_tool::WidgetType,

    /// Optional. Configuration for rendering the widget.
    pub ui_config: std::option::Option<wkt::Struct>,

    /// Optional. The mapping that defines how data from a source tool is mapped to
    /// the widget's input parameters.
    pub data_mapping: std::option::Option<crate::model::widget_tool::DataMapping>,

    /// Optional. Configuration for always-included text responses.
    pub text_response_config: std::option::Option<crate::model::widget_tool::TextResponseConfig>,

    /// The input of the widget tool.
    pub input: std::option::Option<crate::model::widget_tool::Input>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl WidgetTool {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::WidgetTool::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// let x = WidgetTool::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [description][crate::model::WidgetTool::description].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// let x = WidgetTool::new().set_description("example");
    /// ```
    pub fn set_description<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.description = v.into();
        self
    }

    /// Sets the value of [widget_type][crate::model::WidgetTool::widget_type].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// use google_cloud_ces_v1::model::widget_tool::WidgetType;
    /// let x0 = WidgetTool::new().set_widget_type(WidgetType::Custom);
    /// let x1 = WidgetTool::new().set_widget_type(WidgetType::ProductCarousel);
    /// let x2 = WidgetTool::new().set_widget_type(WidgetType::ProductDetails);
    /// ```
    pub fn set_widget_type<T: std::convert::Into<crate::model::widget_tool::WidgetType>>(
        mut self,
        v: T,
    ) -> Self {
        self.widget_type = v.into();
        self
    }

    /// Sets the value of [ui_config][crate::model::WidgetTool::ui_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// use wkt::Struct;
    /// let x = WidgetTool::new().set_ui_config(Struct::default()/* use setters */);
    /// ```
    pub fn set_ui_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.ui_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [ui_config][crate::model::WidgetTool::ui_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// use wkt::Struct;
    /// let x = WidgetTool::new().set_or_clear_ui_config(Some(Struct::default()/* use setters */));
    /// let x = WidgetTool::new().set_or_clear_ui_config(None::<Struct>);
    /// ```
    pub fn set_or_clear_ui_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Struct>,
    {
        self.ui_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [data_mapping][crate::model::WidgetTool::data_mapping].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// use google_cloud_ces_v1::model::widget_tool::DataMapping;
    /// let x = WidgetTool::new().set_data_mapping(DataMapping::default()/* use setters */);
    /// ```
    pub fn set_data_mapping<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::widget_tool::DataMapping>,
    {
        self.data_mapping = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [data_mapping][crate::model::WidgetTool::data_mapping].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// use google_cloud_ces_v1::model::widget_tool::DataMapping;
    /// let x = WidgetTool::new().set_or_clear_data_mapping(Some(DataMapping::default()/* use setters */));
    /// let x = WidgetTool::new().set_or_clear_data_mapping(None::<DataMapping>);
    /// ```
    pub fn set_or_clear_data_mapping<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::widget_tool::DataMapping>,
    {
        self.data_mapping = v.map(|x| x.into());
        self
    }

    /// Sets the value of [text_response_config][crate::model::WidgetTool::text_response_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// use google_cloud_ces_v1::model::widget_tool::TextResponseConfig;
    /// let x = WidgetTool::new().set_text_response_config(TextResponseConfig::default()/* use setters */);
    /// ```
    pub fn set_text_response_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::widget_tool::TextResponseConfig>,
    {
        self.text_response_config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [text_response_config][crate::model::WidgetTool::text_response_config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// use google_cloud_ces_v1::model::widget_tool::TextResponseConfig;
    /// let x = WidgetTool::new().set_or_clear_text_response_config(Some(TextResponseConfig::default()/* use setters */));
    /// let x = WidgetTool::new().set_or_clear_text_response_config(None::<TextResponseConfig>);
    /// ```
    pub fn set_or_clear_text_response_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::widget_tool::TextResponseConfig>,
    {
        self.text_response_config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [input][crate::model::WidgetTool::input].
    ///
    /// Note that all the setters affecting `input` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = WidgetTool::new().set_input(Some(
    ///     google_cloud_ces_v1::model::widget_tool::Input::Parameters(Schema::default().into())));
    /// ```
    pub fn set_input<
        T: std::convert::Into<std::option::Option<crate::model::widget_tool::Input>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.input = v.into();
        self
    }

    /// The value of [input][crate::model::WidgetTool::input]
    /// if it holds a `Parameters`, `None` if the field is not set or
    /// holds a different branch.
    pub fn parameters(&self) -> std::option::Option<&std::boxed::Box<crate::model::Schema>> {
        #[allow(unreachable_patterns)]
        self.input.as_ref().and_then(|v| match v {
            crate::model::widget_tool::Input::Parameters(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [input][crate::model::WidgetTool::input]
    /// to hold a `Parameters`.
    ///
    /// Note that all the setters affecting `input` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_ces_v1::model::WidgetTool;
    /// use google_cloud_ces_v1::model::Schema;
    /// let x = WidgetTool::new().set_parameters(Schema::default()/* use setters */);
    /// assert!(x.parameters().is_some());
    /// ```
    pub fn set_parameters<T: std::convert::Into<std::boxed::Box<crate::model::Schema>>>(
        mut self,
        v: T,
    ) -> Self {
        self.input =
            std::option::Option::Some(crate::model::widget_tool::Input::Parameters(v.into()));
        self
    }
}

impl wkt::message::Message for WidgetTool {
    fn typename() -> &'static str {
        "type.googleapis.com/google.cloud.ces.v1.WidgetTool"
    }
}

/// Defines additional types related to [WidgetTool].
pub mod widget_tool {
    #[allow(unused_imports)]
    use super::*;

    /// Configuration for the text response returned with the widget.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct TextResponseConfig {
        /// Optional. The strategy for providing the text response.
        pub r#type: crate::model::widget_tool::text_response_config::Type,

        /// Optional. The static text response to return when type is STATIC.
        pub static_text: std::string::String,

        /// Optional. Instruction for the LLM on how to generate the text response.
        /// Used as the description for the text response parameter if type is
        /// LLM_GENERATED.
        pub text_response_instruction: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl TextResponseConfig {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [r#type][crate::model::widget_tool::TextResponseConfig::type].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::widget_tool::TextResponseConfig;
        /// use google_cloud_ces_v1::model::widget_tool::text_response_config::Type;
        /// let x0 = TextResponseConfig::new().set_type(Type::None);
        /// let x1 = TextResponseConfig::new().set_type(Type::LlmGenerated);
        /// let x2 = TextResponseConfig::new().set_type(Type::Static);
        /// ```
        pub fn set_type<
            T: std::convert::Into<crate::model::widget_tool::text_response_config::Type>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.r#type = v.into();
            self
        }

        /// Sets the value of [static_text][crate::model::widget_tool::TextResponseConfig::static_text].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::widget_tool::TextResponseConfig;
        /// let x = TextResponseConfig::new().set_static_text("example");
        /// ```
        pub fn set_static_text<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.static_text = v.into();
            self
        }

        /// Sets the value of [text_response_instruction][crate::model::widget_tool::TextResponseConfig::text_response_instruction].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::widget_tool::TextResponseConfig;
        /// let x = TextResponseConfig::new().set_text_response_instruction("example");
        /// ```
        pub fn set_text_response_instruction<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.text_response_instruction = v.into();
            self
        }
    }

    impl wkt::message::Message for TextResponseConfig {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.WidgetTool.TextResponseConfig"
        }
    }

    /// Defines additional types related to [TextResponseConfig].
    pub mod text_response_config {
        #[allow(unused_imports)]
        use super::*;

        /// Defines how the text response is produced.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum Type {
            /// Unspecified type.
            Unspecified,
            /// The LLM dynamically decides whether to generate a text response
            /// alongside the widget based on the conversation context.
            None,
            /// The LLM is explicitly required to generate a text response.
            LlmGenerated,
            /// A pre-defined static text response is always used.
            Static,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [Type::value] or
            /// [Type::name].
            UnknownValue(r#type::UnknownValue),
        }

        #[doc(hidden)]
        pub mod r#type {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl Type {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::None => std::option::Option::Some(1),
                    Self::LlmGenerated => std::option::Option::Some(2),
                    Self::Static => std::option::Option::Some(3),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("TYPE_UNSPECIFIED"),
                    Self::None => std::option::Option::Some("NONE"),
                    Self::LlmGenerated => std::option::Option::Some("LLM_GENERATED"),
                    Self::Static => std::option::Option::Some("STATIC"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for Type {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for Type {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for Type {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::None,
                    2 => Self::LlmGenerated,
                    3 => Self::Static,
                    _ => Self::UnknownValue(r#type::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for Type {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "TYPE_UNSPECIFIED" => Self::Unspecified,
                    "NONE" => Self::None,
                    "LLM_GENERATED" => Self::LlmGenerated,
                    "STATIC" => Self::Static,
                    _ => Self::UnknownValue(r#type::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for Type {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::None => serializer.serialize_i32(1),
                    Self::LlmGenerated => serializer.serialize_i32(2),
                    Self::Static => serializer.serialize_i32(3),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for Type {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<Type>::new(
                    ".google.cloud.ces.v1.WidgetTool.TextResponseConfig.Type",
                ))
            }
        }
    }

    /// Configuration for mapping data from a source tool to the widget's input
    /// parameters.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct DataMapping {
        /// Optional. The resource name of the tool that provides the data for the
        /// widget (e.g., a search tool or a custom function). Format:
        /// `projects/{project}/locations/{location}/agents/{agent}/tools/{tool}`
        pub source_tool_name: std::string::String,

        /// Optional. A map of widget input parameter fields to the corresponding
        /// output fields of the source tool.
        pub field_mappings: std::collections::HashMap<std::string::String, std::string::String>,

        /// Optional. Configuration for a Python function used to transform the
        /// source tool's output into the widget's input format.
        pub python_function: std::option::Option<crate::model::PythonFunction>,

        /// Optional. The mode of the data mapping.
        pub mode: crate::model::widget_tool::data_mapping::Mode,

        /// Deprecated: Use `python_function` instead.
        #[deprecated]
        pub python_script: std::string::String,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl DataMapping {
        /// Creates a new default instance.
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [source_tool_name][crate::model::widget_tool::DataMapping::source_tool_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::widget_tool::DataMapping;
        /// let x = DataMapping::new().set_source_tool_name("example");
        /// ```
        pub fn set_source_tool_name<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.source_tool_name = v.into();
            self
        }

        /// Sets the value of [field_mappings][crate::model::widget_tool::DataMapping::field_mappings].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::widget_tool::DataMapping;
        /// let x = DataMapping::new().set_field_mappings([
        ///     ("key0", "abc"),
        ///     ("key1", "xyz"),
        /// ]);
        /// ```
        pub fn set_field_mappings<T, K, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = (K, V)>,
            K: std::convert::Into<std::string::String>,
            V: std::convert::Into<std::string::String>,
        {
            use std::iter::Iterator;
            self.field_mappings = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
            self
        }

        /// Sets the value of [python_function][crate::model::widget_tool::DataMapping::python_function].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::widget_tool::DataMapping;
        /// use google_cloud_ces_v1::model::PythonFunction;
        /// let x = DataMapping::new().set_python_function(PythonFunction::default()/* use setters */);
        /// ```
        pub fn set_python_function<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::PythonFunction>,
        {
            self.python_function = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [python_function][crate::model::widget_tool::DataMapping::python_function].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::widget_tool::DataMapping;
        /// use google_cloud_ces_v1::model::PythonFunction;
        /// let x = DataMapping::new().set_or_clear_python_function(Some(PythonFunction::default()/* use setters */));
        /// let x = DataMapping::new().set_or_clear_python_function(None::<PythonFunction>);
        /// ```
        pub fn set_or_clear_python_function<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::PythonFunction>,
        {
            self.python_function = v.map(|x| x.into());
            self
        }

        /// Sets the value of [mode][crate::model::widget_tool::DataMapping::mode].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::widget_tool::DataMapping;
        /// use google_cloud_ces_v1::model::widget_tool::data_mapping::Mode;
        /// let x0 = DataMapping::new().set_mode(Mode::FieldMapping);
        /// let x1 = DataMapping::new().set_mode(Mode::PythonScript);
        /// ```
        pub fn set_mode<T: std::convert::Into<crate::model::widget_tool::data_mapping::Mode>>(
            mut self,
            v: T,
        ) -> Self {
            self.mode = v.into();
            self
        }

        /// Sets the value of [python_script][crate::model::widget_tool::DataMapping::python_script].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_ces_v1::model::widget_tool::DataMapping;
        /// let x = DataMapping::new().set_python_script("example");
        /// ```
        #[deprecated]
        pub fn set_python_script<T: std::convert::Into<std::string::String>>(
            mut self,
            v: T,
        ) -> Self {
            self.python_script = v.into();
            self
        }
    }

    impl wkt::message::Message for DataMapping {
        fn typename() -> &'static str {
            "type.googleapis.com/google.cloud.ces.v1.WidgetTool.DataMapping"
        }
    }

    /// Defines additional types related to [DataMapping].
    pub mod data_mapping {
        #[allow(unused_imports)]
        use super::*;

        /// The strategy used to map data from the source tool to the widget.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum Mode {
            /// Unspecified mode.
            Unspecified,
            /// Use the `field_mappings` map for data transformation.
            FieldMapping,
            /// Use the `python_script` for data transformation.
            PythonScript,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [Mode::value] or
            /// [Mode::name].
            UnknownValue(mode::UnknownValue),
        }

        #[doc(hidden)]
        pub mod mode {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl Mode {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::FieldMapping => std::option::Option::Some(1),
                    Self::PythonScript => std::option::Option::Some(2),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("MODE_UNSPECIFIED"),
                    Self::FieldMapping => std::option::Option::Some("FIELD_MAPPING"),
                    Self::PythonScript => std::option::Option::Some("PYTHON_SCRIPT"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for Mode {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for Mode {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for Mode {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::FieldMapping,
                    2 => Self::PythonScript,
                    _ => Self::UnknownValue(mode::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for Mode {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "MODE_UNSPECIFIED" => Self::Unspecified,
                    "FIELD_MAPPING" => Self::FieldMapping,
                    "PYTHON_SCRIPT" => Self::PythonScript,
                    _ => Self::UnknownValue(mode::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for Mode {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::FieldMapping => serializer.serialize_i32(1),
                    Self::PythonScript => serializer.serialize_i32(2),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for Mode {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<Mode>::new(
                    ".google.cloud.ces.v1.WidgetTool.DataMapping.Mode",
                ))
            }
        }
    }

    /// All available widget types.
    /// New values may be added to this enum in the future.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum WidgetType {
        /// Unspecified widget type.
        Unspecified,
        /// Custom widget type.
        Custom,
        /// Product carousel widget.
        ProductCarousel,
        /// Product details widget.
        ProductDetails,
        /// Quick actions widget.
        QuickActions,
        /// Product comparison widget.
        ProductComparison,
        /// Advanced product details widget.
        AdvancedProductDetails,
        /// Short form widget.
        ShortForm,
        /// Overall satisfaction widget.
        OverallSatisfaction,
        /// Order summary widget.
        OrderSummary,
        /// Appointment details widget.
        AppointmentDetails,
        /// Appointment scheduler widget.
        AppointmentScheduler,
        /// Contact form widget.
        ContactForm,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [WidgetType::value] or
        /// [WidgetType::name].
        UnknownValue(widget_type::UnknownValue),
    }

    #[doc(hidden)]
    pub mod widget_type {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl WidgetType {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Custom => std::option::Option::Some(1),
                Self::ProductCarousel => std::option::Option::Some(2),
                Self::ProductDetails => std::option::Option::Some(3),
                Self::QuickActions => std::option::Option::Some(4),
                Self::ProductComparison => std::option::Option::Some(5),
                Self::AdvancedProductDetails => std::option::Option::Some(6),
                Self::ShortForm => std::option::Option::Some(7),
                Self::OverallSatisfaction => std::option::Option::Some(8),
                Self::OrderSummary => std::option::Option::Some(9),
                Self::AppointmentDetails => std::option::Option::Some(10),
                Self::AppointmentScheduler => std::option::Option::Some(11),
                Self::ContactForm => std::option::Option::Some(12),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("WIDGET_TYPE_UNSPECIFIED"),
                Self::Custom => std::option::Option::Some("CUSTOM"),
                Self::ProductCarousel => std::option::Option::Some("PRODUCT_CAROUSEL"),
                Self::ProductDetails => std::option::Option::Some("PRODUCT_DETAILS"),
                Self::QuickActions => std::option::Option::Some("QUICK_ACTIONS"),
                Self::ProductComparison => std::option::Option::Some("PRODUCT_COMPARISON"),
                Self::AdvancedProductDetails => {
                    std::option::Option::Some("ADVANCED_PRODUCT_DETAILS")
                }
                Self::ShortForm => std::option::Option::Some("SHORT_FORM"),
                Self::OverallSatisfaction => std::option::Option::Some("OVERALL_SATISFACTION"),
                Self::OrderSummary => std::option::Option::Some("ORDER_SUMMARY"),
                Self::AppointmentDetails => std::option::Option::Some("APPOINTMENT_DETAILS"),
                Self::AppointmentScheduler => std::option::Option::Some("APPOINTMENT_SCHEDULER"),
                Self::ContactForm => std::option::Option::Some("CONTACT_FORM"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for WidgetType {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for WidgetType {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for WidgetType {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Custom,
                2 => Self::ProductCarousel,
                3 => Self::ProductDetails,
                4 => Self::QuickActions,
                5 => Self::ProductComparison,
                6 => Self::AdvancedProductDetails,
                7 => Self::ShortForm,
                8 => Self::OverallSatisfaction,
                9 => Self::OrderSummary,
                10 => Self::AppointmentDetails,
                11 => Self::AppointmentScheduler,
                12 => Self::ContactForm,
                _ => Self::UnknownValue(widget_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for WidgetType {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "WIDGET_TYPE_UNSPECIFIED" => Self::Unspecified,
                "CUSTOM" => Self::Custom,
                "PRODUCT_CAROUSEL" => Self::ProductCarousel,
                "PRODUCT_DETAILS" => Self::ProductDetails,
                "QUICK_ACTIONS" => Self::QuickActions,
                "PRODUCT_COMPARISON" => Self::ProductComparison,
                "ADVANCED_PRODUCT_DETAILS" => Self::AdvancedProductDetails,
                "SHORT_FORM" => Self::ShortForm,
                "OVERALL_SATISFACTION" => Self::OverallSatisfaction,
                "ORDER_SUMMARY" => Self::OrderSummary,
                "APPOINTMENT_DETAILS" => Self::AppointmentDetails,
                "APPOINTMENT_SCHEDULER" => Self::AppointmentScheduler,
                "CONTACT_FORM" => Self::ContactForm,
                _ => Self::UnknownValue(widget_type::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for WidgetType {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Custom => serializer.serialize_i32(1),
                Self::ProductCarousel => serializer.serialize_i32(2),
                Self::ProductDetails => serializer.serialize_i32(3),
                Self::QuickActions => serializer.serialize_i32(4),
                Self::ProductComparison => serializer.serialize_i32(5),
                Self::AdvancedProductDetails => serializer.serialize_i32(6),
                Self::ShortForm => serializer.serialize_i32(7),
                Self::OverallSatisfaction => serializer.serialize_i32(8),
                Self::OrderSummary => serializer.serialize_i32(9),
                Self::AppointmentDetails => serializer.serialize_i32(10),
                Self::AppointmentScheduler => serializer.serialize_i32(11),
                Self::ContactForm => serializer.serialize_i32(12),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for WidgetType {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<WidgetType>::new(
                ".google.cloud.ces.v1.WidgetTool.WidgetType",
            ))
        }
    }

    /// The input of the widget tool.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum Input {
        /// Optional. The input parameters of the widget tool.
        Parameters(std::boxed::Box<crate::model::Schema>),
    }
}

/// The execution type of the tool or toolset.
///
/// # Working with unknown values
///
/// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
/// additional enum variants at any time. Adding new variants is not considered
/// a breaking change. Applications should write their code in anticipation of:
///
/// - New values appearing in future releases of the client library, **and**
/// - New values received dynamically, without application changes.
///
/// Please consult the [Working with enums] section in the user guide for some
/// guidelines.
///
/// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub enum ExecutionType {
    /// The execution type is unspecified. Defaults to `SYNCHRONOUS` if
    /// unspecified.
    Unspecified,
    /// The tool is executed synchronously. The session is blocked
    /// until the tool returns.
    Synchronous,
    /// The tool is executed asynchronously. The session will
    /// continue while the tool is executing.
    Asynchronous,
    /// If set, the enum was initialized with an unknown value.
    ///
    /// Applications can examine the value using [ExecutionType::value] or
    /// [ExecutionType::name].
    UnknownValue(execution_type::UnknownValue),
}

#[doc(hidden)]
pub mod execution_type {
    #[allow(unused_imports)]
    use super::*;
    #[derive(Clone, Debug, PartialEq)]
    pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
}

impl ExecutionType {
    /// Gets the enum value.
    ///
    /// Returns `None` if the enum contains an unknown value deserialized from
    /// the string representation of enums.
    pub fn value(&self) -> std::option::Option<i32> {
        match self {
            Self::Unspecified => std::option::Option::Some(0),
            Self::Synchronous => std::option::Option::Some(1),
            Self::Asynchronous => std::option::Option::Some(2),
            Self::UnknownValue(u) => u.0.value(),
        }
    }

    /// Gets the enum value as a string.
    ///
    /// Returns `None` if the enum contains an unknown value deserialized from
    /// the integer representation of enums.
    pub fn name(&self) -> std::option::Option<&str> {
        match self {
            Self::Unspecified => std::option::Option::Some("EXECUTION_TYPE_UNSPECIFIED"),
            Self::Synchronous => std::option::Option::Some("SYNCHRONOUS"),
            Self::Asynchronous => std::option::Option::Some("ASYNCHRONOUS"),
            Self::UnknownValue(u) => u.0.name(),
        }
    }
}

impl std::default::Default for ExecutionType {
    fn default() -> Self {
        use std::convert::From;
        Self::from(0)
    }
}

impl std::fmt::Display for ExecutionType {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
        wkt::internal::display_enum(f, self.name(), self.value())
    }
}

impl std::convert::From<i32> for ExecutionType {
    fn from(value: i32) -> Self {
        match value {
            0 => Self::Unspecified,
            1 => Self::Synchronous,
            2 => Self::Asynchronous,
            _ => Self::UnknownValue(execution_type::UnknownValue(
                wkt::internal::UnknownEnumValue::Integer(value),
            )),
        }
    }
}

impl std::convert::From<&str> for ExecutionType {
    fn from(value: &str) -> Self {
        use std::string::ToString;
        match value {
            "EXECUTION_TYPE_UNSPECIFIED" => Self::Unspecified,
            "SYNCHRONOUS" => Self::Synchronous,
            "ASYNCHRONOUS" => Self::Asynchronous,
            _ => Self::UnknownValue(execution_type::UnknownValue(
                wkt::internal::UnknownEnumValue::String(value.to_string()),
            )),
        }
    }
}

impl serde::ser::Serialize for ExecutionType {
    fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        match self {
            Self::Unspecified => serializer.serialize_i32(0),
            Self::Synchronous => serializer.serialize_i32(1),
            Self::Asynchronous => serializer.serialize_i32(2),
            Self::UnknownValue(u) => u.0.serialize(serializer),
        }
    }
}

impl<'de> serde::de::Deserialize<'de> for ExecutionType {
    fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
    where
        D: serde::Deserializer<'de>,
    {
        deserializer.deserialize_any(wkt::internal::EnumVisitor::<ExecutionType>::new(
            ".google.cloud.ces.v1.ExecutionType",
        ))
    }
}

/// AudioEncoding specifies the encoding format for audio data.
///
/// # Working with unknown values
///
/// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
/// additional enum variants at any time. Adding new variants is not considered
/// a breaking change. Applications should write their code in anticipation of:
///
/// - New values appearing in future releases of the client library, **and**
/// - New values received dynamically, without application changes.
///
/// Please consult the [Working with enums] section in the user guide for some
/// guidelines.
///
/// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub enum AudioEncoding {
    /// Unspecified audio encoding.
    Unspecified,
    /// 16-bit linear PCM audio encoding.
    Linear16,
    /// 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.
    Mulaw,
    /// 8-bit samples that compand 14-bit audio samples using G.711 PCMU/A-law.
    Alaw,
    /// If set, the enum was initialized with an unknown value.
    ///
    /// Applications can examine the value using [AudioEncoding::value] or
    /// [AudioEncoding::name].
    UnknownValue(audio_encoding::UnknownValue),
}

#[doc(hidden)]
pub mod audio_encoding {
    #[allow(unused_imports)]
    use super::*;
    #[derive(Clone, Debug, PartialEq)]
    pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
}

impl AudioEncoding {
    /// Gets the enum value.
    ///
    /// Returns `None` if the enum contains an unknown value deserialized from
    /// the string representation of enums.
    pub fn value(&self) -> std::option::Option<i32> {
        match self {
            Self::Unspecified => std::option::Option::Some(0),
            Self::Linear16 => std::option::Option::Some(1),
            Self::Mulaw => std::option::Option::Some(2),
            Self::Alaw => std::option::Option::Some(3),
            Self::UnknownValue(u) => u.0.value(),
        }
    }

    /// Gets the enum value as a string.
    ///
    /// Returns `None` if the enum contains an unknown value deserialized from
    /// the integer representation of enums.
    pub fn name(&self) -> std::option::Option<&str> {
        match self {
            Self::Unspecified => std::option::Option::Some("AUDIO_ENCODING_UNSPECIFIED"),
            Self::Linear16 => std::option::Option::Some("LINEAR16"),
            Self::Mulaw => std::option::Option::Some("MULAW"),
            Self::Alaw => std::option::Option::Some("ALAW"),
            Self::UnknownValue(u) => u.0.name(),
        }
    }
}

impl std::default::Default for AudioEncoding {
    fn default() -> Self {
        use std::convert::From;
        Self::from(0)
    }
}

impl std::fmt::Display for AudioEncoding {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
        wkt::internal::display_enum(f, self.name(), self.value())
    }
}

impl std::convert::From<i32> for AudioEncoding {
    fn from(value: i32) -> Self {
        match value {
            0 => Self::Unspecified,
            1 => Self::Linear16,
            2 => Self::Mulaw,
            3 => Self::Alaw,
            _ => Self::UnknownValue(audio_encoding::UnknownValue(
                wkt::internal::UnknownEnumValue::Integer(value),
            )),
        }
    }
}

impl std::convert::From<&str> for AudioEncoding {
    fn from(value: &str) -> Self {
        use std::string::ToString;
        match value {
            "AUDIO_ENCODING_UNSPECIFIED" => Self::Unspecified,
            "LINEAR16" => Self::Linear16,
            "MULAW" => Self::Mulaw,
            "ALAW" => Self::Alaw,
            _ => Self::UnknownValue(audio_encoding::UnknownValue(
                wkt::internal::UnknownEnumValue::String(value.to_string()),
            )),
        }
    }
}

impl serde::ser::Serialize for AudioEncoding {
    fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        match self {
            Self::Unspecified => serializer.serialize_i32(0),
            Self::Linear16 => serializer.serialize_i32(1),
            Self::Mulaw => serializer.serialize_i32(2),
            Self::Alaw => serializer.serialize_i32(3),
            Self::UnknownValue(u) => u.0.serialize(serializer),
        }
    }
}

impl<'de> serde::de::Deserialize<'de> for AudioEncoding {
    fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
    where
        D: serde::Deserializer<'de>,
    {
        deserializer.deserialize_any(wkt::internal::EnumVisitor::<AudioEncoding>::new(
            ".google.cloud.ces.v1.AudioEncoding",
        ))
    }
}