Class FlowRunControlRecord

Namespace

FlowOrchestrator.Core.Storage

Assembly

FlowOrchestrator.Core.dll

Control-plane state for a run: timeout deadline, cancellation request, and idempotency key. Written before the run starts and polled by step handlers to honour cancellation signals.

public sealed class FlowRunControlRecord

Inheritance

object

FlowRunControlRecord

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Properties

CancelReason

Optional human-readable reason for the cancellation request.

public string? CancelReason { get; set; }

Property Value

string

CancelRequested

When true, the run has received a cancellation request. Step handlers should check this flag and exit cleanly as soon as possible.

public bool CancelRequested { get; set; }

Property Value

bool

CancelRequestedAtUtc

UTC timestamp when the cancellation was requested, if applicable.

public DateTimeOffset? CancelRequestedAtUtc { get; set; }

Property Value

DateTimeOffset?

CreatedAtUtc

UTC timestamp when the control record was created.

public DateTimeOffset CreatedAtUtc { get; set; }

Property Value

DateTimeOffset

FlowId

The flow that owns this run.

public Guid FlowId { get; set; }

Property Value

Guid

IdempotencyKey

Caller-supplied idempotency key, or null if not provided. Used to deduplicate trigger invocations with the same key within a flow/trigger combination.

public string? IdempotencyKey { get; set; }

Property Value

string

RunId

The run this record controls.

public Guid RunId { get; set; }

Property Value

Guid

TimedOutAtUtc

UTC timestamp when the run was marked as timed out, if applicable.

public DateTimeOffset? TimedOutAtUtc { get; set; }

Property Value

DateTimeOffset?

TimeoutAtUtc

Absolute UTC deadline after which the run should be terminated. null means no timeout is enforced.

public DateTimeOffset? TimeoutAtUtc { get; set; }

Property Value

DateTimeOffset?

TriggerKey

The manifest trigger key used to start this run.

public string TriggerKey { get; set; }

Property Value

string