Class: Clacky::Tools::WebSearch

Inherits:
Base
  • Object
show all
Defined in:
lib/clacky/tools/web_search.rb

Constant Summary collapse

PROVIDERS =

Ordered list of search providers to try in sequence. cn.bing.com is accessible in mainland China without VPN.

%i[duckduckgo bing].freeze
SEARCHER_TIMEOUT = 
30
BING_ENDPOINTS =

── Bing ───────────────────────────────────────────────────────────────

[
  ["cn.bing.com", "zh-CN,zh;q=0.9,en;q=0.8"],
  ["www.bing.com", "en-US,en;q=0.9"]
].freeze
USER_AGENTS =

── Shared HTTP helper ─────────────────────────────────────────────────

[
  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
  "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
  "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
  "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
].freeze

Instance Attribute Summary

Attributes inherited from Base

#agent

Instance Method Summary collapse

Methods inherited from Base

#category, #description, #name, #parameters, #to_function_definition

Instance Method Details

#execute(query:, max_results: 10, working_dir: nil) ⇒ Object 



38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/clacky/tools/web_search.rb', line 38

def execute(query:, max_results: 10, working_dir: nil)
  if query.nil? || query.strip.empty?
    return { error: "Query cannot be empty" }
  end

  last_error = nil

  providers = active_providers
  providers.each do |provider|
    begin
      results = send(:"search_#{provider}", query, max_results)
      # Consider it a success only if we got real results
      next if results.empty? || results.first[:url].include?("duckduckgo.com") && results.first[:title] == "Web search results"

      return {
        query: query,
        results: results,
        count: results.length,
        provider: provider == :custom ? Clacky::SearchConfig.load["provider"] : provider.to_s,
        error: nil
      }
    rescue StandardError => e
      # DuckDuckGo failed — suppress it for 10 minutes
      @ddg_unavailable_until = Time.now + 600 if provider == :duckduckgo
      last_error = e
      next
    end
  end

  {
    query: query,
    results: [],
    count: 0,
    provider: nil,
    error: search_failure_message(providers, last_error)
  }
end

#format_call(args) ⇒ Object

── Formatting ─────────────────────────────────────────────────────────



334
335
336
337
338
 
# File 'lib/clacky/tools/web_search.rb', line 334

def format_call(args)
  query = args[:query] || args["query"] || ""
  display_query = query.length > 40 ? "#{query[0..37]}..." : query
  "web_search(\"#{display_query}\")"
end

#format_result(result) ⇒ Object 



340
341
342
343
344
345
346
347
348
 
# File 'lib/clacky/tools/web_search.rb', line 340

def format_result(result)
  if result[:error]
    "[Error] #{result[:error]}"
  else
    count = result[:count] || 0
    provider = result[:provider] ? " via #{result[:provider]}" : ""
    "[OK] Found #{count} results#{provider}"
  end
end