Skip to main content

Crate eredu_core

Crate eredu_core 

Source
Expand description

Backend-neutral language-model contracts and orchestration.

This crate deliberately contains no tensor runtime. Backends own tensors, streams, executable models, caches, and completion primitives; core owns validation, lifecycle state, scheduling, and portable schemas.

Re-exports§

pub use artifact::gguf_u32_metadata_values;
pub use artifact::inspect_artifact;
pub use artifact::plan_model_preparation;
pub use artifact::resolve_gguf_companions;
pub use artifact::validate_preparation_policy;
pub use artifact::ArtifactFormat;
pub use artifact::ArtifactInspection;
pub use artifact::GgufCompanionEncoding;
pub use artifact::GgufCompanionRequirement;
pub use artifact::GgufCompanionRole;
pub use artifact::LoadingProtocol;
pub use artifact::MaterializationRoute;
pub use artifact::ModelArtifact;
pub use artifact::ModelConfiguration;
pub use artifact::ModelConfigurationResolver;
pub use artifact::ModelPreparationPlan;
pub use artifact::PreparationPolicy;
pub use artifact::QuantizationRequest;
pub use artifact::ResidencyRequest;
pub use artifact::ResolvedModelConfiguration;
pub use artifact::ValidatedGguf;
pub use artifact::ValidatedGgufCompanion;
pub use attention::AttentionPolicy;
pub use attention::LayerSchedule;
pub use attention::LayerScheduleError;
pub use automatic::realize_execution_plan_drafting;
pub use automatic::realize_execution_plan_target;
pub use automatic::AllocatorTelemetry;
pub use automatic::AutomaticPlanRequest;
pub use automatic::AutomaticPlanner;
pub use automatic::AutomaticPlannerPolicy;
pub use automatic::AutomaticPlanningBackend;
pub use automatic::AutomaticPlanningError;
pub use automatic::BoundedResidencyRequirement;
pub use automatic::CandidateAdmission;
pub use automatic::DurationSeconds;
pub use automatic::ExecutionPlanBackendFactory;
pub use automatic::ExecutionPlanReport;
pub use automatic::ExecutionPlanTarget;
pub use automatic::ExecutionTelemetry;
pub use automatic::ExpertCacheTelemetry;
pub use automatic::ExternalDraftArtifact;
pub use automatic::HardwareBackendProfile;
pub use automatic::HardwareDeviceProfile;
pub use automatic::HardwareMemorySemantics;
pub use automatic::HardwareProfile;
pub use automatic::ModelResourceProfile;
pub use automatic::ObservationKind;
pub use automatic::Observed;
pub use automatic::PlanExplanation;
pub use automatic::PlanExplanationEntry;
pub use automatic::PlanExplanationLevel;
pub use automatic::RealizedDrafting;
pub use automatic::ResidencyTelemetry;
pub use automatic::SpeculativeDecodingTelemetry;
pub use automatic::TimingTelemetry;
pub use automatic::TokenizerCompatibilityError;
pub use automatic::TokenizerCompatibilityProof;
pub use automatic::TransferTelemetry;
pub use automatic::AUTOMATIC_SCHEMA_VERSION;
pub use backend::load_model;
pub use backend::prepare_inspected_model;
pub use backend::BackendDescriptor;
pub use backend::BackendError;
pub use backend::BackendProvider;
pub use backend::BackendSession;
pub use backend::CollectiveGroupDescriptor;
pub use backend::CollectiveGroupId;
pub use backend::CollectiveScope;
pub use backend::Completion;
pub use backend::ControlledTextGeneration;
pub use backend::ControlledTextGenerationError;
pub use backend::ControlledToken;
pub use backend::DeviceCapabilities;
pub use backend::DeviceDescriptor;
pub use backend::DistributedBackend;
pub use backend::DistributedCapabilities;
pub use backend::DistributedSession;
pub use backend::DistributedSessionDescriptor;
pub use backend::InspectableBackendSession;
pub use backend::ModelCapabilityBackend;
pub use backend::ModelLoadError;
pub use backend::ModelLoadingBackend;
pub use backend::ModelRuntime;
pub use backend::MultimodalPreparationBackend;
pub use backend::MultimodalPreparationFailure;
pub use backend::PreparedModel;
pub use backend::SessionCapabilities;
pub use backend::SessionCapabilityError;
pub use backend::SpeculativeTokenFilterController;
pub use backend::Submission;
pub use backend::TextGeneration;
pub use backend::TextGenerationBackend;
pub use backend::TextGenerationConfig;
pub use backend::TextSamplingStrategy;
pub use backend::TokenFilter;
pub use backend::TokenFilterController;
pub use backend::TokenFilterError;
pub use backend::TokenOutput;
pub use backend::ValueDescriptor;
pub use capability::apply_admission_policy;
pub use capability::estimate_runtime_state;
pub use capability::Admission;
pub use capability::AdmissionRejection;
pub use capability::AdmissionRequest;
pub use capability::AdmissionResult;
pub use capability::AvailableMemory;
pub use capability::CacheStateStrategy;
pub use capability::CapabilityError;
pub use capability::EstimationCompleteness;
pub use capability::InputModalities;
pub use capability::InputTokenCount;
pub use capability::ModelCapabilities;
pub use capability::PhysicalMemorySemantics;
pub use capability::RuntimeStateEstimate;
pub use capability::SlidingWindowLayerCount;
pub use capability::StateMemoryAssumptions;
pub use capability::StateMemoryLayout;
pub use capability::StaticMemoryReport;
pub use execution::BackendId;
pub use execution::DevicePlan;
pub use execution::DraftPlacementPlan;
pub use execution::DraftingPlan;
pub use execution::ExecutionPlan;
pub use execution::ExecutionPlanError;
pub use execution::ExpertCachePlan;
pub use execution::ResidencyPlan;
pub use execution::WeightTransformationPlan;
pub use execution::DEFAULT_MAX_CACHED_SHARDS;
pub use execution::EXECUTION_PLAN_SCHEMA_VERSION;
pub use generation::resolve_generation_config;
pub use generation::resolve_optimistic_reuse;
pub use generation::CheckpointGenerationConfig;
pub use generation::FinishReason;
pub use generation::GenerationCancellationToken;
pub use generation::GenerationConfigOverrides;
pub use generation::GenerationError;
pub use generation::GenerationSequence;
pub use generation::OptimisticReuseDecision;
pub use generation::ResolvedGenerationConfig;
pub use generation::SemanticEvent;
pub use generation::SpeculativeCancellationDisposition;
pub use generation::SpeculativeCommitPlan;
pub use generation::SpeculativeConfig;
pub use generation::SpeculativeRequestId;
pub use generation::SpeculativeRequestLifecycle;
pub use generation::SpeculativeRequestStatus;
pub use generation::SpeculativeRound;
pub use generation::SpeculativeSchedulerOptions;
pub use generation::SpeculativeTail;
pub use generation::TokenCommit;
pub use generation::TokenTerminalSignals;
pub use input::InputExtent;
pub use input::InputMetadataKey;
pub use input::InputModality;
pub use input::InputPartDescriptor;
pub use input::InputPayloadKind;
pub use input::InputTensorIdentity;
pub use input::PreparedInputError;
pub use input::PreparedInputIdentity;
pub use inspection::ArtifactModality;
pub use inspection::ArtifactTensorEncoding;
pub use inspection::InspectionIssue;
pub use inspection::InspectionIssueCode;
pub use inspection::InspectionReadiness;
pub use inspection::InspectionRequirement;
pub use inspection::InspectionSeverity;
pub use inspection::ModelInspectionReport;
pub use media::Audio;
pub use media::Media;
pub use media::MediaBinding;
pub use media::MediaRequestError;
pub use media::MultimodalRequest;
pub use media::MultimodalSegment;
pub use media::RgbImage;
pub use media::TokenizedMultimodalRequest;
pub use media::TokenizedMultimodalSegment;
pub use media::Video;
pub use media::VideoSampling;
pub use observation::InspectedOutput;
pub use observation::ObservationError;
pub use observation::ObservationRequest;
pub use observation::ObservationSelector;
pub use observation::ObservationSet;
pub use observation::ObservationValue;
pub use observation::TensorObservation;
pub use observation::TensorObservationData;
pub use observation::MODEL_LOGITS_OBSERVATION_PATH;
pub use realtime::load_realtime_model;
pub use realtime::load_realtime_model_with_options;
pub use realtime::RealtimeBackend;
pub use realtime::RealtimeCompletedStep;
pub use realtime::RealtimeConfigError;
pub use realtime::RealtimeDecisionDiagnostics;
pub use realtime::RealtimeError;
pub use realtime::RealtimeFrameConvention;
pub use realtime::RealtimeFrameForcing;
pub use realtime::RealtimeFrameScheduleState;
pub use realtime::RealtimeFrameSlot;
pub use realtime::RealtimeFrameTransition;
pub use realtime::RealtimeInputFrame;
pub use realtime::RealtimeModel;
pub use realtime::RealtimeModelLoadingBackend;
pub use realtime::RealtimeOutputFrame;
pub use realtime::RealtimeSampling;
pub use realtime::RealtimeScheduleError;
pub use realtime::RealtimeScheduler;
pub use realtime::RealtimeSession;
pub use realtime::RealtimeSlotCoordinate;
pub use realtime::RealtimeSlotOccupancy;
pub use realtime::RealtimeSpeechConfig;
pub use realtime::RealtimeTargetDecision;
pub use realtime::RealtimeTargetSource;
pub use realtime::RealtimeTemporalSource;
pub use realtime::MAX_REALTIME_FRAME_DELAY;
pub use residency::BackgroundPrefetchReport;
pub use residency::PrefetchAdmission;
pub use residency::PrefetchCompletion;
pub use residency::PrefetchDemandObservation;
pub use residency::PrefetchDemandResolution;
pub use residency::PrefetchExecutionState;
pub use residency::PrefetchStateError;
pub use residency::PrefetchWork;
pub use speculative::cancel_pending_verification;
pub use speculative::propose_block;
pub use speculative::resolve_commit_and_publish;
pub use speculative::resolve_optimistic_branch;
pub use speculative::resolve_round;
pub use speculative::submit_verification_transaction;
pub use speculative::CompletedSpeculativeRequest;
pub use speculative::CompletedSpeculativeSchedule;
pub use speculative::PendingSpeculativeVerification;
pub use speculative::PreparedSpeculativeLane;
pub use speculative::ProposalDecision;
pub use speculative::PublishedSpeculativeResult;
pub use speculative::PublishedSpeculativeVerification;
pub use speculative::ResolvedSpeculativeRound;
pub use speculative::SamplingPlacement;
pub use speculative::SpeculativeAction;
pub use speculative::SpeculativeCallbackPublisher;
pub use speculative::SpeculativeCandidate;
pub use speculative::SpeculativeCapability;
pub use speculative::SpeculativeCommit;
pub use speculative::SpeculativeConstraint;
pub use speculative::SpeculativeContinuation;
pub use speculative::SpeculativeDraft;
pub use speculative::SpeculativeDraftBlock;
pub use speculative::SpeculativeDraftSource;
pub use speculative::SpeculativeDriverError;
pub use speculative::SpeculativeExecutionTopology;
pub use speculative::SpeculativeExecutor;
pub use speculative::SpeculativeGenerationBackend;
pub use speculative::SpeculativeGenerationBatchOutput;
pub use speculative::SpeculativeGenerationBatchRequest;
pub use speculative::SpeculativeGenerationLane;
pub use speculative::SpeculativeGenerationOutput;
pub use speculative::SpeculativeGenerationVisitor;
pub use speculative::SpeculativeOptimisticBranch;
pub use speculative::SpeculativeOutputError;
pub use speculative::SpeculativeOutputRuntime;
pub use speculative::SpeculativePrefill;
pub use speculative::SpeculativeProposal;
pub use speculative::SpeculativePublicationStatus;
pub use speculative::SpeculativePublisher;
pub use speculative::SpeculativeRandomness;
pub use speculative::SpeculativeRequest;
pub use speculative::SpeculativeRequestTable;
pub use speculative::SpeculativeSampling;
pub use speculative::SpeculativeSchedule;
pub use speculative::SpeculativeSchedulerStats;
pub use speculative::SpeculativeSemanticConstraint;
pub use speculative::SpeculativeSemanticState;
pub use speculative::SpeculativeStats;
pub use speculative::SpeculativeTelemetry;
pub use topology::balanced_contiguous_range;
pub use topology::ParallelAxis;
pub use topology::ParallelCoordinates;
pub use topology::ParallelRankTopology;
pub use topology::ParallelTopology;
pub use topology::SubgroupMembership;
pub use topology::TopologyError;
pub use topology::TopologyPreflightReport;

