Struct Collective 

pub struct Collective {
    pub id: CollectiveId,
    pub name: String,
    pub owner_id: Option<String>,
    pub embedding_dimension: u16,
    pub created_at: Timestamp,
    pub updated_at: Timestamp,
}

A collective — an isolated namespace for agent experiences.

Collectives provide multi-tenancy: each project or team gets its own collective with its own experiences and vector index.

Fields

• id — Unique identifier (UUID v7, time-ordered)
• name — Human-readable name (e.g., “my-project”)
• owner_id — Optional owner for multi-tenant filtering
• embedding_dimension — Vector dimension locked at creation (e.g., 384, 768)
• created_at / updated_at — Lifecycle timestamps

Serialization

Collectives are serialized with bincode for compact storage in redb. The Serialize/Deserialize derives enable this automatically.

Fields

id: CollectiveId

Unique identifier (UUID v7).

name: String

Human-readable name.

owner_id: Option<String>

Optional owner identifier for multi-tenancy.

When set, enables filtering collectives by owner via list_collectives_by_owner().

embedding_dimension: u16

Embedding vector dimension for this collective.

All experiences in this collective must have embeddings with exactly this many dimensions. Locked at creation time.

created_at: Timestamp

When this collective was created.

updated_at: Timestamp

When this collective was last modified.

Implementations

impl Collective

pub fn new(name: impl Into<String>, embedding_dimension: u16) -> Self

Creates a new collective with the given name and embedding dimension.

Sets created_at and updated_at to the current time. The owner_id defaults to None.

pub fn with_owner( name: impl Into<String>, owner_id: impl Into<String>, embedding_dimension: u16, ) -> Self

Creates a new collective with an owner.

Trait Implementations

impl Clone for Collective

fn clone(&self) -> Collective

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Collective

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Collective

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Collective

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

where __S: Serializer,

Serialize this value into the given Serde serializer.