codetether-agent 4.5.7

A2A-native AI coding agent for the CodeTether ecosystem
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

use super::insert_field;
use crate::provenance::{ExecutionProvenance, sign_provenance};
use serde_json::{Map, Value, json};

/// Insert the standard provenance fields into a tool input object.
///
/// # Examples
///
/// ```rust
/// use codetether_agent::provenance::{ExecutionOrigin, ExecutionProvenance};
/// use codetether_agent::session::helper::runtime::insert_provenance_fields;
/// use serde_json::{Map, Value};
///
/// let mut obj = Map::<String, Value>::new();
/// let provenance = ExecutionProvenance::for_operation("agent-build", ExecutionOrigin::Swarm);
/// insert_provenance_fields(&mut obj, &provenance);
///
/// assert_eq!(obj["__ct_origin"], "swarm");
/// assert!(obj.get("__ct_provenance_id").is_some());
/// ```
pub fn insert_provenance_fields(obj: &mut Map<String, Value>, provenance: &ExecutionProvenance) {
    for (key, value) in [
        (
            "__ct_provenance_id",
            Some(provenance.provenance_id.as_str()),
        ),
        ("__ct_origin", Some(provenance.identity.origin.as_str())),
        ("__ct_worker_id", provenance.identity.worker_id.as_deref()),
        ("__ct_task_id", provenance.task_id.as_deref()),
        ("__ct_run_id", provenance.run_id.as_deref()),
        ("__ct_attempt_id", provenance.attempt_id.as_deref()),
        ("__ct_tenant_id", provenance.identity.tenant_id.as_deref()),
        (
            "__ct_agent_identity_id",
            provenance.identity.agent_identity_id.as_deref(),
        ),
        ("__ct_key_id", provenance.identity.key_id.as_deref()),
    ] {
        insert_provenance_field(obj, key, value);
    }
    if let Some(signature) = sign_provenance(provenance) {
        obj.entry("__ct_signature".to_string())
            .or_insert_with(|| json!(signature));
    }
}

/// Insert a single provenance field into a tool input object.
///
/// # Examples
///
/// ```rust
/// use codetether_agent::session::helper::runtime::insert_provenance_field;
/// use serde_json::{Map, Value};
///
/// let mut obj = Map::<String, Value>::new();
/// insert_provenance_field(&mut obj, "__ct_origin", Some("swarm"));
/// insert_provenance_field(&mut obj, "__ct_missing", None);
///
/// assert_eq!(obj["__ct_origin"], "swarm");
/// assert!(!obj.contains_key("__ct_missing"));
/// ```
pub fn insert_provenance_field(obj: &mut Map<String, Value>, key: &str, value: Option<&str>) {
    insert_field(obj, key, value);
}