dsh-web-search-pro 0.1.0

package/lib/router.js

@@ -0,0 +1,332 @@
+/**
+ * Search orchestration: engine ordering/fallback (agent-reach style routing),
+ * optional parallel multi-engine merging, SQLite caching, and persistence.
+ * @module web-search-pro/router
+ */
+import { credentialRef } from '@deepseek-ai/dsh-credentials';
+import { seamEngine, exaEngine, ddgEngine, bingEngine, jinaSearchEngine, githubEngine, bilibiliEngine, v2exEngine, youtubeEngine, arxivEngine, pubmedEngine, platformEngines, rssEngine, customPlatformEngine, EngineError, } from "./engines.js";
+import { normQuery, capText } from "./util.js";
+import { LruCache } from "./memory-cache.js";
+const ENGINE_FACTORIES = {
+    seam: (_deps) => seamEngine(_deps),
+    exa: (deps) => exaEngine(deps),
+    ddg: () => ddgEngine(),
+    bing: () => bingEngine(),
+    jina: (deps) => jinaSearchEngine(deps),
+    github: (deps) => githubEngine(deps),
+    bilibili: (deps) => bilibiliEngine(deps),
+    v2ex: () => v2exEngine(),
+    youtube: (deps) => youtubeEngine(deps),
+    arxiv: () => arxivEngine(),
+    pubmed: () => pubmedEngine(),
+};
+export class SearchRouter {
+    ctx;
+    config;
+    store;
+    dynamic;
+    browser;
+    memory;
+    constructor(ctx, config, store, dynamic = () => config, browser, memory = new LruCache(config.memoryCacheEntries)) {
+        this.ctx = ctx;
+        this.config = config;
+        this.store = store;
+        this.dynamic = dynamic;
+        this.browser = browser;
+        this.memory = memory;
+    }
+    /** Resolve a key through credentials first, then process env. */
+    async resolveKey(ref, literal) {
+        if (literal && literal.length > 0)
+            return literal;
+        const credentials = this.ctx.get('credentials');
+        if (credentials) {
+            try {
+                const resolved = await credentials.resolve(credentialRef(ref));
+                if (resolved?.value)
+                    return resolved.value;
+            }
+            catch { /* fall through to env */ }
+        }
+        return process.env[ref];
+    }
+    async deps(skipSeam) {
+        const cfg = this.dynamic();
+        const web = this.ctx.get('web');
+        const exaApiKey = await this.resolveKey(cfg.exaApiKeyEnv, cfg.exaApiKey);
+        const jinaApiKey = await this.resolveKey(cfg.jinaApiKeyEnv, cfg.jinaApiKey);
+        return {
+            ...web !== undefined ? { web } : {},
+            ...exaApiKey ? { exaApiKey } : {},
+            ...jinaApiKey ? { jinaApiKey } : {},
+            enableCli: cfg.enableCliBackends,
+            opencliEnabled: cfg.opencliEnabled,
+            agentReachEnabled: cfg.agentReachEnabled,
+            ...this.browser !== undefined ? { browser: this.browser } : {},
+            ...cfg.platformRules !== undefined ? { platformRules: cfg.platformRules } : {},
+            ...cfg.customPlatforms !== undefined ? { customPlatforms: cfg.customPlatforms } : {},
+            skipSeam,
+        };
+    }
+    /** Sync key check for available() (no credential resolution — env/literal only). */
+    depsSync(skipSeam) {
+        const cfg = this.dynamic();
+        const web = this.ctx.get('web');
+        const exaApiKey = cfg.exaApiKey || process.env[cfg.exaApiKeyEnv];
+        const jinaApiKey = cfg.jinaApiKey || process.env[cfg.jinaApiKeyEnv];
+        return {
+            ...web !== undefined ? { web } : {},
+            ...exaApiKey ? { exaApiKey } : {},
+            ...jinaApiKey ? { jinaApiKey } : {},
+            enableCli: cfg.enableCliBackends,
+            opencliEnabled: cfg.opencliEnabled,
+            agentReachEnabled: cfg.agentReachEnabled,
+            ...this.browser !== undefined ? { browser: this.browser } : {},
+            ...cfg.platformRules !== undefined ? { platformRules: cfg.platformRules } : {},
+            ...cfg.customPlatforms !== undefined ? { customPlatforms: cfg.customPlatforms } : {},
+            skipSeam,
+        };
+    }
+    /** Whether any configured engine is currently usable. */
+    anyEngineAvailable() {
+        const ids = this.dynamic().engines;
+        return ids.some(id => this.buildSync(id, false).available());
+    }
+    async build(id, skipSeam) {
+        const factory = ENGINE_FACTORIES[id];
+        if (!factory)
+            throw new EngineError('unknown engine: ' + id, 'ENGINE_UNAVAILABLE', false);
+        return factory(await this.deps(skipSeam), this.dynamic());
+    }
+    buildSync(id, skipSeam) {
+        const factory = ENGINE_FACTORIES[id];
+        if (!factory)
+            throw new EngineError('unknown engine: ' + id, 'ENGINE_UNAVAILABLE', false);
+        return factory(this.depsSync(skipSeam), this.dynamic());
+    }
+    /** Run a full search with caching + persistence. */
+    async search(opts) {
+        const query = opts.query.trim();
+        if (!query)
+            throw new Error('query must be a non-empty string');
+        const cfg = this.dynamic();
+        const ids = (opts.engines && opts.engines.length ? opts.engines : cfg.engines)
+            .filter((id, i, arr) => arr.indexOf(id) === i);
+        const nq = normQuery(query);
+        const count = Math.min(Math.max(opts.count, 1), 20);
+        // 1. In-process LRU cache, then SQLite.
+        if (!opts.fresh) {
+            for (const id of ids) {
+                const hot = this.memory.get(id + '|' + nq, cfg.ttlSeconds * 1000);
+                if (hot)
+                    return { ...hot, fromCache: true, enginesTried: [id] };
+            }
+            for (const id of ids) {
+                const cached = this.store.getCachedSearch(id, nq, cfg.ttlSeconds);
+                if (cached) {
+                    const rows = this.store.resultsForQuery(cached.id);
+                    if (rows.length) {
+                        let detail;
+                        if (cached.detail) {
+                            try {
+                                detail = JSON.parse(cached.detail);
+                            }
+                            catch { /* ignore */ }
+                        }
+                        return {
+                            ...detail?.content ? { content: detail.content } : {},
+                            sources: rows.map(r => ({
+                                url: r.url,
+                                ...r.title ? { title: r.title } : {},
+                                ...r.snippet ? { snippet: r.snippet } : {},
+                                ...r.published ? { publishedAt: r.published } : {},
+                            })),
+                            engine: id,
+                            enginesTried: [id],
+                            fromCache: true,
+                        };
+                    }
+                }
+            }
+        }
+        // 2. Run engines.
+        const enginesTried = [];
+        let outcome;
+        let usedId;
+        const signal = opts.signal;
+        if (opts.multi) {
+            const results = await Promise.allSettled(ids.map(async (id) => {
+                const engine = await this.build(id, opts.skipSeam ?? false);
+                if (!engine.available())
+                    throw new EngineError(engine.label + ' unavailable', 'ENGINE_UNAVAILABLE', false);
+                return { id, outcome: await engine.search(query, count, signal) };
+            }));
+            enginesTried.push(...ids);
+            // Reciprocal Rank Fusion + freshness/authority signals (Argo-style
+            // evidence credibility): each engine's rank order contributes 1/(k+rank);
+            // recency and authoritative domains add a bounded bonus so a recent,
+            // trustworthy source can edge out an older, lower-authority one.
+            const k = Math.max(cfg.rrfConstant, 1);
+            const scores = new Map();
+            const entries = new Map();
+            const freshnessBoost = Math.min(Math.max(cfg.freshnessBoost, 0), 1);
+            const authorityBoost = Math.min(Math.max(cfg.authorityBoost, 0), 1);
+            const freshnessDays = Math.max(cfg.freshnessDays, 1);
+            const authorityDomains = [...cfg.authorityDomains, 'github.com', 'wikipedia.org', 'arxiv.org', 'pubmed.ncbi.nlm.nih.gov', 'stackoverflow.com', 'developer.mozilla.org'];
+            for (const r of results) {
+                if (r.status !== 'fulfilled')
+                    continue;
+                r.value.outcome.sources.forEach((s, rank) => {
+                    if (!s.url)
+                        return;
+                    let score = scores.get(s.url) ?? 0;
+                    score += 1 / (k + rank + 1);
+                    if (freshnessBoost > 0 && s.publishedAt) {
+                        const published = Date.parse(s.publishedAt);
+                        if (!Number.isNaN(published)) {
+                            const ageDays = (Date.now() - published) / 86400_000;
+                            if (ageDays >= 0)
+                                score += freshnessBoost * Math.max(0, 1 - ageDays / freshnessDays);
+                        }
+                    }
+                    if (authorityBoost > 0) {
+                        let host = '';
+                        try {
+                            host = new URL(s.url).hostname.toLowerCase();
+                        }
+                        catch { /* ignore */ }
+                        const isAuthority = authorityDomains.some(d => host === d || host.endsWith('.' + d))
+                            || /(^|\.)(edu|gov|org)$/.test(host);
+                        if (isAuthority)
+                            score += authorityBoost;
+                    }
+                    scores.set(s.url, score);
+                    if (!entries.has(s.url)) {
+                        entries.set(s.url, { url: s.url, ...s.title ? { title: s.title } : {}, ...s.snippet ? { snippet: s.snippet } : {}, ...s.publishedAt ? { publishedAt: s.publishedAt } : {} });
+                    }
+                });
+            }
+            if (!scores.size)
+                throw new Error('all engines failed: ' + enginesTried.join(', '));
+            const ranked = [...scores.entries()].sort((a, b) => b[1] - a[1]).slice(0, count);
+            outcome = { sources: ranked.map(([url]) => entries.get(url)) };
+            usedId = 'multi(' + ids.join('+') + ')';
+        }
+        else {
+            for (const id of ids) {
+                enginesTried.push(id);
+                const engine = await this.build(id, opts.skipSeam ?? false);
+                if (!engine.available())
+                    continue;
+                try {
+                    outcome = await engine.search(query, count, signal);
+                    usedId = id;
+                    break;
+                }
+                catch (error) {
+                    if (signal?.aborted)
+                        throw error;
+                    // keep trying the next engine on failure
+                }
+            }
+            if (!outcome || !usedId) {
+                throw new Error('no engine produced results (tried: ' + enginesTried.join(', ') + ')');
+            }
+        }
+        // 3. Persist.
+        const queryId = this.store.recordQuery({
+            kind: 'search',
+            query: nq,
+            engine: usedId,
+            status: 'ok',
+            ...outcome.content ? { detail: JSON.stringify({ content: outcome.content }) } : {},
+        });
+        this.store.recordResults(queryId, outcome.sources, usedId);
+        const result = {
+            ...outcome.content ? { content: outcome.content } : {},
+            sources: outcome.sources.slice(0, count).map(s => ({
+                url: s.url,
+                ...s.title ? { title: s.title } : {},
+                ...s.snippet ? { snippet: capText(s.snippet, 500) } : {},
+                ...s.publishedAt ? { publishedAt: s.publishedAt } : {},
+            })),
+            engine: usedId,
+            enginesTried,
+            fromCache: false,
+        };
+        // 4. Warm the in-process LRU (memory-only; survives across SQLite hits).
+        this.memory.set(usedId + '|' + nq, result);
+        return result;
+    }
+    /** Platform search (web_platform_search tool) with the same cache+persist flow. */
+    async platformSearch(platform, query, url, count, opts) {
+        const nq = normQuery(query || url || platform);
+        const custom = this.dynamic().customPlatforms?.[platform];
+        const engines = custom
+            ? [customPlatformEngine(platform, custom, this.depsSync(true))]
+            : (platform === 'rss' && url ? [rssEngine(url)] : platformEngines(platform, this.depsSync(true)));
+        if (!engines.length)
+            throw new Error('unsupported platform: ' + platform);
+        if (!opts.fresh) {
+            const cached = this.store.getCachedSearch('platform-' + platform, nq, this.dynamic().ttlSeconds);
+            if (cached) {
+                const rows = this.store.resultsForQuery(cached.id);
+                if (rows.length) {
+                    return {
+                        sources: rows.map(r => ({ url: r.url, ...r.title ? { title: r.title } : {}, ...r.snippet ? { snippet: r.snippet } : {} })),
+                        engine: platform,
+                        enginesTried: [platform],
+                        fromCache: true,
+                    };
+                }
+            }
+        }
+        const enginesTried = [];
+        let outcome;
+        for (const engine of engines) {
+            enginesTried.push(engine.id);
+            if (!engine.available())
+                continue;
+            try {
+                outcome = await engine.search(query || 'latest', Math.min(Math.max(count, 1), 20), opts.signal);
+                break;
+            }
+            catch (error) {
+                if (opts.signal?.aborted)
+                    throw error;
+            }
+        }
+        if (!outcome)
+            throw new Error('platform ' + platform + ' unavailable (tried: ' + enginesTried.join(', ') + ')');
+        const queryId = this.store.recordQuery({
+            kind: 'platform',
+            query: nq,
+            platform,
+            engine: enginesTried.at(-1) ?? 'unknown',
+            status: 'ok',
+        });
+        this.store.recordResults(queryId, outcome.sources, 'platform-' + platform);
+        return { sources: outcome.sources, engine: platform, enginesTried, fromCache: false };
+    }
+    /**
+     * ctx.web provider adapter: route the seam request through this router.
+     * Returns a WebSearchResult-shaped value for the built-in web_search tool.
+     */
+    async searchAsProvider(request, signal) {
+        const cfg = this.dynamic();
+        const result = await this.search({
+            query: request.query,
+            count: request.maxResults ?? cfg.searchMaxResults,
+            fresh: false,
+            multi: cfg.parallelEngines,
+            signal,
+            skipSeam: true,
+        });
+        return {
+            ...result.content ? { content: result.content } : {},
+            sources: result.sources.map(s => ({ url: s.url, ...s.title ? { title: s.title } : {}, ...s.snippet ? { snippet: s.snippet } : {}, ...s.publishedAt ? { publishedAt: s.publishedAt } : {} })),
+            truncated: result.sources.length > (request.maxResults ?? cfg.searchMaxResults),
+        };
+    }
+}
+//# sourceMappingURL=router.js.map

