Module presentation 

Verb response presentation modes and transformation.

Transforms canonical handler output into caller-appropriate form after dispatch and before wire serialization. Agent mode abbreviates UUIDs and drops empty fields; Verbose and Human pass through canonical JSON unchanged.

This module also contains the OutputFormat axis (ADR-078) which governs how the resulting serde_json::Value is serialized or rendered to an output string. PresentationMode and OutputFormat compose independently.

Structs

PresentationNow

A response-wide clock sample. Fractional precision distinguishes a newly stored row from a truly future row within the same Unix second.

Enums

NoteContentScope

Exact note-body locations selected by the request boundary for get/list(parse_content=true). No policy marker is inferred from user JSON.

OutputFormat

Output serialization format for verb results (ADR-078).

PresentationMode

How the response envelope is presented to the caller.

RedundancyScope

Which redundancy-reduction rules apply (ADR-078 §7, Amendment 3).

Functions

apply_redundancy_drop

Apply the redundancy-reduction pre-pass (ADR-078 §7, Amendment 3) to a value at the given RedundancyScope.

format_utc_rfc3339_seconds

Format an instant in UTC using RFC3339 whole seconds and a Z suffix.

micros_to_iso

Convert a microsecond epoch i64 to an exact UTC ISO-8601 string.

prepare_format_value

Prepare a successful result for its requested format at the wire boundary.

prepare_format_value_with_note_content

Apply format reductions to record metadata while preserving parsed bodies.

present

Transform a successful verb result value according to the given PresentationMode.

present_with_policy

Present a successful result using its trusted registered verb policy. Receipt policies preserve only their closed string paths, not descendants.

present_with_policy_at

Present with the response’s single sampled instant, including its fraction.

render_format

Render a successful verb result value to a wire string using the given format.

render_format_with_note_content

Render an opt-in parsed-note response without treating its body as metadata or a top-level record table. Auto preserves parsed values; Table stringifies non-scalar content for display only.

rfc3339_to_utc_micros

Parse an RFC 3339 timestamp (offset required) into microsecond epoch i64 — the inverse of micros_to_iso within the RFC 3339 four-digit year range. Expanded ISO years are not accepted. This is the single parse point for caller-supplied instants entering storage comparisons.