exa-ai 0.4.1 → 0.6.0

data/exe/exa-ai-monitor-get

@@ -0,0 +1,92 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "exa-ai"
+
+# Parse arguments
+monitor_id = nil
+api_key = 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 monitor-get <monitor_id> [OPTIONS]
+
+      Retrieve details for a monitor
+
+      Arguments:
+        monitor_id             ID of the monitor to retrieve (required)
+
+      Options:
+        --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
+
+      Examples:
+        exa-ai monitor-get mon_abc123
+        exa-ai monitor-get mon_abc123 --output-format pretty
+    HELP
+    exit 0
+  else
+    # First positional argument is monitor_id
+    if monitor_id.nil?
+      monitor_id = arg
+    else
+      $stderr.puts "Unknown option: #{arg}"
+      exit 1
+    end
+  end
+end
+
+# Validate
+if monitor_id.nil?
+  $stderr.puts "Error: monitor_id argument is required"
+  $stderr.puts "Usage: exa-ai monitor-get <monitor_id> [OPTIONS]"
+  $stderr.puts "Try 'exa-ai monitor-get --help' for more information"
+  exit 1
+end
+
+begin
+  # Resolve API key and format
+  api_key = Exa::CLI::Base.resolve_api_key(api_key)
+  output_format = Exa::CLI::Base.resolve_output_format(output_format)
+
+  # Build client
+  client = Exa::CLI::Base.build_client(api_key)
+
+  # Get monitor
+  monitor = client.get_monitor(monitor_id)
+
+  # Format and output
+  output = Exa::CLI::Formatters::MonitorFormatter.format(monitor, output_format)
+  puts output
+
+rescue Exa::NotFound => e
+  $stderr.puts "Monitor not found: #{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}"
+  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-monitor-list

@@ -0,0 +1,90 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "exa-ai"
+
+# Parse arguments
+limit = nil
+cursor = nil
+api_key = nil
+output_format = "json"
+
+args = ARGV.dup
+while args.any?
+  arg = args.shift
+  case arg
+  when "--limit"
+    limit = args.shift&.to_i
+  when "--cursor"
+    cursor = args.shift
+  when "--api-key"
+    api_key = args.shift
+  when "--output-format"
+    output_format = args.shift
+  when "--help", "-h"
+    puts <<~HELP
+      Usage: exa-ai monitor-list [OPTIONS]
+
+      List all monitors with optional pagination
+
+      Options:
+        --limit N              Maximum number of monitors to return (default: 25, max: 100)
+        --cursor CURSOR        Cursor for pagination (use nextCursor from previous response)
+        --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
+
+      Examples:
+        exa-ai monitor-list
+        exa-ai monitor-list --limit 10
+        exa-ai monitor-list --limit 5 --cursor "abc123"
+        exa-ai monitor-list --output-format pretty
+    HELP
+    exit 0
+  else
+    $stderr.puts "Unknown option: #{arg}"
+    exit 1
+  end
+end
+
+begin
+  # Resolve API key and format
+  api_key = Exa::CLI::Base.resolve_api_key(api_key)
+  output_format = Exa::CLI::Base.resolve_output_format(output_format)
+
+  # Build client
+  client = Exa::CLI::Base.build_client(api_key)
+
+  # List monitors with optional pagination
+  list_params = {}
+  list_params[:limit] = limit if limit
+  list_params[:cursor] = cursor if cursor
+
+  collection = client.list_monitors(**list_params)
+
+  # Format and output
+  output = Exa::CLI::Formatters::MonitorFormatter.format_collection(collection, output_format)
+  puts output
+
+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-monitor-runs-get

