llm4s-core
API
Generated with
llm4s-core/org.llm4s/org.llm4s.trace/org.llm4s.trace.store

org.llm4s.trace.store

package org.llm4s.trace.store

Members list

Type members

Classlikes

class InMemoryTraceStore extends TraceStore[Id]

Thread-safe, in-process TraceStore[Id] backed by immutable maps.

Thread-safe, in-process TraceStore[Id] backed by immutable maps.

All operations are synchronous and never fail (F = cats.Id). Intended for testing and single-process observability. All state is lost when the JVM exits. Use InMemoryTraceStore() to construct.

Attributes

Companion
object
Supertypes
trait TraceStore[Id]
class Object
trait Matchable
class Any
object InMemoryTraceStore

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
final case class TracePage(traces: List[Trace], nextCursor: Option[String])

A single page of traces returned by TraceStore.queryTraces.

A single page of traces returned by TraceStore.queryTraces.

Value parameters

nextCursor

opaque token to pass as TraceQuery.cursor for the next page; None if this is the last page

traces

traces on this page, sorted by start time ascending

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
final case class TraceQuery(startTimeFrom: Option[Instant], startTimeTo: Option[Instant], status: Option[SpanStatus], metadata: Map[String, String], cursor: Option[String], limit: Int)

Filter and pagination parameters for TraceStore.queryTraces.

Filter and pagination parameters for TraceStore.queryTraces.

All filters are optional and combined with AND semantics. Use the companion object smart constructors for the common single-filter cases.

Value parameters

cursor

opaque pagination token from the previous TracePage

limit

maximum number of traces to return (default 50)

metadata

key/value pairs that must all be present in the trace metadata

startTimeFrom

inclusive lower bound on trace start time

startTimeTo

inclusive upper bound on trace start time

status

exact status match

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
object TraceQuery

Attributes

Companion
class
Supertypes
trait Product
trait Mirror
class Object
trait Matchable
class Any
Self type
TraceQuery.type
trait TraceStore[F[_]]

Pluggable backend for storing traces and their spans.

Pluggable backend for storing traces and their spans.

The effect type F[_] abstracts over the execution model:

  • InMemoryTraceStore uses cats.Id — synchronous, never fails.
  • Future backends (Postgres, Redis, …) can use IO, Future, or any effect that natively carries failure, without changing call sites.

Implementations must be thread-safe.

Type parameters

F

effect in which all operations are expressed; no typeclass bound is imposed — each implementation declares its own semantics (synchronous, async, etc.)

Attributes

Supertypes
class Object
trait Matchable
class Any
Known subtypes
Generated with