Cache And Tiers
EdgarParser tracks access and cost separately. tier answers who may call a tool. cache_behavior answers whether a call can do work beyond reading existing artifacts. anonymous_eligible answers whether the shared playground may expose the tool at all.
A public tool is not automatically safe for anonymous demo traffic. Playground access also requires anonymous_eligible: true and cache_behavior: cache_only.
Cache Behaviors
| Behavior | Meaning | Playground |
|---|---|---|
cache_only | Reads existing filing artifacts or derived caches only | Allowed only when manifest says anonymous eligible |
cold_allowed | May fetch, parse, or warm missing data | Never anonymous |
llm_call | May trigger language-model extraction or premium evidence work | Never anonymous |
Access Tiers
| Tier | Typical Surface |
|---|---|
public | Cache-backed filing facts, concepts, metadata, tables, and text search |
registered | Document retrieval and higher-volume workflows |
paid | Premium extraction caches, operational KPI drivers, and LLM-backed evidence |
internal | Admin and operational routes |