memory

type CognitiveMemory interface {
	Remember(ctx context.Context, ns Namespace, record CognitiveRecord) error
	Recall(ctx context.Context, ns Namespace, query string, limit int) ([]CognitiveRecord, error)
}

type CognitiveRecord struct {
	ID         string            `json:"id"`
	Content    string            `json:"content"`
	Scope      string            `json:"scope"`
	Categories []string          `json:"categories,omitempty"`
	Importance float64           `json:"importance"`
	CreatedAt  time.Time         `json:"created_at"`
	Metadata   map[string]string `json:"metadata,omitempty"`
}

type Entry struct {
	Key   string          `json:"key"`
	Value json.RawMessage `json:"value"`
}

type Namespace struct {
	RunID     string `json:"run_id,omitempty"`
	SessionID string `json:"session_id,omitempty"`
	Agent     string `json:"agent,omitempty"`
	Scope     Scope  `json:"scope"`
}

type RecallScore struct {
	Record CognitiveRecord
	Score  float64
}

type Repository interface {
	Get(ctx context.Context, ns Namespace, key string) (json.RawMessage, error)
	Set(ctx context.Context, ns Namespace, key string, value json.RawMessage) error
	Append(ctx context.Context, ns Namespace, key string, value json.RawMessage) error
	Delete(ctx context.Context, ns Namespace, key string) error
	// List returns all entries whose keys begin with prefix within the
	// namespace. An empty prefix matches all keys in the namespace.
	List(ctx context.Context, ns Namespace, prefix string) ([]Entry, error)
}

type Scope string