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
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: exa-ai
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.12.2
4
+ version: 0.14.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Benjamin Jackson
@@ -152,96 +152,59 @@ files:
152
152
  - exe/exa-ai-agent-run-events
153
153
  - exe/exa-ai-agent-run-get
154
154
  - exe/exa-ai-agent-run-list
155
+ - exe/exa-ai-agent-run-stop
155
156
  - exe/exa-ai-answer
156
157
  - exe/exa-ai-context
157
- - exe/exa-ai-enrichment-cancel
158
- - exe/exa-ai-enrichment-create
159
- - exe/exa-ai-enrichment-delete
160
- - exe/exa-ai-enrichment-get
161
- - exe/exa-ai-enrichment-list
162
- - exe/exa-ai-enrichment-update
163
158
  - exe/exa-ai-find-similar
164
159
  - exe/exa-ai-get-contents
165
- - exe/exa-ai-import-create
166
- - exe/exa-ai-import-delete
167
- - exe/exa-ai-import-get
168
- - exe/exa-ai-import-list
169
- - exe/exa-ai-import-update
170
- - exe/exa-ai-monitor-create
171
- - exe/exa-ai-monitor-delete
172
- - exe/exa-ai-monitor-get
173
- - exe/exa-ai-monitor-list
174
- - exe/exa-ai-monitor-runs-get
175
- - exe/exa-ai-monitor-runs-list
176
- - exe/exa-ai-monitor-update
177
- - exe/exa-ai-research-get
178
- - exe/exa-ai-research-list
179
- - exe/exa-ai-research-start
180
160
  - exe/exa-ai-search
181
- - exe/exa-ai-webset-cancel
182
- - exe/exa-ai-webset-create
183
- - exe/exa-ai-webset-delete
184
- - exe/exa-ai-webset-get
185
- - exe/exa-ai-webset-item-delete
186
- - exe/exa-ai-webset-item-get
187
- - exe/exa-ai-webset-item-list
188
- - exe/exa-ai-webset-list
189
- - exe/exa-ai-webset-search-cancel
190
- - exe/exa-ai-webset-search-create
191
- - exe/exa-ai-webset-search-get
192
- - exe/exa-ai-webset-update
161
+ - exe/exa-ai-search-monitor-batch
162
+ - exe/exa-ai-search-monitor-create
163
+ - exe/exa-ai-search-monitor-delete
164
+ - exe/exa-ai-search-monitor-get
165
+ - exe/exa-ai-search-monitor-list
166
+ - exe/exa-ai-search-monitor-runs-get
167
+ - exe/exa-ai-search-monitor-runs-list
168
+ - exe/exa-ai-search-monitor-trigger
169
+ - exe/exa-ai-search-monitor-update
193
170
  - lib/exa-ai.rb
194
171
  - lib/exa.rb
195
172
  - lib/exa/cli/base.rb
173
+ - lib/exa/cli/contents_flags.rb
196
174
  - lib/exa/cli/error_handler.rb
197
175
  - lib/exa/cli/formatters/agent_run_formatter.rb
198
176
  - lib/exa/cli/formatters/answer_formatter.rb
199
177
  - lib/exa/cli/formatters/contents_formatter.rb
200
178
  - lib/exa/cli/formatters/context_formatter.rb
201
- - lib/exa/cli/formatters/enrichment_formatter.rb
202
- - lib/exa/cli/formatters/import_formatter.rb
203
- - lib/exa/cli/formatters/monitor_formatter.rb
204
- - lib/exa/cli/formatters/monitor_run_formatter.rb
205
- - lib/exa/cli/formatters/research_formatter.rb
206
179
  - lib/exa/cli/formatters/search_formatter.rb
207
- - lib/exa/cli/formatters/webset_formatter.rb
208
- - lib/exa/cli/formatters/webset_item_formatter.rb
209
- - lib/exa/cli/formatters/webset_search_formatter.rb
180
+ - lib/exa/cli/formatters/search_monitor_formatter.rb
210
181
  - lib/exa/cli/polling.rb
211
182
  - lib/exa/cli/search_parser.rb
212
183
  - lib/exa/client.rb
213
184
  - lib/exa/connection.rb
214
- - lib/exa/constants/websets.rb
215
185
  - lib/exa/error.rb
