Struct KnowledgeObjectBuilder 

pub struct KnowledgeObjectBuilder { /* private fields */ }

Ergonomic builder for constructing Knowledge Objects.

The builder computes the content-addressed OID automatically on .build().

Example

let ko = KnowledgeObjectBuilder::new(ObjectKind::Entity)
    .attribute("name", SochValue::Text("Alice".into()))
    .embedding("semantic", vec![0.1, 0.2, 0.3])
    .tag("person")
    .valid_from(1700000000_000000)
    .build();

Implementations

impl KnowledgeObjectBuilder

pub fn new(kind: ObjectKind) -> Self

Create a new builder with the given object kind.

pub fn payload(self, payload: SochValue) -> Self

Set the full payload.

pub fn attribute(self, key: impl Into<String>, value: SochValue) -> Self

Add a named attribute to the payload (creates/extends an Object payload).

pub fn edge(self, edge: Edge) -> Self

Add an outgoing edge.

pub fn edges(self, edges: impl IntoIterator<Item = Edge>) -> Self

Add multiple edges at once.

pub fn embedding(self, space: impl Into<String>, vector: Vec<f32>) -> Self

Add an embedding in a named space.

pub fn embedding_with_metadata( self, space: impl Into<String>, vector: Vec<f32>, model: impl Into<String>, generated_at: u64, ) -> Self

Add an embedding with full metadata.

pub fn valid_from(self, valid_from: u64) -> Self

Set the valid_from time (HLC-encoded microseconds).

pub fn valid_to(self, valid_to: u64) -> Self

Set the valid_to time (HLC-encoded microseconds).

pub fn system_time(self, system_time: u64) -> Self

Set the system_time (typically assigned automatically by HLC on write).

pub fn temporal(self, temporal: BitemporalCoord) -> Self

Set the full bitemporal coordinate.

pub fn provenance(self, provenance: Provenance) -> Self

Set the provenance record.

pub fn namespace(self, namespace: impl Into<String>) -> Self

Set the namespace.

pub fn tag(self, tag: impl Into<String>) -> Self

Add a tag.

pub fn tags(self, tags: impl IntoIterator<Item = impl Into<String>>) -> Self

Add multiple tags.

pub fn build(self) -> KnowledgeObject

Build the Knowledge Object, computing the content-addressed OID.

pub fn build_with_oid(self, oid: ObjectId) -> KnowledgeObject

Build with a pre-computed OID (for deserialization or migration).

Trait Implementations

impl From<SochValue> for KnowledgeObjectBuilder

fn from(value: SochValue) -> Self

Convert a SochValue into a KnowledgeObject builder. The SochValue becomes the payload; kind defaults to Document.