Skip to main content

Module spec

Module spec 

Source
Expand description

Shared backend/spec parsing and loading helpers. Canonical backend/spec parsing shared by Rust, CLI, and Python surfaces.

Re-exports§

pub use self::core::AssetRef;
pub use self::core::CanonicalBytes;
pub use self::core::CompiledCompressionBackend;
pub use self::core::CompiledRateBackend;
pub use self::core::CompressionBackendCapabilities;
pub use self::core::MethodBackendFamily;
pub use self::core::RateBackendCapabilities;
pub use self::core::RateBackendTraceStrategy;
pub use self::core::SpecEnvironment;
pub use self::core::ValidatedCompressionBackend;
pub use self::core::ValidatedRateBackend;

Modules§

core
Canonical validated and compiled backend plans.

Structs§

AiqiDiscountedControllerSpec
Discounted AIQI controller configuration.
AssetBinding
Filesystem binding for a named external asset referenced by a spec document.
CompiledPlannerRunSpec
Compiled planner-run specification with resolved assets and compiled backends.
CompressionBackendShorthandOptions
Defaults for shorthand compression-backend parsing such as CLI/Python --compression-backend ... --method ....
McAixiControllerSpec
MC-AIXI controller configuration using a unified rate-backend predictor.
ParsedSpecDocument
Parsed top-level spec document paired with its parse base directory.
PlannerInterfaceSpec
Planner observation/reward/action interface contract.
PlannerRunSpec
Canonical planner-run specification.
PlannerRuntimeSpec
Operational planner-run controls that do not change predictor semantics.
RateBackendShorthandOptions
Defaults for shorthand backend parsing such as CLI --rate-backend ... --method ....
ResolvedAssetBinding
Resolved runtime asset binding derived from a canonical asset identifier.
SpecError
Lightweight error type for spec/config parsing and loading.
ValidatedPlannerRunSpec
Canonicalized and validated planner-run document.
VmActionFilterSpec
Optional information-theoretic action filtering for VM runs.
VmEnvironmentSpec
Canonical Nyx/Firecracker environment configuration.
VmTraceSpec
Optional VM trace collection settings.
WarmStartExactJhControllerSpec
Warm-start exact-\u{1d4a5}_H controller configuration.

Enums§

BuiltinEnvironmentSpec
Built-in non-VM environment choices available to planner runs.
CompiledPlannerController
Compiled planner controller with precompiled predictor backends.
CompiledSpecDocument
Compiled top-level spec document.
ControllerSpec
Canonical planner controller selection.
EnvironmentSpec
Canonical planner-visible environment specification.
SharedMemoryPolicySpec
Shared-memory persistence policy for Nyx VM environments.
SpecDocument
Universal top-level spec document.
ValidatedSpecDocument
Validated top-level spec document.
VmFuzzMutatorSpec
Canonical fuzz mutator choices for VM action generation.
VmObservationPolicySpec
Canonical observation derivation modes for VM environments.
VmObservationStreamModeSpec
Canonical normalization modes for VM observation streams.
VmPayloadEncodingSpec
Canonical payload encodings for VM action and protocol payloads.
VmRewardPolicySpec
Reward policy for canonical VM environment specs.
VmRewardShapingSpec
Reward shaping configuration for VM environments.
VmRuntimeActionSourceSpec
Canonical runtime action source for VM environments.

Traits§

CanonicalJson
Trait for deterministic canonical JSON serialization.

Functions§

calibrated_spec_to_json_value
Serialize a CalibratedSpec into the canonical JSON representation.
compile_compression_backend_name_method
Parse and compile a shorthand CLI/Python-style compression backend.
compile_rate_backend_name_method
Parse and compile a shorthand CLI/Python-style rate backend.
compression_backend_to_json_value
Serialize a CompressionBackend into the canonical JSON representation.
load_calibrated_spec
Load a calibrated spec from disk.
load_expert_spec
Load a single expert spec from disk.
load_json_value_from_path
Load a plain JSON value from disk, resolving relative paths against base_dir.
load_mixture_spec
Load a mixture spec from disk.
load_mixture_spec_with_depth
Load a mixture spec from disk with an explicit remaining nesting budget.
load_particle_spec
Load a particle spec from disk.
load_spec_document
Load a spec document from disk.
mixture_expert_spec_to_json_value
Serialize a MixtureExpertSpec into the canonical JSON representation.
mixture_spec_to_json_value
Serialize a MixtureSpec into the canonical JSON representation.
parse_calibrated_spec_value
Parse a calibrated backend specification.
parse_compression_backend_json
Parse a canonical compression-backend JSON object.
parse_compression_backend_name_method
Build a compression backend from shorthand CLI/Python-style name + optional method inputs.
parse_mixture_expert_value
Parse one mixture expert entry.
parse_mixture_spec_value
Parse a MixtureSpec from JSON.
parse_particle_spec_value
Parse a ParticleSpec from JSON.
parse_rate_backend_json
Parse a canonical rate-backend JSON object.
parse_rate_backend_name_method
Build a backend from shorthand CLI/Python-style name + optional method inputs.
parse_rwkv7_compression_backend_method
Parse RWKV7 compression backend shorthand into a canonical backend configuration.
particle_spec_to_json_value
Serialize a ParticleSpec into the canonical JSON representation.
rate_backend_to_json_value
Serialize a RateBackend into the canonical JSON representation.
resolve_enabled_compression_backend_name
Resolve a compression backend alias and require that it is enabled in the current build.
resolve_enabled_rate_backend_name
Resolve a rate backend alias and require that it is enabled in the current build.
resolve_spec_path
Resolve a spec path against a base directory.

Type Aliases§

AssetId
Stable identifier for an external asset binding.
SpecResult
Result type used by the shared spec/parsing layer.