@memberjunction/search-engine 5.33.0 → 5.34.0

package/dist/rerankers/OpenAIReRanker.js

@@ -0,0 +1,197 @@
+/**
+ * @fileoverview OpenAI chat-judge re-ranker (P2D.4).
+ *
+ * **Decision (2026-04-28):** OpenAI does not publish a first-party reranker endpoint.
+ * Their offerings are completions, chat, embeddings, and moderation — there is no
+ * dedicated `/rerank`. This implementation uses the documented fallback from the plan:
+ * a small chat-completion-based "judge" that scores each candidate's relevance to the
+ * query and returns the new ordering. Re-evaluate this decision when OpenAI ships a
+ * first-party reranker — the canonical plan calls out swapping in the first-party
+ * endpoint as soon as it exists.
+ *
+ * **Approach.** Single chat completion call, JSON-mode response. The model receives
+ * the query and a numbered list of documents and returns
+ * `{ "scores": [<number 0..1>, ...] }` with one score per document, in input order.
+ * We then sort by score, slice to topN, and return.
+ *
+ * **Cost.** `gpt-4o-mini` defaults: $0.15 / 1M input tokens, $0.60 / 1M output tokens
+ * (2026-04 pricing). Pre-call estimate uses a conservative ~80 tokens/doc input plus
+ * 8 tokens/doc output. Post-call cost reports the exact `usage.{prompt,completion}_tokens`
+ * from OpenAI so the budget guard sees real spend.
+ *
+ * **API key.** `GetAIAPIKey('OpenAILLM')` —
+ * AI_VENDOR_API_KEY__OPENAILLM or any registered AIAPIKeys subclass.
+ *
+ * @module @memberjunction/search-engine
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var OpenAIReRanker_1;
+import { RegisterClass } from '@memberjunction/global';
+import { LogError } from '@memberjunction/core';
+import { BaseReranker as AIBaseReranker, GetAIAPIKey, } from '@memberjunction/ai';
+import { BaseReRanker } from '../generic/BaseReRanker.js';
+const OPENAI_CHAT_URL = 'https://api.openai.com/v1/chat/completions';
+const SYSTEM_PROMPT = [
+    'You are a precise relevance scorer for a search system.',
+    'Given a user query and a numbered list of candidate documents, return a JSON object',
+    'with a single key "scores" whose value is an array of numbers. The array must have',
+    'exactly one entry per input document, in the same order, where each entry is a',
+    'relevance score in [0, 1] representing how well that document answers the query.',
+    'Use the full range — do not cluster all scores in one band. Output JSON only.',
+].join('\n');
+class OpenAIScopeAIReranker extends AIBaseReranker {
+    constructor(apiKey, modelName) {
+        super(apiKey, modelName);
+        /** Last call's prompt+completion tokens, populated by `doRerank`. */
+        this.lastPromptTokens = 0;
+        this.lastCompletionTokens = 0;
+    }
+    async doRerank(params) {
+        const docList = params.documents
+            .map((d, i) => `[${i}] ${d.text}`)
+            .join('\n');
+        const userPrompt = `Query:\n${params.query}\n\nDocuments:\n${docList}`;
+        const response = await fetch(OPENAI_CHAT_URL, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                model: this._modelName,
+                messages: [
+                    { role: 'system', content: SYSTEM_PROMPT },
+                    { role: 'user', content: userPrompt },
+                ],
+                response_format: { type: 'json_object' },
+                temperature: 0,
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`OpenAI rerank-judge call failed (${response.status}): ${text || response.statusText}`);
+        }
+        const json = await response.json();
+        this.lastPromptTokens = json.usage?.prompt_tokens ?? 0;
+        this.lastCompletionTokens = json.usage?.completion_tokens ?? 0;
+        const content = json.choices[0]?.message.content ?? '';
+        const parsed = JSON.parse(content);
+        if (!Array.isArray(parsed.scores)) {
+            throw new Error(`OpenAI rerank-judge returned malformed scores: ${content}`);
+        }
+        const scores = parsed.scores;
+        if (scores.length !== params.documents.length) {
+            throw new Error(`OpenAI rerank-judge returned ${scores.length} scores for ${params.documents.length} documents`);
+        }
+        // Build (doc, score) pairs, sort descending by score, optionally slice topK.
+        const pairs = params.documents.map((d, i) => ({
+            doc: d,
+            score: typeof scores[i] === 'number' ? scores[i] : 0,
+        }));
+        pairs.sort((a, b) => b.score - a.score);
+        const topK = params.topK ?? pairs.length;
+        return pairs.slice(0, topK).map((p, idx) => ({
+            id: p.doc.id,
+            relevanceScore: p.score,
+            document: p.doc,
+            rank: idx,
+        }));
+    }
+}
+/**
+ * Chat-completion-based "judge" reranker. Configure per scope via
+ * `SearchScope.ScopeConfig.reRanker.driverClass = 'OpenAIReRanker'`.
+ *
+ * Override the model via `ScopeConfig.reRanker.config.model`
+ * (default: `gpt-4o-mini` — change when a first-party OpenAI rerank endpoint launches).
+ */
+let OpenAIReRanker = class OpenAIReRanker extends BaseReRanker {
+    constructor() {
+        super(...arguments);
+        this.currentAIReranker = null;
+    }
+    static { OpenAIReRanker_1 = this; }
+    /** Pricing in cents-per-token. As of 2026-04. */
+    static { this.PRICING = {
+        'gpt-4o-mini': { input: 0.15 / 1_000_000 * 100, output: 0.60 / 1_000_000 * 100 },
+        'gpt-4o': { input: 2.50 / 1_000_000 * 100, output: 10.00 / 1_000_000 * 100 },
+        'gpt-4.1-mini': { input: 0.40 / 1_000_000 * 100, output: 1.60 / 1_000_000 * 100 },
+        'gpt-4.1': { input: 2.00 / 1_000_000 * 100, output: 8.00 / 1_000_000 * 100 },
+    }; }
+    get DriverClass() {
+        return 'OpenAIReRanker';
+    }
+    get Name() {
+        return 'OpenAI';
+    }
+    get Version() {
+        return '1';
+    }
+    /**
+     * Effective limit when the candidate list plus prompt fits in the model's input
+     * window. With gpt-4o-mini's 128k input context and ~80 tokens/doc, the practical
+     * cap is well above 1000. Returning 1000 to match the other rerankers; the
+     * SearchEngine will chunk above this when chunking is implemented.
+     */
+    GetMaxResultCount() {
+        return 1000;
+    }
+    /**
+     * Pre-call cost estimate. ~80 input tokens/doc + 50 system/query tokens, plus
+     * 8 output tokens/doc. Conservative — actual usage tends to be lower.
+     */
+    EstimateCostCents(resultCount) {
+        const pricing = OpenAIReRanker_1.PRICING['gpt-4o-mini'];
+        const inputTokens = resultCount * 80 + 50;
+        const outputTokens = resultCount * 8;
+        return inputTokens * pricing.input + outputTokens * pricing.output;
+    }
+    getAIReranker(config, _contextUser) {
+        if (this.currentAIReranker)
+            return this.currentAIReranker;
+        const apiKey = GetAIAPIKey('OpenAILLM');
+        if (!apiKey) {
+            LogError('OpenAIReRanker: no API key found for driver "OpenAILLM" — set AI_VENDOR_API_KEY__OPENAILLM or register an AIAPIKeys subclass.');
+            return null;
+        }
+        const modelName = config?.['model'] ?? 'gpt-4o-mini';
+        this.currentAIReranker = new OpenAIScopeAIReranker(apiKey, modelName);
+        return this.currentAIReranker;
+    }
+    async ReRank(query, candidates, topN, contextUser, config) {
+        if (topN <= 0 || candidates.length === 0)
+            return [];
+        this.currentAIReranker = null;
+        const apiReranker = this.getAIReranker(config, contextUser);
+        try {
+            if (!apiReranker)
+                return candidates.slice(0, topN);
+            const result = await super.ReRank(query, candidates, topN, contextUser, config);
+            const modelName = config?.['model'] ?? 'gpt-4o-mini';
+            const pricing = OpenAIReRanker_1.PRICING[modelName] ?? OpenAIReRanker_1.PRICING['gpt-4o-mini'];
+            const cents = apiReranker.lastPromptTokens * pricing.input
+                + apiReranker.lastCompletionTokens * pricing.output;
+            if (cents > 0)
+                this.reportCost(cents);
+            return result;
+        }
+        finally {
+            this.currentAIReranker = null;
+        }
+    }
+};
+OpenAIReRanker = OpenAIReRanker_1 = __decorate([
+    RegisterClass(BaseReRanker, 'OpenAIReRanker')
+], OpenAIReRanker);
+export { OpenAIReRanker };
+/** Tree-shake prevention helper. */
+export function LoadOpenAIReRanker() {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const _ref = OpenAIReRanker;
+}
+//# sourceMappingURL=OpenAIReRanker.js.map

