Struct Store 

pub struct Store { /* private fields */ }

Namespace-aware object storage facade used by engine contexts.

In Anda Engine, the namespace is derived from an agent or tool context path, which isolates data for each registered component.

Any ObjectStore implementation can be used, including in-memory, filesystem, cloud, and IC-COSE-backed stores.

You can find various implementations of ObjectStore at: https://github.com/apache/arrow-rs/tree/main/object_store

Alternatively, you can use IC-COSE’s ObjectStore implementation, which stores data on the ICP blockchain.

Implementations

impl Store

pub fn new(store: Arc<dyn ObjectStore>) -> Self

Creates a storage facade from an object-store backend.

pub async fn store_get( &self, namespace: &Path, path: &Path, ) -> Result<(Bytes, ObjectMeta), BoxError>

Retrieves object bytes and metadata from a namespace-relative path.

pub async fn store_list( &self, namespace: &Path, prefix: Option<&Path>, offset: &Path, ) -> Result<Vec<ObjectMeta>, BoxError>

Lists objects with optional namespace-relative prefix and offset filters.

Arguments

• prefix - Optional path prefix to filter results
• offset - Optional path to start listing from (exclude)

pub async fn store_put( &self, namespace: &Path, path: &Path, mode: PutMode, val: Bytes, ) -> Result<PutResult, BoxError>

Stores bytes at a namespace-relative path with the given write mode.

Arguments

• path - Target storage path
• mode - Write mode (Create, Overwrite, etc.)
• val - Data to store as bytes

pub async fn store_rename_if_not_exists( &self, namespace: &Path, from: &Path, to: &Path, ) -> Result<(), BoxError>

Renames an object if the target path does not exist.

Arguments

• from - Source path
• to - Destination path

pub async fn store_delete( &self, namespace: &Path, path: &Path, ) -> Result<(), BoxError>

Deletes an object at a namespace-relative path.

Arguments

• path - Path of the object to delete

Trait Implementations

impl Clone for Store

fn clone(&self) -> Store

Returns a duplicate of the value.

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

Performs copy-assignment from source.