Struct CommandExecution 

pub struct CommandExecution {

    pub id: Uuid,
    pub task_id: TaskId,
    pub run_id: RunId,
    pub command: String,
    pub working_dir: String,
    pub command_class: CommandClass,
    pub state: CommandState,
    pub queued_at: DateTime<Utc>,
    pub started_at: Option<DateTime<Utc>>,
    pub ended_at: Option<DateTime<Utc>>,
    pub exit_code: Option<i32>,
    pub idempotency_key: Option<String>,
    pub correlation_id: CorrelationId,
    pub chunk_count: u64,
    pub resource_usage: Option<CommandResourceUsage>,
    pub token_usage: Option<TokenUsage>,
}

An immutable record of a command execution.

Fields

id: Uuid

Unique command execution ID.

task_id: TaskId

The task that owns this command.

run_id: RunId

The run this command belongs to.

command: String

Command string (program + arguments).

working_dir: String

Working directory for the command.

command_class: CommandClass

Command class for concurrency accounting.

state: CommandState

Current FSM state.

queued_at: DateTime<Utc>

When the command was queued.

started_at: Option<DateTime<Utc>>

When the command started executing.

ended_at: Option<DateTime<Utc>>

When the command finished (exited/timed-out/killed).

exit_code: Option<i32>

Process exit code (None if not yet exited or killed).

idempotency_key: Option<String>

Idempotency key for deduplication of side-effecting commands.

correlation_id: CorrelationId

Correlation ID.

chunk_count: u64

Number of stdout/stderr chunks collected.

resource_usage: Option<CommandResourceUsage>

Captured process resource usage for this command.

token_usage: Option<TokenUsage>

Token usage associated with this command execution.

Implementations

impl CommandExecution

pub fn new( task_id: TaskId, run_id: RunId, command: impl Into<String>, working_dir: impl Into<String>, command_class: CommandClass, correlation_id: CorrelationId, ) -> Self

Create a new command execution in CmdQueued state.

pub fn with_idempotency_key(self, key: impl Into<String>) -> Self

Set an idempotency key for deduplication.

pub fn transition( &mut self, to: CommandState, reason: impl Into<String>, actor: impl Into<String>, causation_id: Option<EventId>, ) -> Result<Transition, TransitionError>

Attempt a state transition. Returns a Transition event on success.

pub fn exit( &mut self, exit_code: i32, actor: impl Into<String>, causation_id: Option<EventId>, ) -> Result<Transition, TransitionError>

Record a successful exit with exit code.

pub fn duration(&self) -> Option<Duration>

Duration of the command (from start to end or now).

Trait Implementations

impl Clone for CommandExecution

fn clone(&self) -> CommandExecution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandExecution

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CommandExecution

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CommandExecution

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

where __S: Serializer,

Serialize this value into the given Serde serializer.