Struct AgentVersion 

pub struct AgentVersion {

    pub public_id: AgentVersionId,
    pub internal_id: Uuid,
    pub agent_id: AgentId,
    pub version_number: i32,
    pub semver_major: i32,
    pub semver_minor: i32,
    pub semver_patch: i32,
    pub version: String,
    pub is_published: bool,
    pub parent_version_id: Option<AgentVersionId>,
    pub source_version_id: Option<AgentVersionId>,
    pub created_by_principal_id: Option<PrincipalId>,
    pub change_kind: AgentVersionChangeKind,
    pub summary: Option<String>,
    pub config_hash: String,
    pub authored_config: Value,
    pub resolved_config: Value,
    pub created_at: DateTime<Utc>,
}

Immutable snapshot of an Agent’s authored and resolved runtime config.

Fields

public_id: AgentVersionId

Prefixed public identifier. See ID Schema.

internal_id: Uuid

Internal database UUID. Not part of the public identifier surface; skipped during serialization.

agent_id: AgentId

Owning agent’s prefixed public identifier.

version_number: i32

Monotonic per-agent version sequence number (1, 2, 3, …). Increments on every snapshot.

semver_major: i32

Semantic version major component.

semver_minor: i32

Semantic version minor component.

semver_patch: i32

Semantic version patch component.

version: String

Combined semver string for display (e.g. 1.4.2).

is_published: bool

Whether this version was explicitly published by a user. Published versions are user-controlled semver releases; unpublished rows are automatic draft snapshots kept for audit and rollback.

parent_version_id: Option<AgentVersionId>

Version this one was forked or branched from, if any.

source_version_id: Option<AgentVersionId>

When this version is a copy of another version (e.g. a manual rollback), the original source. None for ordinary snapshots.

created_by_principal_id: Option<PrincipalId>

Identity of the principal (user or agent identity) that created this version. None for system-generated snapshots.

change_kind: AgentVersionChangeKind

Classification of why this version was created (manual publish, automatic draft, rollback, fork, etc.).

summary: Option<String>

Human-readable summary of changes in this version (release notes). None if not provided.

config_hash: String

Stable hash of resolved_config used to deduplicate adjacent identical snapshots.

authored_config: Value

User-authored agent configuration JSON, exactly as submitted. Capabilities, MCP refs, model selection live here.

resolved_config: Value

Resolved configuration after applying harness, capability, and platform layers. This is what the runtime executes against.

created_at: DateTime<Utc>

Timestamp when this version was created (RFC 3339).

Trait Implementations

impl Clone for AgentVersion

fn clone(&self) -> AgentVersion

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentVersion

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentVersion

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentVersion

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.