package/dist/rerankers/OpenAIReRanker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIReRanker.js","sourceRoot":"","sources":["../../src/rerankers/OpenAIReRanker.ts"],"names":[],"mappings":"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"}

package/dist/rerankers/RerankerBudgetGuard.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Reranker budget guard (P2D.6).
+ *
+ * Per-search-invocation circuit breaker that caps real-provider reranker spend
+ * (Cohere, Voyage, OpenAI) against `SearchScope.RerankerBudgetCents`. Wired into
+ * the SearchEngine's rerank stage so:
+ *
+ *   1. Before each rerank call, the engine asks the guard whether `EstimateCostCents`
+ *      fits in the remaining budget. If not, the engine SKIPS the rerank and uses
+ *      the unranked candidate list.
+ *   2. After each rerank call, the reranker's `CostReporter` callback (P2D.1
+ *      contract) lands in `record()`, accumulating actual spend.
+ *
+ * NULL budget = uncapped; the guard always returns `canSpend = true` and accumulates
+ * spend purely for observability. This preserves Phase 1 behavior for any scope the
+ * admin hasn't explicitly capped.
+ *
+ * @module @memberjunction/search-engine
+ */
+/**
+ * Per-run budget tracker. One instance per search invocation; lives only as long
+ * as the SearchEngine.search call. Not thread-safe, but Node is single-threaded
+ * within a request so that's fine.
+ */
+export declare class RerankerBudgetGuard {
+    /** Total budget in cents, or null when uncapped. */
+    readonly Budget: number | null;
+    /** Accumulated cost in cents, populated via record(). */
+    Spent: number;
+    constructor(budgetCents: number | null | undefined);
+    /**
+     * Cents remaining in the budget. Returns null when uncapped, else
+     * `max(0, Budget - Spent)`.
+     */
+    Remaining(): number | null;
+    /**
+     * Pre-call check: does `estimatedCents` fit in the remaining budget? Returns
+     * true when uncapped or when remaining ≥ estimate.
+     *
+     * Negative estimates are treated as zero (defensive — a buggy
+     * `EstimateCostCents` shouldn't trigger short-circuits prematurely).
+     */
+    CanSpend(estimatedCents: number): boolean;
+    /**
+     * Post-call accumulator. Negative or non-finite values are clamped to 0.
+     */
+    Record(actualCents: number): void;
+    /**
+     * Sugar for wiring into a reranker. Returns a closure that records cost on
+     * this guard — assignable directly to `BaseReRanker.CostReporter`.
+     */
+    AsCostReporter(): (cents: number) => void;
+}
+//# sourceMappingURL=RerankerBudgetGuard.d.ts.map

