aspera-cli 4.27.5 → 4.29.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 (249) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/BUGS.md +5 -10
  4. data/CHANGELOG.md +301 -4
  5. data/CODE_OF_CONDUCT.md +18 -0
  6. data/CONTRIBUTING.md +139 -58
  7. data/GOVERNANCE.md +30 -0
  8. data/LICENSE +201 -0
  9. data/README.md +103 -26
  10. data/SECURITY.md +70 -0
  11. data/bin/ascli +8 -5
  12. data/bin/asession +10 -7
  13. data/docs/README.md +2551 -772
  14. data/docs/test-mcp-with-ai.md +13 -11
  15. data/lib/aspera/agent/base.rb +23 -2
  16. data/lib/aspera/agent/connect.rb +16 -12
  17. data/lib/aspera/agent/desktop.rb +10 -7
  18. data/lib/aspera/agent/direct.rb +34 -22
  19. data/lib/aspera/agent/factory.rb +8 -4
  20. data/lib/aspera/agent/httpgw.rb +7 -5
  21. data/lib/aspera/agent/node.rb +15 -7
  22. data/lib/aspera/agent/transferd.rb +167 -43
  23. data/lib/aspera/api/alee.rb +4 -1
  24. data/lib/aspera/api/aoc.rb +14 -11
  25. data/lib/aspera/api/ats.rb +4 -2
  26. data/lib/aspera/api/cos_node.rb +8 -5
  27. data/lib/aspera/api/faspex.rb +16 -9
  28. data/lib/aspera/api/httpgw.rb +9 -6
  29. data/lib/aspera/api/node.rb +23 -19
  30. data/lib/aspera/ascmd.rb +8 -5
  31. data/lib/aspera/ascp/installation.rb +84 -42
  32. data/lib/aspera/ascp/log.schema.yaml +1084 -0
  33. data/lib/aspera/ascp/log_analyzer/advice.rb +97 -0
  34. data/lib/aspera/ascp/log_analyzer/diagnostics.rb +344 -0
  35. data/lib/aspera/ascp/log_analyzer/lines.rb +75 -0
  36. data/lib/aspera/ascp/log_analyzer/log_file.rb +593 -0
  37. data/lib/aspera/ascp/log_analyzer/records.rb +379 -0
  38. data/lib/aspera/ascp/log_analyzer/rules.rb +172 -0
  39. data/lib/aspera/ascp/log_analyzer/session.rb +782 -0
  40. data/lib/aspera/ascp/log_analyzer.rb +354 -0
  41. data/lib/aspera/ascp/management.rb +102 -48
  42. data/lib/aspera/ascp/session_errors.rb +217 -0
  43. data/lib/aspera/assert.rb +4 -0
  44. data/lib/aspera/cli/ascp_actions.rb +16 -37
  45. data/lib/aspera/cli/ascp_logs_actions.rb +176 -0
  46. data/lib/aspera/cli/async_transfer_store.rb +7 -4
  47. data/lib/aspera/cli/bootstrapper.rb +37 -34
  48. data/lib/aspera/cli/command_line.rb +24 -6
  49. data/lib/aspera/cli/command_registry.rb +49 -4
  50. data/lib/aspera/cli/command_spec.rb +34 -4
  51. data/lib/aspera/cli/completion/ascli.bash +53 -5
  52. data/lib/aspera/cli/completion/ascli.fish +27 -8
  53. data/lib/aspera/cli/completion/ascli.ps1 +63 -0
  54. data/lib/aspera/cli/completion/ascli.zsh +36 -4
  55. data/lib/aspera/cli/completion_actions.rb +594 -0
  56. data/lib/aspera/cli/context.rb +9 -4
  57. data/lib/aspera/cli/deprecation.rb +5 -2
  58. data/lib/aspera/cli/error.rb +45 -0
  59. data/lib/aspera/cli/extended_value.rb +83 -24
  60. data/lib/aspera/cli/formatter.rb +142 -73
  61. data/lib/aspera/cli/gem_checker.rb +9 -6
  62. data/lib/aspera/cli/hints.rb +22 -11
  63. data/lib/aspera/cli/http.rb +17 -13
  64. data/lib/aspera/cli/info.rb +17 -6
  65. data/lib/aspera/cli/mailer.rb +7 -4
  66. data/lib/aspera/cli/mcp/http_servlet.rb +155 -0
  67. data/lib/aspera/cli/mcp/secrets.rb +146 -0
  68. data/lib/aspera/cli/mcp/tool.rb +232 -0
  69. data/lib/aspera/cli/option_declarator.rb +10 -4
  70. data/lib/aspera/cli/option_registry.rb +6 -3
  71. data/lib/aspera/cli/option_types.rb +17 -2
  72. data/lib/aspera/cli/option_value.rb +72 -11
  73. data/lib/aspera/cli/options.schema.yaml +856 -81
  74. data/lib/aspera/cli/parser.rb +64 -31
  75. data/lib/aspera/cli/plugins/alee.rb +7 -4
  76. data/lib/aspera/cli/plugins/aoc.rb +250 -44
  77. data/lib/aspera/cli/plugins/ats.rb +9 -8
  78. data/lib/aspera/cli/plugins/base.rb +51 -25
  79. data/lib/aspera/cli/plugins/basic_auth.rb +5 -2
  80. data/lib/aspera/cli/plugins/config.rb +207 -141
  81. data/lib/aspera/cli/plugins/console.rb +9 -4
  82. data/lib/aspera/cli/plugins/cos.rb +8 -4
  83. data/lib/aspera/cli/plugins/factory.rb +22 -8
  84. data/lib/aspera/cli/plugins/faspex5.rb +37 -44
  85. data/lib/aspera/cli/plugins/faspio.rb +41 -8
  86. data/lib/aspera/cli/plugins/httpgw.rb +8 -4
  87. data/lib/aspera/cli/plugins/mcp.rb +186 -121
  88. data/lib/aspera/cli/plugins/node.rb +41 -34
  89. data/lib/aspera/cli/plugins/oauth.rb +5 -1
  90. data/lib/aspera/cli/plugins/orchestrator.rb +572 -59
  91. data/lib/aspera/cli/plugins/preview.rb +69 -44
  92. data/lib/aspera/cli/plugins/server.rb +66 -12
  93. data/lib/aspera/cli/plugins/shares.rb +288 -48
  94. data/lib/aspera/cli/plugins/transferd.rb +223 -0
  95. data/lib/aspera/cli/preset_actions.rb +155 -33
  96. data/lib/aspera/cli/preset_manager.rb +72 -16
  97. data/lib/aspera/cli/prompt.rb +7 -2
  98. data/lib/aspera/cli/result.rb +28 -11
  99. data/lib/aspera/cli/runner.rb +193 -80
  100. data/lib/aspera/cli/secret_finder.rb +4 -1
  101. data/lib/aspera/cli/security.rb +204 -0
  102. data/lib/aspera/cli/special_values.rb +4 -1
  103. data/lib/aspera/cli/sync_actions.rb +13 -10
  104. data/lib/aspera/cli/table_fitter.rb +119 -0
  105. data/lib/aspera/cli/terminal_formatter.rb +32 -40
  106. data/lib/aspera/cli/transfer_actions.rb +11 -8
  107. data/lib/aspera/cli/transfer_agent.rb +31 -19
  108. data/lib/aspera/cli/transfer_progress.rb +13 -45
  109. data/lib/aspera/cli/vault_actions.rb +45 -0
  110. data/lib/aspera/cli/vault_manager.rb +197 -50
  111. data/lib/aspera/cli/version.rb +4 -1
  112. data/lib/aspera/cli/web_secret.html.erb +61 -0
  113. data/lib/aspera/cli/web_secret.rb +222 -0
  114. data/lib/aspera/cli/wizard.rb +58 -45
  115. data/lib/aspera/command_line_builder.rb +35 -5
  116. data/lib/aspera/command_line_converter.rb +4 -1
  117. data/lib/aspera/coverage.rb +103 -33
  118. data/lib/aspera/data_repository.rb +42 -25
  119. data/lib/aspera/dot_container.rb +4 -1
  120. data/lib/aspera/duration.rb +45 -0
  121. data/lib/aspera/environment.rb +106 -33
  122. data/lib/aspera/exec_spec.rb +9 -5
  123. data/lib/aspera/faspex_gw.rb +105 -35
  124. data/lib/aspera/faspex_postproc.rb +193 -47
  125. data/lib/aspera/formatter_interface.rb +4 -2
  126. data/lib/aspera/graphql.rb +5 -1
  127. data/lib/aspera/hash_ext.rb +3 -0
  128. data/lib/aspera/id_generator.rb +6 -3
  129. data/lib/aspera/json_rpc/client.rb +55 -35
  130. data/lib/aspera/json_rpc/version.rb +4 -0
  131. data/lib/aspera/line_logger.rb +4 -1
  132. data/lib/aspera/link_header.rb +4 -1
  133. data/lib/aspera/log.rb +20 -10
  134. data/lib/aspera/markdown.rb +155 -115
  135. data/lib/aspera/mime.rb +9 -0
  136. data/lib/aspera/nagios.rb +9 -5
  137. data/lib/aspera/node_emulator.rb +111 -112
  138. data/lib/aspera/oauth/client/base.rb +163 -0
  139. data/lib/aspera/oauth/{boot.rb → client/boot.rb} +8 -4
  140. data/lib/aspera/oauth/{factory.rb → client/factory.rb} +13 -3
  141. data/lib/aspera/oauth/{generic.rb → client/generic.rb} +5 -1
  142. data/lib/aspera/oauth/{json_credentials.rb → client/json_credentials.rb} +4 -1
  143. data/lib/aspera/oauth/{jwt.rb → client/jwt.rb} +6 -3
  144. data/lib/aspera/oauth/client/shares_web.rb +85 -0
  145. data/lib/aspera/oauth/{url_json.rb → client/url_json.rb} +4 -1
  146. data/lib/aspera/oauth/client/web.rb +84 -0
  147. data/lib/aspera/oauth/server/authorize.html.erb +34 -0
  148. data/lib/aspera/oauth/server/pkce.rb +427 -0
  149. data/lib/aspera/orchestrator_workflow_checker.rb +679 -0
  150. data/lib/aspera/persistency_action_once.rb +5 -3
  151. data/lib/aspera/persistency_folder.rb +6 -3
  152. data/lib/aspera/preview/file_types.rb +6 -3
  153. data/lib/aspera/preview/generator.rb +9 -5
  154. data/lib/aspera/preview/options.schema.yaml +3 -3
  155. data/lib/aspera/preview/terminal.rb +11 -6
  156. data/lib/aspera/preview/utils.rb +6 -4
  157. data/lib/aspera/products/connect.rb +5 -2
  158. data/lib/aspera/products/desktop.rb +4 -1
  159. data/lib/aspera/products/other.rb +4 -2
  160. data/lib/aspera/products/transferd.rb +6 -2
  161. data/lib/aspera/products/transferd_service.rb +610 -0
  162. data/lib/aspera/proxy_auto_config.js +2 -2
  163. data/lib/aspera/proxy_auto_config.rb +5 -2
  164. data/lib/aspera/rainbow.rb +30 -1
  165. data/lib/aspera/rest/aspera_errors.rb +55 -60
  166. data/lib/aspera/rest/call_error.rb +3 -0
  167. data/lib/aspera/rest/client.rb +42 -42
  168. data/lib/aspera/rest/error_analyzer.rb +14 -2
  169. data/lib/aspera/rest/list.rb +14 -10
  170. data/lib/aspera/rest/parameters.rb +3 -0
  171. data/lib/aspera/rest/util.rb +13 -4
  172. data/lib/aspera/rest.rb +9 -7
  173. data/lib/aspera/schema/IBM Aspera Faspex API-5.0-enhanced.yaml +9 -11
  174. data/lib/aspera/schema/IBM Aspera Orchestrator API-v1-enhanced.yaml +4089 -0
  175. data/lib/aspera/schema/IBM Aspera faspio Gateway API-1.0.0-enhanced.yaml +1097 -0
  176. data/lib/aspera/schema/IBM Aspera on Cloud API-0.2.6-enhanced.yaml +11 -11
  177. data/lib/aspera/schema/IBM Aspera on Cloud Automation API-1.0.5-enhanced.yaml +2437 -1437
  178. data/lib/aspera/schema/IBM_Aspera_Shares.yaml +819 -7
  179. data/lib/aspera/schema/async_tables.yaml +11 -10
  180. data/lib/aspera/schema/documentation.rb +56 -78
  181. data/lib/aspera/schema/reader.rb +46 -11
  182. data/lib/aspera/schema/registry.rb +45 -24
  183. data/lib/aspera/schema/transferd-config.schema.json +333 -0
  184. data/lib/aspera/schema/validator.rb +4 -1
  185. data/lib/aspera/sealed_hash.rb +166 -0
  186. data/lib/aspera/secret/hider.rb +201 -0
  187. data/lib/aspera/secret/reference.rb +150 -0
  188. data/lib/aspera/secret/resolver.rb +212 -0
  189. data/lib/aspera/secret/store/base.rb +153 -0
  190. data/lib/aspera/secret/store/encrypted_hash.rb +329 -0
  191. data/lib/aspera/secret/store/factory.rb +103 -0
  192. data/lib/aspera/secret/store/hashicorp_vault.rb +390 -0
  193. data/lib/aspera/secret/store/keeper.rb +141 -0
  194. data/lib/aspera/secret/store/macos_security.rb +284 -0
  195. data/lib/aspera/secret/store/one_password_api.rb +99 -0
  196. data/lib/aspera/secret/store/one_password_base.rb +42 -0
  197. data/lib/aspera/secret/store/one_password_cli.rb +110 -0
  198. data/lib/aspera/secret/store/secret_service.rb +125 -0
  199. data/lib/aspera/secret/strength.rb +119 -0
  200. data/lib/aspera/servlet_helpers.rb +114 -0
  201. data/lib/aspera/ssh.rb +10 -7
  202. data/lib/aspera/ssl.rb +5 -2
  203. data/lib/aspera/string_ext.rb +3 -0
  204. data/lib/aspera/sync/args.schema.yaml +6 -1
  205. data/lib/aspera/sync/conf.schema.yaml +25 -10
  206. data/lib/aspera/sync/database.rb +3 -0
  207. data/lib/aspera/sync/operations.rb +34 -12
  208. data/lib/aspera/temp_file_manager.rb +85 -22
  209. data/lib/aspera/timer_limiter.rb +3 -0
  210. data/lib/aspera/transfer/error.rb +4 -1
  211. data/lib/aspera/transfer/faux_file.rb +4 -1
  212. data/lib/aspera/transfer/parameters.rb +22 -14
  213. data/lib/aspera/transfer/result.rb +3 -0
  214. data/lib/aspera/transfer/resumer.rb +6 -4
  215. data/lib/aspera/transfer/spec.rb +45 -18
  216. data/lib/aspera/transfer/spec.schema.yaml +8 -5
  217. data/lib/aspera/transfer/units.rb +75 -0
  218. data/lib/aspera/uri_reader.rb +57 -7
  219. data/lib/aspera/web_auth/index.html.erb +20 -0
  220. data/lib/aspera/web_auth/paste.rb +109 -0
  221. data/lib/aspera/web_auth/receiver.rb +50 -0
  222. data/lib/aspera/web_auth/relay.rb +76 -0
  223. data/lib/aspera/web_auth/reply.html.erb +150 -0
  224. data/lib/aspera/web_auth/server.rb +59 -14
  225. data/lib/aspera/web_page.html.erb +262 -0
  226. data/lib/aspera/web_page.rb +66 -0
  227. data/lib/aspera/web_server_simple.rb +82 -13
  228. data/lib/aspera/yaml.rb +5 -1
  229. data/llms.txt +81 -0
  230. data/skills/ascli/SKILL.md +88 -0
  231. data.tar.gz.sig +0 -0
  232. metadata +116 -48
  233. metadata.gz.sig +0 -0
  234. data/lib/aspera/cli/mcp_tool.rb +0 -189
  235. data/lib/aspera/keychain/base.rb +0 -25
  236. data/lib/aspera/keychain/encrypted_hash.rb +0 -188
  237. data/lib/aspera/keychain/factory.rb +0 -59
  238. data/lib/aspera/keychain/hashicorp_vault.rb +0 -74
  239. data/lib/aspera/keychain/macos_security.rb +0 -171
  240. data/lib/aspera/keychain/one_password_api.rb +0 -86
  241. data/lib/aspera/keychain/one_password_base.rb +0 -34
  242. data/lib/aspera/keychain/one_password_cli.rb +0 -98
  243. data/lib/aspera/oauth/base.rb +0 -141
  244. data/lib/aspera/oauth/web.rb +0 -57
  245. data/lib/aspera/oauth.rb +0 -9
  246. data/lib/aspera/schema/IBM Aspera Orchestrator API-v1.yaml +0 -1784
  247. data/lib/aspera/schema/IBM Aspera faspio Gateway API-1.0.0.yaml +0 -249
  248. data/lib/aspera/secret_hider.rb +0 -117
  249. data/lib/aspera/web_auth/index.html +0 -147
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aspera-cli
3
3
  version: !ruby/object:Gem::Version
