How it works
- The workspace pool is the hard cap. Set a monthly (or one-off) amount. When it runs out, new work stops until it resets or you add credits.
- Each person gets a share. Equal by default; an admin can set a different share or a fixed amount.
- Shares can add up to more than 100%. They are ceilings, not reservations; the pool still caps the total.
- Top-ups add to the pool until used, across resets.
- Limits apply between model calls. A running call finishes, so expect a small overshoot.
- Running out keeps everything readable. People see who can raise the limit and when it resets.
Plans as multiples
If you sell a baseline plan and multiples of it, keep billing on your side and let Opengeni count usage:- On a plan or seat change, set the workspace’s amount to
seats × baseline × multiple. - When a customer buys a top-up, grant it with your own operation ID.
- When their admin changes a person’s share, set that member’s share.
fraction and a status for this.
React components
@opengeni/react/usage reads the signed-in person’s usage through your session proxy:
useUsage()returns the raw reading and which limit applies first.UsageMetershows shares. UseformatAmountto show your own unit;density="hero"for a page header.UsageLimitNoticeappears only near or at a limit. Customize it withlabelsand add a button withaction.UsageMemberListis an admin roster with a share slider per person. Your backend saves the change.
allowanceExhaustedLabels or renderAllowanceExhausted on SessionConversation or MessageTimeline.