memory

type CompactableContext interface {
	ContextManager

	// Compact summarizes older messages to reduce token count.
	// The LLM is used to generate summaries.
	Compact(l llm.LLM) error

	// NeedsCompaction returns true if the context exceeds the threshold.
	NeedsCompaction(threshold int) bool
}

type ContextManager interface {
	// Add appends a message to the context
	Add(msg llm.Message)

	// Messages returns messages that fit within maxTokens
	Messages(maxTokens int) []llm.Message

	// Clear resets the context
	Clear()

	// TokenCount returns current token usage
	TokenCount() int
}

type Memory interface {
	// Store saves a value with a key
	Store(key string, value any, metadata map[string]any) error

	// Retrieve performs semantic search and returns top-k results
	Retrieve(query string, k int) ([]MemoryItem, error)

	// Get retrieves a specific item by key
	Get(key string) (MemoryItem, error)

	// Delete removes an item
	Delete(key string) error
}

type MemoryItem struct {
	Key       string
	Value     any
	Metadata  map[string]any
	CreatedAt time.Time
	UpdatedAt time.Time
	Score     float64 // Relevance score for Retrieve
}

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

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