Cairnloop.Retrieval.Telemetry (cairnloop v0.1.0)

Copy Markdown View Source

Stable Cairnloop-native telemetry helpers for retrieval search and draft grounding.

Metadata is intentionally bounded and low-cardinality so it can be safely projected into host-owned metrics without leaking raw query text, result identifiers, or citation payloads.

Summary

Functions

classify_exception(error)

draft_grounding_event_name()

emit_draft_grounding(measurements, metadata)

emit_search(measurements, metadata)

error_metadata(opts, diagnostic_class, reason)

grounding_metadata(bundle, opts \\ [])

normalize_diagnostic_class(class)

normalize_reason(reason)

search_event_name()

search_metadata(results, opts \\ [])

surface(opts)