@framers/agentos 0.1.179 → 0.1.181

package/dist/web-search/WebSearchService.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @module web-search/WebSearchService
+ *
+ * Multi-provider web search orchestrator.
+ * Pipeline: parallel search → semantic dedup → RRF fusion → optional neural reranking.
+ */
+import type { IWebSearchProvider, WebSearchConfig, EnrichedSearchResult } from './types';
+export declare class WebSearchService {
+    private providers;
+    private readonly config;
+    constructor(config?: WebSearchConfig);
+    /** Register a search provider. */
+    registerProvider(provider: IWebSearchProvider): void;
+    /** Check if any providers are registered and available. */
+    hasProviders(): boolean;
+    /** List registered provider IDs. */
+    listProviders(): string[];
+    /**
+     * Full search pipeline: parallel query → dedup → RRF → optional rerank.
+     *
+     * @param query - Search query string
+     * @param options - Override maxResults or disable reranking
+     */
+    search(query: string, options?: {
+        maxResults?: number;
+        rerank?: boolean;
+    }): Promise<EnrichedSearchResult[]>;
+    /** Convenience: return a function matching the legacy SearchFn signature. */
+    asSearchFn(): (query: string) => Promise<EnrichedSearchResult[]>;
+}
+//# sourceMappingURL=WebSearchService.d.ts.map

package/dist/web-search/WebSearchService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSearchService.d.ts","sourceRoot":"","sources":["../../src/web-search/WebSearchService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EAErB,MAAM,SAAS,CAAC;AAIjB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAEH;gBAER,MAAM,CAAC,EAAE,eAAe;IAQpC,kCAAkC;IAClC,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIpD,2DAA2D;IAC3D,YAAY,IAAI,OAAO;IAIvB,oCAAoC;IACpC,aAAa,IAAI,MAAM,EAAE;IAIzB;;;;;OAKG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAClD,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAsFlC,6EAA6E;IAC7E,UAAU,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAGjE"}

package/dist/web-search/WebSearchService.js

@@ -0,0 +1,108 @@
+import { normalizeUrl, computeWeightedRRF } from './fusion.js';
+import { semanticDedup } from './dedup.js';
+export class WebSearchService {
+    constructor(config) {
+        this.providers = [];
+        this.config = {
+            dedupThreshold: config?.dedupThreshold ?? 0.85,
+            maxResults: config?.maxResults ?? 12,
+            ...config,
+        };
+    }
+    /** Register a search provider. */
+    registerProvider(provider) {
+        this.providers.push(provider);
+    }
+    /** Check if any providers are registered and available. */
+    hasProviders() {
+        return this.providers.some((p) => p.isAvailable());
+    }
+    /** List registered provider IDs. */
+    listProviders() {
+        return this.providers.map((p) => p.providerId);
+    }
+    /**
+     * Full search pipeline: parallel query → dedup → RRF → optional rerank.
+     *
+     * @param query - Search query string
+     * @param options - Override maxResults or disable reranking
+     */
+    async search(query, options) {
+        const available = this.providers.filter((p) => p.isAvailable());
+        if (available.length === 0)
+            return [];
+        // ── Parallel search across all available providers ──
+        const settled = await Promise.allSettled(available.map((p) => p.search(query)));
+        // ── Collect as RRF candidates ──
+        const allCandidates = [];
+        for (let i = 0; i < available.length; i++) {
+            const outcome = settled[i];
+            if (outcome.status !== 'fulfilled')
+                continue;
+            const provider = available[i];
+            for (let rank = 0; rank < outcome.value.length; rank++) {
+                const r = outcome.value[rank];
+                allCandidates.push({
+                    url: r.url,
+                    normalizedUrl: normalizeUrl(r.url),
+                    title: r.title,
+                    snippet: r.snippet,
+                    content: r.content,
+                    providerRanks: new Map([[provider.providerId, rank]]),
+                    providerSources: [provider.providerId],
+                    rrfScore: 0,
+                    relevanceScore: r.relevanceScore,
+                });
+            }
+        }
+        if (allCandidates.length === 0)
+            return [];
+        // ── Semantic dedup ──
+        const deduped = semanticDedup(allCandidates, this.config.dedupThreshold);
+        // ── RRF scoring with provider weights ──
+        const weights = {};
+        for (const p of available) {
+            weights[p.providerId] = p.weight;
+        }
+        computeWeightedRRF(deduped, weights);
+        // ── Slice to max results ──
+        const maxResults = options?.maxResults ?? this.config.maxResults;
+        const enriched = deduped.slice(0, maxResults).map((c) => ({
+            url: c.url,
+            title: c.title,
+            snippet: c.snippet,
+            content: c.content,
+            relevanceScore: c.relevanceScore,
+            providerSources: c.providerSources,
+            rrfScore: c.rrfScore,
+        }));
+        // ── Neural reranking (optional) ──
+        const shouldRerank = options?.rerank !== false;
+        if (shouldRerank && this.config.reranker && this.config.rerankChain) {
+            try {
+                const chunks = enriched.map((r, i) => ({
+                    id: `search-${i}`,
+                    originalDocumentId: r.url,
+                    content: r.content ?? r.snippet,
+                    relevanceScore: r.rrfScore,
+                    metadata: { url: r.url, title: r.title },
+                }));
+                const reranked = await this.config.reranker.rerankChain(query, chunks, this.config.rerankChain);
+                const resultMap = new Map(enriched.map((r, i) => [`search-${i}`, r]));
+                return reranked.map((chunk) => {
+                    const original = resultMap.get(chunk.id);
+                    return { ...original, rerankScore: chunk.relevanceScore ?? 0 };
+                });
+            }
+            catch {
+                // Reranking failure is non-fatal
+            }
+        }
+        return enriched;
+    }
+    /** Convenience: return a function matching the legacy SearchFn signature. */
+    asSearchFn() {
+        return (query) => this.search(query);
+    }
+}
+//# sourceMappingURL=WebSearchService.js.map