package/lib/router.js.map

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

package/lib/store.d.ts

@@ -0,0 +1,117 @@
+/**
+ * SQLite persistence for web-search-pro (node:sqlite, zero dependencies).
+ * Stores search queries + results, fetched page snapshots, and user-extended
+ * extraction rules (userscript-style). All methods are synchronous; writes are
+ * small and batched per call.
+ * @module web-search-pro/store
+ */
+export type QueryKind = 'search' | 'fetch' | 'platform' | 'snapshot';
+export interface QueryRecord {
+    id: string;
+    kind: QueryKind;
+    query?: string;
+    engine?: string;
+    platform?: string;
+    url?: string;
+    status: string;
+    ts: string;
+    detail?: string;
+}
+export interface SourceRow {
+    id: string;
+    queryId: string;
+    rank: number;
+    url: string;
+    title?: string;
+    snippet?: string;
+    published?: string;
+    engine?: string;
+    extra?: string;
+}
+export interface PageRecord {
+    id: string;
+    url: string;
+    title?: string;
+    text?: string;
+    htmlPath?: string;
+    screenshotPath?: string;
+    status?: number;
+    fetchedAt: string;
+    source?: string;
+}
+export interface RuleRecord {
+    hostname: string;
+    content: string;
+    remove?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class Store {
+    readonly dbPath: string;
+    private db;
+    constructor(dbPath: string);
+    close(): void;
+    /** Record one operation (search / fetch / platform / snapshot). Returns its id. */
+    recordQuery(input: Omit<QueryRecord, 'id' | 'ts'> & {
+        id?: string;
+    }): string;
+    /** Look up a fresh cached search by (engine, normalized query). */
+    getCachedSearch(engine: string, normQuery: string, ttlSeconds: number): {
+        id: string;
+        detail?: string;
+    } | undefined;
+    recordResults(queryId: string, sources: {
+        url: string;
+        title?: string;
+        snippet?: string;
+        publishedAt?: string;
+        extra?: string;
+    }[], engine: string): void;
+    resultsForQuery(queryId: string): SourceRow[];
+    /** Fresh page snapshot by URL, or undefined. */
+    getPage(url: string, ttlSeconds: number): PageRecord | undefined;
+    savePage(input: Omit<PageRecord, 'id' | 'fetchedAt'>): void;
+    listQueries(opts: {
+        kind?: QueryKind;
+        query?: string;
+        engine?: string;
+        platform?: string;
+        limit?: number;
+    }): QueryRecord[];
+    clearCache(opts: {
+        olderThanDays?: number;
+        engine?: string;
+    }): {
+        queries: number;
+        results: number;
+        pages: number;
+    };
+    private removeQuery;
+    /** Delete one query and its results; returns whether it existed. */
+    deleteQuery(id: string): boolean;
+    /** Most-used engines, desc. */
+    topEngines(limit?: number): {
+        engine: string;
+        count: number;
+    }[];
+    /** Most-frequent queries, desc. */
+    topQueries(limit?: number): {
+        query: string;
+        count: number;
+    }[];
+    /** Per-kind record counts. */
+    kindCounts(): {
+        kind: string;
+        count: number;
+    }[];
+    stats(): {
+        dbSizeBytes: number;
+        queries: number;
+        results: number;
+        pages: number;
+        rules: number;
+    };
+    listRules(): RuleRecord[];
+    upsertRule(hostname: string, content: string, remove?: string): void;
+    removeRule(hostname: string): boolean;
+}