Skip to main content

Crate vyre_runtime

Crate vyre_runtime 

Source
Expand description

Artifact execution, resident work queues, resource residency, and zero-copy IO.

Runtime construction starts from an authenticated ArtifactSession. Immutable compiler artifacts are materialized through registered target devices; runtime policy owns bindings, retained state, queueing, recovery, resource residency, IO, and telemetry.

Re-exports§

pub use replay::RecordedSlot;
pub use replay::ReplayFailureClass;
pub use replay::ReplayFailureEvidence;
pub use replay::ReplayLogError;
pub use replay::ReplayRecord;
pub use replay::RingLog;
pub use tenant::TenantError;
pub use tenant::TenantHandle;
pub use tenant::TenantRegistry;
pub use tenant::OPCODE_RANGE_PER_TENANT;
pub use tenant::TENANT_ID_MAX;
pub use tenant::TENANT_OPCODE_BASE;
pub use pipeline_cache::RemoteCache;
pub use pipeline_cache::DiskCache;
pub use pipeline_cache::DiskCacheError;
pub use pipeline_cache::InMemoryPipelineCache;
pub use pipeline_cache::LayeredPipelineCache;
pub use pipeline_cache::PipelineCacheMetricError;
pub use pipeline_cache::PipelineCacheMetrics;
pub use pipeline_cache::PipelineCacheStore;
pub use pipeline_cache::PipelineFingerprint;
pub use artifact_admission::admit_artifact;
pub use artifact_admission::admit_cached_artifact;
pub use artifact_admission::admit_envelope;
pub use artifact_admission::AdmittedArtifact;
pub use artifact_admission::ArtifactAdmissionError;
pub use artifact_admission::ArtifactSession;
pub use artifact_admission::ArtifactSessionError;
pub use artifact_admission::RetainedArtifactSession;
pub use persistent_executor::PersistentExecutor;
pub use persistent_executor::ResidentQueueCompletion;
pub use persistent_executor::ResidentQueueState;
pub use recovery::classify_backend_error;
pub use recovery::recover_artifact_session;
pub use uring::GpuMappedBuffer;

Modules§

artifact_admission
Canonical artifact-envelope authentication and exact-format admission.
persistent_executor
Authenticated persistent execution over retained artifact bindings. Persistent resident-work-queue execution over authenticated artifact sessions.
pipeline_cache
Content-addressed authenticated artifact cache. Content-addressed neutral-artifact cache.
recovery
Structured artifact-session recovery without message parsing or recompilation. Structured artifact-session recovery policy.
replay
Differential megakernel replay log - captures every published ring slot so a later cert run can diff epoch-by-epoch execution against a live backend. Differential megakernel replay log.
resident_work_queue
Resident work-queue protocols, scheduling policy, and runtime IO. Resident work-queue protocol, host mirrors, scheduling policy, and IO.
resource_residency
Backend-neutral immutable-resource and mutable-state residency. Backend-neutral immutable-resource, artifact, and mutable-state residency ownership.
routing
Backend routing policy for execution plans. High-level execution routing engine.
scheduler
Multi-GPU work partitioning across runtime backends. Multi-GPU work stealing scheduler (Innovation I.7).
tenant
Multi-tenant megakernel multiplexing - one persistent kernel per GPU, shared across producer tools via the tenant_id field already in the ring protocol. Multi-tenant megakernel multiplexing.
uring
Linux io_uring integration. Compiled out on macOS / Windows. Linux io_uring scaffolding for NVMe → GPU-visible memory streaming. All items here are gated on cfg(target_os = "linux") and compiled out on every other platform.

Structs§

UringCompletionPump
Completion pump for an optional Linux io_uring stream.

Enums§

PipelineError
Errors surfaced by the runtime layer. Every variant carries a Fix:-bearing message so a reviewer can act on the failure.
RetryClass
Whether and where a failed workflow may be retried.
UringPollState
Result of one non-blocking completion-pump probe.