Files
codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountTokenUsageResponse.json
Felipe Coury f1a1fce26a Show estimated thread usage in /status (#38281)
## What changed

- Extend `account/usage/read` with an optional `threadId` request and a
  backward-compatible `threadUsage` response containing estimated credits,
  optional USD cost, and model, reasoning, speed, and token breakdowns.
- Fetch thread usage for eligible Business and Enterprise plans when `/status`
  is opened, then update the rendered status card asynchronously.
- Preserve terminal scrollback when replacing a visible status-card tail, and
  append a refreshed card when the original tail can no longer be updated.

## Testing

- Add app-server coverage for authentication, canonical thread IDs,
  unavailable billing routes, and malformed IDs.
- Add TUI coverage for usage formatting, stale responses, retries, history
  updates, terminal reflow, and scrollback preservation.

GitOrigin-RevId: 49300914b3fba917c0f08e8595363e04e5ba6d37
2026-08-13 00:30:08 +00:00

187 lines
3.7 KiB
JSON
Generated

{
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"AccountTokenUsageDailyBucket": {
"properties": {
"startDate": {
"type": "string"
},
"tokens": {
"format": "int64",
"type": "integer"
}
},
"required": [
"startDate",
"tokens"
],
"type": "object"
},
"AccountTokenUsageSummary": {
"properties": {
"currentStreakDays": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"lifetimeTokens": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"longestRunningTurnSec": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"longestStreakDays": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"peakDailyTokens": {
"format": "int64",
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"ThreadUsage": {
"properties": {
"estimatedUsageCreditsMicros": {
"format": "int64",
"type": "integer"
},
"estimatedUsageUsdMicros": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"groups": {
"items": {
"$ref": "#/definitions/ThreadUsageBreakdownGroup"
},
"type": "array"
},
"threadId": {
"type": "string"
}
},
"required": [
"estimatedUsageCreditsMicros",
"groups",
"threadId"
],
"type": "object"
},
"ThreadUsageBreakdownGroup": {
"properties": {
"cachedInputTokens": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"estimatedUsageCreditsMicros": {
"format": "int64",
"type": "integer"
},
"inputTokens": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"model": {
"type": [
"string",
"null"
]
},
"netNewInputTokens": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"outputTokens": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"reasoningEffort": {
"type": [
"string",
"null"
]
},
"speed": {
"type": [
"string",
"null"
]
},
"totalTokens": {
"format": "int64",
"type": [
"integer",
"null"
]
}
},
"required": [
"estimatedUsageCreditsMicros"
],
"type": "object"
}
},
"properties": {
"dailyUsageBuckets": {
"items": {
"$ref": "#/definitions/AccountTokenUsageDailyBucket"
},
"type": [
"array",
"null"
]
},
"summary": {
"$ref": "#/definitions/AccountTokenUsageSummary"
},
"threadUsage": {
"anyOf": [
{
"$ref": "#/definitions/ThreadUsage"
},
{
"type": "null"
}
],
"default": null,
"description": "Estimated usage when a thread was requested and its billing route is available."
}
},
"required": [
"summary"
],
"title": "GetAccountTokenUsageResponse",
"type": "object"
}