Struct BackgroundExecution 

pub struct BackgroundExecution {

    pub execution_id: ExecutionId,
    pub tenant_id: TenantId,
    pub callable_name: String,
    pub input: Option<String>,
    pub context: Option<HashMap<String, String>>,
    pub config: BackgroundExecutionConfig,
    pub status: BackgroundExecutionStatus,
    pub queued_at: DateTime<Utc>,
    pub started_at: Option<DateTime<Utc>>,
    pub completed_at: Option<DateTime<Utc>>,
    pub output: Option<Value>,
    pub error: Option<ExecutionError>,
    pub target_binding_applied: bool,
    pub trigger_id: Option<TriggerId>,
    pub metadata: Option<HashMap<String, Value>>,
}

BackgroundExecution - A background execution record @see packages/enact-schemas/src/execution.schemas.ts - backgroundExecutionSchema

Fields

execution_id: ExecutionId

Execution ID

tenant_id: TenantId

Tenant that owns this execution

callable_name: String

Callable to invoke

input: Option<String>

Input to pass to the callable

context: Option<HashMap<String, String>>

Context to pass

config: BackgroundExecutionConfig

Configuration

status: BackgroundExecutionStatus

Current status

queued_at: DateTime<Utc>

When execution was queued

started_at: Option<DateTime<Utc>>

When execution started

completed_at: Option<DateTime<Utc>>

When execution completed

output: Option<Value>

Output (populated on completion)

error: Option<ExecutionError>

Error (populated on failure)

target_binding_applied: bool

Whether target binding was applied

trigger_id: Option<TriggerId>

Trigger that spawned this execution (if any)

metadata: Option<HashMap<String, Value>>

Metadata

Implementations

impl BackgroundExecution

pub fn new( tenant_id: TenantId, callable_name: impl Into<String>, config: BackgroundExecutionConfig, ) -> Self

Create a new background execution

pub fn from_trigger( tenant_id: TenantId, trigger_id: TriggerId, callable_name: impl Into<String>, input: Option<String>, context: Option<HashMap<String, String>>, target_binding: Option<TargetBindingConfig>, retry: Option<RetryConfig>, ) -> Self

Create from a trigger

pub fn from_spawn_mode( spawn_mode: &SpawnMode, tenant_id: TenantId, callable_name: impl Into<String>, input: Option<String>, context: Option<HashMap<String, String>>, ) -> Option<Self>

Create from SpawnMode::Child

This bridges the gap between SpawnMode::Child { background: true, .. } and the BackgroundExecution infrastructure.

@see docs/TECHNICAL/32-SPAWN-MODE.md

pub fn should_run_background(spawn_mode: &SpawnMode) -> bool

Check if a SpawnMode should create a background execution

pub fn start(&mut self)

Mark execution as started

pub fn complete(&mut self, output: Value)

Mark execution as completed

pub fn fail(&mut self, error: ExecutionError)

Mark execution as failed

pub fn cancel(&mut self)

Mark execution as cancelled

pub fn timeout(&mut self)

Mark execution as timed out

pub fn is_finished(&self) -> bool

Check if execution has completed (successfully or not)

pub fn is_success(&self) -> bool

Check if execution succeeded

pub fn duration_ms(&self) -> Option<i64>

Calculate execution duration

pub fn is_silent(&self) -> bool

Check if execution should suppress streaming events (silent mode)

pub fn requires_result(&self) -> bool

Check if execution requires waiting for result

Trait Implementations

impl Clone for BackgroundExecution

fn clone(&self) -> BackgroundExecution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BackgroundExecution

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BackgroundExecution

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BackgroundExecution

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

where __S: Serializer,

Serialize this value into the given Serde serializer.