Crate vifu_runtime 

Embeddable, stateful Agent Runtime primitives for Rust applications.

Add application behavior as Bevy plugins, dispatch RuntimeCommand values, and let the host execute the resulting effects.

Re-exports

pub use bridge::RuntimeBridge;

pub use bridge::RuntimeBridgeCancelParams;

pub use bridge::RuntimeBridgeError;

pub use bridge::RuntimeBridgeHelloParams;

pub use bridge::RuntimeBridgeHelloPayload;

pub use bridge::RuntimeBridgeInvocationEvent;

pub use bridge::RuntimeBridgeInvokePayload;

pub use bridge::RUNTIME_BRIDGE_CANCELLED_EVENT;

pub use bridge::RUNTIME_BRIDGE_CANCEL_METHOD;

pub use bridge::RUNTIME_BRIDGE_COMPLETED_EVENT;

pub use bridge::RUNTIME_BRIDGE_FAILED_EVENT;

pub use bridge::RUNTIME_BRIDGE_HELLO_METHOD;

pub use bridge::RUNTIME_BRIDGE_INVOKE_METHOD;

pub use bridge::RUNTIME_BRIDGE_OUTPUT_DELTA_EVENT;

pub use bridge::RUNTIME_BRIDGE_STARTED_EVENT;

pub use bridge::VIFU_RUNTIME_BRIDGE_PROTOCOL_VERSION;

pub use protocol::decode_protocol_frame;

pub use protocol::encode_protocol_frame;

pub use protocol::ErrorShape;

pub use protocol::EventFrame;

pub use protocol::EventFrameType;

pub use protocol::ProtocolFrame;

pub use protocol::RequestFrame;

pub use protocol::RequestFrameType;

pub use protocol::ResponseFrame;

pub use protocol::ResponseFrameType;

pub use protocol::StateVersion;

pub use protocol::MAX_PROTOCOL_FRAME_BYTES;

pub use providers::LocalWhisperProvider;

pub use providers::HttpCapabilityProvider;

pub use providers::HttpCapabilityRoute;

Modules

bridge

Engine-neutral bridge between a host application and VifuRuntime.

prelude

Common imports for application runtime plugins.

protocol

Transport-neutral frames shared by embedded hosts and Vifu Gateway.

providers

Structs

AgentDefinition

An agent registered inside one application runtime.

CancellationToken

Cooperative cancellation signal passed to providers.

EffectExecution

Result of running host effects through the runtime.

EffectRequest

EffectRequestQueue

EffectResult

EffectResultQueue

EndpointDefinition

A stable, named application endpoint backed by one registered agent.

HeadlessRuntime

InvocationEvent

One ordered event produced by an invocation.

InvocationHandle

Opaque handle returned by the game-loop invocation API.

InvocationInput

Input for one application-facing endpoint invocation.

InvocationOutput

Result of one endpoint invocation.

InvocationPoll

Non-blocking game-loop poll result.

InvocationTraceEvent

One safe trace event emitted by the application runtime.

LocalProviderBinding

Local-only provider configuration kept outside portable releases.

MemoryRuntimeStore

In-memory persistence used by the standalone embedded runtime.

ProviderEventSink

Sink supplied to providers that can produce incremental output.

ProviderRequest

Request delivered to a dynamically registered AgentProvider.

ProviderRequirement

A logical provider required by a runtime release.

ProviderResponse

Provider result and an optional replacement for the session’s durable state.

RuntimeAdvance

RuntimeCommand

RuntimeCommandQueue

RuntimeEvent

RuntimeEventQueue

RuntimeManifest

Portable runtime configuration shared by embedded and connected runtimes.

RuntimeMonitorIoSummary

Bounded process-local I/O summary for an opt-in diagnostic observer.

RuntimeRelease

One immutable, content-addressed project runtime release.

RuntimeSchedule

RuntimeSession

A session-scoped view over VifuRuntime.

RuntimeSnapshot

RuntimeState

RuntimeTraceRecord

Redacted invocation metadata waiting to be uploaded to an optional server.

SqliteRuntimeStore

SQLite-backed application state for an embedded Vifu runtime.

VifuRuntime

A self-contained runtime for one application or project.

VifuRuntimePlugin

Enums

InvocationData

JSON or binary data passed through an embedded runtime invocation.

InvocationEventKind

Kind of event emitted while a non-blocking invocation is running.

InvocationStatus

Current state of an invocation started with VifuRuntime::start_invoke.

ProviderEvent

A typed provider event emitted while an invocation is running.

ProviderStage

A provider stage that can be rendered as an observation in a live trace.

RuntimeError

Errors returned by the embedded application runtime.

RuntimeMonitorEvent

Payload-safe lifecycle metadata for one embedded runtime invocation.

RuntimeMonitorIoEvent

Invocation I/O exposed only to an explicitly installed diagnostic observer.

RuntimeMonitorStageStatus

State of a provider stage reported to an embedded runtime monitor.

RuntimeMonitorStatus

Terminal outcome reported to an embedded runtime monitor.

Constants

RUNTIME_MANIFEST_SCHEMA_VERSION

Traits

AgentProvider

Runtime-selected provider implementation.

RuntimeStore

Persistence adapter supplied by an embedding host.

Type Aliases

ProjectSettings

Portable provider, agent, and endpoint settings for one Vifu project.

ProviderFuture

A boxed provider future used by AgentProvider.

RuntimeMonitorIoObserver

Thread-safe callback for bounded invocation I/O diagnostics.

RuntimeMonitorObserver

Thread-safe callback installed by an embedding host that wants live, payload-safe runtime lifecycle metadata.