telemetry

Documentation

Overview

Package telemetry provides a tiny JSONL emitter, turn-id context helpers, and startup-evaluated config for opt-in observability and artifacts directory resolution.

Index

• func CalibrationModeEnabled() bool
• func Emit(name string, fields map[string]any)
• func EmitLocalFeatures(ctx context.Context, user string)
• func ObserveEnabled() bool
• func PersistPayloadsEnabled() bool
• func TurnIDFromContext(ctx context.Context) (string, bool)
• func WithTurnID(ctx context.Context, id string) context.Context

Functions

func CalibrationModeEnabled

func CalibrationModeEnabled() bool

CalibrationModeEnabled reports whether calibration mode was enabled at startup.

func Emit

func Emit(name string, fields map[string]any)

Emit writes a single JSON line to .agent/events.jsonl when observation is enabled. It augments fields with RFC3339Nano time and the event name.

func EmitLocalFeatures

func EmitLocalFeatures(ctx context.Context, user string)

func ObserveEnabled

func ObserveEnabled() bool

ObserveEnabled reports whether JSONL emission was enabled at startup, considering calibration defaults.

func PersistPayloadsEnabled

func PersistPayloadsEnabled() bool

PersistPayloadsEnabled reports whether request and response payload persistence was enabled at startup.

func TurnIDFromContext

func TurnIDFromContext(ctx context.Context) (string, bool)

TurnIDFromContext returns the turn ID from ctx, if present. Returns "", false if the value is missing or not a non-empty string.

func WithTurnID

func WithTurnID(ctx context.Context, id string) context.Context

WithTurnID returns a child context that carries the provided turn ID. If ctx is nil, context.Background() is used