Module task_scheduler 

Agent-wide admission scheduler for top-level and background work.

Session transcript admission remains single-flight. This scheduler adds a shared capacity boundary across every session created by one Agent, using a3s-lane’s stable priority queue for exact priority/FIFO ordering.

Structs

TaskLease

RAII ownership of one scheduler admission.

TaskPriorityCounts

Counts grouped by the stable public priority classes.

TaskScheduler

Shared actor handle. One instance belongs to each Agent.

TaskSchedulerConfig

Agent-wide task scheduler settings.

TaskSchedulerHealthSnapshot

Bounded cumulative admission and fairness diagnostics for one scheduler.

TaskSchedulerQuota

Immutable capacity quota carried by one scheduler admission request.

TaskSchedulerQuotaHealthSnapshot

Bounded live-or-recent health for one scheduler quota identity.

TaskSchedulerQuotaSnapshot

Live, digest-only occupancy projection for one scheduler quota.

TaskSchedulerStats

Point-in-time scheduler occupancy for hosts and diagnostics.

Enums

TaskPriority

Relative importance of work admitted through an agent’s shared scheduler.

TaskSchedulerError

Scheduler admission failures.

Constants

TASK_SCHEDULER_MAX_QUOTAS

Maximum number of independent quota dimensions accepted by one admission.

TASK_SCHEDULER_MAX_SCOPE_BYTES

Maximum bytes accepted while deriving a scheduler owner scope.

TASK_SCHEDULER_QUOTA_HEALTH_RETENTION

Maximum number of idle quota health epochs retained by one scheduler.