StaticInstanceGet the singleton instance of RerankerService
Clear the reranker cache. Useful for testing or when models are updated.
The Global Object Store is a place to store global objects that need to be shared across the application. Depending on the execution environment, this could be the window object in a browser, or the global object in a node environment, or something else in other contexts. The key here is that in some cases static variables are not truly shared because it is possible that a given class might have copies of its code in multiple paths in a deployed application. This approach ensures that no matter how many code copies might exist, there is only one instance of the object in question by using the Global Object Store.
Get or create a reranker instance for the specified model. Caches instances for reuse across multiple calls.
ID of the AIModel with type='Reranker'
User context for operations
OptionalpromptID: stringOptional prompt ID for LLM-based rerankers
Reranker instance or null if unavailable
Parse RerankerConfiguration JSON from agent settings. Returns null if configuration is missing or invalid.
JSON string from AIAgent.RerankerConfiguration
Parsed configuration with defaults applied, or null if disabled/invalid
Rerank notes using the configured reranker. Implements two-stage retrieval for semantic relevance ranking.
IMPORTANT: This service does NOT handle fallback logic. If reranking fails, this method throws an error. The calling code (agent class) is responsible for deciding whether to fall back to original vector search results.
Vector search results to rerank
User query for relevance scoring
Reranker configuration from agent
User context for operations
Optionaloptions: RerankObservabilityOptionsOptional observability parameters
Reranked notes sorted by relevance
Protected StaticgetReturns the singleton instance of the class. If the instance does not exist, it is created and stored in the Global Object Store. If className is provided it will be used as part of the key in the Global Object Store, otherwise the actual class name will be used. NOTE: the class name used by default is the lowest level of the object hierarchy, so if you have a class that extends another class, the lowest level class name will be used.
OptionalclassName: string
Service for managing reranker instances and performing note reranking. Implements singleton pattern for efficient reranker caching.
Key responsibilities:
Usage: