pub enum VerbPresentationPolicy {
Standard,
AlwaysVerbose,
}Expand description
Presentation override for a verb handler.
Most verbs use the default Standard policy which allows the caller’s
requested PresentationMode to apply. A small set declare AlwaysVerbose
because Agent-mode trimming (UUID shortening, empty-field dropping) would
corrupt their response for downstream chaining — e.g. get returns UUIDs
that callers pipe into link; shortening them here breaks the chain.
The policy is carried as a const in HandlerDef so the registry can
consult it before applying the presentation transform.
Variants§
Standard
Apply the caller’s requested PresentationMode unchanged.
AlwaysVerbose
Always use Verbose output regardless of the caller’s mode.
Declared verbs: get, link, query, traverse, neighbors,
brain.feedback, brain.auto_feedback, memory.feedback,
comm.delivered, git.digest.
link is included because the returned edge ID is the only handle for
follow-up neighbors/traverse calls; short-form IDs risk prefix
collision at scale (~65K edges can share an 8-char prefix).
brain.feedback is included because callers chain target_id from the
response back into subsequent feedback or profile queries; an 8-char
prefix is ambiguous and defeats the acknowledged-ID contract (#545).
memory.feedback has the same exact-target contract and rejects prefix
resolution, so its acknowledged target_id must remain canonical.
brain.auto_feedback acknowledges the same canonical target_id and
feeds those strict paths, so it carries the same guarantee.
comm.delivered is included because its id is an exact correlation
key and the verb deliberately rejects prefix resolution (#1482).
git.digest is included because its successful response is also the
durable receipt payload. Presentation must not shorten receipt_id or
otherwise make the returned result differ from the stored result.
Trait Implementations§
Source§impl Clone for VerbPresentationPolicy
impl Clone for VerbPresentationPolicy
Source§fn clone(&self) -> VerbPresentationPolicy
fn clone(&self) -> VerbPresentationPolicy
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more