package/dist/rerankers/RerankerBudgetGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RerankerBudgetGuard.d.ts","sourceRoot":"","sources":["../../src/rerankers/RerankerBudgetGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,qBAAa,mBAAmB;IAC5B,oDAAoD;IACpD,SAAgB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,yDAAyD;IAClD,KAAK,SAAK;gBAEL,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIlD;;;OAGG;IACI,SAAS,IAAI,MAAM,GAAG,IAAI;IAIjC;;;;;;OAMG;IACI,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAMhD;;OAEG;IACI,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKxC;;;OAGG;IACI,cAAc,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;CAGnD"}

package/dist/rerankers/RerankerBudgetGuard.js

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview Reranker budget guard (P2D.6).
+ *
+ * Per-search-invocation circuit breaker that caps real-provider reranker spend
+ * (Cohere, Voyage, OpenAI) against `SearchScope.RerankerBudgetCents`. Wired into
+ * the SearchEngine's rerank stage so:
+ *
+ *   1. Before each rerank call, the engine asks the guard whether `EstimateCostCents`
+ *      fits in the remaining budget. If not, the engine SKIPS the rerank and uses
+ *      the unranked candidate list.
+ *   2. After each rerank call, the reranker's `CostReporter` callback (P2D.1
+ *      contract) lands in `record()`, accumulating actual spend.
+ *
+ * NULL budget = uncapped; the guard always returns `canSpend = true` and accumulates
+ * spend purely for observability. This preserves Phase 1 behavior for any scope the
+ * admin hasn't explicitly capped.
+ *
+ * @module @memberjunction/search-engine
+ */
+/**
+ * Per-run budget tracker. One instance per search invocation; lives only as long
+ * as the SearchEngine.search call. Not thread-safe, but Node is single-threaded
+ * within a request so that's fine.
+ */
+export class RerankerBudgetGuard {
+    constructor(budgetCents) {
+        /** Accumulated cost in cents, populated via record(). */
+        this.Spent = 0;
+        this.Budget = budgetCents == null ? null : Math.max(0, budgetCents);
+    }
+    /**
+     * Cents remaining in the budget. Returns null when uncapped, else
+     * `max(0, Budget - Spent)`.
+     */
+    Remaining() {
+        return this.Budget == null ? null : Math.max(0, this.Budget - this.Spent);
+    }
+    /**
+     * Pre-call check: does `estimatedCents` fit in the remaining budget? Returns
+     * true when uncapped or when remaining ≥ estimate.
+     *
+     * Negative estimates are treated as zero (defensive — a buggy
+     * `EstimateCostCents` shouldn't trigger short-circuits prematurely).
+     */
+    CanSpend(estimatedCents) {
+        if (this.Budget == null)
+            return true;
+        const need = Math.max(0, estimatedCents);
+        return this.Remaining() >= need;
+    }
+    /**
+     * Post-call accumulator. Negative or non-finite values are clamped to 0.
+     */
+    Record(actualCents) {
+        if (!Number.isFinite(actualCents) || actualCents <= 0)
+            return;
+        this.Spent += actualCents;
+    }
+    /**
+     * Sugar for wiring into a reranker. Returns a closure that records cost on
+     * this guard — assignable directly to `BaseReRanker.CostReporter`.
+     */
+    AsCostReporter() {
+        return (cents) => this.Record(cents);
+    }
+}
+//# sourceMappingURL=RerankerBudgetGuard.js.map

