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
|
@@ -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
|
data/exe/exa-ai-webset-update
DELETED
|
@@ -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
|