package/dist/web-search/WebSearchService.js.map

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

package/dist/web-search/dedup.d.ts

@@ -0,0 +1,19 @@
+import type { RRFCandidate } from './types';
+/** Build vocabulary index from all texts. */
+export declare function buildVocabulary(texts: string[]): Map<string, number>;
+/** Build a TF vector normalized by document length. */
+export declare function buildTfVector(text: string, vocabulary: Map<string, number>): number[];
+/**
+ * Semantic dedup: merge near-duplicate results across providers.
+ *
+ * Two-pass:
+ * 1. URL normalization merge (exact match after stripping protocol/www/tracking)
+ * 2. TF-IDF cosine similarity on snippets (catches same article at different URLs)
+ *
+ * Keeps the version with richest content (prefers full markdown over snippet-only).
+ *
+ * @param candidates - Raw candidates from all providers
+ * @param threshold - Cosine similarity threshold for dedup (default 0.85)
+ */
+export declare function semanticDedup(candidates: RRFCandidate[], threshold?: number): RRFCandidate[];
+//# sourceMappingURL=dedup.d.ts.map

package/dist/web-search/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/web-search/dedup.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQpE;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CASrF;AAwBD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,YAAY,EAAE,EAC1B,SAAS,GAAE,MAAa,GACvB,YAAY,EAAE,CA4ChB"}

package/dist/web-search/dedup.js

