@memberjunction/web-search-engine 0.0.1-seed.1 → 6.2.0-edge.0

package/dist/providers/GoogleCustomSearchWebSearchProvider.js

@@ -0,0 +1,125 @@
+/**
+ * @fileoverview Google Custom Search driver — retiring 2027-01-01.
+ * @module @memberjunction/web-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 GoogleCustomSearchWebSearchProvider_1;
+import { RegisterClass } from '@memberjunction/global';
+import { HttpGet } from '@memberjunction/network-utils';
+import { BaseWebSearchProvider } from '../BaseWebSearchProvider.js';
+import { classifyHttpFailure, failure } from './httpFailure.js';
+/**
+ * Searches through the Google Custom Search JSON API.
+ *
+ * **This provider has an end date.** Google closed the API to new customers during 2025 and
+ * discontinues it on **2027-01-01**. It ships so that hosts already holding a key keep working
+ * through the transition, and it is ordered behind Brave and Tavily deliberately.
+ *
+ * It needs no dated code change to retire: once Google stops serving, calls fail, the engine
+ * fails over, and removing the metadata row takes it out of rotation entirely. A host that
+ * never had a key sees `CheckAvailability` self-disable it on the first config, which is the
+ * ordinary "not configured here" path rather than an error.
+ *
+ * Credential keys `apiKey` and `cx`; environment fallbacks `GOOGLE_CUSTOM_SEARCH_API_KEY`
+ * and `GOOGLE_CUSTOM_SEARCH_CX`.
+ */
+let GoogleCustomSearchWebSearchProvider = class GoogleCustomSearchWebSearchProvider extends BaseWebSearchProvider {
+    constructor() {
+        super(...arguments);
+        this.Capabilities = {
+            Answer: false,
+            DomainFilter: true,
+            Freshness: true,
+            Region: true,
+            // Google serves at most 10 per request and indexes only the first 100 results.
+            MaxResultsCap: 10,
+        };
+    }
+    static { GoogleCustomSearchWebSearchProvider_1 = this; }
+    static { this.ENDPOINT = 'https://www.googleapis.com/customsearch/v1'; }
+    async CheckAvailability(_contextUser) {
+        this.apiKey = this.GetSecret('apiKey', 'GOOGLE_CUSTOM_SEARCH_API_KEY');
+        this.cx = this.GetSecret('cx', 'GOOGLE_CUSTOM_SEARCH_CX');
+        if (this.apiKey && this.cx) {
+            this.MarkAvailable();
+        }
+        else {
+            this.MarkUnavailable('Google Custom Search needs both an API key and a search engine ID (cx). ' +
+                'Note the API is closed to new customers and is discontinued on 2027-01-01.');
+        }
+    }
+    async ExecuteSearch(params, _contextUser) {
+        const query = {
+            key: this.apiKey ?? '',
+            cx: this.cx ?? '',
+            q: params.Query,
+            num: this.ResolveMaxResults(params.MaxResults),
+        };
+        if (params.SafeSearch) {
+            query.safe = params.SafeSearch === 'strict' ? 'active' : 'off';
+        }
+        // Google takes a single site restriction, so only the first include domain is expressible.
+        if (params.IncludeDomains?.length) {
+            query.siteSearch = params.IncludeDomains[0];
+            query.siteSearchFilter = 'i';
+        }
+        else if (params.ExcludeDomains?.length) {
+            query.siteSearch = params.ExcludeDomains[0];
+            query.siteSearchFilter = 'e';
+        }
+        const dateRestrict = this.mapFreshness(params);
+        if (dateRestrict) {
+            query.dateRestrict = dateRestrict;
+        }
+        if (params.Country) {
+            query.gl = params.Country.toLowerCase();
+        }
+        try {
+            const response = await HttpGet(GoogleCustomSearchWebSearchProvider_1.ENDPOINT, { Query: query, Timeout: 15000 });
+            if (!response.Data) {
+                return failure('transient', 'Empty response from Google Custom Search.');
+            }
+            return {
+                Success: true,
+                Hits: (response.Data.items ?? []).map((item) => this.toHit(item)),
+            };
+        }
+        catch (e) {
+            return classifyHttpFailure(e, 'Google Custom Search');
+        }
+    }
+    /** Google expresses recency as `d7`, `w2`, `m3`, `y1`. */
+    mapFreshness(params) {
+        const freshness = params.Freshness;
+        if (!freshness) {
+            return undefined;
+        }
+        if (typeof freshness === 'string') {
+            return { day: 'd1', week: 'w1', month: 'm1', year: 'y1' }[freshness];
+        }
+        const days = Math.max(1, Math.ceil((freshness.To.getTime() - freshness.From.getTime()) / 86400000));
+        return `d${days}`;
+    }
+    toHit(item) {
+        return {
+            Title: item.title ?? '',
+            URL: item.link ?? '',
+            Snippet: item.snippet ?? '',
+            DisplayURL: item.displayLink ?? undefined,
+        };
+    }
+};
+GoogleCustomSearchWebSearchProvider = GoogleCustomSearchWebSearchProvider_1 = __decorate([
+    RegisterClass(BaseWebSearchProvider, 'GoogleCustomSearchWebSearchProvider')
+], GoogleCustomSearchWebSearchProvider);
+export { GoogleCustomSearchWebSearchProvider };
+/** Anti-tree-shaking anchor. */
+export function LoadGoogleCustomSearchWebSearchProvider() {
+    void GoogleCustomSearchWebSearchProvider;
+}
+//# sourceMappingURL=GoogleCustomSearchWebSearchProvider.js.map

