run-kit 0.7.1

Universal multi-language runner and smart REPL
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

//! Orchestrator
//!
//! Component lifecycle and inter-component calls.

mod lifecycle;
mod logging;
mod router;
#[cfg(test)]
mod tests;

pub use lifecycle::{ComponentStatus, HealthCheck, Orchestrator};
pub use logging::{LogAggregator, LogEntry, LogLevel};
pub use router::{CallRouter, RouteTarget};

use crate::v2::runtime::{ExecutionResult, InstanceHandle, RuntimeEngine};
use std::sync::{Arc, Mutex};
use std::time::{Duration, Instant};
#[derive(Debug, Clone)]
pub struct OrchestratorConfig {
    pub health_checks: bool,

    pub health_check_interval: Duration,

    pub restart_policy: RestartPolicy,

    pub max_restart_attempts: u32,

    pub log_buffer_size: usize,

    pub metrics_enabled: bool,
}

impl Default for OrchestratorConfig {
    fn default() -> Self {
        Self {
            health_checks: true,
            health_check_interval: Duration::from_secs(30),
            restart_policy: RestartPolicy::OnFailure,
            max_restart_attempts: 3,
            log_buffer_size: 10_000,
            metrics_enabled: true,
        }
    }
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum RestartPolicy {
    Never,

    OnFailure,

    Always,
}
#[derive(Debug)]
pub struct ManagedComponent {
    pub id: String,

    pub handle: Option<InstanceHandle>,

    pub status: ComponentStatus,

    pub restart_count: u32,

    pub last_health_check: Option<Instant>,

    pub healthy: bool,

    pub dependencies: Vec<String>,

    pub dependents: Vec<String>,
}
#[derive(Debug, Clone, Default)]
pub struct ComponentMetrics {
    pub call_count: u64,

    pub error_count: u64,

    pub total_time_ms: u64,

    pub avg_time_ms: f64,

    pub restart_count: u32,

    pub uptime_ms: u64,
}
#[derive(Debug, Clone, Default)]
pub struct OrchestratorMetrics {
    pub components_running: usize,
    pub components_stopped: usize,
    pub components_failed: usize,

    pub total_calls: u64,

    pub total_errors: u64,

    pub uptime_ms: u64,
}
#[derive(Debug, Clone)]
pub enum OrchestratorEvent {
    ComponentStarted {
        id: String,
    },

    ComponentStopped {
        id: String,
        exit_code: i32,
    },

    ComponentFailed {
        id: String,
        error: String,
    },

    ComponentRestarted {
        id: String,
        attempt: u32,
    },

    HealthCheckPassed {
        id: String,
    },

    HealthCheckFailed {
        id: String,
        reason: String,
    },

    ComponentCall {
        from: String,
        to: String,
        function: String,
    },
}
pub type EventCallback = Box<dyn Fn(&OrchestratorEvent) + Send + Sync>;

pub fn create_orchestrator(
    runtime: Arc<Mutex<RuntimeEngine>>,
    config: OrchestratorConfig,
) -> Orchestrator {
    Orchestrator::new(runtime, config)
}