Graphorin API reference v0.15.1
Graphorin API reference / @graphorin/reranker-llm / / LlmReRanker
Class: LlmReRanker<TRecord>
Defined in: src/reranker.ts:130
Stable
ReRanker implementation. Matches the contract from @graphorin/memory/search.
Type Parameters
| Type Parameter | Default type |
|---|---|
TRecord extends MemoryRecord | MemoryRecord |
Implements
Constructors
Constructor
new LlmReRanker<TRecord>(options): LlmReRanker<TRecord>;Defined in: src/reranker.ts:148
Parameters
| Parameter | Type |
|---|---|
options | LlmRerankerOptions<TRecord> |
Returns
LlmReRanker<TRecord>
Properties
| Property | Modifier | Type | Default value | Description | Defined in |
|---|---|---|---|---|---|
batchSize | readonly | number | undefined | - | src/reranker.ts:134 |
fallbackScore | readonly | number | undefined | - | src/reranker.ts:137 |
id | readonly | "llm-judge" | RERANKER_ID | Stable lowercase identifier surfaced on every span. | src/reranker.ts:131 |
maxOutputTokens | readonly | number | undefined | - | src/reranker.ts:136 |
maxScore | readonly | number | undefined | - | src/reranker.ts:133 |
provider | readonly | Provider | undefined | - | src/reranker.ts:132 |
temperature | readonly | number | undefined | - | src/reranker.ts:135 |
Accessors
invocationCount
Get Signature
get invocationCount(): number;Defined in: src/reranker.ts:177
Stable
Number of rerank(...) invocations since construction. Surfaced for observability + the test suite.
Returns
number
lastErrorCount
Get Signature
get lastErrorCount(): number;Defined in: src/reranker.ts:197
Number of per-passage provider failures swallowed (→ fallbackScore) on the most recent rerank(...). A non-zero value means the ranking is partially degraded - surface it for observability.
Returns
number
lastFailures
Get Signature
get lastFailures(): readonly LlmRerankFailure[];Defined in: src/reranker.ts:222
Stable
Per-passage failure details (both kinds) from the most recent rerank(...), capped at 25 entries - enough to diagnose a live incident (status codes, error classes, off-format reply snippets) without re-running billed calls. The counters above keep full totals.
Returns
readonly LlmRerankFailure[]
lastOffFormatCount
Get Signature
get lastOffFormatCount(): number;Defined in: src/reranker.ts:209
Stable
Number of off-format replies (no parseable integer → fallbackScore) on the most recent rerank(...). Distinct from lastErrorCount: the provider call SUCCEEDED but the model drifted off the integer-only contract.
Returns
number
lastPromptTokens
Get Signature
get lastPromptTokens(): number;Defined in: src/reranker.ts:188
Stable
Rough total prompt-tokens spent on the most-recent rerank call. Returned by the provider on each generate(...); we expose the sum so tests can assert the batching shape.
Returns
number
Methods
rerank()
rerank<TInputRecord>(
query,
lists,
options?): Promise<readonly MemoryHit<TInputRecord>[]>;Defined in: src/reranker.ts:226
Rerank one or more parallel ranked lists and return the fused top-K (default topK = 10). Each input list must already be sorted by score descending.
Type Parameters
| Type Parameter |
|---|
TInputRecord extends MemoryRecord |
Parameters
| Parameter | Type |
|---|---|
query | string |
lists | readonly readonly MemoryHit<TInputRecord>[][] |
options | ReRankOptions |
Returns
Promise<readonly MemoryHit<TInputRecord>[]>