exa-ai 0.13.0 → 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 (151) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +119 -73
  3. data/exe/exa-ai +41 -136
  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-agent-run-stop +93 -0
  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 +186 -310
  30. data/lib/exa/resources/agent_run.rb +5 -3
  31. data/lib/exa/resources/agent_run_deletion.rb +17 -0
  32. data/lib/exa/resources/answer.rb +3 -3
  33. data/lib/exa/resources/contents_result.rb +5 -1
  34. data/lib/exa/resources/find_similar_result.rb +5 -1
  35. data/lib/exa/resources/search_monitor.rb +42 -0
  36. data/lib/exa/resources/search_monitor_batch_result.rb +11 -0
  37. data/lib/exa/resources/search_monitor_list.rb +19 -0
  38. data/lib/exa/resources/search_monitor_run.rb +46 -0
  39. data/lib/exa/resources/search_monitor_trigger_result.rb +11 -0
  40. data/lib/exa/resources/search_result.rb +11 -1
  41. data/lib/exa/services/agent_run_cancel.rb +1 -12
  42. data/lib/exa/services/agent_run_create.rb +1 -12
  43. data/lib/exa/services/agent_run_delete.rb +6 -14
  44. data/lib/exa/services/agent_run_events.rb +33 -4
  45. data/lib/exa/services/agent_run_get.rb +1 -12
  46. data/lib/exa/services/agent_run_list.rb +1 -12
  47. data/lib/exa/services/agent_run_stop.rb +21 -0
  48. data/lib/exa/services/agent_run_stream.rb +53 -51
  49. data/lib/exa/services/answer.rb +5 -2
  50. data/lib/exa/services/answer_stream.rb +54 -45
  51. data/lib/exa/services/context.rb +3 -1
  52. data/lib/exa/services/find_similar.rb +9 -2
  53. data/lib/exa/services/get_contents.rb +14 -15
  54. data/lib/exa/services/parameter_converter.rb +128 -111
  55. data/lib/exa/services/search.rb +58 -19
  56. data/lib/exa/services/search_monitors/batch.rb +36 -0
  57. data/lib/exa/services/search_monitors/create.rb +37 -0
  58. data/lib/exa/services/search_monitors/delete.rb +22 -0
  59. data/lib/exa/services/search_monitors/get.rb +22 -0
  60. data/lib/exa/services/search_monitors/list.rb +29 -0
  61. data/lib/exa/services/search_monitors/runs_get.rb +23 -0
  62. data/lib/exa/services/search_monitors/runs_list.rb +29 -0
  63. data/lib/exa/services/search_monitors/trigger.rb +22 -0
  64. data/lib/exa/services/search_monitors/update.rb +42 -0
  65. data/lib/exa/services/search_stream.rb +38 -0
  66. data/lib/exa/version.rb +1 -1
  67. data/lib/exa.rb +18 -50
  68. metadata +30 -84
  69. data/exe/exa-ai-enrichment-cancel +0 -108
  70. data/exe/exa-ai-enrichment-create +0 -226
  71. data/exe/exa-ai-enrichment-delete +0 -122
  72. data/exe/exa-ai-enrichment-get +0 -104
  73. data/exe/exa-ai-enrichment-list +0 -99
  74. data/exe/exa-ai-enrichment-update +0 -171
  75. data/exe/exa-ai-import-create +0 -253
  76. data/exe/exa-ai-import-delete +0 -92
  77. data/exe/exa-ai-import-get +0 -92
  78. data/exe/exa-ai-import-list +0 -72
  79. data/exe/exa-ai-import-update +0 -164
  80. data/exe/exa-ai-monitor-create +0 -223
  81. data/exe/exa-ai-monitor-delete +0 -101
  82. data/exe/exa-ai-monitor-get +0 -92
  83. data/exe/exa-ai-monitor-list +0 -90
  84. data/exe/exa-ai-monitor-runs-get +0 -103
  85. data/exe/exa-ai-monitor-runs-list +0 -110
  86. data/exe/exa-ai-monitor-update +0 -207
  87. data/exe/exa-ai-webset-cancel +0 -97
  88. data/exe/exa-ai-webset-create +0 -254
  89. data/exe/exa-ai-webset-delete +0 -111
  90. data/exe/exa-ai-webset-get +0 -93
  91. data/exe/exa-ai-webset-item-delete +0 -111
  92. data/exe/exa-ai-webset-item-get +0 -105
  93. data/exe/exa-ai-webset-item-list +0 -108
  94. data/exe/exa-ai-webset-list +0 -91
  95. data/exe/exa-ai-webset-search-cancel +0 -104
  96. data/exe/exa-ai-webset-search-create +0 -247
  97. data/exe/exa-ai-webset-search-get +0 -105
  98. data/exe/exa-ai-webset-update +0 -143
  99. data/lib/exa/cli/formatters/enrichment_formatter.rb +0 -125
  100. data/lib/exa/cli/formatters/import_formatter.rb +0 -153
  101. data/lib/exa/cli/formatters/monitor_formatter.rb +0 -144
  102. data/lib/exa/cli/formatters/monitor_run_formatter.rb +0 -126
  103. data/lib/exa/cli/formatters/webset_formatter.rb +0 -134
  104. data/lib/exa/cli/formatters/webset_item_formatter.rb +0 -131
  105. data/lib/exa/cli/formatters/webset_search_formatter.rb +0 -57
  106. data/lib/exa/constants/websets.rb +0 -19
  107. data/lib/exa/resources/import.rb +0 -86
  108. data/lib/exa/resources/import_collection.rb +0 -33
  109. data/lib/exa/resources/monitor.rb +0 -48
  110. data/lib/exa/resources/monitor_collection.rb +0 -30
  111. data/lib/exa/resources/monitor_run.rb +0 -52
  112. data/lib/exa/resources/monitor_run_collection.rb +0 -30
  113. data/lib/exa/resources/webset.rb +0 -74
  114. data/lib/exa/resources/webset_collection.rb +0 -33
  115. data/lib/exa/resources/webset_enrichment.rb +0 -71
  116. data/lib/exa/resources/webset_enrichment_collection.rb +0 -28
  117. data/lib/exa/resources/webset_item_collection.rb +0 -33
  118. data/lib/exa/resources/webset_search.rb +0 -112
  119. data/lib/exa/services/websets/cancel.rb +0 -36
  120. data/lib/exa/services/websets/cancel_enrichment.rb +0 -35
  121. data/lib/exa/services/websets/cancel_search.rb +0 -44
  122. data/lib/exa/services/websets/create.rb +0 -45
  123. data/lib/exa/services/websets/create_enrichment.rb +0 -35
  124. data/lib/exa/services/websets/create_search.rb +0 -48
  125. data/lib/exa/services/websets/create_search_validator.rb +0 -128
  126. data/lib/exa/services/websets/create_validator.rb +0 -213
  127. data/lib/exa/services/websets/delete.rb +0 -36
  128. data/lib/exa/services/websets/delete_enrichment.rb +0 -35
  129. data/lib/exa/services/websets/delete_item.rb +0 -20
  130. data/lib/exa/services/websets/get_item.rb +0 -20
  131. data/lib/exa/services/websets/get_search.rb +0 -43
  132. data/lib/exa/services/websets/import_create.rb +0 -40
  133. data/lib/exa/services/websets/import_delete.rb +0 -37
  134. data/lib/exa/services/websets/import_get.rb +0 -37
  135. data/lib/exa/services/websets/import_list.rb +0 -25
  136. data/lib/exa/services/websets/import_update.rb +0 -38
  137. data/lib/exa/services/websets/import_upload.rb +0 -59
  138. data/lib/exa/services/websets/list.rb +0 -25
  139. data/lib/exa/services/websets/list_items.rb +0 -26
  140. data/lib/exa/services/websets/monitors/create.rb +0 -42
  141. data/lib/exa/services/websets/monitors/delete.rb +0 -32
  142. data/lib/exa/services/websets/monitors/get.rb +0 -33
  143. data/lib/exa/services/websets/monitors/list.rb +0 -27
  144. data/lib/exa/services/websets/monitors/runs/get.rb +0 -37
  145. data/lib/exa/services/websets/monitors/runs/list.rb +0 -30
  146. data/lib/exa/services/websets/monitors/update.rb +0 -33
  147. data/lib/exa/services/websets/retrieve.rb +0 -47
  148. data/lib/exa/services/websets/retrieve_enrichment.rb +0 -35
  149. data/lib/exa/services/websets/update.rb +0 -37
  150. data/lib/exa/services/websets/update_enrichment.rb +0 -36
  151. data/lib/exa/services/websets_parameter_converter.rb +0 -45
