Struct Experience 

pub struct Experience {

    pub id: ExperienceId,
    pub collective_id: CollectiveId,
    pub content: String,
    pub embedding: Vec<f32>,
    pub experience_type: ExperienceType,
    pub importance: f32,
    pub confidence: f32,
    pub applications: BTreeMap<InstanceId, u32>,
    pub domain: Vec<String>,
    pub related_files: Vec<String>,
    pub source_agent: AgentId,
    pub source_task: Option<TaskId>,
    pub timestamp: Timestamp,
    pub last_reinforced: Timestamp,
    pub archived: bool,
}

A stored experience — the core data type in PulseDB.

Experiences are agent-learned knowledge units stored in collectives. Each experience has content, a semantic embedding for vector search, a rich type, and metadata for filtering and ranking.

Serialization Note

The embedding field is marked #[serde(skip)] because embeddings are stored in a separate EMBEDDINGS_TABLE for performance. The storage layer reconstitutes the full struct by joining both tables on read.

Fields

id: ExperienceId

Unique identifier (UUID v7, time-ordered).

collective_id: CollectiveId

The collective this experience belongs to.

content: String

The experience content (text). Immutable after creation.

embedding: Vec<f32>

Semantic embedding vector. Immutable after creation.

Stored separately in EMBEDDINGS_TABLE; skipped during postcard serialization of the main experience record.

experience_type: ExperienceType

Rich experience type with associated data.

importance: f32

Importance score (0.0–1.0). Higher = more important.

confidence: f32

Confidence score (0.0–1.0). Higher = more confident.

applications: BTreeMap<InstanceId, u32>

Per-instance application/reinforcement counters.

The total application count is available via applications().

domain: Vec<String>

Domain tags for categorical filtering (e.g., [“rust”, “async”]).

related_files: Vec<String>

Related source file paths.

source_agent: AgentId

The agent that created this experience.

source_task: Option<TaskId>

Optional task context where this experience was created.

timestamp: Timestamp

When this experience was recorded.

last_reinforced: Timestamp

Last time this experience was explicitly reinforced.

archived: bool

Whether this experience is archived (soft-deleted).

Archived experiences are excluded from search results but remain in storage and can be restored via unarchive_experience().

Implementations

impl Experience

pub fn applications(&self) -> u32

Returns the total application count across all instance buckets.

Trait Implementations

impl Clone for Experience

fn clone(&self) -> Experience

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Experience

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Experience

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Experience

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

where __S: Serializer,

Serialize this value into the given Serde serializer.