Struct RuntimeSessionSpec 

pub struct RuntimeSessionSpec {

    pub session_id: String,
    pub env_id: String,
    pub env_component_id: String,
    pub model_component_id: String,
    pub workflow_edition: String,
    pub env_contract: EnvContract,
    pub num_envs: usize,
    pub base_seed: Option<i64>,
    pub episode_seeds: Vec<i64>,
    pub max_episodes: Option<u64>,
    pub max_episode_steps: Option<i64>,
    pub max_episode_seconds: Option<f64>,
    pub close_env_on_end: bool,
    pub limits: RuntimeLimits,
}

Everything one route needs to run: its identity, the negotiated env contract, and the per-op limits. validate gates a spec before the driver runs it.

Fields

session_id: String

Correlation label only; OSS does not key on it (the managed layer owns session lifecycle). Kept as plumbing for telemetry/logs — its removal is the deferred closed split, out of scope here.

env_id: String

The connected env container, UUIDv7 (minted by the runtime on attach). The single routing key: replaces the old route_id + positional lane. (Repurposed from the former descriptive-name field; the human env name now lives only in the language SDK’s own contract type.)

env_component_id: String

model_component_id: String

workflow_edition: String

Workflow edition negotiated at the env handshake. The runtime refuses an edition it was not built to drive (see RuntimeSessionSpec::validate).

env_contract: EnvContract

num_envs: usize

base_seed: Option<i64>

episode_seeds: Vec<i64>

Explicit per-episode reset seeds, consumed in episode-start order (a vector reset claims one per lane). Overrides base_seed derivation when non-empty; episodes beyond the list reset unseeded. Requires driver-owned resets (autoreset DISABLED): under NEXT_STEP the env seeds its own rolls, so the list would silently not apply.

max_episodes: Option<u64>

max_episode_steps: Option<i64>

Truncate any episode after this many steps (runtime-enforced; the lane is reset and the episode reported truncated). Requires driver-owned resets (autoreset DISABLED).

max_episode_seconds: Option<f64>

Truncate any episode after this wall-clock duration (seconds), same semantics and autoreset requirement as max_episode_steps.

close_env_on_end: bool

limits: RuntimeLimits

Implementations

impl RuntimeSessionSpec

pub fn validate(&self) -> Result<(), String>

pub fn env_context(&self) -> RuntimeEnvContext

pub fn observation_space(&self) -> Option<&SpaceSpec>

Returns the observation space, or None if the spec has not been populated/validated (env_contract.observation_space is unset).

All RuntimeSessionSpec fields are public, so an unvalidated spec is trivial to construct; this accessor never panics. The driver validates the spec before running and uses the infallible internal accessor.

pub fn action_space(&self) -> Option<&SpaceSpec>

Returns the action space, or None if the spec has not been populated/validated (env_contract.action_space is unset).

See RuntimeSessionSpec::observation_space for why this is fallible.

Trait Implementations

impl Clone for RuntimeSessionSpec

fn clone(&self) -> RuntimeSessionSpec

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RuntimeSessionSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for RuntimeSessionSpec

fn eq(&self, other: &RuntimeSessionSpec) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RuntimeSessionSpec