Plan, status and seats
The settings billing page shows the workspace subscription: its plan, the Stripe subscription status, the saved card, the seat state and the invoices. Access needs the BILLING_READ permission, so the owner and admins, not only the platform super-admin.
- Current plan and base price
- Seats occupied: active members and pending invites count, revoked members do not
- Per-seat price beyond the plan's included seats
- Payment card and applied payout commission
Entitlements and feature keys
The key catalogue is typed: modules (module.studio, module.voice, module.ads…), features (feature.emails.sequences, feature.linkedin.extension, feature.agents.copilot…) and limits (limit.contacts, limit.workspace_members, limit.webinars…). The plan carries the matrix, workspace overrides win over it. Each key has a minimum plan and a label for the upgrade copy.
Quotas and hard limit
A quota compares current-period usage to the plan's included amount, for one service and metric pair. A hard-limit plan cuts the action off when the quota is spent: the call throws a QuotaExceededError and the call site returns a readable 402, not a 500. The same guard protects the Kernel paid surfaces and the mobile copilot, identically.
Metered and rebillable usage
Every call to an external service records a usage event: the service, the metric, the quantity and an estimated cost in cents. The usage page aggregates by service and period (this month, last month, 30 days), splits the rebillable cost from the bring-your-own-key (BYO) cost, and filters by core or voice family.
- Core: Claude, Apify, Fathom, WhatsApp, Resend
- Voice: Twilio, Groq, Deepgram, Vapi, Dropcontact
- A key supplied by the workspace flips the event to BYO, not rebilled
Banners, grace and comping
The banner state resolves by priority: payment failed, card missing, quota warning at 80 percent, plan not chosen after 14 days. A comped workspace sees no banner. A free workspace still without a plan past the grace period is moved back to free by a cron, with a transition log.