exa-ai 0.11.1 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5fb7cd2fe000621f282f4eba7b178bc628793fc8232a47664f9a62d6a9d63ed
-  data.tar.gz: c8f6d9cb0272743280d73383629e1db1b68febd787a04f68dd402c1eb7927e7a
+  metadata.gz: aac702bd80757b3b6f52899e116899184df36530b6330c496c405e52a247eb95
+  data.tar.gz: 46669a7169fc6f2155b2869b7bf90740d6e28d90855a35e8064707778115b8db
 SHA512:
-  metadata.gz: 5c59a5d154df999cfd6e1212d23cfa46507caaa37a026439107ee63e9866e010367d75da4199b7b9873ccf37b8af83176d14420f21ee68499dc00e43ce001425
-  data.tar.gz: fc82c1690affcec1d61bc5df5930819c0c375b33fe0ac3e40d956c1ce5ad6b36cc3b908590b9bbcb14759a3521cad2cc4ef5de494b32705a0a9d2238ddbb0112
+  metadata.gz: c6db2aaa317b4e3b4a07c2a09a6af6b41e701961333b4dc3fa46c3c66bd535c529c82b92091a160be1d8ed7c25e7a7bc91933aa29278a4dd809bca92a6d1036d
+  data.tar.gz: 49159797c3615649188ab4a16d076b29a3b2134446731d6cf38c6fb59fddb4e49b823cdd07ef7390d030458cc04fabdcb20278581df2120b7c69721dbf6bf548

data/README.md

