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.budget—ProviderBudget, the self-tracked counter. Fallback when no live quota API exists.live_quota— kernel-sideQuotaSnapshot/PlanType/QuotaFetchertrait. The v2 eligibility signal #1.quota_tracker—QuotaTracker, 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).