systemprompt-identifiers 0.64.0

Typed newtype identifiers (UserId, TraceId, AgentId, McpServerId…) for systemprompt.io AI governance infrastructure. Enforces type-safe IDs across every boundary in the MCP governance pipeline.
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

//! Agent identity newtypes: opaque [`AgentId`] (UUID-backed), checked
//! [`AgentName`] (non-empty, rejects the `"unknown"`/`"unset"` sentinels), and
//! [`ExternalAgentId`] for off-platform "super-agents" (Claude Desktop,
//! Codex CLI, Claude Code) that connect via the bridge binary.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

crate::define_id!(AgentId, generate, schema);
crate::define_id!(ExternalAgentId, non_empty);

use crate::error::IdValidationError;

crate::define_id!(AgentName, checked, validate_agent_name);

fn validate_agent_name(name: &str) -> Result<(), IdValidationError> {
    if name.trim().is_empty() {
        return Err(IdValidationError::empty("AgentName"));
    }
    if name.eq_ignore_ascii_case("unknown") || name.eq_ignore_ascii_case("unset") {
        return Err(IdValidationError::invalid(
            "AgentName",
            format!("'{name}' is a reserved sentinel, not an agent name"),
        ));
    }
    Ok(())
}

impl AgentName {
    pub fn system() -> Self {
        Self("system".to_owned())
    }

    pub fn bridge() -> Self {
        Self("bridge".to_owned())
    }
}