TokenUsage

TokenUsage = object

Defined in: packages/core/src/observability/token-usage.ts:10

Provider-reported token counts for one agent episode (or a rollup of episodes).

Persisted/UI shape keeps flat cachedInputTokens / reasoningTokens (SQLite columns). toTokenUsage also maps AI SDK 7 nested inputTokenDetails.cacheReadTokens / outputTokenDetails.reasoningTokens into those fields.

Fields are omitted when the provider did not report them — never invent zeros.

Properties

cachedInputTokens?

optional cachedInputTokens?: number

Defined in: packages/core/src/observability/token-usage.ts:14

---

inputTokens?

optional inputTokens?: number

Defined in: packages/core/src/observability/token-usage.ts:11

---

outputTokens?

optional outputTokens?: number

Defined in: packages/core/src/observability/token-usage.ts:12

---

reasoningTokens?

optional reasoningTokens?: number

Defined in: packages/core/src/observability/token-usage.ts:15

---

totalTokens?

optional totalTokens?: number

Defined in: packages/core/src/observability/token-usage.ts:13