Skip to content

Interface: TokenAnalysis

Defined in: packages/core/src/introspection/TokenEconomics.ts:46

Token economics analysis for a single tool response.

Properties

actionKey

ts
readonly actionKey: string | null;

Defined in: packages/core/src/introspection/TokenEconomics.ts:50

Action key, if applicable


advisory

ts
readonly advisory: string | null;

Defined in: packages/core/src/introspection/TokenEconomics.ts:66

Human-readable advisory


blockCount

ts
readonly blockCount: number;

Defined in: packages/core/src/introspection/TokenEconomics.ts:54

Number of content blocks in the response


blocks

ts
readonly blocks: readonly BlockTokenProfile[];

Defined in: packages/core/src/introspection/TokenEconomics.ts:56

Per-block token breakdown


dataTokens

ts
readonly dataTokens: number;

Defined in: packages/core/src/introspection/TokenEconomics.ts:60

Data payload tokens (actual tool output)


estimatedTokens

ts
readonly estimatedTokens: number;

Defined in: packages/core/src/introspection/TokenEconomics.ts:52

Estimated total tokens in the response


overheadRatio

ts
readonly overheadRatio: number;

Defined in: packages/core/src/introspection/TokenEconomics.ts:62

Overhead-to-data ratio (higher = more overhead)


overheadTokens

ts
readonly overheadTokens: number;

Defined in: packages/core/src/introspection/TokenEconomics.ts:58

Overhead tokens (rules, affordances, UI decorators)


risk

ts
readonly risk: TokenRisk;

Defined in: packages/core/src/introspection/TokenEconomics.ts:64

Risk classification


toolName

ts
readonly toolName: string;

Defined in: packages/core/src/introspection/TokenEconomics.ts:48

Tool name