orca-core 0.1.0-rc.2

Core types, configuration, Runtime trait, and error types for the orca orchestrator
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AiConfig {
    /// LLM provider: "litellm", "ollama", "openai", "anthropic"
    #[serde(default = "default_ai_provider")]
    pub provider: String,
    /// Endpoint URL (for litellm/ollama/compatible APIs).
    pub endpoint: Option<String>,
    /// Model identifier.
    pub model: Option<String>,
    /// API key (or use ${secrets.ai_api_key}).
    pub api_key: Option<String>,
    /// Conversational alerting configuration.
    #[serde(default)]
    pub alerts: Option<AiAlertConfig>,
    /// Auto-remediation rules.
    #[serde(default)]
    pub auto_remediate: Option<AutoRemediateConfig>,
}

fn default_ai_provider() -> String {
    "ollama".into()
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AiAlertConfig {
    /// Enable conversational alerts (default: true when [ai] is configured).
    #[serde(default = "default_true")]
    pub enabled: bool,
    /// How often to analyze cluster health (seconds, default: 60).
    #[serde(default = "default_analysis_interval")]
    pub analysis_interval_secs: u64,
    /// Channels to deliver conversation updates.
    pub channels: Option<AlertDeliveryChannels>,
}

fn default_true() -> bool {
    true
}

fn default_analysis_interval() -> u64 {
    60
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AlertDeliveryChannels {
    /// Webhook URL for alert conversation updates.
    pub webhook: Option<String>,
    /// Slack webhook for threaded alert conversations.
    pub slack: Option<String>,
    /// Email for alert digests.
    pub email: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AutoRemediateConfig {
    /// Auto-restart crashed services (default: true).
    #[serde(default = "default_true")]
    pub restart_crashed: bool,
    /// Auto-scale on resource pressure (default: false, suggest only).
    #[serde(default)]
    pub scale_on_pressure: bool,
    /// Auto-rollback on deploy failure (default: false, suggest only).
    #[serde(default)]
    pub rollback_on_failure: bool,
}