216
186
  - lib/exa/middleware/raise_error.rb
217
187
  - lib/exa/resources/agent_run.rb
188
+ - lib/exa/resources/agent_run_deletion.rb
218
189
  - lib/exa/resources/agent_run_event_list.rb
219
190
  - lib/exa/resources/agent_run_list.rb
220
191
  - lib/exa/resources/answer.rb
221
192
  - lib/exa/resources/contents_result.rb
222
193
  - lib/exa/resources/context_result.rb
223
194
  - lib/exa/resources/find_similar_result.rb
224
- - lib/exa/resources/import.rb
225
- - lib/exa/resources/import_collection.rb
226
- - lib/exa/resources/monitor.rb
227
- - lib/exa/resources/monitor_collection.rb
228
- - lib/exa/resources/monitor_run.rb
229
- - lib/exa/resources/monitor_run_collection.rb
230
- - lib/exa/resources/research_list.rb
231
- - lib/exa/resources/research_task.rb
195
+ - lib/exa/resources/search_monitor.rb
196
+ - lib/exa/resources/search_monitor_batch_result.rb
197
+ - lib/exa/resources/search_monitor_list.rb
198
+ - lib/exa/resources/search_monitor_run.rb
199
+ - lib/exa/resources/search_monitor_trigger_result.rb
232
200
  - lib/exa/resources/search_result.rb
233
- - lib/exa/resources/webset.rb
234
- - lib/exa/resources/webset_collection.rb
235
- - lib/exa/resources/webset_enrichment.rb
236
- - lib/exa/resources/webset_enrichment_collection.rb
237
- - lib/exa/resources/webset_item_collection.rb
238
- - lib/exa/resources/webset_search.rb
239
201
  - lib/exa/services/agent_run_cancel.rb
240
202
  - lib/exa/services/agent_run_create.rb
241
203
  - lib/exa/services/agent_run_delete.rb
242
204
  - lib/exa/services/agent_run_events.rb
243
205
  - lib/exa/services/agent_run_get.rb
244
206
  - lib/exa/services/agent_run_list.rb
207
+ - lib/exa/services/agent_run_stop.rb
245
208
  - lib/exa/services/agent_run_stream.rb
246
209
  - lib/exa/services/answer.rb
247
210
  - lib/exa/services/answer_stream.rb
@@ -249,43 +212,17 @@ files:
249
212
  - lib/exa/services/find_similar.rb
250
213
  - lib/exa/services/get_contents.rb
251
214
  - lib/exa/services/parameter_converter.rb
252
- - lib/exa/services/research_get.rb
253
- - lib/exa/services/research_list.rb
254
- - lib/exa/services/research_start.rb
255
215
  - lib/exa/services/search.rb
256
- - lib/exa/services/websets/cancel.rb
257
- - lib/exa/services/websets/cancel_enrichment.rb
258
- - lib/exa/services/websets/cancel_search.rb
259
- - lib/exa/services/websets/create.rb
260
- - lib/exa/services/websets/create_enrichment.rb
261
- - lib/exa/services/websets/create_search.rb
262
- - lib/exa/services/websets/create_search_validator.rb
263
- - lib/exa/services/websets/create_validator.rb
264
- - lib/exa/services/websets/delete.rb
265
- - lib/exa/services/websets/delete_enrichment.rb
266
- - lib/exa/services/websets/delete_item.rb
267
- - lib/exa/services/websets/get_item.rb
268
- - lib/exa/services/websets/get_search.rb
269
- - lib/exa/services/websets/import_create.rb
270
- - lib/exa/services/websets/import_delete.rb
271
- - lib/exa/services/websets/import_get.rb
272
- - lib/exa/services/websets/import_list.rb
273
- - lib/exa/services/websets/import_update.rb
274
- - lib/exa/services/websets/import_upload.rb
275
- - lib/exa/services/websets/list.rb
276
- - lib/exa/services/websets/list_items.rb
277
- - lib/exa/services/websets/monitors/create.rb
278
- - lib/exa/services/websets/monitors/delete.rb
279
- - lib/exa/services/websets/monitors/get.rb
280
- - lib/exa/services/websets/monitors/list.rb
281
- - lib/exa/services/websets/monitors/runs/get.rb
282
- - lib/exa/services/websets/monitors/runs/list.rb
283
- - lib/exa/services/websets/monitors/update.rb
284
- - lib/exa/services/websets/retrieve.rb
285
- - lib/exa/services/websets/retrieve_enrichment.rb
286
- - lib/exa/services/websets/update.rb
287
- - lib/exa/services/websets/update_enrichment.rb
288
- - lib/exa/services/websets_parameter_converter.rb
216
+ - lib/exa/services/search_monitors/batch.rb
217
+ - lib/exa/services/search_monitors/create.rb
218
+ - lib/exa/services/search_monitors/delete.rb
219
+ - lib/exa/services/search_monitors/get.rb
220
+ - lib/exa/services/search_monitors/list.rb
221
+ - lib/exa/services/search_monitors/runs_get.rb
222
+ - lib/exa/services/search_monitors/runs_list.rb
223
+ - lib/exa/services/search_monitors/trigger.rb
224
+ - lib/exa/services/search_monitors/update.rb
225
+ - lib/exa/services/search_stream.rb
289
226
  - lib/exa/version.rb