@@ -0,0 +1,107 @@
+/**
+ * @module web-search/dedup
+ *
+ * Semantic deduplication for web search results.
+ * Uses TF-IDF cosine similarity to detect near-duplicates across providers.
+ * Pure functions, no IO.
+ */
+import { cosineSimilarity } from '../rag/citation/cosine.js';
+import { normalizeUrl } from './fusion.js';
+/** Build vocabulary index from all texts. */
+export function buildVocabulary(texts) {
+    const vocab = new Map();
+    for (const text of texts) {
+        for (const word of text.toLowerCase().split(/\W+/).filter(Boolean)) {
+            if (!vocab.has(word))
+                vocab.set(word, vocab.size);
+        }
+    }
+    return vocab;
+}
+/** Build a TF vector normalized by document length. */
+export function buildTfVector(text, vocabulary) {
+    const words = text.toLowerCase().split(/\W+/).filter(Boolean);
+    const vec = new Array(vocabulary.size).fill(0);
+    for (const w of words) {
+        const idx = vocabulary.get(w);
+        if (idx !== undefined)
+            vec[idx]++;
+    }
+    const len = words.length || 1;
+    return vec.map((v) => v / len);
+}
+/**
+ * Merge a source candidate into a target candidate.
+ * Combines provider ranks and keeps the richest content.
+ */
+function mergeCandidates(target, source) {
+    for (const [prov, rank] of source.providerRanks) {
+        if (!target.providerRanks.has(prov)) {
+            target.providerRanks.set(prov, rank);
+            target.providerSources.push(prov);
+        }
+    }
+    if (source.content && !target.content) {
+        target.content = source.content;
+    }
+    if (source.relevanceScore &&
+        (!target.relevanceScore || source.relevanceScore > target.relevanceScore)) {
+        target.relevanceScore = source.relevanceScore;
+    }
+}
+/**
+ * Semantic dedup: merge near-duplicate results across providers.
+ *
+ * Two-pass:
+ * 1. URL normalization merge (exact match after stripping protocol/www/tracking)
+ * 2. TF-IDF cosine similarity on snippets (catches same article at different URLs)
+ *
+ * Keeps the version with richest content (prefers full markdown over snippet-only).
+ *
+ * @param candidates - Raw candidates from all providers
+ * @param threshold - Cosine similarity threshold for dedup (default 0.85)
+ */
+export function semanticDedup(candidates, threshold = 0.85) {
+    if (candidates.length <= 1)
+        return candidates;
+    // Pass 1: merge by normalized URL
+    const urlMap = new Map();
+    for (const c of candidates) {
+        const normUrl = c.normalizedUrl || normalizeUrl(c.url);
+        const existing = urlMap.get(normUrl);
+        if (existing) {
+            mergeCandidates(existing, c);
+        }
+        else {
+            urlMap.set(normUrl, { ...c, normalizedUrl: normUrl });
+        }
+    }
+    const urlDeduped = Array.from(urlMap.values());
+    if (urlDeduped.length <= 1)
+        return urlDeduped;
+    // Pass 2: semantic similarity on snippets
+    const snippets = urlDeduped.map((c) => c.snippet);
+    const vocab = buildVocabulary(snippets);
+    if (vocab.size === 0)
+        return urlDeduped;
+    const vectors = snippets.map((s) => buildTfVector(s, vocab));
+    const merged = new Set();
+    const result = [];
+    for (let i = 0; i < urlDeduped.length; i++) {
+        if (merged.has(i))
+            continue;
+        const current = urlDeduped[i];
+        for (let j = i + 1; j < urlDeduped.length; j++) {
+            if (merged.has(j))
+                continue;
+            const sim = cosineSimilarity(vectors[i], vectors[j]);
+            if (sim >= threshold) {
+                mergeCandidates(current, urlDeduped[j]);
+                merged.add(j);
+            }
+        }
+        result.push(current);
+    }
+    return result;
+}
+//# sourceMappingURL=dedup.js.map

package/dist/web-search/dedup.js.map

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

package/dist/web-search/fusion.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @module web-search/fusion
+ *
+ * URL normalization and Reciprocal Rank Fusion (RRF) scoring.
+ * Pure functions, no IO.
+ */
+import type { RRFCandidate } from './types';
+/** Normalize a URL for dedup comparison. */
+export declare function normalizeUrl(url: string): string;
+/**
+ * Compute RRF scores for candidates.
+ *
+ * Formula: score(d) = Σ (provider_weight / (k + rank_in_provider))
+ * Results appearing in multiple providers get naturally boosted.
+ *
+ * @param candidates - Candidates with providerRanks populated
+ * @param k - RRF constant (default 60)
+ * @returns Same candidates with rrfScore computed, sorted descending
+ */
+export declare function computeRRF(candidates: RRFCandidate[], k?: number): RRFCandidate[];
+/**
+ * Compute weighted RRF scores using per-provider weights.
+ *
+ * @param candidates - Candidates with providerRanks populated
+ * @param weights - Provider ID → weight multiplier map
+ * @param k - RRF constant (default 60)
+ */
+export declare function computeWeightedRRF(candidates: RRFCandidate[], weights: Record<string, number>, k?: number): RRFCandidate[];
+//# sourceMappingURL=fusion.d.ts.map

package/dist/web-search/fusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion.d.ts","sourceRoot":"","sources":["../../src/web-search/fusion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAK5C,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,CAAC,GAAE,MAAkB,GAAG,YAAY,EAAE,CAW5F;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,YAAY,EAAE,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,CAAC,GAAE,MAAkB,GACpB,YAAY,EAAE,CAUhB"}

package/dist/web-search/fusion.js

