nat.atof.category#

Category vocabulary for ATOF events (spec §4).

ATOF v0.1 uses a CLOSED vocabulary for category with a custom + category_profile.subtype escape hatch for vendor extensions and an unknown value for tier-1 pass-through producers that cannot classify the work.

The Category name is a Literal type alias so that typed Python consumers can annotate expected values; validator logic in events.py tolerates any non-empty string on the wire (consumers MUST NOT reject unknown category values per spec §4.3), but producers using the canonical vocabulary through Category get static-analysis coverage.

Canonical vocabulary:

  • agent — top-level agent or workflow scope

  • function — generic function or application step

  • llm — LLM call (populates category_profile.model_name)

  • tool — tool invocation (populates category_profile.tool_call_id)

  • retriever — retrieval step (document search, index lookup)

  • embedder — embedding-generation step

  • reranker — result reranking step

  • guardrail — guardrail or validation step

  • evaluator — evaluation or scoring step

  • custom — vendor-defined category; REQUIRES category_profile.subtype to name it

  • unknown — producer does not know or cannot classify the work

Attributes#

Category

Module Contents#

Category#