[shaneutt]

Makes AI spending a first-class control in Praxis.

This proposal defines Tokenomics: the allocation and enforcement of budgets and rate-limits based on inference tokens.

This is not meant to be implemented immediately upon completion, thus the status is still proposed and several graduation criteria remain. This is meant to be an iterative step in a direction.

Note: This refines the previous token-based rate-limiting design and merges that in.

Summary by CodeRabbit

• Documentation
  • Added a Tokenomics proposal describing tenant token budgets, weighted usage costs, request and token rate limits, hard or soft enforcement, alerts, and usage reporting.
  • The proposal also covers tenant identity, budget allocation and renewal, usage estimation and settlement, and policy validation.
  • Removed the prior token rate-limiting proposal.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

The PR removes an earlier token-rate-limiting proposal and adds a Tokenomics proposal. The new document describes tenant budgets, weighted costs, request and token rate limits, enforcement, admission and settlement, store responsibilities, and usage reporting.

Changes: Tokenomics policy proposal

Layer / File(s)	Summary
Policy and accounting model proposals/00121_tokenomics.md, proposals/00121_token-rate-limiting.md	The proposal defines tenant and budget selection, cost matching, normalized usage, and renewal. It removes the earlier token-rate-limiting proposal.
Configuration and policy validation proposals/00121_tokenomics.md	The proposal adds a YAML example and Rust configuration declarations. It specifies policy validation and update rules.
Admission, settlement, and store recovery proposals/00121_tokenomics.md	The proposal describes request admission, usage settlement, store-failure outcomes, and managed-store replay and acknowledgment.
Reporting and verification proposals/00121_tokenomics.md	The proposal defines usage and quota reporting, related references, and an implementation and verification plan.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Change: Other

Possibly related PRs

• praxis-proxy/enhancements#32: This earlier revision changes the same proposal documents and covers the same Tokenomics design.

Suggested reviewers: araujof

Merge Risk: Low · up to 5410f

This is a design proposal and does not change product behavior today. A few contract gaps should be closed before implementation begins: how it works alongside the existing rate-limit filter, how store backends are validated, how streaming usage is normalized, and how usage events are named. The document can be merged with these tracked as follow-ups.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

• X
• Mastodon
• Reddit
• LinkedIn

CodeRabbit Verify

• Run CodeRabbit Verify to test the changes in this pull request.

[shaneutt]

Merging this now, as proposed because Aslak is going to do the next iteration