Struct CommonConfig 

pub struct CommonConfig {
    pub agent_id: String,
    pub auth_token: String,
    pub transports: HashMap<String, TransportConfig>,
    pub slash_commands: Vec<SlashCommandConfig>,
    pub push_relay: Option<PushRelayConfig>,
}

Stable agent identity and multi-transport settings.

Replaces the old BridgeConfig / bridge.toml. Stored as common.toml.

Fields

agent_id: String

Stable UUID that identifies this agent across all transports.

auth_token: String

Bearer token required for WebSocket connections.

transports: HashMap<String, TransportConfig>

Per-transport configuration, keyed by transport name (e.g., "local", "cloudflare", "tailscale-serve").

slash_commands: Vec<SlashCommandConfig>

Slash commands to advertise to clients via available_commands_update. Used for agents that don’t send this notification themselves. The bridge injects the notification after every session/new or session/load.

push_relay: Option<PushRelayConfig>

Push relay configuration. Push is disabled when this section is absent or any required field is empty — no hardcoded defaults.

Implementations

impl CommonConfig

pub fn config_path() -> PathBuf

Path to the common.toml file (default config dir).

pub fn config_dir() -> PathBuf

Config directory (system default or custom override).

pub fn load() -> Result<Self>

Load from common.toml at the default location, or return defaults.

pub fn load_from_dir(dir: &Path) -> Result<Self>

Load from common.toml in a specific directory, or return defaults.

pub fn save(&self) -> Result<()>

Save to common.toml with 0600 permissions (default config dir).

pub fn save_to_dir(&self, dir: &Path) -> Result<()>

Save to common.toml in a specific directory with 0600 permissions.

pub fn ensure_agent_id(&mut self)

Generate a UUID v4 agent_id if one is not already set.

pub fn generate_auth_token() -> String

Generate a random URL-safe authentication token (32 random bytes, base64).

pub fn ensure_auth_token(&mut self)

Ensure auth_token is populated, generating one if needed.

pub fn enabled_transports(&self) -> Vec<(&str, &TransportConfig)>

Returns all enabled transports, sorted by name for deterministic ordering.

pub fn to_connection_json( &self, hostname: &str, transport_name: &str, cwd: &str, ) -> Result<String>

Build a static connection JSON payload for a QR code.

Includes agentId, url, protocol, version, authToken, and Cloudflare credentials if present in the transport config.

Trait Implementations

impl Clone for CommonConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommonConfig

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

Formats the value using the given formatter.

impl Default for CommonConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CommonConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CommonConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.