logging

Documentation

Overview

Package logging provides structured logging for AgentCTL using stdlib slog. Default level is Warn (silent in normal use). Enable debug with --debug flag or /debug command.

Index

• func Debug(msg string, args ...any)
• func Error(msg string, args ...any)
• func Info(msg string, args ...any)
• func Init(w io.Writer, debug bool)
• func InitWithFile(debug bool) func()
• func IsDebug() bool
• func LogDir() string
• func SessionID() string
• func SetDebug(on bool)
• func Span(op string, args ...any) func()
• func Warn(msg string, args ...any)

Functions

func Debug

func Debug(msg string, args ...any)

func Error

func Error(msg string, args ...any)

func Info

func Info(msg string, args ...any)

func Init

func Init(w io.Writer, debug bool)

Init configures the logger output and level.

func InitWithFile

func InitWithFile(debug bool) func()

InitWithFile sets up logging to both stderr and a log file. Returns a closer function. If file creation fails, logs to stderr only.

func IsDebug

func IsDebug() bool

IsDebug reports whether debug logging is active.

func LogDir

func LogDir() string

LogDir returns the log directory path.

func SessionID

func SessionID() string

SessionID generates a short unique session identifier.

func SetDebug

func SetDebug(on bool)

SetDebug toggles debug level at runtime (for /debug command).

func Span

func Span(op string, args ...any) func()

Span tracks the duration of an operation. Usage:

end := logging.Span("llm.stream", "model", model)
defer end()

func Warn

func Warn(msg string, args ...any)