Commercial Levers

The five levers

• token_usd_rate · top-up price charged to customers + internal upstream cost basis. Two-sided so you can model margin before flipping rates.
• pass_back_ratio · fraction of routing savings passed back to users as wallet credit (default 0.6). Bigger usage, bigger share passed back.
• benchmark_ceilings · per-capability-tier (heavy / balanced / cheap) rate used as the “would-have-cost” baseline for savings calc. Route-pick reads from here on every call.
• upstream_markup_pct · markup applied to raw Fireworks / OpenRouter cost before entering the margin calc (default 0.1 = 10%).
• model_tier_map · model_id → tier classification. Seeded with Opus / Sonnet / Haiku / GPT-4o family / Llama / DeepSeek; expandable via admin UI.

Changing a lever

1. Open the /commercial-levers page in admin-console.
2. Click Edit on the lever row.
3. Update the JSON value. Enter a reason (min 3 chars) · this is written to AuditLog alongside the old + new values so margin movement is always explainable after the fact.
4. Click Save. The in-process route-pick cache is invalidated immediately · next proxy call uses the new value.

History

Every lever has a History drawer (GET /api/admin/commercial-levers/:name/history) showing who changed what, when, and why. Use this before any margin investigation to reconstruct the decision sequence.

Call log export

The /commercial-levers page also hosts the LLM call log export panel. Specify days (1-365) + row limit (1-100k) + tenant filter (UUID or "all"), download as CSV or JSON. BigInt token fields are serialised as strings; timestamps are ISO 8601.