exa-ai 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cc4ccfc59e93013765b9289621cdb0447c4cc5bbc24e1585376ebae4b7b6ff0
-  data.tar.gz: 45cbb8655d636906d1230651896aeab9375720e655ca4d18c74f12a425ea5bd7
+  metadata.gz: 9f9d0670c6b642073a66e32d8ecdd46702931e4b17f66bd6970b976a51ec5c56
+  data.tar.gz: 2f9126068c6e0672cf7ac67b2d18e188396dbd3785285c4683b2deb99b97d14d
 SHA512:
-  metadata.gz: 4d569c43e3d9071accaeb081c6c8b51bbd0248258aa36331a8874ae17b648686bf22da5d73faee00b0a8d4a6b2b5a62dc47bcec5e4d4d7202d20870dca4ebb4e
-  data.tar.gz: 41c7f61f7de1dcc31fec84588cc2ed6287ddec597554cc18d7a9afbc0b044a790792a598ddfaef68e12174178a373081c3274e6240f6c91f908db14101fc4887
+  metadata.gz: 70e7be7fd10d14c69dd1b3125e453c9aa5a7233fb5f618233b8e3af0b42c7546a02b7cb34b9a20f9bb25b0f235f5b6fcbecefbaa5c33393720a47200b1443d93
+  data.tar.gz: 3ef41b82e7126b4f875a3acddeaf046293a75e2d6cae3a03ea1c3ab46dc5ba9d8ade004add9e5f588876b7cdc4bf7a6c4f27d6be08a42b31e29a7ec3a987dd4f

data/exe/exa-ai

@@ -44,7 +44,7 @@ module ExaCLI
       print_help
       exit 0
     when "--api-key"
-      puts "Use --api-key flag with specific commands"
+      $stderr.puts "Error: Use --api-key flag with specific commands"
       exit 1
     when "search"
       exec File.expand_path("../exa-ai-search", __FILE__), *ARGV[1..]
@@ -175,15 +175,15 @@ module ExaCLI
   def self.print_error_for_command(cmd)
     return print_help if cmd.nil?
 
-    puts "Error: Unknown command '#{cmd}'"
-    puts ""
+    $stderr.puts "Error: Unknown command '#{cmd}'"
+    $stderr.puts ""
 
     # Try to suggest similar commands
     suggestion = suggest_command(cmd)
-    puts "Did you mean: #{suggestion}?" if suggestion
+    $stderr.puts "Did you mean: #{suggestion}?" if suggestion
 
-    puts ""
-    puts "Run 'exa-ai --help' for usage information."
+    $stderr.puts ""
+    $stderr.puts "Run 'exa-ai --help' for usage information."
   end
 
   def self.suggest_command(input)

data/exe/exa-ai-answer

@@ -38,7 +38,7 @@ def parse_args(argv)
       i += 2
     when "--help", "-h"
       puts <<~HELP
-        Usage: exa-api answer QUERY [OPTIONS]
+        Usage: exa-ai answer QUERY [OPTIONS]
 
         Generate an answer to a question using Exa AI
 
@@ -55,12 +55,12 @@ def parse_args(argv)
           --help, -h            Show this help message
 
         Examples:
-          exa-api answer "What is the capital of France?"
-          exa-api answer "Latest AI breakthroughs" --stream
-          exa-api answer "Latest AI breakthroughs" --text
-          exa-api answer "Ruby best practices" --output-format pretty
-          exa-api answer "What is the capital of France?" --output-schema '{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"}}}'
-          exa-api answer "What is Paris?" --system-prompt "Respond in the voice of a pirate"
+          exa-ai answer "What is the capital of France?"
+          exa-ai answer "Latest AI breakthroughs" --stream
+          exa-ai answer "Latest AI breakthroughs" --text
+          exa-ai answer "Ruby best practices" --output-format pretty
+          exa-ai answer "What is the capital of France?" --output-schema '{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"}}}'
+          exa-ai answer "What is Paris?" --system-prompt "Respond in the voice of a pirate"
       HELP
       exit 0
     else
@@ -80,7 +80,7 @@ begin
   # Validate query
   if args[:query].nil? || args[:query].empty?
     $stderr.puts "Error: Query is required"
-    $stderr.puts "Run 'exa-api answer --help' for usage information"
+    $stderr.puts "Run 'exa-ai answer --help' for usage information"
     exit 1
   end
 
@@ -125,6 +125,7 @@ begin
     result = client.answer(args[:query], **answer_params)
     output = Exa::CLI::Formatters::AnswerFormatter.format(result, output_format)
     puts output
+    $stdout.flush
   end
 
 rescue Exa::ConfigurationError => e

data/exe/exa-ai-context

@@ -43,7 +43,7 @@ end
 def print_help
   puts "Exa Context - Get code context from repositories"
   puts ""
