Crate khora_control 

The strategic brain of the Khora Engine, responsible for the [C]ontrol Plane.

This crate implements the core logic of the Symbiotic Adaptive Architecture (SAA). It is designed to make high-level, strategic decisions based on telemetry data, but it never performs real-time, performance-critical work itself.

Its primary responsibilities include:

• The Dynamic Context Core (DCC): A service that aggregates engine-wide telemetry (from khora-telemetry) to build a constantly updated situational model of the application’s performance and state.

• Goal-Oriented Resource Negotiation & Allocation (GORNA): The protocol and logic used by the DCC to analyze requests from Agents and to allocate resource budgets (e.g., CPU/GPU time) to them in order to meet high-level performance goals.

• Agent Registry: Automatic registration and ordered iteration of all engine agents with priority-based execution ordering.

This crate represents the “cold path” of the engine, operating at a lower frequency and focusing on intelligent analysis rather than raw execution speed.

Re-exports

pub use analysis::AnalysisReport;

pub use context::Context;

pub use context::HardwareState;

pub use gorna::GornaArbitrator;

pub use plugin::EnginePlugin;

pub use registry::AgentRegistry;

pub use scheduler::ExecutionScheduler;

pub use service::DccConfig;

pub use service::DccService;

Modules

analysis

Heuristic analysis for the DCC.

budget_channel

Unidirectional budget channel from the DCC cold thread to the Scheduler hot thread.

context

Context for the Dynamic Context Core.

cost_model

Empirical cost model — fits a subsystem’s measured runtime to a complexity class so the DCC can anticipate a budget breach instead of only reacting to it.

gorna

GORNA Arbitrator implementation.

metrics

Efficient storage for rolling telemetry metrics.

plugin

Engine plugins — extensible hooks that inject into the frame pipeline.

registry

Agent registry for automatic registration and ordered iteration.

scheduler

The ExecutionScheduler — hot-path orchestrator for the SAA frame loop.

service

Central service for the Dynamic Context Core.

substrate

Substrate Pass — orchestrates the Data layer’s self-maintenance work.

worker_pool

A small persistent thread pool owned by the ExecutionScheduler.

Enums

BatteryLevel

Represents the power source and battery level.

EngineMode

The current mode of the engine.

ThermalStatus

Represents the thermal state of the device.