> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentium.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Reranking

> Public reranking signatures and configuration in @agentium/core 4.0.0.

Import these **12 exports** from `@agentium/core`. Read the [reranking guide](/features/reranking) for setup and behavior, or return to the [package reference](/api-reference/core).

A `?` marks an optional field. These are declarations for lookup; run the examples in the linked guide. Follow related-type links for Agentium types and source links for imported dependency types.

## CohereReranker

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/providers/cohere.ts)

```typescript theme={null}
/**
 * Cohere reranker. Requires the `cohere-ai` package as an optional peer dependency.
 *
 * Pricing/availability docs: https://docs.cohere.com/reference/rerank
 */
export declare class CohereReranker implements Reranker {
    readonly providerId = "cohere";
    constructor(config?: CohereRerankerConfig);
    rerank(query: string, documents: RerankDocument[], options?: RerankOptions): Promise<RerankResult[]>;
}
```

Related: [`CohereRerankerConfig`](/api-reference/core/rerank#coherererankerconfig), [`RerankDocument`](/api-reference/core/rerank#rerankdocument), [`Reranker`](/api-reference/core/rerank#reranker), [`RerankOptions`](/api-reference/core/rerank#rerankoptions), [`RerankResult`](/api-reference/core/rerank#rerankresult).

## CohereRerankerConfig

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/providers/cohere.ts)

```typescript theme={null}
export interface CohereRerankerConfig {
    apiKey?: string;
    /** Cohere rerank model. Defaults to `rerank-v3.5`. */
    model?: string;
}
```

## CrossEncoderReranker

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/providers/cross-encoder-reranker.ts)

```typescript theme={null}
/** Local cross-encoder via the optional @huggingface/transformers package.
 * Scores paired query/document sequences using sequence-classification logits. */
export declare class CrossEncoderReranker implements Reranker {
    readonly providerId = "cross-encoder-local";
    constructor(config?: CrossEncoderRerankerConfig);
    ready(): Promise<void>;
    rerank(query: string, documents: RerankDocument[], options?: RerankOptions): Promise<RerankResult[]>;
}
```

Related: [`CrossEncoderRerankerConfig`](/api-reference/core/rerank#crossencoderrerankerconfig), [`RerankDocument`](/api-reference/core/rerank#rerankdocument), [`Reranker`](/api-reference/core/rerank#reranker), [`RerankOptions`](/api-reference/core/rerank#rerankoptions), [`RerankResult`](/api-reference/core/rerank#rerankresult).

## CrossEncoderRerankerConfig

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/providers/cross-encoder-reranker.ts)

```typescript theme={null}
export interface CrossEncoderRerankerConfig {
    /** Model ID or local artifact directory. This adapter is a cross-encoder, not ColBERT late interaction. */
    model?: string;
    prewarm?: boolean;
    /** Defaults true: ordinary calls never silently download model weights. */
    localFilesOnly?: boolean;
    cacheDir?: string;
    dtype?: "fp32" | "fp16" | "q8" | "q4";
    /** Required when a classifier returns multiple labels; defaults LABEL_1. */
    positiveLabel?: string;
    /** Host-owned loader for custom devices, artifact stores and deterministic tests. */
    pipelineFactory?: (task: "text-classification", model: string, options: {
        local_files_only: boolean;
        cache_dir?: string;
        dtype?: string;
    }) => Promise<CrossEncoderPipeline>;
}
```

## JinaReranker

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/providers/jina.ts)

```typescript theme={null}
/**
 * Jina AI reranker. Uses Jina's HTTPS API directly (no SDK required).
 *
 * Docs: https://jina.ai/reranker
 */
export declare class JinaReranker implements Reranker {
    readonly providerId = "jina";
    constructor(config?: JinaRerankerConfig);
    rerank(query: string, documents: RerankDocument[], options?: RerankOptions): Promise<RerankResult[]>;
}
```

