Struct SourceRef 

pub struct SourceRef {
    pub uri: String,
    pub mime_type: Option<String>,
    pub size_bytes: Option<u64>,
    pub checksum: Option<String>,
}

Reference to source content (URL, file path, S3 URI, etc.)

Used when an entity was extracted from multimedia content (images, audio, video, PDFs, web pages). The entity stores the extracted text/summary, while SourceRef points to the original content.

Example

use umi_memory::storage::SourceRef;

// Image that was analyzed
let image_ref = SourceRef::new("file:///photos/meeting.jpg".to_string())
    .with_mime_type("image/jpeg".to_string())
    .with_size_bytes(1024 * 500);

// PDF that was extracted
let pdf_ref = SourceRef::new("s3://docs/report.pdf".to_string())
    .with_mime_type("application/pdf".to_string())
    .with_checksum("sha256:abc123...".to_string());

Fields

uri: String

URI to the source (file://, https://, s3://, etc.)

mime_type: Option<String>

MIME type of the source (image/png, audio/mp3, application/pdf, etc.)

size_bytes: Option<u64>

Size in bytes (if known)

checksum: Option<String>

Checksum for integrity verification (e.g., “sha256:abc123…”)

Implementations

impl SourceRef

pub fn new(uri: String) -> Self

Create a new source reference with just the URI.

pub fn with_mime_type(self, mime_type: String) -> Self

Set the MIME type.

pub fn with_size_bytes(self, size_bytes: u64) -> Self

Set the size in bytes.

pub fn with_checksum(self, checksum: String) -> Self

Set the checksum.

pub fn is_local(&self) -> bool

Check if this is a local file reference.

pub fn is_remote(&self) -> bool

Check if this is a remote URL.

pub fn is_s3(&self) -> bool

Check if this is an S3 reference.

pub fn extension(&self) -> Option<&str>

Get the file extension from the URI (if any).

Trait Implementations

impl Clone for SourceRef

fn clone(&self) -> SourceRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SourceRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SourceRef

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

Formats the value using the given formatter.

impl PartialEq for SourceRef

fn eq(&self, other: &SourceRef) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SourceRef

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for SourceRef

impl StructuralPartialEq for SourceRef