exa-ai 0.12.2 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (159) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +120 -83
  3. data/exe/exa-ai +45 -152
  4. data/exe/exa-ai-agent-run-create +55 -20
  5. data/exe/exa-ai-agent-run-delete +1 -8
  6. data/exe/exa-ai-agent-run-events +21 -1
  7. data/exe/exa-ai-agent-run-list +1 -1
  8. data/exe/{exa-ai-research-list → exa-ai-agent-run-stop} +31 -32
  9. data/exe/exa-ai-answer +25 -0
  10. data/exe/exa-ai-context +6 -2
  11. data/exe/exa-ai-find-similar +26 -68
  12. data/exe/exa-ai-get-contents +138 -42
  13. data/exe/exa-ai-search +27 -104
  14. data/exe/exa-ai-search-monitor-batch +93 -0
  15. data/exe/exa-ai-search-monitor-create +104 -0
  16. data/exe/exa-ai-search-monitor-delete +69 -0
  17. data/exe/exa-ai-search-monitor-get +69 -0
  18. data/exe/exa-ai-search-monitor-list +73 -0
  19. data/exe/exa-ai-search-monitor-runs-get +68 -0
  20. data/exe/exa-ai-search-monitor-runs-list +75 -0
  21. data/exe/exa-ai-search-monitor-trigger +69 -0
  22. data/exe/exa-ai-search-monitor-update +102 -0
  23. data/lib/exa/cli/base.rb +57 -0
  24. data/lib/exa/cli/contents_flags.rb +199 -0
  25. data/lib/exa/cli/formatters/agent_run_formatter.rb +79 -3
  26. data/lib/exa/cli/formatters/search_formatter.rb +18 -2
  27. data/lib/exa/cli/formatters/search_monitor_formatter.rb +98 -0
  28. data/lib/exa/cli/search_parser.rb +46 -87
  29. data/lib/exa/client.rb +183 -333
  30. data/lib/exa/middleware/raise_error.rb +14 -0
  31. data/lib/exa/resources/agent_run.rb +5 -3
  32. data/lib/exa/resources/agent_run_deletion.rb +17 -0
  33. data/lib/exa/resources/answer.rb +3 -3
  34. data/lib/exa/resources/contents_result.rb +5 -1
  35. data/lib/exa/resources/find_similar_result.rb +5 -1
  36. data/lib/exa/resources/search_monitor.rb +42 -0
  37. data/lib/exa/resources/search_monitor_batch_result.rb +11 -0
  38. data/lib/exa/resources/{research_list.rb → search_monitor_list.rb} +3 -2
  39. data/lib/exa/resources/search_monitor_run.rb +46 -0
  40. data/lib/exa/resources/search_monitor_trigger_result.rb +11 -0
  41. data/lib/exa/resources/search_result.rb +11 -1
  42. data/lib/exa/services/agent_run_cancel.rb +1 -12
  43. data/lib/exa/services/agent_run_create.rb +1 -12
  44. data/lib/exa/services/agent_run_delete.rb +6 -14
  45. data/lib/exa/services/agent_run_events.rb +33 -4
  46. data/lib/exa/services/agent_run_get.rb +1 -12
  47. data/lib/exa/services/agent_run_list.rb +1 -12
  48. data/lib/exa/services/agent_run_stop.rb +21 -0
  49. data/lib/exa/services/agent_run_stream.rb +56 -52
  50. data/lib/exa/services/answer.rb +5 -2
  51. data/lib/exa/services/answer_stream.rb +57 -46
  52. data/lib/exa/services/context.rb +3 -1
  53. data/lib/exa/services/find_similar.rb +9 -2
  54. data/lib/exa/services/get_contents.rb +14 -15
  55. data/lib/exa/services/parameter_converter.rb +128 -111
  56. data/lib/exa/services/search.rb +58 -19
  57. data/lib/exa/services/search_monitors/batch.rb +36 -0
  58. data/lib/exa/services/search_monitors/create.rb +37 -0
  59. data/lib/exa/services/search_monitors/delete.rb +22 -0
  60. data/lib/exa/services/search_monitors/get.rb +22 -0
  61. data/lib/exa/services/search_monitors/list.rb +29 -0
  62. data/lib/exa/services/search_monitors/runs_get.rb +23 -0
  63. data/lib/exa/services/search_monitors/runs_list.rb +29 -0
  64. data/lib/exa/services/search_monitors/trigger.rb +22 -0
  65. data/lib/exa/services/search_monitors/update.rb +42 -0
  66. data/lib/exa/services/search_stream.rb +38 -0
  67. data/lib/exa/version.rb +1 -1
  68. data/lib/exa.rb +18 -56
  69. metadata +31 -94
  70. data/exe/exa-ai-enrichment-cancel +0 -108
  71. data/exe/exa-ai-enrichment-create +0 -226
  72. data/exe/exa-ai-enrichment-delete +0 -122
  73. data/exe/exa-ai-enrichment-get +0 -104
  74. data/exe/exa-ai-enrichment-list +0 -99
  75. data/exe/exa-ai-enrichment-update +0 -171
  76. data/exe/exa-ai-import-create +0 -253
  77. data/exe/exa-ai-import-delete +0 -92
  78. data/exe/exa-ai-import-get +0 -92
  79. data/exe/exa-ai-import-list +0 -72
  80. data/exe/exa-ai-import-update +0 -164
  81. data/exe/exa-ai-monitor-create +0 -223
  82. data/exe/exa-ai-monitor-delete +0 -101
  83. data/exe/exa-ai-monitor-get +0 -92
  84. data/exe/exa-ai-monitor-list +0 -90
  85. data/exe/exa-ai-monitor-runs-get +0 -103
  86. data/exe/exa-ai-monitor-runs-list +0 -110
  87. data/exe/exa-ai-monitor-update +0 -207
  88. data/exe/exa-ai-research-get +0 -109
  89. data/exe/exa-ai-research-start +0 -174
  90. data/exe/exa-ai-webset-cancel +0 -97
  91. data/exe/exa-ai-webset-create +0 -254
  92. data/exe/exa-ai-webset-delete +0 -111
  93. data/exe/exa-ai-webset-get +0 -93
  94. data/exe/exa-ai-webset-item-delete +0 -111
  95. data/exe/exa-ai-webset-item-get +0 -105
  96. data/exe/exa-ai-webset-item-list +0 -108
  97. data/exe/exa-ai-webset-list +0 -91
  98. data/exe/exa-ai-webset-search-cancel +0 -104
  99. data/exe/exa-ai-webset-search-create +0 -247
  100. data/exe/exa-ai-webset-search-get +0 -105
  101. data/exe/exa-ai-webset-update +0 -143
  102. data/lib/exa/cli/formatters/enrichment_formatter.rb +0 -125
  103. data/lib/exa/cli/formatters/import_formatter.rb +0 -153
  104. data/lib/exa/cli/formatters/monitor_formatter.rb +0 -144
  105. data/lib/exa/cli/formatters/monitor_run_formatter.rb +0 -126
  106. data/lib/exa/cli/formatters/research_formatter.rb +0 -124
  107. data/lib/exa/cli/formatters/webset_formatter.rb +0 -134
  108. data/lib/exa/cli/formatters/webset_item_formatter.rb +0 -131
  109. data/lib/exa/cli/formatters/webset_search_formatter.rb +0 -57
  110. data/lib/exa/constants/websets.rb +0 -19
  111. data/lib/exa/resources/import.rb +0 -86
  112. data/lib/exa/resources/import_collection.rb +0 -33
  113. data/lib/exa/resources/monitor.rb +0 -48
  114. data/lib/exa/resources/monitor_collection.rb +0 -30
  115. data/lib/exa/resources/monitor_run.rb +0 -52
  116. data/lib/exa/resources/monitor_run_collection.rb +0 -30
  117. data/lib/exa/resources/research_task.rb +0 -39
  118. data/lib/exa/resources/webset.rb +0 -74
  119. data/lib/exa/resources/webset_collection.rb +0 -33
  120. data/lib/exa/resources/webset_enrichment.rb +0 -71
  121. data/lib/exa/resources/webset_enrichment_collection.rb +0 -28
  122. data/lib/exa/resources/webset_item_collection.rb +0 -33
  123. data/lib/exa/resources/webset_search.rb +0 -112
  124. data/lib/exa/services/research_get.rb +0 -30
  125. data/lib/exa/services/research_list.rb +0 -37
  126. data/lib/exa/services/research_start.rb +0 -26
  127. data/lib/exa/services/websets/cancel.rb +0 -36
  128. data/lib/exa/services/websets/cancel_enrichment.rb +0 -35
  129. data/lib/exa/services/websets/cancel_search.rb +0 -44
  130. data/lib/exa/services/websets/create.rb +0 -45
  131. data/lib/exa/services/websets/create_enrichment.rb +0 -35
  132. data/lib/exa/services/websets/create_search.rb +0 -48
  133. data/lib/exa/services/websets/create_search_validator.rb +0 -128
  134. data/lib/exa/services/websets/create_validator.rb +0 -213
  135. data/lib/exa/services/websets/delete.rb +0 -36
  136. data/lib/exa/services/websets/delete_enrichment.rb +0 -35
  137. data/lib/exa/services/websets/delete_item.rb +0 -20
  138. data/lib/exa/services/websets/get_item.rb +0 -20
  139. data/lib/exa/services/websets/get_search.rb +0 -43
  140. data/lib/exa/services/websets/import_create.rb +0 -40
  141. data/lib/exa/services/websets/import_delete.rb +0 -37
  142. data/lib/exa/services/websets/import_get.rb +0 -37
  143. data/lib/exa/services/websets/import_list.rb +0 -25
  144. data/lib/exa/services/websets/import_update.rb +0 -38
  145. data/lib/exa/services/websets/import_upload.rb +0 -58
  146. data/lib/exa/services/websets/list.rb +0 -25
  147. data/lib/exa/services/websets/list_items.rb +0 -26
  148. data/lib/exa/services/websets/monitors/create.rb +0 -42
  149. data/lib/exa/services/websets/monitors/delete.rb +0 -32
  150. data/lib/exa/services/websets/monitors/get.rb +0 -33
  151. data/lib/exa/services/websets/monitors/list.rb +0 -27
  152. data/lib/exa/services/websets/monitors/runs/get.rb +0 -37
  153. data/lib/exa/services/websets/monitors/runs/list.rb +0 -30
  154. data/lib/exa/services/websets/monitors/update.rb +0 -33
  155. data/lib/exa/services/websets/retrieve.rb +0 -47
  156. data/lib/exa/services/websets/retrieve_enrichment.rb +0 -35
  157. data/lib/exa/services/websets/update.rb +0 -37
  158. data/lib/exa/services/websets/update_enrichment.rb +0 -36
  159. data/lib/exa/services/websets_parameter_converter.rb +0 -45
