canic-host 0.110.45

Host-side App build and desired-state Fleet reconciliation library for Canic workspaces
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

//! Current preparation authority for a completed source, separate from old executable plans.

use crate::fleet_ensure::model::{
    EnsureAction, FleetTerminalSourceRecord, completed_handoff::CompletedEstateCustodyRecord,
};
use serde::{Deserialize, Serialize};
use std::collections::BTreeMap;

/// A separately reviewed, bounded set of authority seals; no wipe or payment is authorized.
#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
#[serde(deny_unknown_fields)]
pub struct CompletedPreparationReviewRecord {
    pub schema_version: u16,
    pub cli_release: String,
    pub environment: String,
    pub fleet: String,
    pub operation_id: String,
    pub source: FleetTerminalSourceRecord,
    pub custody: CompletedEstateCustodyRecord,
    pub source_artifacts: BTreeMap<String, String>,
    pub actions: Vec<EnsureAction>,
    /// Every retained physical ID and its inspection owner; None means direct operator custody.
    pub inspection_roots: BTreeMap<String, Option<String>>,
    pub source_accounting: CompletedSourceAccountingRecord,
    pub maximum_attempts_per_action: u32,
    pub maximum_observations_per_action: u32,
    #[serde(with = "crate::fleet_ensure::model::u128_text")]
    pub maximum_execution_burn_cycles: u128,
    pub review_sha256: String,
}

/// A consumed seal submission and its exact completion evidence.
#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
#[serde(deny_unknown_fields)]
pub struct CompletedPreparationEffectRecord {
    pub action_sha256: String,
    pub submission_attempts: u32,
    pub observation_attempts: u32,
    pub applied: bool,
    #[serde(deserialize_with = "crate::fleet_ensure::model::serialization::required_option")]
    pub before: Option<CompletedPreparationBalanceRecord>,
    #[serde(deserialize_with = "crate::fleet_ensure::model::serialization::required_option")]
    pub after: Option<CompletedPreparationBalanceRecord>,
}

/// Intent is retained before the first seal; each submission consumes its reviewed allowance.
#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
#[serde(deny_unknown_fields)]
pub struct CompletedPreparationJournalRecord {
    pub schema_version: u16,
    pub review_sha256: String,
    pub effects: Vec<CompletedPreparationEffectRecord>,
    pub inspections: BTreeMap<String, CompletedPreparationInspectionRecord>,
    pub prepared: bool,
}

/// Original receipt baseline is retained independently of newly sampled balances.
#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
#[serde(deny_unknown_fields)]
pub struct CompletedSourceAccountingRecord {
    #[serde(with = "crate::fleet_ensure::model::u128_text")]
    pub initial_native_cycles: u128,
    #[serde(with = "crate::fleet_ensure::model::u128_text")]
    pub recorded_funding_cycles: u128,
    #[serde(with = "crate::fleet_ensure::model::u128_text")]
    pub maximum_source_burn_cycles: u128,
}

/// A bounded management observation; consumed attempts survive an interrupted reply.
#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
#[serde(deny_unknown_fields)]
pub struct CompletedPreparationInspectionRecord {
    pub attempts: u32,
    #[serde(deserialize_with = "crate::fleet_ensure::model::serialization::required_option")]
    pub balance: Option<CompletedPreparationBalanceRecord>,
}

/// Native and reserved balances remain distinct; reserved funds cannot fund preparation.
#[derive(Clone, Copy, Debug, Deserialize, Eq, PartialEq, Serialize)]
#[serde(deny_unknown_fields)]
pub struct CompletedPreparationBalanceRecord {
    pub status: crate::fleet_ensure::model::CanisterRuntimeStatus,
    #[serde(with = "crate::fleet_ensure::model::u128_text")]
    pub native_cycles: u128,
    #[serde(with = "crate::fleet_ensure::model::u128_text")]
    pub reserved_cycles: u128,
}