jacs 0.9.5

JACS JSON AI Communication Standard
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
141
142

use crate::observability::metrics::{increment_counter, record_histogram};
use std::collections::HashMap;
use tracing::{debug, error, info, warn};

/// Record an agent operation with both metrics and structured logging
pub fn record_agent_operation(operation: &str, agent_id: &str, success: bool, duration_ms: u64) {
    // Create a tracing span for this operation
    let span = tracing::info_span!(
        "agent_operation",
        operation = operation,
        agent_id = agent_id,
        success = success,
        duration_ms = duration_ms
    );
    let _enter = span.enter();

    let mut tags = HashMap::new();
    tags.insert("operation".to_string(), operation.to_string());
    tags.insert("agent_id".to_string(), agent_id.to_string());
    tags.insert("success".to_string(), success.to_string());

    // Metrics
    increment_counter("jacs_agent_operations_total", 1, Some(tags.clone()));
    record_histogram(
        "jacs_agent_operation_duration_ms",
        duration_ms as f64,
        Some(tags),
    );

    // Structured logging WITH ALL ORIGINAL METADATA
    if success {
        info!(
            operation = operation,
            agent_id = agent_id,
            duration_ms = duration_ms,
            "Agent operation completed successfully"
        );
    } else {
        error!(
            operation = operation,
            agent_id = agent_id,
            duration_ms = duration_ms,
            "Agent operation failed"
        );
    }
}

/// Record document validation with metrics and logging
pub fn record_document_validation(doc_id: &str, schema_version: &str, valid: bool) {
    let mut tags = HashMap::new();
    tags.insert("schema_version".to_string(), schema_version.to_string());
    tags.insert("valid".to_string(), valid.to_string());

    // Metrics
    increment_counter("jacs_document_validations_total", 1, Some(tags));

    // Structured logging
    if valid {
        debug!(
            document_id = doc_id,
            schema_version = schema_version,
            "Document validation passed"
        );
    } else {
        warn!(
            document_id = doc_id,
            schema_version = schema_version,
            "Document validation failed"
        );
    }
}

/// Record signature verification with metrics and logging
pub fn record_signature_verification(agent_id: &str, success: bool, algorithm: &str) {
    // Create a tracing span for signature verification
    let span = tracing::debug_span!(
        "signature_verification",
        agent_id = agent_id,
        algorithm = algorithm,
        success = success
    );
    let _enter = span.enter();

    let mut tags = HashMap::new();
    tags.insert("algorithm".to_string(), algorithm.to_string());
    tags.insert("success".to_string(), success.to_string());

    // Metrics
    increment_counter("jacs_signature_verifications_total", 1, Some(tags));

    // Structured logging
    if success {
        debug!("Signature verification successful");
    } else {
        error!("Signature verification failed");
    }
}

/// Record network communication metrics
pub fn record_network_request(endpoint: &str, method: &str, status_code: u16, duration_ms: u64) {
    // Create a tracing span for network request
    let span = tracing::info_span!(
        "network_request",
        endpoint = endpoint,
        method = method,
        status_code = status_code,
        duration_ms = duration_ms
    );
    let _enter = span.enter();

    let mut tags = HashMap::new();
    tags.insert("endpoint".to_string(), endpoint.to_string());
    tags.insert("method".to_string(), method.to_string());
    tags.insert("status_code".to_string(), status_code.to_string());

    increment_counter("jacs_network_requests_total", 1, Some(tags.clone()));
    record_histogram(
        "jacs_network_request_duration_ms",
        duration_ms as f64,
        Some(tags),
    );

    info!("Network request completed");
}

/// Record memory usage metrics
pub fn record_memory_usage(component: &str, bytes_used: u64) {
    let mut tags = HashMap::new();
    tags.insert("component".to_string(), component.to_string());

    crate::observability::metrics::set_gauge(
        "jacs_memory_usage_bytes",
        bytes_used as f64,
        Some(tags),
    );

    debug!(
        component = component,
        bytes_used = bytes_used,
        "Memory usage recorded"
    );
}