pub struct ModelInvocation { /* private fields */ }Expand description
One immutable, journal-anchored revision of a logical model invocation.
Deserialization verifies local checksums, scope, descriptor/request/result
binding, and predecessor-head shape. Stream the complete ascending history
through ModelInvocationHistoryVerifier to prove delayed retry legality.
Implementations§
Source§impl ModelInvocation
impl ModelInvocation
Sourcepub fn prepare(
intent: ModelInvocationIntent,
journal_head: JournalHead,
) -> Result<Self, ModelInvocationError>
pub fn prepare( intent: ModelInvocationIntent, journal_head: JournalHead, ) -> Result<Self, ModelInvocationError>
Materializes the initial prepared revision after its journal event commits.
The journal head must belong to the activation’s tenant/run and strictly advance the exact base checkpoint without regressing durable time.
§Errors
Returns ModelInvocationError for scope, ordering, or integrity failure.
Sourcepub fn advance(
&self,
transition: ModelInvocationTransition,
journal_head: JournalHead,
) -> Result<Self, ModelInvocationError>
pub fn advance( &self, transition: ModelInvocationTransition, journal_head: JournalHead, ) -> Result<Self, ModelInvocationError>
Applies one legal transition and constructs its next immutable revision.
This enforces exact response/error provenance, request/descriptor
bindings, minimum retry delay, journal order, and revision overflow.
Stores must still compare Self::head under the run lock and current
fencing token, and must enforce run-wide physical attempt uniqueness.
§Errors
Returns ModelInvocationError when the transition cannot safely commit.
Sourcepub fn restore(
intent: ModelInvocationIntent,
revision: ModelInvocationRevision,
state: ModelInvocationState,
previous: Option<ModelInvocationHead>,
journal_head: JournalHead,
transition: Option<ModelInvocationTransition>,
transition_digest: Option<Digest>,
digest: Digest,
) -> Result<Self, ModelInvocationError>
pub fn restore( intent: ModelInvocationIntent, revision: ModelInvocationRevision, state: ModelInvocationState, previous: Option<ModelInvocationHead>, journal_head: JournalHead, transition: Option<ModelInvocationTransition>, transition_digest: Option<Digest>, digest: Digest, ) -> Result<Self, ModelInvocationError>
Restores a record and verifies every invariant available locally.
Failed-to-executing retry authorization depends on the predecessor’s full
error and is therefore verified by ModelInvocationHistoryVerifier,
not by a compact predecessor head.
§Errors
Returns ModelInvocationError for malformed state, provenance, scope,
ordering, transition checksum, or record checksum.
Sourcepub const fn intent(&self) -> &ModelInvocationIntent
pub const fn intent(&self) -> &ModelInvocationIntent
Returns the immutable preparation intent.
Sourcepub const fn revision(&self) -> ModelInvocationRevision
pub const fn revision(&self) -> ModelInvocationRevision
Returns this record’s monotonic revision.
Sourcepub const fn state(&self) -> &ModelInvocationState
pub const fn state(&self) -> &ModelInvocationState
Returns the integrity-bound lifecycle state.
Sourcepub const fn status(&self) -> ModelInvocationStatus
pub const fn status(&self) -> ModelInvocationStatus
Returns the lifecycle discriminator.
Sourcepub const fn attempt_id(&self) -> Option<AttemptId>
pub const fn attempt_id(&self) -> Option<AttemptId>
Returns the physical attempt represented by this revision, if any.
Sourcepub const fn previous(&self) -> Option<&ModelInvocationHead>
pub const fn previous(&self) -> Option<&ModelInvocationHead>
Returns the exact predecessor head, absent only for preparation.
Sourcepub const fn journal_head(&self) -> &JournalHead
pub const fn journal_head(&self) -> &JournalHead
Returns the exact journal prefix anchoring this revision.
Sourcepub const fn transition(&self) -> Option<&ModelInvocationTransition>
pub const fn transition(&self) -> Option<&ModelInvocationTransition>
Returns the explicit transition, absent only for preparation.
Sourcepub const fn transition_digest(&self) -> Option<Digest>
pub const fn transition_digest(&self) -> Option<Digest>
Returns the transition fingerprint, absent only for preparation.
Sourcepub fn head(&self) -> ModelInvocationHead
pub fn head(&self) -> ModelInvocationHead
Returns a compact exact optimistic-comparison token.
Trait Implementations§
Source§impl Clone for ModelInvocation
impl Clone for ModelInvocation
Source§impl Debug for ModelInvocation
impl Debug for ModelInvocation
Source§impl<'de> Deserialize<'de> for ModelInvocation
impl<'de> Deserialize<'de> for ModelInvocation
Source§fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where
D: Deserializer<'de>,
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where
D: Deserializer<'de>,
Source§impl JsonSchema for ModelInvocation
impl JsonSchema for ModelInvocation
Source§fn schema_id() -> Cow<'static, str>
fn schema_id() -> Cow<'static, str>
Source§fn json_schema(generator: &mut SchemaGenerator) -> Schema
fn json_schema(generator: &mut SchemaGenerator) -> Schema
Source§fn inline_schema() -> bool
fn inline_schema() -> bool
$ref keyword. Read more