Inspection

The scheduler exposes lightweight, read-only state through IJobSchedulerInspector. This is enough to build an admin dashboard or a job-status endpoint without a separate trigger API.

Snapshots

var snapshot = schedulerInspector.GetSnapshot();
var activeRuns = snapshot.ActiveRuns;
var nextDue = snapshot.Jobs
    .Single(job => job.Name == "reports.daily")
    .NextDueTimeUtc;

var job = schedulerInspector.GetJob(handle.JobId);

NextDueTimeUtc is the next queued due time known to the running in-memory scheduler — enough to show the next fire time for enabled recurring jobs. Runtime jobs with deferred retry expose their next retry due time through ScheduledJobState.NextAttemptDueTimeUtc.

Per-job status

A status handler can inspect the logical job and surface it to a caller:

var state = schedulerInspector.GetJob(jobId);
if (state is null) {
    return AppError.NotFound("Job state is no longer available.");
}

return new JobStatusResponse(
    state.Status,
    state.Attempt,
    state.MaxAttempts,
    state.NextAttemptDueTimeUtc,
    state.LastError);

Terminal states are Succeeded, Failed, Cancelled, or Skipped, retained in memory up to Scheduler:MaxRetainedCompletedJobs.