@@ -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
@@ -1,104 +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-get <webset_id> <enrichment_id> [OPTIONS]
23
-
24
- Retrieve details for an enrichment
25
-
26
- Arguments:
27
- webset_id ID of the webset (required)
28
- enrichment_id ID of the enrichment to retrieve (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-get ws_123 enr_456
37
- exa-ai enrichment-get 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-get <webset_id> <enrichment_id> [OPTIONS]"
57
- $stderr.puts "Try 'exa-ai enrichment-get --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-get <webset_id> <enrichment_id> [OPTIONS]"
64
- $stderr.puts "Try 'exa-ai enrichment-get --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
- # Get enrichment
77
- enrichment = client.get_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::Unauthorized => e
88
- $stderr.puts "Authentication error: #{e.message}"
89
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
90
- exit 1
91
- rescue Exa::ClientError => e
92
- $stderr.puts "Client error: #{e.message}"
93
- exit 1
94
- rescue Exa::ServerError => e
95
- $stderr.puts "Server error: #{e.message}"
96
- exit 1
97
- rescue Exa::Error => e
98
- $stderr.puts "Error: #{e.message}"
99
- exit 1
100
- rescue StandardError => e
101
- $stderr.puts "Unexpected error: #{e.message}"
102
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
103
- exit 1
104
- end
@@ -1,99 +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 enrichment-list <webset_id> [OPTIONS]
22
-
23
- List all enrichments for a webset
24
-
25
- Arguments:
26
- webset_id ID of the webset (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 enrichment-list ws_123
35
- exa-ai enrichment-list ws_123 --output-format text
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 enrichment-list <webset_id> [OPTIONS]"
53
- $stderr.puts "Try 'exa-ai enrichment-list --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
- # Get webset to retrieve enrichments
66
- webset = client.get_webset(webset_id)
67
-
68
- # Extract enrichments array (or empty array if none)
69
- enrichments_data = webset.enrichments || []
70
-
71
- # Create collection
72
- collection = Exa::Resources::WebsetEnrichmentCollection.new(data: enrichments_data)
73
-
74
- # Format and output
75
- output = Exa::CLI::Formatters::EnrichmentFormatter.format_collection(collection, output_format)
76
- puts output
77
- $stdout.flush
78
-
79
- rescue Exa::NotFound => e
80
- $stderr.puts "Webset not found: #{e.message}"
81
- exit 1
82
- rescue Exa::Unauthorized => e
83
- $stderr.puts "Authentication error: #{e.message}"
84
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
85
- exit 1
86
- rescue Exa::ClientError => e
87
- $stderr.puts "Client error: #{e.message}"
88
- exit 1
89
- rescue Exa::ServerError => e
90
- $stderr.puts "Server error: #{e.message}"
91
- exit 1
92
- rescue Exa::Error => e
93
- $stderr.puts "Error: #{e.message}"
94
- exit 1
95
- rescue StandardError => e
96
- $stderr.puts "Unexpected error: #{e.message}"
97
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
98
- exit 1
99
- end