Struct FileAttachment 

pub struct FileAttachment {
    pub file_id: String,
    pub filename: String,
    pub size: u64,
    pub mime_type: Option<String>,
    pub channel: String,
    pub message_id: Option<String>,
    pub uploaded_by: Option<String>,
    pub stored_at: DateTime<Utc>,
    pub ref_count: usize,
}

Unified file attachment representation

This struct wraps a FileHandle from agent-diva-files and adds channel-specific metadata for tracking which channel and message the file was associated with.

Fields

file_id: String

Content-addressed file ID (SHA256 hash)

filename: String

Original filename as uploaded

size: u64

File size in bytes

mime_type: Option<String>

MIME type if known

channel: String

Source channel (e.g., “telegram”, “discord”, “slack”)

message_id: Option<String>

Associated message ID from the channel

uploaded_by: Option<String>

User who uploaded the file

stored_at: DateTime<Utc>

When the file was stored

ref_count: usize

Reference count (number of channel associations)

Implementations

impl FileAttachment

pub fn from_handle( handle: FileHandle, channel: &str, message_id: Option<&str>, ) -> Self

Create a FileAttachment from a FileHandle and channel info

Arguments

• handle - The FileHandle from agent-diva-files
• channel - The source channel identifier
• message_id - Optional message ID from the channel

Example

use agent_diva_core::attachment::FileAttachment;
use agent_diva_files::{FileManager, FileConfig};
use agent_diva_files::handle::FileMetadata;
use std::path::PathBuf;

let config = FileConfig::with_path(PathBuf::from("./data"));
let manager = FileManager::new(config).await?;
let metadata = FileMetadata {
    name: "document.pdf".to_string(),
    size: 1024,
    mime_type: Some("application/pdf".to_string()),
    source: Some("telegram".to_string()),
    created_at: chrono::Utc::now(),
    last_accessed_at: None,
    preview: None,
};
let handle = manager.store(b"dummy content", metadata).await?;
let attachment = FileAttachment::from_handle(handle, "telegram", Some("123456"));

pub fn from_metadata( file_id: &str, metadata: &FileMetadata, channel: &str, message_id: Option<&str>, ref_count: usize, ) -> Self

Create a FileAttachment from stored metadata

This is useful when reconstructing an attachment from the database without needing the full FileHandle.

pub fn display(&self) -> String

Get a display string for the attachment

Example

use agent_diva_core::attachment::FileAttachment;
use agent_diva_files::{FileManager, FileConfig};
use agent_diva_files::handle::FileMetadata;
use std::path::PathBuf;

let config = FileConfig::with_path(PathBuf::from("./data"));
let manager = FileManager::new(config).await?;
let metadata = FileMetadata {
    name: "document.pdf".to_string(),
    size: 1024 * 1024, // 1 MB
    mime_type: Some("application/pdf".to_string()),
    source: Some("telegram".to_string()),
    created_at: chrono::Utc::now(),
    last_accessed_at: None,
    preview: None,
};
let handle = manager.store(b"dummy content", metadata).await?;
let attachment = FileAttachment::from_handle(handle, "telegram", Some("msg_123"));
let display = attachment.display();
// "document.pdf (1.0 MB) from telegram"

pub fn is_image(&self) -> bool

Check if this attachment is an image

pub fn is_video(&self) -> bool

Check if this attachment is a video

pub fn is_audio(&self) -> bool

Check if this attachment is audio

pub fn is_document(&self) -> bool

Check if this attachment is a document

Trait Implementations

impl Clone for FileAttachment

fn clone(&self) -> FileAttachment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileAttachment

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileAttachment

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for FileAttachment

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

Formats the value using the given formatter.

impl Serialize for FileAttachment

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

where __S: Serializer,

Serialize this value into the given Serde serializer.