@@ -1,109 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # frozen_string_literal: true
3
-
4
- require "exa-ai"
5
-
6
- # Parse command-line arguments
7
- api_key = nil
8
- research_id = nil
9
- events = false
10
- stream = false
11
- output_format = "json"
12
-
13
- args = ARGV.dup
14
- while args.any?
15
- arg = args.shift
16
- case arg
17
- when "--api-key"
18
- api_key = args.shift
19
- when "--events"
20
- events = true
21
- when "--stream"
22
- stream = true
23
- when "--output-format"
24
- output_format = args.shift
25
- when "--help", "-h"
26
- puts <<~HELP
27
- Usage: exa-ai research-get <research_id> [options]
28
-
29
- Get the status and results of a research task.
30
-
31
- Arguments:
32
- research_id ID of the research task to retrieve
33
-
34
- Options:
35
- --api-key KEY Exa API key (or use EXA_API_KEY env var)
36
- --events Include task execution events in response
37
- --stream Stream the response (for real-time updates)
38
- --output-format FORMAT Output format: json, pretty, or text (default: json)
39
- --help, -h Show this help message
40
-
41
- Examples:
42
- exa-ai research-get research_123
43
- exa-ai research-get research_123 --events
44
- exa-ai research-get research_123 --stream
45
- exa-ai research-get research_123 --output-format pretty
46
- HELP
47
- exit 0
48
- else
49
- # First positional argument is the research_id
50
- if research_id.nil?
51
- research_id = arg
52
- else
53
- warn "Unknown option: #{arg}"
54
- exit 1
55
- end
56
- end
57
- end
58
-
59
- # Validate required arguments
60
- if research_id.nil?
61
- warn "Error: Research ID argument required"
62
- warn "Usage: exa-ai research-get <research_id> [options]"
63
- warn "Try 'exa-ai research-get --help' for more information"
64
- exit 1
65
- end
66
-
67
- begin
68
- # Resolve API key
69
- api_key = Exa::CLI::Base.resolve_api_key(api_key)
70
-
71
- # Build client
72
- client = Exa::CLI::Base.build_client(api_key)
73
-
74
- # Build parameters
75
- params = {}
76
- params[:events] = events if events
77
- params[:stream] = stream if stream
78
-
79
- # Call API
80
- result = client.research_get(research_id, **params)
81
-
82
- # Format output
83
- formatted = Exa::CLI::Formatters::ResearchFormatter.format_task(
84
- result,
85
- output_format,
86
- show_events: events
87
- )
88
- puts formatted
89
-
90
- rescue Exa::NotFound => e
91
- warn "Research task not found: #{e.message}"
92
- exit 1
93
- rescue Exa::Unauthorized => e
94
- warn "Authentication failed: #{e.message}"
95
- warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
96
- exit 1
97
- rescue Exa::ClientError => e
98
- warn "Client error: #{e.message}"
99
- exit 1
100
- rescue Exa::ServerError => e
101
- warn "Server error: #{e.message}"
102
- exit 1
103
- rescue Exa::Error => e
104
- warn "Error: #{e.message}"
105
- exit 1
106
- rescue StandardError => e
107
- warn "Unexpected error: #{e.message}"
108
- exit 1
109
- end
@@ -1,174 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # frozen_string_literal: true
3
-
4
- require "exa-ai"
5
-
6
- # Parse command-line arguments
7
- def parse_args(argv)
8
- args = {
9
- output_format: "json",
10
- api_key: nil,
11
- events: false,
12
- wait: false
13
- }
14
-
15
- i = 0
16
- while i < argv.length
17
- arg = argv[i]
18
- case arg
19
- when "--instructions"
20
- args[:instructions] = argv[i + 1]
21
- i += 2
22
- when "--model"
23
- args[:model] = argv[i + 1]
24
- i += 2
25
- when "--output-schema"
26
- args[:output_schema] = argv[i + 1]
27
- i += 2
28
- when "--wait"
29
- args[:wait] = true
30
- i += 1
31
- when "--events"
32
- args[:events] = true
33
- i += 1
34
- when "--api-key"
35
- args[:api_key] = argv[i + 1]
36
- i += 2
37
- when "--output-format"
38
- args[:output_format] = argv[i + 1]
39
- i += 2
40
- when "--help", "-h"
41
- puts <<~HELP
42
- Usage: exa-ai research-start --instructions "TEXT" [OPTIONS]
43
-
44
- Start a research task using Exa AI
45
-
46
- Options:
47
- --instructions TEXT Research instructions (required)
48
- --model MODEL Research model: exa-research (default), exa-research-pro, exa-research-fast
49
- --output-schema JSON JSON schema string for structured output
50
- --wait Wait for task to complete (polls until done)
51
- --events Include event log in output (only with --wait)
52
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
53
- --output-format FMT Output format: json, pretty, or text (default: json)
54
- --help, -h Show this help message
55
-
56
- Examples:
57
- exa-ai research-start --instructions "Find Ruby performance tips"
58
- exa-ai research-start --instructions "Analyze AI trends" --wait --events
59
- exa-ai research-start --instructions "Summarize papers" --model exa-research-pro --wait
60
- exa-ai research-start --instructions "Find stats" --output-schema '{"type":"object"}'
61
- HELP
62
- exit 0
63
- else
64
- i += 1
65
- end
66
- end
67
-
68
- args
69
- end
70
-
71
- # Main execution
72
- begin
73
- args = parse_args(ARGV)
74
-
75
- # Validate instructions
76
- if args[:instructions].nil? || args[:instructions].empty?
77
- $stderr.puts "Error: --instructions flag is required"
78
- $stderr.puts "Run 'exa-ai research-start --help' for usage information"
79
- exit 1
80
- end
81
-
82
- # Resolve API key
83
- api_key = Exa::CLI::Base.resolve_api_key(args[:api_key])
84
-
85
- # Resolve output format
86
- output_format = Exa::CLI::Base.resolve_output_format(args[:output_format])
87
-
88
- # Build client
89
- client = Exa::CLI::Base.build_client(api_key)
90
-
91
- # Prepare research parameters
92
- research_params = { instructions: args[:instructions] }
93
- research_params[:model] = args[:model] if args[:model]
94
-
95
- # Parse output_schema as JSON if provided
96
- if args[:output_schema]
97
- begin
98
- research_params[:output_schema] = JSON.parse(args[:output_schema])
99
- rescue JSON::ParserError => e
100
- $stderr.puts "Error: Invalid JSON in --output-schema: #{e.message}"
101
- exit 1
102
- end
103
- end
104
-
105
- # Start research task
106
- task = client.research_start(**research_params)
107
-
108
- # If --wait flag is set, poll until task completes
109
- if args[:wait]
110
- $stderr.print "Starting research task... "
111
-
112
- begin
113
- final_task = Exa::CLI::Polling.poll(max_duration: 300, initial_delay: 2, max_delay: 10) do
114
- # Get current task status
115
- current_task = client.research_get(task.research_id, events: args[:events])
116
-
117
- # Show progress indicator
118
- case current_task.status
119
- when "pending"
120
- $stderr.print "⏳"
121
- when "running"
122
- $stderr.print "⚙️"
123
- end
124
-
125
- # Check if done
126
- done = current_task.finished?
127
-
128
- { done: done, result: current_task, status: current_task.status }
129
- end
130
-
131
- $stderr.puts " #{final_task.status.upcase}"
132
-
133
- # Format and output final result
134
- output = Exa::CLI::Formatters::ResearchFormatter.format_task(final_task, output_format, show_events: args[:events])
135
- puts output
136
- $stdout.flush
137
-
138
- # Exit with error code if task failed
139
- exit 1 if final_task.failed?
140
-
141
- rescue Exa::CLI::Polling::TimeoutError => e
142
- $stderr.puts "\nError: Task did not complete within timeout period (5 minutes)"
143
- $stderr.puts "Task ID: #{task.research_id}"
144
- $stderr.puts "You can check the status later with: exa-ai research-get #{task.research_id}"
145
- exit 1
146
- end
147
- else
148
- # Just return the initial task (with status "pending")
149
- output = Exa::CLI::Formatters::ResearchFormatter.format_task(task, output_format, show_events: false)
150
- puts output
151
- end
152
-
153
- rescue Exa::ConfigurationError => e
154
- $stderr.puts "Configuration error: #{e.message}"
155
- exit 1
156
- rescue Exa::Unauthorized => e
157
- $stderr.puts "Authentication error: #{e.message}"
158
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
159
- exit 1
160
- rescue Exa::ClientError => e
161
- $stderr.puts "Client error: #{e.message}"
162
- exit 1
163
- rescue Exa::ServerError => e
164
- $stderr.puts "Server error: #{e.message}"
165
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
166
- exit 1
167
- rescue Exa::Error => e
168
- $stderr.puts "Error: #{e.message}"
169
- exit 1
170
- rescue StandardError => e
171
- $stderr.puts "Unexpected error: #{e.message}"
172
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
173
- exit 1
174
- end
@@ -1,97 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # frozen_string_literal: true
3
-
4
- require "exa-ai"
5
-
6
- # Parse arguments
7
- webset_id = nil
8
- api_key = nil
9
- output_format = "json"
10
-
11
- args = ARGV.dup
12
- while args.any?
13
- arg = args.shift
14
- case arg
15
- when "--api-key"
16
- api_key = args.shift
17
- when "--output-format"
18
- output_format = args.shift
19
- when "--help", "-h"
20
- puts <<~HELP
21
- Usage: exa-ai webset-cancel <webset_id> [OPTIONS]
22
-
23
- Cancel a running webset
24
-
25
- Arguments:
26
- webset_id ID of the webset to cancel (required)
27
-
28
- Options:
29
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
30
- --output-format FMT Output format: json, pretty, or text (default: json)
31
- --help, -h Show this help message
32
-
33
- Examples:
34
- exa-ai webset-cancel ws_abc123
35
- exa-ai webset-cancel ws_abc123 --output-format pretty
36
- HELP
37
- exit 0
38
- else
39
- # First positional argument is webset_id
40
- if webset_id.nil?
41
- webset_id = arg
42
- else
43
- $stderr.puts "Unknown option: #{arg}"
44
- exit 1
45
- end
46
- end
47
- end
48
-
49
- # Validate
50
- if webset_id.nil?
51
- $stderr.puts "Error: webset_id argument is required"
52
- $stderr.puts "Usage: exa-ai webset-cancel <webset_id> [OPTIONS]"
53
- $stderr.puts "Try 'exa-ai webset-cancel --help' for more information"
54
- exit 1
55
- end
56
-
57
- begin
58
- # Resolve API key and format
59
- api_key = Exa::CLI::Base.resolve_api_key(api_key)
60
- output_format = Exa::CLI::Base.resolve_output_format(output_format)
61
-
62
- # Build client
63
- client = Exa::CLI::Base.build_client(api_key)
64
-
65
- # Cancel webset
66
- webset = client.cancel_webset(webset_id)
67
-
68
- # Format and output
69
- output = Exa::CLI::Formatters::WebsetFormatter.format(webset, output_format)
70
- puts output
71
- $stdout.flush
72
-
73
- rescue Exa::NotFound => e
74
- $stderr.puts "Webset not found: #{e.message}"
75
- exit 1
76
- rescue Exa::ConfigurationError => e
77
- $stderr.puts "Configuration error: #{e.message}"
78
- exit 1
79
- rescue Exa::Unauthorized => e
80
- $stderr.puts "Authentication error: #{e.message}"
81
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
82
- exit 1
83
- rescue Exa::ClientError => e
84
- $stderr.puts "Client error: #{e.message}"
85
- exit 1
86
- rescue Exa::ServerError => e
87
- $stderr.puts "Server error: #{e.message}"
88
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
89
- exit 1
90
- rescue Exa::Error => e
91
- $stderr.puts "Error: #{e.message}"
92
- exit 1
93
- rescue StandardError => e
94
- $stderr.puts "Unexpected error: #{e.message}"
95
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
96
- exit 1
97
- end
@@ -1,254 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # frozen_string_literal: true
3
-
4
- require "exa-ai"
5
-
6
- # Recursively convert hash keys from strings to symbols
7
- def deep_symbolize_keys(obj)
8
- case obj
9
- when Hash
10
- obj.each_with_object({}) do |(key, value), result|
11
- result[key.to_sym] = deep_symbolize_keys(value)
12
- end
13
- when Array
14
- obj.map { |item| deep_symbolize_keys(item) }
15
- else
16
- obj
17
- end
18
- end
19
-
20
- # Parse JSON string or load from file (supports @file.json syntax)
21
- def parse_json_or_file(value)
22
- json_data = if value.start_with?("@")
23
- file_path = value[1..]
24
- JSON.parse(File.read(file_path))
25
- else
26
- JSON.parse(value)
27
- end
28
- deep_symbolize_keys(json_data)
29
- rescue JSON::ParserError => e
30
- $stderr.puts "Error: Invalid JSON: #{e.message}"
31
- exit 1
32
- rescue Errno::ENOENT => e
33
- $stderr.puts "Error: File not found: #{e.message}"
34
- exit 1
35
- end
36
-
37
- # Parse command-line arguments
38
- def parse_args(argv)
39
- args = {
40
- output_format: "json",
41
- api_key: nil,
42
- wait: false
43
- }
44
-
45
- i = 0
46
- while i < argv.length
47
- arg = argv[i]
48
- case arg
49
- when "--import"
50
- args[:import] = argv[i + 1]
51
- i += 2
52
- when "--search"
53
- args[:search] = parse_json_or_file(argv[i + 1])
54
- i += 2
55
- when "--enrichments"
56
- args[:enrichments] = parse_json_or_file(argv[i + 1])
57
- i += 2
58
- when "--exclude"
59
- args[:exclude] = parse_json_or_file(argv[i + 1])
60
- i += 2
61
- when "--external-id"
62
- args[:external_id] = argv[i + 1]
63
- i += 2
64
- when "--title"
65
- args[:title] = argv[i + 1]
66
- i += 2
67
- when "--metadata"
68
- args[:metadata] = parse_json_or_file(argv[i + 1])
69
- i += 2
70
- when "--wait"
71
- args[:wait] = true
72
- i += 1
73
- when "--api-key"
74
- args[:api_key] = argv[i + 1]
75
- i += 2
76
- when "--output-format"
77
- args[:output_format] = argv[i + 1]
78
- i += 2
79
- when "--help", "-h"
80
- puts <<~HELP
81
- Usage: exa-ai webset-create (--search JSON | --import ID) [OPTIONS]
82
-
83
- Create a new webset from search criteria or an import
84
-
85
- Required (choose one):
86
- --search JSON Search configuration as JSON (supports @file.json)
87
- Format: {"query":"...","count":10,"scope":[...]}
88
- The 'scope' field limits search to specific sources
89
- --import ID Import/webset ID to attach data to this webset
90
- (loads data but does NOT filter searches)
91
- Format: import_abc123 or webset_xyz789
92
-
93
- Options:
94
- --enrichments JSON Array of enrichment configs (supports @file.json)
95
- Format: [{"description":"...","format":"text"}]
96
- --exclude JSON Sources to exclude from searches (supports @file.json)
97
- Format: [{"source":"import|webset","id":"..."}]
98
- --external-id ID External identifier for the webset
99
- --title TITLE Title for the webset
100
- --metadata JSON Custom metadata (supports @file.json)
101
- Format: {"key":"value"}
102
- --wait Wait for webset to reach idle status
103
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
104
- --output-format FMT Output format: json, pretty, or text (default: json)
105
- --help, -h Show this help message
106
-
107
- JSON Format Details:
108
- search.scope Array of source references to limit search
109
- Format: [{"source":"import|webset","id":"..."}]
110
- With relationship (hop search):
111
- [{"source":"webset","id":"ws_123",
112
- "relationship":{"definition":"investors of","limit":3}}]
113
-
114
- IMPORTANT: Cannot use the same import ID in both --import and search.scope
115
- (this will return a 400 error from the API)
116
-
117
- Examples:
118
- # Create webset from search
119
- exa-ai webset-create --search '{"query":"AI startups","count":10}'
120
- exa-ai webset-create --search @search.json --enrichments @enrichments.json
121
- exa-ai webset-create --search @search.json --wait
122
-
123
- # Create webset with scoped search (filter to specific import)
124
- exa-ai webset-create --search '{"query":"CEOs","count":10,"scope":[{"source":"import","id":"import_abc"}]}'
125
-
126
- # Create webset from import
127
- exa-ai webset-create --import import_abc123
128
- exa-ai webset-create --import import_def456 --enrichments @enrichments.json
129
-
130
- # Load import AND run search (search not scoped to import)
131
- exa-ai webset-create --import import_abc123 --search '{"query":"investors","count":20}'
132
- HELP
133
- exit 0
134
- else
135
- $stderr.puts "Unknown option: #{arg}"
136
- exit 1
137
- end
138
- end
139
-
140
- args
141
- end
142
-
143
- # Main execution
144
- begin
145
- args = parse_args(ARGV)
146
-
147
- # Validate required parameters
148
- if args[:search] && args[:import]
149
- $stderr.puts "Error: Cannot specify both --search and --import"
150
- $stderr.puts "Run 'exa-ai webset-create --help' for usage information"
151
- exit 1
152
- end
153
-
154
- unless args[:search] || args[:import]
155
- $stderr.puts "Error: Either --search or --import is required"
156
- $stderr.puts "Run 'exa-ai webset-create --help' for usage information"
157
- exit 1
158
- end
159
-
160
- # Resolve API key
161
- api_key = Exa::CLI::Base.resolve_api_key(args[:api_key])
162
-
163
- # Resolve output format
164
- output_format = Exa::CLI::Base.resolve_output_format(args[:output_format])
165
-
166
- # Build client
167
- client = Exa::CLI::Base.build_client(api_key)
168
-
169
- # Prepare webset parameters
170
- webset_params = {}
171
-
172
- if args[:search]
173
- webset_params[:search] = args[:search]
174
- elsif args[:import]
175
- # Detect source type from ID prefix and convert to API format
176
- import_id = args[:import]
177
- source = if import_id.start_with?("import_")
178
- "import"
179
- elsif import_id.start_with?("webset_")
180
- "webset"
181
- else
182
- $stderr.puts "Error: Import ID must start with 'import_' or 'webset_'"
183
- exit 1
184
- end
185
-
186
- webset_params[:import] = [{ source: source, id: import_id }]
187
- end
188
-
189
- webset_params[:enrichments] = args[:enrichments] if args[:enrichments]
190
- webset_params[:exclude] = args[:exclude] if args[:exclude]
191
- webset_params[:externalId] = args[:external_id] if args[:external_id]
192
- webset_params[:title] = args[:title] if args[:title]
193
- webset_params[:metadata] = args[:metadata] if args[:metadata]
194
-
195
- # Create webset
196
- webset = client.create_webset(**webset_params)
197
-
198
- # If --wait flag is set, poll until webset is idle
199
- if args[:wait]
200
- $stderr.print "Creating webset... "
201
-
202
- begin
203
- final_webset = Exa::CLI::Polling.poll(max_duration: 300, initial_delay: 2, max_delay: 10) do
204
- current_webset = client.get_webset(webset.id)
205
-
206
- # Show progress indicator
207
- case current_webset.status
208
- when "pending"
209
- $stderr.print "⏳"
210
- when "running"
211
- $stderr.print "⚙️"
212
- end
213
-
214
- done = current_webset.idle?
215
- { done: done, result: current_webset, status: current_webset.status }
216
- end
217
-
218
- $stderr.puts " #{final_webset.status.upcase}"
219
- webset = final_webset
220
-
221
- rescue Exa::CLI::Polling::TimeoutError
222
- $stderr.puts "\nWarning: Webset creation did not complete within timeout"
223
- $stderr.puts "Webset ID: #{webset.id}"
224
- $stderr.puts "Check status with: exa-ai webset-get #{webset.id}"
225
- end
226
- end
227
-
228
- # Format and output result
229
- output = Exa::CLI::Formatters::WebsetFormatter.format(webset, output_format)
230
- puts output
231
- $stdout.flush
232
-
233
- rescue Exa::ConfigurationError => e
234
- $stderr.puts "Configuration error: #{e.message}"
235
- exit 1
236
- rescue Exa::Unauthorized => e
237
- $stderr.puts "Authentication error: #{e.message}"
238
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
239
- exit 1
240
- rescue Exa::ClientError => e
241
- $stderr.puts "Client error: #{e.message}"
242
- exit 1
243
- rescue Exa::ServerError => e
244
- $stderr.puts "Server error: #{e.message}"
245
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
246
- exit 1
247
- rescue Exa::Error => e
248
- $stderr.puts "Error: #{e.message}"
249
- exit 1
250
- rescue StandardError => e
251
- $stderr.puts "Unexpected error: #{e.message}"
252
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
253
- exit 1
254
- end