290
227
  homepage: https://github.com/benjaminjackson/exa-ruby
291
228
  licenses:
@@ -308,7 +245,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
308
245
  - !ruby/object:Gem::Version
309
246
  version: '0'
310
247
  requirements: []
311
- rubygems_version: 3.7.2
248
+ rubygems_version: 3.6.9
312
249
  specification_version: 4
313
250
  summary: Ruby client for the Exa.ai API
314
251
  test_files: []
@@ -1,108 +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
- enrichment_id = nil
9
- api_key = nil
10
- output_format = "json"
11
-
12
- args = ARGV.dup
13
- while args.any?
14
- arg = args.shift
15
- case arg
16
- when "--api-key"
17
- api_key = args.shift
18
- when "--output-format"
19
- output_format = args.shift
20
- when "--help", "-h"
21
- puts <<~HELP
22
- Usage: exa-ai enrichment-cancel <webset_id> <enrichment_id> [OPTIONS]
23
-
24
- Cancel a running enrichment
25
-
26
- Arguments:
27
- webset_id ID of the webset (required)
28
- enrichment_id ID of the enrichment to cancel (required)
29
-
30
- Options:
31
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
32
- --output-format FMT Output format: json, pretty, or text (default: json)
33
- --help, -h Show this help message
34
-
35
- Examples:
36
- exa-ai enrichment-cancel ws_123 enr_456
37
- exa-ai enrichment-cancel ws_123 enr_456 --output-format pretty
38
- HELP
39
- exit 0
40
- else
41
- # First positional argument is webset_id, second is enrichment_id
42
- if webset_id.nil?
43
- webset_id = arg
44
- elsif enrichment_id.nil?
45
- enrichment_id = arg
46
- else
47
- $stderr.puts "Unknown option: #{arg}"
48
- exit 1
49
- end
50
- end
51
- end
52
-
53
- # Validate
54
- if webset_id.nil?
55
- $stderr.puts "Error: webset_id argument is required"
56
- $stderr.puts "Usage: exa-ai enrichment-cancel <webset_id> <enrichment_id> [OPTIONS]"
57
- $stderr.puts "Try 'exa-ai enrichment-cancel --help' for more information"
58
- exit 1
59
- end
60
-
61
- if enrichment_id.nil?
62
- $stderr.puts "Error: enrichment_id argument is required"
63
- $stderr.puts "Usage: exa-ai enrichment-cancel <webset_id> <enrichment_id> [OPTIONS]"
64
- $stderr.puts "Try 'exa-ai enrichment-cancel --help' for more information"
65
- exit 1
66
- end
67
-
68
- begin
69
- # Resolve API key and format
70
- api_key = Exa::CLI::Base.resolve_api_key(api_key)
71
- output_format = Exa::CLI::Base.resolve_output_format(output_format)
72
-
73
- # Build client
74
- client = Exa::CLI::Base.build_client(api_key)
75
-
76
- # Cancel enrichment
77
- enrichment = client.cancel_enrichment(webset_id: webset_id, id: enrichment_id)
78
-
79
- # Format and output
80
- output = Exa::CLI::Formatters::EnrichmentFormatter.format(enrichment, output_format)
81
- puts output
82
- $stdout.flush
83
-
84
- rescue Exa::NotFound => e
85
- $stderr.puts "Enrichment not found: #{e.message}"
86
- exit 1
87
- rescue Exa::ConfigurationError => e
88
- $stderr.puts "Configuration error: #{e.message}"
89
- exit 1
90
- rescue Exa::Unauthorized => e
91
- $stderr.puts "Authentication error: #{e.message}"
92
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
93
- exit 1
94
- rescue Exa::ClientError => e
95
- $stderr.puts "Client error: #{e.message}"
96
- exit 1
97
- rescue Exa::ServerError => e
98
- $stderr.puts "Server error: #{e.message}"
99
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
100
- exit 1
101
- rescue Exa::Error => e
102
- $stderr.puts "Error: #{e.message}"
103
- exit 1
104
- rescue StandardError => e
105
- $stderr.puts "Unexpected error: #{e.message}"
106
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
107
- exit 1
108
- end
@@ -1,226 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # frozen_string_literal: true
3
-
4
- require "exa-ai"
5
-
6
- VALID_FORMATS = Exa::Constants::Websets::ENRICHMENT_FORMATS
7
-
8
- # Recursively convert hash keys from strings to symbols
9
- def deep_symbolize_keys(obj)
10
- case obj
11
- when Hash
12
- obj.each_with_object({}) do |(key, value), result|
13
- result[key.to_sym] = deep_symbolize_keys(value)
14
- end
15
- when Array
16
- obj.map { |item| deep_symbolize_keys(item) }
17
- else
18
- obj
19
- end
20
- end
21
-
22
- # Parse JSON string or load from file (supports @file.json syntax)
23
- def parse_json_or_file(value)
24
- json_data = if value.start_with?("@")
25
- file_path = value[1..]
26
- JSON.parse(File.read(file_path))
27
- else
28
- JSON.parse(value)
29
- end
30
- deep_symbolize_keys(json_data)
31
- rescue JSON::ParserError => e
32
- $stderr.puts "Error: Invalid JSON: #{e.message}"
33
- exit 1
34
- rescue Errno::ENOENT => e
35
- $stderr.puts "Error: File not found: #{e.message}"
36
- exit 1
37
- end
38
-
39
- # Parse command-line arguments
40
- def parse_args(argv)
41
- # Check for help first
42
- if argv.include?("--help") || argv.include?("-h")
43
- puts <<~HELP
44
- Usage: exa-ai enrichment-create <webset_id> --description TEXT --format TYPE [OPTIONS]
45
-
46
- Create a new enrichment for a webset
47
-
48
- Required:
49
- <webset_id> Webset ID
50
- --description TEXT What to extract
51
- --format TYPE One of: #{VALID_FORMATS.join(', ')}
52
-
53
- Options:
54
- --options JSON Array of {label: "..."} (required if format=options, supports @file.json)
55
- --metadata JSON Custom metadata (supports @file.json)
56
- --wait Wait for enrichment to complete
57
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
58
- --output-format FMT Output format: json, pretty, or text (default: json)
59
- --help, -h Show this help message
60
-
61
- Examples:
62
- exa-ai enrichment-create ws_123 --description "Company size" --format text
63
- exa-ai enrichment-create ws_123 --description "Industry" --format options --options options.json
64
- exa-ai enrichment-create ws_123 --description "Website URL" --format url --wait
65
- HELP
66
- exit 0
67
- end
68
-
69
- args = {
70
- output_format: "json",
71
- api_key: nil,
72
- wait: false
73
- }
74
-
75
- # First, check for positional argument (webset_id)
76
- if argv.empty? || argv[0].start_with?("--")
77
- return args
78
- end
79
-
80
- args[:webset_id] = argv[0]
81
- i = 1
82
-
83
- while i < argv.length
84
- arg = argv[i]
85
- case arg
86
- when "--description"
87
- args[:description] = argv[i + 1]
88
- i += 2
89
- when "--format"
90
- args[:format] = argv[i + 1]
91
- i += 2
92
- when "--options"
93
- args[:options] = parse_json_or_file(argv[i + 1])
94
- i += 2
95
- when "--metadata"
96
- args[:metadata] = parse_json_or_file(argv[i + 1])
97
- i += 2
98
- when "--wait"
99
- args[:wait] = true
100
- i += 1
101
- when "--api-key"
102
- args[:api_key] = argv[i + 1]
103
- i += 2
104
- when "--output-format"
105
- args[:output_format] = argv[i + 1]
106
- i += 2
107
- else
108
- $stderr.puts "Unknown option: #{arg}"
109
- exit 1
110
- end
111
- end
112
-
113
- args
114
- end
115
-
116
- # Main execution
117
- begin
118
- args = parse_args(ARGV)
119
-
120
- # Validate required parameters
121
- unless args[:webset_id]
122
- $stderr.puts "Error: <webset_id> is required"
123
- $stderr.puts "Run 'exa-ai enrichment-create --help' for usage information"
124
- exit 1
125
- end
126
-
127
- unless args[:description]
128
- $stderr.puts "Error: --description is required"
129
- $stderr.puts "Run 'exa-ai enrichment-create --help' for usage information"
130
- exit 1
131
- end
132
-
133
- unless args[:format]
134
- $stderr.puts "Error: --format is required"
135
- $stderr.puts "Run 'exa-ai enrichment-create --help' for usage information"
136
- exit 1
137
- end
138
-
139
- # Validate format
140
- unless VALID_FORMATS.include?(args[:format])
141
- $stderr.puts "Error: format must be one of: #{VALID_FORMATS.join(', ')}"
142
- exit 1
143
- end
144
-
145
- # Validate options requirement for 'options' format
146
- if args[:format] == "options" && !args[:options]
147
- $stderr.puts "Error: --options is required when format is 'options'"
148
- exit 1
149
- end
150
-
151
- # Resolve API key
152
- api_key = Exa::CLI::Base.resolve_api_key(args[:api_key])
153
-
154
- # Resolve output format
155
- output_format = Exa::CLI::Base.resolve_output_format(args[:output_format])
156
-
157
- # Build client
158
- client = Exa::CLI::Base.build_client(api_key)
159
-
160
- # Prepare enrichment parameters
161
- enrichment_params = {
162
- description: args[:description],
163
- format: args[:format]
164
- }
165
- enrichment_params[:options] = args[:options] if args[:options]
166
- enrichment_params[:metadata] = args[:metadata] if args[:metadata]
167
-
168
- # Create enrichment
169
- enrichment = client.create_enrichment(webset_id: args[:webset_id], **enrichment_params)
170
-
171
- # If --wait flag is set, poll until enrichment is complete
172
- if args[:wait]
173
- $stderr.print "Creating enrichment... "
174
-
175
- begin
176
- final_enrichment = Exa::CLI::Polling.poll(max_duration: 300, initial_delay: 2, max_delay: 10) do
177
- current = client.get_enrichment(webset_id: args[:webset_id], id: enrichment.id)
178
-
179
- case current.status
180
- when "pending"
181
- $stderr.print "⏳"
182
- when "running"
183
- $stderr.print "⚙️"
184
- end
185
-
186
- done = current.completed?
187
- { done: done, result: current, status: current.status }
188
- end
189
-
190
- $stderr.puts " COMPLETED"
191
- enrichment = final_enrichment
192
-
193
- rescue Exa::CLI::Polling::TimeoutError
194
- $stderr.puts "\nWarning: Enrichment did not complete within timeout"
195
- $stderr.puts "Enrichment ID: #{enrichment.id}"
196
- $stderr.puts "Check status with: exa-ai enrichment-get #{args[:webset_id]} #{enrichment.id}"
197
- end
198
- end
199
-
200
- # Format and output result
201
- output = Exa::CLI::Formatters::EnrichmentFormatter.format(enrichment, output_format)
202
- puts output
203
- $stdout.flush
204
-
205
- rescue Exa::ConfigurationError => e
206
- $stderr.puts "Configuration error: #{e.message}"
207
- exit 1
208
- rescue Exa::Unauthorized => e
209
- $stderr.puts "Authentication error: #{e.message}"
210
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
211
- exit 1
212
- rescue Exa::ClientError => e
213
- $stderr.puts "Client error: #{e.message}"
214
- exit 1
215
- rescue Exa::ServerError => e
216
- $stderr.puts "Server error: #{e.message}"
217
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
218
- exit 1
219
- rescue Exa::Error => e
220
- $stderr.puts "Error: #{e.message}"
221
- exit 1
222
- rescue StandardError => e
223
- $stderr.puts "Unexpected error: #{e.message}"
224
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
225
- exit 1
226
- end
@@ -1,122 +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
- enrichment_id = nil
9
- force = false
10
- api_key = nil
11
- output_format = "json"
12
-
13
- args = ARGV.dup
14
- while args.any?
15
- arg = args.shift
16
- case arg
17
- when "--force"
18
- force = true
19
- when "--api-key"
20
- api_key = args.shift
21
- when "--output-format"
22
- output_format = args.shift
23
- when "--help", "-h"
24
- puts <<~HELP
25
- Usage: exa-ai enrichment-delete <webset_id> <enrichment_id> [OPTIONS]
26
-
27
- Delete an enrichment
28
-
29
- Arguments:
30
- webset_id ID of the webset (required)
31
- enrichment_id ID of the enrichment to delete (required)
32
-
33
- Options:
34
- --force Skip confirmation prompt
35
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
36
- --output-format FMT Output format: json, pretty, or text (default: json)
37
- --help, -h Show this help message
38
-
39
- Examples:
40
- exa-ai enrichment-delete ws_123 enr_456
41
- exa-ai enrichment-delete ws_123 enr_456 --force
42
- HELP
43
- exit 0
44
- else
45
- # First positional argument is webset_id, second is enrichment_id
46
- if webset_id.nil?
47
- webset_id = arg
48
- elsif enrichment_id.nil?
49
- enrichment_id = arg
50
- else
51
- $stderr.puts "Unknown option: #{arg}"
52
- exit 1
53
- end
54
- end
55
- end
56
-
57
- # Validate
58
- if webset_id.nil?
59
- $stderr.puts "Error: webset_id argument is required"
60
- $stderr.puts "Usage: exa-ai enrichment-delete <webset_id> <enrichment_id> [OPTIONS]"
61
- $stderr.puts "Try 'exa-ai enrichment-delete --help' for more information"
62
- exit 1
63
- end
64
-
65
- if enrichment_id.nil?
66
- $stderr.puts "Error: enrichment_id argument is required"
67
- $stderr.puts "Usage: exa-ai enrichment-delete <webset_id> <enrichment_id> [OPTIONS]"
68
- $stderr.puts "Try 'exa-ai enrichment-delete --help' for more information"
69
- exit 1
70
- end
71
-
72
- begin
73
- # Resolve API key and format
74
- api_key = Exa::CLI::Base.resolve_api_key(api_key)
75
- output_format = Exa::CLI::Base.resolve_output_format(output_format)
76
-
77
- # Confirm deletion unless --force is used
78
- unless force
79
- $stderr.print "Delete enrichment #{enrichment_id} from webset #{webset_id}? (y/N): "
80
- response = $stdin.gets.chomp.downcase
81
- unless response == "y" || response == "yes"
82
- $stderr.puts "Cancelled"
83
- exit 0
84
- end
85
- end
86
-
87
- # Build client
88
- client = Exa::CLI::Base.build_client(api_key)
89
-
90
- # Delete enrichment
91
- result = client.delete_enrichment(webset_id: webset_id, id: enrichment_id)
92
-
93
- # Format and output
94
- output = Exa::CLI::Formatters::EnrichmentFormatter.format(result, output_format)
95
- puts output
96
- $stdout.flush
97
-
98
- rescue Exa::NotFound => e
99
- $stderr.puts "Enrichment not found: #{e.message}"
100
- exit 1
101
- rescue Exa::ConfigurationError => e
102
- $stderr.puts "Configuration error: #{e.message}"
103
- exit 1
104
- rescue Exa::Unauthorized => e
105
- $stderr.puts "Authentication error: #{e.message}"
106
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
107
- exit 1
108
- rescue Exa::ClientError => e
109
- $stderr.puts "Client error: #{e.message}"
110
- exit 1
111
- rescue Exa::ServerError => e
112
- $stderr.puts "Server error: #{e.message}"
113
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
114
- exit 1
115
- rescue Exa::Error => e
116
- $stderr.puts "Error: #{e.message}"
117
- exit 1
118
- rescue StandardError => e
119
- $stderr.puts "Unexpected error: #{e.message}"
120
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
121
- exit 1
122
- end