4
- version: 4.27.5
4
+ version: 4.29.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Laurent Martin
@@ -39,19 +39,19 @@ cert_chain:
39
39
  date: 1980-01-02 00:00:00.000000000 Z
40
40
  dependencies:
41
41
  - !ruby/object:Gem::Dependency
42
- name: blankslate
42
+ name: base64
43
43
  requirement: !ruby/object:Gem::Requirement
44
44
  requirements:
45
45
  - - "~>"
46
46
  - !ruby/object:Gem::Version
47
- version: '3.1'
47
+ version: '0.3'
48
48
  type: :runtime
49
49
  prerelease: false
50
50
  version_requirements: !ruby/object:Gem::Requirement
51
51
  requirements:
52
52
  - - "~>"
53
53
  - !ruby/object:Gem::Version
54
- version: '3.1'
54
+ version: '0.3'
55
55
  - !ruby/object:Gem::Dependency
56
56
  name: chunky_png
57
57
  requirement: !ruby/object:Gem::Requirement
@@ -94,6 +94,20 @@ dependencies:
94
94
  - - "~>"
95
95
  - !ruby/object:Gem::Version
96
96
  version: '2.0'
97
+ - !ruby/object:Gem::Dependency
98
+ name: jmespath
99
+ requirement: !ruby/object:Gem::Requirement
100
+ requirements:
101
+ - - "~>"
102
+ - !ruby/object:Gem::Version
103
+ version: '1.6'
104
+ type: :runtime
105
+ prerelease: false
106
+ version_requirements: !ruby/object:Gem::Requirement
107
+ requirements:
108
+ - - "~>"
109
+ - !ruby/object:Gem::Version
110
+ version: '1.6'
97
111
  - !ruby/object:Gem::Dependency
