core

type AddOptions struct {
	ClassifyOptions
	DefaultSensitive bool // from config — used when IsSensitive is not explicitly set
}

type ClassifyOptions struct {
	Category    string   // explicit category; empty = auto-detect
	Tags        []string // explicit tags; nil = auto-detect
	IsSensitive *bool    // explicit sensitivity; nil = auto-detect
}

type Container struct {
	Notes  *NoteService
	Search *SearchService
	DB     db.Adapter
}

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

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

type SearchOptions struct {
	TopK     int
	Category string
	Tags     []string

	// IsSensitive optionally restricts results by the sensitive flag.
	// nil = no filter (default); pointer to false = exclude sensitive
	// notes from results before they reach the LLM. Used by the MCP
	// server to prevent sensitive notes leaking to the calling agent.
	IsSensitive *bool

	// MaxDistance is the L2-distance ceiling for keeping a candidate note.
	//
	//   = 0  →  use the service default (typically 1.0)
	//   > 0  →  keep notes with Distance <= MaxDistance
	//   < 0  →  disable filtering entirely (return whatever the DB returned)
	//
	// The "= 0 means default" overload means an *exact* 0 threshold cannot be
	// expressed via this field. In practice this is fine: with L2-normalised
	// embeddings, bit-exact distance 0 implies bit-identical content, which is
	// not a useful retrieval target.
	MaxDistance float32

	// OnStep is an optional progress hook invoked at the start of each
	// pipeline phase ("embedding", "searching", "answering"). Used by the
	// CLI to update a spinner label. Must be cheap and non-blocking.
	OnStep func(step string)
}

type SearchResult struct {
	Answer string
	Notes  []*model.Note
}

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

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