agents

type Agent struct {
	Name                  string
	Role                  string
	Goals                 []string
	Backstory             string
	KnowledgeSources      []KnowledgeSource
	Memory                *memory.BaseMemory
	Tools                 []core.Tool
	LLMProvider           core.LLMProvider
	Executor              *core.Executor
	Config                *AgentConfig
	Capabilities          *AgentCapabilities
	TaskMonitor           *TaskMonitor
	Priority              tasks.TaskPriority
	MaxWorkload           int
	CurrentTasks          int
	Performance           map[string]float64
	DelegationPrefs       *DelegationPreference
	CollaborationScore    float64
	SupervisionNeeded     bool
	LastCollaborators     []string
	SuccessfulDelegations int
	FailedDelegations     int

	PriorityQueue    *PriorityQueue
	PriorityStrategy string
	PriorityWeights  map[string]float64 // Weights for different priority factors

	DelegationStats    *DelegationStats
	DelegationHistory  []DelegationResult
	PreferredDelegates map[string]float64 // Agent ID -> success rate

	FeedbackMetrics   *FeedbackMetrics
	LearningRate      float64
	AdaptationHistory []string
	// contains filtered or unexported fields
}

type AgentCapabilities struct {
	Capabilities       map[capabilities.Capability]capabilities.CapabilityLevel
	Priority           int
	MaxConcurrentTasks int
	CurrentTasks       int
}

type AgentConfig struct {
	AllowDelegation    bool
	AllowCodeExecution bool
	CodeExecutionMode  string // "safe" or "unsafe"
	Multimodal         bool
	MaxRetryLimit      int
}

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

type AgentOption func(*Agent)

type AssignedTaskPriority struct {
	Priority     tasks.TaskPriority
	Deadline     time.Time
	Importance   float64
	Urgency      float64
	Dependencies []string
}

type CapabilityMatch struct {
	Score   float64
	Reasons []string
}

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

type DelegationPreference struct {
	PreferredTypes    []DelegationType
	CollaborationTags []string
	SupervisorRoles   []string
	ExcludedTasks     []string
}

type DelegationResult struct {
	Success      bool
	AgentID      string
	TaskID       string
	ErrorMessage string
	Feedback     string
}

type DelegationStats struct {
	TotalDelegations      int
	SuccessfulDelegations int
	FailedDelegations     int
	AverageSuccessRate    float64
	PreferredAgents       map[string]int
	TaskTypes             map[string]int
}

type DelegationType string

type Experience struct {
	// ID uniquely identifies this experience
	ID string

	// AgentID identifies the agent that had the experience
	AgentID string

	// TaskID identifies the related task if any
	TaskID string

	// Capability is the capability being learned/improved
	Capability capabilities.Capability

	// Outcome describes what happened
	Outcome string

	// Confidence indicates certainty level (0-1)
	Confidence float64

	// Metadata contains additional context
	Metadata map[string]interface{}

	// Timestamp when experience occurred
	Timestamp time.Time
}

type FeedbackMetrics struct {
	TasksCompleted        int
	TasksFailed           int
	AverageCompletionTime time.Duration
	SuccessRate           float64
	TaskTypePerformance   map[string]float64
	CapabilityScores      map[capabilities.Capability]float64
	RecentFeedback        []string
}

type KnowledgeSource struct {
	Content  string
	Metadata map[string]interface{}
}

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

type LearningConfig struct {
	// Strategy determines the learning approach
	Strategy LearningStrategy

	// EnableExperienceSharing allows sharing experiences between agents
	EnableExperienceSharing bool

	// MinConfidenceThreshold is minimum confidence needed to apply learning
	MinConfidenceThreshold float64

	// MaxExperienceAge is how long to retain experiences
	MaxExperienceAge time.Duration

	// MemoryScope determines visibility of learned experiences
	MemoryScope memory.MemoryScope
}

type LearningMetrics struct {
	// ExperienceCount is total number of experiences
	ExperienceCount int

	// SuccessRate is ratio of successful outcomes
	SuccessRate float64

	// ConfidenceAvg is average confidence across experiences
	ConfidenceAvg float64

	// CapabilityLevels maps capabilities to current levels
	CapabilityLevels map[capabilities.Capability]float64

	// LastUpdated indicates when metrics were last updated
	LastUpdated time.Time
}

type LearningStrategy string

type LearningSystem struct {
	// Config contains learning settings
	Config *LearningConfig

	// Metrics tracks learning progress
	Metrics *LearningMetrics
	// contains filtered or unexported fields
}

type Message struct {
	ID          string
	Type        MessageType
	FromAgent   string
	ToAgent     string // Empty for broadcast
	Content     string
	Context     map[string]interface{}
	Priority    int
	Timestamp   time.Time
	ExpiresAt   *time.Time
	RequiresAck bool
	Acked       bool
	// Sequence number for ordered delivery
	Sequence uint64
}

type MessageStatus struct {
	Attempts     int
	LastAttempt  time.Time
	NextAttempt  time.Time
	Status       string
	ErrorHistory []error
}

type MessageType string

type PriorityQueue struct {
	Tasks    []*tasks.Task
	Capacity int
	Strategy string // "fifo", "deadline", "importance", "balanced"
}

type ProtocolConfig struct {
	MaxRetries      int
	RetryBackoff    time.Duration
	MaxBackoff      time.Duration
	DeliveryTimeout time.Duration
}

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

type ProtocolType string

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

type TaskProgress struct {
	TaskID       string
	AgentID      string
	Status       string
	Progress     float64
	Messages     []string
	StartTime    time.Time
	EndTime      *time.Time
	Requirements *capabilities.TaskRequirements
}