Package com.tnsai.reliability

Interface Progress

All Known Implementing Classes:
Progress.CheckpointSaved, Progress.CostUpdate, Progress.Heartbeat, Progress.RunAborted, Progress.RunCompleted, Progress.RunFailed, Progress.StepCompleted, Progress.StepStarted
public sealed interface Progress permits Progress.Heartbeat, Progress.StepStarted, Progress.StepCompleted, Progress.CostUpdate, Progress.CheckpointSaved, Progress.RunCompleted, Progress.RunFailed, Progress.RunAborted
Observable mid-run state event (TNS-299). Sealed so a ProgressSink subscriber can dispatch with an exhaustive pattern-match.

A run emits one of these whenever something operator-visible happens — a step finishes, the orchestrator records a checkpoint, cost ticks, or a heartbeat keeps the live dashboard alive. The RunConfig.progressTimeout window is judged against these events: if none arrive within the configured window, the run is declared "stuck" and the orchestrator aborts.

Since:
0.10.0 (TNS-299)

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static final record 
    Progress.CheckpointSaved
    A Checkpoint has been persisted.
    static final record 
    Progress.CostUpdate
    Spend tick — the orchestrator emits this when a cost-tracking integration reports new spend, so dashboards can plot against the run's RunConfig.costCeilingUSD.
    static final record 
    Progress.Heartbeat
    Idle "I'm still alive" pulse for runs that perform a long-running step without intermediate checkpoints.
    static final record 
    Progress.RunAborted
    Run aborted by policy (AbortReason).
    static final record 
    Progress.RunCompleted
    Run reached the end of its step list.
    static final record 
    Progress.RunFailed
    Run aborted by uncaught exception or retry exhaustion.
    static final record 
    Progress.StepCompleted
    A step finished successfully; carries timing for diagnostics.
    static final record 
    Progress.StepStarted
    A step has begun executing.

  • Method Summary

    Modifier and Type
    Method
    Description
    Instant
    at()
    Wall-clock instant the event was emitted.

  • Method Details

    • at

      Instant at()
      Wall-clock instant the event was emitted.