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.
- checksums.yaml +4 -4
- data/README.md +120 -83
- data/exe/exa-ai +45 -152
- 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-research-list → exa-ai-agent-run-stop} +31 -32
- 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 +183 -333
- data/lib/exa/middleware/raise_error.rb +14 -0
- 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/{research_list.rb → search_monitor_list.rb} +3 -2
- 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 +56 -52
- data/lib/exa/services/answer.rb +5 -2
- data/lib/exa/services/answer_stream.rb +57 -46
- 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 -56
- metadata +31 -94
- 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-research-get +0 -109
- data/exe/exa-ai-research-start +0 -174
- 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/research_formatter.rb +0 -124
- 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/research_task.rb +0 -39
- 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/research_get.rb +0 -30
- data/lib/exa/services/research_list.rb +0 -37
- data/lib/exa/services/research_start.rb +0 -26
- 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 -58
- 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
data/exe/exa-ai-research-get
DELETED
|
@@ -1,109 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env ruby
|
|
2
|
-
# frozen_string_literal: true
|
|
3
|
-
|
|
4
|
-
require "exa-ai"
|
|
5
|
-
|
|
6
|
-
# Parse command-line arguments
|
|
7
|
-
api_key = nil
|
|
8
|
-
research_id = nil
|
|
9
|
-
events = false
|
|
10
|
-
stream = false
|
|
11
|
-
output_format = "json"
|
|
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 "--events"
|
|
20
|
-
events = true
|
|
21
|
-
when "--stream"
|
|
22
|
-
stream = true
|
|
23
|
-
when "--output-format"
|
|
24
|
-
output_format = args.shift
|
|
25
|
-
when "--help", "-h"
|
|
26
|
-
puts <<~HELP
|
|
27
|
-
Usage: exa-ai research-get <research_id> [options]
|
|
28
|
-
|
|
29
|
-
Get the status and results of a research task.
|
|
30
|
-
|
|
31
|
-
Arguments:
|
|
32
|
-
research_id ID of the research task to retrieve
|
|
33
|
-
|
|
34
|
-
Options:
|
|
35
|
-
--api-key KEY Exa API key (or use EXA_API_KEY env var)
|
|
36
|
-
--events Include task execution events in response
|
|
37
|
-
--stream Stream the response (for real-time updates)
|
|
38
|
-
--output-format FORMAT Output format: json, pretty, or text (default: json)
|
|
39
|
-
--help, -h Show this help message
|
|
40
|
-
|
|
41
|
-
Examples:
|
|
42
|
-
exa-ai research-get research_123
|
|
43
|
-
exa-ai research-get research_123 --events
|
|
44
|
-
exa-ai research-get research_123 --stream
|
|
45
|
-
exa-ai research-get research_123 --output-format pretty
|
|
46
|
-
HELP
|
|
47
|
-
exit 0
|
|
48
|
-
else
|
|
49
|
-
# First positional argument is the research_id
|
|
50
|
-
if research_id.nil?
|
|
51
|
-
research_id = arg
|
|
52
|
-
else
|
|
53
|
-
warn "Unknown option: #{arg}"
|
|
54
|
-
exit 1
|
|
55
|
-
end
|
|
56
|
-
end
|
|
57
|
-
end
|
|
58
|
-
|
|
59
|
-
# Validate required arguments
|
|
60
|
-
if research_id.nil?
|
|
61
|
-
warn "Error: Research ID argument required"
|
|
62
|
-
warn "Usage: exa-ai research-get <research_id> [options]"
|
|
63
|
-
warn "Try 'exa-ai research-get --help' for more information"
|
|
64
|
-
exit 1
|
|
65
|
-
end
|
|
66
|
-
|
|
67
|
-
begin
|
|
68
|
-
# Resolve API key
|
|
69
|
-
api_key = Exa::CLI::Base.resolve_api_key(api_key)
|
|
70
|
-
|
|
71
|
-
# Build client
|
|
72
|
-
client = Exa::CLI::Base.build_client(api_key)
|
|
73
|
-
|
|
74
|
-
# Build parameters
|
|
75
|
-
params = {}
|
|
76
|
-
params[:events] = events if events
|
|
77
|
-
params[:stream] = stream if stream
|
|
78
|
-
|
|
79
|
-
# Call API
|
|
80
|
-
result = client.research_get(research_id, **params)
|
|
81
|
-
|
|
82
|
-
# Format output
|
|
83
|
-
formatted = Exa::CLI::Formatters::ResearchFormatter.format_task(
|
|
84
|
-
result,
|
|
85
|
-
output_format,
|
|
86
|
-
show_events: events
|
|
87
|
-
)
|
|
88
|
-
puts formatted
|
|
89
|
-
|
|
90
|
-
rescue Exa::NotFound => e
|
|
91
|
-
warn "Research task not found: #{e.message}"
|
|
92
|
-
exit 1
|
|
93
|
-
rescue Exa::Unauthorized => e
|
|
94
|
-
warn "Authentication failed: #{e.message}"
|
|
95
|
-
warn "Please provide a valid API key via --api-key or EXA_API_KEY environment variable"
|
|
96
|
-
exit 1
|
|
97
|
-
rescue Exa::ClientError => e
|
|
98
|
-
warn "Client error: #{e.message}"
|
|
99
|
-
exit 1
|
|
100
|
-
rescue Exa::ServerError => e
|
|
101
|
-
warn "Server error: #{e.message}"
|
|
102
|
-
exit 1
|
|
103
|
-
rescue Exa::Error => e
|
|
104
|
-
warn "Error: #{e.message}"
|
|
105
|
-
exit 1
|
|
106
|
-
rescue StandardError => e
|
|
107
|
-
warn "Unexpected error: #{e.message}"
|
|
108
|
-
exit 1
|
|
109
|
-
end
|
data/exe/exa-ai-research-start
DELETED
|
@@ -1,174 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env ruby
|
|
2
|
-
# frozen_string_literal: true
|
|
3
|
-
|
|
4
|
-
require "exa-ai"
|
|
5
|
-
|
|
6
|
-
# Parse command-line arguments
|
|
7
|
-
def parse_args(argv)
|
|
8
|
-
args = {
|
|
9
|
-
output_format: "json",
|
|
10
|
-
api_key: nil,
|
|
11
|
-
events: false,
|
|
12
|
-
wait: false
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
i = 0
|
|
16
|
-
while i < argv.length
|
|
17
|
-
arg = argv[i]
|
|
18
|
-
case arg
|
|
19
|
-
when "--instructions"
|
|
20
|
-
args[:instructions] = argv[i + 1]
|
|
21
|
-
i += 2
|
|
22
|
-
when "--model"
|
|
23
|
-
args[:model] = argv[i + 1]
|
|
24
|
-
i += 2
|
|
25
|
-
when "--output-schema"
|
|
26
|
-
args[:output_schema] = argv[i + 1]
|
|
27
|
-
i += 2
|
|
28
|
-
when "--wait"
|
|
29
|
-
args[:wait] = true
|
|
30
|
-
i += 1
|
|
31
|
-
when "--events"
|
|
32
|
-
args[:events] = true
|
|
33
|
-
i += 1
|
|
34
|
-
when "--api-key"
|
|
35
|
-
args[:api_key] = argv[i + 1]
|
|
36
|
-
i += 2
|
|
37
|
-
when "--output-format"
|
|
38
|
-
args[:output_format] = argv[i + 1]
|
|
39
|
-
i += 2
|
|
40
|
-
when "--help", "-h"
|
|
41
|
-
puts <<~HELP
|
|
42
|
-
Usage: exa-ai research-start --instructions "TEXT" [OPTIONS]
|
|
43
|
-
|
|
44
|
-
Start a research task using Exa AI
|
|
45
|
-
|
|
46
|
-
Options:
|
|
47
|
-
--instructions TEXT Research instructions (required)
|
|
48
|
-
--model MODEL Research model: exa-research (default), exa-research-pro, exa-research-fast
|
|
49
|
-
--output-schema JSON JSON schema string for structured output
|
|
50
|
-
--wait Wait for task to complete (polls until done)
|
|
51
|
-
--events Include event log in output (only with --wait)
|
|
52
|
-
--api-key KEY Exa API key (or set EXA_API_KEY env var)
|
|
53
|
-
--output-format FMT Output format: json, pretty, or text (default: json)
|
|
54
|
-
--help, -h Show this help message
|
|
55
|
-
|
|
56
|
-
Examples:
|
|
57
|
-
exa-ai research-start --instructions "Find Ruby performance tips"
|
|
58
|
-
exa-ai research-start --instructions "Analyze AI trends" --wait --events
|
|
59
|
-
exa-ai research-start --instructions "Summarize papers" --model exa-research-pro --wait
|
|
60
|
-
exa-ai research-start --instructions "Find stats" --output-schema '{"type":"object"}'
|
|
61
|
-
HELP
|
|
62
|
-
exit 0
|
|
63
|
-
else
|
|
64
|
-
i += 1
|
|
65
|
-
end
|
|
66
|
-
end
|
|
67
|
-
|
|
68
|
-
args
|
|
69
|
-
end
|
|
70
|
-
|
|
71
|
-
# Main execution
|
|
72
|
-
begin
|
|
73
|
-
args = parse_args(ARGV)
|
|
74
|
-
|
|
75
|
-
# Validate instructions
|
|
76
|
-
if args[:instructions].nil? || args[:instructions].empty?
|
|
77
|
-
$stderr.puts "Error: --instructions flag is required"
|
|
78
|
-
$stderr.puts "Run 'exa-ai research-start --help' for usage information"
|
|
79
|
-
exit 1
|
|
80
|
-
end
|
|
81
|
-
|
|
82
|
-
# Resolve API key
|
|
83
|
-
api_key = Exa::CLI::Base.resolve_api_key(args[:api_key])
|
|
84
|
-
|
|
85
|
-
# Resolve output format
|
|
86
|
-
output_format = Exa::CLI::Base.resolve_output_format(args[:output_format])
|
|
87
|
-
|
|
88
|
-
# Build client
|
|
89
|
-
client = Exa::CLI::Base.build_client(api_key)
|
|
90
|
-
|
|
91
|
-
# Prepare research parameters
|
|
92
|
-
research_params = { instructions: args[:instructions] }
|
|
93
|
-
research_params[:model] = args[:model] if args[:model]
|
|
94
|
-
|
|
95
|
-
# Parse output_schema as JSON if provided
|
|
96
|
-
if args[:output_schema]
|
|
97
|
-
begin
|
|
98
|
-
research_params[:output_schema] = JSON.parse(args[:output_schema])
|
|
99
|
-
rescue JSON::ParserError => e
|
|
100
|
-
$stderr.puts "Error: Invalid JSON in --output-schema: #{e.message}"
|
|
101
|
-
exit 1
|
|
102
|
-
end
|
|
103
|
-
end
|
|
104
|
-
|
|
105
|
-
# Start research task
|
|
106
|
-
task = client.research_start(**research_params)
|
|
107
|
-
|
|
108
|
-
# If --wait flag is set, poll until task completes
|
|
109
|
-
if args[:wait]
|
|
110
|
-
$stderr.print "Starting research task... "
|
|
111
|
-
|
|
112
|
-
begin
|
|
113
|
-
final_task = Exa::CLI::Polling.poll(max_duration: 300, initial_delay: 2, max_delay: 10) do
|
|
114
|
-
# Get current task status
|
|
115
|
-
current_task = client.research_get(task.research_id, events: args[:events])
|
|
116
|
-
|
|
117
|
-
# Show progress indicator
|
|
118
|
-
case current_task.status
|
|
119
|
-
when "pending"
|
|
120
|
-
$stderr.print "⏳"
|
|
121
|
-
when "running"
|
|
122
|
-
$stderr.print "⚙️"
|
|
123
|
-
end
|
|
124
|
-
|
|
125
|
-
# Check if done
|
|
126
|
-
done = current_task.finished?
|
|
127
|
-
|
|
128
|
-
{ done: done, result: current_task, status: current_task.status }
|
|
129
|
-
end
|
|
130
|
-
|
|
131
|
-
$stderr.puts " #{final_task.status.upcase}"
|
|
132
|
-
|
|
133
|
-
# Format and output final result
|
|
134
|
-
output = Exa::CLI::Formatters::ResearchFormatter.format_task(final_task, output_format, show_events: args[:events])
|
|
135
|
-
puts output
|
|
136
|
-
$stdout.flush
|
|
137
|
-
|
|
138
|
-
# Exit with error code if task failed
|
|
139
|
-
exit 1 if final_task.failed?
|
|
140
|
-
|
|
141
|
-
rescue Exa::CLI::Polling::TimeoutError => e
|
|
142
|
-
$stderr.puts "\nError: Task did not complete within timeout period (5 minutes)"
|
|
143
|
-
$stderr.puts "Task ID: #{task.research_id}"
|
|
144
|
-
$stderr.puts "You can check the status later with: exa-ai research-get #{task.research_id}"
|
|
145
|
-
exit 1
|
|
146
|
-
end
|
|
147
|
-
else
|
|
148
|
-
# Just return the initial task (with status "pending")
|
|
149
|
-
output = Exa::CLI::Formatters::ResearchFormatter.format_task(task, output_format, show_events: false)
|
|
150
|
-
puts output
|
|
151
|
-
end
|
|
152
|
-
|
|
153
|
-
rescue Exa::ConfigurationError => e
|
|
154
|
-
$stderr.puts "Configuration error: #{e.message}"
|
|
155
|
-
exit 1
|
|
156
|
-
rescue Exa::Unauthorized => e
|
|
157
|
-
$stderr.puts "Authentication error: #{e.message}"
|
|
158
|
-
$stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
|
|
159
|
-
exit 1
|
|
160
|
-
rescue Exa::ClientError => e
|
|
161
|
-
$stderr.puts "Client error: #{e.message}"
|
|
162
|
-
exit 1
|
|
163
|
-
rescue Exa::ServerError => e
|
|
164
|
-
$stderr.puts "Server error: #{e.message}"
|
|
165
|
-
$stderr.puts "The Exa API may be experiencing issues. Please try again later."
|
|
166
|
-
exit 1
|
|
167
|
-
rescue Exa::Error => e
|
|
168
|
-
$stderr.puts "Error: #{e.message}"
|
|
169
|
-
exit 1
|
|
170
|
-
rescue StandardError => e
|
|
171
|
-
$stderr.puts "Unexpected error: #{e.message}"
|
|
172
|
-
$stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
|
|
173
|
-
exit 1
|
|
174
|
-
end
|
data/exe/exa-ai-webset-cancel
DELETED
|
@@ -1,97 +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-cancel <webset_id> [OPTIONS]
|
|
22
|
-
|
|
23
|
-
Cancel a running webset
|
|
24
|
-
|
|
25
|
-
Arguments:
|
|
26
|
-
webset_id ID of the webset to cancel (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-cancel ws_abc123
|
|
35
|
-
exa-ai webset-cancel 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-cancel <webset_id> [OPTIONS]"
|
|
53
|
-
$stderr.puts "Try 'exa-ai webset-cancel --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
|
-
# Cancel webset
|
|
66
|
-
webset = client.cancel_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::ConfigurationError => e
|
|
77
|
-
$stderr.puts "Configuration error: #{e.message}"
|
|
78
|
-
exit 1
|
|
79
|
-
rescue Exa::Unauthorized => e
|
|
80
|
-
$stderr.puts "Authentication error: #{e.message}"
|
|
81
|
-
$stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
|
|
82
|
-
exit 1
|
|
83
|
-
rescue Exa::ClientError => e
|
|
84
|
-
$stderr.puts "Client error: #{e.message}"
|
|
85
|
-
exit 1
|
|
86
|
-
rescue Exa::ServerError => e
|
|
87
|
-
$stderr.puts "Server error: #{e.message}"
|
|
88
|
-
$stderr.puts "The Exa API may be experiencing issues. Please try again later."
|
|
89
|
-
exit 1
|
|
90
|
-
rescue Exa::Error => e
|
|
91
|
-
$stderr.puts "Error: #{e.message}"
|
|
92
|
-
exit 1
|
|
93
|
-
rescue StandardError => e
|
|
94
|
-
$stderr.puts "Unexpected error: #{e.message}"
|
|
95
|
-
$stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
|
|
96
|
-
exit 1
|
|
97
|
-
end
|
data/exe/exa-ai-webset-create
DELETED
|
@@ -1,254 +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
|
-
wait: false
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
i = 0
|
|
46
|
-
while i < argv.length
|
|
47
|
-
arg = argv[i]
|
|
48
|
-
case arg
|
|
49
|
-
when "--import"
|
|
50
|
-
args[:import] = argv[i + 1]
|
|
51
|
-
i += 2
|
|
52
|
-
when "--search"
|
|
53
|
-
args[:search] = parse_json_or_file(argv[i + 1])
|
|
54
|
-
i += 2
|
|
55
|
-
when "--enrichments"
|
|
56
|
-
args[:enrichments] = parse_json_or_file(argv[i + 1])
|
|
57
|
-
i += 2
|
|
58
|
-
when "--exclude"
|
|
59
|
-
args[:exclude] = parse_json_or_file(argv[i + 1])
|
|
60
|
-
i += 2
|
|
61
|
-
when "--external-id"
|
|
62
|
-
args[:external_id] = argv[i + 1]
|
|
63
|
-
i += 2
|
|
64
|
-
when "--title"
|
|
65
|
-
args[:title] = argv[i + 1]
|
|
66
|
-
i += 2
|
|
67
|
-
when "--metadata"
|
|
68
|
-
args[:metadata] = parse_json_or_file(argv[i + 1])
|
|
69
|
-
i += 2
|
|
70
|
-
when "--wait"
|
|
71
|
-
args[:wait] = true
|
|
72
|
-
i += 1
|
|
73
|
-
when "--api-key"
|
|
74
|
-
args[:api_key] = argv[i + 1]
|
|
75
|
-
i += 2
|
|
76
|
-
when "--output-format"
|
|
77
|
-
args[:output_format] = argv[i + 1]
|
|
78
|
-
i += 2
|
|
79
|
-
when "--help", "-h"
|
|
80
|
-
puts <<~HELP
|
|
81
|
-
Usage: exa-ai webset-create (--search JSON | --import ID) [OPTIONS]
|
|
82
|
-
|
|
83
|
-
Create a new webset from search criteria or an import
|
|
84
|
-
|
|
85
|
-
Required (choose one):
|
|
86
|
-
--search JSON Search configuration as JSON (supports @file.json)
|
|
87
|
-
Format: {"query":"...","count":10,"scope":[...]}
|
|
88
|
-
The 'scope' field limits search to specific sources
|
|
89
|
-
--import ID Import/webset ID to attach data to this webset
|
|
90
|
-
(loads data but does NOT filter searches)
|
|
91
|
-
Format: import_abc123 or webset_xyz789
|
|
92
|
-
|
|
93
|
-
Options:
|
|
94
|
-
--enrichments JSON Array of enrichment configs (supports @file.json)
|
|
95
|
-
Format: [{"description":"...","format":"text"}]
|
|
96
|
-
--exclude JSON Sources to exclude from searches (supports @file.json)
|
|
97
|
-
Format: [{"source":"import|webset","id":"..."}]
|
|
98
|
-
--external-id ID External identifier for the webset
|
|
99
|
-
--title TITLE Title for the webset
|
|
100
|
-
--metadata JSON Custom metadata (supports @file.json)
|
|
101
|
-
Format: {"key":"value"}
|
|
102
|
-
--wait Wait for webset to reach idle status
|
|
103
|
-
--api-key KEY Exa API key (or set EXA_API_KEY env var)
|
|
104
|
-
--output-format FMT Output format: json, pretty, or text (default: json)
|
|
105
|
-
--help, -h Show this help message
|
|
106
|
-
|
|
107
|
-
JSON Format Details:
|
|
108
|
-
search.scope Array of source references to limit search
|
|
109
|
-
Format: [{"source":"import|webset","id":"..."}]
|
|
110
|
-
With relationship (hop search):
|
|
111
|
-
[{"source":"webset","id":"ws_123",
|
|
112
|
-
"relationship":{"definition":"investors of","limit":3}}]
|
|
113
|
-
|
|
114
|
-
IMPORTANT: Cannot use the same import ID in both --import and search.scope
|
|
115
|
-
(this will return a 400 error from the API)
|
|
116
|
-
|
|
117
|
-
Examples:
|
|
118
|
-
# Create webset from search
|
|
119
|
-
exa-ai webset-create --search '{"query":"AI startups","count":10}'
|
|
120
|
-
exa-ai webset-create --search @search.json --enrichments @enrichments.json
|
|
121
|
-
exa-ai webset-create --search @search.json --wait
|
|
122
|
-
|
|
123
|
-
# Create webset with scoped search (filter to specific import)
|
|
124
|
-
exa-ai webset-create --search '{"query":"CEOs","count":10,"scope":[{"source":"import","id":"import_abc"}]}'
|
|
125
|
-
|
|
126
|
-
# Create webset from import
|
|
127
|
-
exa-ai webset-create --import import_abc123
|
|
128
|
-
exa-ai webset-create --import import_def456 --enrichments @enrichments.json
|
|
129
|
-
|
|
130
|
-
# Load import AND run search (search not scoped to import)
|
|
131
|
-
exa-ai webset-create --import import_abc123 --search '{"query":"investors","count":20}'
|
|
132
|
-
HELP
|
|
133
|
-
exit 0
|
|
134
|
-
else
|
|
135
|
-
$stderr.puts "Unknown option: #{arg}"
|
|
136
|
-
exit 1
|
|
137
|
-
end
|
|
138
|
-
end
|
|
139
|
-
|
|
140
|
-
args
|
|
141
|
-
end
|
|
142
|
-
|
|
143
|
-
# Main execution
|
|
144
|
-
begin
|
|
145
|
-
args = parse_args(ARGV)
|
|
146
|
-
|
|
147
|
-
# Validate required parameters
|
|
148
|
-
if args[:search] && args[:import]
|
|
149
|
-
$stderr.puts "Error: Cannot specify both --search and --import"
|
|
150
|
-
$stderr.puts "Run 'exa-ai webset-create --help' for usage information"
|
|
151
|
-
exit 1
|
|
152
|
-
end
|
|
153
|
-
|
|
154
|
-
unless args[:search] || args[:import]
|
|
155
|
-
$stderr.puts "Error: Either --search or --import is required"
|
|
156
|
-
$stderr.puts "Run 'exa-ai webset-create --help' for usage information"
|
|
157
|
-
exit 1
|
|
158
|
-
end
|
|
159
|
-
|
|
160
|
-
# Resolve API key
|
|
161
|
-
api_key = Exa::CLI::Base.resolve_api_key(args[:api_key])
|
|
162
|
-
|
|
163
|
-
# Resolve output format
|
|
164
|
-
output_format = Exa::CLI::Base.resolve_output_format(args[:output_format])
|
|
165
|
-
|
|
166
|
-
# Build client
|
|
167
|
-
client = Exa::CLI::Base.build_client(api_key)
|
|
168
|
-
|
|
169
|
-
# Prepare webset parameters
|
|
170
|
-
webset_params = {}
|
|
171
|
-
|
|
172
|
-
if args[:search]
|
|
173
|
-
webset_params[:search] = args[:search]
|
|
174
|
-
elsif args[:import]
|
|
175
|
-
# Detect source type from ID prefix and convert to API format
|
|
176
|
-
import_id = args[:import]
|
|
177
|
-
source = if import_id.start_with?("import_")
|
|
178
|
-
"import"
|
|
179
|
-
elsif import_id.start_with?("webset_")
|
|
180
|
-
"webset"
|
|
181
|
-
else
|
|
182
|
-
$stderr.puts "Error: Import ID must start with 'import_' or 'webset_'"
|
|
183
|
-
exit 1
|
|
184
|
-
end
|
|
185
|
-
|
|
186
|
-
webset_params[:import] = [{ source: source, id: import_id }]
|
|
187
|
-
end
|
|
188
|
-
|
|
189
|
-
webset_params[:enrichments] = args[:enrichments] if args[:enrichments]
|
|
190
|
-
webset_params[:exclude] = args[:exclude] if args[:exclude]
|
|
191
|
-
webset_params[:externalId] = args[:external_id] if args[:external_id]
|
|
192
|
-
webset_params[:title] = args[:title] if args[:title]
|
|
193
|
-
webset_params[:metadata] = args[:metadata] if args[:metadata]
|
|
194
|
-
|
|
195
|
-
# Create webset
|
|
196
|
-
webset = client.create_webset(**webset_params)
|
|
197
|
-
|
|
198
|
-
# If --wait flag is set, poll until webset is idle
|
|
199
|
-
if args[:wait]
|
|
200
|
-
$stderr.print "Creating webset... "
|
|
201
|
-
|
|
202
|
-
begin
|
|
203
|
-
final_webset = Exa::CLI::Polling.poll(max_duration: 300, initial_delay: 2, max_delay: 10) do
|
|
204
|
-
current_webset = client.get_webset(webset.id)
|
|
205
|
-
|
|
206
|
-
# Show progress indicator
|
|
207
|
-
case current_webset.status
|
|
208
|
-
when "pending"
|
|
209
|
-
$stderr.print "⏳"
|
|
210
|
-
when "running"
|
|
211
|
-
$stderr.print "⚙️"
|
|
212
|
-
end
|
|
213
|
-
|
|
214
|
-
done = current_webset.idle?
|
|
215
|
-
{ done: done, result: current_webset, status: current_webset.status }
|
|
216
|
-
end
|
|
217
|
-
|
|
218
|
-
$stderr.puts " #{final_webset.status.upcase}"
|
|
219
|
-
webset = final_webset
|
|
220
|
-
|
|
221
|
-
rescue Exa::CLI::Polling::TimeoutError
|
|
222
|
-
$stderr.puts "\nWarning: Webset creation did not complete within timeout"
|
|
223
|
-
$stderr.puts "Webset ID: #{webset.id}"
|
|
224
|
-
$stderr.puts "Check status with: exa-ai webset-get #{webset.id}"
|
|
225
|
-
end
|
|
226
|
-
end
|
|
227
|
-
|
|
228
|
-
# Format and output result
|
|
229
|
-
output = Exa::CLI::Formatters::WebsetFormatter.format(webset, output_format)
|
|
230
|
-
puts output
|
|
231
|
-
$stdout.flush
|
|
232
|
-
|
|
233
|
-
rescue Exa::ConfigurationError => e
|
|
234
|
-
$stderr.puts "Configuration error: #{e.message}"
|
|
235
|
-
exit 1
|
|
236
|
-
rescue Exa::Unauthorized => e
|
|
237
|
-
$stderr.puts "Authentication error: #{e.message}"
|
|
238
|
-
$stderr.puts "Check your API key (set EXA_API_KEY or use --api-key)"
|
|
239
|
-
exit 1
|
|
240
|
-
rescue Exa::ClientError => e
|
|
241
|
-
$stderr.puts "Client error: #{e.message}"
|
|
242
|
-
exit 1
|
|
243
|
-
rescue Exa::ServerError => e
|
|
244
|
-
$stderr.puts "Server error: #{e.message}"
|
|
245
|
-
$stderr.puts "The Exa API may be experiencing issues. Please try again later."
|
|
246
|
-
exit 1
|
|
247
|
-
rescue Exa::Error => e
|
|
248
|
-
$stderr.puts "Error: #{e.message}"
|
|
249
|
-
exit 1
|
|
250
|
-
rescue StandardError => e
|
|
251
|
-
$stderr.puts "Unexpected error: #{e.message}"
|
|
252
|
-
$stderr.puts e.backtrace.first(5) if ENV["DEBUG"]
|
|
253
|
-
exit 1
|
|
254
|
-
end
|