@@ -0,0 +1,50 @@
+/** Default RRF constant — prevents top-ranked results from dominating. */
+const DEFAULT_K = 60;
+/** Normalize a URL for dedup comparison. */
+export function normalizeUrl(url) {
+    return url
+        .replace(/^https?:\/\//, '')
+        .replace(/^www\./, '')
+        .replace(/\/+$/, '')
+        .replace(/[?&](utm_\w+|ref|source|fbclid|gclid)=[^&]*/g, '')
+        .replace(/\?$/, '');
+}
+/**
+ * Compute RRF scores for candidates.
+ *
+ * Formula: score(d) = Σ (provider_weight / (k + rank_in_provider))
+ * Results appearing in multiple providers get naturally boosted.
+ *
+ * @param candidates - Candidates with providerRanks populated
+ * @param k - RRF constant (default 60)
+ * @returns Same candidates with rrfScore computed, sorted descending
+ */
+export function computeRRF(candidates, k = DEFAULT_K) {
+    for (const candidate of candidates) {
+        let score = 0;
+        for (const [, rank] of candidate.providerRanks) {
+            // Weight is baked into the candidate via the provider that created it
+            score += 1 / (k + rank);
+        }
+        candidate.rrfScore = score;
+    }
+    return candidates.sort((a, b) => b.rrfScore - a.rrfScore);
+}
+/**
+ * Compute weighted RRF scores using per-provider weights.
+ *
+ * @param candidates - Candidates with providerRanks populated
+ * @param weights - Provider ID → weight multiplier map
+ * @param k - RRF constant (default 60)
+ */
+export function computeWeightedRRF(candidates, weights, k = DEFAULT_K) {
+    for (const candidate of candidates) {
+        let score = 0;
+        for (const [provider, rank] of candidate.providerRanks) {
+            score += (weights[provider] ?? 1.0) / (k + rank);
+        }
+        candidate.rrfScore = score;
+    }
+    return candidates.sort((a, b) => b.rrfScore - a.rrfScore);
+}
+//# sourceMappingURL=fusion.js.map

package/dist/web-search/fusion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion.js","sourceRoot":"","sources":["../../src/web-search/fusion.ts"],"names":[],"mappings":"AAQA,0EAA0E;AAC1E,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,4CAA4C;AAC5C,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG;SACP,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,8CAA8C,EAAE,EAAE,CAAC;SAC3D,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,UAA0B,EAAE,IAAY,SAAS;IAC1E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;YAC/C,sEAAsE;YACtE,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,SAAS,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA0B,EAC1B,OAA+B,EAC/B,IAAY,SAAS;IAErB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;YACvD,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,SAAS,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC5D,CAAC"}

package/dist/web-search/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module @framers/agentos/web-search
+ *
+ * Multi-provider web search with RRF fusion, semantic dedup, and neural reranking.
+ * Supports Firecrawl (primary), Tavily, Serper, and Brave search providers.
+ *
+ * @example
+ * ```typescript
+ * import { WebSearchService, FirecrawlProvider, TavilyProvider } from '../web-search';
+ *
+ * const service = new WebSearchService();
+ * service.registerProvider(new FirecrawlProvider(process.env.FIRECRAWL_API_KEY!));
+ * service.registerProvider(new TavilyProvider(process.env.TAVILY_API_KEY!));
+ *
+ * const results = await service.search('quantum computing breakthroughs 2026');
+ * // Results are deduped, RRF-scored, and optionally reranked
+ * ```
+ */
+export type { IWebSearchProvider, WebSearchResult, EnrichedSearchResult, WebSearchConfig, RRFCandidate, } from './types';
+export { WebSearchService } from './WebSearchService';
+export { FirecrawlProvider } from './providers/FirecrawlProvider';
+export { TavilyProvider } from './providers/TavilyProvider';
+export { SerperProvider } from './providers/SerperProvider';
+export { BraveProvider } from './providers/BraveProvider';
+export { normalizeUrl, computeRRF, computeWeightedRRF } from './fusion';
+export { semanticDedup, buildVocabulary, buildTfVector } from './dedup';
+//# sourceMappingURL=index.d.ts.map

package/dist/web-search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web-search/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGxE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/web-search/index.js

@@ -0,0 +1,30 @@
+/**
+ * @module @framers/agentos/web-search
+ *
+ * Multi-provider web search with RRF fusion, semantic dedup, and neural reranking.
+ * Supports Firecrawl (primary), Tavily, Serper, and Brave search providers.
+ *
+ * @example
+ * ```typescript
+ * import { WebSearchService, FirecrawlProvider, TavilyProvider } from '../web-search/index.js';
+ *
+ * const service = new WebSearchService();
+ * service.registerProvider(new FirecrawlProvider(process.env.FIRECRAWL_API_KEY!));
+ * service.registerProvider(new TavilyProvider(process.env.TAVILY_API_KEY!));
+ *
+ * const results = await service.search('quantum computing breakthroughs 2026');
+ * // Results are deduped, RRF-scored, and optionally reranked
+ * ```
+ */
+// Service
+export { WebSearchService } from './WebSearchService.js';
+// Providers
+export { FirecrawlProvider } from './providers/FirecrawlProvider.js';
+export { TavilyProvider } from './providers/TavilyProvider.js';
+export { SerperProvider } from './providers/SerperProvider.js';
+export { BraveProvider } from './providers/BraveProvider.js';
+// Fusion utilities
+export { normalizeUrl, computeRRF, computeWeightedRRF } from './fusion.js';
+// Dedup utilities
+export { semanticDedup, buildVocabulary, buildTfVector } from './dedup.js';
+//# sourceMappingURL=index.js.map

package/dist/web-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web-search/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAExE,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/web-search/providers/BraveProvider.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module web-search/providers/BraveProvider
+ *
+ * Brave Search API provider.
+ */
+import type { IWebSearchProvider, WebSearchResult } from '../types';
+export declare class BraveProvider implements IWebSearchProvider {
+    private readonly apiKey;
+    readonly providerId: "brave";
+    readonly weight = 1;
+    constructor(apiKey: string);
+    isAvailable(): boolean;
+    search(query: string, limit?: number): Promise<WebSearchResult[]>;
+}
+//# sourceMappingURL=BraveProvider.d.ts.map

package/dist/web-search/providers/BraveProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BraveProvider.d.ts","sourceRoot":"","sources":["../../../src/web-search/providers/BraveProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEpE,qBAAa,aAAc,YAAW,kBAAkB;IAI1C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,QAAQ,CAAC,UAAU,EAAG,OAAO,CAAU;IACvC,QAAQ,CAAC,MAAM,KAAO;gBAEO,MAAM,EAAE,MAAM;IAE3C,WAAW,IAAI,OAAO;IAIhB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAa3E"}

package/dist/web-search/providers/BraveProvider.js

@@ -0,0 +1,23 @@
+export class BraveProvider {
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.providerId = 'brave';
+        this.weight = 1.0;
+    }
+    isAvailable() {
+        return this.apiKey.length > 0;
+    }
+    async search(query, limit = 5) {
+        const params = new URLSearchParams({ q: query, count: String(limit) });
+        const res = await fetch(`https://api.search.brave.com/res/v1/web/search?${params}`, {
+            headers: { 'X-Subscription-Token': this.apiKey },
+        });
+        const data = await res.json();
+        return (data.web?.results ?? []).map((r) => ({
+            url: String(r.url ?? ''),
+            title: String(r.title ?? ''),
+            snippet: String(r.description ?? ''),
+        }));
+    }
+}
+//# sourceMappingURL=BraveProvider.js.map

