Struct ProxyState 

pub struct ProxyState {

    pub proxy_url: String,
    pub tunnel_url: String,
    pub mcp_upstream: String,
    pub widgets: String,
    pub mcp_status: ConnectionStatus,
    pub mcp_warning: Option<String>,
    pub tunnel_status: ConnectionStatus,
    pub widgets_status: ConnectionStatus,
    pub widget_count: Option<usize>,
    pub widget_names: Vec<String>,
    pub cloud_endpoint: Option<String>,
    pub cloud_sync: Option<CloudSyncStatus>,
    pub started_at: Instant,
    pub request_count: u64,
}

Runtime state of a running proxy instance.

All fields are updated by background tasks (health checks, request handlers) and read by status/admin endpoints. Protected by a Mutex for simplicity — contention is negligible since updates are infrequent (every few seconds).

Fields

proxy_url: String

Public URL where AI clients connect (e.g., http://localhost:3000 or tunnel URL).

tunnel_url: String

Tunnel public URL (empty if tunnel disabled).

mcp_upstream: String

Upstream MCP server URL from config.

widgets: String

Widget source description (“URL”, “path”, or “(none)”).

mcp_status: ConnectionStatus

MCP upstream connection health.

mcp_warning: Option<String>

Optional warning about MCP upstream (e.g., “Server requires auth”).

tunnel_status: ConnectionStatus

Tunnel connection health.

widgets_status: ConnectionStatus

Widget source connection health.

widget_count: Option<usize>

Number of discovered widgets.

widget_names: Vec<String>

Names of discovered widgets.

cloud_endpoint: Option<String>

Cloud sync endpoint URL (None if cloud not configured).

cloud_sync: Option<CloudSyncStatus>

Last cloud sync status.

started_at: Instant

When this proxy instance started.

request_count: u64

Total number of requests handled.

Implementations

impl ProxyState

pub fn new() -> Self

pub fn confirm_mcp_connected(&mut self)

Mark the MCP upstream as confirmed connected (clear any warning).

pub fn record_request(&mut self)

Increment request counter.

pub fn uptime(&self) -> String

Human-readable uptime string.

Trait Implementations

impl Default for ProxyState

fn default() -> Self

Returns the “default value” for a type.