Skip to main content

Module token_maxing

Module token_maxing 

Source
Expand description

Token Maxing Mode (RFC-031 v2).

Autonomous burn of subscription-quota providers during a user-configured time window. v2 derives eligibility from live quota API responses instead of the v1 [[token-maxing.providers]] opt-in block.

Architecture:

  • config — TOML schema ([token-maxing]). The v1 [[token-maxing.providers]] block is now optional — providers are auto-discovered when a live subscription snapshot exists.
  • budgetProviderBudget, the self-tracked counter. Fallback when no live quota API exists.
  • live_quota — kernel-side QuotaSnapshot/PlanType/ QuotaFetcher trait. The v2 eligibility signal #1.
  • quota_trackerQuotaTracker, the decision layer. v2 reads live snapshots first; v1 config gate is the fallback.
  • planner, maxer, session — Phase 3.

Re-exports§

pub use budget::ProviderBudget;
pub use budget::ProviderSnapshot;
pub use budget::ProviderState;
pub use budget::ReserveError;
pub use config::SUBSCRIPTION_BILLING_MODEL;
pub use config::TokenMaxingConfig;
pub use config::TokenMaxingProviderConfig;
pub use live_quota::PlanType;
pub use live_quota::QuotaFetcher;
pub use live_quota::QuotaSnapshot;
pub use live_quota::RateWindow;
pub use maxer::TokenMaxer;
pub use planner::PlannedTask;
pub use planner::WorkPlanner;
pub use quota_tracker::Availability;
pub use quota_tracker::CooldownRecord;
pub use quota_tracker::QuotaTracker;
pub use quota_tracker::QuotaTrackerSnapshot;
pub use quota_tracker::RecalibrationOutcome;
pub use quota_tracker::RecalibrationRecord;
pub use session::MaxerStatus;
pub use session::MaxingStart;
pub use session::MaxingWindow;
pub use session::ProviderSessionRecord;
pub use session::ProviderWindowRecord;
pub use session::SessionTotals;
pub use session::StopReason;
pub use session::TaskRecord;
pub use session::TaskSource;
pub use session::TokenMaxingSession;

Modules§

budget
Self-tracked per-provider budget (RFC-031 §4, Phase 1).
config
Token Maxing configuration (RFC-031 §2).
live_quota
Live quota snapshot types — the v2 signal #3 data source for QuotaTracker (RFC-031 v2 §4).
maxer
TokenMaxer orchestrator (RFC-031 §5).
planner
WorkPlanner — three-source task synthesis (RFC-031 §7).
quota_tracker
QuotaTracker — the per-provider availability decision layer (RFC-031 v2 §4).
session
TokenMaxingSession + report (RFC-031 §8).