@@ -0,0 +1,103 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "exa-ai"
+
+# Parse arguments
+monitor_id = nil
+run_id = nil
+api_key = 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 monitor-runs-get <monitor_id> <run_id> [OPTIONS]
+
+      Retrieve details for a specific monitor run
+
+      Arguments:
+        monitor_id             ID of the monitor (required)
+        run_id                 ID of the run to retrieve (required)
+
+      Options:
+        --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
+
+      Examples:
+        exa-ai monitor-runs-get mon_abc123 run_xyz789
+        exa-ai monitor-runs-get mon_abc123 run_xyz789 --output-format pretty
+    HELP
+    exit 0
+  else
+    # First positional argument is monitor_id, second is run_id
+    if monitor_id.nil?
+      monitor_id = arg
+    elsif run_id.nil?
+      run_id = arg
+    else
+      $stderr.puts "Unknown option: #{arg}"
+      exit 1
+    end
+  end
+end
+
+# Validate
+if monitor_id.nil?
+  $stderr.puts "Error: monitor_id argument is required"
+  $stderr.puts "Usage: exa-ai monitor-runs-get <monitor_id> <run_id> [OPTIONS]"
+  $stderr.puts "Try 'exa-ai monitor-runs-get --help' for more information"
+  exit 1
+end
+
+if run_id.nil?
+  $stderr.puts "Error: run_id argument is required"
+  $stderr.puts "Usage: exa-ai monitor-runs-get <monitor_id> <run_id> [OPTIONS]"
+  $stderr.puts "Try 'exa-ai monitor-runs-get --help' for more information"
+  exit 1
+end
+
+begin
+  # Resolve API key and format
+  api_key = Exa::CLI::Base.resolve_api_key(api_key)
+  output_format = Exa::CLI::Base.resolve_output_format(output_format)
+
+  # Build client
+  client = Exa::CLI::Base.build_client(api_key)
+
+  # Get monitor run
+  monitor_run = client.get_monitor_run(monitor_id: monitor_id, id: run_id)
+
+  # Format and output
+  output = Exa::CLI::Formatters::MonitorRunFormatter.format(monitor_run, output_format)
+  puts output
+
+rescue Exa::NotFound => e
+  $stderr.puts "Monitor run not found: #{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}"
+  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-monitor-runs-list

@@ -0,0 +1,110 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "exa-ai"
+
+# Parse arguments
+monitor_id = nil
+limit = nil
+cursor = nil
+api_key = nil
+output_format = "json"
+
+args = ARGV.dup
+while args.any?
+  arg = args.shift
+  case arg
+  when "--limit"
+    limit = args.shift&.to_i
+  when "--cursor"
+    cursor = args.shift
+  when "--api-key"
+    api_key = args.shift
+  when "--output-format"
+    output_format = args.shift
+  when "--help", "-h"
+    puts <<~HELP
+      Usage: exa-ai monitor-runs-list <monitor_id> [OPTIONS]
+
+      List execution runs for a monitor
+
+      Arguments:
+        monitor_id             ID of the monitor (required)
+
+      Options:
+        --limit N              Maximum number of runs to return (default: 25, max: 100)
+        --cursor CURSOR        Cursor for pagination (use nextCursor from previous response)
+        --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
+
+      Examples:
+        exa-ai monitor-runs-list mon_abc123
+        exa-ai monitor-runs-list mon_abc123 --limit 10
+        exa-ai monitor-runs-list mon_abc123 --limit 5 --cursor "abc123"
+        exa-ai monitor-runs-list mon_abc123 --output-format pretty
+    HELP
+    exit 0
+  else
+    # First positional argument is monitor_id
+    if monitor_id.nil?
+      monitor_id = arg
+    else
+      $stderr.puts "Unknown option: #{arg}"
+      exit 1
+    end
+  end
+end
+
+# Validate
+if monitor_id.nil?
+  $stderr.puts "Error: monitor_id argument is required"
+  $stderr.puts "Usage: exa-ai monitor-runs-list <monitor_id> [OPTIONS]"
+  $stderr.puts "Try 'exa-ai monitor-runs-list --help' for more information"
+  exit 1
+end
+
+begin
+  # Resolve API key and format
+  api_key = Exa::CLI::Base.resolve_api_key(api_key)
+  output_format = Exa::CLI::Base.resolve_output_format(output_format)
+
+  # Build client
+  client = Exa::CLI::Base.build_client(api_key)
+
+  # List monitor runs with optional pagination
+  list_params = {monitor_id: monitor_id}
+  list_params[:limit] = limit if limit
+  list_params[:cursor] = cursor if cursor
+
+  collection = client.list_monitor_runs(**list_params)
+
+  # Format and output
+  output = Exa::CLI::Formatters::MonitorRunFormatter.format_collection(collection, output_format)
+  puts output
+
+rescue Exa::NotFound => e
+  $stderr.puts "Monitor not found: #{e.message}"
+  exit 1
+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-monitor-update

