@aria-cli/tools 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"brave.d.ts","sourceRoot":"","sources":["../../src/providers/brave.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAG9B,qBAAa,mBAAoB,YAAW,cAAc;IAMtD,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,cAAc,QAAQ;IAC/B,QAAQ,CAAC,QAAQ,KAAK;gBAGH,GAAG,GAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe;IAG5F,WAAW,IAAI,OAAO;IAKhB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAyD9E"}

package/dist/providers/brave.js

@@ -0,0 +1,63 @@
+import { createProviderAbortSignal, resolveSearchProviderEnv } from "./search-provider.js";
+export class BraveSearchProvider {
+    env;
+    name = "brave";
+    requiresApiKey = true;
+    priority = 1;
+    constructor(env = process.env) {
+        this.env = env;
+    }
+    isAvailable() {
+        const apiKey = resolveSearchProviderEnv(this.env).BRAVE_API_KEY;
+        return Boolean(apiKey && apiKey.trim().length > 0);
+    }
+    async search(query, options) {
+        const apiKey = resolveSearchProviderEnv(this.env).BRAVE_API_KEY;
+        if (!apiKey) {
+            throw new Error("BRAVE_API_KEY environment variable is not set");
+        }
+        const limit = options?.limit ?? 5;
+        const url = new URL("https://api.search.brave.com/res/v1/web/search");
+        url.searchParams.set("q", query);
+        url.searchParams.set("count", String(limit));
+        // Handle timeRange option (map to Brave's freshness parameter)
+        if (options?.timeRange) {
+            const freshnessMap = {
+                day: "pd",
+                week: "pw",
+                month: "pm",
+                year: "py",
+            };
+            const freshness = freshnessMap[options.timeRange];
+            if (freshness) {
+                url.searchParams.set("freshness", freshness);
+            }
+        }
+        const { signal, cleanup } = createProviderAbortSignal(30_000, options?.signal);
+        try {
+            const response = await fetch(url.toString(), {
+                method: "GET",
+                headers: {
+                    Accept: "application/json",
+                    "X-Subscription-Token": apiKey,
+                },
+                signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Brave Search API error: ${response.status} ${response.statusText}`);
+            }
+            const json = await response.json();
+            const webResults = json.web?.results || [];
+            return webResults.map((r) => ({
+                title: r.title,
+                url: r.url,
+                content: r.description,
+                score: r.relevance_score,
+            }));
+        }
+        finally {
+            cleanup();
+        }
+    }
+}
+//# sourceMappingURL=brave.js.map

package/dist/providers/brave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.js","sourceRoot":"","sources":["../../src/providers/brave.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,MAAM,OAAO,mBAAmB;IAMX;IALV,IAAI,GAAG,OAAO,CAAC;IACf,cAAc,GAAG,IAAI,CAAC;IACtB,QAAQ,GAAG,CAAC,CAAC;IAEtB,YACmB,MAA8D,OAAO,CAAC,GAAG;QAAzE,QAAG,GAAH,GAAG,CAAsE;IACzF,CAAC;IAEJ,WAAW;QACT,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC;QAChE,OAAO,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QACjD,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC;QAChE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAElC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,gDAAgD,CAAC,CAAC;QACtE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAE7C,+DAA+D;QAC/D,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,MAAM,YAAY,GAA2B;gBAC3C,GAAG,EAAE,IAAI;gBACT,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,IAAI;aACX,CAAC;YACF,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,SAAS,EAAE,CAAC;gBACd,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBAC3C,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,MAAM,EAAE,kBAAkB;oBAC1B,sBAAsB,EAAE,MAAM;iBAC/B;gBACD,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACvF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC;YAE3C,OAAO,UAAU,CAAC,GAAG,CACnB,CAAC,CAAgF,EAAE,EAAE,CAAC,CAAC;gBACrF,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,WAAW;gBACtB,KAAK,EAAE,CAAC,CAAC,eAAe;aACzB,CAAC,CACH,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/providers/duckduckgo.d.ts

@@ -0,0 +1,19 @@
+import type { SearchProvider, SearchOptions, SearchResult } from "./search-provider.js";
+export declare class DuckDuckGoSearchProvider implements SearchProvider {
+    readonly name = "duckduckgo";
+    readonly requiresApiKey = false;
+    readonly priority = 6;
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Strip HTML tags from a string
+     */
+    private stripHtmlTags;
+    /**
+     * Decode HTML entities in URLs
+     */
+    private decodeHtmlEntities;
+    private resolveDuckDuckGoResultUrl;
+    private normalizeResultUrl;
+}
+//# sourceMappingURL=duckduckgo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckduckgo.d.ts","sourceRoot":"","sources":["../../src/providers/duckduckgo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGxF,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,cAAc,SAAS;IAChC,QAAQ,CAAC,QAAQ,KAAK;IAEtB,WAAW,IAAI,OAAO;IAKhB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyF7E;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,kBAAkB;CAqC3B"}

package/dist/providers/duckduckgo.js

@@ -0,0 +1,177 @@
+import { createProviderAbortSignal } from "./search-provider.js";
+export class DuckDuckGoSearchProvider {
+    name = "duckduckgo";
+    requiresApiKey = false;
+    priority = 6;
+    isAvailable() {
+        // DuckDuckGo is always available (no API key required)
+        return true;
+    }
+    async search(query, options) {
+        const limit = options?.limit ?? 5;
+        // DuckDuckGo HTML search endpoint (we'll parse the HTML response)
+        // The Instant Answer API doesn't provide web search results, only factoids
+        const url = new URL("https://html.duckduckgo.com/html/");
+        url.searchParams.set("q", query);
+        const { signal, cleanup } = createProviderAbortSignal(30_000, options?.signal);
+        try {
+            const response = await fetch(url.toString(), {
+                method: "GET",
+                signal,
+                headers: {
+                    "User-Agent": "Mozilla/5.0 (compatible; ARIA/1.0)",
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`DuckDuckGo Search error: ${response.status} ${response.statusText}`);
+            }
+            const html = await response.text();
+            // Parse HTML to extract search results
+            // DuckDuckGo HTML results have result__a (title/url) and result__snippet (description)
+            const results = [];
+            // First pass: extract all result__a links (title + url)
+            const linkMap = new Map();
+            const linkRegex = /<a(?=[^>]*\bclass=(["'])[^"']*\bresult__a\b[^"']*\1)(?=[^>]*\bhref=(["'])(.*?)\2)[^>]*>([\s\S]*?)<\/a>/gi;
+            let match;
+            let resultAnchorCount = 0;
+            while ((match = linkRegex.exec(html)) !== null) {
+                const rawHref = match[3];
+                const rawTitle = match[4];
+                if (!rawHref || !rawTitle) {
+                    continue;
+                }
+                resultAnchorCount++;
+                const url = this.resolveDuckDuckGoResultUrl(rawHref);
+                if (!url) {
+                    continue;
+                }
+                const title = this.stripHtmlTags(rawTitle);
+                if (!title) {
+                    continue;
+                }
+                linkMap.set(url, { title, url });
+            }
+            // If DDG returned result anchors but we extracted zero usable URLs, parsing is stale.
+            // Throw to allow router fallback rather than silently returning empty results.
+            if (resultAnchorCount > 0 && linkMap.size === 0) {
+                throw new Error("Could not resolve any result URLs from DuckDuckGo response");
+            }
+            // Second pass: extract snippets
+            const snippetRegex = /<(?:a|div|span)(?=[^>]*\bclass=(["'])[^"']*\bresult__snippet\b[^"']*\1)[^>]*>([\s\S]*?)<\/(?:a|div|span)>/gi;
+            const snippets = [];
+            while ((match = snippetRegex.exec(html)) !== null) {
+                const rawSnippet = match[2];
+                snippets.push(this.stripHtmlTags(rawSnippet ?? ""));
+            }
+            // Combine results (matching by order, which should align)
+            const linkEntries = Array.from(linkMap.values());
+            for (let i = 0; i < Math.min(linkEntries.length, limit); i++) {
+                const link = linkEntries[i];
+                if (!link) {
+                    continue;
+                }
+                const snippet = snippets[i] || link.title;
+                results.push({
+                    title: link.title,
+                    url: link.url,
+                    content: snippet,
+                });
+            }
+            return results;
+        }
+        finally {
+            cleanup();
+        }
+    }
+    /**
+     * Strip HTML tags from a string
+     */
+    stripHtmlTags(html) {
+        return html
+            .replace(/<[^>]*>/g, "")
+            .replace(/&nbsp;/g, " ")
+            .replace(/&amp;/g, "&")
+            .replace(/&lt;/g, "<")
+            .replace(/&gt;/g, ">")
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'")
+            .trim();
+    }
+    /**
+     * Decode HTML entities in URLs
+     */
+    decodeHtmlEntities(text) {
+        return text
+            .replace(/&amp;/g, "&")
+            .replace(/&lt;/g, "<")
+            .replace(/&gt;/g, ">")
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'");
+    }
+    resolveDuckDuckGoResultUrl(rawHref) {
+        const decodedHref = this.decodeHtmlEntities(rawHref).trim();
+        if (!decodedHref) {
+            return null;
+        }
+        let absoluteHref = decodedHref;
+        if (absoluteHref.startsWith("//")) {
+            absoluteHref = `https:${absoluteHref}`;
+        }
+        else if (absoluteHref.startsWith("/")) {
+            absoluteHref = `https://duckduckgo.com${absoluteHref}`;
+        }
+        let parsed;
+        try {
+            parsed = new URL(absoluteHref);
+        }
+        catch {
+            return null;
+        }
+        const hostname = parsed.hostname.toLowerCase();
+        if (hostname === "duckduckgo.com" || hostname.endsWith(".duckduckgo.com")) {
+            const redirected = parsed.searchParams.get("uddg");
+            if (!redirected) {
+                return null;
+            }
+            return this.normalizeResultUrl(redirected);
+        }
+        return this.normalizeResultUrl(absoluteHref);
+    }
+    normalizeResultUrl(candidate) {
+        let value = candidate.trim();
+        if (!value) {
+            return null;
+        }
+        if (value.startsWith("//")) {
+            value = `https:${value}`;
+        }
+        // Some uddg values are encoded multiple times; decode at most twice.
+        for (let i = 0; i < 2; i++) {
+            try {
+                const decoded = decodeURIComponent(value);
+                if (decoded === value) {
+                    break;
+                }
+                value = decoded;
+            }
+            catch {
+                break;
+            }
+        }
+        try {
+            const parsed = new URL(value);
+            if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+                return null;
+            }
+            const hostname = parsed.hostname.toLowerCase();
+            if (hostname === "duckduckgo.com" || hostname.endsWith(".duckduckgo.com")) {
+                return null;
+            }
+            return parsed.toString();
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=duckduckgo.js.map

package/dist/providers/duckduckgo.js.map

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

package/dist/providers/exa.d.ts

@@ -0,0 +1,11 @@
+import type { SearchProvider, SearchOptions, SearchResult, SearchProviderEnv } from "./search-provider.js";
+export declare class ExaSearchProvider implements SearchProvider {
+    private readonly env;
+    readonly name = "exa";
+    readonly requiresApiKey = true;
+    readonly priority = 3;
+    constructor(env?: SearchProviderEnv | Record<string, string | undefined>);
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=exa.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exa.d.ts","sourceRoot":"","sources":["../../src/providers/exa.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAG9B,qBAAa,iBAAkB,YAAW,cAAc;IAMpD,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,cAAc,QAAQ;IAC/B,QAAQ,CAAC,QAAQ,KAAK;gBAGH,GAAG,GAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe;IAG5F,WAAW,IAAI,OAAO;IAKhB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA8D9E"}

package/dist/providers/exa.js

@@ -0,0 +1,64 @@
+import { createProviderAbortSignal, resolveSearchProviderEnv } from "./search-provider.js";
+export class ExaSearchProvider {
+    env;
+    name = "exa";
+    requiresApiKey = true;
+    priority = 3;
+    constructor(env = process.env) {
+        this.env = env;
+    }
+    isAvailable() {
+        const apiKey = resolveSearchProviderEnv(this.env).EXA_API_KEY;
+        return Boolean(apiKey && apiKey.trim().length > 0);
+    }
+    async search(query, options) {
+        const apiKey = resolveSearchProviderEnv(this.env).EXA_API_KEY;
+        if (!apiKey) {
+            throw new Error("EXA_API_KEY environment variable is not set");
+        }
+        const limit = options?.limit ?? 5;
+        const body = {
+            query,
+            numResults: limit,
+            useAutoprompt: true,
+            contents: {
+                text: true,
+            },
+        };
+        // Domain filtering
+        if (options?.domains) {
+            body.includeDomains = options.domains;
+        }
+        if (options?.excludeDomains) {
+            body.excludeDomains = options.excludeDomains;
+        }
+        const { signal, cleanup } = createProviderAbortSignal(30_000, options?.signal);
+        try {
+            const response = await fetch("https://api.exa.ai/search", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": apiKey,
+                },
+                body: JSON.stringify(body),
+                signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Exa Search API error: ${response.status} ${response.statusText}`);
+            }
+            const json = await response.json();
+            const results = (json.results || []);
+            return results.map((r) => ({
+                title: r.title,
+                url: r.url,
+                content: r.text || "",
+                score: r.score,
+                publishedDate: r.publishedDate,
+            }));
+        }
+        finally {
+            cleanup();
+        }
+    }
+}
+//# sourceMappingURL=exa.js.map

package/dist/providers/exa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.js","sourceRoot":"","sources":["../../src/providers/exa.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,MAAM,OAAO,iBAAiB;IAMT;IALV,IAAI,GAAG,KAAK,CAAC;IACb,cAAc,GAAG,IAAI,CAAC;IACtB,QAAQ,GAAG,CAAC,CAAC;IAEtB,YACmB,MAA8D,OAAO,CAAC,GAAG;QAAzE,QAAG,GAAH,GAAG,CAAsE;IACzF,CAAC;IAEJ,WAAW;QACT,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QAC9D,OAAO,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QACjD,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAA4B;YACpC,KAAK;YACL,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,IAAI;YACnB,QAAQ,EAAE;gBACR,IAAI,EAAE,IAAI;aACX;SACF,CAAC;QAEF,mBAAmB;QACnB,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;QACxC,CAAC;QACD,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;YAC5B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC/C,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,2BAA2B,EAAE;gBACxD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,WAAW,EAAE,MAAM;iBACpB;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACrF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAMjC,CAAC;YAEH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;gBACrB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,aAAa,EAAE,CAAC,CAAC,aAAa;aAC/B,CAAC,CAAC,CAAC;QACN,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/providers/firecrawl.d.ts

@@ -0,0 +1,11 @@
+import type { SearchProvider, SearchOptions, SearchResult, SearchProviderEnv } from "./search-provider.js";
+export declare class FirecrawlSearchProvider implements SearchProvider {
+    private readonly env;
+    readonly name = "firecrawl";
+    readonly requiresApiKey = true;
+    readonly priority = 2;
+    constructor(env?: SearchProviderEnv | Record<string, string | undefined>);
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=firecrawl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firecrawl.d.ts","sourceRoot":"","sources":["../../src/providers/firecrawl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAG9B,qBAAa,uBAAwB,YAAW,cAAc;IAM1D,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,cAAc,QAAQ;IAC/B,QAAQ,CAAC,QAAQ,KAAK;gBAGH,GAAG,GAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe;IAG5F,WAAW,IAAI,OAAO;IAKhB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAsD9E"}

package/dist/providers/firecrawl.js

@@ -0,0 +1,56 @@
+import { createProviderAbortSignal, resolveSearchProviderEnv } from "./search-provider.js";
+export class FirecrawlSearchProvider {
+    env;
+    name = "firecrawl";
+    requiresApiKey = true;
+    priority = 2;
+    constructor(env = process.env) {
+        this.env = env;
+    }
+    isAvailable() {
+        const apiKey = resolveSearchProviderEnv(this.env).FIRECRAWL_API_KEY;
+        return Boolean(apiKey && apiKey.trim().length > 0);
+    }
+    async search(query, options) {
+        const apiKey = resolveSearchProviderEnv(this.env).FIRECRAWL_API_KEY;
+        if (!apiKey) {
+            throw new Error("FIRECRAWL_API_KEY environment variable is not set");
+        }
+        const limit = options?.limit ?? 5;
+        const body = {
+            query,
+            limit,
+        };
+        const { signal, cleanup } = createProviderAbortSignal(30_000, options?.signal);
+        try {
+            const response = await fetch("https://api.firecrawl.dev/v1/search", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify(body),
+                signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Firecrawl Search API error: ${response.status} ${response.statusText}`);
+            }
+            const json = await response.json();
+            // Firecrawl can return 200 with success: false
+            if (json.success === false) {
+                throw new Error(`Firecrawl API error: ${json.error || "Unknown error"}`);
+            }
+            const results = (json.data || []);
+            return results.map((r) => ({
+                title: r.title,
+                url: r.url,
+                content: r.markdown || "",
+                score: r.score,
+            }));
+        }
+        finally {
+            cleanup();
+        }
+    }
+}
+//# sourceMappingURL=firecrawl.js.map

package/dist/providers/firecrawl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firecrawl.js","sourceRoot":"","sources":["../../src/providers/firecrawl.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,MAAM,OAAO,uBAAuB;IAMf;IALV,IAAI,GAAG,WAAW,CAAC;IACnB,cAAc,GAAG,IAAI,CAAC;IACtB,QAAQ,GAAG,CAAC,CAAC;IAEtB,YACmB,MAA8D,OAAO,CAAC,GAAG;QAAzE,QAAG,GAAH,GAAG,CAAsE;IACzF,CAAC;IAEJ,WAAW;QACT,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC;QACpE,OAAO,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QACjD,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC;QACpE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAElC,MAAM,IAAI,GAA4B;YACpC,KAAK;YACL,KAAK;SACN,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,qCAAqC,EAAE;gBAClE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,MAAM,EAAE;iBAClC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC3F,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,+CAA+C;YAC/C,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;YAC3E,CAAC;YAED,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAK9B,CAAC;YAEH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;gBACzB,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC,CAAC;QACN,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/providers/index.d.ts

@@ -0,0 +1,9 @@
+export type { SearchOptions, SearchResult, SearchProvider } from "./search-provider.js";
+export { JinaSearchProvider } from "./jina.js";
+export { DuckDuckGoSearchProvider } from "./duckduckgo.js";
+export { TavilySearchProvider } from "./tavily.js";
+export { BraveSearchProvider } from "./brave.js";
+export { ExaSearchProvider } from "./exa.js";
+export { FirecrawlSearchProvider } from "./firecrawl.js";
+export { SearchProviderRouter } from "./router.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,8 @@
+export { JinaSearchProvider } from "./jina.js";
+export { DuckDuckGoSearchProvider } from "./duckduckgo.js";
+export { TavilySearchProvider } from "./tavily.js";
+export { BraveSearchProvider } from "./brave.js";
+export { ExaSearchProvider } from "./exa.js";
+export { FirecrawlSearchProvider } from "./firecrawl.js";
+export { SearchProviderRouter } from "./router.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers/jina.d.ts

@@ -0,0 +1,11 @@
+import type { SearchProvider, SearchOptions, SearchResult, SearchProviderEnv } from "./search-provider.js";
+export declare class JinaSearchProvider implements SearchProvider {
+    private readonly env;
+    readonly name = "jina";
+    readonly requiresApiKey = false;
+    readonly priority = 5;
+    constructor(env?: SearchProviderEnv | Record<string, string | undefined>);
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=jina.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jina.d.ts","sourceRoot":"","sources":["../../src/providers/jina.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAG9B,qBAAa,kBAAmB,YAAW,cAAc;IAMrD,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,cAAc,SAAS;IAChC,QAAQ,CAAC,QAAQ,KAAK;gBAGH,GAAG,GAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe;IAG5F,WAAW,IAAI,OAAO;IAKhB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA+C9E"}

package/dist/providers/jina.js

@@ -0,0 +1,50 @@
+import { createProviderAbortSignal, resolveSearchProviderEnv } from "./search-provider.js";
+export class JinaSearchProvider {
+    env;
+    name = "jina";
+    requiresApiKey = false;
+    priority = 5;
+    constructor(env = process.env) {
+        this.env = env;
+    }
+    isAvailable() {
+        // Jina works without an API key (20 req/min), or with a key (200 req/min)
+        return true;
+    }
+    async search(query, options) {
+        const apiKey = resolveSearchProviderEnv(this.env).JINA_API_KEY;
+        const limit = options?.limit ?? 5;
+        const url = new URL("https://s.jina.ai/");
+        url.searchParams.set("q", query);
+        const headers = {
+            Accept: "application/json",
+        };
+        if (apiKey) {
+            headers.Authorization = `Bearer ${apiKey}`;
+        }
+        const { signal, cleanup } = createProviderAbortSignal(30_000, options?.signal);
+        try {
+            const response = await fetch(url.toString(), {
+                method: "GET",
+                headers,
+                signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Jina Search API error: ${response.status} ${response.statusText}`);
+            }
+            const json = await response.json();
+            const results = (json.data || []);
+            // Apply limit client-side
+            return results.slice(0, limit).map((r) => ({
+                title: r.title,
+                url: r.url,
+                content: r.content,
+                score: r.score,
+            }));
+        }
+        finally {
+            cleanup();
+        }
+    }
+}
+//# sourceMappingURL=jina.js.map

package/dist/providers/jina.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jina.js","sourceRoot":"","sources":["../../src/providers/jina.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,MAAM,OAAO,kBAAkB;IAMV;IALV,IAAI,GAAG,MAAM,CAAC;IACd,cAAc,GAAG,KAAK,CAAC;IACvB,QAAQ,GAAG,CAAC,CAAC;IAEtB,YACmB,MAA8D,OAAO,CAAC,GAAG;QAAzE,QAAG,GAAH,GAAG,CAAsE;IACzF,CAAC;IAEJ,WAAW;QACT,0EAA0E;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QACjD,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC;QAC/D,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAElC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEjC,MAAM,OAAO,GAAgB;YAC3B,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QAEF,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,aAAa,GAAG,UAAU,MAAM,EAAE,CAAC;QAC7C,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBAC3C,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACtF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAK9B,CAAC;YAEH,0BAA0B;YAC1B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzC,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC,CAAC;QACN,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/providers/router.d.ts

@@ -0,0 +1,22 @@
+import type { SearchProvider, SearchOptions, SearchResult, SearchProviderEnv } from "./search-provider.js";
+export declare class SearchProviderRouter {
+    private _providers;
+    private readonly env;
+    constructor(_providers: SearchProvider[], env?: SearchProviderEnv | Record<string, string | undefined>);
+    /**
+     * Resolves the best available search provider.
+     * Priority:
+     * 1. Explicit override via ARIA_SEARCH_PROVIDER env var
+     * 2. Highest-priority available provider (lowest priority number)
+     * @throws {Error} if no providers are available or override is invalid
+     */
+    resolve(): SearchProvider;
+    /**
+     * Performs a search with automatic fallback.
+     * Tries providers in priority order (resolved provider first, then others).
+     * Circuit breaker: stops at first successful response.
+     * @throws {AggregateError} if all providers fail
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/providers/router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAG9B,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADZ,UAAU,EAAE,cAAc,EAAE,EACnB,GAAG,GAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe;IAG5F;;;;;;OAMG;IACH,OAAO,IAAI,cAAc;IAmCzB;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAyD9E"}