mojentic-core/com.mojentic.tracer

Package-level declarations

Types

data class AgentInteractionEvent(val timestamp: Instant = Clock.System.now(), val correlationId: String, val fromAgent: String, val toAgent: String, val eventType: String, val eventId: String? = null) : TracerEvent

Records an inter-agent interaction. Emitted by Dispatcher / Router once the Phase 4 agent system ships; declared here so consumers can register interest immediately.

EventStore

class EventStore(replayCapacity: Int = 0)

Append-only buffer of TracerEvents plus a hot SharedFlow for live consumers.

LlmCallEvent

data class LlmCallEvent(val timestamp: Instant = Clock.System.now(), val correlationId: String, val model: String, val messages: List<LlmMessage>, val temperature: Double, val tools: List<String>?) : TracerEvent

Records when an LLM is called with a specific message list and tool set.

LlmResponseEvent

data class LlmResponseEvent(val timestamp: Instant = Clock.System.now(), val correlationId: String, val model: String, val content: String?, val toolCalls: List<LlmToolCall>?, val callDuration: Duration, val usage: JsonObject? = null, val providerModel: String? = null, val finishReason: String? = null, val metadata: JsonObject? = null) : TracerEvent

Records the response received from an LLM call.

NullTracer

object NullTracer : Tracer

Zero-allocation, no-op Tracer. The broker's default.

ToolBatchEvent

data class ToolBatchEvent(val timestamp: Instant = Clock.System.now(), val correlationId: String, val batchId: String, val toolNames: List<String>, val successCount: Int, val failureCount: Int, val callDuration: Duration, val caller: String? = null) : TracerEvent

Records the end-to-end execution of a parallel tool batch.

ToolCallEvent

data class ToolCallEvent(val timestamp: Instant = Clock.System.now(), val correlationId: String, val toolName: String, val arguments: String, val result: String, val callDuration: Duration, val isError: Boolean, val caller: String? = null) : TracerEvent

Records a single tool invocation.

Tracer

interface Tracer

Observability hook surface called by com.mojentic.llm.LlmBroker and the tool runners.

TracerEvent

sealed interface TracerEvent

Closed sum of tracer events recorded by TracerSystem.

TracerSystem

class TracerSystem(val eventStore: EventStore = EventStore(), enabled: Boolean = true) : Tracer

Central Tracer implementation backed by an EventStore.