exa-ai 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffa1108ddff0ff951dc18d12eeef57f74020a4c0425916a394fac95e4699fef5
-  data.tar.gz: 43c40cc61a7bee139dc3c179fe9d11c40b04dd506d53c22f88e312705ae9dfe3
+  metadata.gz: 52f222b86ee544f2e2bfa756c61e816cd874e8e1ac7d688dcb2bae8e242f712e
+  data.tar.gz: 254fc95859993deabded89ee9019a680dfa04b05b581a669296524d1a8dbc3b5
 SHA512:
-  metadata.gz: 5745df2cf4664fff7b8a507fb82662cd1e448a51dba7a0a0ac30485d624ac1bb3624e85b6086a6bd511a9485636b0d5a9804c561e9476106679a7458572fcf62
-  data.tar.gz: 637d5150a3b0d192b1c68288c83c4e0ad13827d4d60ac9deb4a974397ab9b0c2ab86dd9281f33bc11dc5e1fd7ba06b22daa4c8d0f80c8927c108946e4c8ffe46
+  metadata.gz: af592dc58ceec4b4da49a069622c7f14c65205fd2349fa89ab35b517d368b565b51581e22d401802df96a3a47404d9717ea9d88bfede54d0c513dd1a0434bb96
+  data.tar.gz: 0b6f2aa5c9494b934d07499218b2a8156c6150c435e8fea9e5b8ec7b765adbbf922193187c07c256ed776aa17bb7284e77fb6c1cdbf82e0e56a3fa79c65071d4

data/exe/exa-ai-search

@@ -18,9 +18,8 @@ def print_help
       --type TYPE                  Search type: auto, neural, fast, deep, deep-reasoning,
                                    or instant (default: auto)
       --category CAT               Focus on specific data category
-                                   Options: "company", "research paper", "news", "pdf",
-                                   "github", "tweet", "personal site", "financial report",
-                                   "people"
+                                   Options: "company", "research paper", "news", "github",
+                                   "tweet", "personal site", "financial report", "people"
       --include-domains D          Comma-separated list of domains to include
       --exclude-domains D          Comma-separated list of domains to exclude
       --start-published-date DATE  Filter by published date (ISO 8601 format)
@@ -33,6 +32,7 @@ def print_help
     Content Extraction:
       --text                       Include full webpage text
       --text-max-characters N      Max characters for webpage text
+      --text-verbosity LEVEL       Text verbosity: compact, standard, or full
       --include-html-tags          Include HTML tags in text extraction
       --summary                    Include AI-generated summary
       --summary-query PROMPT       Custom prompt for summary generation
@@ -48,14 +48,16 @@ def print_help
       --highlights-num-sentences N   Number of sentences per highlight
       --highlights-per-url N       Number of highlights per URL
       --highlights-query QUERY     Custom query for highlight extraction
-      --livecrawl MODE             Livecrawl mode: always, fallback, never, auto, or preferred
-      --livecrawl-timeout N        Livecrawl timeout in milliseconds
+      --livecrawl                  Enable livecrawl (sets maxAgeHours=0, livecrawlTimeout=5000)
+      --livecrawl-timeout N        Livecrawl timeout in milliseconds (overrides --livecrawl default)
       --max-age-hours N            Maximum age of results in hours
 
     Search Options:
       --additional-queries QUERY   Additional search queries (repeatable)
       --output-schema JSON         JSON schema for output structure (@file syntax)
       --user-location CODE         User location (ISO country code)
+      --system-prompt PROMPT       System prompt for AI-powered search
+      --moderation                 Enable content moderation
 
     General Options:
       --api-key KEY                Exa API key (or set EXA_API_KEY env var)
@@ -79,10 +81,11 @@ def build_contents(args)
 
   # Text options
   if args[:text]
-    if args[:text_max_characters] || args[:include_html_tags]
+    if args[:text_max_characters] || args[:include_html_tags] || args[:text_verbosity]
       contents[:text] = {}
       contents[:text][:max_characters] = args[:text_max_characters] if args[:text_max_characters]
       contents[:text][:include_html_tags] = args[:include_html_tags] if args[:include_html_tags]
+      contents[:text][:verbosity] = args[:text_verbosity] if args[:text_verbosity]
     else
       contents[:text] = true
     end
@@ -134,9 +137,13 @@ def build_contents(args)
   end
 
   # Livecrawl options
