memory

type Config struct {
	// Memory is the memory backend implementation. Required.
	// Shipped backends: pkg/memory/weaviate and pkg/memory/pgvector.
	Memory interfaces.Memory

	// ScopeConfig resolves [interfaces.MemoryScope] from request context.
	ScopeConfig ScopeConfig

	// TTLPolicy sets ExpiresAt at Store time from record kind.
	TTLPolicy TTLPolicy

	// Store controls when and how memories are written.
	Store StoreConfig

	// Recall controls Load behavior when the SDK recalls memories for a run.
	Recall RecallConfig
}

type ExtractFunc func(ctx context.Context, messages []interfaces.Message) ([]interfaces.MemoryRecord, error)

type RecallConfig struct {
	// Enabled recalls memories automatically for each run when true (default).
	// When false the SDK still stores memories after each run but skips Load.
	Enabled bool

	// Limit is the maximum number of memories to load. Zero or negative defaults to [defaultRecallLimit].
	Limit int

	// MinScore filters out entries below this relevance score when Score is applicable.
	MinScore float32

	// Kinds restricts recall to these kinds. Empty means all kinds.
	Kinds []interfaces.MemoryKind
}

type ScopeConfig struct {
	TenantIDResolver ScopeResolver
	UserIDResolver   ScopeResolver
	AgentIDResolver  ScopeResolver

	// ExtraKeys lists tag keys always resolved on Store/Load/Clear (e.g. "project_id", "env").
	// Each key must have a matching entry in TagResolvers.
	ExtraKeys []string

	// TagResolvers supplies values for [ExtraKeys].
	TagResolvers map[string]ScopeResolver
}

type ScopeResolver func(ctx context.Context) string

type StoreConfig struct {
	// Mode controls when memories are written. Default [StoreModeOnDemand].
	Mode StoreMode

	// DedupMinScore is the semantic similarity floor for upserting an existing memory instead of appending.
	// Zero defaults to [defaultDedupMinScore].
	DedupMinScore float32

	// Extract overrides run-end memory extraction when [Mode] is [StoreModeAlways].
	// Must be nil when [Mode] is [StoreModeOnDemand].
	Extract ExtractFunc

	// DefaultKind is used when the record kind is empty. Zero defaults to [KindNote].
	DefaultKind interfaces.MemoryKind

	// AllowedKinds restricts stored kinds when non-empty.
	AllowedKinds []interfaces.MemoryKind
}

type StoreMode string

type TTLPolicy map[interfaces.MemoryKind]time.Duration