package/dist/rerankers/RerankerBudgetGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RerankerBudgetGuard.js","sourceRoot":"","sources":["../../src/rerankers/RerankerBudgetGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAM5B,YAAY,WAAsC;QAHlD,yDAAyD;QAClD,UAAK,GAAG,CAAC,CAAC;QAGb,IAAI,CAAC,MAAM,GAAG,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IACxE,CAAC;IAED;;;OAGG;IACI,SAAS;QACZ,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;OAMG;IACI,QAAQ,CAAC,cAAsB;QAClC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,SAAS,EAAG,IAAI,IAAI,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,WAAmB;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC;YAAE,OAAO;QAC9D,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACI,cAAc;QACjB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CACJ"}

package/dist/rerankers/VoyageReRanker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Voyage AI Rerank API integration (P2D.3).
+ *
+ * Calls Voyage's `rerank-2` (and `rerank-2-lite`) endpoint via the public REST API.
+ * No SDK dependency — Voyage's surface is small and fetch-based, so we call the
+ * endpoint directly and avoid pulling in `voyageai` as another optional peer.
+ *
+ * **Cost model.** Voyage bills per token (query + document tokens combined). Pricing
+ * as of 2026-04: `rerank-2` is $0.05 per 1M tokens; `rerank-2-lite` is $0.02 per 1M
+ * tokens. We approximate token count as `ceil(charCount / 4)` for the estimate, then
+ * report the exact `usage.total_tokens` returned by the API as the actual cost.
+ *
+ * **API key resolution.** Uses `GetAIAPIKey('VoyageLLM')` — sources from
+ * `AI_VENDOR_API_KEY__VOYAGELLM` env var or any registered AIAPIKeys subclass.
+ *
+ * @module @memberjunction/search-engine
+ */
+import { UserInfo } from '@memberjunction/core';
+import { BaseReranker as AIBaseReranker } from '@memberjunction/ai';
+import { BaseReRanker } from '../generic/BaseReRanker.js';
+import { SearchResultItem } from '../generic/search.types.js';
+/**
+ * Voyage `rerank-2` re-ranker. Configure per scope via
+ * `SearchScope.ScopeConfig.reRanker.driverClass = 'VoyageReRanker'`.
+ *
+ * Override the model via `ScopeConfig.reRanker.config.model = 'rerank-2-lite'` for
+ * the cheaper lite variant.
+ */
+export declare class VoyageReRanker extends BaseReRanker {
+    /** Pricing in cents-per-token, indexed by model name. As of 2026-04. */
+    private static readonly CENTS_PER_TOKEN;
+    /**
+     * Per-instance reranker, captured so we can read `lastTokensUsed` after a call to
+     * report exact cost. Recreated per ReRank invocation when config or contextUser
+     * change shouldn't be a concern in practice.
+     */
+    private currentAIReranker;
+    get DriverClass(): string;
+    get Name(): string;
+    get Version(): string;
+    /** Voyage's published cap is 1000 documents per call. */
+    GetMaxResultCount(): number;
+    /**
+     * Pre-call cost estimate using `ceil(charCount / 4)` per document plus query
+     * tokens. Conservative — tends to over-estimate, which is what a budget guard
+     * wants. Default model is `rerank-2`; pass `config.model` to switch.
+     */
+    EstimateCostCents(resultCount: number): number;
+    protected getAIReranker(config: Record<string, unknown> | undefined, _contextUser: UserInfo): AIBaseReranker | null;
+    /**
+     * Override `ReRank` to report exact post-call cost via `usage.total_tokens` from
+     * the Voyage response, not the pre-call estimate. The estimate exists only to feed
+     * the budget guard's pre-call short-circuit.
+     */
+    ReRank(query: string, candidates: SearchResultItem[], topN: number, contextUser: UserInfo, config?: Record<string, unknown>): Promise<SearchResultItem[]>;
+}
+/** Tree-shake prevention helper. */
+export declare function LoadVoyageReRanker(): void;
+//# sourceMappingURL=VoyageReRanker.d.ts.map