package/dist/providers/GoogleCustomSearchWebSearchProvider.js.map

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

package/dist/providers/PerplexityWebSearchProvider.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Perplexity driver — the raw `/search` endpoint, not the Sonar chat models.
+ * @module @memberjunction/web-search-engine
+ */
+import { UserInfo } from '@memberjunction/core';
+import { BaseWebSearchProvider } from '../BaseWebSearchProvider.js';
+import { WebSearchCapabilities, WebSearchParams, WebSearchProviderResponse } from '../types.js';
+/**
+ * Searches through Perplexity.
+ *
+ * Hits always come from **`POST /search`** — the raw search endpoint, which returns ranked
+ * title/url/snippet at a flat per-query price in well under a second. The Sonar chat models are
+ * used only when {@link WebSearchParams.IncludeAnswer} asks for prose, because they bill per
+ * token and take seconds; paying generation prices to obtain a list of links was the defect
+ * this driver exists to avoid repeating.
+ *
+ * Credential key `apiKey`; environment fallback `PERPLEXITY_API_KEY`.
+ */
+export declare class PerplexityWebSearchProvider extends BaseWebSearchProvider {
+    private static readonly SEARCH_ENDPOINT;
+    private static readonly CHAT_ENDPOINT;
+    /** Perplexity's cap on the domain allow/deny list. */
+    private static readonly MAX_DOMAIN_FILTERS;
+    readonly Capabilities: WebSearchCapabilities;
+    private apiKey;
+    CheckAvailability(_contextUser: UserInfo): Promise<void>;
+    ExecuteSearch(params: WebSearchParams, _contextUser: UserInfo): Promise<WebSearchProviderResponse>;
+    /**
+     * Second call to the Sonar chat models, made only when an answer was explicitly requested.
+     *
+     * A failure here does not fail the search — the hits are already in hand and are the more
+     * valuable half, so the answer is simply absent.
+     */
+    private fetchAnswer;
+    private mapRecency;
+    private toHit;
+}
+/** Anti-tree-shaking anchor. */
+export declare function LoadPerplexityWebSearchProvider(): void;
+//# sourceMappingURL=PerplexityWebSearchProvider.d.ts.map

package/dist/providers/PerplexityWebSearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerplexityWebSearchProvider.d.ts","sourceRoot":"","sources":["../../src/providers/PerplexityWebSearchProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAgB,eAAe,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAsB3G;;;;;;;;;;GAUG;AACH,qBACa,2BAA4B,SAAQ,qBAAqB;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAsC;IAC7E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAgD;IACrF,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAM;IAEhD,SAAgB,YAAY,EAAE,qBAAqB,CAMjD;IAEF,OAAO,CAAC,MAAM,CAAqB;IAEtB,iBAAiB,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD,aAAa,CACtB,MAAM,EAAE,eAAe,EACvB,YAAY,EAAE,QAAQ,GACvB,OAAO,CAAC,yBAAyB,CAAC;IAuCrC;;;;;OAKG;YACW,WAAW;IAmBzB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,KAAK;CAiBhB;AAED,gCAAgC;AAChC,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}

package/dist/providers/PerplexityWebSearchProvider.js

