telemetry

type ChatMessage struct {
	Role  string
	Parts []MessagePart
}

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

type ChatStart struct {
	ModelCallID string
	Model       string
	// Provider 是 gen_ai.provider.name；经网关或兼容接口访问时表示协议家族而非实际厂商。
	Provider string
	// Purpose 是 ChatPurposeConversation 或 ChatPurposeCompact。
	Purpose string
	// ServerAddress 与 ServerPort 是模型服务的主机与端口；地址为空时两者都不写。
	ServerAddress string
	ServerPort    int
	// Compacted 本次请求的上下文是否以摘要开头？是时记 gen_ai.conversation.compacted=true。
	Compacted bool
	// TokenModality 是 token 计数器的模态：TokenModalityText 或 TokenModalityUnknown；空值按 unknown 记录。
	TokenModality string
}

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

type ExecuteToolStart struct {
	Name   string
	CallID string
	// Description 是工具定义中的描述；为空时不写。
	Description string
}

type InvokeAgentEnd struct {
	Status  string
	Err     error
	Summary TurnSummary
}

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

type InvokeAgentStart struct {
	AgentName        string
	AgentDescription string
	// Model 是 Agent 配置的主模型。
	Model  string
	TurnID string
}

type MessagePart struct {
	Type    string
	Content string
	ID      string
	Name    string
	// Arguments 是工具调用参数，Response 是工具结果：能解析为 JSON 时为解析结果，否则为原文字符串；为 nil 时不写出。
	Arguments any
	Response  any
	Modality  string
	MimeType  string
	URI       string
}

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

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

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

type TelemetryOpt struct {
	TracerProvider trace.TracerProvider
	MeterProvider  metric.MeterProvider
	Logger         *slog.Logger
	// CaptureContent 是否把对话内容写入 span 属性？NewTelemetryOpt 默认开启，与配置默认值一致。
	CaptureContent bool
}

type TurnSummary struct {
	// Steps 是普通模型调用次数。
	Steps int
	// InferenceCalls 是全部模型调用次数，含压缩调用。
	InferenceCalls int
	// ToolCalls 是收到结果的工具调用次数，FailedToolCalls 是其中带错误的次数。
	ToolCalls       int
	FailedToolCalls int
	// Usage 是全部模型调用的 token 合计。
	Usage defs.TokenUsage
	// FinishReason 是最后一次普通模型调用的结束原因（已归一）。
	FinishReason string
	// Output 是本轮最后一条助手消息；内容采集关闭时为空。
	Output []ChatMessage
}