Related: [`JinaRerankerConfig`](/api-reference/core/rerank#jinarerankerconfig), [`RerankDocument`](/api-reference/core/rerank#rerankdocument), [`Reranker`](/api-reference/core/rerank#reranker), [`RerankOptions`](/api-reference/core/rerank#rerankoptions), [`RerankResult`](/api-reference/core/rerank#rerankresult).

## JinaRerankerConfig

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/providers/jina.ts)

```typescript theme={null}
export interface JinaRerankerConfig {
    apiKey?: string;
    /** Jina rerank model. Defaults to `jina-reranker-v2-base-multilingual`. */
    model?: string;
    /** Optional override for the Jina base URL. */
    baseURL?: string;
}
```

## RerankDocument

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/types.ts)

```typescript theme={null}
/**
 * Document input for reranking.
 * Accepts either a plain string, a `VectorSearchResult`-like object, or any shape
 * with a textual `content` field.
 */
export type RerankDocument = string | {
    id?: string;
    content: string;
    metadata?: Record<string, unknown>;
};
```

## Reranker

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/types.ts)

```typescript theme={null}
export interface Reranker {
    /** Name of the provider/model (for logging). */
    readonly providerId: string;
    /**
     * Reorder documents by relevance to a query.
     * Returns results sorted by score descending.
     */
    rerank(query: string, documents: RerankDocument[], options?: RerankOptions): Promise<RerankResult[]>;
}
```

Related: [`RerankDocument`](/api-reference/core/rerank#rerankdocument), [`RerankOptions`](/api-reference/core/rerank#rerankoptions), [`RerankResult`](/api-reference/core/rerank#rerankresult).

## RerankOptions

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/types.ts)

```typescript theme={null}
export interface RerankOptions {
    /** Maximum number of results to return. If undefined, returns all reranked. */
    topK?: number;
    /** Minimum score threshold; results below this are dropped. */
    minScore?: number;
}
```

## RerankResult

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/types.ts)

```typescript theme={null}
export interface RerankResult {
    /** Original index in the input array (useful when callers want to keep their own metadata). */
    index: number;
    /** Relevance score from the reranker. Higher is more relevant. */
    score: number;
    /** Document content as fed to the reranker. */
    content: string;
    /** Original metadata, if the input was an object. */
    metadata?: Record<string, unknown>;
    /** Original id, if the input was an object. */
    id?: string;
}
```

## VoyageReranker

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/providers/voyage.ts)

```typescript theme={null}
/**
 * Voyage AI reranker. Uses Voyage's HTTPS API directly (no SDK required).
 *
 * Docs: https://docs.voyageai.com/reference/reranker-api
 */
export declare class VoyageReranker implements Reranker {
    readonly providerId = "voyage";
    constructor(config?: VoyageRerankerConfig);
    rerank(query: string, documents: RerankDocument[], options?: RerankOptions): Promise<RerankResult[]>;
}
```

Related: [`RerankDocument`](/api-reference/core/rerank#rerankdocument), [`Reranker`](/api-reference/core/rerank#reranker), [`RerankOptions`](/api-reference/core/rerank#rerankoptions), [`RerankResult`](/api-reference/core/rerank#rerankresult), [`VoyageRerankerConfig`](/api-reference/core/rerank#voyagererankerconfig).

## VoyageRerankerConfig

[Source](https://github.com/agentiumOS/agentium/blob/v4.0.0/packages/core/src/rerank/providers/voyage.ts)

```typescript theme={null}
export interface VoyageRerankerConfig {
    apiKey?: string;
    /** Voyage rerank model. Defaults to `rerank-2`. */
    model?: string;
    /** Optional override for the Voyage base URL. */
    baseURL?: string;
}
```

## Supporting types

These local shapes appear in public signatures but are not named exports of this entrypoint.

### CrossEncoderPipeline

```typescript theme={null}
export type CrossEncoderPipeline = (input: {
    text: string;
    text_pair: string;
}, options: {
    top_k: null;
    function_to_apply: "sigmoid";
}) => Promise<Array<{
    label: string;
    score: number;
}> | {
    label: string;
    score: number;
}>;
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.