Struct Config 

pub struct Config {

    pub mode: OperatingMode,
    pub x_api: XApiConfig,
    pub auth: AuthConfig,
    pub business: BusinessProfile,
    pub scoring: ScoringConfig,
    pub limits: LimitsConfig,
    pub intervals: IntervalsConfig,
    pub llm: LlmConfig,
    pub targets: TargetsConfig,
    pub approval_mode: bool,
    pub max_batch_approve: usize,
    pub server: ServerConfig,
    pub storage: StorageConfig,
    pub logging: LoggingConfig,
    pub schedule: ScheduleConfig,
    pub mcp_policy: McpPolicyConfig,
    pub circuit_breaker: CircuitBreakerConfig,
    pub content_sources: ContentSourcesConfig,
    pub deployment_mode: DeploymentMode,
    pub connectors: ConnectorConfig,
    pub embedding: Option<EmbeddingConfig>,
}

Top-level configuration for the Tuitbot agent.

Fields

mode: OperatingMode

Operating mode: “autopilot” (default) or “composer”.

x_api: XApiConfig

X API credentials.

auth: AuthConfig

Authentication settings.

business: BusinessProfile

Business profile for content targeting.

scoring: ScoringConfig

Scoring engine weights and threshold.

limits: LimitsConfig

Safety limits for API actions.

intervals: IntervalsConfig

Automation interval settings.

llm: LlmConfig

LLM provider configuration.

targets: TargetsConfig

Target account monitoring configuration.

approval_mode: bool

Enable approval mode: queue posts for human review instead of posting.

max_batch_approve: usize

Maximum items that can be batch-approved at once.

server: ServerConfig

Server binding configuration for LAN access.

storage: StorageConfig

Data storage configuration.

logging: LoggingConfig

Logging and observability settings.

schedule: ScheduleConfig

Active hours schedule for posting.

mcp_policy: McpPolicyConfig

MCP mutation policy enforcement.

circuit_breaker: CircuitBreakerConfig

Circuit breaker for X API rate-limit protection.

content_sources: ContentSourcesConfig

Content source configuration for the Watchtower.

deployment_mode: DeploymentMode

Deployment mode: desktop (default), self_host, or cloud. Controls which source types and features are available.

connectors: ConnectorConfig

Connector configuration for remote source OAuth flows.

embedding: Option<EmbeddingConfig>

Embedding provider configuration for semantic search indexing. When None, semantic indexing is disabled.

Implementations

impl Config

pub fn profile_completeness(&self) -> ProfileCompleteness

Compute profile completeness across all enrichment stages.

impl Config

pub fn validate_minimum(&self) -> Result<(), Vec<ConfigError>>

Validate the minimum configuration required for progressive activation.

Only checks business profile fields and structural requirements. Skips LLM API key, X API client_id, and other advanced fields that can be configured later via Settings.

pub fn validate(&self) -> Result<(), Vec<ConfigError>>

Validate the configuration, returning all errors found (not just the first).

impl Config

pub fn load(config_path: Option<&str>) -> Result<Config, ConfigError>

Load configuration from a TOML file with environment variable overrides.

The loading sequence:

1. Determine config file path (argument > TUITBOT_CONFIG env var > default)
2. Parse TOML file (or use defaults if default path doesn’t exist)
3. Apply environment variable overrides

pub fn load_and_validate( config_path: Option<&str>, ) -> Result<Config, Vec<ConfigError>>

Load configuration and validate it, returning all validation errors at once.

pub fn effective_approval_mode(&self) -> bool

Returns true if approval mode is effectively enabled.

In composer mode, approval mode is implicitly enabled for autonomous loops so the user controls all automated posting. Manual compose actions from the dashboard respect the explicit approval_mode setting — use Config::approval_mode directly for user-initiated flows.

pub fn is_composer_mode(&self) -> bool

Returns true if the agent is in composer mode.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

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

where __S: Serializer,

Serialize this value into the given Serde serializer.