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
@@ -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