package/dist/rerankers/VoyageReRanker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoyageReRanker.d.ts","sourceRoot":"","sources":["../../src/rerankers/VoyageReRanker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACH,YAAY,IAAI,cAAc,EAIjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAyE3D;;;;;;GAMG;AACH,qBACa,cAAe,SAAQ,YAAY;IAC5C,wEAAwE;IACxE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAGrC;IAEF;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAAsC;IAE/D,IAAW,WAAW,IAAI,MAAM,CAE/B;IACD,IAAoB,IAAI,IAAI,MAAM,CAEjC;IACD,IAAoB,OAAO,IAAI,MAAM,CAEpC;IAED,yDAAyD;IACzC,iBAAiB,IAAI,MAAM;IAI3C;;;;OAIG;IACa,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;cAS3C,aAAa,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,YAAY,EAAE,QAAQ,GACvB,cAAc,GAAG,IAAI;IAiBxB;;;;OAIG;IACmB,MAAM,CACxB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,gBAAgB,EAAE,EAC9B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,QAAQ,EACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAsBjC;AAED,oCAAoC;AACpC,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/rerankers/VoyageReRanker.js

@@ -0,0 +1,184 @@
+/**
+ * @fileoverview Voyage AI Rerank API integration (P2D.3).
+ *
+ * Calls Voyage's `rerank-2` (and `rerank-2-lite`) endpoint via the public REST API.
+ * No SDK dependency — Voyage's surface is small and fetch-based, so we call the
+ * endpoint directly and avoid pulling in `voyageai` as another optional peer.
+ *
+ * **Cost model.** Voyage bills per token (query + document tokens combined). Pricing
+ * as of 2026-04: `rerank-2` is $0.05 per 1M tokens; `rerank-2-lite` is $0.02 per 1M
+ * tokens. We approximate token count as `ceil(charCount / 4)` for the estimate, then
+ * report the exact `usage.total_tokens` returned by the API as the actual cost.
+ *
+ * **API key resolution.** Uses `GetAIAPIKey('VoyageLLM')` — sources from
+ * `AI_VENDOR_API_KEY__VOYAGELLM` env var or any registered AIAPIKeys subclass.
+ *
+ * @module @memberjunction/search-engine
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var VoyageReRanker_1;
+import { RegisterClass } from '@memberjunction/global';
+import { LogError } from '@memberjunction/core';
+import { BaseReranker as AIBaseReranker, GetAIAPIKey, } from '@memberjunction/ai';
+import { BaseReRanker } from '../generic/BaseReRanker.js';
+const VOYAGE_RERANK_URL = 'https://api.voyageai.com/v1/rerank';
+/**
+ * Approximate Voyage's tokenizer by `ceil(charCount / 4)`. Real Voyage tokenization is
+ * BPE-based; this approximation is conservative enough to keep budget guards from
+ * under-counting in practice.
+ */
+function estimateTokens(text) {
+    return Math.max(1, Math.ceil(text.length / 4));
+}
+/**
+ * Inline AI-layer reranker that POSTs to Voyage's rerank endpoint.
+ */
+class VoyageScopeAIReranker extends AIBaseReranker {
+    constructor(apiKey, modelName) {
+        super(apiKey, modelName);
+        /**
+         * Last-call usage. Populated on each `doRerank()` so the SearchEngine wrapper can
+         * report exact cost via `usage.total_tokens` instead of the pre-call estimate.
+         */
+        this.lastTokensUsed = 0;
+    }
+    async doRerank(params) {
+        const body = {
+            query: params.query,
+            documents: params.documents.map(d => d.text),
+            model: this._modelName,
+            top_k: params.topK ?? params.documents.length,
+            return_documents: false,
+        };
+        const response = await fetch(VOYAGE_RERANK_URL, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`Voyage rerank failed (${response.status}): ${text || response.statusText}`);
+        }
+        const json = await response.json();
+        this.lastTokensUsed = json.usage?.total_tokens ?? 0;
+        return json.data.map((r, idx) => ({
+            id: params.documents[r.index].id,
+            relevanceScore: r.relevance_score,
+            document: params.documents[r.index],
+            rank: idx,
+        }));
+    }
+}
+/**
+ * Voyage `rerank-2` re-ranker. Configure per scope via
+ * `SearchScope.ScopeConfig.reRanker.driverClass = 'VoyageReRanker'`.
+ *
+ * Override the model via `ScopeConfig.reRanker.config.model = 'rerank-2-lite'` for
+ * the cheaper lite variant.
+ */
+let VoyageReRanker = class VoyageReRanker extends BaseReRanker {
+    constructor() {
+        super(...arguments);
+        /**
+         * Per-instance reranker, captured so we can read `lastTokensUsed` after a call to
+         * report exact cost. Recreated per ReRank invocation when config or contextUser
+         * change shouldn't be a concern in practice.
+         */
+        this.currentAIReranker = null;
+    }
+    static { VoyageReRanker_1 = this; }
+    /** Pricing in cents-per-token, indexed by model name. As of 2026-04. */
+    static { this.CENTS_PER_TOKEN = {
+        'rerank-2': 0.05 / 1_000_000 * 100, // $0.05 / 1M tokens → 5e-6 cents/token
+        'rerank-2-lite': 0.02 / 1_000_000 * 100, // $0.02 / 1M tokens → 2e-6 cents/token
+    }; }
+    get DriverClass() {
+        return 'VoyageReRanker';
+    }
+    get Name() {
+        return 'Voyage';
+    }
+    get Version() {
+        return '1';
+    }
+    /** Voyage's published cap is 1000 documents per call. */
+    GetMaxResultCount() {
+        return 1000;
+    }
+    /**
+     * Pre-call cost estimate using `ceil(charCount / 4)` per document plus query
+     * tokens. Conservative — tends to over-estimate, which is what a budget guard
+     * wants. Default model is `rerank-2`; pass `config.model` to switch.
+     */
+    EstimateCostCents(resultCount) {
+        // Use the default model's pricing for the estimate; the actual call will use
+        // whatever's in config.model and the post-call cost report will be exact.
+        const pricePerToken = VoyageReRanker_1.CENTS_PER_TOKEN['rerank-2'] ?? 0;
+        // Assume average document size ~250 chars (~62 tokens) and a 30-token query.
+        const approxTokens = resultCount * 62 + 30;
+        return approxTokens * pricePerToken;
+    }
+    getAIReranker(config, _contextUser) {
+        // Return the cached instance if `ReRank()` already constructed one for this
+        // invocation — super.ReRank calls us a second time during dispatch. Without
+        // the cache we'd build two separate Voyage clients per call and lose track of
+        // `lastTokensUsed`.
+        if (this.currentAIReranker)
+            return this.currentAIReranker;
+        const apiKey = GetAIAPIKey('VoyageLLM');
+        if (!apiKey) {
+            LogError('VoyageReRanker: no API key found for driver "VoyageLLM" — set AI_VENDOR_API_KEY__VOYAGELLM or register an AIAPIKeys subclass.');
+            return null;
+        }
+        const modelName = config?.['model'] ?? 'rerank-2';
+        this.currentAIReranker = new VoyageScopeAIReranker(apiKey, modelName);
+        return this.currentAIReranker;
+    }
+    /**
+     * Override `ReRank` to report exact post-call cost via `usage.total_tokens` from
+     * the Voyage response, not the pre-call estimate. The estimate exists only to feed
+     * the budget guard's pre-call short-circuit.
+     */
+    async ReRank(query, candidates, topN, contextUser, config) {
+        if (topN <= 0 || candidates.length === 0)
+            return [];
+        // Reset the per-call cache and prime it via getAIReranker. Super will reuse it.
+        this.currentAIReranker = null;
+        const apiReranker = this.getAIReranker(config, contextUser);
+        try {
+            if (!apiReranker) {
+                // No API key — fall through to a top-N slice without charge.
+                return candidates.slice(0, topN);
+            }
+            const result = await super.ReRank(query, candidates, topN, contextUser, config);
+            const modelName = config?.['model'] ?? 'rerank-2';
+            const pricePerToken = VoyageReRanker_1.CENTS_PER_TOKEN[modelName] ?? VoyageReRanker_1.CENTS_PER_TOKEN['rerank-2'];
+            const cents = apiReranker.lastTokensUsed * pricePerToken;
+            if (cents > 0) {
+                this.reportCost(cents);
+            }
+            return result;
+        }
+        finally {
+            this.currentAIReranker = null;
+        }
+    }
+};
+VoyageReRanker = VoyageReRanker_1 = __decorate([
+    RegisterClass(BaseReRanker, 'VoyageReRanker')
+], VoyageReRanker);
+export { VoyageReRanker };
+/** Tree-shake prevention helper. */
+export function LoadVoyageReRanker() {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const _ref = VoyageReRanker;
+}
+//# sourceMappingURL=VoyageReRanker.js.map

