Struct ResourceFileProvider 

pub struct ResourceFileProvider { /* private fields */ }

Provider for a single file discovered under providers/resources/, serving either static file bytes or a sandboxed TypeScript read() reader.

Implementations

impl ResourceFileProvider

pub fn from_file( absolute_path: PathBuf, relative_path: &Path, canonical_root: &Path, ) -> Result<Self, ResourceFileError>

Builds a provider for one file discovered under providers/resources/. relative_path is the file’s path relative to that directory (already verified not to escape the provider root — see filesystem::collect_resource_files). canonical_root is that directory’s canonicalized path, re-checked at read time. A .ts extension makes the file a dynamic reader; every other extension makes it a static resource read directly from disk.

pub fn arc( absolute_path: PathBuf, relative_path: &Path, canonical_root: &Path, ) -> Result<Arc<dyn Provider>, ResourceFileError>

Same as from_file but returns the provider boxed as a shared Arc<dyn Provider> for registration.

Trait Implementations

impl Clone for ResourceFileProvider

fn clone(&self) -> ResourceFileProvider

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResourceFileProvider

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

Formats the value using the given formatter.

impl Provider for ResourceFileProvider

fn catalog(&self) -> ProviderCatalog

The provider’s catalog — its tools, prompts, resources, and metadata.

fn call<'life0, 'async_trait>( &'life0 self, call: ProviderCall, ) -> Pin<Box<dyn Future<Output = Result<ProviderOutput, ProviderError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Executes one provider action call and returns its output.

fn dynamic_resource_templates(&self) -> Vec<DynamicResourceTemplate>

Dynamic resource templates this provider serves. Every provider inherits the empty default — only file-based dynamic resource readers (providers/resources/*.ts) override it.

fn supports_resource_reads(&self) -> bool

Whether this provider can actually serve read_resource calls. catalog().resources is a schema-legal field on every provider kind’s manifest (OpenAPI, MCP, ai-sdk, WASM, Python, generic JSON), but only file-based ResourceFileProviders have any mechanism to read content back — every other kind inherits read_resource’s default error. ResourceIndex::register uses this to reject a manifest that declares resources it can never serve at snapshot-build time, rather than letting them appear in resources/list and always fail resources/read with an opaque error.

fn read_resource<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, uri: &'life1 str, params: &'life2 BTreeMap<String, String>, ) -> Pin<Box<dyn Future<Output = Result<ResourceReadOutput, ProviderError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Reads resource content for a URI the registry has already matched against either this provider’s catalog().resources (exact, params empty) or one of its dynamic_resource_templates() (params holds captured path parameters).

fn retire<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Drains and releases provider-owned runtime resources after a registry generation swap.

fn suspend<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Parks runtime resources while preserving rollback capability.

fn runtime_status(&self) -> Option<Value>

Returns product-neutral operator status for a stateful runtime.

fn cancel_active(&self) -> bool

Cancels active work without waiting for provider dispatch to complete.

fn reset_quarantine<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clears runtime quarantine after explicit operator authorization.

fn deactivate(&self)

Stops new work while in-flight work drains on a retained generation.

fn activate(&self)

Re-enables a retained generation selected by operator rollback.

fn acquire_dispatch(&self) -> bool

Reserves an invocation while this provider is still active.

fn release_dispatch(&self)

Releases a reservation acquired by Provider::acquire_dispatch.