98
112
  name: json_schemer
99
113
  requirement: !ruby/object:Gem::Requirement
@@ -128,14 +142,14 @@ dependencies:
128
142
  requirements:
129
143
  - - "~>"
130
144
  - !ruby/object:Gem::Version
131
- version: '1.1'
145
+ version: '2.1'
132
146
  type: :runtime
133
147
  prerelease: false
134
148
  version_requirements: !ruby/object:Gem::Requirement
135
149
  requirements:
136
150
  - - "~>"
137
151
  - !ruby/object:Gem::Version
138
- version: '1.1'
152
+ version: '2.1'
139
153
  - !ruby/object:Gem::Dependency
140
154
  name: mime-types
141
155
  requirement: !ruby/object:Gem::Requirement
@@ -170,14 +184,14 @@ dependencies:
170
184
  requirements:
171
185
  - - "~>"
172
186
  - !ruby/object:Gem::Version
173
- version: '7.3'
187
+ version: '8.1'
174
188
  type: :runtime
175
189
  prerelease: false
176
190
  version_requirements: !ruby/object:Gem::Requirement
177
191
  requirements:
178
192
  - - "~>"
179
193
  - !ruby/object:Gem::Version
180
- version: '7.3'
194
+ version: '8.1'
181
195
  - !ruby/object:Gem::Dependency
