{"name":"modelUsage","slug":"modelusage","family":"setting","title":"Settings keys","noun":"settings key","description":"SDK results now document exactly what token usage and dollar cost figures include, and that \/clear resets them.","description_source":"entry","described_by":{"version":"2.1.223","anchor":"sdk-result-docs-for-modelusage-and-totalcostusd"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.309","builds":0,"mined_builds":150,"first_cited":{"version":"2.1.239","released_at":"2026-08-21 17:18:54","spans":1}},"aliases":[],"entries":[{"version":"2.1.277","anchor":"new-sdk-query-usagecost-fields-get-detailed-docs","heading":"New SDK query() usage\/cost fields get detailed docs","line":"SDK docs now spell out that query() usage and cost totals accumulate across turns and reset on \/clear","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.239","anchor":"stream-json-result-schema-spells-out-what-a-held-back-result","heading":"Stream-JSON result schema spells out what a held-back result includes","line":"The stream-JSON schema now documents that a held-back result still carries cost and usage.","released_at":"2026-08-21 17:18:54","reason":"found in this entry's text"},{"version":"2.1.223","anchor":"sdk-result-docs-for-modelusage-and-totalcostusd","heading":"SDK result docs for modelUsage and totalCostUsd","line":"SDK results now document exactly what token usage and dollar cost figures include, and that \/clear resets them.","released_at":"2026-08-05 22:51:13","reason":"named in this entry, found in this entry's text"},{"version":"2.1.223","anchor":"sdk-result-schema-documents-what-usage-total-cost-usd-and-mo","heading":"SDK result schema documents what usage, total_cost_usd and modelUsage actually cover","line":"SDK result fields now explain that usage covers only the main loop and costs are estimates.","released_at":"2026-08-05 22:51:13","reason":"named in this entry, found in this entry's text"}],"entries_total":4,"docs":[{"source":"api","path":"api\/beta\/sessions\/events","title":"Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/events\/list","title":"List Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/events\/stream","title":"Stream Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/threads","title":"Threads","documented":false},{"source":"api","path":"api\/beta\/sessions\/threads\/events","title":"Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/threads\/events\/list","title":"List Session Thread Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/threads\/events\/stream","title":"Stream Session Thread Events","documented":false},{"source":"api","path":"managed-agents\/reference","title":"reference","documented":false},{"source":"claude-code","path":"agent-sdk\/agent-loop","title":"How the agent loop works","documented":false},{"source":"claude-code","path":"agent-sdk\/cost-tracking","title":"Track cost and usage","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/modelusage","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}