package/dist/web-search/providers/BraveProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BraveProvider.js","sourceRoot":"","sources":["../../../src/web-search/providers/BraveProvider.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,aAAa;IAIxB,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QAHlC,eAAU,GAAG,OAAgB,CAAC;QAC9B,WAAM,GAAG,GAAG,CAAC;IAEwB,CAAC;IAE/C,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,QAAgB,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,kDAAkD,MAAM,EAAE,EAAE;YAClF,OAAO,EAAE,EAAE,sBAAsB,EAAE,IAAI,CAAC,MAAM,EAAE;SACjD,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC;YACpE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;YACxB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;SACrC,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/web-search/providers/FirecrawlProvider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module web-search/providers/FirecrawlProvider
+ *
+ * Firecrawl search provider — search + scrape in one API call.
+ * Returns full extracted markdown content alongside search results.
+ * Primary provider with 1.5x RRF weight.
+ */
+import type { IWebSearchProvider, WebSearchResult } from '../types';
+export declare class FirecrawlProvider implements IWebSearchProvider {
+    private readonly apiKey;
+    readonly providerId: "firecrawl";
+    readonly weight = 1.5;
+    constructor(apiKey: string);
+    isAvailable(): boolean;
+    search(query: string, limit?: number): Promise<WebSearchResult[]>;
+}
+//# sourceMappingURL=FirecrawlProvider.d.ts.map

