tracing

type Config struct {
	// ServiceName labels the traces; defaults to "jargo".
	ServiceName string
	// ServiceVersion is an optional version label.
	ServiceVersion string
	// Endpoint overrides the OTLP HTTP endpoint (host:port). Empty honors the
	// standard OTEL_EXPORTER_OTLP_ENDPOINT environment variable.
	Endpoint string
	// Insecure sends over plain HTTP instead of HTTPS.
	Insecure bool
	// SampleRatio is the head-sampling ratio in (0,1]. Zero (or less) always
	// samples — jargo traces are low-volume, one trace per session.
	SampleRatio float64
}

type GeminiLiveAttributes struct {
	// Model is the model identifier the session runs against.
	Model string
	// Operation names what the span covers (setup, a response, a tool call).
	Operation string
	// VoiceID is the voice the model speaks in. Empty leaves the attribute off.
	VoiceID string
	// Language is the language of the session. Empty leaves the attribute off.
	Language string
	// Modalities are the response modalities configured. Empty leaves the
	// attribute off.
	Modalities string
	// Tools are the names of the tools offered, one entry per tool. A tool with
	// no name contributes to the count but not to the names.
	Tools []string
	// ToolsSerialized is the full tool definitions. Empty leaves them off.
	ToolsSerialized string
	// Transcript is speech transcribed this operation. Empty leaves it off.
	Transcript string
	// TranscriptIsInput reports whether the transcript is the user's speech
	// rather than the model's. Nil leaves the attribute off.
	TranscriptIsInput *bool
	// TextOutput is text the model produced. Empty leaves the attribute off.
	TextOutput string
	// AudioDataSize is the size of the audio payload in bytes. Nil leaves the
	// attribute off.
	AudioDataSize *int
	// Settings are the session settings, recorded under settings.*. A grouped
	// setting is expanded one level.
	Settings map[string]any
	// Extra are additional attributes, written last so they override.
	Extra map[string]any
}

type LLMAttributes struct {
	// Service is the generating service's name, which the provider name is
	// derived from.
	Service string
	// Model is the model identifier that answered.
	Model string
	// Stream reports whether the generation streamed. It is always recorded.
	Stream bool
	// Messages is the serialized conversation sent to the model. Empty leaves
	// the attribute off.
	Messages string
	// Output is the model's reply text. Empty leaves the attribute off.
	Output string
	// Tools is the serialized tool configuration. Empty leaves the attribute
	// off.
	Tools string
	// ToolCount is how many tools were offered. Nil leaves the attribute off.
	ToolCount *int
	// ToolChoice is how the model was told to choose among them. Empty leaves
	// the attribute off.
	ToolChoice string
	// SystemInstructions is the system prompt in force. Empty leaves the
	// attribute off.
	SystemInstructions string
	// TTFB is the time to first byte in seconds. Nil leaves the attribute off.
	TTFB *float64
	// Parameters are the generation parameters. The ones the conventions name
	// are recorded under gen_ai.request.*, the rest under param.*.
	Parameters map[string]any
	// ExtraParameters are provider-specific parameters, recorded under extra.*.
	ExtraParameters map[string]any
	// Extra are additional attributes, written last so they override.
	Extra map[string]any
}

type OpenAIRealtimeAttributes struct {
	// Model is the model identifier the session runs against.
	Model string
	// Operation names what the span covers (setup, a request, a response).
	Operation string
	// SessionProperties are the session configuration, recorded under session.*.
	// A grouped property is expanded one level.
	SessionProperties map[string]any
	// Transcript is speech transcribed this operation. Empty leaves it off.
	Transcript string
	// TranscriptIsInput reports whether the transcript is the user's speech
	// rather than the model's. Nil leaves the attribute off.
	TranscriptIsInput *bool
	// ContextMessages is the serialized conversation sent to the model, recorded
	// as the span's input. Empty leaves the attribute off.
	ContextMessages string
	// Tools are the names of the tools offered, one entry per tool.
	Tools []string
	// ToolsSerialized is the full tool definitions. Empty leaves them off.
	ToolsSerialized string
	// FunctionCalls are the names of the calls the model requested, in the order
	// it requested them.
	FunctionCalls []string
	// AudioDataSize is the size of the audio payload in bytes. Nil leaves the
	// attribute off.
	AudioDataSize *int
	// Extra are additional attributes, written last so they override.
	Extra map[string]any
}

type STTAttributes struct {
	// Service is the transcribing service's name, which the provider name is
	// derived from.
	Service string
	// Model is the model identifier the transcription ran against.
	Model string
	// OperationName names the operation; empty means "stt".
	OperationName string
	// Transcript is the text transcribed. Empty leaves the attribute off.
	Transcript string
	// Final reports whether the transcript is the finalized one. Nil leaves the
	// attribute off.
	Final *bool
	// Language is the language transcribed. Empty leaves the attribute off.
	Language string
	// UserID names whose speech was transcribed. Empty leaves the attribute off.
	UserID string
	// VADEnabled reports whether voice activity detection is in use. It is
	// always recorded.
	VADEnabled bool
	// TTFB is the time to first byte in seconds. Nil leaves the attribute off.
	TTFB *float64
	// Settings are the service settings the caller gave, recorded under
	// settings.*.
	Settings map[string]any
	// Extra are additional attributes, written last so they override.
	Extra map[string]any
}

type TTSAttributes struct {
	// Service is the synthesizing service's name, which the provider name is
	// derived from.
	Service string
	// Model is the model identifier the synthesis ran against.
	Model string
	// VoiceID is the voice spoken in.
	VoiceID string
	// Text is what was synthesized. Empty leaves the attribute off.
	Text string
	// OperationName names the operation; empty means "tts".
	OperationName string
	// CharacterCount is how many characters were synthesized. Nil leaves the
	// attribute off; zero is recorded.
	CharacterCount *int
	// TTFB is the time to first byte in seconds. Nil leaves the attribute off.
	TTFB *float64
	// Settings are the service settings the caller gave, recorded under
	// settings.*.
	Settings map[string]any
	// Extra are additional attributes, written last so they override.
	Extra map[string]any
}

type TracingContext struct {
	// contains filtered or unexported fields
}