182
196
  name: rainbow
183
197
  requirement: !ruby/object:Gem::Requirement
@@ -192,6 +206,20 @@ dependencies:
192
206
  - - "~>"
193
207
  - !ruby/object:Gem::Version
194
208
  version: '3.0'
209
+ - !ruby/object:Gem::Dependency
210
+ name: regexp_parser
211
+ requirement: !ruby/object:Gem::Requirement
212
+ requirements:
213
+ - - "!="
214
+ - !ruby/object:Gem::Version
215
+ version: 2.13.2
216
+ type: :runtime
217
+ prerelease: false
218
+ version_requirements: !ruby/object:Gem::Requirement
219
+ requirements:
220
+ - - "!="
221
+ - !ruby/object:Gem::Version
222
+ version: 2.13.2
195
223
  - !ruby/object:Gem::Dependency
196
224
  name: ruby-progressbar
197
225
  requirement: !ruby/object:Gem::Requirement
@@ -290,20 +318,6 @@ dependencies:
290
318
  - - "~>"
291
319
  - !ruby/object:Gem::Version
292
320
  version: '1.2'
293
- - !ruby/object:Gem::Dependency
294
- name: word_wrap
295
- requirement: !ruby/object:Gem::Requirement
296
- requirements:
297
- - - "~>"
298
- - !ruby/object:Gem::Version
299
- version: '1.0'
300
- type: :runtime
301
- prerelease: false
302
- version_requirements: !ruby/object:Gem::Requirement
303
- requirements:
304
- - - "~>"
305
- - !ruby/object:Gem::Version
306
- version: '1.0'
307
321
  - !ruby/object:Gem::Dependency
308
322
  name: xml-simple
309
323
  requirement: !ruby/object:Gem::Requirement
@@ -318,7 +332,13 @@ dependencies:
318
332
  - - "~>"
319
333
  - !ruby/object:Gem::Version
320
334
  version: '1.0'
321
- description: Command line interface for IBM Aspera products
335
+ description: 'Open-source toolkit to automate, integrate and operate IBM Aspera products:
336
+ high-speed transfers with FASP (ascp), send and receive packages, manage files and
337
+ administer Aspera on Cloud, Faspex, Shares, Node, Console, Orchestrator and High
338
+ Speed Transfer Server. Structured output for scripts and pipelines, presets and
339
+ secret vaults for multiple environments, analysis of ascp logs. Usable by AI assistants
340
+ and AI agents: in a shell (see llms.txt and the agent skill), or through its MCP
341
+ (Model Context Protocol) server.'
322
342
  email:
323
343
  - laurent.martin.aspera@fr.ibm.com
324
344
  executables:
