mojentic-core/com.mojentic.tracer/Tracer

Tracer

interface Tracer

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

Every method has a no-op default so implementations only override what they care about. NullTracer inherits all defaults; TracerSystem forwards every call to its EventStore.

Methods are suspend because TracerSystem performs a Mutex-protected append; the broker calls every recorder from a suspend context so this imposes no extra burden.

Correlation IDs are opaque strings (UUID-shaped by convention) so the public surface does not depend on still-experimental kotlin.uuid.Uuid.

Inheritors

NullTracer

TracerSystem

Functions

recordAgentInteraction

open suspend fun recordAgentInteraction(fromAgent: String, toAgent: String, eventType: String, eventId: String?, correlationId: String?)

Emitted by Dispatcher / Router when the Phase 4 agent system routes an event between agents.

recordLlmCall

open suspend fun recordLlmCall(model: String, messages: List<LlmMessage>, temperature: Double, tools: List<String>?, correlationId: String?)

recordLlmResponse

open suspend fun recordLlmResponse(model: String, content: String?, toolCalls: List<LlmToolCall>?, callDuration: Duration, correlationId: String?, usage: JsonObject? = null, providerModel: String? = null, finishReason: String? = null, metadata: JsonObject? = null)

Records an LLM response. model is the configured request model. The evidence parameters carry what the provider reported, unchanged: usage is never estimated and stays null when the provider reported none.

recordToolBatch

open suspend fun recordToolBatch(batchId: String, toolNames: List<String>, successCount: Int, failureCount: Int, callDuration: Duration, correlationId: String?, caller: String? = null)

Emitted once per parallel tool batch in addition to the per-call recordToolCall events. Serial runners do not emit batch events.

recordToolCall

open suspend fun recordToolCall(toolName: String, arguments: String, result: String, callDuration: Duration, isError: Boolean, correlationId: String?, caller: String? = null)