-  puts "Usage: exa-api context <query> [options]"
+  puts "Usage: exa-ai context <query> [options]"
   puts ""
   puts "Arguments:"
   puts "  query                  Search query for code context (required)"
@@ -55,9 +55,9 @@ def print_help
   puts "  --help, -h             Show this help message"
   puts ""
   puts "Examples:"
-  puts "  exa-api context 'React hooks'"
-  puts "  exa-api context 'authentication with JWT in Ruby' --tokens-num 5000"
-  puts "  exa-api context 'React hooks' --output-format text"
+  puts "  exa-ai context 'React hooks'"
+  puts "  exa-ai context 'authentication with JWT in Ruby' --tokens-num 5000"
+  puts "  exa-ai context 'React hooks' --output-format text"
 end
 
 begin
@@ -68,7 +68,7 @@ begin
   unless options[:query]
     puts "Error: Query argument required"
     puts ""
-    puts "Run 'exa-api context --help' for usage information."
+    puts "Run 'exa-ai context --help' for usage information."
     exit 1
   end
 
@@ -91,6 +91,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::ContextFormatter.format(result, output_format)
   puts output
+  $stdout.flush
 rescue Exa::Error => e
   puts "Error: #{e.message}"
   exit 1

data/exe/exa-ai-enrichment-cancel