@@ -329,8 +349,12 @@ extra_rdoc_files: []
329
349
  files:
330
350
  - BUGS.md
331
351
  - CHANGELOG.md
352
+ - CODE_OF_CONDUCT.md
332
353
  - CONTRIBUTING.md
354
+ - GOVERNANCE.md
355
+ - LICENSE
333
356
  - README.md
357
+ - SECURITY.md
334
358
  - TODO.md
335
359
  - bin/ascli
336
360
  - bin/asession
@@ -355,9 +379,20 @@ files:
355
379
  - lib/aspera/api/queries/bss_subscription_usage.graphql
356
380
  - lib/aspera/ascmd.rb
357
381
  - lib/aspera/ascp/installation.rb
382
+ - lib/aspera/ascp/log.schema.yaml
383
+ - lib/aspera/ascp/log_analyzer.rb
384
+ - lib/aspera/ascp/log_analyzer/advice.rb
385
+ - lib/aspera/ascp/log_analyzer/diagnostics.rb
386
+ - lib/aspera/ascp/log_analyzer/lines.rb
387
+ - lib/aspera/ascp/log_analyzer/log_file.rb
388
+ - lib/aspera/ascp/log_analyzer/records.rb
389
+ - lib/aspera/ascp/log_analyzer/rules.rb
390
+ - lib/aspera/ascp/log_analyzer/session.rb
358
391
  - lib/aspera/ascp/management.rb
392
+ - lib/aspera/ascp/session_errors.rb
359
393
  - lib/aspera/assert.rb
360
394
  - lib/aspera/cli/ascp_actions.rb
395
+ - lib/aspera/cli/ascp_logs_actions.rb
361
396
  - lib/aspera/cli/async_transfer_store.rb
362
397
  - lib/aspera/cli/bootstrapper.rb
363
398
  - lib/aspera/cli/command_line.rb
@@ -365,7 +400,9 @@ files:
365
400
  - lib/aspera/cli/command_spec.rb
366
401
  - lib/aspera/cli/completion/ascli.bash
367
402
  - lib/aspera/cli/completion/ascli.fish
403
+ - lib/aspera/cli/completion/ascli.ps1
368
404
  - lib/aspera/cli/completion/ascli.zsh
405
+ - lib/aspera/cli/completion_actions.rb
369
406
  - lib/aspera/cli/context.rb
370
407
  - lib/aspera/cli/deprecation.rb
371
408
  - lib/aspera/cli/error.rb
@@ -376,7 +413,9 @@ files:
376
413
  - lib/aspera/cli/http.rb
377
414
  - lib/aspera/cli/info.rb
378
415
  - lib/aspera/cli/mailer.rb
379
- - lib/aspera/cli/mcp_tool.rb
416
+ - lib/aspera/cli/mcp/http_servlet.rb
417
+ - lib/aspera/cli/mcp/secrets.rb
418
+ - lib/aspera/cli/mcp/tool.rb
380
419
  - lib/aspera/cli/option_declarator.rb
381
420
  - lib/aspera/cli/option_registry.rb
382
421
  - lib/aspera/cli/option_types.rb
@@ -402,20 +441,26 @@ files:
402
441
  - lib/aspera/cli/plugins/preview.rb
403
442
  - lib/aspera/cli/plugins/server.rb
404
443
  - lib/aspera/cli/plugins/shares.rb
444
+ - lib/aspera/cli/plugins/transferd.rb
405
445
  - lib/aspera/cli/preset_actions.rb
406
446
  - lib/aspera/cli/preset_manager.rb
407
447
  - lib/aspera/cli/prompt.rb
408
448
  - lib/aspera/cli/result.rb
409
449
  - lib/aspera/cli/runner.rb
410
450
  - lib/aspera/cli/secret_finder.rb
451
+ - lib/aspera/cli/security.rb
411
452
  - lib/aspera/cli/special_values.rb
412
453
  - lib/aspera/cli/sync_actions.rb
454
+ - lib/aspera/cli/table_fitter.rb
413
455
  - lib/aspera/cli/terminal_formatter.rb
414
456
  - lib/aspera/cli/transfer_actions.rb
415
457
  - lib/aspera/cli/transfer_agent.rb
416
458
  - lib/aspera/cli/transfer_progress.rb
459
+ - lib/aspera/cli/vault_actions.rb
417
460
  - lib/aspera/cli/vault_manager.rb
418
461
  - lib/aspera/cli/version.rb
462
+ - lib/aspera/cli/web_secret.html.erb
463
+ - lib/aspera/cli/web_secret.rb
419
464
  - lib/aspera/cli/wizard.rb
420
465
  - lib/aspera/command_line_builder.rb
421
466
  - lib/aspera/command_line_converter.rb
@@ -428,6 +473,7 @@ files:
428
473
  - lib/aspera/data/6
429
474
  - lib/aspera/data_repository.rb
430
475
  - lib/aspera/dot_container.rb
476
+ - lib/aspera/duration.rb
431
477
  - lib/aspera/environment.rb
432
478
  - lib/aspera/exec_spec.rb
433
479
  - lib/aspera/faspex_gw.rb
@@ -438,14 +484,6 @@ files:
438
484
  - lib/aspera/id_generator.rb
439
485
  - lib/aspera/json_rpc/client.rb
440
486
  - lib/aspera/json_rpc/version.rb
441
- - lib/aspera/keychain/base.rb
442
- - lib/aspera/keychain/encrypted_hash.rb
443
- - lib/aspera/keychain/factory.rb
444
- - lib/aspera/keychain/hashicorp_vault.rb
445
- - lib/aspera/keychain/macos_security.rb
446
- - lib/aspera/keychain/one_password_api.rb
447
- - lib/aspera/keychain/one_password_base.rb
448
- - lib/aspera/keychain/one_password_cli.rb
449
487
  - lib/aspera/line_logger.rb