package/dist/rerankers/VoyageReRanker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoyageReRanker.js","sourceRoot":"","sources":["../../src/rerankers/VoyageReRanker.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/search-engine",
   "type": "module",
-  "version": "5.33.0",
+  "version": "5.34.0",
   "description": "MemberJunction: Reusable server-side search engine - vector + full-text + entity search with RRF fusion",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,16 +16,21 @@
   "author": "MemberJunction.com",
   "license": "ISC",
   "dependencies": {
-    "@memberjunction/ai": "5.33.0",
-    "@memberjunction/ai-vectordb": "5.33.0",
-    "@memberjunction/aiengine": "5.33.0",
-    "@memberjunction/core": "5.33.0",
-    "@memberjunction/core-entities": "5.33.0",
-    "@memberjunction/global": "5.33.0",
-    "@memberjunction/storage": "5.33.0"
+    "@memberjunction/ai": "5.34.0",
+    "@memberjunction/ai-vectordb": "5.34.0",
+    "@memberjunction/aiengine": "5.34.0",
+    "@memberjunction/core": "5.34.0",
+    "@memberjunction/core-entities": "5.34.0",
+    "@memberjunction/global": "5.34.0",
+    "@memberjunction/storage": "5.34.0",
+    "nunjucks": "^3.2.4"
+  },
+  "optionalDependencies": {
+    "cohere-ai": "^7.20.0"
   },
   "devDependencies": {
     "@types/node": "24.10.11",
+    "@types/nunjucks": "^3.2.6",
     "typescript": "^5.9.3"
   },
   "repository": {