Struct VifuRuntime 

pub struct VifuRuntime { /* private fields */ }

A self-contained runtime for one application or project.

One runtime may register multiple providers, agents, and stable named endpoints. It can run directly inside a Rust host; Vifu Server and Agent Gateway are optional deployment components.

Implementations

impl VifuRuntime

pub fn new(project_id: impl Into<String>) -> Result<Self, RuntimeError>

pub fn with_store( project_id: impl Into<String>, store: Arc<dyn RuntimeStore>, ) -> Result<Self, RuntimeError>

pub fn project_id(&self) -> &str

pub fn register_provider( &self, name: impl Into<String>, provider: Arc<dyn AgentProvider>, ) -> Result<(), RuntimeError>

pub fn register_agent(&self, agent: AgentDefinition) -> Result<(), RuntimeError>

pub fn register_endpoint( &self, endpoint: EndpointDefinition, ) -> Result<(), RuntimeError>

pub fn session( &self, session_id: impl Into<String>, ) -> Result<RuntimeSession, RuntimeError>

pub async fn invoke( &self, input: InvocationInput, ) -> Result<InvocationOutput, RuntimeError>

pub fn start_invoke( &self, input: InvocationInput, ) -> Result<InvocationHandle, RuntimeError>

pub fn poll_invocation( &self, handle: &InvocationHandle, ) -> Result<InvocationPoll, RuntimeError>

pub fn take_invocation( &self, handle: &InvocationHandle, ) -> Result<InvocationPoll, RuntimeError>

Returns the current poll state and removes it once it is terminal.

Pending and running invocations remain registered so callers can keep polling the same handle.

pub fn cancel_invocation( &self, handle: &InvocationHandle, ) -> Result<(), RuntimeError>

pub async fn execute_effects( &self, effects: Vec<EffectRequest>, ) -> Result<EffectExecution, RuntimeError>

pub async fn execute_effects_with_limit( &self, effects: Vec<EffectRequest>, limit: usize, ) -> Result<EffectExecution, RuntimeError>

pub fn export_snapshot(&self) -> Result<Vec<u8>, RuntimeError>

pub fn restore_snapshot(&self, bytes: &[u8]) -> Result<(), RuntimeError>

Trait Implementations

impl Clone for VifuRuntime

fn clone(&self) -> VifuRuntime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VifuRuntime

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

Formats the value using the given formatter.