450
488
  - lib/aspera/link_header.rb
451
489
  - lib/aspera/log.rb
@@ -453,15 +491,18 @@ files:
453
491
  - lib/aspera/mime.rb
454
492
  - lib/aspera/nagios.rb
455
493
  - lib/aspera/node_emulator.rb
456
- - lib/aspera/oauth.rb
457
- - lib/aspera/oauth/base.rb
458
- - lib/aspera/oauth/boot.rb
459
- - lib/aspera/oauth/factory.rb
460
- - lib/aspera/oauth/generic.rb
461
- - lib/aspera/oauth/json_credentials.rb
462
- - lib/aspera/oauth/jwt.rb
463
- - lib/aspera/oauth/url_json.rb
464
- - lib/aspera/oauth/web.rb
494
+ - lib/aspera/oauth/client/base.rb
495
+ - lib/aspera/oauth/client/boot.rb
496
+ - lib/aspera/oauth/client/factory.rb
497
+ - lib/aspera/oauth/client/generic.rb
498
+ - lib/aspera/oauth/client/json_credentials.rb
499
+ - lib/aspera/oauth/client/jwt.rb
500
+ - lib/aspera/oauth/client/shares_web.rb
501
+ - lib/aspera/oauth/client/url_json.rb
502
+ - lib/aspera/oauth/client/web.rb
503
+ - lib/aspera/oauth/server/authorize.html.erb
504
+ - lib/aspera/oauth/server/pkce.rb
505
+ - lib/aspera/orchestrator_workflow_checker.rb
465
506
  - lib/aspera/persistency_action_once.rb
466
507
  - lib/aspera/persistency_folder.rb
467
508
  - lib/aspera/preview/file_types.rb
@@ -475,6 +516,7 @@ files:
475
516
  - lib/aspera/products/desktop.rb
476
517
  - lib/aspera/products/other.rb
477
518
  - lib/aspera/products/transferd.rb
519
+ - lib/aspera/products/transferd_service.rb
478
520
  - lib/aspera/proxy_auto_config.js
479
521
  - lib/aspera/proxy_auto_config.rb
480
522
  - lib/aspera/rainbow.rb
@@ -489,8 +531,8 @@ files:
489
531
  - lib/aspera/schema/IBM Aspera Console-enhanced.yaml
490
532
  - lib/aspera/schema/IBM Aspera Faspex API-5.0-enhanced.yaml
491
533
  - lib/aspera/schema/IBM Aspera Node API-4.4.6.yaml
492
- - lib/aspera/schema/IBM Aspera Orchestrator API-v1.yaml
493
- - lib/aspera/schema/IBM Aspera faspio Gateway API-1.0.0.yaml
534
+ - lib/aspera/schema/IBM Aspera Orchestrator API-v1-enhanced.yaml
535
+ - lib/aspera/schema/IBM Aspera faspio Gateway API-1.0.0-enhanced.yaml
494
536
  - lib/aspera/schema/IBM Aspera on Cloud API-0.2.6-enhanced.yaml
495
537
  - lib/aspera/schema/IBM Aspera on Cloud Automation API-1.0.5-enhanced.yaml
496
538
  - lib/aspera/schema/IBM_Aspera_Shares.yaml
@@ -498,8 +540,24 @@ files:
498
540
  - lib/aspera/schema/documentation.rb
499
541
  - lib/aspera/schema/reader.rb
500
542
  - lib/aspera/schema/registry.rb
543
+ - lib/aspera/schema/transferd-config.schema.json
501
544
  - lib/aspera/schema/validator.rb
502
- - lib/aspera/secret_hider.rb
545
+ - lib/aspera/sealed_hash.rb
546
+ - lib/aspera/secret/hider.rb
547
+ - lib/aspera/secret/reference.rb
548
+ - lib/aspera/secret/resolver.rb
549
+ - lib/aspera/secret/store/base.rb
550
+ - lib/aspera/secret/store/encrypted_hash.rb
551
+ - lib/aspera/secret/store/factory.rb
552
+ - lib/aspera/secret/store/hashicorp_vault.rb
553
+ - lib/aspera/secret/store/keeper.rb
554
+ - lib/aspera/secret/store/macos_security.rb
555
+ - lib/aspera/secret/store/one_password_api.rb
556
+ - lib/aspera/secret/store/one_password_base.rb
557
+ - lib/aspera/secret/store/one_password_cli.rb
558
+ - lib/aspera/secret/store/secret_service.rb
559
+ - lib/aspera/secret/strength.rb
560
+ - lib/aspera/servlet_helpers.rb
503
561
  - lib/aspera/ssh.rb
504
562
  - lib/aspera/ssl.rb
505
563
  - lib/aspera/string_ext.rb
@@ -516,13 +574,22 @@ files:
516
574
  - lib/aspera/transfer/resumer.rb
517
575
  - lib/aspera/transfer/spec.rb
518
576
  - lib/aspera/transfer/spec.schema.yaml
577
+ - lib/aspera/transfer/units.rb
519
578
  - lib/aspera/uri_reader.rb
520
- - lib/aspera/web_auth/index.html
579
+ - lib/aspera/web_auth/index.html.erb
580
+ - lib/aspera/web_auth/paste.rb
581
+ - lib/aspera/web_auth/receiver.rb
582
+ - lib/aspera/web_auth/relay.rb
583
+ - lib/aspera/web_auth/reply.html.erb
521
584
  - lib/aspera/web_auth/server.rb
585
+ - lib/aspera/web_page.html.erb
586
+ - lib/aspera/web_page.rb
522
587
  - lib/aspera/web_server_simple.rb
523
588
  - lib/aspera/yaml.rb
524
589
  - lib/transferd_pb.rb
525
590
  - lib/transferd_services_pb.rb
591
+ - llms.txt
592
+ - skills/ascli/SKILL.md
526
593
  homepage: https://github.com/IBM/aspera-cli
