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.
- checksums.yaml +4 -4
- data/README.md +119 -73
- data/exe/exa-ai +41 -136
- data/exe/exa-ai-agent-run-create +55 -20
- data/exe/exa-ai-agent-run-delete +1 -8
- data/exe/exa-ai-agent-run-events +21 -1
- data/exe/exa-ai-agent-run-list +1 -1
- data/exe/exa-ai-agent-run-stop +93 -0
- data/exe/exa-ai-answer +25 -0
- data/exe/exa-ai-context +6 -2
- data/exe/exa-ai-find-similar +26 -68
- data/exe/exa-ai-get-contents +138 -42
- data/exe/exa-ai-search +27 -104
- data/exe/exa-ai-search-monitor-batch +93 -0
- data/exe/exa-ai-search-monitor-create +104 -0
- data/exe/exa-ai-search-monitor-delete +69 -0
- data/exe/exa-ai-search-monitor-get +69 -0
- data/exe/exa-ai-search-monitor-list +73 -0
- data/exe/exa-ai-search-monitor-runs-get +68 -0
- data/exe/exa-ai-search-monitor-runs-list +75 -0
- data/exe/exa-ai-search-monitor-trigger +69 -0
- data/exe/exa-ai-search-monitor-update +102 -0
- data/lib/exa/cli/base.rb +57 -0
- data/lib/exa/cli/contents_flags.rb +199 -0
- data/lib/exa/cli/formatters/agent_run_formatter.rb +79 -3
- data/lib/exa/cli/formatters/search_formatter.rb +18 -2
- data/lib/exa/cli/formatters/search_monitor_formatter.rb +98 -0
- data/lib/exa/cli/search_parser.rb +46 -87
- data/lib/exa/client.rb +186 -310
- data/lib/exa/resources/agent_run.rb +5 -3
- data/lib/exa/resources/agent_run_deletion.rb +17 -0
- data/lib/exa/resources/answer.rb +3 -3
- data/lib/exa/resources/contents_result.rb +5 -1
- data/lib/exa/resources/find_similar_result.rb +5 -1
- data/lib/exa/resources/search_monitor.rb +42 -0
- data/lib/exa/resources/search_monitor_batch_result.rb +11 -0
- data/lib/exa/resources/search_monitor_list.rb +19 -0
- data/lib/exa/resources/search_monitor_run.rb +46 -0
- data/lib/exa/resources/search_monitor_trigger_result.rb +11 -0
- data/lib/exa/resources/search_result.rb +11 -1
- data/lib/exa/services/agent_run_cancel.rb +1 -12
- data/lib/exa/services/agent_run_create.rb +1 -12
- data/lib/exa/services/agent_run_delete.rb +6 -14
- data/lib/exa/services/agent_run_events.rb +33 -4
- data/lib/exa/services/agent_run_get.rb +1 -12
- data/lib/exa/services/agent_run_list.rb +1 -12
- data/lib/exa/services/agent_run_stop.rb +21 -0
- data/lib/exa/services/agent_run_stream.rb +53 -51
- data/lib/exa/services/answer.rb +5 -2
- data/lib/exa/services/answer_stream.rb +54 -45
- data/lib/exa/services/context.rb +3 -1
- data/lib/exa/services/find_similar.rb +9 -2
- data/lib/exa/services/get_contents.rb +14 -15
- data/lib/exa/services/parameter_converter.rb +128 -111
- data/lib/exa/services/search.rb +58 -19
- data/lib/exa/services/search_monitors/batch.rb +36 -0
- data/lib/exa/services/search_monitors/create.rb +37 -0
- data/lib/exa/services/search_monitors/delete.rb +22 -0
- data/lib/exa/services/search_monitors/get.rb +22 -0
- data/lib/exa/services/search_monitors/list.rb +29 -0
- data/lib/exa/services/search_monitors/runs_get.rb +23 -0
- data/lib/exa/services/search_monitors/runs_list.rb +29 -0
- data/lib/exa/services/search_monitors/trigger.rb +22 -0
- data/lib/exa/services/search_monitors/update.rb +42 -0
- data/lib/exa/services/search_stream.rb +38 -0
- data/lib/exa/version.rb +1 -1
- data/lib/exa.rb +18 -50
- metadata +30 -84
- data/exe/exa-ai-enrichment-cancel +0 -108
- data/exe/exa-ai-enrichment-create +0 -226
- data/exe/exa-ai-enrichment-delete +0 -122
- data/exe/exa-ai-enrichment-get +0 -104
- data/exe/exa-ai-enrichment-list +0 -99
- data/exe/exa-ai-enrichment-update +0 -171
- data/exe/exa-ai-import-create +0 -253
- data/exe/exa-ai-import-delete +0 -92
- data/exe/exa-ai-import-get +0 -92
- data/exe/exa-ai-import-list +0 -72
- data/exe/exa-ai-import-update +0 -164
- data/exe/exa-ai-monitor-create +0 -223
- data/exe/exa-ai-monitor-delete +0 -101
- data/exe/exa-ai-monitor-get +0 -92
- data/exe/exa-ai-monitor-list +0 -90
- data/exe/exa-ai-monitor-runs-get +0 -103
- data/exe/exa-ai-monitor-runs-list +0 -110
- data/exe/exa-ai-monitor-update +0 -207
- data/exe/exa-ai-webset-cancel +0 -97
- data/exe/exa-ai-webset-create +0 -254
- data/exe/exa-ai-webset-delete +0 -111
- data/exe/exa-ai-webset-get +0 -93
- data/exe/exa-ai-webset-item-delete +0 -111
- data/exe/exa-ai-webset-item-get +0 -105
- data/exe/exa-ai-webset-item-list +0 -108
- data/exe/exa-ai-webset-list +0 -91
- data/exe/exa-ai-webset-search-cancel +0 -104
- data/exe/exa-ai-webset-search-create +0 -247
- data/exe/exa-ai-webset-search-get +0 -105
- data/exe/exa-ai-webset-update +0 -143
- data/lib/exa/cli/formatters/enrichment_formatter.rb +0 -125
- data/lib/exa/cli/formatters/import_formatter.rb +0 -153
- data/lib/exa/cli/formatters/monitor_formatter.rb +0 -144
- data/lib/exa/cli/formatters/monitor_run_formatter.rb +0 -126
- data/lib/exa/cli/formatters/webset_formatter.rb +0 -134
- data/lib/exa/cli/formatters/webset_item_formatter.rb +0 -131
- data/lib/exa/cli/formatters/webset_search_formatter.rb +0 -57
- data/lib/exa/constants/websets.rb +0 -19
- data/lib/exa/resources/import.rb +0 -86
- data/lib/exa/resources/import_collection.rb +0 -33
- data/lib/exa/resources/monitor.rb +0 -48
- data/lib/exa/resources/monitor_collection.rb +0 -30
- data/lib/exa/resources/monitor_run.rb +0 -52
- data/lib/exa/resources/monitor_run_collection.rb +0 -30
- data/lib/exa/resources/webset.rb +0 -74
- data/lib/exa/resources/webset_collection.rb +0 -33
- data/lib/exa/resources/webset_enrichment.rb +0 -71
- data/lib/exa/resources/webset_enrichment_collection.rb +0 -28
- data/lib/exa/resources/webset_item_collection.rb +0 -33
- data/lib/exa/resources/webset_search.rb +0 -112
- data/lib/exa/services/websets/cancel.rb +0 -36
- data/lib/exa/services/websets/cancel_enrichment.rb +0 -35
- data/lib/exa/services/websets/cancel_search.rb +0 -44
- data/lib/exa/services/websets/create.rb +0 -45
- data/lib/exa/services/websets/create_enrichment.rb +0 -35
- data/lib/exa/services/websets/create_search.rb +0 -48
- data/lib/exa/services/websets/create_search_validator.rb +0 -128
- data/lib/exa/services/websets/create_validator.rb +0 -213
- data/lib/exa/services/websets/delete.rb +0 -36
- data/lib/exa/services/websets/delete_enrichment.rb +0 -35
- data/lib/exa/services/websets/delete_item.rb +0 -20
- data/lib/exa/services/websets/get_item.rb +0 -20
- data/lib/exa/services/websets/get_search.rb +0 -43
- data/lib/exa/services/websets/import_create.rb +0 -40
- data/lib/exa/services/websets/import_delete.rb +0 -37
- data/lib/exa/services/websets/import_get.rb +0 -37
- data/lib/exa/services/websets/import_list.rb +0 -25
- data/lib/exa/services/websets/import_update.rb +0 -38
- data/lib/exa/services/websets/import_upload.rb +0 -59
- data/lib/exa/services/websets/list.rb +0 -25
- data/lib/exa/services/websets/list_items.rb +0 -26
- data/lib/exa/services/websets/monitors/create.rb +0 -42
- data/lib/exa/services/websets/monitors/delete.rb +0 -32
- data/lib/exa/services/websets/monitors/get.rb +0 -33
- data/lib/exa/services/websets/monitors/list.rb +0 -27
- data/lib/exa/services/websets/monitors/runs/get.rb +0 -37
- data/lib/exa/services/websets/monitors/runs/list.rb +0 -30
- data/lib/exa/services/websets/monitors/update.rb +0 -33
- data/lib/exa/services/websets/retrieve.rb +0 -47
- data/lib/exa/services/websets/retrieve_enrichment.rb +0 -35
- data/lib/exa/services/websets/update.rb +0 -37
- data/lib/exa/services/websets/update_enrichment.rb +0 -36
- data/lib/exa/services/websets_parameter_converter.rb +0 -45
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
# frozen_string_literal: true
|
|
3
|
+
|
|
4
|
+
require "exa-ai"
|
|
5
|
+
|
|
6
|
+
api_key = nil
|
|
7
|
+
output_format = "json"
|
|
8
|
+
monitor_id = nil
|
|
9
|
+
|
|
10
|
+
args = ARGV.dup
|
|
11
|
+
while args.any?
|
|
12
|
+
arg = args.shift
|
|
13
|
+
case arg
|
|
14
|
+
when "--api-key"
|
|
15
|
+
api_key = args.shift
|
|
16
|
+
when "--output-format"
|
|
17
|
+
output_format = args.shift
|
|
18
|
+
when "--help", "-h"
|
|
19
|
+
puts <<~HELP
|
|
20
|
+
Usage: exa-ai search-monitor-delete ID [options]
|
|
21
|
+
|
|
22
|
+
Delete a search monitor.
|
|
23
|
+
Search monitors are the /monitors API.
|
|
24
|
+
|
|
25
|
+
Options:
|
|
26
|
+
--api-key KEY Exa API key (or use EXA_API_KEY env var)
|
|
27
|
+
--output-format FORMAT Output format: json, pretty, text, or toon (default: json)
|
|
28
|
+
--help, -h Show this help message
|
|
29
|
+
|
|
30
|
+
Example:
|
|
31
|
+
exa-ai search-monitor-delete mon_abc123
|
|
32
|
+
HELP
|
|
33
|
+
exit 0
|
|
34
|
+
else
|
|
35
|
+
if arg.start_with?("-") || monitor_id
|
|
36
|
+
warn "Unknown option: #{arg}"
|
|
37
|
+
exit 1
|
|
38
|
+
end
|
|
39
|
+
monitor_id = arg
|
|
40
|
+
end
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
unless monitor_id
|
|
44
|
+
warn "Error: ID is required. Run with --help for usage."
|
|
45
|
+
exit 1
|
|
46
|
+
end
|
|
47
|
+
|
|
48
|
+
begin
|
|
49
|
+
output_format = Exa::CLI::Base.resolve_output_format(output_format)
|
|
50
|
+
client = Exa::CLI::Base.build_client(Exa::CLI::Base.resolve_api_key(api_key))
|
|
51
|
+
result = client.search_monitor_delete(monitor_id)
|
|
52
|
+
puts Exa::CLI::Formatters::SearchMonitorFormatter.format(result, output_format)
|
|
53
|
+
rescue Exa::Unauthorized => e
|
|
54
|
+
warn "Authentication failed: #{e.message}"
|
|
55
|
+
warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
|
|
56
|
+
exit 1
|
|
57
|
+
rescue Exa::ClientError => e
|
|
58
|
+
warn "Client error: #{e.message}"
|
|
59
|
+
exit 1
|
|
60
|
+
rescue Exa::ServerError => e
|
|
61
|
+
warn "Server error: #{e.message}"
|
|
62
|
+
exit 1
|
|
63
|
+
rescue Exa::Error => e
|
|
64
|
+
warn "Error: #{e.message}"
|
|
65
|
+
exit 1
|
|
66
|
+
rescue StandardError => e
|
|
67
|
+
warn "Unexpected error: #{e.message}"
|
|
68
|
+
exit 1
|
|
69
|
+
end
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
# frozen_string_literal: true
|
|
3
|
+
|
|
4
|
+
require "exa-ai"
|
|
5
|
+
|
|
6
|
+
api_key = nil
|
|
7
|
+
output_format = "json"
|
|
8
|
+
monitor_id = nil
|
|
9
|
+
|
|
10
|
+
args = ARGV.dup
|
|
11
|
+
while args.any?
|
|
12
|
+
arg = args.shift
|
|
13
|
+
case arg
|
|
14
|
+
when "--api-key"
|
|
15
|
+
api_key = args.shift
|
|
16
|
+
when "--output-format"
|
|
17
|
+
output_format = args.shift
|
|
18
|
+
when "--help", "-h"
|
|
19
|
+
puts <<~HELP
|
|
20
|
+
Usage: exa-ai search-monitor-get ID [options]
|
|
21
|
+
|
|
22
|
+
Get a search monitor.
|
|
23
|
+
Search monitors are the /monitors API.
|
|
24
|
+
|
|
25
|
+
Options:
|
|
26
|
+
--api-key KEY Exa API key (or use EXA_API_KEY env var)
|
|
27
|
+
--output-format FORMAT Output format: json, pretty, text, or toon (default: json)
|
|
28
|
+
--help, -h Show this help message
|
|
29
|
+
|
|
30
|
+
Example:
|
|
31
|
+
exa-ai search-monitor-get mon_abc123
|
|
32
|
+
HELP
|
|
33
|
+
exit 0
|
|
34
|
+
else
|
|
35
|
+
if arg.start_with?("-") || monitor_id
|
|
36
|
+
warn "Unknown option: #{arg}"
|
|
37
|
+
exit 1
|
|
38
|
+
end
|
|
39
|
+
monitor_id = arg
|
|
40
|
+
end
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
unless monitor_id
|
|
44
|
+
warn "Error: ID is required. Run with --help for usage."
|
|
45
|
+
exit 1
|
|
46
|
+
end
|
|
47
|
+
|
|
48
|
+
begin
|
|
49
|
+
output_format = Exa::CLI::Base.resolve_output_format(output_format)
|
|
50
|
+
client = Exa::CLI::Base.build_client(Exa::CLI::Base.resolve_api_key(api_key))
|
|
51
|
+
result = client.search_monitor_get(monitor_id)
|
|
52
|
+
puts Exa::CLI::Formatters::SearchMonitorFormatter.format(result, output_format)
|
|
53
|
+
rescue Exa::Unauthorized => e
|
|
54
|
+
warn "Authentication failed: #{e.message}"
|
|
55
|
+
warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
|
|
56
|
+
exit 1
|
|
57
|
+
rescue Exa::ClientError => e
|
|
58
|
+
warn "Client error: #{e.message}"
|
|
59
|
+
exit 1
|
|
60
|
+
rescue Exa::ServerError => e
|
|
61
|
+
warn "Server error: #{e.message}"
|
|
62
|
+
exit 1
|
|
63
|
+
rescue Exa::Error => e
|
|
64
|
+
warn "Error: #{e.message}"
|
|
65
|
+
exit 1
|
|
66
|
+
rescue StandardError => e
|
|
67
|
+
warn "Unexpected error: #{e.message}"
|
|
68
|
+
exit 1
|
|
69
|
+
end
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
# frozen_string_literal: true
|
|
3
|
+
|
|
4
|
+
require "exa-ai"
|
|
5
|
+
|
|
6
|
+
api_key = nil
|
|
7
|
+
output_format = "json"
|
|
8
|
+
params = {}
|
|
9
|
+
|
|
10
|
+
args = ARGV.dup
|
|
11
|
+
while args.any?
|
|
12
|
+
arg = args.shift
|
|
13
|
+
case arg
|
|
14
|
+
when "--api-key"
|
|
15
|
+
api_key = args.shift
|
|
16
|
+
when "--status"
|
|
17
|
+
params[:status] = args.shift
|
|
18
|
+
when "--name"
|
|
19
|
+
params[:name] = args.shift
|
|
20
|
+
when "--cursor"
|
|
21
|
+
params[:cursor] = args.shift
|
|
22
|
+
when "--limit"
|
|
23
|
+
params[:limit] = Exa::CLI::Base.parse_integer("--limit", args.shift)
|
|
24
|
+
when "--output-format"
|
|
25
|
+
output_format = args.shift
|
|
26
|
+
when "--help", "-h"
|
|
27
|
+
puts <<~HELP
|
|
28
|
+
Usage: exa-ai search-monitor-list [options]
|
|
29
|
+
|
|
30
|
+
List search monitors (the /monitors API).
|
|
31
|
+
|
|
32
|
+
Options:
|
|
33
|
+
--status STATUS Filter by status: active, paused, or disabled
|
|
34
|
+
--name TEXT Filter by name (case-insensitive substring)
|
|
35
|
+
--cursor CURSOR Pagination cursor for next page
|
|
36
|
+
--limit N Results per page (1-100)
|
|
37
|
+
--api-key KEY Exa API key (or use EXA_API_KEY env var)
|
|
38
|
+
--output-format FORMAT Output format: json, pretty, text, or toon (default: json)
|
|
39
|
+
--help, -h Show this help message
|
|
40
|
+
|
|
41
|
+
Examples:
|
|
42
|
+
exa-ai search-monitor-list
|
|
43
|
+
exa-ai search-monitor-list --status active --limit 20
|
|
44
|
+
HELP
|
|
45
|
+
exit 0
|
|
46
|
+
else
|
|
47
|
+
warn "Unknown option: #{arg}"
|
|
48
|
+
exit 1
|
|
49
|
+
end
|
|
50
|
+
end
|
|
51
|
+
|
|
52
|
+
begin
|
|
53
|
+
output_format = Exa::CLI::Base.resolve_output_format(output_format)
|
|
54
|
+
client = Exa::CLI::Base.build_client(Exa::CLI::Base.resolve_api_key(api_key))
|
|
55
|
+
result = client.search_monitor_list(**params)
|
|
56
|
+
puts Exa::CLI::Formatters::SearchMonitorFormatter.format(result, output_format)
|
|
57
|
+
rescue Exa::Unauthorized => e
|
|
58
|
+
warn "Authentication failed: #{e.message}"
|
|
59
|
+
warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
|
|
60
|
+
exit 1
|
|
61
|
+
rescue Exa::ClientError => e
|
|
62
|
+
warn "Client error: #{e.message}"
|
|
63
|
+
exit 1
|
|
64
|
+
rescue Exa::ServerError => e
|
|
65
|
+
warn "Server error: #{e.message}"
|
|
66
|
+
exit 1
|
|
67
|
+
rescue Exa::Error => e
|
|
68
|
+
warn "Error: #{e.message}"
|
|
69
|
+
exit 1
|
|
70
|
+
rescue StandardError => e
|
|
71
|
+
warn "Unexpected error: #{e.message}"
|
|
72
|
+
exit 1
|
|
73
|
+
end
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
# frozen_string_literal: true
|
|
3
|
+
|
|
4
|
+
require "exa-ai"
|
|
5
|
+
|
|
6
|
+
api_key = nil
|
|
7
|
+
output_format = "json"
|
|
8
|
+
positional = []
|
|
9
|
+
|
|
10
|
+
args = ARGV.dup
|
|
11
|
+
while args.any?
|
|
12
|
+
arg = args.shift
|
|
13
|
+
case arg
|
|
14
|
+
when "--api-key"
|
|
15
|
+
api_key = args.shift
|
|
16
|
+
when "--output-format"
|
|
17
|
+
output_format = args.shift
|
|
18
|
+
when "--help", "-h"
|
|
19
|
+
puts <<~HELP
|
|
20
|
+
Usage: exa-ai search-monitor-runs-get MONITOR_ID RUN_ID [options]
|
|
21
|
+
|
|
22
|
+
Get one run of a search monitor.
|
|
23
|
+
|
|
24
|
+
Options:
|
|
25
|
+
--api-key KEY Exa API key (or use EXA_API_KEY env var)
|
|
26
|
+
--output-format FORMAT Output format: json, pretty, text, or toon (default: json)
|
|
27
|
+
--help, -h Show this help message
|
|
28
|
+
|
|
29
|
+
Example:
|
|
30
|
+
exa-ai search-monitor-runs-get mon_abc123 run_xyz789
|
|
31
|
+
HELP
|
|
32
|
+
exit 0
|
|
33
|
+
else
|
|
34
|
+
if arg.start_with?("-")
|
|
35
|
+
warn "Unknown option: #{arg}"
|
|
36
|
+
exit 1
|
|
37
|
+
end
|
|
38
|
+
positional << arg
|
|
39
|
+
end
|
|
40
|
+
end
|
|
41
|
+
|
|
42
|
+
unless positional.size == 2
|
|
43
|
+
warn "Error: MONITOR_ID and RUN_ID are required. Run with --help for usage."
|
|
44
|
+
exit 1
|
|
45
|
+
end
|
|
46
|
+
|
|
47
|
+
begin
|
|
48
|
+
output_format = Exa::CLI::Base.resolve_output_format(output_format)
|
|
49
|
+
client = Exa::CLI::Base.build_client(Exa::CLI::Base.resolve_api_key(api_key))
|
|
50
|
+
result = client.search_monitor_runs_get(positional[0], positional[1])
|
|
51
|
+
puts Exa::CLI::Formatters::SearchMonitorFormatter.format(result, output_format)
|
|
52
|
+
rescue Exa::Unauthorized => e
|
|
53
|
+
warn "Authentication failed: #{e.message}"
|
|
54
|
+
warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
|
|
55
|
+
exit 1
|
|
56
|
+
rescue Exa::ClientError => e
|
|
57
|
+
warn "Client error: #{e.message}"
|
|
58
|
+
exit 1
|
|
59
|
+
rescue Exa::ServerError => e
|
|
60
|
+
warn "Server error: #{e.message}"
|
|
61
|
+
exit 1
|
|
62
|
+
rescue Exa::Error => e
|
|
63
|
+
warn "Error: #{e.message}"
|
|
64
|
+
exit 1
|
|
65
|
+
rescue StandardError => e
|
|
66
|
+
warn "Unexpected error: #{e.message}"
|
|
67
|
+
exit 1
|
|
68
|
+
end
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
# frozen_string_literal: true
|
|
3
|
+
|
|
4
|
+
require "exa-ai"
|
|
5
|
+
|
|
6
|
+
api_key = nil
|
|
7
|
+
output_format = "json"
|
|
8
|
+
monitor_id = nil
|
|
9
|
+
params = {}
|
|
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 "--cursor"
|
|
18
|
+
params[:cursor] = args.shift
|
|
19
|
+
when "--limit"
|
|
20
|
+
params[:limit] = Exa::CLI::Base.parse_integer("--limit", args.shift)
|
|
21
|
+
when "--output-format"
|
|
22
|
+
output_format = args.shift
|
|
23
|
+
when "--help", "-h"
|
|
24
|
+
puts <<~HELP
|
|
25
|
+
Usage: exa-ai search-monitor-runs-list MONITOR_ID [options]
|
|
26
|
+
|
|
27
|
+
List the runs of a search monitor.
|
|
28
|
+
|
|
29
|
+
Options:
|
|
30
|
+
--cursor CURSOR Pagination cursor for next page
|
|
31
|
+
--limit N Results per page (1-100)
|
|
32
|
+
--api-key KEY Exa API key (or use EXA_API_KEY env var)
|
|
33
|
+
--output-format FORMAT Output format: json, pretty, text, or toon (default: json)
|
|
34
|
+
--help, -h Show this help message
|
|
35
|
+
|
|
36
|
+
Example:
|
|
37
|
+
exa-ai search-monitor-runs-list mon_abc123 --limit 20
|
|
38
|
+
HELP
|
|
39
|
+
exit 0
|
|
40
|
+
else
|
|
41
|
+
if arg.start_with?("-") || monitor_id
|
|
42
|
+
warn "Unknown option: #{arg}"
|
|
43
|
+
exit 1
|
|
44
|
+
end
|
|
45
|
+
monitor_id = arg
|
|
46
|
+
end
|
|
47
|
+
end
|
|
48
|
+
|
|
49
|
+
unless monitor_id
|
|
50
|
+
warn "Error: MONITOR_ID is required. Run with --help for usage."
|
|
51
|
+
exit 1
|
|
52
|
+
end
|
|
53
|
+
|
|
54
|
+
begin
|
|
55
|
+
output_format = Exa::CLI::Base.resolve_output_format(output_format)
|
|
56
|
+
client = Exa::CLI::Base.build_client(Exa::CLI::Base.resolve_api_key(api_key))
|
|
57
|
+
result = client.search_monitor_runs_list(monitor_id, **params)
|
|
58
|
+
puts Exa::CLI::Formatters::SearchMonitorFormatter.format(result, output_format)
|
|
59
|
+
rescue Exa::Unauthorized => e
|
|
60
|
+
warn "Authentication failed: #{e.message}"
|
|
61
|
+
warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
|
|
62
|
+
exit 1
|
|
63
|
+
rescue Exa::ClientError => e
|
|
64
|
+
warn "Client error: #{e.message}"
|
|
65
|
+
exit 1
|
|
66
|
+
rescue Exa::ServerError => e
|
|
67
|
+
warn "Server error: #{e.message}"
|
|
68
|
+
exit 1
|
|
69
|
+
rescue Exa::Error => e
|
|
70
|
+
warn "Error: #{e.message}"
|
|
71
|
+
exit 1
|
|
72
|
+
rescue StandardError => e
|
|
73
|
+
warn "Unexpected error: #{e.message}"
|
|
74
|
+
exit 1
|
|
75
|
+
end
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
# frozen_string_literal: true
|
|
3
|
+
|
|
4
|
+
require "exa-ai"
|
|
5
|
+
|
|
6
|
+
api_key = nil
|
|
7
|
+
output_format = "json"
|
|
8
|
+
monitor_id = nil
|
|
9
|
+
|
|
10
|
+
args = ARGV.dup
|
|
11
|
+
while args.any?
|
|
12
|
+
arg = args.shift
|
|
13
|
+
case arg
|
|
14
|
+
when "--api-key"
|
|
15
|
+
api_key = args.shift
|
|
16
|
+
when "--output-format"
|
|
17
|
+
output_format = args.shift
|
|
18
|
+
when "--help", "-h"
|
|
19
|
+
puts <<~HELP
|
|
20
|
+
Usage: exa-ai search-monitor-trigger ID [options]
|
|
21
|
+
|
|
22
|
+
Run a search monitor now (status must be active or paused).
|
|
23
|
+
Search monitors are the /monitors API.
|
|
24
|
+
|
|
25
|
+
Options:
|
|
26
|
+
--api-key KEY Exa API key (or use EXA_API_KEY env var)
|
|
27
|
+
--output-format FORMAT Output format: json, pretty, text, or toon (default: json)
|
|
28
|
+
--help, -h Show this help message
|
|
29
|
+
|
|
30
|
+
Example:
|
|
31
|
+
exa-ai search-monitor-trigger mon_abc123
|
|
32
|
+
HELP
|
|
33
|
+
exit 0
|
|
34
|
+
else
|
|
35
|
+
if arg.start_with?("-") || monitor_id
|
|
36
|
+
warn "Unknown option: #{arg}"
|
|
37
|
+
exit 1
|
|
38
|
+
end
|
|
39
|
+
monitor_id = arg
|
|
40
|
+
end
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
unless monitor_id
|
|
44
|
+
warn "Error: ID is required. Run with --help for usage."
|
|
45
|
+
exit 1
|
|
46
|
+
end
|
|
47
|
+
|
|
48
|
+
begin
|
|
49
|
+
output_format = Exa::CLI::Base.resolve_output_format(output_format)
|
|
50
|
+
client = Exa::CLI::Base.build_client(Exa::CLI::Base.resolve_api_key(api_key))
|
|
51
|
+
result = client.search_monitor_trigger(monitor_id)
|
|
52
|
+
puts Exa::CLI::Formatters::SearchMonitorFormatter.format(result, output_format)
|
|
53
|
+
rescue Exa::Unauthorized => e
|
|
54
|
+
warn "Authentication failed: #{e.message}"
|
|
55
|
+
warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
|
|
56
|
+
exit 1
|
|
57
|
+
rescue Exa::ClientError => e
|
|
58
|
+
warn "Client error: #{e.message}"
|
|
59
|
+
exit 1
|
|
60
|
+
rescue Exa::ServerError => e
|
|
61
|
+
warn "Server error: #{e.message}"
|
|
62
|
+
exit 1
|
|
63
|
+
rescue Exa::Error => e
|
|
64
|
+
warn "Error: #{e.message}"
|
|
65
|
+
exit 1
|
|
66
|
+
rescue StandardError => e
|
|
67
|
+
warn "Unexpected error: #{e.message}"
|
|
68
|
+
exit 1
|
|
69
|
+
end
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
# frozen_string_literal: true
|
|
3
|
+
|
|
4
|
+
require "exa-ai"
|
|
5
|
+
|
|
6
|
+
api_key = nil
|
|
7
|
+
output_format = "json"
|
|
8
|
+
monitor_id = nil
|
|
9
|
+
search = {}
|
|
10
|
+
webhook = {}
|
|
11
|
+
params = {}
|
|
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 "--name"
|
|
20
|
+
params[:name] = args.shift
|
|
21
|
+
when "--status"
|
|
22
|
+
params[:status] = args.shift
|
|
23
|
+
when "--query"
|
|
24
|
+
search[:query] = args.shift
|
|
25
|
+
when "--period"
|
|
26
|
+
params[:trigger] = { type: "interval", period: args.shift }
|
|
27
|
+
when "--remove-trigger"
|
|
28
|
+
params[:trigger] = nil
|
|
29
|
+
when "--webhook-url"
|
|
30
|
+
webhook[:url] = args.shift
|
|
31
|
+
when "--webhook-events"
|
|
32
|
+
webhook[:events] = Exa::CLI::Base.option_value("--webhook-events", args.shift).split(",").map(&:strip)
|
|
33
|
+
when "--output-schema"
|
|
34
|
+
params[:output_schema] = Exa::CLI::Base.parse_json_or_file("--output-schema", args.shift)
|
|
35
|
+
when "--metadata"
|
|
36
|
+
params[:metadata] = Exa::CLI::Base.parse_json_or_file("--metadata", args.shift)
|
|
37
|
+
when "--output-format"
|
|
38
|
+
output_format = args.shift
|
|
39
|
+
when "--help", "-h"
|
|
40
|
+
puts <<~HELP
|
|
41
|
+
Usage: exa-ai search-monitor-update ID [options]
|
|
42
|
+
|
|
43
|
+
Update a search monitor. Only the options given are changed.
|
|
44
|
+
|
|
45
|
+
Options:
|
|
46
|
+
--name NAME New name
|
|
47
|
+
--status STATUS active or paused
|
|
48
|
+
--query TEXT New search query
|
|
49
|
+
--period PERIOD New schedule, e.g. 1h, 6h, 1d, 7d
|
|
50
|
+
--remove-trigger Remove the schedule (manual runs only)
|
|
51
|
+
--webhook-url URL New webhook URL
|
|
52
|
+
--webhook-events LIST Comma-separated webhook events
|
|
53
|
+
--output-schema JSON JSON schema for structured output (JSON or @file.json)
|
|
54
|
+
--metadata JSON Custom metadata (JSON or @file.json)
|
|
55
|
+
--api-key KEY Exa API key (or use EXA_API_KEY env var)
|
|
56
|
+
--output-format FORMAT Output format: json, pretty, text, or toon (default: json)
|
|
57
|
+
--help, -h Show this help message
|
|
58
|
+
|
|
59
|
+
Examples:
|
|
60
|
+
exa-ai search-monitor-update mon_abc123 --status paused
|
|
61
|
+
exa-ai search-monitor-update mon_abc123 --remove-trigger
|
|
62
|
+
HELP
|
|
63
|
+
exit 0
|
|
64
|
+
else
|
|
65
|
+
if arg.start_with?("-") || monitor_id
|
|
66
|
+
warn "Unknown option: #{arg}"
|
|
67
|
+
exit 1
|
|
68
|
+
end
|
|
69
|
+
monitor_id = arg
|
|
70
|
+
end
|
|
71
|
+
end
|
|
72
|
+
|
|
73
|
+
unless monitor_id
|
|
74
|
+
warn "Error: ID is required. Run with --help for usage."
|
|
75
|
+
exit 1
|
|
76
|
+
end
|
|
77
|
+
|
|
78
|
+
params[:search] = search unless search.empty?
|
|
79
|
+
params[:webhook] = webhook unless webhook.empty?
|
|
80
|
+
|
|
81
|
+
begin
|
|
82
|
+
output_format = Exa::CLI::Base.resolve_output_format(output_format)
|
|
83
|
+
client = Exa::CLI::Base.build_client(Exa::CLI::Base.resolve_api_key(api_key))
|
|
84
|
+
result = client.search_monitor_update(monitor_id, **params)
|
|
85
|
+
puts Exa::CLI::Formatters::SearchMonitorFormatter.format(result, output_format)
|
|
86
|
+
rescue Exa::Unauthorized => e
|
|
87
|
+
warn "Authentication failed: #{e.message}"
|
|
88
|
+
warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
|
|
89
|
+
exit 1
|
|
90
|
+
rescue Exa::ClientError => e
|
|
91
|
+
warn "Client error: #{e.message}"
|
|
92
|
+
exit 1
|
|
93
|
+
rescue Exa::ServerError => e
|
|
94
|
+
warn "Server error: #{e.message}"
|
|
95
|
+
exit 1
|
|
96
|
+
rescue Exa::Error => e
|
|
97
|
+
warn "Error: #{e.message}"
|
|
98
|
+
exit 1
|
|
99
|
+
rescue StandardError => e
|
|
100
|
+
warn "Unexpected error: #{e.message}"
|
|
101
|
+
exit 1
|
|
102
|
+
end
|
data/lib/exa/cli/base.rb
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# frozen_string_literal: true
|
|
2
2
|
|
|
3
|
+
require "json"
|
|
4
|
+
|
|
3
5
|
module Exa
|
|
4
6
|
module CLI
|
|
5
7
|
class Base
|
|
@@ -52,6 +54,61 @@ module Exa
|
|
|
52
54
|
require "toon" unless defined?(Toon)
|
|
53
55
|
Toon.encode(data)
|
|
54
56
|
end
|
|
57
|
+
|
|
58
|
+
# Return the value given after a flag. When the flag came last with no
|
|
59
|
+
# value, print one error line and exit, so the command does not crash
|
|
60
|
+
# later with a NoMethodError on nil. Exits instead of raising because
|
|
61
|
+
# many commands parse their options outside their rescue block.
|
|
62
|
+
def self.option_value(flag, value)
|
|
63
|
+
fail_with("#{flag} needs a value") if value.nil?
|
|
64
|
+
|
|
65
|
+
value
|
|
66
|
+
end
|
|
67
|
+
|
|
68
|
+
# Return the value of a free-text option such as --summary-query. Like
|
|
69
|
+
# option_value, but also fails when the value looks like the next flag,
|
|
70
|
+
# which means the user left this option's value out. A value counts as
|
|
71
|
+
# a flag when it starts with two dashes and has no whitespace: a flag
|
|
72
|
+
# name never contains whitespace, so "--autosquash behavior" is text.
|
|
73
|
+
def self.text_value(flag, value)
|
|
74
|
+
option_value(flag, value)
|
|
75
|
+
fail_with("#{flag} needs a value (got the flag #{value})") if value.start_with?("--") && !value.match?(/\s/)
|
|
76
|
+
|
|
77
|
+
value
|
|
78
|
+
end
|
|
79
|
+
|
|
80
|
+
# Stop the command for an argument that starts with two dashes but is
|
|
81
|
+
# not a flag the command knows, so it is not read as a query or a URL.
|
|
82
|
+
def self.reject_unknown_option(arg)
|
|
83
|
+
fail_with("unknown option #{arg}")
|
|
84
|
+
end
|
|
85
|
+
|
|
86
|
+
# Parse a base-10 integer option. "abc", "10abc", "1.5" and "0x10" all
|
|
87
|
+
# fail with one error line instead of silently becoming a number.
|
|
88
|
+
def self.parse_integer(flag, value)
|
|
89
|
+
Integer(option_value(flag, value), 10)
|
|
90
|
+
rescue ArgumentError
|
|
91
|
+
fail_with("#{flag} must be a number (got #{value.inspect})")
|
|
92
|
+
end
|
|
93
|
+
|
|
94
|
+
# Parse a JSON option. A value that starts with @ names a file to read
|
|
95
|
+
# the JSON from. Hash keys stay strings unless symbolize_names is true.
|
|
96
|
+
def self.parse_json_or_file(flag, value, symbolize_names: false)
|
|
97
|
+
text = option_value(flag, value)
|
|
98
|
+
text = File.read(text[1..]) if text.start_with?("@")
|
|
99
|
+
JSON.parse(text, symbolize_names: symbolize_names)
|
|
100
|
+
rescue JSON::ParserError => e
|
|
101
|
+
fail_with("#{flag} is not valid JSON: #{e.message.lines.first.strip}")
|
|
102
|
+
rescue SystemCallError => e
|
|
103
|
+
fail_with("#{flag} file could not be read: #{e.message}")
|
|
104
|
+
end
|
|
105
|
+
|
|
106
|
+
# Print one error line to stderr and exit with status 1.
|
|
107
|
+
def self.fail_with(message)
|
|
108
|
+
warn "Error: #{message}"
|
|
109
|
+
exit 1
|
|
110
|
+
end
|
|
111
|
+
private_class_method :fail_with
|
|
55
112
|
end
|
|
56
113
|
end
|
|
57
114
|
end
|