Struct PublicChatChannelConfig 

pub struct PublicChatChannelConfig {
    pub anonymous: bool,
    pub token: Option<String>,
    pub session_expiration_seconds: u32,
    pub rate_limit_per_minute: Option<u32>,
    pub tool_visibility: AgUiToolVisibility,
    pub generic_tool_text: String,
    pub auth: Option<AppEndpointAuthConfig>,
    pub branding: PublicChatBranding,
    pub captcha: Option<PublicChatCaptchaConfig>,
}

Typed Public Chat channel configuration.

Parsed from the channel_config JSON field on App. Public Chat reuses AG-UI’s streaming semantics and the shared App endpoint auth verifier, and adds branding and bot-mitigation tailored to a public, link-shareable chat website. See specs/public-chat.md.

Fields

anonymous: bool

Whether anonymous access is allowed. Anonymous-by-default mirrors AG-UI. When false, visitors must authenticate (e.g. via auth Google OIDC).

token: Option<String>

Optional shared bearer token for simple gated access. When set, requests must include the token in a supported header. Redacted on read.

session_expiration_seconds: u32

How long (in seconds) a visitor session can be resumed before a fresh one must be started. 0 disables expiration. Defaults to 6 hours.

rate_limit_per_minute: Option<u32>

Optional per-IP, per-app rate limit in requests per minute. None or Some(0) disables the per-app cap (the global API limit still applies).

tool_visibility: AgUiToolVisibility

Public tool activity visibility. Same rules as AG-UI: raw tool names, args, results, and internal IDs are never exposed on public streams.

generic_tool_text: String

Generic public text shown when tool_visibility is generic/narrated.

auth: Option<AppEndpointAuthConfig>

Optional inline auth config for this public endpoint (e.g. Google OIDC). When omitted, anonymous + optional token behavior applies.

branding: PublicChatBranding

Branding shown on the public chat surface.

captcha: Option<PublicChatCaptchaConfig>

Optional bot-mitigation / CAPTCHA configuration (Cloudflare Turnstile).

Implementations

impl PublicChatChannelConfig

pub fn ag_ui_stream_config(&self) -> AgUiChannelConfig

Project the streaming-relevant fields onto an AgUiChannelConfig so the shared AG-UI ingress/streaming core can serve Public Chat without a parallel implementation. Branding and captcha are Public-Chat-only and are handled by the Public Chat handler, not the shared core.

pub fn captcha_enforced(&self) -> bool

Whether the Turnstile/CAPTCHA challenge should be enforced for an anonymous visitor. Returns false when no captcha is configured or it is explicitly disabled. Signed-in visitors (validated via auth) bypass the challenge and are handled by the caller.

Trait Implementations

impl Clone for PublicChatChannelConfig

fn clone(&self) -> PublicChatChannelConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PublicChatChannelConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PublicChatChannelConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PublicChatChannelConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.