@@ -9,6 +9,7 @@ Ruby client for the Exa.ai API. Search and analyze web content using neural sear
 - [Configuration](#configuration)
 - [Quick Start](#quick-start)
 - [Features](#features)
+- [Agent](#agent)
 - [Error Handling](#error-handling)
 - [Documentation](#documentation)
 - [Development](#development)
@@ -226,6 +227,117 @@ The gem provides complete access to Exa's API endpoints:
 - **Enrichments** — Create and manage AI-powered data enrichment tasks on websets
 - **Imports** — Upload CSV files to import external data into websets
 
+### Agent
+- **Agent API** — Asynchronous research agent with citations, streaming, and full run lifecycle
+
+## Agent
+
+Exa's Agent API runs asynchronous research agents that search the web, synthesize findings, and return structured output with source citations. Runs are long-lived — create one, poll for completion, and stream events as it progresses.
+
+### Ruby API
+
+```ruby
+require 'exa-ai'
+
+client = Exa::Client.new(api_key: ENV['EXA_API_KEY'])
+
+# Create an async agent run
+run = client.agent_run_create(
+  query: "AI infrastructure startups that raised Series A in 2025",
+  effort: "high"
+)
+puts run.id      # => "run_abc123"
+puts run.status  # => "queued"
+puts run.queued? # => true
+
+# Poll for the result
+run = client.agent_run_get(run.id)
+if run.completed?
+  puts run.output[:text]
+  puts run.output[:structured]  # already-parsed JSON — no string parsing needed
+  puts run.output[:grounding]
+end
+
+# Create a run with structured output and a system prompt
+run = client.agent_run_create(
+  query: "AI infrastructure startups that raised Series A in 2025",
+  system_prompt: "Return only companies headquartered in the US.",
+  effort: "high",
+  output_schema: {
+    type: "object",
+    properties: {
+      companies: { type: "array", items: { type: "string" } }
+    }
+  }
+)
+
+# Attach premium data partners (Exa Connect) alongside web search.
+# The agent queries each partner where it's strongest and blends the
+# results into one grounded, structured answer.
+run = client.agent_run_create(
+  query: "Profile Anthropic: total funding and estimated monthly web traffic",
+  data_sources: [{ provider: "fiber_ai" }, { provider: "similarweb" }],
+  output_schema: {
+    type: "object",
+    properties: {
+      name: { type: "string" },
+      totalFunding: { type: "string" },  # from Fiber.ai
+      monthlyVisits: { type: "number" }  # from Similarweb
+    }
+  }
+)
+
+# Stream events as they arrive
+client.agent_run_stream(query: "AI infrastructure startups that raised Series A in 2025") do |event, data|
+  puts "#{event}: #{data.inspect}"
+  # event is the SSE event-type string, e.g. "agent_run.completed"
+  # data is the parsed JSON hash
+end
+
+# List recent runs
+runs = client.agent_run_list(limit: 5)
+puts runs.has_more    # => true/false
+puts runs.next_cursor # => pagination cursor
+runs.data.each { |r| puts "#{r.id}: #{r.status}" }
+
+# Fetch a run's events
+events = client.agent_run_events(run.id)
+
+# Cancel or delete a run
+client.agent_run_cancel(run.id)
+client.agent_run_delete(run.id)
+```
+
+> **Note:** Multi-word keys inside `input`, `data_sources` items, and `metadata` are passed through verbatim — supply them in the exact shape the API expects, the same contract as `output_schema`.
+
+### Command Line
+
+```bash
+# Create a run and wait for it to finish
+exa-ai agent-run-create --query "AI infrastructure startups that raised Series A in 2025" --wait --output-format pretty
+
+# Attach premium data partners (Exa Connect) with a structured schema.
+# Run `exa-ai agent-run-create --help` to see every provider and when to use it:
+# fiber_ai, similarweb, baselayer, affiliate, particle_news, financial_datasets, jinko
+exa-ai agent-run-create --wait \
+  --query "Profile Anthropic: total funding and monthly web traffic" \
+  --data-sources fiber_ai,similarweb \
+  --output-schema '{"type":"object","properties":{"name":{"type":"string"},"totalFunding":{"type":"string"},"monthlyVisits":{"type":"number"}}}'
+
+# Fetch an existing run
+exa-ai agent-run-get <run_id>
+
+# List recent runs
+exa-ai agent-run-list --limit 5
+
+# Cancel or delete a run
+exa-ai agent-run-cancel <run_id>
+exa-ai agent-run-delete <run_id>
+
+# Fetch a run's events
+exa-ai agent-run-events <run_id>
+```
+
 ## Error Handling
 
 ```ruby

data/exe/exa-ai

@@ -44,7 +44,13 @@ module ExaCLI
     "monitor-update" => "Update a monitor",
     "monitor-delete" => "Delete a monitor",
     "monitor-runs-list" => "List monitor runs",
-    "monitor-runs-get" => "Get monitor run details"
+    "monitor-runs-get" => "Get monitor run details",
+    "agent-run-create" => "Create an agent run",
+    "agent-run-get" => "Get agent run details",
+    "agent-run-list" => "List agent runs",
+    "agent-run-cancel" => "Cancel an agent run",
+    "agent-run-delete" => "Delete an agent run",
+    "agent-run-events" => "Get events for an agent run"
   }.freeze
 
   def self.run
@@ -134,6 +140,18 @@ module ExaCLI
       exec File.expand_path("../exa-ai-monitor-runs-list", __FILE__), *ARGV[1..]
     when "monitor-runs-get"
       exec File.expand_path("../exa-ai-monitor-runs-get", __FILE__), *ARGV[1..]
+    when "agent-run-create"
+      exec File.expand_path("../exa-ai-agent-run-create", __FILE__), *ARGV[1..]
+    when "agent-run-get"
+      exec File.expand_path("../exa-ai-agent-run-get", __FILE__), *ARGV[1..]
+    when "agent-run-list"
+      exec File.expand_path("../exa-ai-agent-run-list", __FILE__), *ARGV[1..]
+    when "agent-run-cancel"
+      exec File.expand_path("../exa-ai-agent-run-cancel", __FILE__), *ARGV[1..]
+    when "agent-run-delete"
+      exec File.expand_path("../exa-ai-agent-run-delete", __FILE__), *ARGV[1..]
+    when "agent-run-events"
+      exec File.expand_path("../exa-ai-agent-run-events", __FILE__), *ARGV[1..]
     else
       print_error_for_command(ARGV[0])
       exit 1
@@ -198,6 +216,15 @@ module ExaCLI
       ["import-delete", "Delete an import"]
     ])
 
+    print_command_section("Agent Runs", [
+      ["agent-run-create", "Create an agent run"],
+      ["agent-run-get", "Get agent run details"],
+      ["agent-run-list", "List agent runs"],
+      ["agent-run-cancel", "Cancel an agent run"],
+      ["agent-run-delete", "Delete an agent run"],
+      ["agent-run-events", "Get events for an agent run"]
+    ])
+
     print_command_section("Webset Monitors", [
       ["monitor-create", "Create a webset monitor"],
       ["monitor-get", "Get monitor details"],

data/exe/exa-ai-agent-run-cancel

@@ -0,0 +1,90 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "exa-ai"
+
+# Parse command-line arguments
+api_key = nil
+run_id = nil
+output_format = "json"
+
+args = ARGV.dup
+while args.any?
+  arg = args.shift
+  case arg
+  when "--api-key"
+    api_key = args.shift
+  when "--output-format"
+    output_format = args.shift
+  when "--help", "-h"
+    puts <<~HELP
+      Usage: exa-ai agent-run-cancel <run_id> [options]
+
+      Cancel an in-progress agent run.
+
+      Arguments:
+        run_id                  ID of the agent run to cancel
+
+      Options:
+        --api-key KEY           Exa API key (or use EXA_API_KEY env var)
+        --output-format FORMAT  Output format: json, pretty, or text (default: json)
+        --help, -h              Show this help message
+
+      Examples:
+        exa-ai agent-run-cancel run_123
+        exa-ai agent-run-cancel run_123 --output-format pretty
+    HELP
+    exit 0
+  else
+    # First positional argument is the run_id
+    if run_id.nil?
+      run_id = arg
+    else
+      warn "Unknown option: #{arg}"
+      exit 1
+    end
+  end
+end
+
+# Validate required arguments
+if run_id.nil?
+  warn "Error: Run ID argument required"
+  warn "Usage: exa-ai agent-run-cancel <run_id> [options]"
+  warn "Try 'exa-ai agent-run-cancel --help' for more information"
+  exit 1
+end
+
+begin
+  # Resolve API key
+  api_key = Exa::CLI::Base.resolve_api_key(api_key)
+
+  # Build client
+  client = Exa::CLI::Base.build_client(api_key)
+
+  # Call API
+  result = client.agent_run_cancel(run_id)
+
+  # Format output
+  formatted = Exa::CLI::Formatters::AgentRunFormatter.format_run(result, output_format)
+  puts formatted
+
+rescue Exa::NotFound => e
+  warn "Agent run not found: #{e.message}"
+  exit 1
+rescue Exa::Unauthorized => e
+  warn "Authentication failed: #{e.message}"
+  warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
+  exit 1
+rescue Exa::ClientError => e
+  warn "Client error: #{e.message}"
+  exit 1
+rescue Exa::ServerError => e
+  warn "Server error: #{e.message}"
+  exit 1
+rescue Exa::Error => e
+  warn "Error: #{e.message}"
+  exit 1
+rescue StandardError => e
+  warn "Unexpected error: #{e.message}"
+  exit 1
+end

data/exe/exa-ai-agent-run-create

@@ -0,0 +1,278 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "exa-ai"
+
+# Parse a JSON flag value: inline JSON, or @path to read JSON from a file.
+def parse_json_arg(value, flag_name)
+  json = value.to_s.start_with?("@") ? File.read(value.to_s[1..]) : value.to_s
+  JSON.parse(json)
+rescue JSON::ParserError => e
+  $stderr.puts "Error: #{flag_name} is not valid JSON (#{e.message})"
+  exit 1
+rescue Errno::ENOENT
+  $stderr.puts "Error: #{flag_name} file not found: #{value.to_s[1..]}"
+  exit 1
+end
+
+# Parse command-line arguments
+def parse_args(argv)
+  args = {
+    output_format: "json",
+    api_key: nil,
+    wait: false
+  }
+
+  i = 0
+  while i < argv.length
+    arg = argv[i]
+    case arg
+    when "--query"
+      args[:query] = argv[i + 1]
+      i += 2
+    when "--system-prompt"
+      args[:system_prompt] = argv[i + 1]
+      i += 2
+    when "--effort"
+      args[:effort] = argv[i + 1]
+      i += 2
+    when "--data-sources"
+      # ponytail: comma-separated slugs cover all documented usage ({provider: slug}).
+      # For richer per-provider config, use the Ruby API (client.agent_run_create).
+      args[:data_sources] = argv[i + 1].to_s.split(",").map { |s| { provider: s.strip } }
+      i += 2
+    when "--input-data"
+      args[:input_data] = parse_json_arg(argv[i + 1], "--input-data")
+      i += 2
+    when "--input-exclusion"
+      args[:input_exclusion] = parse_json_arg(argv[i + 1], "--input-exclusion")
+      i += 2
+    when "--previous-run-id"
+      args[:previous_run_id] = argv[i + 1]
+      i += 2
+    when "--output-schema"
+      args[:output_schema] = parse_json_arg(argv[i + 1], "--output-schema")
+      i += 2
+    when "--output-format"
+      args[:output_format] = argv[i + 1]
+      i += 2
+    when "--wait"
+      args[:wait] = true
+      i += 1
+    when "--api-key"
+      args[:api_key] = argv[i + 1]
+      i += 2
+    when "--help", "-h"
+      puts <<~HELP
+        Usage: exa-ai agent-run-create --query "TEXT" [OPTIONS]
+
+        Create an agent run using Exa AI. Optionally attach premium data
+        partners (Exa Connect) so the agent queries their databases alongside
+        web search and blends everything into one grounded answer.
+
+        Options:
+          --query TEXT           Query for the agent run (required)
+          --system-prompt TEXT   System prompt to guide the agent
+          --effort LEVEL         Effort level: low, medium, high
+          --data-sources LIST    Comma-separated partner slugs to attach (see
+                                 "Data sources" below), e.g. fiber_ai,similarweb
+          --input-data JSON      JSON array of objects for the agent to process,
+                                 or @file.json to read from a file. Each element
+                                 is a record the agent enriches or acts on.
+          --input-exclusion JSON JSON array of objects to exclude from results,
+                                 or @file.json. Useful to skip already-known rows.
+          --previous-run-id ID   Continue from a completed run. The agent picks
+                                 up where the prior run left off.
+          --output-schema JSON   JSON schema for structured output, or @file.json
+                                 to read it from a file. Recommended alongside
+                                 --data-sources so the agent knows which fields
+                                 each partner should fill.
+          --wait                 Stream the run and wait for it to complete
+          --api-key KEY          Exa API key (or set EXA_API_KEY env var)
+          --output-format FMT    Output format: json, pretty, or text (default: json)
+          --help, -h             Show this help message
+
+        Data sources (Exa Connect):
+          Each attached partner is billed per call on top of normal agent costs.
+          The agent picks the right source per step and cites everything.
+
+          fiber_ai            GTM & recruiting. 40M+ companies, 850M+ people,
+                              work/personal emails and phones. Use for B2B
+                              prospecting, CRM enrichment, finding contacts.
+          similarweb          Web analytics. Traffic estimates, global rankings,
+                              and competitors for any domain. Use for traffic
+                              benchmarking and market sizing.
+          baselayer           Compliance & KYB. Verify US businesses: officers,
+                              state registrations, risk scores. Use for KYB and
+                              vendor/customer screening.
+          affiliate           Commerce. Product catalog with live pricing,
+                              brands, and merchant links. Use for price
+                              comparison and shopping assistants.
+          particle_news       Media intelligence. Podcast transcripts with
+                              speaker attribution and timestamps. Use to find
+                              who said what on podcasts.
+          financial_datasets  Finance. Ticker-based news for US public
+                              companies. Use to track news/earnings for stocks.
+          jinko               Travel. Destinations ranked by lowest available
+                              fare from your departure airports. Use for
+                              budget trip ideas.
+
+        Examples:
+          exa-ai agent-run-create --query "Find Ruby performance tips"
+          exa-ai agent-run-create --query "Analyze AI trends" --wait
+
+          # Enrich a list of companies from a JSON file:
+          exa-ai agent-run-create --wait \\
+            --query "For each company, find the CEO and their LinkedIn URL." \\
+            --input-data @companies.json \\
+            --output-schema '{"type":"object","properties":{"companies":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"ceo":{"type":"string"},"linkedin":{"type":"string"}}}}}}'
+
+          # Company profile blending two partners + web, as structured JSON:
+          exa-ai agent-run-create --wait \\
+            --query "Profile Anthropic: total funding and monthly web traffic" \\
+            --data-sources fiber_ai,similarweb \\
+            --output-schema '{"type":"object","properties":{"name":{"type":"string"},"totalFunding":{"type":"string"},"monthlyVisits":{"type":"number"}}}'
+
+          # KYB check with a larger schema read from a file:
+          exa-ai agent-run-create --wait --query "Verify Stripe, Inc." \\
+            --data-sources baselayer --output-schema @schema.json
+      HELP
+      exit 0
+    else
+      i += 1
+    end
+  end
+
+  args
+end
+
+# Main execution
+begin
+  args = parse_args(ARGV)
+
+  # Validate query
+  if args[:query].nil? || args[:query].empty?
+    $stderr.puts "Error: --query flag is required"
+    $stderr.puts "Run 'exa-ai agent-run-create --help' for usage information"
+    exit 1
+  end
+
+  # Resolve API key
+  api_key = Exa::CLI::Base.resolve_api_key(args[:api_key])
+
+  # Resolve output format
+  output_format = Exa::CLI::Base.resolve_output_format(args[:output_format])
+
+  # Build client
+  client = Exa::CLI::Base.build_client(api_key)
+
+  # Prepare run parameters
+  run_params = { query: args[:query] }
+  run_params[:system_prompt] = args[:system_prompt] if args[:system_prompt]
+  run_params[:effort] = args[:effort] if args[:effort]
+  run_params[:data_sources] = args[:data_sources] if args[:data_sources]
+  if args[:input_data] || args[:input_exclusion]
+    input = {}
+    input[:data]      = args[:input_data]      if args[:input_data]
+    input[:exclusion] = args[:input_exclusion] if args[:input_exclusion]
+    run_params[:input] = input
+  end
+  run_params[:previous_run_id] = args[:previous_run_id] if args[:previous_run_id]
+  run_params[:output_schema] = args[:output_schema] if args[:output_schema]
+
+  if args[:wait]
+    # Stream the run and watch it to completion. The SSE stream creates the run
+    # and pushes lifecycle events (created/started/completed); the final run is
+    # rendered the instant it lands — lower latency than polling, and the run
+    # still persists with an id.
+    start = Time.now
+    run_id = nil
+    phase = "starting"
+    done = false
+
+    # ponytail: the SSE block only fires on events, and nothing arrives between
+    # "started" and "completed". A background thread paints a live elapsed timer
+    # so the user can see it's alive during the silent running phase.
+    painter = Thread.new do
+      frames = %w[⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏]
+      i = 0
+      until done
+        elapsed = (Time.now - start).round
+        $stderr.print "\r#{frames[i % frames.size]} #{run_id || "agent run"}  #{phase}  #{elapsed}s   "
+        $stderr.flush
+        i += 1
+        sleep 0.2
+      end
+    end
+
+    final = nil
+    stream_error = nil
+    begin
+      final = client.agent_run_stream(**run_params) do |event, data|
+        run_id ||= data["id"] if data.is_a?(Hash)
+        phase = "queued"  if event == "agent_run.created"
+        phase = "running" if event == "agent_run.started"
+      end
+    rescue Faraday::Error, Exa::Error => e
+      stream_error = e # stream dropped mid-run; recover via polling below if we have an id
+    ensure
+      done = true
+      painter.join
+    end
+
+    # Fallback: stream ended/dropped without a terminal event. If we learned the
+    # run id, poll it to completion rather than losing the run.
+    if final.nil? && run_id
+      $stderr.print "\r(stream interrupted; polling #{run_id})                 "
+      begin
+        final = Exa::CLI::Polling.poll(max_duration: 300, initial_delay: 2, max_delay: 10) do
+          current = client.agent_run_get(run_id)
+          { done: current.finished?, result: current, status: current.status }
+        end
+      rescue Exa::CLI::Polling::TimeoutError
+        $stderr.puts "\nError: run did not complete within 5 minutes"
+        $stderr.puts "Run ID: #{run_id} — check later with: exa-ai agent-run-get #{run_id}"
+        exit 1
+      end
+    end
+
+    $stderr.print "\r" + (" " * 72) + "\r"
+
+    if final.nil?
+      $stderr.puts "Error: the run did not produce a result#{stream_error ? " (#{stream_error.message})" : ""}"
+      $stderr.puts "Run ID: #{run_id}" if run_id
+      exit 1
+    end
+
+    $stderr.puts "#{final.completed? ? "✓" : "•"} #{final.status} · #{(Time.now - start).round}s"
+    puts Exa::CLI::Formatters::AgentRunFormatter.format_run(final, output_format)
+    $stdout.flush
+    exit 1 if final.failed?
+  else
+    # Not waiting: create and return the initial (queued) run.
+    run = client.agent_run_create(**run_params)
+    puts Exa::CLI::Formatters::AgentRunFormatter.format_run(run, output_format)
+  end
+
+rescue Exa::ConfigurationError => e
+  $stderr.puts "Configuration error: #{e.message}"
+  exit 1
+rescue Exa::Unauthorized => e
+  $stderr.puts "Authentication error: #{e.message}"
+  $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
+  exit 1
+rescue Exa::ClientError => e
+  $stderr.puts "Client error: #{e.message}"
+  exit 1
+rescue Exa::ServerError => e
+  $stderr.puts "Server error: #{e.message}"
+  $stderr.puts "The Exa API may be experiencing issues. Please try again later."
+  exit 1
+rescue Exa::Error => e
+  $stderr.puts "Error: #{e.message}"
+  exit 1
+rescue StandardError => e
+  $stderr.puts "Unexpected error: #{e.message}"
+  $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
+  exit 1
+end

data/exe/exa-ai-agent-run-delete

@@ -0,0 +1,96 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "exa-ai"
+
+# Parse command-line arguments
+api_key = nil
+run_id = nil
+output_format = "json"
+
+args = ARGV.dup
+while args.any?
+  arg = args.shift
+  case arg
+  when "--api-key"
+    api_key = args.shift
+  when "--output-format"
+    output_format = args.shift
+  when "--help", "-h"
+    puts <<~HELP
+      Usage: exa-ai agent-run-delete <run_id> [options]
+
+      Delete an agent run.
+
+      Arguments:
+        run_id                  ID of the agent run to delete
+
+      Options:
+        --api-key KEY           Exa API key (or use EXA_API_KEY env var)
+        --output-format FORMAT  Output format: json, pretty, or text (default: json)
+        --help, -h              Show this help message
+
+      Examples:
+        exa-ai agent-run-delete run_123
+        exa-ai agent-run-delete run_123 --output-format pretty
+    HELP
+    exit 0
+  else
+    # First positional argument is the run_id
+    if run_id.nil?
+      run_id = arg
+    else
+      warn "Unknown option: #{arg}"
+      exit 1
+    end
+  end
+end
+
+# Validate required arguments
+if run_id.nil?
+  warn "Error: Run ID argument required"
+  warn "Usage: exa-ai agent-run-delete <run_id> [options]"
+  warn "Try 'exa-ai agent-run-delete --help' for more information"
+  exit 1
+end
+
+begin
+  # Resolve API key
+  api_key = Exa::CLI::Base.resolve_api_key(api_key)
+
+  # Build client
+  client = Exa::CLI::Base.build_client(api_key)
+
+  # Call API
+  result = client.agent_run_delete(run_id)
+
+  # Format output
+  if result.respond_to?(:to_h)
+    formatted = Exa::CLI::Formatters::AgentRunFormatter.format_run(result, output_format)
+    puts formatted
+  else
+    puts({ deleted: true, id: run_id }.to_json) if output_format == "json"
+    puts "Deleted agent run: #{run_id}" if output_format == "pretty"
+    puts run_id if output_format == "text"
+  end
+
+rescue Exa::NotFound => e
+  warn "Agent run not found: #{e.message}"
+  exit 1
+rescue Exa::Unauthorized => e
+  warn "Authentication failed: #{e.message}"
+  warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
+  exit 1
+rescue Exa::ClientError => e
+  warn "Client error: #{e.message}"
+  exit 1
+rescue Exa::ServerError => e
+  warn "Server error: #{e.message}"
+  exit 1
+rescue Exa::Error => e
+  warn "Error: #{e.message}"
+  exit 1
+rescue StandardError => e
+  warn "Unexpected error: #{e.message}"
+  exit 1
+end