@aria-cli/tools 1.0.18 → 1.0.31

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/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-cjs/providers/index.d.ts → dist/providers/index.js}

@@ -1,4 +1,3 @@
-export type { SearchOptions, SearchResult, SearchProvider } from "./search-provider.js";
 export { JinaSearchProvider } from "./jina.js";
 export { DuckDuckGoSearchProvider } from "./duckduckgo.js";
 export { TavilySearchProvider } from "./tavily.js";
@@ -6,3 +5,4 @@ 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/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/router.js

@@ -0,0 +1,97 @@
+import { log } from "@aria-cli/types";
+import { resolveSearchProviderEnv } from "./search-provider.js";
+export class SearchProviderRouter {
+    _providers;
+    env;
+    constructor(_providers, env = process.env) {
+        this._providers = _providers;
+        this.env = env;
+    }
+    /**
+     * 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() {
+        const env = resolveSearchProviderEnv(this.env);
+        // 1. Check for explicit override
+        const override = env.ARIA_SEARCH_PROVIDER;
+        if (override) {
+            const provider = this._providers.find((p) => p.name === override);
+            if (!provider) {
+                throw new Error(`ARIA_SEARCH_PROVIDER override '${override}' not found in provider registry`);
+            }
+            // Verify the overridden provider is actually available (e.g., has API key)
+            if (!provider.isAvailable()) {
+                // Fall through to default priority-based routing
+                log.debug(`[SearchProviderRouter] ARIA_SEARCH_PROVIDER override '${override}' is not available, falling back to priority routing`);
+            }
+            else {
+                return provider;
+            }
+        }
+        // 2. Select first available provider by priority (lower number = higher priority)
+        const sorted = [...this._providers].sort((a, b) => a.priority - b.priority);
+        const available = sorted.find((p) => p.isAvailable());
+        if (!available) {
+            throw new Error("No search providers available. Set at least one API key (BRAVE_API_KEY, TAVILY_API_KEY, etc.)");
+        }
+        return available;
+    }
+    /**
+     * 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
+     */
+    async search(query, options) {
+        if (options?.signal?.aborted) {
+            throw new Error("Search aborted");
+        }
+        const env = resolveSearchProviderEnv(this.env);
+        // Get all available providers sorted by priority
+        const availableProviders = [...this._providers]
+            .filter((p) => p.isAvailable())
+            .sort((a, b) => a.priority - b.priority);
+        if (availableProviders.length === 0) {
+            throw new Error("No search providers available");
+        }
+        // Honor ARIA_SEARCH_PROVIDER override: try the override provider first
+        const override = env.ARIA_SEARCH_PROVIDER;
+        if (override) {
+            const overrideProvider = availableProviders.find((p) => p.name === override);
+            if (overrideProvider) {
+                // Move override provider to front of the list
+                const reordered = [
+                    overrideProvider,
+                    ...availableProviders.filter((p) => p.name !== override),
+                ];
+                availableProviders.length = 0;
+                availableProviders.push(...reordered);
+            }
+        }
+        const errors = [];
+        // Try each provider in order
+        for (const provider of availableProviders) {
+            if (options?.signal?.aborted) {
+                throw new Error("Search aborted");
+            }
+            try {
+                const results = await provider.search(query, options);
+                return results; // Circuit breaker: return on first success
+            }
+            catch (error) {
+                if (options?.signal?.aborted) {
+                    throw error instanceof Error ? error : new Error("Search aborted");
+                }
+                errors.push(error instanceof Error ? error : new Error(`Unknown error from ${provider.name}`));
+                // Continue to next provider
+            }
+        }
+        // All providers failed
+        throw new AggregateError(errors, `All search providers failed (tried ${availableProviders.length} providers)`);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/providers/search-provider.js

@@ -0,0 +1,33 @@
+export function resolveSearchProviderEnv(env = process.env) {
+    return {
+        ARIA_SEARCH_PROVIDER: env.ARIA_SEARCH_PROVIDER,
+        BRAVE_API_KEY: env.BRAVE_API_KEY,
+        FIRECRAWL_API_KEY: env.FIRECRAWL_API_KEY,
+        EXA_API_KEY: env.EXA_API_KEY,
+        TAVILY_API_KEY: env.TAVILY_API_KEY,
+        JINA_API_KEY: env.JINA_API_KEY,
+    };
+}
+export function createProviderAbortSignal(timeoutMs, callerSignal) {
+    const controller = new AbortController();
+    const onCallerAbort = () => controller.abort();
+    if (callerSignal) {
+        if (callerSignal.aborted) {
+            controller.abort();
+        }
+        else {
+            callerSignal.addEventListener("abort", onCallerAbort, { once: true });
+        }
+    }
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    return {
+        signal: controller.signal,
+        cleanup: () => {
+            clearTimeout(timeout);
+            if (callerSignal) {
+                callerSignal.removeEventListener("abort", onCallerAbort);
+            }
+        },
+    };
+}
+//# sourceMappingURL=search-provider.js.map

package/dist/providers/tavily.js

@@ -0,0 +1,55 @@
+import { createProviderAbortSignal, resolveSearchProviderEnv } from "./search-provider.js";
+export class TavilySearchProvider {
+    env;
+    name = "tavily";
+    requiresApiKey = true;
+    priority = 4;
+    constructor(env = process.env) {
+        this.env = env;
+    }
+    isAvailable() {
+        const apiKey = resolveSearchProviderEnv(this.env).TAVILY_API_KEY;
+        return Boolean(apiKey && apiKey.trim().length > 0);
+    }
+    async search(query, options) {
+        const apiKey = resolveSearchProviderEnv(this.env).TAVILY_API_KEY;
+        if (!apiKey) {
+            throw new Error("TAVILY_API_KEY environment variable is not set");
+        }
+        const limit = options?.limit ?? 5;
+        const body = {
+            api_key: apiKey,
+            query,
+            max_results: limit,
+            ...(options?.topic && { topic: options.topic }),
+            ...(options?.domains && { include_domains: options.domains }),
+            ...(options?.excludeDomains && { exclude_domains: options.excludeDomains }),
+        };
+        const { signal, cleanup } = createProviderAbortSignal(30_000, options?.signal);
+        try {
+            const response = await fetch("https://api.tavily.com/search", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+                signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Tavily 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.content,
+                score: r.score,
+            }));
+        }
+        finally {
+            cleanup();
+        }
+    }
+}
+//# sourceMappingURL=tavily.js.map

package/dist/pty-w5c9dv33.js

@@ -0,0 +1 @@
+import{Wb as a,Xb as b,Yb as c,Zb as d,_b as e}from"./index-45qvfjbf.js";import"./index-6qew5tp1.js";import"./index-tvryzx00.js";export{e as runInPTY,d as createPTYSession,a as PTYTimeoutError,c as PTYSession,b as PTYError};