reflection

type Evaluation struct {
	Strengths     []string               `json:"strengths"`
	Weaknesses    []string               `json:"weaknesses"`
	Opportunities []string               `json:"opportunities"`
	Threats       []string               `json:"threats"`
	Score         float64                `json:"score"` // 0-1
	Details       map[string]interface{} `json:"details,omitempty"`
}

type Experience struct {
	ID          string                 `json:"id"`
	Description string                 `json:"description"`
	Input       interface{}            `json:"input"`
	Output      interface{}            `json:"output"`
	Success     bool                   `json:"success"`
	Duration    time.Duration          `json:"duration"`
	Error       string                 `json:"error,omitempty"`
	Context     map[string]interface{} `json:"context,omitempty"`
	Timestamp   time.Time              `json:"timestamp"`
}

type Improvement struct {
	Description   string                 `json:"description"`
	Priority      int                    `json:"priority"` // 1-5
	Impact        float64                `json:"impact"`   // Expected impact 0-1
	Effort        float64                `json:"effort"`   // Required effort 0-1
	ActionItems   []string               `json:"action_items"`
	Prerequisites []string               `json:"prerequisites,omitempty"`
	Metadata      map[string]interface{} `json:"metadata,omitempty"`
}

type Insight struct {
	Description string    `json:"description"`
	Category    string    `json:"category"`
	Importance  float64   `json:"importance"` // 0-1
	Evidence    []string  `json:"evidence,omitempty"`
	Timestamp   time.Time `json:"timestamp"`
}

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

type LearningPoint struct {
	Lesson        string    `json:"lesson"`
	Context       string    `json:"context"`
	Category      string    `json:"category"`
	Applicability float64   `json:"applicability"` // How widely applicable 0-1
	Confidence    float64   `json:"confidence"`    // Confidence in the learning 0-1
	Examples      []string  `json:"examples,omitempty"`
	Timestamp     time.Time `json:"timestamp"`
}

type PerformanceMetrics struct {
	SuccessRate     float64                `json:"success_rate"`
	AverageTime     time.Duration          `json:"average_time"`
	ErrorRate       float64                `json:"error_rate"`
	TotalExecutions int                    `json:"total_executions"`
	ResourceUsage   map[string]float64     `json:"resource_usage"`
	CustomMetrics   map[string]interface{} `json:"custom_metrics,omitempty"`
}

type ReflectionMetrics struct {
	TotalReflections       int                      `json:"total_reflections"`
	AverageScore           float64                  `json:"average_score"`
	ImprovementRate        float64                  `json:"improvement_rate"`
	LearningsGenerated     int                      `json:"learnings_generated"`
	LearningsApplied       int                      `json:"learnings_applied"`
	SuccessfulApplications int                      `json:"successful_applications"`
	CategoryPerformance    map[string]float64       `json:"category_performance"`
	TimeMetrics            map[string]time.Duration `json:"time_metrics"`
	// contains filtered or unexported fields
}

type ReflectionOption func(*SelfReflectiveAgent)

type ReflectionResult struct {
	ID               string                 `json:"id"`
	Type             ReflectionType         `json:"type"`
	Subject          string                 `json:"subject"`
	Timestamp        time.Time              `json:"timestamp"`
	Evaluation       *Evaluation            `json:"evaluation"`
	Insights         []Insight              `json:"insights"`
	Improvements     []Improvement          `json:"improvements"`
	LearningPoints   []LearningPoint        `json:"learning_points"`
	PerformanceScore float64                `json:"performance_score"`
	Confidence       float64                `json:"confidence"`
	Metadata         map[string]interface{} `json:"metadata,omitempty"`
}

type ReflectionType string

type ReflectiveAgent interface {
	core.Agent

	// Reflect performs self-reflection
	Reflect(ctx context.Context, subject interface{}) (*ReflectionResult, error)

	// EvaluatePerformance evaluates recent performance
	EvaluatePerformance(ctx context.Context, metrics PerformanceMetrics) (*Evaluation, error)

	// ExtractLearnings extracts learnings from experiences
	ExtractLearnings(ctx context.Context, experiences []Experience) ([]LearningPoint, error)

	// GenerateImprovements generates improvement suggestions
	GenerateImprovements(ctx context.Context, evaluation *Evaluation) ([]Improvement, error)

	// ApplyLearnings applies learnings to improve behavior
	ApplyLearnings(ctx context.Context, learnings []LearningPoint) error
}

type SelfReflectiveAgent struct {
	*core.BaseAgent
	// contains filtered or unexported fields
}