agent

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

type AudioConfig struct {
	// SampleRate in Hz (default: 48000)
	SampleRate int
	// Channels: 1 = mono, 2 = stereo (default: 1)
	Channels int
	// FrameDuration for audio frames (default: 20ms)
	FrameDuration time.Duration
	// TrackName for the published audio track
	TrackName string
}

type AudioFrame struct {
	ParticipantID   string
	ParticipantName string
	Data            []byte // PCM16 little-endian
	SampleRate      int
	Channels        int
	Timestamp       time.Time
	SequenceNumber  uint64
}

type AudioWriter interface {
	// Write writes PCM16 little-endian audio data.
	Write(data []byte) (int, error)
	// Close stops the audio writer.
	Close() error
}

type ConnectionState string

type DataMessage struct {
	Topic          string
	Payload        []byte
	From           *participant.Participant
	DestinationIDs []string
	Reliable       bool
	Timestamp      time.Time
}

type ImageConfig struct {
	// Path to the image file (PNG, JPEG, etc.)
	// Requires CGO for runtime encoding. For no-CGO deployment, use H264Path.
	Path string
	// Data is raw image data (alternative to Path)
	// Requires CGO for runtime encoding. For no-CGO deployment, use H264Data.
	Data []byte

	// H264Path is the path to a pre-encoded H.264 keyframe file.
	// Use the encode-avatar tool to create this file.
	// This is the recommended approach - no CGO required at runtime.
	H264Path string
	// H264Data is pre-encoded H.264 keyframe data (alternative to H264Path).
	// Use the encode-avatar tool to create this data.
	H264Data []byte

	// Width to resize to (0 = use original). Only used with Path/Data.
	Width int
	// Height to resize to (0 = use original). Only used with Path/Data.
	Height int
	// FrameRate for the static image video track (default: 1)
	// Lower values use less bandwidth for static content.
	FrameRate int
	// TrackName for the published video track
	TrackName string
}

type ImageWriter interface {
	// UpdateImage updates the image being published.
	UpdateImage(data []byte) error
	// Close stops the image writer.
	Close() error
}

type MediaMode string

type Options struct {
	// LiveKit connection settings
	APIKey    string
	APISecret string
	ServerURL string

	// Agent identity
	Name     string // Display name in the meeting
	Identity string // Unique identity (defaults to generated UUID)
	Metadata map[string]string

	// Media mode selection
	MediaMode MediaMode // Defaults to AudioOnly

	// Audio configuration
	Audio AudioConfig

	// Video configuration (for AudioWithVideo mode)
	Video VideoConfig

	// Image configuration (for AudioWithImage mode)
	Image ImageConfig

	// Behavior
	AutoSubscribe bool // Auto-subscribe to all tracks (default: true)
}

type VideoConfig struct {
	// Width in pixels (default: 640)
	Width int
	// Height in pixels (default: 480)
	Height int
	// FrameRate in fps (default: 30)
	FrameRate int
	// Codec: "vp8" or "h264" (default: "vp8")
	Codec string
	// Bitrate in bps (default: auto)
	Bitrate int
	// TrackName for the published video track
	TrackName string
}

type VideoFrame struct {
	// Data contains encoded video data (VP8 or H264 depending on codec).
	Data []byte
	// Width of the frame in pixels.
	Width int
	// Height of the frame in pixels.
	Height int
	// Timestamp of the frame.
	Timestamp time.Time
	// Keyframe indicates if this is a keyframe.
	Keyframe bool
}

type VideoWriter interface {
	// WriteFrame writes a video frame.
	WriteFrame(frame VideoFrame) error
	// Close stops the video writer.
	Close() error
}