exa-ai 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4458cc74fb6924d5e7e57300ba28ae1db399d0d89bf68495b1203f5fe29d73d2
-  data.tar.gz: 00b7f59be62aad198438660acdec2e1a2e3c86539bd1a462c4ea03f45c08a87b
+  metadata.gz: 4f55e9efe411da4b9eaf3018791aa7819fc8872c69e32369627014594eb23670
+  data.tar.gz: 0d074ce4bb6eaa2902b80fe5df239be717f182c3703ebfcd6c45944de7cd1245
 SHA512:
-  metadata.gz: b45e4d6a35d33910e9ce4b154b1b432efba13732b9c237ab94da5962944fae65bf3562a426dc9fa9c18af8c820e8db5d1a4ae3417605d171a136de2d01f149db
-  data.tar.gz: 98f082e62eeef3cf7851abcda1cdd61ee5edd548c2cd0d5a65b7645510248ebd0a2274b743e83b7ff354e1ebb4016a92ab83e8a4f93300c255d298fdb9a2683b
+  metadata.gz: 732d915bf1eadcabff77ae2dcf7c573d426021bea3dac1fe0b2013958dde5a53129c62675ff66279b5204233c970b988ea72ad29ef94bb4b5219cba55910145b
+  data.tar.gz: f4f73347c282e2ebb2209afd42a02e1fb253e9d682a5959ce1cd2ea27519f132c156fb897bbd3177d24f4b88bd06874afd76b81bf70ccb225dcb3ad64ec6249b

data/exe/exa-ai-enrichment-create

@@ -51,9 +51,7 @@ def parse_args(argv)
         --format TYPE              One of: #{VALID_FORMATS.join(', ')}
 
       Options:
-        --title TEXT               Display title
         --options JSON             Array of {label: "..."} (required if format=options, supports @file.json)
-        --instructions TEXT        Additional instructions
         --metadata JSON            Custom metadata (supports @file.json)
         --wait                     Wait for enrichment to complete
         --api-key KEY              Exa API key (or set EXA_API_KEY env var)
@@ -91,15 +89,9 @@ def parse_args(argv)
     when "--format"
       args[:format] = argv[i + 1]
       i += 2
-    when "--title"
-      args[:title] = argv[i + 1]
-      i += 2
     when "--options"
       args[:options] = parse_json_or_file(argv[i + 1])
       i += 2
-    when "--instructions"
-      args[:instructions] = argv[i + 1]
-      i += 2
     when "--metadata"
       args[:metadata] = parse_json_or_file(argv[i + 1])
       i += 2
@@ -170,9 +162,7 @@ begin
     description: args[:description],
     format: args[:format]
   }
-  enrichment_params[:title] = args[:title] if args[:title]
   enrichment_params[:options] = args[:options] if args[:options]
-  enrichment_params[:instructions] = args[:instructions] if args[:instructions]
   enrichment_params[:metadata] = args[:metadata] if args[:metadata]
 
   # Create enrichment

data/exe/exa-ai-import-create