@@ -79,6 +79,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::EnrichmentFormatter.format(enrichment, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Enrichment not found: #{e.message}"

data/exe/exa-ai-enrichment-create

@@ -210,6 +210,7 @@ begin
   # Format and output result
   output = Exa::CLI::Formatters::EnrichmentFormatter.format(enrichment, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::ConfigurationError => e
   $stderr.puts "Configuration error: #{e.message}"

data/exe/exa-ai-enrichment-delete

@@ -93,6 +93,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::EnrichmentFormatter.format(result, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Enrichment not found: #{e.message}"

data/exe/exa-ai-enrichment-get

@@ -79,6 +79,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::EnrichmentFormatter.format(enrichment, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Enrichment not found: #{e.message}"

data/exe/exa-ai-enrichment-list

@@ -74,6 +74,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::EnrichmentFormatter.format_collection(collection, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Webset not found: #{e.message}"

data/exe/exa-ai-enrichment-update

@@ -142,6 +142,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::EnrichmentFormatter.format(enrichment, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Enrichment not found: #{e.message}"

data/exe/exa-ai-find-similar

@@ -215,6 +215,7 @@ begin
   # Format and output result
   output = Exa::CLI::Formatters::SearchFormatter.format(result, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::ConfigurationError => e
   $stderr.puts "Configuration error: #{e.message}"

data/exe/exa-ai-get-contents

@@ -164,7 +164,7 @@ end
 
 def print_help
   puts <<~HELP
-    Usage: exa-api get-contents <urls> [options]
+    Usage: exa-ai get-contents <urls> [options]
 
     Retrieve full page contents from URLs
 
@@ -203,12 +203,12 @@ def print_help
         --help, -h                   Show this help message
 
     Examples:
-      exa-api get-contents 'https://example.com'
-      exa-api get-contents 'https://example.com' --text
-      exa-api get-contents 'https://example.com' --text --text-max-characters 3000 --include-html-tags
-      exa-api get-contents 'url1,url2' --summary --summary-query "Be terse"
-      exa-api get-contents 'https://example.com' --subpages 1 --subpage-target about
-      exa-api get-contents 'https://example.com' --links 5 --image-links 10
+      exa-ai get-contents 'https://example.com'
+      exa-ai get-contents 'https://example.com' --text
+      exa-ai get-contents 'https://example.com' --text --text-max-characters 3000 --include-html-tags
+      exa-ai get-contents 'url1,url2' --summary --summary-query "Be terse"
+      exa-ai get-contents 'https://example.com' --subpages 1 --subpage-target about
+      exa-ai get-contents 'https://example.com' --links 5 --image-links 10
   HELP
 end
 
@@ -220,7 +220,7 @@ begin
   if options[:ids].empty?
     $stderr.puts "Error: URLs argument required"
     $stderr.puts ""
-    $stderr.puts "Run 'exa-api get-contents --help' for usage information."
+    $stderr.puts "Run 'exa-ai get-contents --help' for usage information."
     exit 1
   end
 
@@ -243,6 +243,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::ContentsFormatter.format(result, output_format)
   puts output
+  $stdout.flush
 rescue Exa::ConfigurationError => e
   $stderr.puts "Configuration error: #{e.message}"
   exit 1

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

data/exe/exa-ai-research-start

@@ -39,7 +39,7 @@ def parse_args(argv)
       i += 2
     when "--help", "-h"
       puts <<~HELP
-        Usage: exa-api research-start --instructions "TEXT" [OPTIONS]
+        Usage: exa-ai research-start --instructions "TEXT" [OPTIONS]
 
         Start a research task using Exa AI
 
@@ -54,10 +54,10 @@ def parse_args(argv)
           --help, -h            Show this help message
 
         Examples:
-          exa-api research-start --instructions "Find Ruby performance tips"
-          exa-api research-start --instructions "Analyze AI trends" --wait --events
-          exa-api research-start --instructions "Summarize papers" --model exa-research-pro --wait
-          exa-api research-start --instructions "Find stats" --output-schema '{"type":"object"}'
+          exa-ai research-start --instructions "Find Ruby performance tips"
+          exa-ai research-start --instructions "Analyze AI trends" --wait --events
+          exa-ai research-start --instructions "Summarize papers" --model exa-research-pro --wait
+          exa-ai research-start --instructions "Find stats" --output-schema '{"type":"object"}'
       HELP
       exit 0
     else
@@ -75,7 +75,7 @@ begin
   # Validate instructions
   if args[:instructions].nil? || args[:instructions].empty?
     $stderr.puts "Error: --instructions flag is required"
-    $stderr.puts "Run 'exa-api research-start --help' for usage information"
+    $stderr.puts "Run 'exa-ai research-start --help' for usage information"
     exit 1
   end
 
@@ -133,6 +133,7 @@ begin
       # Format and output final result
       output = Exa::CLI::Formatters::ResearchFormatter.format_task(final_task, output_format, show_events: args[:events])
       puts output
+      $stdout.flush
 
       # Exit with error code if task failed
       exit 1 if final_task.failed?
@@ -140,7 +141,7 @@ begin
     rescue Exa::CLI::Polling::TimeoutError => e
       $stderr.puts "\nError: Task did not complete within timeout period (5 minutes)"
       $stderr.puts "Task ID: #{task.research_id}"
-      $stderr.puts "You can check the status later with: exa-api research-get #{task.research_id}"
+      $stderr.puts "You can check the status later with: exa-ai research-get #{task.research_id}"
       exit 1
     end
   else

data/exe/exa-ai-search

@@ -20,7 +20,13 @@ def parse_args(argv)
       args[:num_results] = argv[i + 1].to_i
       i += 2
     when "--type"
-      args[:type] = argv[i + 1]
+      search_type = argv[i + 1]
+      valid_types = ["fast", "deep", "keyword", "auto"]
+      unless valid_types.include?(search_type)
+        $stderr.puts "Error: Search type must be one of: #{valid_types.join(', ')}"
+        exit 1
+      end
+      args[:type] = search_type
       i += 2
     when "--category"
       category = argv[i + 1]
@@ -116,7 +122,7 @@ def parse_args(argv)
       i += 2
     when "--help", "-h"
       puts <<~HELP
-        Usage: exa-api search QUERY [OPTIONS]
+        Usage: exa-ai search QUERY [OPTIONS]
 
         Search the web using Exa AI
 
@@ -125,7 +131,7 @@ def parse_args(argv)
 
         Options:
           --num-results N              Number of results to return (default: 10)
-          --type TYPE                  Search type: keyword, neural, fast, or auto (default: auto)
+          --type TYPE                  Search type: fast, deep, keyword, or auto (default: fast)
           --category CAT               Focus on specific data category
                                        Options: "company", "research paper", "news", "pdf",
                                        "github", "tweet", "personal site", "linkedin profile",
@@ -160,15 +166,15 @@ def parse_args(argv)
           --help, -h                   Show this help message
 
         Examples:
-          exa-api search "ruby programming"
-          exa-api search "machine learning" --num-results 5 --type keyword
-          exa-api search "Latest LLM research" --category "research paper"
-          exa-api search "AI startups" --category company
-          exa-api search "Anthropic" --linkedin company
-          exa-api search "Dario Amodei" --linkedin person
-          exa-api search "AI" --linkedin all
-          exa-api search "AI research" --include-domains arxiv.org,scholar.google.com
-          exa-api search "tutorials" --output-format pretty
+          exa-ai search "ruby programming"
+          exa-ai search "machine learning" --num-results 5 --type deep
+          exa-ai search "Latest LLM research" --category "research paper"
+          exa-ai search "AI startups" --category company
+          exa-ai search "Anthropic" --linkedin company
+          exa-ai search "Dario Amodei" --linkedin person
+          exa-ai search "AI" --linkedin all
+          exa-ai search "AI research" --include-domains arxiv.org,scholar.google.com
+          exa-ai search "tutorials" --output-format pretty
       HELP
       exit 0
     else
@@ -237,7 +243,7 @@ begin
   # Validate query
   if args[:query].nil? || args[:query].empty?
     $stderr.puts "Error: Query is required"
-    $stderr.puts "Run 'exa-api search --help' for usage information"
+    $stderr.puts "Run 'exa-ai search --help' for usage information"
     exit 1
   end
 
@@ -281,6 +287,7 @@ begin
   # Format and output result
   output = Exa::CLI::Formatters::SearchFormatter.format(result, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::ConfigurationError => e
   $stderr.puts "Configuration error: #{e.message}"

data/exe/exa-ai-webset-cancel

@@ -68,6 +68,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::WebsetFormatter.format(webset, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Webset not found: #{e.message}"

data/exe/exa-ai-webset-create

@@ -167,6 +167,7 @@ begin
   # Format and output result
   output = Exa::CLI::Formatters::WebsetFormatter.format(webset, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::ConfigurationError => e
   $stderr.puts "Configuration error: #{e.message}"

data/exe/exa-ai-webset-delete

@@ -82,6 +82,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::WebsetFormatter.format(result, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Webset not found: #{e.message}"

data/exe/exa-ai-webset-get

@@ -68,6 +68,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::WebsetFormatter.format(webset, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Webset not found: #{e.message}"

data/exe/exa-ai-webset-item-get

@@ -80,6 +80,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::WebsetItemFormatter.format(item, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Item not found: #{e.message}"

data/exe/exa-ai-webset-item-list

@@ -69,6 +69,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::WebsetItemFormatter.format_collection(items, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Webset not found: #{e.message}"

data/exe/exa-ai-webset-list

@@ -65,6 +65,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::WebsetFormatter.format_collection(collection, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::ConfigurationError => e
   $stderr.puts "Configuration error: #{e.message}"

data/exe/exa-ai-webset-search-cancel

@@ -77,8 +77,9 @@ begin
   search = client.cancel_webset_search(webset_id: webset_id, id: search_id)
 
   # Format and output
-  output = Exa::CLI::Formatters::WebsetSearchFormatter.format(search, output_format)
+  output = Exa::CLI::Formatters::SearchFormatter.format(search, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Search not found: #{e.message}"

data/exe/exa-ai-webset-search-create

@@ -203,8 +203,9 @@ begin
   search = client.create_webset_search(webset_id: args[:webset_id], **search_params)
 
   # Format and output result
-  output = Exa::CLI::Formatters::WebsetSearchFormatter.format(search, output_format)
+  output = Exa::CLI::Formatters::SearchFormatter.format(search, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::ConfigurationError => e
   $stderr.puts "Configuration error: #{e.message}"

data/exe/exa-ai-webset-search-get

@@ -78,8 +78,9 @@ begin
   search = client.get_webset_search(webset_id: webset_id, id: search_id)
 
   # Format and output
-  output = Exa::CLI::Formatters::WebsetSearchFormatter.format(search, output_format)
+  output = Exa::CLI::Formatters::SearchFormatter.format(search, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Search not found: #{e.message}"

data/exe/exa-ai-webset-update

@@ -111,6 +111,7 @@ begin
   # Format and output
   output = Exa::CLI::Formatters::WebsetFormatter.format(webset, output_format)
   puts output
+  $stdout.flush
 
 rescue Exa::NotFound => e
   $stderr.puts "Webset not found: #{e.message}"

data/lib/exa/middleware/raise_error.rb

@@ -41,6 +41,11 @@ module Exa
         body = env[:body]
 
         if body.is_a?(Hash)
+          # Prioritize "message" field for detailed error descriptions
+          return body["message"] if body["message"]
+          return body[:message] if body[:message]
+
+          # Fall back to "error" field
           return body["error"] if body["error"]
           return body[:error] if body[:error]
         end

data/lib/exa/services/search.rb

@@ -5,9 +5,13 @@ require_relative "parameter_converter"
 module Exa
   module Services
     class Search
+      VALID_SEARCH_TYPES = ["fast", "deep", "keyword", "auto"].freeze
+      DEFAULT_SEARCH_TYPE = "fast"
+
       def initialize(connection, **params)
         @connection = connection
-        @params = params
+        @params = normalize_params(params)
+        validate_search_type!
       end
 
       def call
@@ -23,6 +27,22 @@ module Exa
           cost_dollars: body["costDollars"]
         )
       end
+
+      private
+
+      def normalize_params(params)
+        normalized = params.dup
+        # Set default search type if not provided
+        normalized[:type] = DEFAULT_SEARCH_TYPE unless normalized.key?(:type)
+        normalized
+      end
+
+      def validate_search_type!
+        search_type = @params[:type]
+        return if VALID_SEARCH_TYPES.include?(search_type)
+
+        raise ArgumentError, "Invalid search type: '#{search_type}'. Must be one of: #{VALID_SEARCH_TYPES.join(', ')}"
+      end
     end
   end
 end

data/lib/exa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Exa
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: exa-ai
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Benjamin Jackson