@@ -0,0 +1,207 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "exa-ai"
+
+VALID_BEHAVIOR_TYPES = %w[search refresh].freeze
+
+# Recursively convert hash keys from strings to symbols
+def deep_symbolize_keys(obj)
+  case obj
+  when Hash
+    obj.each_with_object({}) do |(key, value), result|
+      result[key.to_sym] = deep_symbolize_keys(value)
+    end
+  when Array
+    obj.map { |item| deep_symbolize_keys(item) }
+  else
+    obj
+  end
+end
+
+# Parse JSON string or load from file (supports @file.json syntax)
+def parse_json_or_file(value)
+  json_data = if value.start_with?("@")
+                file_path = value[1..]
+                JSON.parse(File.read(file_path))
+              else
+                JSON.parse(value)
+              end
+  deep_symbolize_keys(json_data)
+rescue JSON::ParserError => e
+  $stderr.puts "Error: Invalid JSON: #{e.message}"
+  exit 1
+rescue Errno::ENOENT => e
+  $stderr.puts "Error: File not found: #{e.message}"
+  exit 1
+end
+
+# Parse command-line arguments
+def parse_args(argv)
+  # Check for help first
+  if argv.include?("--help") || argv.include?("-h")
+    puts <<~HELP
+      Usage: exa-ai monitor-update <monitor_id> [OPTIONS]
+
+      Update a monitor's schedule or behavior
+
+      Required:
+        <monitor_id>               Monitor ID
+
+      Cadence options:
+        --cron EXPR                Cron expression (e.g., "0 0 * * *")
+        --timezone TZ              Timezone (e.g., "America/New_York")
+
+      Behavior options:
+        --behavior-type TYPE       One of: #{VALID_BEHAVIOR_TYPES.join(', ')}
+        --query TEXT               Search query (for search behavior)
+        --count N                  Number of results (for search behavior)
+        --behavior-mode MODE       Mode: override or append (for search behavior)
+
+      Other options:
+        --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
+
+      Examples:
+        # Update cron schedule
+        exa-ai monitor-update mon_123 --cron "0 */12 * * *"
+
+        # Update search query
+        exa-ai monitor-update mon_123 --query "AI startups in Europe"
+
+        # Update multiple fields
+        exa-ai monitor-update mon_123 --cron "0 0 * * *" --timezone "UTC" \\
+          --query "New companies" --count 100
+    HELP
+    exit 0
+  end
+
+  args = {
+    output_format: "json",
+    api_key: nil
+  }
+
+  # First, check for positional argument (monitor_id)
+  if argv.empty? || argv[0].start_with?("--")
+    return args
+  end
+
+  args[:monitor_id] = argv[0]
+  i = 1
+
+  while i < argv.length
+    arg = argv[i]
+    case arg
+    when "--cron"
+      args[:cron] = argv[i + 1]
+      i += 2
+    when "--timezone"
+      args[:timezone] = argv[i + 1]
+      i += 2
+    when "--behavior-type"
+      args[:behavior_type] = argv[i + 1]
+      i += 2
+    when "--query"
+      args[:query] = argv[i + 1]
+      i += 2
+    when "--count"
+      args[:count] = argv[i + 1]&.to_i
+      i += 2
+    when "--behavior-mode"
+      args[:behavior_mode] = argv[i + 1]
+      i += 2
+    when "--api-key"
+      args[:api_key] = argv[i + 1]
+      i += 2
+    when "--output-format"
+      args[:output_format] = argv[i + 1]
+      i += 2
+    else
+      $stderr.puts "Unknown option: #{arg}"
+      exit 1
+    end
+  end
+
+  args
+end
+
+# Validate required arguments
+def validate_args(args)
+  unless args[:monitor_id]
+    $stderr.puts "Error: monitor_id argument is required"
+    $stderr.puts "Usage: exa-ai monitor-update <monitor_id> [OPTIONS]"
+    $stderr.puts "Try 'exa-ai monitor-update --help' for more information"
+    exit 1
+  end
+
+  # Validate behavior type if provided
+  if args[:behavior_type] && !VALID_BEHAVIOR_TYPES.include?(args[:behavior_type])
+    $stderr.puts "Error: --behavior-type must be one of: #{VALID_BEHAVIOR_TYPES.join(', ')}"
+    exit 1
+  end
+end
+
+# Main execution
+args = parse_args(ARGV)
+validate_args(args)
+
+begin
+  # Resolve API key and format
+  api_key = Exa::CLI::Base.resolve_api_key(args[:api_key])
+  output_format = Exa::CLI::Base.resolve_output_format(args[:output_format])
+
+  # Build client
+  client = Exa::CLI::Base.build_client(api_key)
+
+  # Build update params
+  update_params = {}
+
+  # Build cadence object if any cadence params provided
+  if args[:cron] || args[:timezone]
+    update_params[:cadence] = {}
+    update_params[:cadence][:cron] = args[:cron] if args[:cron]
+    update_params[:cadence][:timezone] = args[:timezone] if args[:timezone]
+  end
+
+  # Build behavior object if any behavior params provided
+  if args[:behavior_type] || args[:query] || args[:count] || args[:behavior_mode]
+    update_params[:behavior] = {}
+    update_params[:behavior][:type] = args[:behavior_type] if args[:behavior_type]
+    update_params[:behavior][:query] = args[:query] if args[:query]
+    update_params[:behavior][:count] = args[:count] if args[:count]
+    update_params[:behavior][:mode] = args[:behavior_mode] if args[:behavior_mode]
+  end
+
+  # Update monitor
+  monitor = client.update_monitor(args[:monitor_id], **update_params)
+
+  # Format and output
+  output = Exa::CLI::Formatters::MonitorFormatter.format(monitor, output_format)
+  puts output
+
+rescue Exa::NotFound => e
+  $stderr.puts "Monitor not found: #{e.message}"
+  exit 1
+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-research-get