package/dist/web-search/providers/FirecrawlProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirecrawlProvider.d.ts","sourceRoot":"","sources":["../../../src/web-search/providers/FirecrawlProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEpE,qBAAa,iBAAkB,YAAW,kBAAkB;IAI9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,QAAQ,CAAC,UAAU,EAAG,WAAW,CAAU;IAC3C,QAAQ,CAAC,MAAM,OAAO;gBAEO,MAAM,EAAE,MAAM;IAE3C,WAAW,IAAI,OAAO;IAIhB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CA6B3E"}

package/dist/web-search/providers/FirecrawlProvider.js

@@ -0,0 +1,38 @@
+export class FirecrawlProvider {
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.providerId = 'firecrawl';
+        this.weight = 1.5;
+    }
+    isAvailable() {
+        return this.apiKey.length > 0;
+    }
+    async search(query, limit = 5) {
+        const res = await fetch('https://api.firecrawl.dev/v1/search', {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                query,
+                limit,
+                scrapeOptions: { formats: ['markdown'], onlyMainContent: true },
+            }),
+        });
+        if (!res.ok) {
+            const errText = await res.text().catch(() => '');
+            throw new Error(`Firecrawl search failed (${res.status}): ${errText}`);
+        }
+        const data = await res.json();
+        if (!data.success || !Array.isArray(data.data))
+            return [];
+        return data.data.map((r) => ({
+            url: String(r.url ?? r.metadata?.sourceURL ?? ''),
+            title: String(r.title ?? r.metadata?.title ?? ''),
+            snippet: String(r.description ?? r.metadata?.description ?? ''),
+            content: typeof r.markdown === 'string' ? r.markdown : undefined,
+        }));
+    }
+}
+//# sourceMappingURL=FirecrawlProvider.js.map

package/dist/web-search/providers/FirecrawlProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirecrawlProvider.js","sourceRoot":"","sources":["../../../src/web-search/providers/FirecrawlProvider.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,iBAAiB;IAI5B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QAHlC,eAAU,GAAG,WAAoB,CAAC;QAClC,WAAM,GAAG,GAAG,CAAC;IAEwB,CAAC;IAE/C,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,QAAgB,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,qCAAqC,EAAE;YAC7D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK;gBACL,KAAK;gBACL,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE;aAChE,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAE1D,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC;YACpD,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAK,CAAC,CAAC,QAAoC,EAAE,SAAS,IAAI,EAAE,CAAC;YAC9E,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAK,CAAC,CAAC,QAAoC,EAAE,KAAK,IAAI,EAAE,CAAC;YAC9E,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,IAAK,CAAC,CAAC,QAAoC,EAAE,WAAW,IAAI,EAAE,CAAC;YAC5F,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SACjE,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/web-search/providers/SerperProvider.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module web-search/providers/SerperProvider
+ *
+ * Serper (Google Search) provider.
+ */
+import type { IWebSearchProvider, WebSearchResult } from '../types';
+export declare class SerperProvider implements IWebSearchProvider {
+    private readonly apiKey;
+    readonly providerId: "serper";
+    readonly weight = 1;
+    constructor(apiKey: string);
+    isAvailable(): boolean;
+    search(query: string, limit?: number): Promise<WebSearchResult[]>;
+}
+//# sourceMappingURL=SerperProvider.d.ts.map

package/dist/web-search/providers/SerperProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerperProvider.d.ts","sourceRoot":"","sources":["../../../src/web-search/providers/SerperProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEpE,qBAAa,cAAe,YAAW,kBAAkB;IAI3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,QAAQ,CAAC,UAAU,EAAG,QAAQ,CAAU;IACxC,QAAQ,CAAC,MAAM,KAAO;gBAEO,MAAM,EAAE,MAAM;IAE3C,WAAW,IAAI,OAAO;IAIhB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAiB3E"}

package/dist/web-search/providers/SerperProvider.js