@@ -0,0 +1,148 @@
+/**
+ * @fileoverview Perplexity driver — the raw `/search` endpoint, not the Sonar chat models.
+ * @module @memberjunction/web-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 PerplexityWebSearchProvider_1;
+import { RegisterClass } from '@memberjunction/global';
+import { HttpPost } from '@memberjunction/network-utils';
+import { BaseWebSearchProvider } from '../BaseWebSearchProvider.js';
+import { classifyHttpFailure, failure } from './httpFailure.js';
+/**
+ * Searches through Perplexity.
+ *
+ * Hits always come from **`POST /search`** — the raw search endpoint, which returns ranked
+ * title/url/snippet at a flat per-query price in well under a second. The Sonar chat models are
+ * used only when {@link WebSearchParams.IncludeAnswer} asks for prose, because they bill per
+ * token and take seconds; paying generation prices to obtain a list of links was the defect
+ * this driver exists to avoid repeating.
+ *
+ * Credential key `apiKey`; environment fallback `PERPLEXITY_API_KEY`.
+ */
+let PerplexityWebSearchProvider = class PerplexityWebSearchProvider extends BaseWebSearchProvider {
+    constructor() {
+        super(...arguments);
+        this.Capabilities = {
+            Answer: true,
+            DomainFilter: true,
+            Freshness: true,
+            Region: true,
+            MaxResultsCap: 20,
+        };
+    }
+    static { PerplexityWebSearchProvider_1 = this; }
+    static { this.SEARCH_ENDPOINT = 'https://api.perplexity.ai/search'; }
+    static { this.CHAT_ENDPOINT = 'https://api.perplexity.ai/chat/completions'; }
+    /** Perplexity's cap on the domain allow/deny list. */
+    static { this.MAX_DOMAIN_FILTERS = 20; }
+    async CheckAvailability(_contextUser) {
+        this.apiKey = this.GetSecret('apiKey', 'PERPLEXITY_API_KEY');
+        if (this.apiKey) {
+            this.MarkAvailable();
+        }
+        else {
+            this.MarkUnavailable('No Perplexity API key. Set it on the linked Credential (key `apiKey`) or as PERPLEXITY_API_KEY.');
+        }
+    }
+    async ExecuteSearch(params, _contextUser) {
+        const body = {
+            query: params.Query,
+            max_results: this.ResolveMaxResults(params.MaxResults),
+        };
+        // Truncated rather than rejected: Perplexity 400s on an over-long list, and the first
+        // 20 domains still express what the caller was narrowing to.
+        const domains = (params.IncludeDomains ?? []).slice(0, PerplexityWebSearchProvider_1.MAX_DOMAIN_FILTERS);
+        if (domains.length > 0) {
+            body.search_domain_filter = domains;
+        }
+        const recency = this.mapRecency(params);
+        if (recency) {
+            body.search_recency_filter = recency;
+        }
+        if (params.Country) {
+            body.country = params.Country.toUpperCase();
+        }
+        try {
+            const response = await HttpPost(PerplexityWebSearchProvider_1.SEARCH_ENDPOINT, body, { Headers: { Authorization: `Bearer ${this.apiKey}` }, Timeout: 30000 });
+            if (!response.Data) {
+                return failure('transient', 'Empty response from Perplexity Search.');
+            }
+            const hits = (response.Data.results ?? []).map((item) => this.toHit(item));
+            const answer = params.IncludeAnswer ? await this.fetchAnswer(params) : undefined;
+            return { Success: true, Hits: hits, Answer: answer };
+        }
+        catch (e) {
+            return classifyHttpFailure(e, 'Perplexity');
+        }
+    }
+    /**
+     * Second call to the Sonar chat models, made only when an answer was explicitly requested.
+     *
+     * A failure here does not fail the search — the hits are already in hand and are the more
+     * valuable half, so the answer is simply absent.
+     */
+    async fetchAnswer(params) {
+        try {
+            const response = await HttpPost(PerplexityWebSearchProvider_1.CHAT_ENDPOINT, {
+                model: this.GetConfigValue('answerModel') ?? 'sonar',
+                messages: [{ role: 'user', content: params.Query }],
+                max_tokens: this.GetConfigValue('answerMaxTokens') ?? 1000,
+                stream: false,
+            }, { Headers: { Authorization: `Bearer ${this.apiKey}` }, Timeout: 60000 });
+            return response.Data?.choices?.[0]?.message?.content || undefined;
+        }
+        catch {
+            // Deliberately swallowed and reported as absent rather than thrown — see the JSDoc.
+            return undefined;
+        }
+    }
+    mapRecency(params) {
+        const freshness = params.Freshness;
+        if (!freshness) {
+            return undefined;
+        }
+        if (typeof freshness === 'string') {
+            return freshness;
+        }
+        // Perplexity takes only relative windows; pick the smallest that covers the range.
+        const days = Math.ceil((freshness.To.getTime() - freshness.From.getTime()) / 86400000);
+        if (days <= 1)
+            return 'day';
+        if (days <= 7)
+            return 'week';
+        if (days <= 31)
+            return 'month';
+        return 'year';
+    }
+    toHit(item) {
+        const hit = {
+            Title: item.title ?? '',
+            URL: item.url ?? '',
+            Snippet: item.snippet ?? '',
+        };
+        if (item.date) {
+            const parsed = new Date(item.date);
+            if (!isNaN(parsed.getTime())) {
+                hit.PublishedAt = parsed;
+            }
+        }
+        if (item.last_updated) {
+            hit.ProviderExtras = { lastUpdated: item.last_updated };
+        }
+        return hit;
+    }
+};
+PerplexityWebSearchProvider = PerplexityWebSearchProvider_1 = __decorate([
+    RegisterClass(BaseWebSearchProvider, 'PerplexityWebSearchProvider')
+], PerplexityWebSearchProvider);
+export { PerplexityWebSearchProvider };
+/** Anti-tree-shaking anchor. */
+export function LoadPerplexityWebSearchProvider() {
+    void PerplexityWebSearchProvider;
+}
+//# sourceMappingURL=PerplexityWebSearchProvider.js.map

