15#ifndef A11_ACTIONS_STREAM_REFERENCE_H_
16#define A11_ACTIONS_STREAM_REFERENCE_H_
21#include <absl/status/status.h>
22#include <absl/status/statusor.h>
30 "a11-stream-reference";
absl::StatusOr< data::Chunk > StreamReferenceToChunk(const StreamReference &reference)
Encode a reference and its source as a plain JSON object chunk.
Definition stream_reference.cc:39
absl::StatusOr< StreamReference > StreamReferenceFromChunk(data::Chunk chunk)
Decode a reference, preserving source metadata as an opaque JSON chunk.
Definition stream_reference.cc:73
constexpr std::string_view kStreamReferenceAttribute
Metadata identifying a reference chunk on a scope's reserved output.
Definition stream_reference.h:29
Locate an auxiliary producer independently of its stream payload.
Definition stream_reference.h:33
data::NodeRef node
Node readable in the receiving scope.
Definition stream_reference.h:36
data::Chunk source
Opaque source metadata as a JSON object.
Definition stream_reference.h:38
absl::Status Validate() const
Validate the identifiers independently of source serialization.
Definition stream_reference.cc:31
std::string producer_id
Stable logical producer identity.
Definition stream_reference.h:34
std::string parent_producer_id
Enclosing producer, or empty.
Definition stream_reference.h:35
std::string purpose
Payload protocol, such as llm_usage.
Definition stream_reference.h:37
friend bool operator==(const StreamReference &, const StreamReference &)=default
A unit of data: bytes plus optional descriptive metadata.
Definition types.h:173
A reference to a (slice of a) logical node, in lieu of inline data.
Definition types.h:311
A11's core wire value types: chunks, node fragments and messages.