exa-ai 0.5.0 → 0.6.0

data/exe/exa-ai-import-update

@@ -0,0 +1,164 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "exa-ai"
+
+# 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 import-update <import_id> [OPTIONS]
+
+      Update an existing import
+
+      Required:
+        <import_id>            Import ID
+
+      Options:
+        --title TEXT           New display title
+        --metadata JSON        New metadata (supports @file.json)
+        --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 import-update imp_123 --title "Updated Title"
+        exa-ai import-update imp_123 --metadata '{"status":"reviewed"}'
+        exa-ai import-update imp_123 --title "New Title" --metadata @metadata.json
+    HELP
+    exit 0
+  end
+
+  args = {
+    output_format: "json",
+    api_key: nil
+  }
+
+  # First positional argument is import_id
+  if argv.empty? || argv[0].start_with?("--")
+    return args
+  end
+
+  args[:import_id] = argv[0]
+  i = 1
+
+  while i < argv.length
+    arg = argv[i]
+    case arg
+    when "--title"
+      args[:title] = argv[i + 1]
+      i += 2
+    when "--metadata"
+      args[:metadata] = parse_json_or_file(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
+
+# Main execution
+begin
+  args = parse_args(ARGV)
+
+  # Validate required parameters
+  unless args[:import_id]
+    $stderr.puts "Error: <import_id> is required"
+    $stderr.puts "Run 'exa-ai import-update --help' for usage information"
+    exit 1
+  end
+
+  # Validate at least one update parameter provided
+  unless args[:title] || args[:metadata]
+    $stderr.puts "Error: At least one of --title or --metadata must be provided"
+    $stderr.puts "Run 'exa-ai import-update --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 update parameters (only include provided values)
+  update_params = {}
+  update_params[:title] = args[:title] if args[:title]
+  update_params[:metadata] = args[:metadata] if args[:metadata]
+
+  # Update import
+  import = client.update_import(args[:import_id], **update_params)
+
+  # Format and output result
+  output = Exa::CLI::Formatters::ImportFormatter.format(import, output_format)
+  puts output
+
+rescue Exa::NotFound => e
+  $stderr.puts "Import 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-create

@@ -0,0 +1,223 @@
+#!/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-create <webset_id> --cron EXPR --timezone TZ --behavior-type TYPE [OPTIONS]
+
+      Create a new monitor to automate webset updates on a schedule
+
+      Required:
+        <webset_id>                Webset ID
+        --cron EXPR                Cron expression (e.g., "0 0 * * *" for daily at midnight)
+        --timezone TZ              Timezone (e.g., "America/New_York")
+        --behavior-type TYPE       One of: #{VALID_BEHAVIOR_TYPES.join(', ')}
+
+      For search behavior:
+        --query TEXT               Search query (required for search behavior)
+        --count N                  Number of results (optional)
+        --behavior-mode MODE       Mode: override or append (optional, default: append)
+
+      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:
+        # Create a search monitor
+        exa-ai monitor-create ws_123 --cron "0 0 * * *" --timezone "America/New_York" \\
+          --behavior-type search --query "AI startups in San Francisco" --count 50
+
+        # Create a refresh monitor
+        exa-ai monitor-create ws_123 --cron "0 */6 * * *" --timezone "UTC" \\
+          --behavior-type refresh
+    HELP
+    exit 0
+  end
+
+  args = {
+    output_format: "json",
+    api_key: nil
+  }
+
+  # First, check for positional argument (webset_id)
+  if argv.empty? || argv[0].start_with?("--")
+    return args
+  end
+
+  args[:webset_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[:webset_id]
+    $stderr.puts "Error: webset_id argument is required"
+    $stderr.puts "Usage: exa-ai monitor-create <webset_id> --cron EXPR --timezone TZ --behavior-type TYPE [OPTIONS]"
+    $stderr.puts "Try 'exa-ai monitor-create --help' for more information"
+    exit 1
+  end
+
+  unless args[:cron]
+    $stderr.puts "Error: --cron is required"
+    $stderr.puts "Try 'exa-ai monitor-create --help' for more information"
+    exit 1
+  end
+
+  unless args[:timezone]
+    $stderr.puts "Error: --timezone is required"
+    $stderr.puts "Try 'exa-ai monitor-create --help' for more information"
+    exit 1
+  end
+
+  unless args[:behavior_type]
+    $stderr.puts "Error: --behavior-type is required"
+    $stderr.puts "Try 'exa-ai monitor-create --help' for more information"
+    exit 1
+  end
+
+  unless VALID_BEHAVIOR_TYPES.include?(args[:behavior_type])
+    $stderr.puts "Error: --behavior-type must be one of: #{VALID_BEHAVIOR_TYPES.join(', ')}"
+    exit 1
+  end
+
+  # Validate search behavior requirements
+  if args[:behavior_type] == "search" && !args[:query]
+    $stderr.puts "Error: --query is required for search behavior"
+    $stderr.puts "Try 'exa-ai monitor-create --help' for more information"
+    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 cadence object
+  cadence = {
+    cron: args[:cron],
+    timezone: args[:timezone]
+  }
+
+  # Build behavior object
+  behavior = {type: args[:behavior_type]}
+  if args[:behavior_type] == "search"
+    behavior[:query] = args[:query]
+    behavior[:count] = args[:count] if args[:count]
+    behavior[:mode] = args[:behavior_mode] || "append"
+  end
+
+  # Create monitor
+  monitor = client.create_monitor(
+    webset_id: args[:webset_id],
+    cadence: cadence,
+    behavior: behavior
+  )
+
+  # Format and output
+  output = Exa::CLI::Formatters::MonitorFormatter.format(monitor, 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-delete

@@ -0,0 +1,101 @@
+#!/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-delete <monitor_id> [OPTIONS]
+
+      Delete a monitor
+
+      Arguments:
+        monitor_id             ID of the monitor to delete (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-delete mon_abc123
+        exa-ai monitor-delete 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-delete <monitor_id> [OPTIONS]"
+  $stderr.puts "Try 'exa-ai monitor-delete --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)
+
+  # Delete monitor
+  result = client.delete_monitor(monitor_id)
+
+  # Format and output
+  output = case output_format
+           when "json"
+             JSON.generate(result)
+           when "pretty"
+             JSON.pretty_generate(result)
+           when "text"
+             "Monitor #{monitor_id} deleted successfully"
+           else
+             raise ArgumentError, "Unknown output format: #{output_format}"
+           end
+  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-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