Struct MemoryLookupHit 

pub struct MemoryLookupHit {
    pub score: f32,
    pub summary: String,
    pub key: Option<String>,
    pub source_uri: Option<String>,
    pub principal: Option<String>,
    pub scope: Option<String>,
    pub recorded_at_millis: Option<i64>,
    pub metadata: Value,
}

One hit returned by a MemoryLookupStore.

Fields

score: f32

Retrieval score in [0, 1]; higher is more similar.

summary: String

Short text summary suitable for evidence display.

key: Option<String>

Optional stable store key, frame id, or episode id.

source_uri: Option<String>

Optional URI or locator for the backing memory source.

principal: Option<String>

Optional principal, actor, tenant, or subject associated with the hit.

scope: Option<String>

Optional caller-defined lookup scope such as tenant, workspace, or profile.

recorded_at_millis: Option<i64>

Optional milliseconds since the Unix epoch when the source was recorded.

metadata: Value

Optional store-specific metadata.

Implementations

impl MemoryLookupHit

pub fn new(score: f32, summary: impl Into<String>) -> Self

Create a hit with no key or metadata.

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

Attach a stable storage key.

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

Attach a source URI or locator.

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

Attach the principal, actor, tenant, or subject associated with the hit.

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

Attach the caller-defined lookup scope.

pub fn with_recorded_at_millis(self, recorded_at_millis: i64) -> Self

Attach the source record timestamp in milliseconds since the Unix epoch.

pub fn with_metadata(self, metadata: Value) -> Self

Attach store-specific metadata.

Trait Implementations

impl Clone for MemoryLookupHit

fn clone(&self) -> MemoryLookupHit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryLookupHit

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MemoryLookupHit

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl IntoContextItem for MemoryLookupHit

fn to_context_item(&self) -> ContextItem

Project this resource record into a prompt-ready context item.

impl Serialize for MemoryLookupHit

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

where __S: Serializer,

Serialize this value into the given Serde serializer.