jamjet-agents 0.3.1

JamJet agent registry, lifecycle, and Agent Card management
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

use serde::{Deserialize, Serialize};
use std::collections::HashMap;

/// The Agent Card — machine-readable capability manifest for a JamJet agent.
/// Aligned with the A2A Agent Card specification.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AgentCard {
    pub id: String,
    pub uri: String,
    pub name: String,
    pub description: String,
    pub version: String,
    pub capabilities: AgentCapabilities,
    pub autonomy: AutonomyLevel,
    pub constraints: Option<AutonomyConstraints>,
    pub auth: AuthSpec,
    /// Latency classification for routing decisions.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub latency_class: Option<LatencyClass>,
    /// Cost tier for delegation decisions.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cost_class: Option<CostClass>,
    /// Reasoning modes this agent supports (e.g. react, plan-and-execute, critic).
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub reasoning_modes: Vec<String>,
    #[serde(default)]
    pub labels: HashMap<String, String>,
}

/// Latency classification for agent routing and SLA matching.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum LatencyClass {
    /// Sub-second responses (caches, deterministic tools).
    Realtime,
    /// Seconds (fast model inference, simple tool calls).
    Fast,
    /// Tens of seconds (complex reasoning, multi-step).
    Medium,
    /// Minutes+ (research tasks, multi-agent delegation).
    Slow,
}

/// Cost tier for delegation budget planning.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum CostClass {
    /// Free or negligible cost (local tools, cached responses).
    Free,
    /// Low cost per invocation (small models, simple APIs).
    Low,
    /// Moderate cost (frontier models, paid APIs).
    Medium,
    /// High cost (long-running agents, expensive external services).
    High,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AgentCapabilities {
    pub skills: Vec<Skill>,
    /// Supported protocols: "mcp_server", "mcp_client", "a2a"
    pub protocols: Vec<String>,
    /// Tools this agent exposes to others.
    pub tools_provided: Vec<String>,
    /// Tools this agent needs from others.
    pub tools_consumed: Vec<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Skill {
    pub name: String,
    pub description: String,
    pub input_schema: String,
    pub output_schema: String,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum AutonomyLevel {
    Deterministic,
    #[default]
    Guided,
    BoundedAutonomous,
    FullyAutonomous,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AutonomyConstraints {
    pub max_iterations: Option<u32>,
    pub max_tool_calls: Option<u32>,
    pub token_budget: Option<u64>,
    pub cost_budget_usd: Option<f64>,
    /// Glob patterns for allowed tools (e.g. "search_*")
    pub allowed_tools: Vec<String>,
    /// Glob patterns for blocked tools (e.g. "delete_*")
    pub blocked_tools: Vec<String>,
    /// Agent ids this agent is allowed to delegate to.
    pub allowed_delegations: Vec<String>,
    /// Operations that require explicit approval before execution.
    pub require_approval_for: Vec<String>,
    pub time_budget_secs: Option<u64>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum AuthSpec {
    BearerToken { scopes: Vec<String> },
    ApiKey { header: String },
    None,
}