-  contents[:livecrawl] = args[:livecrawl] if args[:livecrawl]
-  contents[:livecrawl_timeout] = args[:livecrawl_timeout] if args[:livecrawl_timeout]
-  contents[:max_age_hours] = args[:max_age_hours] if args[:max_age_hours]
+  if args[:livecrawl]
+    contents[:max_age_hours] = args[:max_age_hours].nil? ? 0 : args[:max_age_hours]
+    contents[:livecrawl_timeout] = args[:livecrawl_timeout].nil? ? 5000 : args[:livecrawl_timeout]
+  else
+    contents[:livecrawl_timeout] = args[:livecrawl_timeout] if args[:livecrawl_timeout]
+    contents[:max_age_hours] = args[:max_age_hours] if args[:max_age_hours]
+  end
 
   contents.empty? ? nil : contents
 end
@@ -177,6 +184,8 @@ begin
   search_params[:additional_queries] = args[:additional_queries] if args[:additional_queries]
   search_params[:output_schema] = args[:output_schema] if args[:output_schema]
   search_params[:user_location] = args[:user_location] if args[:user_location]
+  search_params[:system_prompt] = args[:system_prompt] if args[:system_prompt]
+  search_params[:moderation] = args[:moderation] if args[:moderation]
   contents = build_contents(args)
   search_params.merge!(contents) if contents
 

data/lib/exa/cli/search_parser.rb

@@ -4,9 +4,9 @@ module Exa
   module CLI
     class SearchParser
       VALID_SEARCH_TYPES = ["auto", "neural", "fast", "deep", "deep-reasoning", "instant"].freeze
-      VALID_LIVECRAWL_MODES = ["always", "fallback", "never", "auto", "preferred"].freeze
+      VALID_TEXT_VERBOSITY = ["compact", "standard", "full"].freeze
       VALID_CATEGORIES = [
-        "company", "research paper", "news", "pdf", "github",
+        "company", "research paper", "news", "github",
         "tweet", "personal site", "financial report", "people"
       ].freeze
 
@@ -140,10 +140,8 @@ module Exa
             @args[:highlights_query] = @argv[i + 1]
             i += 2
           when "--livecrawl"
-            livecrawl = @argv[i + 1]
-            validate_livecrawl(livecrawl)
-            @args[:livecrawl] = livecrawl
-            i += 2
+            @args[:livecrawl] = true
+            i += 1
           when "--livecrawl-timeout"
             @args[:livecrawl_timeout] = @argv[i + 1].to_i
             i += 2
@@ -165,6 +163,17 @@ module Exa
           when "--user-location"
             @args[:user_location] = @argv[i + 1]
             i += 2
+          when "--system-prompt"
+            @args[:system_prompt] = @argv[i + 1]
+            i += 2
+          when "--moderation"
+            @args[:moderation] = true
+            i += 1
+          when "--text-verbosity"
+            verbosity = @argv[i + 1]
+            validate_text_verbosity(verbosity)
+            @args[:text_verbosity] = verbosity
+            i += 2
           else
             query_parts << arg
             i += 1
@@ -184,17 +193,17 @@ module Exa
         raise ArgumentError, "Search type must be one of: #{VALID_SEARCH_TYPES.join(', ')}"
       end
 
-      def validate_livecrawl(mode)
-        return if VALID_LIVECRAWL_MODES.include?(mode)
-
-        raise ArgumentError, "Livecrawl mode must be one of: #{VALID_LIVECRAWL_MODES.join(', ')}"
-      end
-
       def validate_category(category)
         return if VALID_CATEGORIES.include?(category)
 
         raise ArgumentError, "Category must be one of: #{VALID_CATEGORIES.map { |c| "\"#{c}\"" }.join(', ')}"
       end
+
+      def validate_text_verbosity(verbosity)
+        return if VALID_TEXT_VERBOSITY.include?(verbosity)
+
+        raise ArgumentError, "Text verbosity must be one of: #{VALID_TEXT_VERBOSITY.join(', ')}"
+      end
     end
   end
 end

data/lib/exa/services/parameter_converter.rb

@@ -42,6 +42,7 @@ module Exa
         when :num_results then :numResults
         when :include_domains then :includeDomains
         when :exclude_domains then :excludeDomains
+        when :system_prompt then :systemPrompt
         else
           key
         end
@@ -112,7 +113,8 @@ module Exa
           max_characters: :maxCharacters,
           include_html_tags: :includeHtmlTags,
           include_sections: :includeSections,
-          exclude_sections: :excludeSections
+          exclude_sections: :excludeSections,
+          verbosity: :verbosity
         }
       end
 

data/lib/exa/version.rb

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

metadata

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