docs(copilot): clarify token-estimate vs metered billing (interim for #443)#449
Draft
iamtoruk wants to merge 1 commit into
Draft
docs(copilot): clarify token-estimate vs metered billing (interim for #443)#449iamtoruk wants to merge 1 commit into
iamtoruk wants to merge 1 commit into
Conversation
…ost estimated Copilot cost in codeburn is a token-based API-rate estimate of the inferred model, which does not match GitHub's metered premium-request / AI-Credits billing. Add a Pricing section to copilot.md explaining the mismatch, and set costIsEstimated on copilot calls. Interim/honest-labeling baseline for #443. The full metered-billing cost model is tracked separately and needs per-plan calibration against a real dashboard.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Interim baseline for #443 — not the full metered-billing cost model (that's gated on reporter calibration; see below).
What this does
docs/providers/copilot.mdexplaining why codeburn's Copilot number won't match the GitHub dashboard: codeburn estimatestokens × underlying-model API rate, while GitHub bills by metered premium requests (legacy, annual plans) or AI Credits (the usage-based model GitHub moved to on 2026-06-01).costIsEstimated: trueon Copilot calls (both parsers).Why it's only a baseline
The real fix — modeling GitHub's metered billing so the dollar figure matches the dashboard — can't be done blind:
parser.tsdrops + recomputes provider cost), which warrants its own careful PR.So we asked the reporter (and the subagent commenter) for their plan + billing system + a calibration data point on #443. Once we have that, the real metered-billing model gets built on their numbers and they validate the branch before merge.
Status
Draft / do not merge yet — kept open as the honest-labeling baseline. tsc clean;
copilot.test.ts25/25 pass.