// searxng's tools (novox/hq ADR 0039), importing searxng's own client. A stateless metasearch: one
// query in, merged results out — genuinely useful, and with nothing to observe over time it stays
// tools-only (no events, no broker).

import { registerModuleTools, type ToolDefinition } from "@novox/mesh-sdk/tools";
import { SearxngClient } from "../client.js";

export function getSearxngTools(searxng: SearxngClient): ToolDefinition[] {
  return [
    {
      name: "searxng_search",
      description: "Search the web through SearXNG's privacy-respecting metasearch — merged results from many engines.",
      input: {
        query: { type: "string", description: "the search query" },
        categories: { type: "string", description: "comma-separated categories, e.g. 'general', 'news', 'images'" },
        language: { type: "string", description: "language code, e.g. 'en' or 'en-US'" },
      },
      run: async (args) => {
        const found = await searxng.search(String(args.query), {
          categories: args.categories ? String(args.categories) : undefined,
          language: args.language ? String(args.language) : undefined,
        });
        return found;
      },
    },
  ];
}

// A URL always resolves (it defaults), so this normally contributes its tool; the try/catch keeps a
// misconfiguration from taking the whole runtime down.
registerModuleTools("searxng", (env) => {
  try {
    return getSearxngTools(SearxngClient.fromEnv(env));
  } catch {
    return [];
  }
});