@@ -0,0 +1,27 @@
+export class SerperProvider {
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.providerId = 'serper';
+        this.weight = 1.0;
+    }
+    isAvailable() {
+        return this.apiKey.length > 0;
+    }
+    async search(query, limit = 5) {
+        const res = await fetch('https://google.serper.dev/search', {
+            method: 'POST',
+            headers: {
+                'X-API-KEY': this.apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ q: query, num: limit }),
+        });
+        const data = await res.json();
+        return (data.organic ?? []).map((r) => ({
+            url: String(r.link ?? ''),
+            title: String(r.title ?? ''),
+            snippet: String(r.snippet ?? ''),
+        }));
+    }
+}
+//# sourceMappingURL=SerperProvider.js.map

package/dist/web-search/providers/SerperProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerperProvider.js","sourceRoot":"","sources":["../../../src/web-search/providers/SerperProvider.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,cAAc;IAIzB,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QAHlC,eAAU,GAAG,QAAiB,CAAC;QAC/B,WAAM,GAAG,GAAG,CAAC;IAEwB,CAAC;IAE/C,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,QAAgB,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,kCAAkC,EAAE;YAC1D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;SAC/C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC;YAC/D,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YACzB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;SACjC,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/web-search/providers/TavilyProvider.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module web-search/providers/TavilyProvider
+ *
+ * Tavily AI-optimized search provider.
+ */
+import type { IWebSearchProvider, WebSearchResult } from '../types';
+export declare class TavilyProvider implements IWebSearchProvider {
+    private readonly apiKey;
+    readonly providerId: "tavily";
+    readonly weight = 1;
+    constructor(apiKey: string);
+    isAvailable(): boolean;
+    search(query: string, limit?: number): Promise<WebSearchResult[]>;
+}
+//# sourceMappingURL=TavilyProvider.d.ts.map

package/dist/web-search/providers/TavilyProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TavilyProvider.d.ts","sourceRoot":"","sources":["../../../src/web-search/providers/TavilyProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEpE,qBAAa,cAAe,YAAW,kBAAkB;IAI3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,QAAQ,CAAC,UAAU,EAAG,QAAQ,CAAU;IACxC,QAAQ,CAAC,MAAM,KAAO;gBAEO,MAAM,EAAE,MAAM;IAE3C,WAAW,IAAI,OAAO;IAIhB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAsB3E"}

package/dist/web-search/providers/TavilyProvider.js

@@ -0,0 +1,32 @@
+export class TavilyProvider {
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.providerId = 'tavily';
+        this.weight = 1.0;
+    }
+    isAvailable() {
+        return this.apiKey.length > 0;
+    }
+    async search(query, limit = 5) {
+        const res = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                api_key: this.apiKey,
+                query,
+                search_depth: 'advanced',
+                include_answer: false,
+                include_raw_content: false,
+                max_results: limit,
+            }),
+        });
+        const data = await res.json();
+        return (data.results ?? []).map((r) => ({
+            url: String(r.url ?? ''),
+            title: String(r.title ?? ''),
+            snippet: String(r.content ?? ''),
+            relevanceScore: typeof r.score === 'number' ? r.score : 0.5,
+        }));
+    }
+}
+//# sourceMappingURL=TavilyProvider.js.map

package/dist/web-search/providers/TavilyProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TavilyProvider.js","sourceRoot":"","sources":["../../../src/web-search/providers/TavilyProvider.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,cAAc;IAIzB,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QAHlC,eAAU,GAAG,QAAiB,CAAC;QAC/B,WAAM,GAAG,GAAG,CAAC;IAEwB,CAAC;IAE/C,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,QAAgB,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,IAAI,CAAC,MAAM;gBACpB,KAAK;gBACL,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,KAAK;gBACrB,mBAAmB,EAAE,KAAK;gBAC1B,WAAW,EAAE,KAAK;aACnB,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC;YAC/D,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;YACxB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;YAChC,cAAc,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG;SAC5D,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/web-search/providers/index.d.ts

@@ -0,0 +1,5 @@
+export { FirecrawlProvider } from './FirecrawlProvider';
+export { TavilyProvider } from './TavilyProvider';
+export { SerperProvider } from './SerperProvider';
+export { BraveProvider } from './BraveProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/web-search/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/web-search/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/web-search/providers/index.js

@@ -0,0 +1,5 @@
+export { FirecrawlProvider } from './FirecrawlProvider.js';
+export { TavilyProvider } from './TavilyProvider.js';
+export { SerperProvider } from './SerperProvider.js';
+export { BraveProvider } from './BraveProvider.js';
+//# sourceMappingURL=index.js.map

