Struct RunRecord 

pub struct RunRecord {

    pub session_id: SessionId,
    pub run_id: RunId,
    pub revision: u64,
    pub conversation_id: ConversationId,
    pub input: Vec<InputPart>,
    pub status: RunStatus,
    pub output_preview: Option<String>,
    pub terminal_error: Option<RunTerminalError>,
    pub structured_output: Value,
    pub latest_checkpoint: Option<CheckpointRef>,
    pub environment_state: Option<EnvironmentStateRef>,
    pub stream_cursors: Vec<StreamCursorRef>,
    pub trace_context: TraceContext,
    pub sequence_no: usize,
    pub restore_from_run_id: Option<RunId>,
    pub parent_run_id: Option<RunId>,
    pub parent_task_id: Option<TaskId>,
    pub trigger_type: Option<String>,
    pub profile: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub metadata: Metadata,
}

Durable run record.

Fields

session_id: SessionId

Session id.

run_id: RunId

Run id.

revision: u64

Monotonic optimistic-concurrency revision.

conversation_id: ConversationId

Conversation id.

input: Vec<InputPart>

User, API, or service input parts.

status: RunStatus

Durable run status.

output_preview: Option<String>

Final output preview.

terminal_error: Option<RunTerminalError>

Safe diagnostic for a failed or cancelled terminal run.

structured_output: Value

Final structured output preview or summary.

latest_checkpoint: Option<CheckpointRef>

Latest checkpoint reference.

environment_state: Option<EnvironmentStateRef>

Latest environment state reference for this run.

stream_cursors: Vec<StreamCursorRef>

Latest stream cursor refs by family.

trace_context: TraceContext

Trace context.

sequence_no: usize

Monotonic order inside the session.

restore_from_run_id: Option<RunId>

Run snapshot used as continuation source.

parent_run_id: Option<RunId>

Parent run identifier when this run is delegated from another run.

parent_task_id: Option<TaskId>

Parent-scoped delegated task identifier when this run executes a lightweight task.

trigger_type: Option<String>

Trigger source such as cli, service, schedule, or delegated.

profile: Option<String>

Profile resolved for this run.

created_at: DateTime<Utc>

Creation time.

updated_at: DateTime<Utc>

Last update time.

metadata: Metadata

Metadata.

Implementations

impl RunRecord

pub fn terminal_projection(&self) -> Option<RunTerminalProjection>

Return the complete terminal projection when this record is terminal.

Historical failed records may legitimately return a projection with no diagnostic.

pub fn validate_new_write(&self) -> Result<(), RunTerminalProjectionError>

Validate a newly persisted run state.

Historical records are accepted when read, but every new write must carry a complete terminal projection and every non-terminal write must omit stale terminal diagnostics.

Errors

Returns an error when status, output, and terminal diagnostic are inconsistent.

pub fn normalize_for_admission(&mut self)

Normalize caller-provided state before a new admission is persisted.

Admission always creates a queued execution. Any stale terminal projection from a reused record is discarded rather than becoming active-run state or client-visible output.

pub fn apply_legacy_status_update( &mut self, status: RunStatus, output_preview: Option<String>, )

Apply the legacy low-level status update contract.

The legacy API cannot distinguish safe diagnostics from arbitrary caller text, so failed and cancelled updates discard their preview and persist a fixed generic diagnostic.

pub fn new( session_id: SessionId, run_id: RunId, conversation_id: ConversationId, ) -> Self

Build a run record for a session.

Trait Implementations

impl Clone for RunRecord

fn clone(&self) -> RunRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RunRecord

impl From<&RunRecord> for RunChangedSummary

fn from(run: &RunRecord) -> Self

Converts to this type from the input type.

impl PartialEq for RunRecord

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RunRecord

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 RunRecord

impl VersionedRecord for RunRecord

const SCHEMA: &'static str = "starweaver.session.run_record"

Stable schema identifier.

const ALLOW_BARE_V0: bool = true

Whether this record explicitly accepts a previous bare-JSON v0 shape.

const VERSION: u32 = 1

Current schema version.

fn decode_version( version: u32, payload: Value, ) -> Result<Self, VersionedRecordError>

where Self: DeserializeOwned,

Decode one enveloped payload version.

fn decode_bare_v0(payload: Value) -> Result<Self, VersionedRecordError>

where Self: DeserializeOwned,

Decode the explicitly supported bare-JSON v0 shape.