agenttrustid 0.3.0

AgentTrust ID SDK — runtime authorization, opaque agent tokens, and Guardian checks for AI agents
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

//! # AgentTrust SDK
//!
//! The AgentTrust SDK provides authentication and authorization for AI agents.
//! It enables secure, auditable agent operations through identity management,
//! capability tokens, pre-flight action checks, and telemetry reporting.
//!
//! ## Quick Start
//!
//! ```rust,no_run
//! use agenttrustid::{AgentTrustClient, CreateAgentRequest, IssueTokenRequest, AgentTrustGuard};
//!
//! // Create a client
//! let client = AgentTrustClient::builder()
//!     .base_url("http://localhost:8080")
//!     .api_key("sk_live_xxx")
//!     .build()
//!     .unwrap();
//!
//! // Register an agent
//! let agent = client.agents().create(&CreateAgentRequest {
//!     name: "my-assistant".to_string(),
//!     framework: "langchain".to_string(),
//!     capabilities: vec!["files:read".to_string()],
//!     ..Default::default()
//! }).unwrap();
//!
//! // Issue an opaque agent token (prefix `at_`)
//! let token = client.tokens().issue(&IssueTokenRequest {
//!     agent_id: agent.id.clone(),
//!     scope: vec!["files:read".to_string()],
//!     audience: vec!["mcp://filesystem".to_string()],
//!     ttl: 300,
//! }).unwrap();
//!
//! println!("Token: {}", token.token);
//! ```
//!
//! ## Guard Pattern
//!
//! The [`AgentTrustGuard`] provides a high-level wrapper for agents using raw
//! OpenAI/Anthropic SDKs:
//!
//! ```rust,no_run
//! use agenttrustid::{AgentTrustClient, AgentTrustGuard};
//!
//! let client = AgentTrustClient::from_env().unwrap();
//! let guard = AgentTrustGuard::new(client, "agent-123");
//!
//! // Before tool calls
//! guard.check("web_search", "AI news").unwrap();
//!
//! // After tool calls
//! guard.report("web_search", true, 1200);
//!
//! // Telemetry auto-flushed on drop
//! ```

pub mod a2a;
pub mod actions;
pub mod agentcards;
pub mod agents;
pub mod approvals;
pub mod client;
pub mod delegations;
pub mod error;
pub mod federation;
pub mod guard;
pub mod mcp;
pub mod models;
pub mod sessions;
pub mod streaming;
pub mod telemetry;
pub mod tokens;
pub mod wimse;

#[cfg(test)]
mod tests;

// Public re-exports for convenient top-level access.
pub use a2a::A2A;
pub use agentcards::AgentCards;
pub use approvals::ApprovalsAPI;
pub use client::{AgentTrustClient, AgentTrustClientBuilder};
pub use delegations::Delegations;
pub use error::{AgentTrustError, Result};
pub use federation::Federation;
pub use guard::{AgentTrustGuard, AgentTrustGuardBuilder};

// ---------------------------------------------------------------------------
// ---------------------------------------------------------------------------






pub use mcp::Mcp;
pub use models::{
    A2ATask, ActionCheckRequest, ActionCheckResult, Agent, AgentCard, AgentCardSignature,
    AgentCardSkill, AgentExtension, AgentInterface, ApprovalRequestStatus, Capabilities,
    CreateAgentRequest, CreateDelegationRequest, CreateSIEMDestinationRequest, Delegation,
    FederationProvider, HealthResponse, InitSessionRequest, IntrospectTokenRequest,
    IntrospectionResult, IssueFederatedIDTokenRequest, IssueFederatedIDTokenResult,
    IssueTokenRequest, IssueWIMSETokenRequest, MCPServer, Provider,
    RegisterFederationProviderRequest, RegisterMCPServerRequest, SIEMDeliveryRecord,
    SIEMDestination, SecurityScheme, SendTaskRequest, Session, TelemetryEvent,
    TelemetryReportRequest, Token, UpdateSIEMDestinationRequest, V1Task, V1TaskStatus,
    VerifyFederatedTokenRequest, VerifyFederatedTokenResult, VerifyWIMSETokenRequest,
    VerifyWIMSETokenResponse, WIMSETokenResponse, ATI_TRUST_EXTENSION_URI,
};
pub use sessions::SessionsAPI;
pub use streaming::{StreamFilter, Streaming};
pub use wimse::Wimse;