iicp-client 0.7.93

Use the open IICP AI mesh from Rust without running a node
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

//! Pure, opt-in accounting decisions for the draft service lifecycle profile.

use serde_json::Value;

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct LifecycleAccountingDecision {
    pub decision: String,
    pub reservation_action: &'static str,
    pub settlement_action: &'static str,
    pub new_execution: bool,
}

fn result(
    decision: impl Into<String>,
    reservation_action: &'static str,
    settlement_action: &'static str,
    new_execution: bool,
) -> LifecycleAccountingDecision {
    LifecycleAccountingDecision {
        decision: decision.into(),
        reservation_action,
        settlement_action,
        new_execution,
    }
}

fn simple(decision: &str) -> LifecycleAccountingDecision {
    result(decision, "none", "none", false)
}

pub fn decide_lifecycle_accounting(input: &Value) -> LifecycleAccountingDecision {
    let operation = input.get("operation").and_then(Value::as_str);
    let binding = input.get("binding").and_then(Value::as_str);
    let reservation_exists = input.get("reservation_exists").and_then(Value::as_bool) == Some(true);
    let settlement_exists = input.get("settlement_exists").and_then(Value::as_bool) == Some(true);
    let accepted = input.get("accepted").and_then(Value::as_bool) == Some(true);
    let delivery = input.get("delivery").and_then(Value::as_str);

    if !matches!(
        operation,
        Some("submit" | "status" | "observe" | "resume" | "cancel" | "terminal")
    ) || !matches!(binding, Some("same" | "conflict" | "fresh"))
        || !matches!(delivery, Some("none" | "partial" | "complete"))
    {
        return simple("reject_invalid_input");
    }
    if matches!(
        operation,
        Some("status" | "observe" | "cancel" | "terminal")
    ) && binding != Some("same")
    {
        return simple("reject_conflict");
    }

    match operation.expect("validated operation") {
        "status" => simple("return_status"),
        "observe" => simple("replay_events"),
        "resume" => {
            if input.get("resume_available").and_then(Value::as_bool) == Some(true) {
                return simple("replay_events");
            }
            if input.get("explicit_new_task").and_then(Value::as_bool) != Some(true) {
                return simple("explicit_new_task_required");
            }
            if binding != Some("fresh")
                || input.get("fresh_task_id").and_then(Value::as_bool) != Some(true)
                || input.get("fresh_idempotency_key").and_then(Value::as_bool) != Some(true)
            {
                return simple("reject_identifier_reuse");
            }
            result("start_new_task", "create", "none", true)
        }
        "submit" => {
            if binding == Some("conflict") {
                simple("reject_conflict")
            } else if binding == Some("same") && reservation_exists {
                result("reuse_execution", "reuse", "none", false)
            } else if binding == Some("same") {
                simple("reject_missing_reservation")
            } else if reservation_exists {
                simple("reject_conflict")
            } else {
                result("start_execution", "create", "none", true)
            }
        }
        "cancel" => {
            if settlement_exists {
                return result("return_existing_settlement", "reuse", "reuse", false);
            }
            if !reservation_exists {
                return simple("cancel_without_accounting");
            }
            if !accepted {
                return result("cancel_before_acceptance", "release", "none", false);
            }
            let decision = if delivery == Some("partial") {
                "cancel_after_partial_delivery"
            } else {
                "cancel_after_acceptance"
            };
            result(decision, "reuse", "create", false)
        }
        "terminal" => {
            if settlement_exists {
                return result("return_existing_settlement", "reuse", "reuse", false);
            }
            if !reservation_exists {
                return simple("reject_missing_reservation");
            }
            let terminal_state = input.get("terminal_state").and_then(Value::as_str);
            if !matches!(
                terminal_state,
                Some("completed" | "failed" | "cancelled" | "expired")
            ) {
                return simple("reject_invalid_input");
            }
            let suffix = if delivery == Some("partial") {
                "_partial"
            } else {
                ""
            };
            result(
                format!(
                    "settle_{}{suffix}",
                    terminal_state.expect("validated terminal state")
                ),
                "reuse",
                "create",
                false,
            )
        }
        _ => simple("reject_invalid_input"),
    }
}