@@ -24,7 +24,7 @@ while args.any?
     output_format = args.shift
   when "--help", "-h"
     puts <<~HELP
-      Usage: exa-api research-get <research_id> [options]
+      Usage: exa-ai research-get <research_id> [options]
 
       Get the status and results of a research task.
 
@@ -39,10 +39,10 @@ while args.any?
         --help, -h              Show this help message
 
       Examples:
-        exa-api research-get research_123
-        exa-api research-get research_123 --events
-        exa-api research-get research_123 --stream
-        exa-api research-get research_123 --output-format pretty
+        exa-ai research-get research_123
+        exa-ai research-get research_123 --events
+        exa-ai research-get research_123 --stream
+        exa-ai research-get research_123 --output-format pretty
     HELP
     exit 0
   else
@@ -59,8 +59,8 @@ end
 # Validate required arguments
 if research_id.nil?
   warn "Error: Research ID argument required"
-  warn "Usage: exa-api research-get <research_id> [options]"
-  warn "Try 'exa-api research-get --help' for more information"
+  warn "Usage: exa-ai research-get <research_id> [options]"
+  warn "Try 'exa-ai research-get --help' for more information"
   exit 1
 end
 

data/exe/exa-ai-research-list

@@ -23,7 +23,7 @@ while args.any?
     output_format = args.shift
   when "--help", "-h"
     puts <<~HELP
-      Usage: exa-api research-list [options]
+      Usage: exa-ai research-list [options]
 
       List research tasks with cursor-based pagination.
 
@@ -35,10 +35,10 @@ while args.any?
         --help, -h              Show this help message
 
       Examples:
-        exa-api research-list
-        exa-api research-list --limit 20
-        exa-api research-list --cursor next_page_cursor
-        exa-api research-list --output-format pretty
+        exa-ai research-list
+        exa-ai research-list --limit 20
+        exa-ai research-list --cursor next_page_cursor
+        exa-ai research-list --output-format pretty
     HELP
     exit 0
   else