Struct EpisodeId 

pub struct EpisodeId(/* private fields */);

An episode’s own identity: s-<YYYYMMDDHHMMSS>-<4 hex>.

This is the canonical session identity and the only one. It is minted once, when the episode opens, by whoever opens it; it is what every ledger line of the episode is stamped with; and it is what session_id: names in the closed record. A provider’s own session string is ProviderSessionId and is never this.

The shape is the shell tool’s, parsed as written rather than as would be tidier: there are months of these ids in .ai/repo/sessions/ and a parser that refused them would be a parser that cannot read this repository. It is not crate::execution::ExecutionId’s shape — that one is x-20260908T010203Z-0a1b2c3d, with a T, a Z and eight hex digits — and the difference is asserted below so that a refactor cannot quietly align them and orphan every record already written.

use majordomus_cli::session::EpisodeId;

let id = EpisodeId::parse("s-20260910205542-e2a6").expect("an episode id");
assert_eq!(id.as_str(), "s-20260910205542-e2a6");
assert_eq!(id.minted_at(), "20260910205542");

// what it refuses, and why: a path segment is what this value becomes on disk
assert!(EpisodeId::parse("../../etc/passwd").is_none());
assert!(EpisodeId::parse("s-20260910205542-e2a").is_none(), "four hex digits");
assert!(EpisodeId::parse("x-20260908T010203Z-0a1b2c3d").is_none(), "that is an execution");
assert!(EpisodeId::parse("").is_none());

Implementations

impl EpisodeId

pub fn parse(text: &str) -> Option<Self>

Parse an id as the stores write it. None for anything else — which is what keeps a path, a traversal or a wildcard out of a store lookup, since this value names a file under state/sessions-closing/ and is matched against record front matter.

use majordomus_cli::session::EpisodeId;
assert!(EpisodeId::parse("s-20260910205542-e2a6").is_some());
assert!(EpisodeId::parse("s-20260910205542-e2a6/../x").is_none(), "one path segment");

pub fn minted_at(&self) -> &str

The YYYYMMDDHHMMSS the id was minted at. A reader’s convenience and never a substitute for started_at: the stamp says when the id was made, the record says when the episode opened, and an episode recovered from a crash can have the two differ.

use majordomus_cli::session::EpisodeId;
let id = EpisodeId::parse("s-20260910205542-e2a6").expect("an episode id");
assert_eq!(id.minted_at(), "20260910205542");

pub fn as_str(&self) -> &str

The id as text. This is the string every ledger line of the episode is stamped with and the one session_id: names in the closed record.

use majordomus_cli::session::EpisodeId;
let id = EpisodeId::parse("s-20260910205542-e2a6").expect("an episode id");
assert_eq!(id.as_str(), "s-20260910205542-e2a6");

Trait Implementations

impl Clone for EpisodeId

fn clone(&self) -> EpisodeId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EpisodeId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EpisodeId

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for EpisodeId

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

Formats the value using the given formatter.

impl Eq for EpisodeId

impl Hash for EpisodeId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl JsonSchema for EpisodeId

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Ord for EpisodeId

fn cmp(&self, other: &EpisodeId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for EpisodeId

fn eq(&self, other: &EpisodeId) -> 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 PartialOrd for EpisodeId

fn partial_cmp(&self, other: &EpisodeId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for EpisodeId

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EpisodeId