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
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

use super::{default_public_paths, load_token};
use std::{collections::HashSet, sync::Arc};

/// Shared authentication state for the HTTP server.
///
/// # Examples
///
/// ```rust
/// use codetether_agent::server::auth::AuthState;
///
/// let state = AuthState::with_token("example-token");
///
/// assert_eq!(state.token(), "example-token");
/// assert!(state.is_public_path("/health"));
/// ```
#[derive(Debug, Clone)]
pub struct AuthState {
    token: Arc<String>,
    public_paths: Arc<HashSet<String>>,
}

impl AuthState {
    /// Build auth state from environment variables.
    ///
    /// # Examples
    ///
    /// ```rust
    /// use codetether_agent::server::auth::AuthState;
    ///
    /// # unsafe {
    /// std::env::set_var("CODETETHER_AUTH_TOKEN", "example-token");
    /// # }
    /// let state = AuthState::from_env();
    ///
    /// assert_eq!(state.token(), "example-token");
    /// ```
    pub fn from_env() -> Self {
        let token = load_token();
        Self {
            token: Arc::new(token),
            public_paths: Arc::new(default_public_paths()),
        }
    }

    /// Build auth state with an explicit token.
    ///
    /// # Examples
    ///
    /// ```rust
    /// use codetether_agent::server::auth::AuthState;
    ///
    /// let state = AuthState::with_token("example-token");
    /// assert_eq!(state.token(), "example-token");
    /// ```
    pub fn with_token(token: impl Into<String>) -> Self {
        Self {
            token: Arc::new(token.into()),
            public_paths: Arc::new(default_public_paths()),
        }
    }

    /// Return the active bearer token.
    ///
    /// # Examples
    ///
    /// ```rust
    /// use codetether_agent::server::auth::AuthState;
    ///
    /// # unsafe {
    /// std::env::set_var("CODETETHER_AUTH_TOKEN", "example-token");
    /// # }
    /// let state = AuthState::from_env();
    ///
    /// assert_eq!(state.token(), "example-token");
    /// ```
    pub fn token(&self) -> &str {
        &self.token
    }

    /// Return whether a request path is exempt from authentication.
    ///
    /// # Examples
    ///
    /// ```rust
    /// use codetether_agent::server::auth::AuthState;
    ///
    /// let state = AuthState::with_token("example-token");
    ///
    /// assert!(state.is_public_path("/health"));
    /// assert!(!state.is_public_path("/secure"));
    /// ```
    pub fn is_public_path(&self, path: &str) -> bool {
        self.public_paths.contains(path)
    }
}