package/dist/providers/PerplexityWebSearchProvider.js.map

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

package/dist/providers/TavilyWebSearchProvider.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Tavily driver — search built for LLM consumption.
+ * @module @memberjunction/web-search-engine
+ */
+import { UserInfo } from '@memberjunction/core';
+import { BaseWebSearchProvider } from '../BaseWebSearchProvider.js';
+import { WebSearchCapabilities, WebSearchParams, WebSearchProviderResponse } from '../types.js';
+/**
+ * Searches through Tavily, whose results arrive as **extracted page content** rather than
+ * snippets plus links to go fetch — which is what makes it well suited to an agent that would
+ * otherwise make a second round trip per result.
+ *
+ * It is an aggregator rather than an index of its own, so it inherits its upstreams' fate;
+ * that is why it sits behind Brave in the default priority order rather than ahead of it.
+ *
+ * Credential key `apiKey`; environment fallback `TAVILY_API_KEY`.
+ */
+export declare class TavilyWebSearchProvider extends BaseWebSearchProvider {
+    private static readonly ENDPOINT;
+    readonly Capabilities: WebSearchCapabilities;
+    private apiKey;
+    CheckAvailability(_contextUser: UserInfo): Promise<void>;
+    ExecuteSearch(params: WebSearchParams, _contextUser: UserInfo): Promise<WebSearchProviderResponse>;
+    /** Tavily expresses recency as a day count on its news topic. */
+    private freshnessToDays;
+    private toHit;
+}
+/** Anti-tree-shaking anchor. */
+export declare function LoadTavilyWebSearchProvider(): void;
+//# sourceMappingURL=TavilyWebSearchProvider.d.ts.map

package/dist/providers/TavilyWebSearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TavilyWebSearchProvider.d.ts","sourceRoot":"","sources":["../../src/providers/TavilyWebSearchProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAgB,eAAe,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAmB3G;;;;;;;;;GASG;AACH,qBACa,uBAAwB,SAAQ,qBAAqB;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAEnE,SAAgB,YAAY,EAAE,qBAAqB,CAMjD;IAEF,OAAO,CAAC,MAAM,CAAqB;IAEtB,iBAAiB,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD,aAAa,CACtB,MAAM,EAAE,eAAe,EACvB,YAAY,EAAE,QAAQ,GACvB,OAAO,CAAC,yBAAyB,CAAC;IA2CrC,iEAAiE;IACjE,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,KAAK;CAkBhB;AAED,gCAAgC;AAChC,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/providers/TavilyWebSearchProvider.js

