ubersearch 1.1.0 → 1.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ubersearch",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "module": "src/index.ts",
   "type": "module",
   "bin": {

package/src/bootstrap/container.ts

@@ -95,16 +95,16 @@ export async function bootstrapContainer(
 
         // Skip providers that aren't configured (e.g., missing API key)
         if (!provider.isConfigured()) {
-          log.info(`Skipping provider ${engineConfig.id}: ${provider.getMissingConfigMessage()}`);
+          log.debug(`Skipping provider ${engineConfig.id}: ${provider.getMissingConfigMessage()}`);
           skippedProviders.push(engineConfig.id);
           continue;
         }
 
         registry.register(provider);
-        log.info(`Registered provider: ${engineConfig.id}`);
+        log.debug(`Registered provider: ${engineConfig.id}`);
       } catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);
-        log.warn(`Failed to register provider ${engineConfig.id}: ${errorMsg}`);
+        log.debug(`Failed to register provider ${engineConfig.id}: ${errorMsg}`);
         failedProviders.push(engineConfig.id);
       }
     }
@@ -112,14 +112,19 @@ export async function bootstrapContainer(
     const availableProviders = registry.list();
     if (availableProviders.length === 0) {
       const allSkipped = [...failedProviders, ...skippedProviders];
+      const skipDetails = allSkipped.length > 0 ? `Skipped: ${allSkipped.join(", ")}. ` : "";
       throw new Error(
-        `No providers could be registered. Skipped/failed providers: ${allSkipped.join(", ")}. ` +
-          "Check your configuration and environment variables.",
+        `No search providers available. ${skipDetails}\n\n` +
+          "To fix this, either:\n" +
+          "  1. Set an API key: export TAVILY_API_KEY=your-key (or BRAVE_API_KEY, LINKUP_API_KEY)\n" +
+          "  2. Start the SearXNG Docker container: docker compose up -d\n" +
+          "  3. Create a config file: ubersearch.config.json\n\n" +
+          "Get API keys at: https://tavily.com, https://brave.com/search/api, https://linkup.so",
       );
     }
 
     if (failedProviders.length > 0) {
-      log.warn(`Some providers failed to initialize: ${failedProviders.join(", ")}`);
+      log.debug(`Some providers failed to initialize: ${failedProviders.join(", ")}`);
     }
 
     return registry;

package/src/cli.ts

@@ -160,7 +160,7 @@ if (!query) {
 async function main() {
   try {
     // Bootstrap the DI container
-    const _container = await bootstrapContainer(configPath);
+    const container = await bootstrapContainer(configPath);
 
     const result = await uberSearch(
       {
@@ -170,7 +170,7 @@ async function main() {
         includeRaw: options.includeRaw,
         strategy: options.strategy,
       },
-      configPath,
+      { containerOverride: container },
     );
 
     if (options.json) {

package/src/config/load.ts

@@ -203,35 +203,87 @@ export interface LoadConfigOptions {
  */
 /**
  * Get default configuration when no config file is found
- * Uses SearXNG as a sensible default (no API key required)
+ * Prioritizes cloud providers if API keys are set, falls back to SearXNG
  */
 function getDefaultConfig(): ExtendedSearchConfig {
-  const packageRoot = getPackageRoot();
-  const composeFile = join(packageRoot, "providers", "searxng", "docker-compose.yml");
+  const engines: ExtendedSearchConfig["engines"] = [];
+  const defaultEngineOrder: string[] = [];
+
+  // Add cloud providers if API keys are available (preferred for bunx usage)
+  if (process.env.TAVILY_API_KEY) {
+    defaultEngineOrder.push("tavily");
+    engines.push({
+      id: "tavily",
+      type: "tavily",
+      enabled: true,
+      displayName: "Tavily Search",
+      apiKeyEnv: "TAVILY_API_KEY",
+      endpoint: "https://api.tavily.com/search",
+      searchDepth: "basic",
+      monthlyQuota: 1000,
+      creditCostPerSearch: 1,
+      lowCreditThresholdPercent: 80,
+    });
+  }
 
-  return {
-    defaultEngineOrder: ["searchxng"],
-    engines: [
-      {
-        id: "searchxng",
-        type: "searchxng",
-        enabled: true,
-        displayName: "SearXNG (Local)",
-        apiKeyEnv: "SEARXNG_API_KEY",
-        endpoint: "http://localhost:8888/search",
-        composeFile,
-        containerName: "searxng",
-        healthEndpoint: "http://localhost:8888/healthz",
-        defaultLimit: 10,
-        monthlyQuota: 10000,
-        creditCostPerSearch: 0,
-        lowCreditThresholdPercent: 80,
-        autoStart: true,
-        autoStop: true,
-        initTimeoutMs: 60000,
-      },
-    ],
-  };
+  if (process.env.BRAVE_API_KEY) {
+    defaultEngineOrder.push("brave");
+    engines.push({
+      id: "brave",
+      type: "brave",
+      enabled: true,
+      displayName: "Brave Search",
+      apiKeyEnv: "BRAVE_API_KEY",
+      endpoint: "https://api.search.brave.com/res/v1/web/search",
+      defaultLimit: 10,
+      monthlyQuota: 1000,
+      creditCostPerSearch: 1,
+      lowCreditThresholdPercent: 80,
+    });
+  }
+
+  if (process.env.LINKUP_API_KEY) {
+    defaultEngineOrder.push("linkup");
+    engines.push({
+      id: "linkup",
+      type: "linkup",
+      enabled: true,
+      displayName: "Linkup Search",
+      apiKeyEnv: "LINKUP_API_KEY",
+      endpoint: "https://api.linkup.so/v1/search",
+      monthlyQuota: 1000,
+      creditCostPerSearch: 1,
+      lowCreditThresholdPercent: 80,
+    });
+  }
+
+  // If no cloud providers configured, fall back to SearXNG (requires Docker)
+  if (engines.length === 0) {
+    const packageRoot = getPackageRoot();
+    const composeFile = join(packageRoot, "providers", "searxng", "docker-compose.yml");
+
+    defaultEngineOrder.push("searchxng");
+    engines.push({
+      id: "searchxng",
+      type: "searchxng",
+      enabled: true,
+      displayName: "SearXNG (Local)",
+      apiKeyEnv: "SEARXNG_API_KEY",
+      endpoint: "http://localhost:8888/search",
+      composeFile,
+      containerName: "searxng",
+      healthEndpoint: "http://localhost:8888/healthz",
+      defaultLimit: 10,
+      monthlyQuota: 10000,
+      creditCostPerSearch: 0,
+      lowCreditThresholdPercent: 80,
+      autoStart: true,
+      autoStop: true,
+      initTimeoutMs: 60000,
+    });
+  }
+
+  return { defaultEngineOrder, engines };
 }
 
 export async function loadConfig(
@@ -293,10 +345,7 @@ export async function loadConfig(
     }
   }
 
-  // No config file found - use default configuration
-  console.warn("No config file found. Using default configuration (SearXNG).");
-  console.warn("Create a config file for custom providers: ubersearch.config.json");
-
+  // No config file found - use default configuration (silent)
   const defaultConfig = getDefaultConfig();
 
   // Register plugins for default config
@@ -354,8 +403,6 @@ export function loadConfigSync(
     }
   }
 
-  console.warn("No config file found. Using default configuration (SearXNG).");
-  console.warn("Create a config file for custom providers: ubersearch.config.json");
   return getDefaultConfig();
 }
 

package/src/core/docker/dockerLifecycleManager.ts

@@ -73,7 +73,8 @@ export class DockerLifecycleManager {
     }
 
     this.initPromise = this.performInit().catch((error) => {
-      log.error("Initialization failed:", error);
+      const message = error instanceof Error ? error.message : String(error);
+      log.error("Initialization failed:", message);
       this.initialized = false;
       throw error;
     });
@@ -110,7 +111,7 @@ export class DockerLifecycleManager {
       "Docker availability check",
     );
     if (!dockerAvailable) {
-      log.warn("Docker is not available. Cannot auto-start container.");
+      log.debug("Docker is not available. Cannot auto-start container.");
       this.initialized = true;
       return;
     }
@@ -118,13 +119,13 @@ export class DockerLifecycleManager {
     // Check if container is already running (with timeout)
     const isRunning = await this.withTimeout(this.healthcheck(), 5000, "Initial health check");
     if (isRunning) {
-      log.info("Container is already running.");
+      log.debug("Container is already running.");
       this.initialized = true;
       return;
     }
 
     // Auto-start container
-    log.info("Starting Docker container...");
+    log.debug("Starting Docker container...");
     try {
       // Run from project root to ensure correct path resolution
       const projectRoot = this.config.projectRoot || process.cwd();
@@ -132,7 +133,7 @@ export class DockerLifecycleManager {
         this.config.containerName ? [this.config.containerName] : undefined,
         { cwd: projectRoot },
       );
-      log.info("Container started successfully.");
+      log.debug("Container started successfully.");
 
       // Wait for health check if endpoint is configured
       if (this.config.healthEndpoint) {
@@ -141,7 +142,8 @@ export class DockerLifecycleManager {
 
       this.initialized = true;
     } catch (error) {
-      log.error("Failed to start container:", error);
+      const message = error instanceof Error ? error.message : String(error);
+      log.error("Failed to start container:", message);
       throw error;
     } finally {
       this.initPromise = null;
@@ -196,12 +198,12 @@ export class DockerLifecycleManager {
       return;
     }
 
-    log.info("Waiting for health check...");
+    log.debug("Waiting for health check...");
 
     const startTime = Date.now();
     while (Date.now() - startTime < timeoutMs) {
       if (await this.healthcheck()) {
-        log.info("Health check passed.");
+        log.debug("Health check passed.");
         return;
       }
 
@@ -233,15 +235,16 @@ export class DockerLifecycleManager {
       return;
     }
 
-    log.info("Stopping Docker container...");
+    log.debug("Stopping Docker container...");
     try {
       await this.dockerHelper.stop(
         this.config.containerName ? [this.config.containerName] : undefined,
         { cwd: projectRoot },
       );
-      log.info("Container stopped.");
+      log.debug("Container stopped.");
     } catch (error) {
-      log.error("Failed to stop container:", error);
+      const message = error instanceof Error ? error.message : String(error);
+      log.error("Failed to stop container:", message);
       // Don't throw on shutdown errors
     }
   }
@@ -345,7 +348,8 @@ export class DockerLifecycleManager {
         cwd: projectRoot,
       });
     } catch (error) {
-      log.warn("Error checking if container is running:", error);
+      const message = error instanceof Error ? error.message : String(error);
+      log.debug("Error checking if container is running:", message);
       return false;
     }
   }

package/src/core/strategy/AllProvidersStrategy.ts

@@ -118,8 +118,8 @@ export class AllProvidersStrategy implements ISearchStrategy {
           attempts.push({ engineId, success: false, reason: "unknown" });
         }
 
-        // Log warning but continue with other providers
-        log.warn(
+        // Log debug message but continue with other providers
+        log.debug(
           `Search failed for ${engineId}: ${error instanceof Error ? error.message : String(error)}`,
         );
       }
@@ -194,7 +194,7 @@ export class AllProvidersStrategy implements ISearchStrategy {
       if (settledResult.status === "rejected") {
         // Promise itself was rejected (shouldn't happen with our try/catch, but handle it)
         attempts.push({ engineId, success: false, reason: "unknown" });
-        log.warn(`Search failed for ${engineId}: Promise rejected`);
+        log.debug(`Search failed for ${engineId}: Promise rejected`);
         continue;
       }
 
@@ -207,7 +207,7 @@ export class AllProvidersStrategy implements ISearchStrategy {
         } else {
           attempts.push({ engineId, success: false, reason: "unknown" });
         }
-        log.warn(`Search failed for ${engineId}: ${error.message}`);
+        log.debug(`Search failed for ${engineId}: ${error.message}`);
         continue;
       }
 

package/src/core/strategy/FirstSuccessStrategy.ts

@@ -85,8 +85,8 @@ export class FirstSuccessStrategy implements ISearchStrategy {
           attempts.push({ engineId, success: false, reason: "unknown" });
         }
 
-        // Log warning and continue
-        log.warn(
+        // Log debug message and continue
+        log.debug(
           `Search failed for ${engineId}: ${error instanceof Error ? error.message : String(error)}`,
         );
       }

package/src/providers/searchxng.ts

@@ -7,14 +7,17 @@
 import { dirname } from "node:path";
 import type { SearchxngConfig as BaseSearchxngConfig } from "../config/types";
 import { DockerLifecycleManager } from "../core/docker/dockerLifecycleManager";
+import { createLogger } from "../core/logger";
 import type { ILifecycleProvider, ProviderMetadata } from "../core/provider";
 import type { SearchQuery, SearchResponse, SearchResultItem } from "../core/types";
 import { SearchError } from "../core/types";
 import { BaseProvider } from "./BaseProvider";
 import { PROVIDER_DEFAULTS } from "./constants";
-import type { SearxngApiResponse, SearxngSearchResult } from "./types";
+import type { SearxngApiResponse, SearxngInfobox, SearxngSearchResult } from "./types";
 import { buildUrl, fetchWithErrorHandling } from "./utils";
 
+const log = createLogger("SearXNG");
+
 export class SearchxngProvider
   extends BaseProvider<BaseSearchxngConfig>
   implements ILifecycleProvider
@@ -79,12 +82,13 @@ export class SearchxngProvider
       const isInitializing = !!(await (this.lifecycleManager as any).initPromise);
       if (!isInitializing) {
         try {
-          console.log(`[SearXNG] Container not healthy, attempting auto-start...`);
+          log.debug("Container not healthy, attempting auto-start...");
           await this.init();
           // Re-check health after init attempt
           isHealthy = await this.healthcheck();
         } catch (initError) {
-          console.error(`[SearXNG] Failed to auto-start container:`, initError);
+          const message = initError instanceof Error ? initError.message : String(initError);
+          log.debug(`Failed to auto-start container: ${message}`);
         }
       }
     }
@@ -121,10 +125,10 @@ export class SearchxngProvider
       "SearXNG",
     );
 
-    const results: SearxngSearchResult[] = json.results ?? [];
-
-    this.validateResults(results, "SearXNG");
+    const results: SearxngSearchResult[] = Array.isArray(json.results) ? json.results : [];
+    const infoboxes: SearxngInfobox[] = Array.isArray(json.infoboxes) ? json.infoboxes : [];
 
+    // Convert regular results
     const items: SearchResultItem[] = results.map((r: SearxngSearchResult) => ({
       title: r.title ?? r.url ?? "#",
       url: r.url ?? "#",
@@ -133,6 +137,24 @@ export class SearchxngProvider
       sourceEngine: r.engine ?? this.id,
     }));
 
+    // Add infoboxes as results (Wikipedia, etc.)
+    for (const box of infoboxes) {
+      const boxUrl = box.id ?? box.urls?.[0]?.url;
+      if (boxUrl) {
+        items.push({
+          title: box.infobox ?? "Info",
+          url: boxUrl,
+          snippet: box.content ?? "",
+          sourceEngine: box.engine ?? "wikipedia",
+        });
+      }
+    }
+
+    // Only validate if we have no results at all
+    if (items.length === 0) {
+      this.validateResults(results, "SearXNG");
+    }
+
     const limitedItems = items.slice(0, limit);
 
     return {

package/src/providers/types/index.ts

@@ -110,6 +110,18 @@ export interface SearxngSearchResult {
   category?: string;
 }
 
+/**
+ * Infobox from SearXNG (Wikipedia, etc.)
+ */
+export interface SearxngInfobox {
+  infobox?: string;
+  id?: string;
+  content?: string;
+  img_src?: string;
+  urls?: Array<{ title?: string; url?: string }>;
+  engine?: string;
+}
+
 /**
  * SearXNG search API response
  */
@@ -117,7 +129,7 @@ export interface SearxngApiResponse {
   query?: string;
   results: SearxngSearchResult[];
   number_of_results?: number;
-  infoboxes?: unknown[];
+  infoboxes?: SearxngInfobox[];
   suggestions?: string[];
   answers?: string[];
   corrections?: string[];