rightkit-agent-engine-protocol 0.1.0

Agent engine protocol: events, envelopes, tool calls, trust wrapping and settlement types shared by agent hosts
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

use super::*;

#[test]
fn transcript_message_system_kind() {
    let msg = TranscriptMessage::System {
        id: "m1".into(),
        created_at: "t".into(),
        content: "You are a helpful assistant.".into(),
        pinned: false,
    };
    let json = serde_json::to_string(&msg).unwrap();
    assert!(json.contains(r#""$kind":"system""#), "got: {json}");
    let rt: TranscriptMessage = serde_json::from_str(&json).unwrap();
    assert!(matches!(rt, TranscriptMessage::System { .. }));
}

#[test]
fn transcript_message_user_kind() {
    let msg = TranscriptMessage::User {
        id: "m2".into(),
        created_at: "t".into(),
        content: "Hello!".into(),
        trust: None,
        pinned: false,
        attachments: Vec::new(),
    };
    let json = serde_json::to_string(&msg).unwrap();
    assert!(json.contains(r#""$kind":"user""#), "got: {json}");
    let rt: TranscriptMessage = serde_json::from_str(&json).unwrap();
    assert!(matches!(rt, TranscriptMessage::User { .. }));
}

#[test]
fn transcript_message_assistant_kind() {
    let msg = TranscriptMessage::Assistant {
        id: "m3".into(),
        created_at: "t".into(),
        content: "Hi there!".into(),
        reasoning_content: Some("thinking...".into()),
        tool_calls: vec![],
        pinned: false,
    };
    let json = serde_json::to_string(&msg).unwrap();
    assert!(json.contains(r#""$kind":"assistant""#), "got: {json}");
    let rt: TranscriptMessage = serde_json::from_str(&json).unwrap();
    assert!(matches!(rt, TranscriptMessage::Assistant { .. }));
}

#[test]
fn transcript_message_tool_kind() {
    let msg = TranscriptMessage::Tool {
        id: "m4".into(),
        created_at: "t".into(),
        tool_call_id: "tc1".into(),
        summary: "wrote 3 files".into(),
        output: None,
        trust: Some(TrustEnvelope {
            trust: ContentTrust::ToolUntrusted,
            source: "tool:write_file".into(),
            instructions_are_data: true,
            content_hash: "sha256:test".into(),
        }),
        is_error: false,
        pinned: false,
        process_id: None,
    };
    let json = serde_json::to_string(&msg).unwrap();
    assert!(json.contains(r#""$kind":"tool""#), "got: {json}");
    assert!(json.contains(r#""trust":"toolUntrusted""#), "got: {json}");
    let rt: TranscriptMessage = serde_json::from_str(&json).unwrap();
    assert!(matches!(
        rt,
        TranscriptMessage::Tool {
            trust: Some(envelope),
            ..
        } if envelope.trust == ContentTrust::ToolUntrusted
    ));

    let legacy = r#"{"$kind":"tool","id":"m4","createdAt":"t","toolCallId":"tc1","summary":"wrote 3 files","isError":false,"pinned":false}"#;
    let rt: TranscriptMessage = serde_json::from_str(legacy).unwrap();
    assert!(matches!(rt, TranscriptMessage::Tool { trust: None, .. }));
}

#[test]
fn transcript_message_compact_kind() {
    let msg = TranscriptMessage::Compact {
        id: "m5".into(),
        created_at: "t".into(),
        summary: "10 turns summarized.".into(),
        dropped_count: 10,
        pinned: false,
    };
    let json = serde_json::to_string(&msg).unwrap();
    assert!(json.contains(r#""$kind":"compact""#), "got: {json}");
    let rt: TranscriptMessage = serde_json::from_str(&json).unwrap();
    assert!(matches!(rt, TranscriptMessage::Compact { .. }));
}

// ── camelCase field name spot-checks ──────────────────────────────────────