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,111 +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
- force = false
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 "--force"
17
- force = true
18
- when "--api-key"
19
- api_key = args.shift
20
- when "--output-format"
21
- output_format = args.shift
22
- when "--help", "-h"
23
- puts <<~HELP
24
- Usage: exa-ai webset-delete <webset_id> [OPTIONS]
25
-
26
- Delete a webset
27
-
28
- Arguments:
29
- webset_id ID of the webset to delete (required)
30
-
31
- Options:
32
- --force Skip confirmation prompt
33
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
34
- --output-format FMT Output format: json, pretty, or text (default: json)
35
- --help, -h Show this help message
36
-
37
- Examples:
38
- exa-ai webset-delete ws_abc123
39
- exa-ai webset-delete ws_abc123 --force
40
- HELP
41
- exit 0
42
- else
43
- # First positional argument is webset_id
44
- if webset_id.nil?
45
- webset_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-delete <webset_id> [OPTIONS]"
57
- $stderr.puts "Try 'exa-ai webset-delete --help' for more information"
58
- exit 1
59
- end
60
-
61
- begin
62
- # Resolve API key and format
63
- api_key = Exa::CLI::Base.resolve_api_key(api_key)
64
- output_format = Exa::CLI::Base.resolve_output_format(output_format)
65
-
66
- # Confirm deletion unless --force is used
67
- unless force
68
- $stderr.print "Delete webset #{webset_id}? (y/N): "
69
- response = $stdin.gets.chomp.downcase
70
- unless response == "y" || response == "yes"
71
- $stderr.puts "Cancelled"
72
- exit 0
73
- end
74
- end
75
-
76
- # Build client
77
- client = Exa::CLI::Base.build_client(api_key)
78
-
79
- # Delete webset
80
- result = client.delete_webset(webset_id)
81
-
82
- # Format and output
83
- output = Exa::CLI::Formatters::WebsetFormatter.format(result, output_format)
84
- puts output
85
- $stdout.flush
86
-
87
- rescue Exa::NotFound => e
88
- $stderr.puts "Webset not found: #{e.message}"
89
- exit 1
90
- rescue Exa::ConfigurationError => e
91
- $stderr.puts "Configuration error: #{e.message}"
92
- exit 1
93
- rescue Exa::Unauthorized => e
94
- $stderr.puts "Authentication error: #{e.message}"
95
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
96
- exit 1
97
- rescue Exa::ClientError => e
98
- $stderr.puts "Client error: #{e.message}"
99
- exit 1
100
- rescue Exa::ServerError => e
101
- $stderr.puts "Server error: #{e.message}"
102
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
103
- exit 1
104
- rescue Exa::Error => e
105
- $stderr.puts "Error: #{e.message}"
106
- exit 1
107
- rescue StandardError => e
108
- $stderr.puts "Unexpected error: #{e.message}"
109
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
110
- exit 1
111
- end
@@ -1,93 +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-get <webset_id> [OPTIONS]
22
-
23
- Retrieve details for a webset
24
-
25
- Arguments:
26
- webset_id ID of the webset to retrieve (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-get ws_abc123
35
- exa-ai webset-get 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-get <webset_id> [OPTIONS]"
53
- $stderr.puts "Try 'exa-ai webset-get --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
66
- webset = client.get_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::Unauthorized => e
77
- $stderr.puts "Authentication error: #{e.message}"
78
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
79
- exit 1
80
- rescue Exa::ClientError => e
81
- $stderr.puts "Client error: #{e.message}"
82
- exit 1
83
- rescue Exa::ServerError => e
84
- $stderr.puts "Server error: #{e.message}"
85
- exit 1
86
- rescue Exa::Error => e
87
- $stderr.puts "Error: #{e.message}"
88
- exit 1
89
- rescue StandardError => e
90
- $stderr.puts "Unexpected error: #{e.message}"
91
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
92
- exit 1
93
- end
@@ -1,111 +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
- item_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-item-delete <webset_id> <item_id> [OPTIONS]
23
-
24
- Delete a webset item
25
-
26
- Arguments:
27
- webset_id ID of the webset (required)
28
- item_id ID of the item (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-item-delete ws_123 item_456
37
- exa-ai webset-item-delete ws_123 item_456 --output-format text
38
- HELP
39
- exit 0
40
- else
41
- # First positional argument is webset_id, second is item_id
42
- if webset_id.nil?
43
- webset_id = arg
44
- elsif item_id.nil?
45
- item_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-item-delete <webset_id> <item_id> [OPTIONS]"
57
- $stderr.puts "Try 'exa-ai webset-item-delete --help' for more information"
58
- exit 1
59
- end
60
-
61
- if item_id.nil?
62
- $stderr.puts "Error: item_id argument is required"
63
- $stderr.puts "Usage: exa-ai webset-item-delete <webset_id> <item_id> [OPTIONS]"
64
- $stderr.puts "Try 'exa-ai webset-item-delete --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
- # Delete item
77
- result = client.delete_item(webset_id: webset_id, id: item_id)
78
-
79
- # Format and output
80
- if result
81
- case output_format
82
- when :text
83
- puts "Item #{item_id} deleted successfully"
84
- when :pretty
85
- puts JSON.pretty_generate({ success: true, item_id: item_id })
86
- else
87
- puts JSON.generate({ success: true, item_id: item_id })
88
- end
89
- end
90
-
91
- rescue Exa::NotFound => e
92
- $stderr.puts "Item not found: #{e.message}"
93
- exit 1
94
- rescue Exa::Unauthorized => e
95
- $stderr.puts "Authentication error: #{e.message}"
96
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
97
- exit 1
98
- rescue Exa::ClientError => e
99
- $stderr.puts "Client error: #{e.message}"
100
- exit 1
101
- rescue Exa::ServerError => e
102
- $stderr.puts "Server error: #{e.message}"
103
- exit 1
104
- rescue Exa::Error => e
105
- $stderr.puts "Error: #{e.message}"
106
- exit 1
107
- rescue StandardError => e
108
- $stderr.puts "Unexpected error: #{e.message}"
109
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
110
- exit 1
111
- 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
- item_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-item-get <webset_id> <item_id> [OPTIONS]
23
-
24
- Get details of a webset item
25
-
26
- Arguments:
27
- webset_id ID of the webset (required)
28
- item_id ID of the item (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-item-get ws_123 item_456
37
- exa-ai webset-item-get ws_123 item_456 --output-format pretty
38
- exa-ai webset-item-get ws_123 item_456 --output-format text
39
- HELP
40
- exit 0
41
- else
42
- # First positional argument is webset_id, second is item_id
43
- if webset_id.nil?
44
- webset_id = arg
45
- elsif item_id.nil?
46
- item_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-item-get <webset_id> <item_id> [OPTIONS]"
58
- $stderr.puts "Try 'exa-ai webset-item-get --help' for more information"
59
- exit 1
60
- end
61
-
62
- if item_id.nil?
63
- $stderr.puts "Error: item_id argument is required"
64
- $stderr.puts "Usage: exa-ai webset-item-get <webset_id> <item_id> [OPTIONS]"
65
- $stderr.puts "Try 'exa-ai webset-item-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 item
78
- item = client.get_item(webset_id: webset_id, id: item_id)
79
-
80
- # Format and output
81
- output = Exa::CLI::Formatters::WebsetItemFormatter.format(item, output_format)
82
- puts output
83
- $stdout.flush
84
-
85
- rescue Exa::NotFound => e
86
- $stderr.puts "Item 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,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
- api_key = nil
9
- output_format = "json"
10
- limit = nil
11
- cursor = nil
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 "--output-format"
20
- output_format = args.shift
21
- when "--limit"
22
- limit = args.shift&.to_i
23
- when "--cursor"
24
- cursor = args.shift
25
- when "--help", "-h"
26
- puts <<~HELP
27
- Usage: exa-ai webset-item-list <webset_id> [OPTIONS]
28
-
29
- List all items in a webset
30
-
31
- Arguments:
32
- webset_id ID of the webset (required)
33
-
34
- Options:
35
- --limit N Maximum number of items to return (default: 20)
36
- --cursor CURSOR Cursor for pagination (use nextCursor from previous response)
37
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
38
- --output-format FMT Output format: json, pretty, text, or toon (default: json)
39
- --help, -h Show this help message
40
-
41
- Examples:
42
- exa-ai webset-item-list ws_123
43
- exa-ai webset-item-list ws_123 --limit 10
44
- exa-ai webset-item-list ws_123 --limit 5 --cursor "abc123"
45
- exa-ai webset-item-list ws_123 --output-format pretty
46
- HELP
47
- exit 0
48
- else
49
- # First positional argument is webset_id
50
- if webset_id.nil?
51
- webset_id = arg
52
- else
53
- $stderr.puts "Unknown option: #{arg}"
54
- exit 1
55
- end
56
- end
57
- end
58
-
59
- # Validate
60
- if webset_id.nil?
61
- $stderr.puts "Error: webset_id argument is required"
62
- $stderr.puts "Usage: exa-ai webset-item-list <webset_id> [OPTIONS]"
63
- $stderr.puts "Try 'exa-ai webset-item-list --help' for more information"
64
- exit 1
65
- end
66
-
67
- begin
68
- # Resolve API key and format
69
- api_key = Exa::CLI::Base.resolve_api_key(api_key)
70
- output_format = Exa::CLI::Base.resolve_output_format(output_format)
71
-
72
- # Build client
73
- client = Exa::CLI::Base.build_client(api_key)
74
-
75
- # Build list params
76
- list_params = {}
77
- list_params[:limit] = limit if limit
78
- list_params[:cursor] = cursor if cursor
79
-
80
- # List items
81
- collection = client.list_items(webset_id: webset_id, **list_params)
82
-
83
- # Format and output
84
- output = Exa::CLI::Formatters::WebsetItemFormatter.format_collection(collection, output_format)
85
- puts output
86
- $stdout.flush
87
-
88
- rescue Exa::NotFound => e
89
- $stderr.puts "Webset not found: #{e.message}"
90
- exit 1
91
- rescue Exa::Unauthorized => e
92
- $stderr.puts "Authentication error: #{e.message}"
93
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
94
- exit 1
95
- rescue Exa::ClientError => e
96
- $stderr.puts "Client error: #{e.message}"
97
- exit 1
98
- rescue Exa::ServerError => e
99
- $stderr.puts "Server error: #{e.message}"
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,91 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # frozen_string_literal: true
3
-
4
- require "exa-ai"
5
-
6
- # Parse arguments
7
- limit = nil
8
- cursor = 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 "--limit"
17
- limit = args.shift&.to_i
18
- when "--cursor"
19
- cursor = args.shift
20
- when "--api-key"
21
- api_key = args.shift
22
- when "--output-format"
23
- output_format = args.shift
24
- when "--help", "-h"
25
- puts <<~HELP
26
- Usage: exa-ai webset-list [OPTIONS]
27
-
28
- List all websets with optional pagination
29
-
30
- Options:
31
- --limit N Maximum number of websets to return (default: 25, max: 100)
32
- --cursor CURSOR Cursor for pagination (use next_cursor from previous response)
33
- --api-key KEY Exa API key (or set EXA_API_KEY env var)
34
- --output-format FMT Output format: json, pretty, or text (default: json)
35
- --help, -h Show this help message
36
-
37
- Examples:
38
- exa-ai webset-list
39
- exa-ai webset-list --limit 10
40
- exa-ai webset-list --limit 5 --cursor "abc123"
41
- exa-ai webset-list --output-format pretty
42
- HELP
43
- exit 0
44
- else
45
- $stderr.puts "Unknown option: #{arg}"
46
- exit 1
47
- end
48
- end
49
-
50
- begin
51
- # Resolve API key and format
52
- api_key = Exa::CLI::Base.resolve_api_key(api_key)
53
- output_format = Exa::CLI::Base.resolve_output_format(output_format)
54
-
55
- # Build client
56
- client = Exa::CLI::Base.build_client(api_key)
57
-
58
- # List websets with optional pagination
59
- list_params = {}
60
- list_params[:limit] = limit if limit
61
- list_params[:cursor] = cursor if cursor
62
-
63
- collection = client.list_websets(**list_params)
64
-
65
- # Format and output
66
- output = Exa::CLI::Formatters::WebsetFormatter.format_collection(collection, output_format)
67
- puts output
68
- $stdout.flush
69
-
70
- rescue Exa::ConfigurationError => e
71
- $stderr.puts "Configuration error: #{e.message}"
72
- exit 1
73
- rescue Exa::Unauthorized => e
74
- $stderr.puts "Authentication error: #{e.message}"
75
- $stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
76
- exit 1
77
- rescue Exa::ClientError => e
78
- $stderr.puts "Client error: #{e.message}"
79
- exit 1
80
- rescue Exa::ServerError => e
81
- $stderr.puts "Server error: #{e.message}"
82
- $stderr.puts "The Exa API may be experiencing issues. Please try again later."
83
- exit 1
84
- rescue Exa::Error => e
85
- $stderr.puts "Error: #{e.message}"
86
- exit 1
87
- rescue StandardError => e
88
- $stderr.puts "Unexpected error: #{e.message}"
89
- $stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
90
- exit 1
91
- end