@@ -0,0 +1,126 @@
+/**
+ * @fileoverview Tavily driver — search built for LLM consumption.
+ * @module @memberjunction/web-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 TavilyWebSearchProvider_1;
+import { RegisterClass } from '@memberjunction/global';
+import { HttpPost } from '@memberjunction/network-utils';
+import { BaseWebSearchProvider } from '../BaseWebSearchProvider.js';
+import { classifyHttpFailure, failure } from './httpFailure.js';
+/**
+ * Searches through Tavily, whose results arrive as **extracted page content** rather than
+ * snippets plus links to go fetch — which is what makes it well suited to an agent that would
+ * otherwise make a second round trip per result.
+ *
+ * It is an aggregator rather than an index of its own, so it inherits its upstreams' fate;
+ * that is why it sits behind Brave in the default priority order rather than ahead of it.
+ *
+ * Credential key `apiKey`; environment fallback `TAVILY_API_KEY`.
+ */
+let TavilyWebSearchProvider = class TavilyWebSearchProvider extends BaseWebSearchProvider {
+    constructor() {
+        super(...arguments);
+        this.Capabilities = {
+            Answer: true,
+            DomainFilter: true,
+            Freshness: true,
+            Region: false,
+            MaxResultsCap: 20,
+        };
+    }
+    static { TavilyWebSearchProvider_1 = this; }
+    static { this.ENDPOINT = 'https://api.tavily.com/search'; }
+    async CheckAvailability(_contextUser) {
+        this.apiKey = this.GetSecret('apiKey', 'TAVILY_API_KEY');
+        if (this.apiKey) {
+            this.MarkAvailable();
+        }
+        else {
+            this.MarkUnavailable('No Tavily API key. Set it on the linked Credential (key `apiKey`) or as TAVILY_API_KEY.');
+        }
+    }
+    async ExecuteSearch(params, _contextUser) {
+        // Tavily dates results only on its news topic, so a freshness request selects that topic.
+        const topic = params.Freshness ? 'news' : 'general';
+        const body = {
+            query: params.Query,
+            search_depth: this.GetConfigValue('searchDepth') ?? 'basic',
+            topic,
+            max_results: this.ResolveMaxResults(params.MaxResults),
+            include_answer: params.IncludeAnswer === true,
+            include_raw_content: false,
+        };
+        if (params.IncludeDomains?.length) {
+            body.include_domains = params.IncludeDomains;
+        }
+        if (params.ExcludeDomains?.length) {
+            body.exclude_domains = params.ExcludeDomains;
+        }
+        const days = this.freshnessToDays(params);
+        if (days !== undefined) {
+            body.days = days;
+        }
+        try {
+            const response = await HttpPost(TavilyWebSearchProvider_1.ENDPOINT, body, {
+                Headers: { Authorization: `Bearer ${this.apiKey}` },
+                Timeout: 60000,
+            });
+            if (!response.Data) {
+                return failure('transient', 'Empty response from Tavily.');
+            }
+            return {
+                Success: true,
+                Hits: (response.Data.results ?? []).map((item) => this.toHit(item)),
+                Answer: params.IncludeAnswer ? response.Data.answer : undefined,
+            };
+        }
+        catch (e) {
+            return classifyHttpFailure(e, 'Tavily');
+        }
+    }
+    /** Tavily expresses recency as a day count on its news topic. */
+    freshnessToDays(params) {
+        const freshness = params.Freshness;
+        if (!freshness) {
+            return undefined;
+        }
+        if (typeof freshness === 'string') {
+            return { day: 1, week: 7, month: 30, year: 365 }[freshness];
+        }
+        const ms = freshness.To.getTime() - freshness.From.getTime();
+        return Math.max(1, Math.ceil(ms / 86400000));
+    }
+    toHit(item) {
+        const hit = {
+            Title: item.title ?? '',
+            URL: item.url ?? '',
+            Snippet: item.content ?? '',
+            Score: typeof item.score === 'number' ? item.score : undefined,
+        };
+        if (item.published_date) {
+            const parsed = new Date(item.published_date);
+            if (!isNaN(parsed.getTime())) {
+                hit.PublishedAt = parsed;
+            }
+        }
+        if (item.raw_content) {
+            hit.ProviderExtras = { rawContent: item.raw_content };
+        }
+        return hit;
+    }
+};
+TavilyWebSearchProvider = TavilyWebSearchProvider_1 = __decorate([
+    RegisterClass(BaseWebSearchProvider, 'TavilyWebSearchProvider')
+], TavilyWebSearchProvider);
+export { TavilyWebSearchProvider };
+/** Anti-tree-shaking anchor. */
+export function LoadTavilyWebSearchProvider() {
+    void TavilyWebSearchProvider;
+}
+//# sourceMappingURL=TavilyWebSearchProvider.js.map

