Add effort to Search Mode

[CShorten]

What's Changed

Adds an optional effort: Literal["low", "medium", "high"] parameter to Search Mode, available on both QueryAgent.search() and AsyncQueryAgent.search(). Higher effort may improve result quality at the expense of increased latency and cost. Defaults to None (no behavior change for existing callers).

qa.search(
  "Comparisons of Setwise and Listwise rerankers.", 
  effort="high"
)

The parameter is threaded through the searcher and stored on it, so it persists across pagination, response.next() sends the same effort value on every page. This follows the same pattern as the existing filtering and diversity_weight parameters.

Changes

• weaviate_agents/query/classes/request.py: add effort field to SearchModeRequestBase (included in both generation and execution requests)
• weaviate_agents/query/search.py: accept and store effort on _BaseQueryAgentSearcher, include it in request bodies
• weaviate_agents/query/query_agent.py: add effort parameter to sync and async search() with docstrings
• test/query_agent/test_query_model.py: tests for effort being sent, persisting across pagination, and defaulting to None

[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