Class FlowRunControlOptions

Namespace

FlowOrchestrator.Core.Configuration

Assembly

FlowOrchestrator.Core.dll

Configuration for run-level control features: timeouts and idempotency. Applied via FlowOrchestratorBuilder.WithRunControl().

public sealed class FlowRunControlOptions

Inheritance

object

FlowRunControlOptions

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Properties

DefaultRunTimeout

Default timeout applied to every run. Enforcement is twofold: lazily when a step is dispatched after the deadline (the step is skipped and the run marked TimedOut), and proactively by the periodic sweep governed by TimeoutEnforcementInterval. A per-run override may be supplied via the trigger payload's runTimeoutSeconds. null disables the default timeout globally.

public TimeSpan? DefaultRunTimeout { get; set; }

Property Value

TimeSpan?

IdempotencyHeaderName

Name of the HTTP header that carries the caller-supplied idempotency key (e.g. "Idempotency-Key"). Requests carrying a key that matches an existing run are de-duplicated rather than creating a new run.

public string IdempotencyHeaderName { get; set; }

Property Value

string

TimeoutEnforcementInterval

How often the periodic timeout-enforcement sweep runs, proactively marking runs whose TimeoutAtUtc has passed as TimedOut so a stuck run does not sit Running indefinitely. null or a non-positive value disables the sweep.

public TimeSpan? TimeoutEnforcementInterval { get; set; }

Property Value

TimeSpan?

Remarks

The sweep is cheap when no run has a deadline (no DefaultRunTimeout and no per-run override) — it queries active runs and finds nothing to do.