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,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
- search_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 webset-search-cancel <webset_id> <search_id> [OPTIONS]
23
-
24
- Cancel a running webset search
25
-
26
- Arguments:
27
- webset_id ID of the webset (required)
28
- search_id ID of the search (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 webset-search-cancel ws_123 search_456
37
- exa-ai webset-search-cancel ws_123 search_456 --output-format text
38
- HELP
39
- exit 0
40
- else
41
- # First positional argument is webset_id, second is search_id
42
- if webset_id.nil?
43
- webset_id = arg
44
- elsif search_id.nil?
45
- search_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 webset-search-cancel <webset_id> <search_id> [OPTIONS]"
57
- $stderr.puts "Try 'exa-ai webset-search-cancel --help' for more information"
58
- exit 1
59
- end
60
-
61
- if search_id.nil?
62
- $stderr.puts "Error: search_id argument is required"
63
- $stderr.puts "Usage: exa-ai webset-search-cancel <webset_id> <search_id> [OPTIONS]"
64
- $stderr.puts "Try 'exa-ai webset-search-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 search
77
- search = client.cancel_webset_search(webset_id: webset_id, id: search_id)
78
-
79
- # Format and output
80
- output = Exa::CLI::Formatters::SearchFormatter.format(search, output_format)
81
- puts output
82
- $stdout.flush
83
-
84
- rescue Exa::NotFound => e
85
- $stderr.puts "Search 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,247 +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
- }
43
-
44
- # First positional argument is webset_id
45
- webset_id_found = false
46
-
47
- i = 0
48
- while i < argv.length
49
- arg = argv[i]
50
- case arg
51
- when "--query"
52
- args[:query] = argv[i + 1]
53
- i += 2
54
- when "--count"
55
- args[:count] = argv[i + 1].to_i
56
- i += 2
57
- when "--entity"
58
- args[:entity] = argv[i + 1]
59
- i += 2
60
- when "--entity-description"
61
- args[:entity_description] = argv[i + 1]
62
- i += 2
63
- when "--criteria"
64
- args[:criteria] = parse_json_or_file(argv[i + 1])
65
- i += 2
66
- when "--exclude"
67
- args[:exclude] = parse_json_or_file(argv[i + 1])
68
- i += 2
69
- when "--scope"
70
- args[:scope] = parse_json_or_file(argv[i + 1])
71
- i += 2
72
- when "--recall"
73
- args[:recall] = true
74
- i += 1
75
- when "--behavior"
76
- behavior = argv[i + 1]
77
- unless ["override", "append"].include?(behavior)
78
- $stderr.puts "Error: Behavior must be 'override' or 'append'"
79
- exit 1
80
- end
81
- args[:behavior] = behavior
82
- i += 2
83
- when "--metadata"
84
- args[:metadata] = parse_json_or_file(argv[i + 1])
85
- i += 2
86
- when "--api-key"
87
- args[:api_key] = argv[i + 1]
88
- i += 2
89
- when "--output-format"
90
- args[:output_format] = argv[i + 1]
91
- i += 2
92
- when "--help", "-h"
93
- puts <<~HELP
94
- Usage: exa-ai webset-search-create <webset_id> [OPTIONS]
95
-
96
- Create a new search within a webset
97
-
98
- Arguments:
99
- webset_id ID of the webset (required)
100
-
101
- Options:
102
- --query QUERY Search query (required)
103
- --count N Number of results to find
104
- --entity TYPE Entity type: person, company, article, research_paper, custom
105
- --entity-description TXT Description for custom entity type (required with --entity custom)
106
- --criteria JSON Search criteria array (supports @file.json)
107
- Format: [{"description":"criterion 1"},{"description":"criterion 2"}]
108
- --exclude JSON Items to exclude from results (supports @file.json)
109
- Format: [{"source":"import|webset","id":"..."}]
110
- --scope JSON Limit search to specific sources (supports @file.json)
111
- Format: [{"source":"import|webset","id":"..."}]
112
- Filters this search to only items from these sources
113
- With relationship (hop search):
114
- [{"source":"webset","id":"ws_123",
115
- "relationship":{"definition":"investors of","limit":3}}]
116
- --recall Estimate total available results
117
- --behavior TYPE "override" (replace items) or "append" (add items)
118
- Default: override when scope is present, append otherwise
119
- --metadata JSON Custom metadata (supports @file.json)
120
- Format: {"key":"value"}
121
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
122
- --output-format FMT Output format: json, pretty, or text (default: json)
123
- --help, -h Show this help message
124
-
125
- Examples:
126
- # Basic search
127
- exa-ai webset-search-create ws_123 --query "AI startups"
128
-
129
- # Search with entity type
130
- exa-ai webset-search-create ws_123 --query "tech CEOs" --entity person
131
- exa-ai webset-search-create ws_123 --query "Silicon Valley firms" --entity company
132
-
133
- # Scoped search (filter to specific import)
134
- exa-ai webset-search-create ws_123 --query "CTOs" \\
135
- --scope '[{"source":"import","id":"import_abc"}]'
136
-
137
- # Hop search (find investors of companies in webset)
138
- exa-ai webset-search-create ws_123 --query "investors" \\
139
- --scope '[{"source":"webset","id":"ws_companies","relationship":{"definition":"investors of","limit":5}}]'
140
-
141
- # Search with criteria and behavior
142
- exa-ai webset-search-create ws_123 --query "machine learning" --count 50
143
- exa-ai webset-search-create ws_123 --query "research" --behavior append --recall
144
- HELP
145
- exit 0
146
- else
147
- # First positional argument is webset_id
148
- unless webset_id_found
149
- args[:webset_id] = arg
150
- webset_id_found = true
151
- else
152
- $stderr.puts "Unknown option: #{arg}"
153
- exit 1
154
- end
155
- i += 1
156
- end
157
- end
158
-
159
- args
160
- end
161
-
162
- # Main execution
163
- begin
164
- args = parse_args(ARGV)
165
-
166
- # Validate required parameters
167
- unless args[:webset_id]
168
- $stderr.puts "Error: webset_id argument is required"
169
- $stderr.puts "Run 'exa-ai webset-search-create --help' for usage information"
170
- exit 1
171
- end
172
-
173
- unless args[:query]
174
- $stderr.puts "Error: --query is required"
175
- $stderr.puts "Run 'exa-ai webset-search-create --help' for usage information"
176
- exit 1
177
- end
178
-
179
- # Resolve API key
180
- api_key = Exa::CLI::Base.resolve_api_key(args[:api_key])
181
-
182
- # Resolve output format
183
- output_format = Exa::CLI::Base.resolve_output_format(args[:output_format])
184
-
185
- # Build client
186
- client = Exa::CLI::Base.build_client(api_key)
187
-
188
- # Build entity parameter from --entity and --entity-description
189
- entity = nil
190
- if args[:entity]
191
- # Build entity hash from string type
192
- entity = { type: args[:entity] }
193
- if args[:entity] == "custom"
194
- unless args[:entity_description]
195
- $stderr.puts "Error: --entity-description is required when --entity is 'custom'"
196
- exit 1
197
- end
198
- entity[:description] = args[:entity_description]
199
- elsif args[:entity_description]
200
- $stderr.puts "Warning: --entity-description is only used with --entity custom (ignoring)"
201
- end
202
- end
203
-
204
- # Prepare search parameters
205
- search_params = { query: args[:query] }
206
- search_params[:count] = args[:count] if args[:count]
207
- search_params[:entity] = entity if entity
208
- search_params[:criteria] = args[:criteria] if args[:criteria]
209
- search_params[:exclude] = args[:exclude] if args[:exclude]
210
- search_params[:scope] = args[:scope] if args[:scope]
211
- search_params[:recall] = args[:recall] if args[:recall]
212
- search_params[:behavior] = args[:behavior] if args[:behavior]
213
- search_params[:metadata] = args[:metadata] if args[:metadata]
214
-
215
- # Create search
216
- search = client.create_webset_search(webset_id: args[:webset_id], **search_params)
217
-
218
- # Format and output result
219
- output = Exa::CLI::Formatters::WebsetSearchFormatter.format(search, output_format)
220
- puts output
221
- $stdout.flush
222
-
223
- rescue Exa::ConfigurationError => e
224
- $stderr.puts "Configuration error: #{e.message}"
225
- exit 1
226
- rescue Exa::Unauthorized => e
227
- $stderr.puts "Authentication error: #{e.message}"
228
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
229
- exit 1
230
- rescue Exa::NotFound => e
231
- $stderr.puts "Webset not found: #{e.message}"
232
- exit 1
233
- rescue Exa::ClientError => e
234
- $stderr.puts "Client error: #{e.message}"
235
- exit 1
236
- rescue Exa::ServerError => e
237
- $stderr.puts "Server error: #{e.message}"
238
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
239
- exit 1
240
- rescue Exa::Error => e
241
- $stderr.puts "Error: #{e.message}"
242
- exit 1
243
- rescue StandardError => e
244
- $stderr.puts "Unexpected error: #{e.message}"
245
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
246
- exit 1
247
- end
@@ -1,105 +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
- search_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 webset-search-get <webset_id> <search_id> [OPTIONS]
23
-
24
- Get details of a webset search
25
-
26
- Arguments:
27
- webset_id ID of the webset (required)
28
- search_id ID of the search (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 webset-search-get ws_123 search_456
37
- exa-ai webset-search-get ws_123 search_456 --output-format pretty
38
- exa-ai webset-search-get ws_123 search_456 --output-format text
39
- HELP
40
- exit 0
41
- else
42
- # First positional argument is webset_id, second is search_id
43
- if webset_id.nil?
44
- webset_id = arg
45
- elsif search_id.nil?
46
- search_id = arg
47
- else
48
- $stderr.puts "Unknown option: #{arg}"
49
- exit 1
50
- end
51
- end
52
- end
53
-
54
- # Validate
55
- if webset_id.nil?
56
- $stderr.puts "Error: webset_id argument is required"
57
- $stderr.puts "Usage: exa-ai webset-search-get <webset_id> <search_id> [OPTIONS]"
58
- $stderr.puts "Try 'exa-ai webset-search-get --help' for more information"
59
- exit 1
60
- end
61
-
62
- if search_id.nil?
63
- $stderr.puts "Error: search_id argument is required"
64
- $stderr.puts "Usage: exa-ai webset-search-get <webset_id> <search_id> [OPTIONS]"
65
- $stderr.puts "Try 'exa-ai webset-search-get --help' for more information"
66
- exit 1
67
- end
68
-
69
- begin
70
- # Resolve API key and format
71
- api_key = Exa::CLI::Base.resolve_api_key(api_key)
72
- output_format = Exa::CLI::Base.resolve_output_format(output_format)
73
-
74
- # Build client
75
- client = Exa::CLI::Base.build_client(api_key)
76
-
77
- # Get search
78
- search = client.get_webset_search(webset_id: webset_id, id: search_id)
79
-
80
- # Format and output
81
- output = Exa::CLI::Formatters::WebsetSearchFormatter.format(search, output_format)
82
- puts output
83
- $stdout.flush
84
-
85
- rescue Exa::NotFound => e
86
- $stderr.puts "Search not found: #{e.message}"
87
- exit 1
88
- rescue Exa::Unauthorized => e
89
- $stderr.puts "Authentication error: #{e.message}"
90
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
91
- exit 1
92
- rescue Exa::ClientError => e
93
- $stderr.puts "Client error: #{e.message}"
94
- exit 1
95
- rescue Exa::ServerError => e
96
- $stderr.puts "Server error: #{e.message}"
97
- exit 1
98
- rescue Exa::Error => e
99
- $stderr.puts "Error: #{e.message}"
100
- exit 1
101
- rescue StandardError => e
102
- $stderr.puts "Unexpected error: #{e.message}"
103
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
104
- exit 1
105
- end
@@ -1,143 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # frozen_string_literal: true
3
-
4
- require "exa-ai"
5
- require "json"
6
-
7
- # Parse arguments
8
- webset_id = nil
9
- title = nil
10
- metadata = nil
11
- api_key = nil
12
- output_format = "json"
13
-
14
- # Recursively convert hash keys from strings to symbols
15
- def deep_symbolize_keys(obj)
16
- case obj
17
- when Hash
18
- obj.each_with_object({}) do |(key, value), result|
19
- result[key.to_sym] = deep_symbolize_keys(value)
20
- end
21
- when Array
22
- obj.map { |item| deep_symbolize_keys(item) }
23
- else
24
- obj
25
- end
26
- end
27
-
28
- # Helper to parse JSON string or load from file
29
- def parse_json_or_file(value)
30
- json_data = if value.start_with?("@")
31
- file_path = value[1..]
32
- JSON.parse(File.read(file_path))
33
- else
34
- JSON.parse(value)
35
- end
36
- deep_symbolize_keys(json_data)
37
- rescue JSON::ParserError => e
38
- $stderr.puts "Error: Invalid JSON: #{e.message}"
39
- exit 1
40
- rescue Errno::ENOENT => e
41
- $stderr.puts "Error: File not found: #{e.message}"
42
- exit 1
43
- end
44
-
45
- args = ARGV.dup
46
- while args.any?
47
- arg = args.shift
48
- case arg
49
- when "--title"
50
- title = args.shift
51
- when "--metadata"
52
- metadata = parse_json_or_file(args.shift)
53
- when "--api-key"
54
- api_key = args.shift
55
- when "--output-format"
56
- output_format = args.shift
57
- when "--help", "-h"
58
- puts <<~HELP
59
- Usage: exa-ai webset-update <webset_id> [OPTIONS]
60
-
61
- Update a webset's title and/or metadata
62
-
63
- Arguments:
64
- webset_id ID of the webset to update (required)
65
-
66
- Options:
67
- --title TITLE Title for the webset
68
- --metadata JSON Custom metadata to update (supports @file.json)
69
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
70
- --output-format FMT Output format: json, pretty, or text (default: json)
71
- --help, -h Show this help message
72
-
73
- Examples:
74
- exa-ai webset-update ws_abc123 --metadata '{"project":"Q1-2025"}'
75
- exa-ai webset-update ws_abc123 --title "Q1 Research"
76
- exa-ai webset-update ws_abc123 --title "Q1 Research" --metadata '{"project":"Q1-2025"}'
77
- exa-ai webset-update ws_abc123 --metadata @metadata.json
78
- exa-ai webset-update ws_abc123 --metadata '{"tags":["important"]}' --output-format pretty
79
- HELP
80
- exit 0
81
- else
82
- # First positional argument is webset_id
83
- if webset_id.nil?
84
- webset_id = arg
85
- else
86
- $stderr.puts "Unknown option: #{arg}"
87
- exit 1
88
- end
89
- end
90
- end
91
-
92
- # Validate required arguments
93
- if webset_id.nil?
94
- $stderr.puts "Error: webset_id argument is required"
95
- $stderr.puts "Usage: exa-ai webset-update <webset_id> [OPTIONS]"
96
- $stderr.puts "Try 'exa-ai webset-update --help' for more information"
97
- exit 1
98
- end
99
-
100
- begin
101
- # Resolve API key and format
102
- api_key = Exa::CLI::Base.resolve_api_key(api_key)
103
- output_format = Exa::CLI::Base.resolve_output_format(output_format)
104
-
105
- # Build client
106
- client = Exa::CLI::Base.build_client(api_key)
107
-
108
- # Update webset
109
- update_params = {}
110
- update_params[:title] = title if title
111
- update_params[:metadata] = metadata if metadata
112
- webset = client.update_webset(webset_id, **update_params)
113
-
114
- # Format and output
115
- output = Exa::CLI::Formatters::WebsetFormatter.format(webset, output_format)
116
- puts output
117
- $stdout.flush
118
-
119
- rescue Exa::NotFound => e
120
- $stderr.puts "Webset not found: #{e.message}"
121
- exit 1
122
- rescue Exa::ConfigurationError => e
123
- $stderr.puts "Configuration error: #{e.message}"
124
- exit 1
125
- rescue Exa::Unauthorized => e
126
- $stderr.puts "Authentication error: #{e.message}"
127
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
128
- exit 1
129
- rescue Exa::ClientError => e
130
- $stderr.puts "Client error: #{e.message}"
131
- exit 1
132
- rescue Exa::ServerError => e
133
- $stderr.puts "Server error: #{e.message}"
134
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
135
- exit 1
136
- rescue Exa::Error => e
137
- $stderr.puts "Error: #{e.message}"
138
- exit 1
139
- rescue StandardError => e
140
- $stderr.puts "Unexpected error: #{e.message}"
141
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
142
- exit 1
143
- end