Actor convention
July 31, 2026 · View on GitHub
OKF v0.2 (§7) defines a single convention for the identity fields generated.by and
verified[].by (§5.2). Section 5.1 applies the same convention to the credibility signal
sources[].author:
<producer>/<version>— for agents and tools, e.g.reference_agent/gemini-2.5-pro.human:<id>— for a person, e.g.human:ahormati.process:<id>— for an automated process, e.g.process:finance-nightly.
New in v0.2. v0.1 had no actor convention because it had no identity fields. Producers MUST use the
human:prefix for hand-authored or human-confirmed content, because consumers that classify trust tiers (§5.3) key off exactly that prefix to distinguish human-reviewed from machine-confirmed.
Why a prefix and not a type field
Encoding the actor kind in the string itself keeps identity a single portable value
that survives round-tripping and needs no side table. The human: prefix is the one
load-bearing distinction — it is what promotes a concept to the highest trust tier — so
it is made syntactically unambiguous rather than inferred.