package/dist/providers/TavilyWebSearchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TavilyWebSearchProvider.js","sourceRoot":"","sources":["../../src/providers/TavilyWebSearchProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;;;;;;;;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAkB7D;;;;;;;;;GASG;AAEI,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,qBAAqB;IAA3D;;QAGa,iBAAY,GAA0B;YAClD,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,KAAK;YACb,aAAa,EAAE,EAAE;SACpB,CAAC;IA4FN,CAAC;;aApG2B,aAAQ,GAAG,+BAA+B,AAAlC,CAAmC;IAY5D,KAAK,CAAC,iBAAiB,CAAC,YAAsB;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,IAAI,CAAC,aAAa,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,eAAe,CAChB,yFAAyF,CAC5F,CAAC;QACN,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,aAAa,CACtB,MAAuB,EACvB,YAAsB;QAEtB,0FAA0F;QAC1F,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACpD,MAAM,IAAI,GAA4B;YAClC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,YAAY,EAAE,IAAI,CAAC,cAAc,CAAS,aAAa,CAAC,IAAI,OAAO;YACnE,KAAK;YACL,WAAW,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC;YACtD,cAAc,EAAE,MAAM,CAAC,aAAa,KAAK,IAAI;YAC7C,mBAAmB,EAAE,KAAK;SAC7B,CAAC;QAEF,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC;QACjD,CAAC;QACD,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC;QAED,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAoB,yBAAuB,CAAC,QAAQ,EAAE,IAAI,EAAE;gBACvF,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE;gBACnD,OAAO,EAAE,KAAK;aACjB,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO,OAAO,CAAC,WAAW,EAAE,6BAA6B,CAAC,CAAC;YAC/D,CAAC;YAED,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnE,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;aAClE,CAAC;QACN,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,mBAAmB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC;IAED,iEAAiE;IACzD,eAAe,CAAC,MAAuB;QAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,IAAqB;QAC/B,MAAM,GAAG,GAAiB;YACtB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACjE,CAAC;QACF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC;YAC7B,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,GAAG,CAAC,cAAc,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;;AApGQ,uBAAuB;IADnC,aAAa,CAAC,qBAAqB,EAAE,yBAAyB,CAAC;GACnD,uBAAuB,CAqGnC;;AAED,gCAAgC;AAChC,MAAM,UAAU,2BAA2B;IACvC,KAAK,uBAAuB,CAAC;AACjC,CAAC"}

package/dist/providers/httpFailure.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Shared HTTP failure classification for web search drivers.
+ * @module @memberjunction/web-search-engine
+ */
+import { WebSearchFailureKind, WebSearchProviderResponse } from '../types.js';
+/**
+ * Classify an error thrown by a vendor call into the kind that drives engine failover.
+ *
+ * The distinction is about **the request, not the vendor**: a 400/422 normally means this query is
+ * malformed and every other provider will reject it too, so the engine must stop rather than
+ * spend four more paid calls learning the same thing. Everything else — auth, quota, 5xx,
+ * timeouts — is specific to this vendor and another may well succeed.
+ *
+ * A missing or invalid API key is deliberately `transient` in that sense: the request is fine,
+ * *this* provider just cannot serve it, so moving on is exactly right.
+ *
+ * **Status alone does not decide that**, which is why a 400 is inspected before it is trusted.
+ * Google Custom Search answers an invalid key with HTTP 400 (`reason: keyInvalid`), not 401 — so
+ * classifying by status alone made a dead Google key stop the whole run, on precisely the vendor
+ * whose keys are expected to stop working when the API is discontinued on 2027-01-01. Perplexity
+ * answers the same condition with 401 and failed over correctly, which is what made the
+ * inconsistency easy to miss.
+ */
+export declare function classifyHttpFailure(error: unknown, vendor: string): WebSearchProviderResponse;
+/** Build a failed provider response. */
+export declare function failure(kind: WebSearchFailureKind, message: string): WebSearchProviderResponse;
+/** Map a relative freshness window onto a vendor's own code table. */
+export declare function mapFreshnessWindow<T extends string>(window: 'day' | 'week' | 'month' | 'year', codes: Record<'day' | 'week' | 'month' | 'year', T>): T;
+//# sourceMappingURL=httpFailure.d.ts.map

package/dist/providers/httpFailure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpFailure.d.ts","sourceRoot":"","sources":["../../src/providers/httpFailure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAyD3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,yBAAyB,CA4B7F;AAED,wCAAwC;AACxC,wBAAgB,OAAO,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,GAAG,yBAAyB,CAE9F;AA8BD,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAC/C,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EACzC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC,GACpD,CAAC,CAEH"}