Crate vifu_runtime 

Small, stateful runtime primitives for embedding Vifu in 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::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.

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.

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.

RuntimeError

Errors returned by the embedded application runtime.

Constants

RUNTIME_MANIFEST_SCHEMA_VERSION

Traits

AgentProvider

Runtime-selected provider implementation.

RuntimeStore

Persistence adapter supplied by an embedding host.

Type Aliases

ProviderFuture

A boxed provider future used by AgentProvider.