pub.layers.persona

Persona records define annotation frameworks and analyst perspectives. Different personas can annotate the same data with different ontologies and interpretive frameworks, following FOVEA's persona-based approach.

Types

persona

NSID: pub.layers.persona.persona Type: Record

A persona representing an annotator's role, expertise, and interpretive framework.

Field	Type	Description
name	string	The persona name (e.g., 'Syntactician', 'Intelligence Analyst', 'Biomedical NER Annotator').
description	string	Description of the persona's role, expertise, and information needs.
domainUri	at-uri	AT-URI of the domain definition node. Community-expandable via knowledge graph.
domain	string	Domain slug (fallback). Known values: linguistics, nlp, biomedical, legal, intelligence, social-science, humanities, custom
kindUri	at-uri	AT-URI of the persona kind definition node. Community-expandable via knowledge graph.
kind	string	Persona kind slug (fallback). Known values: human-annotator, ml-model, guidelines-persona, expert-panel, crowd-worker, custom
parentRef	at-uri	AT-URI of a parent persona this one specializes.
ontologyRefs	array	Ontologies this persona uses for annotation. Array of at-uri
guidelines	string	Annotation guidelines text.
guidelinesFormat	string	Format of the guidelines text, so consumers can render it safely without sniffing. Defaults to plain when omitted. Known values: plain, html, markdown
guidelinesBlob	blob	Annotation guidelines document (PDF, Markdown, or plain text).
knowledgeRefs	array	Knowledge graph references (e.g., ORCID, institutional identifiers). Array of ref: pub.layers.defs#knowledgeRef
licensing	ref	Licensing terms governing this persona's guidelines and framework (supports dual/multi/component licensing). Ref: pub.layers.defs#licensing
features	ref	Open-ended features: expertise level, certification, language proficiency, reliability. Ref: pub.layers.defs#featureMap
createdAt	datetime	Record creation timestamp.

XRPC Queries

getPersona

NSID: pub.layers.persona.getPersona

Retrieve a single persona record by AT-URI.

Parameter	Type	Description
uri	at-uri (required)	The AT-URI of the persona record.

Output: An object { uri, cid, value: persona } where value is the persona record.

listPersonas

NSID: pub.layers.persona.listPersonas

List persona records in a repository with pagination.

Parameter	Type	Description
repo	at-identifier (required)	The DID or handle of the repository.
domain	string	Optional filter by domain slug.
kind	string	Optional filter by persona kind slug.
limit	integer	Maximum number of records to return (1-100, default 50).
cursor	string	Pagination cursor from previous response.

Output: { records: { uri, cid, value: persona }[], cursor?: string } (each entry is a recordView wrapping the persona).