{"version":"2.1.223","anchor":"sdk-result-docs-for-modelusage-and-totalcostusd","canonical_anchor":"sdk-result-docs-for-modelusage-and-totalcostusd","heading":"SDK result docs for modelUsage and totalCostUsd","tier":"internal","area":"SDK","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.223\/e\/sdk-result-docs-for-modelusage-and-totalcostusd","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.223","markdown":"### SDK result docs for modelUsage and totalCostUsd\n\nSDK results now document exactly what token usage and dollar cost figures include, and that \/clear resets them.\n\n**What**\n\nTwo long documentation strings now describe per-model usage and cumulative USD cost for a `query()` call.\n\n**Details**\n\n- counted: the main loop, Task subagents, sidechains, compaction and Workflow agents\n- excluded: the permission classifier and token-count probes\n- values are cumulative per streaming turn and are reset by a mid-session `\/clear`\n- documented as the correct field for token and cost accounting, but an estimate rather than a billing statement\n\n**Evidence**\n\n`The correct field for token\/cost accounting; treat it as an estimate, not a billing statement.`\n\n- Area: SDK\n- Names: `totalCostUsd`, `modelUsage`, `\/clear`\n- Tier: Under the hood\n- Useful: 2\/5\n- Signal: 0\/5"}