Types

provide.foundation.eventsets.types

TODO: Add module docstring.

Classes

EventMapping

Individual event enrichment mapping for a specific domain.

Attributes:

Name	Type	Description
name	str	Unique identifier for this mapping
visual_markers	dict[str, str]	Mapping of values to visual indicators (e.g., emojis)
metadata_fields	dict[str, dict[str, Any]]	Additional metadata to attach based on values
transformations	dict[str, Callable[[Any], Any]]	Value transformation functions
default_key	str	Key to use when no specific match is found

EventSet

Complete event enrichment domain definition.

Attributes:

Name	Type	Description
name	str	Unique identifier for this event set
description	str | None	Human-readable description
mappings	list[EventMapping]	List of EventMapping definitions
field_mappings	list[FieldMapping]	List of field-to-mapping associations
priority	int	Higher priority sets override lower ones

FieldMapping

Maps a log field to an event set for enrichment.

Attributes:

Name	Type	Description
log_key	str	The field key in log events (e.g., "http.method", "llm.provider")
description	str | None	Human-readable description of this field
value_type	str | None	Expected type of the field value
event_set_name	str | None	Name of the EventSet to use for enrichment
default_override_key	str | None	Override the default key for this specific field
default_value	Any | None	Default value to use if field is not present