Module planner_agent 

Public planner-agent substrate for AIXI-family controllers.

The runtime surface is intentionally limited to executable base controllers: MC-AIXI, discounted AIQI, and exact-(J_H) warm-start AIQI. Failed meta-controller experiments are not part of this module.

Structs

AiqiDiscountedPlannerAgent

Discounted AIQI planner adapter.

McAixiPlannerAgent

MC-AIXI planner adapter.

NullPlannerObserver

No-op observer for executions that do not need telemetry.

PlannerControllerAgent

Runtime controller selected from a compiled planner_run.

PlannerCycleOutcome

Outcome of one planner-environment cycle.

PlannerEnvironment

Runtime environment state for planner episodes.

PlannerRunReport

Summary returned by run_episode.

PlannerRunSession

Executable planner-run session.

PlannerSchedule

Planner learn/eval schedule derived from a runtime specification.

WarmStartExactJhPlannerAgent

Exact-(J_H) warm-start planner adapter.

Enums

PlannerActionProvenance

Stable action-provenance labels used by planner JSONL telemetry.

PlannerAgentError

Planner-agent runtime error.

PlannerPhase

Planner cycle phase.

Traits

EnvironmentFactory

Factory for constructing fresh environments for repeated episodes.

PlannerAgent

Executable planner-agent abstraction.

PlannerCycleObserver

Observer strategy for ordered planner-cycle telemetry.

Functions

build_planner_environment

Build the environment declared by a compiled planner run.

compile_planner_run_document

Compile a planner_run document from a filesystem path.

load_warmstart_exact_jh_teacher_dataset

Load and validate a warm-start teacher dataset asset referenced by a compiled planner run.

run_episode

Run one complete environment episode with a supplied agent and environment factory.

validate_action_alphabet

Validate that the environment action alphabet matches the planner interface.

validate_obs_stream_len

Validate observation stream length.

validate_warmstart_exact_jh_teacher_contract

Validate a teacher dataset contract against a compiled planner run.