systemprompt-identifiers 0.6.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
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

//! Typed newtype identifiers for systemprompt.io.
//!
//! Every entity in the platform is referenced through a wrapper newtype
//! rather than a raw `String`.
//!
//! This crate provides both the macros that generate those wrappers
//! ([`define_id!`], [`define_token!`]) and the canonical concrete types
//! (`UserId`, `AgentId`, `TaskId`, `TraceId`, `ContextId`, `SessionId`,
//! `McpServerId`, ...).
//!
//! Boundary types for talking to the database — [`DbValue`], [`ToDbValue`],
//! [`FromDbValue`], [`JsonRow`] — also live here so that identifier modules
//! can interoperate without depending on the database crate.
//!
//! # Construction
//!
//! ```ignore
//! use systemprompt_identifiers::{TaskId, UserId};
//!
//! // Known string value (literal, parsed input, DB row).
//! let user = UserId::new("user_abc");
//!
//! // Mint a fresh UUID-backed identifier.
//! let task = TaskId::generate();
//! ```
//!
//! Validated identifiers (`McpServerId`, `Email`, `ProfileName`,
//! `ValidatedUrl`, `ValidatedFilePath`, `AgentName`) additionally expose a
//! fallible `try_new` constructor returning [`error::IdValidationError`].
//!
//! # Feature flags
//!
//! | Feature | Effect |
//! |---------|--------|
//! | (default) | Pure-Rust types only. |
//! | `sqlx` | Derives `sqlx::Type` on every identifier, allowing direct binding in `query_as!` macros. |

pub mod db_value;

pub use db_value::{DbValue, FromDbValue, JsonRow, ToDbValue, parse_database_datetime};

mod agent;
mod ai;
mod auth;
mod client;
mod cloud;
mod connection;
mod content;
mod context;
mod email;
mod execution;
mod funnel;
mod hook;
mod jobs;
mod links;
mod mcp;
mod oauth;
mod path;
mod plugin;
mod policy;
mod profile;
mod roles;
mod section;
mod session;
mod task;
mod tenant;
mod trace;
mod url;
mod user;
mod webhook;

pub mod error;
pub mod headers;
pub mod macros;

pub use agent::{AgentId, AgentName};
pub use ai::{
    AiGatewayPolicyId, AiQuotaBucketId, AiRequestId, AiSafetyFindingId, ConfigId, MessageId,
};
pub use auth::{ApiKeyId, ApiKeySecret, CloudAuthToken, DeviceCertId, JwtToken, SessionToken};
pub use client::{ClientId, ClientType};
pub use cloud::{CheckoutSessionId, PriceId, TransactionId};
pub use connection::ConnectionId;
pub use content::{CategoryId, ContentId, FileId, SkillId, SourceId, TagId};
pub use context::ContextId;
pub use email::Email;
pub use execution::{ArtifactId, ExecutionStepId, LogId, TokenId};
pub use funnel::{EngagementEventId, FunnelId, FunnelProgressId};
pub use hook::HookId;
pub use jobs::{JobName, ScheduledJobId};
pub use links::{CampaignId, LinkClickId, LinkId};
pub use mcp::{AiToolCallId, McpExecutionId, McpServerId};
pub use oauth::{AccessTokenId, AuthorizationCode, ChallengeId, RefreshTokenId};
pub use path::ValidatedFilePath;
pub use plugin::PluginId;
pub use policy::PolicyVersion;
pub use profile::ProfileName;
pub use roles::RoleId;
pub use section::SectionId;
pub use session::{SessionId, SessionSource};
pub use task::TaskId;
pub use tenant::TenantId;
pub use trace::TraceId;
pub use url::ValidatedUrl;
pub use user::UserId;
pub use webhook::WebhookEndpointId;