knowledge

type AuditEntry struct {
	SessionKey string
	Action     string
	Actor      string
	Target     string
	Details    map[string]interface{}
}

type ContextItem struct {
	Layer    ContextLayer
	Key      string
	Content  string
	Score    float64
	Source   string
	Category string
}

type ContextLayer int

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

type ExternalRefEntry struct {
	Name     string
	RefType  string
	Location string
	Summary  string
	Metadata map[string]interface{}
}

type InquiryProvider interface {
	PendingInquiryItems(ctx context.Context, sessionKey string, limit int) ([]ContextItem, error)
}

type KnowledgeEntry struct {
	Key       string
	Category  entknowledge.Category
	Content   string
	Tags      []string
	Source    string
	Version   int       // 0 = unset (callers constructing entries don't set this)
	CreatedAt time.Time // zero = unset
	UpdatedAt time.Time // zero = unset; populated from DB on read
}

type LearningEntry struct {
	Trigger      string
	ErrorPattern string
	Diagnosis    string
	Fix          string
	Category     entlearning.Category
	Tags         []string
}

type LearningStats struct {
	TotalCount       int                          `json:"total_count"`
	ByCategory       map[entlearning.Category]int `json:"by_category"`
	AvgConfidence    float64                      `json:"avg_confidence"`
	OldestEntry      time.Time                    `json:"oldest_entry,omitempty"`
	NewestEntry      time.Time                    `json:"newest_entry,omitempty"`
	TotalOccurrences int                          `json:"total_occurrences"`
	TotalSuccesses   int                          `json:"total_successes"`
}

type RetrievalRequest struct {
	Query       string
	SessionKey  string
	Tags        []string
	Layers      []ContextLayer // nil means all layers
	MaxPerLayer int            // 0 uses config default
}

type RetrievalResult struct {
	Items      map[ContextLayer][]ContextItem
	TotalItems int
}

type RuntimeContext struct {
	SessionKey        string
	ChannelType       string // "telegram", "discord", "slack", "direct"
	ActiveToolCount   int
	EncryptionEnabled bool
	KnowledgeEnabled  bool
	MemoryEnabled     bool
}

type RuntimeContextProvider interface {
	GetRuntimeContext() RuntimeContext
}

type ScoredKnowledgeEntry struct {
	Entry        KnowledgeEntry
	Score        float64 // normalized: higher = better
	SearchSource string  // "fts5" or "like"
}

type ScoredLearningEntry struct {
	Entry        LearningEntry
	Score        float64 // normalized: higher = better
	SearchSource string  // "fts5" or "like"
}

type SkillInfo struct {
	Name        string
	Description string
	Type        string
}

type SkillProvider interface {
	ListActiveSkillInfos(ctx context.Context) ([]SkillInfo, error)
}

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

type ToolDescriptor struct {
	Name        string
	Description string
	Aliases     []string // alternate names for search (e.g. "ls" for "fs_list")
	Category    string   // semantic category from Capability (e.g. "filesystem")
	SearchHints []string // additional keywords for search ranking
}

type ToolRegistryProvider interface {
	ListTools() []ToolDescriptor
	SearchTools(query string, limit int) []ToolDescriptor
}