microsoft.opentelemetry.a365.core.message_utils module

Conversion and serialization helpers for OTEL gen-ai message format.

Provides normalization from plain list[str] (backward compat) to the structured array format, and a non-throwing serialize_messages function.

microsoft.opentelemetry.a365.core.message_utils.is_string_list(param)

Return True when param is a plain list[str].

Return type:

bool

microsoft.opentelemetry.a365.core.message_utils.is_wrapped_messages(param)

Return True when param is a structured message container.

Return type:

bool

microsoft.opentelemetry.a365.core.message_utils.to_input_messages(messages)

Convert plain input strings into OTEL ChatMessage objects.

Return type:

list[ChatMessage]

microsoft.opentelemetry.a365.core.message_utils.to_output_messages(messages)

Convert plain output strings into OTEL OutputMessage objects.

Return type:

list[OutputMessage]

microsoft.opentelemetry.a365.core.message_utils.normalize_input_messages(param)

Normalize an InputMessagesParam to an InputMessages container.

• str -> wrapped in a single-element list, then converted.

• list[str] -> converted to ChatMessage list and wrapped.

• InputMessages -> returned as-is.

Return type:

InputMessages

microsoft.opentelemetry.a365.core.message_utils.normalize_output_messages(param)

Normalize an OutputMessagesParam to an OutputMessages container.

• str -> wrapped in a single-element list, then converted.

• list[str] -> converted to OutputMessage list and wrapped.

• OutputMessages -> returned as-is.

Return type:

OutputMessages

microsoft.opentelemetry.a365.core.message_utils.serialize_messages(wrapper)

Serialize a message container to a JSON array.

The output is a plain JSON array of message objects per OTel spec: [{"role":"user","parts":[...]}].

The try/except ensures telemetry recording is non-throwing even when message parts contain non-JSON-serializable values.

Return type:

str