Add retrieval_strategy argument to Search Mode

[CShorten]

Description

Adds a retrieval_strategy parameter to the Query Agent's Search Mode. This allows users to control the trade-off between recall and precision.

The parameter accepts two values: "recall" to optimize for finding all relevant results, or "precision"` to optimize for the accuracy of returned results.

Usage example:

agent = QueryAgent(
  client=client, 
  collections=["FinancialContracts"]
)
                                                                                
# Default behavior (recall) 
results = agent.search("Find all NDAs signed by Jane Doe in 2024.")           
                                                                                
# Optimize for precision
results = agent.search(
  "Find all NDAs signed by Jane Doe in 2024.",
  retrieval_strategy="precision"
)

Pagination Fix

Empty search lists are cached from precision mode's ability to output no searches, ensuring pagination requests are consistent.

[orca-security-eu]

Orca Security Scan Summary

Status	Check	Issues by priority
Passed	Infrastructure as Code	0   0   0   0	View in Orca
Passed	SAST	0   0   0   0	View in Orca
Passed	Secrets	0   0   0   0	View in Orca
Passed	Vulnerabilities	0   0   0   0	View in Orca