Modules§

artifact
Portable artifact inspection and model-preparation planning. Backend-neutral model artifact inspection and preparation planning.
attention
Validated decoder attention schedules. Architecture-neutral decoder layer schedules and attention geometry.
automatic
Backend-neutral automatic execution planning. Backend-neutral automatic execution planning.
backend
High-level execution-backend contract. High-level contract implemented once per execution backend.
cache
Aggregate ownership and admission for backend-managed live caches. Portable cache/state policy and prompt-cache schemas.
capability
Portable model capabilities, runtime-state accounting, and admission policy. Portable model capabilities, runtime-state accounting, and admission policy.
checkpoint
Neutral checkpoint tensor descriptions and validation. Neutral checkpoint tensor catalog contracts.
consensus
Backend-neutral distributed scheduler consensus. Backend-neutral distributed scheduler consensus.
execution
Portable execution plans, capabilities, and telemetry. Portable execution-plan and telemetry schemas.
generation
Backend-independent generation lifecycle and output events. Portable generation configuration, lifecycle, and speculative bookkeeping.
input
Portable identity for ordered, prepared model input. Portable identity for ordered, prepared model input.
inspection
Portable model-artifact inspection results. Portable model-artifact inspection results.
media
Portable decoded-media requests and backend preparation inputs. Portable decoded-media requests and chat-placeholder composition.
observation
Portable, explicitly requested execution observations. Portable, explicitly requested execution observations.
realtime
Backend-generic realtime token-session execution and scheduling. Backend-generic realtime token-session execution and scheduling.
residency
Weight-residency ownership, capacity, and resource planning. Backend-neutral policy, ownership, capacity, accounting, and telemetry for weight residency.
scheduler
Transactional fair work scheduler. Fair transactional scheduling independent of event and tensor runtimes.
speculative
High-level speculative execution contracts and orchestration. High-level contracts and orchestration for speculative execution backends.
topology
Parallel topology and placement planning. Pure parallel topology coordinates and membership validation.