package/dist/web-search/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web-search/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/web-search/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @module web-search/types
+ *
+ * Core types for the AgentOS multi-provider web search pipeline.
+ */
+import type { RerankChainStage } from '../rag/reranking/IRerankerService';
+import type { RerankerService } from '../rag/reranking/RerankerService';
+/** A single raw result from a search provider. */
+export interface WebSearchResult {
+    url: string;
+    title: string;
+    snippet: string;
+    /** Full extracted page content (Firecrawl returns this; others do not). */
+    content?: string;
+    /** Provider-specific relevance score. */
+    relevanceScore?: number;
+}
+/** Enriched result after cross-provider fusion and optional reranking. */
+export interface EnrichedSearchResult extends WebSearchResult {
+    /** Which providers returned this result. */
+    providerSources: string[];
+    /** Reciprocal Rank Fusion score across providers. */
+    rrfScore: number;
+    /** Neural reranker relevance score (0-1). Populated after reranking. */
+    rerankScore?: number;
+}
+/** Contract for pluggable search providers. */
+export interface IWebSearchProvider {
+    /** Unique provider identifier (e.g., 'firecrawl', 'tavily'). */
+    readonly providerId: string;
+    /** RRF weight multiplier. Firecrawl = 1.5, others = 1.0. */
+    readonly weight: number;
+    /** Execute a search query. Returns raw results from this provider. */
+    search(query: string, limit?: number): Promise<WebSearchResult[]>;
+    /** Check if this provider has valid configuration (API key present). */
+    isAvailable(): boolean;
+}
+/** Configuration for the WebSearchService. */
+export interface WebSearchConfig {
+    /** Optional RerankerService for neural reranking after RRF. */
+    reranker?: RerankerService;
+    /** Rerank chain stages (e.g., Cohere → LLM Judge). */
+    rerankChain?: RerankChainStage[];
+    /** Semantic dedup cosine similarity threshold (default 0.85). */
+    dedupThreshold?: number;
+    /** Max results to return (default 12). */
+    maxResults?: number;
+}
+/** Internal candidate during RRF fusion. */
+export interface RRFCandidate {
+    url: string;
+    normalizedUrl: string;
+    title: string;
+    snippet: string;
+    content?: string;
+    providerRanks: Map<string, number>;
+    providerSources: string[];
+    rrfScore: number;
+    relevanceScore?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/web-search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web-search/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,4CAA4C;IAC5C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAClE,wEAAwE;IACxE,WAAW,IAAI,OAAO,CAAC;CACxB;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,sDAAsD;IACtD,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/web-search/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/web-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web-search/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.179",
+  "version": "0.1.181",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",
@@ -32,6 +32,31 @@
       "default": "./dist/api/streamText.js",
       "types": "./dist/api/streamText.d.ts"
     },
+    "./api/generateImage": {
+      "import": "./dist/api/generateImage.js",
+      "default": "./dist/api/generateImage.js",
+      "types": "./dist/api/generateImage.d.ts"
+    },
+    "./api/generateObject": {
+      "import": "./dist/api/generateObject.js",
+      "default": "./dist/api/generateObject.js",
+      "types": "./dist/api/generateObject.d.ts"
+    },
+    "./api/generateMusic": {
+      "import": "./dist/api/generateMusic.js",
+      "default": "./dist/api/generateMusic.js",
+      "types": "./dist/api/generateMusic.d.ts"
+    },
+    "./api/generateSFX": {
+      "import": "./dist/api/generateSFX.js",
+      "default": "./dist/api/generateSFX.js",
+      "types": "./dist/api/generateSFX.d.ts"
+    },
+    "./api/generateVideo": {
+      "import": "./dist/api/generateVideo.js",
+      "default": "./dist/api/generateVideo.js",
+      "types": "./dist/api/generateVideo.d.ts"
+    },
     "./core/llm/routing/IModelRouter": {
       "import": "./dist/core/llm/routing/IModelRouter.js",
       "default": "./dist/core/llm/routing/IModelRouter.js",
@@ -138,6 +163,11 @@
       "default": "./dist/rag/reranking/index.js",
       "types": "./dist/rag/reranking/index.d.ts"
     },
+    "./web-search": {
+      "import": "./dist/web-search/index.js",
+      "default": "./dist/web-search/index.js",
+      "types": "./dist/web-search/index.d.ts"
+    },
     "./rag/graphrag": {
       "import": "./dist/rag/graphrag/index.js",
       "default": "./dist/rag/graphrag/index.js",