527
594
  licenses:
528
595
  - Apache-2.0
@@ -540,7 +607,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
540
607
  requirements:
541
608
  - - ">="
542
609
  - !ruby/object:Gem::Version
543
- version: '3.1'
610
+ version: '3.3'
544
611
  required_rubygems_version: !ruby/object:Gem::Requirement
545
612
  requirements:
546
613
  - - ">="
@@ -550,6 +617,7 @@ requirements:
550
617
  - Read the manual for any requirement
551
618
  rubygems_version: 4.0.20
552
619
  specification_version: 4
553
- summary: 'Execute actions using command line on IBM Aspera Server products: Aspera
554
- on Cloud, Faspex, Shares, Node, Console, Orchestrator, High Speed Transfer Server'
620
+ summary: 'The automation interface for IBM Aspera, from command line to AI agents:
621
+ transfers, packages, files and administration of Aspera on Cloud, Faspex, Shares,
622
+ Node, Console, Orchestrator, High Speed Transfer Server'
555
623
  test_files: []
metadata.gz.sig CHANGED
Binary file
@@ -1,189 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # cspell:ignore ascli
4
-
5
- require 'json'
6
- require 'aspera/log'
7
- require 'aspera/secret_hider'
8
- require 'aspera/cli/runner'
9
- require 'aspera/cli/error'
10
- require 'aspera/schema/reader'
11
- require 'aspera/schema/registry'
12
- unless defined?(MCP::Tool)
13
- begin
14
- require 'mcp'
15
- rescue LoadError
16
- raise Cli::Error, "The 'mcp' and 'rack' gems are required. Install them with: gem install mcp rack"
17
- end
18
- end
19
-
20
- module Aspera
21
- module Cli
22
- # MCP Tool: executes an ascli command in-process.
23
- class McpTool < MCP::Tool
24
- # Default maximum byte size of the JSON text content returned for list results.
25
- # Items are appended whole until the limit is reached; the full list is always
26
- # available in structuredContent.
27
- DEFAULT_MAX_TEXT_BYTES = 100_000
28
- # Default extra arguments automatically prepended to every ascli call.
29
- # Keeps the AI from having to remember mandatory flags on every invocation.
30
- DEFAULT_EXTRA_ARGS = ['--interactive=no', '--transfer.asynchronous=true'].freeze
31
-
32
- tool_name 'execute_ascli_command'
33
-
34
- description <<~DESC.strip
35
- Execute any ascli (Aspera CLI) command in-process and return its result.
36
-
37
- SYNTAX
38
- args is a JSON array of strings mirroring the CLI command line.
39
- Element 0 : plugin name (aoc, faspex5, node, server, config, …).
40
- Elements 1+: sub-commands, positional arguments, and --option=value flags in any order.
41
- Structured values use an extended-value prefix on the relevant element:
42
- "@json:{...}" — inline JSON object or array (preferred: no shell quoting)
43
- "@preset:name" — expand a saved preset
44
- "@env:VAR" — read value from environment variable
45
- "@file:/path" — read value from a file
46
-
47
- AUTOMATIC FLAGS
48
- The server prepends extra_args to every call (default: #{DEFAULT_EXTRA_ARGS.join(' ')}).
49
- Do NOT repeat them. To override one, include it in args: later values take precedence.
50
- Commands never prompt: if credentials are missing, an error is returned; report it and stop.
51
-
52
- DISCOVERY — never guess command or field names from training data
53
- Step 1 — commands of a plugin, with syntax:
54
- ["config", "commands", "<plugin>"]
55
- Returns { syntax, description } for every command of that plugin.
56
- Notation: <arg> mandatory, [<arg>] optional, <a|b> enum, <arg...> variadic, <arg:Hash> typed.
57
- A line ending with <command...> and "(see: <plugin> <path>)" provides the commands of that path:
58
- list them with ["config", "commands", "<plugin>", "<command>", ...] (command words only).
59
- Omit <plugin> to list the commands of all plugins (large).
60
- Step 2 — schema of a Hash argument (shown <name:Hash>), MANDATORY before calling such a command:
61
- ["<plugin>", "<cmd>", ..., "help"]
62
- Put the literal "help" in place of the Hash argument. Returns field names, types,
63
- required flags and descriptions. Never infer fields from server error messages.
64
- Step 2b — filter parameters of a list command:
65
- ["<plugin>", "<cmd>", ..., "--query=help"]
66
- Step 3 — all --flags of a plugin, with allowed values:
67
- ["config", "options", "<plugin>"]
68
- Documentation:
69
- ["config", "documentation", "toc"] → { level, title, anchor } per heading
70
- ["config", "documentation", "local", "<anchor>"] → one README section
71
- Presets (saved credentials):
72
- ["config", "preset", "overview"]
73
-
74
- RESULT FORMAT
75
- Structured data is always in structuredContent (a JSON object; lists are under "items").
76
- For lists, text content is limited to #{DEFAULT_MAX_TEXT_BYTES} bytes (whole items only);
77
- when truncated, a WARNING line gives the real total. Read structuredContent.items for
78
- the full dataset — never report counts or search results from a truncated text block.
79
-
80
- FILE LIST FOR TRANSFERS
81
- For all transfers (upload, download, package send, …), append source paths at the
82
- end of args — no --sources flag needed.
83
-
84
- EXAMPLES
85
- ["config", "commands", "aoc"]
86
- ["aoc", "admin", "user", "create", "help"]
87
- ["config", "options", "aoc"]
88
- ["config", "documentation", "local", "leveraging-ai-assistance"]
89
- ["aoc", "--preset=myaoc", "packages", "list"]
90
- ["aoc", "--preset=myaoc", "admin", "user", "create", '@json:{"email":"a@b.com","name":"Alice"}']
91
- ["aoc", "--preset=myaoc", "packages", "send",
92
- '@json:{"name":"pkg","recipients":["user@example.com"]}', "/local/a.txt", "/local/b.txt"]
93
- ["server", "--preset=myserver", "upload", "--to-folder=/uploads", "/local/a.txt"]
94
- ["server", "browse", "/", "--url=ssh://host:33001", "--username=user", "--password=secret"]
95
- DESC
96
-
97
- input_schema(
98
- properties: {
99
- args: {
100
- type: 'array',
101
- items: {type: 'string'},
102
- minItems: 1,
103
- description: 'ascli arguments: first element is the plugin name, followed by action and --option=value flags'
104
- }
105
- },
106
- required: ['args']
107
- )
108
-
109
- class << self
110
- attr_accessor :max_text_bytes, :extra_args
111
-
112
- def call(args:, server_context: nil)
113
- effective_args = Array(extra_args || DEFAULT_EXTRA_ARGS) + args
114
- Log.dump(:mcp_execute, effective_args)
115
- runner = Runner.new(effective_args)
116
- result = runner.run_with_result
117
- case result
118
- when Result::Nothing, Result::Empty, NilClass
119
- MCP::Tool::Response.new([{type: 'text', text: ''}])
120
- when Result::SingleObject, Result::ObjectList, Result::ValueList
121
- # Secrets never reach the AI client, whatever the output format requested in args.
122
- SecretHider.instance.deep_remove_secret(result.data)
123
- # Apply --select filter in place (affects both text and structuredContent).
124
- runner.context.formatter.filter_columns_on_select(result.data) if result.data.is_a?(Array)
125
- # MCP spec requires structuredContent to be a JSON object (not an array).
126
- structured = result.data.is_a?(Array) ? {items: result.data} : result.data
127
- content = if result.data.is_a?(Array)
128
- text_limit = max_text_bytes || DEFAULT_MAX_TEXT_BYTES
129
- truncated_items = truncate_items_by_bytes(result.data, text_limit)
130
- total = result.data.size
131
- if truncated_items.size < total
132
- [
133
- {type: 'text', text: JSON.generate(truncated_items)},
134
- {type: 'text', text: "WARNING: result truncated to #{truncated_items.size} of #{total} items. Full dataset available in structuredContent."}
135
- ]
136
- else
137
- [{type: 'text', text: JSON.generate(result.data)}]
138
- end
139
- else
140
- [{type: 'text', text: JSON.generate(result.data)}]
141
- end
142
- MCP::Tool::Response.new(content, structured_content: structured)
143
- else
144
- MCP::Tool::Response.new([{type: 'text', text: SecretHider.instance.hide_secrets_in_string(result.data.to_s, all: true)}])
145
- end
146
- rescue Cli::SchemaRequest => e
147
- schema_path = e.path
148
- if schema_path.nil?
149
- MCP::Tool::Response.new([{type: 'text', text: "#{e.class}: #{e.message} (no schema available)"}], error: true)
150
- else
151
- rows = schema_to_rows(Schema::Registry.instance.reader(schema_path))
152
- structured = {items: rows}
153
- MCP::Tool::Response.new([{type: 'text', text: JSON.generate(rows)}], structured_content: structured)
154
- end
155
- rescue SystemExit => e
156
- MCP::Tool::Response.new([{type: 'text', text: "exited with status #{e.status}"}], error: !e.status.zero?)
157
- rescue => e
158
- MCP::Tool::Response.new([{type: 'text', text: "#{e.class}: #{dedupe_lines(e.message)}"}], error: true)
159
- end
160
-
161
- # Delegate to Schema::Reader#to_rows — semantic fields, no ANSI, MCP/JSON-ready.
162
- def schema_to_rows(reader)
163
- reader.to_rows
164
- end
165
-
166
- # Collapse consecutive duplicate lines in a multi-line message.
167
- # Each run of identical lines is replaced by one line + "(×N)" suffix when N > 1.
168
- def dedupe_lines(msg)
169
- return msg unless msg.include?("\n")
170
- msg.split("\n").chunk_while { |a, b| a == b }.map do |group|
171
- group.size > 1 ? "#{group.first} (x#{group.size})" : group.first
172
- end.join("\n")
173
- end
174
-
175
- # Returns the largest prefix of `items` whose JSON serialization fits within `max_bytes`.
176
- # Items are appended whole — no item is ever split mid-JSON.
177
- def truncate_items_by_bytes(items, max_bytes)
178
- buf = +''
179
- items.each_with_index do |item, i|
180
- fragment = (i.zero? ? '[' : ',') + JSON.generate(item)
181
- break if buf.bytesize + fragment.bytesize + 1 > max_bytes # +1 for closing ']'
182
- buf << fragment
183
- end
184
- buf.empty? ? [] : JSON.parse("#{buf}]")
185
- end
186
- end
187
- end
188
- end
189
- end
@@ -1,25 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- module Aspera
4
- module Keychain
5
- class Base
6
- CONTENT_KEYS = %i[label username password url description].freeze
7
-
8
- # Returns a lightweight list: one Hash per secret with :label (and :id if the backend has one).
9
- # Override in subclasses that can provide this cheaply without fetching full item details.
10
- def ids
11
- all.map { |s| s.slice(:id, :label).compact }
12
- end
13
-
14
- def validate_set(options)
15
- Aspera.assert_type(options, Hash) { 'options' }
16
- unsupported = options.keys - CONTENT_KEYS
17
- Aspera.assert(unsupported.empty?) { "unsupported options: #{unsupported}, use #{CONTENT_KEYS.join(', ')}" }
18
- options.each_pair do |k, v|
19
- Aspera.assert_type(v, String) { k.to_s }
20
- end
21
- Aspera.assert(options.key?(:label), 'label is required')
22
- end
23
- end
24
- end
25
- end