@@ -56,6 +56,7 @@ def parse_args(argv)
         --entity-type TYPE        Entity type (options: #{VALID_ENTITY_TYPES.join(', ')})
 
       Options:
+        --entity-description TXT  Description for custom entity type (required with --entity-type custom)
         --csv-identifier N        CSV column identifier (0-indexed)
         --metadata JSON           Custom metadata (supports @file.json)
         --quiet                   Suppress normal output (only show errors)
@@ -102,6 +103,9 @@ def parse_args(argv)
     when "--entity-type"
       args[:entity_type] = argv[i + 1]
       i += 2
+    when "--entity-description"
+      args[:entity_description] = argv[i + 1]
+      i += 2
     when "--csv-identifier"
       args[:csv_identifier] = argv[i + 1].to_i
       i += 2
@@ -161,6 +165,17 @@ begin
     exit 1
   end
 
+  # Validate entity-description for custom entity type
+  if args[:entity_type] == "custom"
+    unless args[:entity_description]
+      $stderr.puts "Error: --entity-description is required when --entity-type is 'custom'"
+      $stderr.puts "Run 'exa-ai import-create --help' for usage information"
+      exit 1
+    end
+  elsif args[:entity_description]
+    $stderr.puts "Warning: --entity-description is only used with --entity-type custom (ignoring)"
+  end
+
   # Validate file exists
   unless File.exist?(args[:file_path])
     $stderr.puts "Error: File not found: #{args[:file_path]}"
@@ -177,12 +192,15 @@ begin
   client = Exa::CLI::Base.build_client(api_key)
 
   # Prepare import parameters
+  entity = { type: args[:entity_type] }
+  entity[:description] = args[:entity_description] if args[:entity_description]
+
   import_params = {
     file_path: args[:file_path],
     count: args[:count],
     title: args[:title],
     format: args[:format],
-    entity: { type: args[:entity_type] }
+    entity: entity
   }
   import_params[:metadata] = args[:metadata] if args[:metadata]
 

data/exe/exa-ai-webset-create

@@ -80,32 +80,51 @@ def parse_args(argv)
         Create a new webset from search criteria or an import
 
         Required (choose one):
-          --search JSON              Search configuration (supports @file.json)
-          --import ID                Import or webset ID to create webset from
-                                     (accepts import_* or webset_* IDs)
+          --search JSON              Search configuration as JSON (supports @file.json)
+                                     Format: {"query":"...","count":10,"scope":[...]}
+                                     The 'scope' field limits search to specific sources
+          --import ID                Import/webset ID to attach data to this webset
+                                     (loads data but does NOT filter searches)
+                                     Format: import_abc123 or webset_xyz789
 
         Options:
           --enrichments JSON         Array of enrichment configs (supports @file.json)
-          --exclude JSON             Array of exclude configs (supports @file.json)
+                                     Format: [{"description":"...","format":"text"}]
+          --exclude JSON             Sources to exclude from searches (supports @file.json)
+                                     Format: [{"source":"import|webset","id":"..."}]
           --external-id ID           External identifier for the webset
           --metadata JSON            Custom metadata (supports @file.json)
+                                     Format: {"key":"value"}
           --wait                     Wait for webset to reach idle status
           --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
 
+        JSON Format Details:
+          search.scope               Array of source references to limit search
+                                     Format: [{"source":"import|webset","id":"..."}]
+                                     With relationship (hop search):
+                                     [{"source":"webset","id":"ws_123",
+                                       "relationship":{"definition":"investors of","limit":3}}]
+
+          IMPORTANT: Cannot use the same import ID in both --import and search.scope
+                    (this will return a 400 error from the API)
+
         Examples:
           # Create webset from search
           exa-ai webset-create --search '{"query":"AI startups","count":10}'
           exa-ai webset-create --search @search.json --enrichments @enrichments.json
           exa-ai webset-create --search @search.json --wait
 
+          # Create webset with scoped search (filter to specific import)
+          exa-ai webset-create --search '{"query":"CEOs","count":10,"scope":[{"source":"import","id":"import_abc"}]}'
+
           # Create webset from import
           exa-ai webset-create --import import_abc123
           exa-ai webset-create --import import_def456 --enrichments @enrichments.json
 
-          # Create webset from existing webset
-          exa-ai webset-create --import webset_xyz789
+          # Load import AND run search (search not scoped to import)
+          exa-ai webset-create --import import_abc123 --search '{"query":"investors","count":20}'
       HELP
       exit 0
     else

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

@@ -104,11 +104,20 @@ def parse_args(argv)
           --entity TYPE            Entity type: person, company, article, research_paper, custom
           --entity-description TXT Description for custom entity type (required with --entity custom)
           --criteria JSON          Search criteria array (supports @file.json)
+                                   Format: [{"description":"criterion 1"},{"description":"criterion 2"}]
           --exclude JSON           Items to exclude from results (supports @file.json)
+                                   Format: [{"source":"import|webset","id":"..."}]
           --scope JSON             Limit search to specific sources (supports @file.json)
+                                   Format: [{"source":"import|webset","id":"..."}]
+                                   Filters this search to only items from these sources
+                                   With relationship (hop search):
+                                   [{"source":"webset","id":"ws_123",
+                                     "relationship":{"definition":"investors of","limit":3}}]
           --recall                 Estimate total available results
-          --behavior TYPE          "override" or "append" (default: override)
+          --behavior TYPE          "override" (replace items) or "append" (add items)
+                                   Default: override when scope is present, append otherwise
           --metadata JSON          Custom metadata (supports @file.json)
+                                   Format: {"key":"value"}
           --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
@@ -121,11 +130,15 @@ def parse_args(argv)
           exa-ai webset-search-create ws_123 --query "tech CEOs" --entity person
           exa-ai webset-search-create ws_123 --query "Silicon Valley firms" --entity company
 
-          # Search with custom entity type
-          exa-ai webset-search-create ws_123 --query "Ford Mustang" \\
-            --entity custom --entity-description "vintage cars"
+          # Scoped search (filter to specific import)
+          exa-ai webset-search-create ws_123 --query "CTOs" \\
+            --scope '[{"source":"import","id":"import_abc"}]'
 
-          # Other options
+          # Hop search (find investors of companies in webset)
+          exa-ai webset-search-create ws_123 --query "investors" \\
+            --scope '[{"source":"webset","id":"ws_companies","relationship":{"definition":"investors of","limit":5}}]'
+
+          # Search with criteria and behavior
           exa-ai webset-search-create ws_123 --query "machine learning" --count 50
           exa-ai webset-search-create ws_123 --query "research" --behavior append --recall
       HELP
@@ -203,7 +216,7 @@ begin
   search = client.create_webset_search(webset_id: args[:webset_id], **search_params)
 
   # Format and output result
-  output = Exa::CLI::Formatters::SearchFormatter.format(search, output_format)
+  output = Exa::CLI::Formatters::WebsetSearchFormatter.format(search, output_format)
   puts output
   $stdout.flush
 

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

@@ -78,7 +78,7 @@ begin
   search = client.get_webset_search(webset_id: webset_id, id: search_id)
 
   # Format and output
-  output = Exa::CLI::Formatters::SearchFormatter.format(search, output_format)
+  output = Exa::CLI::Formatters::WebsetSearchFormatter.format(search, output_format)
   puts output
   $stdout.flush
 

data/lib/exa/cli/formatters/enrichment_formatter.rb

@@ -9,7 +9,7 @@ module Exa
           when "json"
             JSON.generate(enrichment.to_h)
           when "pretty"
-            JSON.pretty_generate(enrichment.to_h)
+            format_as_pretty(enrichment)
           when "text"
             format_as_text(enrichment)
           when "toon"
@@ -24,7 +24,7 @@ module Exa
           when "json"
             JSON.generate(collection.to_h)
           when "pretty"
-            JSON.pretty_generate(collection.to_h)
+            format_collection_as_pretty(collection)
           when "text"
             format_collection_as_text(collection)
           when "toon"
@@ -34,6 +34,31 @@ module Exa
           end
         end
 
+        def self.format_as_pretty(enrichment)
+          lines = []
+          lines << "Enrichment ID: #{enrichment.id}"
+          lines << "Webset ID:     #{enrichment.webset_id}" if enrichment.webset_id
+          lines << "Status:        #{enrichment.status}"
+          lines << "Title:         #{enrichment.title}" if enrichment.title
+          lines << "Description:   #{enrichment.description}" if enrichment.description
+          lines << "Format:        #{enrichment.format}" if enrichment.format
+
+          if enrichment.options && !enrichment.options.empty?
+            lines << ""
+            lines << "Options (#{enrichment.options.length}):"
+            enrichment.options.each do |option|
+              lines << "  • #{option['label']}" if option['label']
+            end
+          end
+
+          lines << ""
+          lines << "Created:       #{enrichment.created_at}" if enrichment.created_at
+          lines << "Updated:       #{enrichment.updated_at}" if enrichment.updated_at
+
+          lines.join("\n")
+        end
+        private_class_method :format_as_pretty
+
         def self.format_as_text(enrichment)
           lines = []
           lines << "Enrichment: #{enrichment.id}"
@@ -57,6 +82,33 @@ module Exa
         end
         private_class_method :format_as_text
 
+        def self.format_collection_as_pretty(collection)
+          lines = []
+          lines << "Enrichments (#{collection.data.length} items)"
+          lines << ""
+
+          collection.data.each_with_index do |enr, idx|
+            lines << "" if idx > 0  # Blank line between enrichments
+
+            lines << "Enrichment ID: #{enr['id']}"
+            lines << "Webset ID:     #{enr['websetId']}" if enr['websetId']
+            lines << "Status:        #{enr['status']}"
+            lines << "Title:         #{enr['title']}" if enr['title']
+            lines << "Description:   #{enr['description']}" if enr['description']
+            lines << "Format:        #{enr['format']}" if enr['format']
+            lines << "Created:       #{enr['createdAt']}" if enr['createdAt']
+            lines << "Updated:       #{enr['updatedAt']}" if enr['updatedAt']
+          end
+
+          if collection.has_more
+            lines << ""
+            lines << "Next Cursor:   #{collection.next_cursor}"
+          end
+
+          lines.join("\n")
+        end
+        private_class_method :format_collection_as_pretty
+
         def self.format_collection_as_text(collection)
           lines = ["Enrichments (#{collection.data.length} items):"]
           collection.data.each do |enr|

data/lib/exa/cli/formatters/import_formatter.rb

@@ -9,7 +9,7 @@ module Exa
           when "json"
             JSON.generate(import.to_h)
           when "pretty"
-            JSON.pretty_generate(import.to_h)
+            format_as_pretty(import)
           when "text"
             format_as_text(import)
           when "toon"
@@ -24,7 +24,7 @@ module Exa
           when "json"
             JSON.generate(collection.to_h)
           when "pretty"
-            JSON.pretty_generate(collection.to_h)
+            format_collection_as_pretty(collection)
           when "text"
             format_collection_as_text(collection)
           when "toon"
@@ -34,6 +34,43 @@ module Exa
           end
         end
 
+        def self.format_as_pretty(import)
+          lines = []
+          lines << "Import ID:     #{import.id}"
+          lines << "Status:        #{import.status}"
+          lines << "Title:         #{import.title}" if import.title
+          lines << "Format:        #{import.format}" if import.format
+
+          if import.entity
+            entity_type = import.entity['type'] || import.entity[:type]
+            lines << "Entity Type:   #{entity_type}" if entity_type
+          end
+
+          lines << "Count:         #{import.count}" if import.count
+
+          if import.failed?
+            lines << ""
+            lines << "Failure:"
+            lines << "  Reason:      #{import.failed_reason}" if import.failed_reason
+            lines << "  Message:     #{import.failed_message}" if import.failed_message
+            lines << "  Failed At:   #{import.failed_at}" if import.failed_at
+          end
+
+          if import.upload_url
+            lines << ""
+            lines << "Upload:"
+            lines << "  URL:         #{import.upload_url}"
+            lines << "  Valid Until: #{import.upload_valid_until}" if import.upload_valid_until
+          end
+
+          lines << ""
+          lines << "Created:       #{import.created_at}" if import.created_at
+          lines << "Updated:       #{import.updated_at}" if import.updated_at
+
+          lines.join("\n")
+        end
+        private_class_method :format_as_pretty
+
         def self.format_as_text(import)
           lines = []
           lines << "Import: #{import.id}"
@@ -68,6 +105,37 @@ module Exa
         end
         private_class_method :format_as_text
 
+        def self.format_collection_as_pretty(collection)
+          lines = []
+          lines << "Imports (#{collection.data.length} items)"
+          lines << ""
+
+          collection.data.each_with_index do |imp, idx|
+            lines << "" if idx > 0  # Blank line between imports
+
+            lines << "Import ID:     #{imp.id}"
+            lines << "Status:        #{imp.status}"
+            lines << "Title:         #{imp.title}" if imp.title
+            lines << "Format:        #{imp.format}" if imp.format
+            lines << "Entity Type:   #{imp.entity['type']}" if imp.entity && imp.entity['type']
+            lines << "Count:         #{imp.count}" if imp.count
+            lines << "Created:       #{imp.created_at}" if imp.created_at
+            lines << "Updated:       #{imp.updated_at}" if imp.updated_at
+
+            if imp.status == 'failed'
+              lines << "Failed Reason: #{imp.failed_reason}" if imp.failed_reason
+            end
+          end
+
+          if collection.has_more
+            lines << ""
+            lines << "Next Cursor:   #{collection.next_cursor}"
+          end
+
+          lines.join("\n")
+        end
+        private_class_method :format_collection_as_pretty
+
         def self.format_collection_as_text(collection)
           lines = ["Imports (#{collection.data.length} items):"]
           collection.data.each do |imp|

data/lib/exa/cli/formatters/monitor_formatter.rb

@@ -9,7 +9,7 @@ module Exa
           when "json"
             JSON.generate(monitor.to_h)
           when "pretty"
-            JSON.pretty_generate(monitor.to_h)
+            format_as_pretty(monitor)
           when "text"
             format_as_text(monitor)
           when "toon"
@@ -24,7 +24,7 @@ module Exa
           when "json"
             JSON.generate(collection.to_h)
           when "pretty"
-            JSON.pretty_generate(collection.to_h)
+            format_collection_as_pretty(collection)
           when "text"
             format_collection_as_text(collection)
           when "toon"
@@ -34,6 +34,35 @@ module Exa
           end
         end
 
+        def self.format_as_pretty(monitor)
+          lines = []
+          lines << "Monitor ID:    #{monitor.id}"
+          lines << "Webset ID:     #{monitor.webset_id}" if monitor.webset_id
+          lines << "Status:        #{monitor.status}"
+
+          if monitor.cadence
+            lines << ""
+            lines << "Cadence:"
+            lines << "  Cron:        #{monitor.cadence['cron']}" if monitor.cadence['cron']
+            lines << "  Timezone:    #{monitor.cadence['timezone']}" if monitor.cadence['timezone']
+          end
+
+          if monitor.behavior
+            lines << ""
+            lines << "Behavior:"
+            lines << "  Type:        #{monitor.behavior['type']}" if monitor.behavior['type']
+            lines << "  Query:       #{monitor.behavior['query']}" if monitor.behavior['query']
+            lines << "  Count:       #{monitor.behavior['count']}" if monitor.behavior['count']
+          end
+
+          lines << ""
+          lines << "Created:       #{monitor.created_at}" if monitor.created_at
+          lines << "Updated:       #{monitor.updated_at}" if monitor.updated_at
+
+          lines.join("\n")
+        end
+        private_class_method :format_as_pretty
+
         def self.format_as_text(monitor)
           lines = []
           lines << "Monitor: #{monitor.id}"
@@ -60,6 +89,40 @@ module Exa
         end
         private_class_method :format_as_text
 
+        def self.format_collection_as_pretty(collection)
+          lines = []
+          lines << "Monitors (#{collection.data.length} items)"
+          lines << ""
+
+          collection.data.each_with_index do |mon, idx|
+            lines << "" if idx > 0  # Blank line between monitors
+
+            lines << "Monitor ID:    #{mon['id']}"
+            lines << "Webset ID:     #{mon['websetId']}" if mon['websetId']
+            lines << "Status:        #{mon['status']}"
+
+            if mon['cadence']
+              lines << "Cron:          #{mon['cadence']['cron']}" if mon['cadence']['cron']
+              lines << "Timezone:      #{mon['cadence']['timezone']}" if mon['cadence']['timezone']
+            end
+
+            if mon['behavior']
+              lines << "Query:         #{mon['behavior']['query']}" if mon['behavior']['query']
+            end
+
+            lines << "Created:       #{mon['createdAt']}" if mon['createdAt']
+            lines << "Updated:       #{mon['updatedAt']}" if mon['updatedAt']
+          end
+
+          if collection.has_more
+            lines << ""
+            lines << "Next Cursor:   #{collection.next_cursor}"
+          end
+
+          lines.join("\n")
+        end
+        private_class_method :format_collection_as_pretty
+
         def self.format_collection_as_text(collection)
           lines = ["Monitors (#{collection.data.length} items):"]
           collection.data.each do |mon|

data/lib/exa/cli/formatters/monitor_run_formatter.rb

@@ -9,7 +9,7 @@ module Exa
           when "json"
             JSON.generate(monitor_run.to_h)
           when "pretty"
-            JSON.pretty_generate(monitor_run.to_h)
+            format_as_pretty(monitor_run)
           when "text"
             format_as_text(monitor_run)
           when "toon"
@@ -24,7 +24,7 @@ module Exa
           when "json"
             JSON.generate(collection.to_h)
           when "pretty"
-            JSON.pretty_generate(collection.to_h)
+            format_collection_as_pretty(collection)
           when "text"
             format_collection_as_text(collection)
           when "toon"
@@ -34,6 +34,27 @@ module Exa
           end
         end
 
+        def self.format_as_pretty(monitor_run)
+          lines = []
+          lines << "Monitor Run ID: #{monitor_run.id}"
+          lines << "Monitor ID:     #{monitor_run.monitor_id}" if monitor_run.monitor_id
+          lines << "Status:         #{monitor_run.status}"
+
+          lines << ""
+          lines << "Created:        #{monitor_run.created_at}" if monitor_run.created_at
+          lines << "Updated:        #{monitor_run.updated_at}" if monitor_run.updated_at
+          lines << "Completed:      #{monitor_run.completed_at}" if monitor_run.completed_at
+
+          if monitor_run.failed?
+            lines << ""
+            lines << "Failed:         #{monitor_run.failed_at}" if monitor_run.failed_at
+            lines << "Reason:         #{monitor_run.failed_reason}" if monitor_run.failed_reason
+          end
+
+          lines.join("\n")
+        end
+        private_class_method :format_as_pretty
+
         def self.format_as_text(monitor_run)
           lines = []
           lines << "Monitor Run: #{monitor_run.id}"
@@ -53,6 +74,36 @@ module Exa
         end
         private_class_method :format_as_text
 
+        def self.format_collection_as_pretty(collection)
+          lines = []
+          lines << "Monitor Runs (#{collection.data.length} items)"
+          lines << ""
+
+          collection.data.each_with_index do |run, idx|
+            lines << "" if idx > 0  # Blank line between runs
+
+            lines << "Monitor Run ID: #{run['id']}"
+            lines << "Monitor ID:     #{run['monitorId']}" if run['monitorId']
+            lines << "Status:         #{run['status']}"
+            lines << "Created:        #{run['createdAt']}" if run['createdAt']
+            lines << "Updated:        #{run['updatedAt']}" if run['updatedAt']
+            lines << "Completed:      #{run['completedAt']}" if run['completedAt']
+
+            if run['status'] == 'failed'
+              lines << "Failed:         #{run['failedAt']}" if run['failedAt']
+              lines << "Reason:         #{run['failedReason']}" if run['failedReason']
+            end
+          end
+
+          if collection.has_more
+            lines << ""
+            lines << "Next Cursor:    #{collection.next_cursor}"
+          end
+
+          lines.join("\n")
+        end
+        private_class_method :format_collection_as_pretty
+
         def self.format_collection_as_text(collection)
           lines = ["Monitor Runs (#{collection.data.length} items):"]
           collection.data.each do |run|

data/lib/exa/cli/formatters/webset_formatter.rb

@@ -24,7 +24,7 @@ module Exa
           when "json"
             JSON.generate(collection.to_h)
           when "pretty"
-            JSON.pretty_generate(collection.to_h)
+            format_collection_as_pretty(collection)
           when "text"
             format_collection_as_text(collection)
           when "toon"
@@ -66,6 +66,66 @@ module Exa
           lines.join("\n")
         end
         private_class_method :format_collection_as_text
+
+        def self.format_collection_as_pretty(collection)
+          lines = []
+
+          # Header with count and pagination info
+          header = "Websets (#{collection.data.length} items)"
+          header += " - Page #{collection.has_more ? '1 of many' : '1 of 1'}" if collection.data.any?
+          lines << header
+
+          if collection.has_more
+            lines << "Next Cursor:   #{collection.next_cursor}"
+          end
+
+          lines << ""
+
+          # Format each webset
+          collection.data.each_with_index do |ws, idx|
+            lines << "" if idx > 0  # Blank line between websets
+
+            lines << "Webset ID:     #{ws['id']}"
+            lines << "Status:        #{ws['status']}"
+            lines << "Title:         #{ws['title']}" if ws['title']
+            lines << "External ID:   #{ws['externalId']}" if ws['externalId']
+            lines << "Created:       #{ws['createdAt']}" if ws['createdAt']
+            lines << "Updated:       #{ws['updatedAt']}" if ws['updatedAt']
+
+            # Searches
+            if ws['searches'] && !ws['searches'].empty?
+              lines << ""
+              lines << "Searches (#{ws['searches'].length}):"
+              ws['searches'].each do |search|
+                status_indicator = case search['status']
+                                   when 'completed' then '✓'
+                                   when 'running' then '→'
+                                   when 'failed' then '✗'
+                                   else '•'
+                                   end
+                lines << "  #{status_indicator} #{search['query']} (#{search['status']})" if search['query']
+              end
+            end
+
+            # Enrichments
+            if ws['enrichments'] && !ws['enrichments'].empty?
+              lines << "Enrichments:   #{ws['enrichments'].length}"
+            end
+
+            # Monitors
+            if ws['monitors'] && !ws['monitors'].empty?
+              lines << "Monitors:      #{ws['monitors'].length}"
+            end
+
+            # Imports
+            if ws['imports'] && !ws['imports'].empty?
+              lines << "Imports:       #{ws['imports'].length}"
+            end
+          end
+
+          lines.join("\n")
+        end
+        private_class_method :format_collection_as_pretty
       end
     end
   end

data/lib/exa/cli/formatters/webset_item_formatter.rb

@@ -9,7 +9,7 @@ module Exa
           when "json"
             JSON.generate(item)
           when "pretty"
-            JSON.pretty_generate(item)
+            format_as_pretty(item)
           when "text"
             format_as_text(item)
           when "toon"
@@ -24,7 +24,7 @@ module Exa
           when "json"
             JSON.generate(items)
           when "pretty"
-            JSON.pretty_generate(items)
+            format_collection_as_pretty(items)
           when "text"
             format_collection_as_text(items)
           when "toon"
@@ -34,6 +34,27 @@ module Exa
           end
         end
 
+        def self.format_as_pretty(item)
+          lines = []
+          lines << "Item ID:       #{item['id']}"
+          lines << "URL:           #{item['url']}" if item['url']
+          lines << "Title:         #{item['title']}" if item['title']
+          lines << "Status:        #{item['status']}" if item['status']
+          lines << "Created:       #{item['createdAt']}" if item['createdAt']
+          lines << "Updated:       #{item['updatedAt']}" if item['updatedAt']
+
+          if item['entity']
+            lines << ""
+            lines << "Entity:"
+            lines << "  Type:        #{item['entity']['type']}" if item['entity']['type']
+            lines << "  Name:        #{item['entity']['name']}" if item['entity']['name']
+            lines << "  Description: #{item['entity']['description']}" if item['entity']['description']
+          end
+
+          lines.join("\n")
+        end
+        private_class_method :format_as_pretty
+
         def self.format_as_text(item)
           lines = []
           lines << "Item: #{item['id']}"
@@ -53,6 +74,33 @@ module Exa
         end
         private_class_method :format_as_text
 
+        def self.format_collection_as_pretty(items)
+          lines = []
+          lines << "Items (#{items.length})"
+          lines << ""
+
+          items.each_with_index do |item, idx|
+            lines << "" if idx > 0  # Blank line between items
+
+            lines << "Item ID:       #{item['id']}"
+            lines << "URL:           #{item['url']}" if item['url']
+            lines << "Title:         #{item['title']}" if item['title']
+            lines << "Status:        #{item['status']}" if item['status']
+            lines << "Created:       #{item['createdAt']}" if item['createdAt']
+            lines << "Updated:       #{item['updatedAt']}" if item['updatedAt']
+
+            if item['entity']
+              entity_name = item['entity']['name']
+              entity_type = item['entity']['type']
+              lines << "Entity:        #{entity_name}" if entity_name
+              lines << "Entity Type:   #{entity_type}" if entity_type && !entity_name
+            end
+          end
+
+          lines.join("\n")
+        end
+        private_class_method :format_collection_as_pretty
+
         def self.format_collection_as_text(items)
           lines = ["Items (#{items.length} total):"]
           items.each_with_index do |item, idx|

data/lib/exa/cli/formatters/webset_search_formatter.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Exa
+  module CLI
+    module Formatters
+      class WebsetSearchFormatter
+        def self.format(search, format)
+          case format
+          when "json"
+            JSON.pretty_generate(search.to_h)
+          when "pretty"
+            format_pretty(search)
+          when "text"
+            format_text(search)
+          when "toon"
+            Exa::CLI::Base.encode_as_toon(search.to_h)
+          else
+            JSON.pretty_generate(search.to_h)
+          end
+        end
+
+        private
+
+        def self.format_pretty(search)
+          output = []
+          output << "Search ID:       #{search.id}"
+          output << "Status:          #{search.status}"
+          output << "Query:           #{search.query}"
+          output << "Entity Type:     #{search.entity&.[]('type') || 'N/A'}" if search.entity
+          output << "Count:           #{search.count}" if search.count
+          output << "Behavior:        #{search.behavior}"
+          output << "Recall:          #{search.recall}" if search.recall
+          output << "Created:         #{search.created_at}"
+          output << "Updated:         #{search.updated_at}"
+          output << "Progress:        #{search.progress}" if search.progress
+          output << ""
+
+          if search.canceled?
+            output << "Canceled:        #{search.canceled_at}"
+            output << "Cancel Reason:   #{search.canceled_reason}" if search.canceled_reason
+          end
+
+          output.join("\n")
+        end
+
+        def self.format_text(search)
+          [
+            "ID: #{search.id}",
+            "Status: #{search.status}",
+            "Query: #{search.query}",
+            "Behavior: #{search.behavior}"
+          ].join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/exa/services/websets/create_validator.rb

@@ -20,6 +20,7 @@ module Exa
             validate_exclude!(params[:exclude]) if params[:exclude]
             validate_external_id!(params[:externalId]) if params[:externalId]
             validate_metadata!(params[:metadata]) if params[:metadata]
+            validate_no_duplicate_ids_in_import_and_scope!(params)
           end
 
           private
@@ -184,6 +185,20 @@ module Exa
             raise ArgumentError, "#{name} must be at least #{min} characters" if min && value.length < min
             raise ArgumentError, "#{name} cannot exceed #{max} characters" if max && value.length > max
           end
+
+          def validate_no_duplicate_ids_in_import_and_scope!(params)
+            return unless params[:import] && params[:search] && params[:search][:scope]
+
+            import_ids = params[:import].map { |item| item[:id] }
+            scope_ids = params[:search][:scope].map { |item| item[:id] }
+
+            duplicates = import_ids & scope_ids
+
+            return if duplicates.empty?
+
+            raise ArgumentError,
+                  "Cannot use the same import/webset ID in both :import and search[:scope]: #{duplicates.join(', ')}"
+          end
         end
       end
     end

data/lib/exa/version.rb

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

data/lib/exa.rb

@@ -67,6 +67,7 @@ require_relative "exa/cli/base"
 require_relative "exa/cli/polling"
 require_relative "exa/cli/error_handler"
 require_relative "exa/cli/formatters/search_formatter"
+require_relative "exa/cli/formatters/webset_search_formatter"
 require_relative "exa/cli/formatters/context_formatter"
 require_relative "exa/cli/formatters/contents_formatter"
 require_relative "exa/cli/formatters/research_formatter"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: exa-ai
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Benjamin Jackson
@@ -206,6 +206,7 @@ files:
 - lib/exa/cli/formatters/search_formatter.rb
 - lib/exa/cli/formatters/webset_formatter.rb
 - lib/exa/cli/formatters/webset_item_formatter.rb
+- lib/exa/cli/formatters/webset_search_formatter.rb
 - lib/exa/cli/polling.rb
 - lib/exa/client.rb
 - lib/exa/connection.rb