Interface: TokenEconomicsProfile

Defined in: packages/core/src/introspection/ToolContract.ts:122

Token economics profile for cognitive overload detection.

Captures the expected token density of a tool's responses to detect context inflation that would evict system rules from the LLM's working memory.

Properties

baseOverheadTokens

readonly baseOverheadTokens: number;

Defined in: packages/core/src/introspection/ToolContract.ts:128

Estimated base token overhead (rules + UI + affordances)

---

inflationRisk

readonly inflationRisk: "critical" | "low" | "medium" | "high";

Defined in: packages/core/src/introspection/ToolContract.ts:130

Risk level based on configuration

---

schemaFieldCount

readonly schemaFieldCount: number;

Defined in: packages/core/src/introspection/ToolContract.ts:124

Estimated tokens per field in the egress schema

---

unboundedCollection

readonly unboundedCollection: boolean;

Defined in: packages/core/src/introspection/ToolContract.ts:126

Whether collections may be unbounded (no agentLimit)