Skip to main content

codewhale_protocol/
placement.rs

1use serde::{Deserialize, Serialize};
2
3#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
4#[serde(rename_all = "snake_case")]
5pub enum EnvironmentKind {
6    Local,
7    Remote,
8    Cloud,
9}
10
11#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
12#[serde(deny_unknown_fields)]
13pub struct EnvironmentResources {
14    #[serde(default, skip_serializing_if = "Option::is_none")]
15    pub cpu_cores: Option<u32>,
16    #[serde(default, skip_serializing_if = "Option::is_none")]
17    pub memory_mib: Option<u64>,
18    #[serde(default, skip_serializing_if = "Option::is_none")]
19    pub gpus: Option<u32>,
20}
21
22#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
23#[serde(deny_unknown_fields)]
24pub struct ExecutionEnvironment {
25    pub id: String,
26    pub kind: EnvironmentKind,
27    #[serde(default)]
28    pub resources: EnvironmentResources,
29    #[serde(default)]
30    pub capabilities: Vec<String>,
31    #[serde(default)]
32    pub data: Vec<String>,
33    #[serde(default, skip_serializing_if = "Option::is_none")]
34    pub persistent: Option<bool>,
35    #[serde(default, skip_serializing_if = "Option::is_none")]
36    pub cost_per_hour_microusd: Option<u64>,
37}
38
39#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
40#[serde(deny_unknown_fields)]
41pub struct PlacementRequirements {
42    #[serde(default)]
43    pub environments: Vec<String>,
44    #[serde(default)]
45    pub kinds: Vec<EnvironmentKind>,
46    #[serde(default)]
47    pub capabilities: Vec<String>,
48    #[serde(default)]
49    pub data: Vec<String>,
50    #[serde(default)]
51    pub resources: EnvironmentResources,
52    #[serde(default, skip_serializing_if = "Option::is_none")]
53    pub persistent: Option<bool>,
54    #[serde(default, skip_serializing_if = "Option::is_none")]
55    pub max_cost_per_hour_microusd: Option<u64>,
56    #[serde(default)]
57    pub prefer: Vec<String>,
58}
59
60#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
61#[serde(rename_all = "snake_case")]
62pub enum PlacementRefusalCode {
63    EnvironmentNotAllowed,
64    KindNotAllowed,
65    MissingCapability,
66    MissingData,
67    InsufficientResources,
68    PersistenceMismatch,
69    CostUnknown,
70    CostLimit,
71    WorkerBusy,
72    UnsupportedHost,
73}
74
75#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
76pub struct PlacementRefusal {
77    pub code: PlacementRefusalCode,
78    pub detail: String,
79}
80
81#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
82pub struct PlacementCandidate {
83    pub worker_id: String,
84    pub environment: ExecutionEnvironment,
85    pub eligible: bool,
86    pub refusals: Vec<PlacementRefusal>,
87}
88
89#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
90pub struct PlacementDecision {
91    pub task_id: String,
92    pub worker_id: Option<String>,
93    pub environment_id: Option<String>,
94    pub reason: String,
95    pub candidates: Vec<PlacementCandidate>,
96}