Crate ringkernel_core 

RingKernel Core

Core traits and types for the RingKernel GPU-native persistent actor system.

This crate provides the foundational abstractions for building GPU-accelerated actor systems with persistent kernels, lock-free message passing, and hybrid logical clocks for temporal ordering.

Core Abstractions

• RingMessage - Trait for messages between kernels
• MessageQueue - Lock-free ring buffer for message passing
• RingKernelRuntime - Backend-agnostic runtime management
• RingContext - GPU intrinsics facade for kernel handlers
• HlcTimestamp - Hybrid Logical Clock for causal ordering

Example

use ringkernel_core::prelude::*;

#[derive(RingMessage)]
struct MyMessage {
    #[message(id)]
    id: MessageId,
    payload: Vec<f32>,
}

Re-exports

pub use context::RingContext;

pub use control::ControlBlock;

pub use error::Result;

pub use error::RingKernelError;

pub use hlc::HlcTimestamp;

pub use memory::DeviceMemory;

pub use memory::GpuBuffer;

pub use memory::MemoryPool;

pub use memory::PinnedMemory;

pub use message::priority;

pub use message::MessageHeader;

pub use message::MessageId;

pub use message::Priority;

pub use message::RingMessage;

pub use queue::MessageQueue;

pub use queue::QueueStats;

pub use runtime::Backend;

pub use runtime::KernelHandle;

pub use runtime::KernelId;

pub use runtime::KernelState;

pub use runtime::KernelStatus;

pub use runtime::LaunchOptions;

pub use runtime::RingKernelRuntime;

pub use telemetry::TelemetryBuffer;

pub use types::BlockId;

pub use types::GlobalThreadId;

pub use types::ThreadId;

pub use types::WarpId;

Modules

context

Ring context providing GPU intrinsics facade for kernel handlers.

control

Control block for kernel state management.

error

Error types for RingKernel operations.

hlc

Hybrid Logical Clock (HLC) implementation for causal ordering.

k2k

Kernel-to-Kernel (K2K) direct messaging.

memory

GPU and host memory management abstractions.

message

Message types and traits for kernel-to-kernel communication.

multi_gpu

Multi-GPU coordination and load balancing.

prelude

Prelude module for convenient imports

pubsub

Topic-based publish/subscribe messaging.

queue

Lock-free message queue implementation.

runtime

Runtime traits and types for kernel management.

telemetry

Telemetry and metrics collection for kernel monitoring.

telemetry_pipeline

Real-time telemetry pipeline for streaming metrics.

types

Core type definitions for GPU thread identification and coordination.