dexbot 1.6.11 → 1.6.13

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 (398) hide show
  1. package/CHANGELOG.md +67 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +11 -11
  4. package/analysis/ama_fitting/README.md +5 -3
  5. package/analysis/tradingview/README.md +1 -1
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  7. package/claw/README.md +1 -0
  8. package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
  9. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  10. package/claw/modules/chain_broadcast.ts +7 -1
  11. package/claw/modules/claw_bridge.ts +0 -3
  12. package/claw/modules/claw_launcher.ts +1 -1
  13. package/claw/modules/claw_skill_md.ts +1 -0
  14. package/claw/modules/launcher_mode_detector.ts +9 -2
  15. package/claw/package.json +3 -3
  16. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  17. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  18. package/claw/tsconfig.json +2 -2
  19. package/dist/analysis/account_resolver.d.ts +1 -1
  20. package/dist/analysis/account_resolver.js +2 -1
  21. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  22. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
  23. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  24. package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
  25. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
  26. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
  27. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
  28. package/dist/analysis/analyze_args.d.ts +43 -0
  29. package/dist/analysis/analyze_args.js +61 -0
  30. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  31. package/dist/analysis/analyze_kalman.js +7 -17
  32. package/dist/analysis/analyze_regime.js +7 -17
  33. package/dist/analysis/analyze_regime_windows.js +8 -18
  34. package/dist/analysis/analyze_risk_profile.js +8 -18
  35. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  36. package/dist/analysis/analyze_volatility.js +7 -17
  37. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
  38. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
  39. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  40. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
  41. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
  42. package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
  43. package/dist/analysis/bot_fitting/shared_utils.js +125 -9
  44. package/dist/analysis/bot_key_utils.d.ts +18 -10
  45. package/dist/analysis/bot_key_utils.js +7 -4
  46. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  47. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  48. package/dist/analysis/chain_pool.d.ts +3 -1
  49. package/dist/analysis/chart_ui.d.ts +35 -3
  50. package/dist/analysis/chart_ui.js +43 -4
  51. package/dist/analysis/chart_utils.d.ts +5 -5
  52. package/dist/analysis/chart_utils.js +9 -0
  53. package/dist/analysis/fills_cache.d.ts +4 -24
  54. package/dist/analysis/fills_cache.js +3 -84
  55. package/dist/analysis/fills_source.d.ts +33 -3
  56. package/dist/analysis/fills_source.js +83 -13
  57. package/dist/analysis/grid_correction_check.d.ts +2 -24
  58. package/dist/analysis/grid_correction_check.js +27 -69
  59. package/dist/analysis/math_utils.d.ts +91 -6
  60. package/dist/analysis/math_utils.js +119 -7
  61. package/dist/analysis/pnl_report.js +29 -29
  62. package/dist/analysis/price_sources.d.ts +30 -9
  63. package/dist/analysis/price_sources.js +28 -4
  64. package/dist/analysis/resolve_bot_accounts.js +2 -2
  65. package/dist/analysis/resolve_source.d.ts +1 -1
  66. package/dist/analysis/resolve_source.js +31 -10
  67. package/dist/analysis/trade_profitability.d.ts +29 -2
  68. package/dist/analysis/trade_profitability.js +73 -147
  69. package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
  70. package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
  71. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  72. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  73. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  74. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  75. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  76. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
  77. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
  78. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
  79. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  80. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
  81. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  82. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  83. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  84. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  85. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  86. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  87. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  88. package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
  89. package/dist/analysis/worker_pool.d.ts +38 -0
  90. package/dist/analysis/worker_pool.js +67 -0
  91. package/dist/credential-daemon.js +34 -20
  92. package/dist/dexbot.js +78 -59
  93. package/dist/market_adapter/ama_signal_runner.js +21 -54
  94. package/dist/market_adapter/candle_utils.d.ts +29 -19
  95. package/dist/market_adapter/candle_utils.js +35 -21
  96. package/dist/market_adapter/cli_args.d.ts +22 -0
  97. package/dist/market_adapter/cli_args.js +30 -0
  98. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  99. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  100. package/dist/market_adapter/core/config_normalizers.js +11 -6
  101. package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
  102. package/dist/market_adapter/core/kibana_candles.js +12 -9
  103. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  104. package/dist/market_adapter/core/kibana_client.js +8 -7
  105. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  106. package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
  107. package/dist/market_adapter/core/market_adapter_service.js +228 -269
  108. package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
  109. package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
  110. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
  111. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
  112. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  113. package/dist/market_adapter/core/strategies/ama.js +2 -4
  114. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  115. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  116. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  117. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  118. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  119. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  120. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  121. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  122. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  123. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  124. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  125. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  126. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  127. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  128. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  129. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  130. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  131. package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
  132. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
  133. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
  134. package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
  135. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  136. package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
  137. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  138. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  139. package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
  140. package/dist/market_adapter/inputs/window_cache.js +59 -184
  141. package/dist/market_adapter/interval_utils.d.ts +15 -5
  142. package/dist/market_adapter/interval_utils.js +16 -1
  143. package/dist/market_adapter/log_format.d.ts +6 -6
  144. package/dist/market_adapter/log_format.js +28 -21
  145. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  146. package/dist/market_adapter/lp_chart_core.js +26 -192
  147. package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
  148. package/dist/market_adapter/lp_chart_runner.js +37 -19
  149. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  150. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  151. package/dist/market_adapter/market_adapter.d.ts +94 -32
  152. package/dist/market_adapter/market_adapter.js +94 -120
  153. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  154. package/dist/market_adapter/utils/adapter_client.js +2 -2
  155. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  156. package/dist/market_adapter/utils/chain.d.ts +50 -41
  157. package/dist/market_adapter/utils/chain.js +40 -46
  158. package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
  159. package/dist/market_adapter/utils/data_discovery.js +220 -27
  160. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  161. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  162. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  163. package/dist/market_adapter/utils/file_lock.js +36 -32
  164. package/dist/market_adapter/utils/month_shards.d.ts +84 -0
  165. package/dist/market_adapter/utils/month_shards.js +237 -0
  166. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  167. package/dist/market_adapter/utils/native_history.js +35 -28
  168. package/dist/modules/account_bots.d.ts +578 -21
  169. package/dist/modules/account_bots.js +272 -267
  170. package/dist/modules/account_orders.d.ts +79 -30
  171. package/dist/modules/account_orders.js +60 -64
  172. package/dist/modules/authority_resolver.d.ts +12 -2
  173. package/dist/modules/authority_resolver.js +15 -8
  174. package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
  175. package/dist/modules/bitshares-native/chain_client.js +59 -59
  176. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  177. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  178. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  179. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  180. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  181. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  182. package/dist/modules/bitshares-native/index.d.ts +1 -1
  183. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  184. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  185. package/dist/modules/bitshares-native/resolvers.js +22 -25
  186. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  187. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  188. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  189. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  190. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  191. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  192. package/dist/modules/bitshares-native/serial/types.js +73 -108
  193. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  194. package/dist/modules/bitshares-native/signing_client.js +19 -14
  195. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  196. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  197. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  198. package/dist/modules/bitshares-native/transport.js +5 -4
  199. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  200. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  201. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  202. package/dist/modules/bitshares_client.d.ts +45 -13
  203. package/dist/modules/bitshares_client.js +28 -19
  204. package/dist/modules/bot_defaults.d.ts +8 -16
  205. package/dist/modules/bot_defaults.js +1 -5
  206. package/dist/modules/bot_settings.d.ts +44 -10
  207. package/dist/modules/bot_settings.js +11 -8
  208. package/dist/modules/bots_file_lock.d.ts +6 -6
  209. package/dist/modules/bots_file_lock.js +16 -12
  210. package/dist/modules/broadcast_failure.d.ts +4 -3
  211. package/dist/modules/broadcast_failure.js +5 -4
  212. package/dist/modules/chain_keys.d.ts +42 -40
  213. package/dist/modules/chain_keys.js +53 -45
  214. package/dist/modules/chain_orders.d.ts +94 -60
  215. package/dist/modules/chain_orders.js +81 -118
  216. package/dist/modules/cli_start_onboarding.d.ts +2 -1
  217. package/dist/modules/constants.d.ts +534 -32
  218. package/dist/modules/constants.js +35 -48
  219. package/dist/modules/cr_planner.d.ts +41 -3
  220. package/dist/modules/cr_planner.js +1 -5
  221. package/dist/modules/credential_policy.d.ts +68 -8
  222. package/dist/modules/credential_policy.js +37 -31
  223. package/dist/modules/credential_session_cache.d.ts +2 -2
  224. package/dist/modules/credit_pricing.d.ts +43 -6
  225. package/dist/modules/credit_pricing.js +70 -60
  226. package/dist/modules/credit_runtime.d.ts +283 -118
  227. package/dist/modules/credit_runtime.js +500 -231
  228. package/dist/modules/crypto/browser_provider.js +6 -4
  229. package/dist/modules/crypto/node_provider.js +1 -1
  230. package/dist/modules/crypto/pure_scrypt.js +35 -4
  231. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  232. package/dist/modules/crypto/sync.d.ts +9 -9
  233. package/dist/modules/crypto/sync.js +16 -9
  234. package/dist/modules/daemon_node_health.d.ts +4 -3
  235. package/dist/modules/dexbot_class.d.ts +213 -146
  236. package/dist/modules/dexbot_class.js +183 -86
  237. package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
  238. package/dist/modules/dexbot_cow_runtime.js +302 -234
  239. package/dist/modules/dexbot_credential_client.d.ts +19 -18
  240. package/dist/modules/dexbot_credential_client.js +1 -2
  241. package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
  242. package/dist/modules/dexbot_fill_runtime.js +53 -47
  243. package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
  244. package/dist/modules/dexbot_maintenance_runtime.js +187 -147
  245. package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
  246. package/dist/modules/dexbot_startup_runtime.js +56 -57
  247. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  248. package/dist/modules/dexbot_state_recovery.js +18 -13
  249. package/dist/modules/fund_registry.d.ts +4 -2
  250. package/dist/modules/fund_registry.js +10 -10
  251. package/dist/modules/general_settings.d.ts +30 -4
  252. package/dist/modules/graceful_shutdown.d.ts +3 -3
  253. package/dist/modules/graceful_shutdown.js +19 -13
  254. package/dist/modules/grid_price_source.d.ts +1 -1
  255. package/dist/modules/key_store.d.ts +14 -8
  256. package/dist/modules/key_store.js +7 -7
  257. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  258. package/dist/modules/launcher/adapter_requirement.js +5 -5
  259. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  260. package/dist/modules/launcher/bot_supervisor.js +12 -11
  261. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  262. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  263. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  264. package/dist/modules/launcher/credential_daemon.js +2 -2
  265. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  266. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  267. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  268. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  269. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  270. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  271. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  272. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  273. package/dist/modules/launcher/supervisor_control.js +4 -2
  274. package/dist/modules/lazy_shim.d.ts +11 -0
  275. package/dist/modules/lazy_shim.js +16 -0
  276. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  277. package/dist/modules/market_adapter_whitelist.js +15 -3
  278. package/dist/modules/node_connect_policy.d.ts +3 -2
  279. package/dist/modules/node_failure_ledger.d.ts +6 -5
  280. package/dist/modules/node_manager.d.ts +41 -11
  281. package/dist/modules/node_manager.js +5 -4
  282. package/dist/modules/order/accounting.d.ts +53 -24
  283. package/dist/modules/order/accounting.js +16 -15
  284. package/dist/modules/order/async_lock.d.ts +5 -2
  285. package/dist/modules/order/async_lock.js +1 -1
  286. package/dist/modules/order/export.d.ts +7 -6
  287. package/dist/modules/order/export.js +1 -7
  288. package/dist/modules/order/format.d.ts +16 -7
  289. package/dist/modules/order/format.js +15 -3
  290. package/dist/modules/order/genesis_policy.d.ts +24 -21
  291. package/dist/modules/order/genesis_policy.js +17 -10
  292. package/dist/modules/order/grid.d.ts +144 -36
  293. package/dist/modules/order/grid.js +226 -145
  294. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  295. package/dist/modules/order/grid_reconcile.js +13 -12
  296. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  297. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  298. package/dist/modules/order/index.d.ts +264 -1
  299. package/dist/modules/order/logger.d.ts +46 -19
  300. package/dist/modules/order/logger.js +38 -49
  301. package/dist/modules/order/logger_state.d.ts +4 -4
  302. package/dist/modules/order/manager.d.ts +232 -191
  303. package/dist/modules/order/manager.js +110 -130
  304. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  305. package/dist/modules/order/processed_fill_store.js +16 -27
  306. package/dist/modules/order/strategy.d.ts +21 -13
  307. package/dist/modules/order/strategy.js +5 -6
  308. package/dist/modules/order/sync_engine.d.ts +91 -33
  309. package/dist/modules/order/sync_engine.js +84 -53
  310. package/dist/modules/order/utils/math.d.ts +157 -102
  311. package/dist/modules/order/utils/math.js +77 -38
  312. package/dist/modules/order/utils/order.d.ts +310 -110
  313. package/dist/modules/order/utils/order.js +153 -126
  314. package/dist/modules/order/utils/slot.d.ts +1 -1
  315. package/dist/modules/order/utils/system.d.ts +156 -26
  316. package/dist/modules/order/utils/system.js +103 -71
  317. package/dist/modules/order/utils/validate.d.ts +89 -41
  318. package/dist/modules/order/utils/validate.js +26 -24
  319. package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
  320. package/dist/modules/order/utils/withPoolRef.js +18 -12
  321. package/dist/modules/order/working_grid.d.ts +14 -13
  322. package/dist/modules/paths.d.ts +1 -4
  323. package/dist/modules/paths.js +33 -61
  324. package/dist/modules/process_discovery.d.ts +1 -1
  325. package/dist/modules/process_discovery.js +2 -1
  326. package/dist/modules/runtime.d.ts +7 -3
  327. package/dist/modules/runtime.js +4 -3
  328. package/dist/modules/runtime_settings.d.ts +14 -11
  329. package/dist/modules/runtime_settings.js +30 -24
  330. package/dist/modules/settings_merge.d.ts +29 -3
  331. package/dist/modules/settings_merge.js +56 -78
  332. package/dist/modules/socket_json_client.d.ts +9 -5
  333. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  334. package/dist/modules/storage/browser_adapter.js +7 -30
  335. package/dist/modules/storage/index.d.ts +1 -1
  336. package/dist/modules/storage/node_adapter.d.ts +45 -27
  337. package/dist/modules/storage/node_adapter.js +9 -9
  338. package/dist/modules/storage/types.d.ts +5 -4
  339. package/dist/modules/types.d.ts +1090 -6
  340. package/dist/modules/types.js +4 -1
  341. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  342. package/dist/modules/utils/asset_symbols.js +2 -1
  343. package/dist/modules/utils/errors.d.ts +9 -0
  344. package/dist/modules/utils/errors.js +24 -4
  345. package/dist/modules/utils/time_range.d.ts +1 -12
  346. package/dist/modules/utils/time_range.js +1 -1
  347. package/dist/modules/validate_profiles.js +53 -43
  348. package/dist/modules/version_notice.d.ts +23 -11
  349. package/dist/modules/version_notice.js +6 -4
  350. package/dist/pm2.d.ts +28 -27
  351. package/dist/pm2.js +61 -40
  352. package/dist/scripts/analyze-credit.d.ts +2 -1
  353. package/dist/scripts/analyze-credit.js +23 -24
  354. package/dist/scripts/analyze-git.js +2 -15
  355. package/dist/scripts/analyze-orders.d.ts +77 -9
  356. package/dist/scripts/analyze-orders.js +65 -40
  357. package/dist/scripts/chart_command.d.ts +27 -18
  358. package/dist/scripts/chart_command.js +15 -13
  359. package/dist/scripts/check_any.d.ts +22 -0
  360. package/dist/scripts/check_any.js +158 -0
  361. package/dist/scripts/diagnose-pool-history.js +13 -13
  362. package/dist/scripts/print_grid.js +0 -1
  363. package/dist/scripts/run-tests.js +39 -8
  364. package/dist/scripts/runner.js +1 -1
  365. package/dist/scripts/sync-version.js +0 -10
  366. package/dist/scripts/test-credit-renewal.js +30 -21
  367. package/dist/scripts/update.d.ts +10 -5
  368. package/dist/scripts/update.js +168 -103
  369. package/dist/scripts/update_dist_freshness.js +1 -0
  370. package/dist/scripts/update_layout.d.ts +61 -0
  371. package/dist/scripts/update_layout.js +180 -0
  372. package/dist/scripts/validate_bots.js +2 -1
  373. package/dist/scripts/verify-browser-bundle.js +8 -0
  374. package/dist/unlock.d.ts +28 -3
  375. package/dist/unlock.js +63 -35
  376. package/docs/BITSHARES_ONBOARDING.md +10 -12
  377. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
  378. package/docs/COW_INVARIANTS.md +13 -6
  379. package/docs/DEXBOT_COMPARISON.md +8 -8
  380. package/docs/EVOLUTION.md +10 -8
  381. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  382. package/docs/GRID_RECALCULATION.md +4 -2
  383. package/docs/GRID_RECONCILE.md +14 -3
  384. package/docs/LIFECYCLE.md +11 -11
  385. package/docs/MPA_CREDIT_USAGE.md +22 -3
  386. package/docs/README.md +14 -3
  387. package/docs/WORKFLOW.md +1 -0
  388. package/docs/architecture.md +31 -19
  389. package/docs/developer_guide.md +6 -6
  390. package/market_adapter/README.md +12 -5
  391. package/modules/README.md +4 -1
  392. package/package.json +9 -9
  393. package/scripts/README.md +43 -38
  394. package/tests/README.md +25 -10
  395. package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
  396. package/dist/scripts/diagnose-kibana-candles.js +0 -82
  397. package/scripts/git-viewer.sh +0 -489
  398. package/scripts/postinstall.js +0 -16
@@ -6,5 +6,8 @@
6
6
  *
7
7
  * See libraries/protocol/include/graphene/protocol/ for canonical defs.
8
8
  */
9
- export {};
9
+ /** Runtime narrowing guard for `UnknownRecord` at I/O boundaries. */
10
+ export function isUnknownRecord(value) {
11
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
12
+ }
10
13
  //# sourceMappingURL=types.js.map
@@ -21,6 +21,7 @@
21
21
  *
22
22
  * Browser-safe: no node built-ins.
23
23
  */
24
+ import type { UnknownRecord } from '../types.js';
24
25
  /** True when the value is a BitShares asset object id, not a symbol. */
25
26
  export declare function isAssetObjectId(value: unknown): boolean;
26
27
  /**
@@ -55,5 +56,5 @@ export declare function splitPairTarget(target: unknown): string[];
55
56
  * hand-edited lowercase entry never leaks into a chain call, a comparison or
56
57
  * a rendered label. The input is never mutated.
57
58
  */
58
- export declare function canonicalizeBotAssetSymbols<T extends Record<string, any>>(entry: T): T;
59
+ export declare function canonicalizeBotAssetSymbols<T extends UnknownRecord>(entry: T): T;
59
60
  //# sourceMappingURL=asset_symbols.d.ts.map
@@ -21,6 +21,7 @@
21
21
  *
22
22
  * Browser-safe: no node built-ins.
23
23
  */
24
+ import { isUnknownRecord } from '../types.js';
24
25
  /** BitShares asset object id, e.g. "1.3.0" (the core asset) or "1.3.529". */
25
26
  const ASSET_OBJECT_ID_PATTERN = /^1\.3\.\d+$/;
26
27
  /** True when the value is a BitShares asset object id, not a symbol. */
@@ -100,7 +101,7 @@ export function canonicalizeBotAssetSymbols(entry) {
100
101
  }
101
102
  if ('debtPolicy' in out) {
102
103
  const policy = out.debtPolicy;
103
- if (policy && typeof policy === 'object' && Array.isArray(policy.lending)) {
104
+ if (isUnknownRecord(policy) && Array.isArray(policy.lending)) {
104
105
  let lendingChanged = false;
105
106
  const lending = policy.lending.map((item) => {
106
107
  if (!item || typeof item !== 'object')
@@ -1,4 +1,13 @@
1
1
  export declare function getErrorMessage(err: unknown): string;
2
+ /**
3
+ * Read a field from an unknown thrown value without resorting to `any`.
4
+ * Returns `undefined` when the value is not an object or the field is absent.
5
+ */
6
+ export declare function getErrorField<T = unknown>(err: unknown, key: string): T | undefined;
7
+ /** String error code (`err.code`) if present, else `undefined`. */
8
+ export declare function getErrorCode(err: unknown): string | undefined;
9
+ /** Error name (`err.name`) if present, else `undefined`. */
10
+ export declare function getErrorName(err: unknown): string | undefined;
2
11
  /**
3
12
  * Resolve an optional millisecond override (a test seam on a production code
4
13
  * path) to a concrete delay.
@@ -5,6 +5,28 @@ export function getErrorMessage(err) {
5
5
  return err;
6
6
  return String(err);
7
7
  }
8
+ /**
9
+ * Read a field from an unknown thrown value without resorting to `any`.
10
+ * Returns `undefined` when the value is not an object or the field is absent.
11
+ */
12
+ export function getErrorField(err, key) {
13
+ if (typeof err === 'object' && err !== null && key in err) {
14
+ return err[key];
15
+ }
16
+ return undefined;
17
+ }
18
+ /** String error code (`err.code`) if present, else `undefined`. */
19
+ export function getErrorCode(err) {
20
+ const code = getErrorField(err, 'code');
21
+ return code === undefined || code === null ? undefined : String(code);
22
+ }
23
+ /** Error name (`err.name`) if present, else `undefined`. */
24
+ export function getErrorName(err) {
25
+ if (err instanceof Error)
26
+ return err.name;
27
+ const name = getErrorField(err, 'name');
28
+ return name === undefined || name === null ? undefined : String(name);
29
+ }
8
30
  /**
9
31
  * Resolve an optional millisecond override (a test seam on a production code
10
32
  * path) to a concrete delay.
@@ -20,9 +42,7 @@ export function getErrorMessage(err) {
20
42
  * interval, credit-deal settle delay, deferred-fill retry backoff).
21
43
  */
22
44
  export function resolveSeamMs(value, fallback) {
23
- return value != null && Number.isFinite(Number(value)) && Number(value) >= 0
24
- ? Number(value)
25
- : fallback;
45
+ return resolveSeamMsOrNull(value) ?? fallback;
26
46
  }
27
47
  /**
28
48
  * Like {@link resolveSeamMs}, but returns `null` instead of a fallback so the
@@ -53,7 +73,7 @@ export function sleepMs(ms) {
53
73
  * kibana_client.ts / kibana_candles.ts / kibana_feed_source.ts.
54
74
  */
55
75
  export function isTransientNetworkError(err) {
56
- const msg = String(err?.message || err || '');
76
+ const msg = String(getErrorMessage(err) || '');
57
77
  return (msg.includes('aborted') ||
58
78
  msg.includes('connection reset') ||
59
79
  msg.includes('ECONNRESET') ||
@@ -1,15 +1,4 @@
1
- /**
2
- * Shared lookback-unit conversion for the analysis commands that accept a
3
- * month-based range (`dexbot tv|dw|pnl --month N`).
4
- *
5
- * A "month" is the fixed 730-hour unit the chart pipeline already used, not a
6
- * calendar month: it keeps a `--month 3` window exactly 3 × 730 h regardless
7
- * of the run date, so two runs a day apart cover the same span. Centralised
8
- * here so the chart and PnL commands can never disagree on what `--month`
9
- * means.
10
- */
11
- declare const HOURS_PER_MONTH = 730;
12
1
  /** Whole months → whole hours, floored at 1 so `--month 0.x` still fetches. */
13
2
  declare function monthsToHours(months: number): number;
14
- export { HOURS_PER_MONTH, monthsToHours };
3
+ export { monthsToHours };
15
4
  //# sourceMappingURL=time_range.d.ts.map
@@ -14,5 +14,5 @@ const HOURS_PER_MONTH = 730;
14
14
  function monthsToHours(months) {
15
15
  return Math.max(1, Math.round(months * HOURS_PER_MONTH));
16
16
  }
17
- export { HOURS_PER_MONTH, monthsToHours };
17
+ export { monthsToHours };
18
18
  //# sourceMappingURL=time_range.js.map
@@ -4,7 +4,7 @@ const storage = getStorage();
4
4
  const { readJSON } = storage;
5
5
  import { PATHS } from './paths.js';
6
6
  import { normalizeBotEntry } from './bot_settings.js';
7
- import { getErrorMessage } from './utils/errors.js';
7
+ import { getErrorMessage, getErrorCode } from './utils/errors.js';
8
8
  import { MERGE_STRATEGIES } from './settings_merge.js';
9
9
  import { DEFAULT_WHITELIST_FLAGS } from './market_adapter_whitelist.js';
10
10
  const PROFILE_KNOWN_FIELDS = new Set([
@@ -18,7 +18,6 @@ const PROFILE_AMA_KNOWN_FIELDS = new Set([
18
18
  const GENERAL_SETTINGS_KNOWN_FIELDS = new Set([
19
19
  ...Object.keys(MERGE_STRATEGIES),
20
20
  'NODES',
21
- 'EXPERT',
22
21
  ]);
23
22
  // Derived from the canonical flag constants so a new flag lands here
24
23
  // automatically instead of drifting out of sync with the reader.
@@ -42,7 +41,7 @@ function loadJsonFile(filePath) {
42
41
  return { data, ok: true };
43
42
  }
44
43
  catch (err) {
45
- if (err?.code === 'ENOENT')
44
+ if (getErrorCode(err) === 'ENOENT')
46
45
  return { data: null, ok: true };
47
46
  if (err instanceof SyntaxError)
48
47
  return { data: null, ok: false, error: `${filePath}: invalid JSON (${getErrorMessage(err)})` };
@@ -53,44 +52,46 @@ function loadJsonFile(filePath) {
53
52
  function validateMarketProfiles(data, filePath, problems) {
54
53
  if (!data)
55
54
  return;
56
- if ('version' in data && typeof data.version !== 'number') {
55
+ const doc = data;
56
+ if ('version' in doc && typeof doc.version !== 'number') {
57
57
  push(problems, filePath, 'version', `Must be a number`);
58
58
  }
59
- const profiles = Array.isArray(data.profiles) ? data.profiles : [];
59
+ const profiles = Array.isArray(doc.profiles) ? doc.profiles : [];
60
60
  profiles.forEach((p, idx) => {
61
61
  const prefix = `profiles[${idx}]`;
62
62
  if (typeof p !== 'object' || p === null)
63
63
  return;
64
- for (const key of Object.keys(p)) {
64
+ const prof = p;
65
+ for (const key of Object.keys(prof)) {
65
66
  if (!PROFILE_KNOWN_FIELDS.has(key)) {
66
67
  push(problems, filePath, `${prefix}.${key}`, `Unrecognized field "${key}"`, 'warn');
67
68
  }
68
69
  }
69
- if ('assetA' in p && typeof p.assetA !== 'string') {
70
+ if ('assetA' in prof && typeof prof.assetA !== 'string') {
70
71
  push(problems, filePath, `${prefix}.assetA`, `Must be a string`);
71
72
  }
72
- if ('assetB' in p && typeof p.assetB !== 'string') {
73
+ if ('assetB' in prof && typeof prof.assetB !== 'string') {
73
74
  push(problems, filePath, `${prefix}.assetB`, `Must be a string`);
74
75
  }
75
- if ('defaultAma' in p && typeof p.defaultAma !== 'string') {
76
+ if ('defaultAma' in prof && typeof prof.defaultAma !== 'string') {
76
77
  push(problems, filePath, `${prefix}.defaultAma`, `Must be a string`);
77
78
  }
78
- if ('intervalSeconds' in p && !isPositiveFinite(p.intervalSeconds)) {
79
+ if ('intervalSeconds' in prof && !isPositiveFinite(prof.intervalSeconds)) {
79
80
  push(problems, filePath, `${prefix}.intervalSeconds`, `Must be a positive number`);
80
81
  }
81
- if (p.amas && typeof p.amas === 'object') {
82
- for (const [amaKey, amaVal] of Object.entries(p.amas)) {
82
+ if (prof.amas && typeof prof.amas === 'object') {
83
+ for (const [amaKey, amaVal] of Object.entries(prof.amas)) {
83
84
  const ap = `${prefix}.amas.${amaKey}`;
84
85
  if (typeof amaVal !== 'object' || amaVal === null) {
85
86
  push(problems, filePath, ap, `Must be an object`);
86
87
  continue;
87
88
  }
88
- for (const k of Object.keys(amaVal)) {
89
+ const v = amaVal;
90
+ for (const k of Object.keys(v)) {
89
91
  if (!PROFILE_AMA_KNOWN_FIELDS.has(k)) {
90
92
  push(problems, filePath, `${ap}.${k}`, `Unrecognized field "${k}"`, 'warn');
91
93
  }
92
94
  }
93
- const v = amaVal;
94
95
  if ('erPeriod' in v && !isPositiveFinite(v.erPeriod)) {
95
96
  push(problems, filePath, `${ap}.erPeriod`, `Must be a positive number`);
96
97
  }
@@ -108,7 +109,8 @@ function validateMarketProfiles(data, filePath, problems) {
108
109
  function validateWhitelist(data, filePath, problems) {
109
110
  if (!data)
110
111
  return;
111
- const raw = data.whitelist;
112
+ const doc = data;
113
+ const raw = doc.whitelist;
112
114
  if (raw === undefined) {
113
115
  push(problems, filePath, 'whitelist', `Missing required key "whitelist"`);
114
116
  return;
@@ -136,8 +138,9 @@ function validateWhitelist(data, filePath, problems) {
136
138
  }
137
139
  }
138
140
  for (const flag of WHITELIST_KNOWN_FLAGS) {
139
- if (flag in entry && typeof entry[flag] !== 'boolean') {
140
- push(problems, filePath, `${prefix}.${flag}`, `Must be a boolean, got ${typeof entry[flag]}`);
141
+ const entryObj = entry;
142
+ if (flag in entryObj && typeof entryObj[flag] !== 'boolean') {
143
+ push(problems, filePath, `${prefix}.${flag}`, `Must be a boolean, got ${typeof entryObj[flag]}`);
141
144
  }
142
145
  }
143
146
  }
@@ -147,39 +150,41 @@ function validateWhitelist(data, filePath, problems) {
147
150
  function validateMarketAdapterSettings(data, filePath, problems) {
148
151
  if (!data)
149
152
  return;
150
- for (const key of Object.keys(data)) {
153
+ const doc = data;
154
+ for (const key of Object.keys(doc)) {
151
155
  if (!MA_SETTINGS_KNOWN_FIELDS.has(key)) {
152
156
  push(problems, filePath, key, `Unrecognized field "${key}"`, 'warn');
153
157
  }
154
158
  }
155
- if ('globals' in data && data.globals !== null) {
156
- if (typeof data.globals !== 'object') {
159
+ if ('globals' in doc && doc.globals !== null) {
160
+ if (typeof doc.globals !== 'object') {
157
161
  push(problems, filePath, 'globals', `Must be an object`);
158
162
  }
159
163
  }
160
- if ('pairs' in data && data.pairs !== null) {
161
- if (!Array.isArray(data.pairs)) {
164
+ if ('pairs' in doc && doc.pairs !== null) {
165
+ if (!Array.isArray(doc.pairs)) {
162
166
  push(problems, filePath, 'pairs', `Must be an array`);
163
167
  }
164
168
  else {
165
- data.pairs.forEach((pair, idx) => {
169
+ doc.pairs.forEach((pair, idx) => {
166
170
  const prefix = `pairs[${idx}]`;
167
171
  if (typeof pair !== 'object' || pair === null)
168
172
  return;
169
- for (const key of Object.keys(pair)) {
173
+ const pr = pair;
174
+ for (const key of Object.keys(pr)) {
170
175
  if (!MA_PAIR_KNOWN_FIELDS.has(key)) {
171
176
  push(problems, filePath, `${prefix}.${key}`, `Unrecognized field "${key}"`, 'warn');
172
177
  }
173
178
  }
174
- if ('key' in pair && typeof pair.key !== 'string') {
179
+ if ('key' in pr && typeof pr.key !== 'string') {
175
180
  push(problems, filePath, `${prefix}.key`, `Must be a string`);
176
181
  }
177
- if ('marketAdapterSettings' in pair && pair.marketAdapterSettings !== null
178
- && typeof pair.marketAdapterSettings !== 'object') {
182
+ if ('marketAdapterSettings' in pr && pr.marketAdapterSettings !== null
183
+ && typeof pr.marketAdapterSettings !== 'object') {
179
184
  push(problems, filePath, `${prefix}.marketAdapterSettings`, `Must be an object`);
180
185
  }
181
- if ('botOverrides' in pair && pair.botOverrides !== null
182
- && typeof pair.botOverrides !== 'object') {
186
+ if ('botOverrides' in pr && pr.botOverrides !== null
187
+ && typeof pr.botOverrides !== 'object') {
183
188
  push(problems, filePath, `${prefix}.botOverrides`, `Must be an object`);
184
189
  }
185
190
  });
@@ -190,19 +195,20 @@ function validateMarketAdapterSettings(data, filePath, problems) {
190
195
  function validateGeneralSettings(data, filePath, problems) {
191
196
  if (!data)
192
197
  return;
193
- for (const key of Object.keys(data)) {
198
+ const doc = data;
199
+ for (const key of Object.keys(doc)) {
194
200
  if (!GENERAL_SETTINGS_KNOWN_FIELDS.has(key) && !key.startsWith('_')) {
195
201
  push(problems, filePath, key, `Unrecognized field "${key}" — may be stale/misspelled, has no effect`, 'warn');
196
202
  }
197
203
  }
198
- if ('LOG_LEVEL' in data && data.LOG_LEVEL !== undefined) {
204
+ if ('LOG_LEVEL' in doc && doc.LOG_LEVEL !== undefined) {
199
205
  const valid = ['debug', 'info', 'warn', 'error', 'critical'];
200
- if (!valid.includes(String(data.LOG_LEVEL).toLowerCase())) {
201
- push(problems, filePath, 'LOG_LEVEL', `Must be one of: ${valid.join(', ')}, got ${JSON.stringify(data.LOG_LEVEL)}`, 'warn');
206
+ if (!valid.includes(String(doc.LOG_LEVEL).toLowerCase())) {
207
+ push(problems, filePath, 'LOG_LEVEL', `Must be one of: ${valid.join(', ')}, got ${JSON.stringify(doc.LOG_LEVEL)}`, 'warn');
202
208
  }
203
209
  }
204
- if ('MARKET_ADAPTER' in data && data.MARKET_ADAPTER !== null && data.MARKET_ADAPTER !== undefined) {
205
- if (typeof data.MARKET_ADAPTER !== 'object') {
210
+ if ('MARKET_ADAPTER' in doc && doc.MARKET_ADAPTER !== null && doc.MARKET_ADAPTER !== undefined) {
211
+ if (typeof doc.MARKET_ADAPTER !== 'object') {
206
212
  push(problems, filePath, 'MARKET_ADAPTER', `Must be an object`);
207
213
  }
208
214
  }
@@ -215,7 +221,8 @@ function validateCrossFileConsistency(problems) {
215
221
  const wlFile = PATHS.PROFILES.MARKET_ADAPTER_WHITELIST_JSON();
216
222
  const wlResult = loadJsonFile(wlFile);
217
223
  if (wlResult.ok && wlResult.data) {
218
- const raw = wlResult.data.whitelist;
224
+ const wlDoc = wlResult.data;
225
+ const raw = wlDoc.whitelist;
219
226
  if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
220
227
  for (const [botKey, entry] of Object.entries(raw)) {
221
228
  botKeysInWhitelist.add(botKey);
@@ -240,7 +247,8 @@ function validateCrossFileConsistency(problems) {
240
247
  const mpResult = loadJsonFile(mpFile);
241
248
  const profiles = [];
242
249
  if (mpResult.ok && mpResult.data) {
243
- const raw = Array.isArray(mpResult.data.profiles) ? mpResult.data.profiles : [];
250
+ const mpDoc = mpResult.data;
251
+ const raw = Array.isArray(mpDoc.profiles) ? mpDoc.profiles : [];
244
252
  profiles.push(...raw);
245
253
  }
246
254
  // Load bots.json — match AMA bots against profiles and whitelist
@@ -248,16 +256,18 @@ function validateCrossFileConsistency(problems) {
248
256
  const botsResult = loadJsonFile(botsFile);
249
257
  const amaBotKeys = new Set();
250
258
  if (botsResult.ok && botsResult.data) {
251
- const bots = Array.isArray(botsResult.data.bots) ? botsResult.data.bots : [];
259
+ const botsDoc = botsResult.data;
260
+ const bots = Array.isArray(botsDoc.bots) ? botsDoc.bots : [];
252
261
  bots.forEach((bot, idx) => {
253
262
  if (!bot)
254
263
  return;
255
- const gp = bot.gridPrice;
264
+ const botObj = bot;
265
+ const gp = botObj.gridPrice;
256
266
  const usesAma = typeof gp === 'string' && /^ama(?:[1-4])?$/i.test(gp.trim());
257
267
  if (!usesAma)
258
268
  return;
259
- const name = bot.name || `unnamed-${idx}`;
260
- const botKey = normalizeBotEntry(bot, idx).botKey;
269
+ const name = botObj.name || `unnamed-${idx}`;
270
+ const botKey = normalizeBotEntry(botObj, idx).botKey || '';
261
271
  amaBotKeys.add(botKey);
262
272
  // Check whitelist: warn if AMA bot has no whitelist entry
263
273
  if (botKeysInWhitelist.size > 0 && !botKeysInWhitelistEnabledAma.has(botKey)) {
@@ -338,7 +348,7 @@ function printValidationProblems(result) {
338
348
  console.warn('═══════════════════════════════════════════');
339
349
  for (const w of result.warnings) {
340
350
  console.warn(` * ${w.file}:${w.field}`);
341
- console.warn(` ${w.message}`);
351
+ console.warn(` ${getErrorMessage(w)}`);
342
352
  }
343
353
  console.warn('');
344
354
  }
@@ -348,7 +358,7 @@ function printValidationProblems(result) {
348
358
  console.error('═══════════════════════════════════════════');
349
359
  for (const e of result.errors) {
350
360
  console.error(` * ${e.file}:${e.field}`);
351
- console.error(` ${e.message}`);
361
+ console.error(` ${getErrorMessage(e)}`);
352
362
  }
353
363
  console.error('');
354
364
  return false;
@@ -63,14 +63,14 @@
63
63
  * dir (never in the package dir — npm reinstalls wipe that).
64
64
  */
65
65
  /** How the running copy was installed — selects the hint text. */
66
- export type InstallKind = 'npm-global' | 'git' | 'other';
66
+ type InstallKind = 'npm-global' | 'git' | 'other';
67
67
  /**
68
68
  * The pending one-time announcement: what the operator is told when a newer
69
69
  * release exists and has not been displayed yet. It carries DATA only — the
70
70
  * wording and colour are rendered by `printVersionStatus`, so there is exactly
71
71
  * one place that decides how a version verdict looks.
72
72
  */
73
- export interface VersionNotice {
73
+ interface VersionNotice {
74
74
  currentVersion: string;
75
75
  latestVersion: string;
76
76
  installKind: InstallKind;
@@ -79,8 +79,8 @@ export interface VersionNotice {
79
79
  cacheFile: string;
80
80
  }
81
81
  /** Green when current, orange when a newer release exists, gray when unknown. */
82
- export type VersionState = 'up-to-date' | 'update-available' | 'unknown';
83
- export interface VersionStatus {
82
+ type VersionState = 'up-to-date' | 'update-available' | 'unknown';
83
+ interface VersionStatus {
84
84
  /** Installed version — `Config.VERSION` unless overridden. */
85
85
  currentVersion: string;
86
86
  /** Latest version observed this run, or from the throttle cache. Null when
@@ -106,7 +106,7 @@ export interface VersionStatus {
106
106
  * that latches it. */
107
107
  notice: VersionNotice | null;
108
108
  }
109
- export interface VersionNoticeOptions {
109
+ interface VersionNoticeOptions {
110
110
  /** Override the installed version (defaults to `Config.VERSION`). */
111
111
  currentVersion?: string;
112
112
  /** Override the cache location (tests). */
@@ -126,7 +126,7 @@ export interface VersionNoticeOptions {
126
126
  /** Override install-kind detection (tests). */
127
127
  installKind?: InstallKind;
128
128
  /** Injectable fetch, for offline/hermetic tests. */
129
- fetchImpl?: (url: string, init: any) => Promise<any>;
129
+ fetchImpl?: FetchImpl;
130
130
  /** Injected clock (tests). */
131
131
  now?: number;
132
132
  /** Ignore the throttle window. */
@@ -148,13 +148,24 @@ export interface VersionNoticeOptions {
148
148
  export declare function compareVersions(a: string, b: string): number;
149
149
  /** Classify the running install without spawning anything. */
150
150
  export declare function detectInstallKind(projectRoot?: string): InstallKind;
151
+ /** Minimal structural view of a fetch response used by the probe. */
152
+ interface FetchResponseLike {
153
+ ok?: boolean;
154
+ status?: number;
155
+ json(): Promise<unknown>;
156
+ }
157
+ type FetchImpl = (url: string, init: {
158
+ method?: string;
159
+ headers?: Record<string, string>;
160
+ signal?: AbortSignal;
161
+ }) => Promise<FetchResponseLike | null | undefined>;
151
162
  /** One place the published version can be read from. */
152
- export interface VersionSource {
163
+ interface VersionSource {
153
164
  id: string;
154
165
  url: string;
155
166
  /** Pull the version out of the source's JSON shape. Returns null when the
156
167
  * document does not carry a usable version (bad payload). */
157
- extract: (body: any) => string | null;
168
+ extract: (body: unknown) => string | null;
158
169
  }
159
170
  /**
160
171
  * Derive the GitHub "latest release" endpoint from the configured repository
@@ -228,7 +239,7 @@ export interface ProbeResult {
228
239
  * would otherwise leave the fallback with no time at all, which is precisely
229
240
  * the case the fallback exists for.
230
241
  */
231
- export declare function probeReleaseSources(sources: VersionSource[], timeoutMs: number, fetchImpl?: any): Promise<ProbeResult>;
242
+ export declare function probeReleaseSources(sources: VersionSource[], timeoutMs: number, fetchImpl?: FetchImpl): Promise<ProbeResult>;
232
243
  /**
233
244
  * Start the check. Resolves with the installed-vs-published status, plus a
234
245
  * `notice` when a NEWER version exists and that version has not been
@@ -285,7 +296,7 @@ export declare function flushVersionStatusOrHeader(pending: Promise<VersionStatu
285
296
  * same contract as `flushVersionStatusOrHeader`.
286
297
  */
287
298
  export declare function printVersionStatusWhenReady(pending: Promise<VersionStatus | null>): void;
288
- export interface StagedVersionNoticeOptions extends VersionNoticeOptions {
299
+ interface StagedVersionNoticeOptions extends VersionNoticeOptions {
289
300
  /** Wait at the top of the command before the caller prints anything else.
290
301
  * Default `UPDATER.NOTICE_STAGE_GRACE_MS` (1s). */
291
302
  graceMs?: number;
@@ -293,7 +304,7 @@ export interface StagedVersionNoticeOptions extends VersionNoticeOptions {
293
304
  * `UPDATER.NOTICE_STATUS_TIMEOUT_MS`. */
294
305
  finalMs?: number;
295
306
  }
296
- export interface StagedVersionWait {
307
+ interface StagedVersionWait {
297
308
  /** The status if it lands within `graceMs`, else null. Await this at the
298
309
  * top of a report; the value is only interesting for its TIMING. */
299
310
  quick: Promise<VersionStatus | null>;
@@ -308,4 +319,5 @@ export interface StagedVersionWait {
308
319
  * carries the whole escalation.
309
320
  */
310
321
  export declare function startStagedVersionStatus(options?: StagedVersionNoticeOptions): StagedVersionWait;
322
+ export {};
311
323
  //# sourceMappingURL=version_notice.d.ts.map
@@ -126,7 +126,8 @@ const NPM_EXTRACT = (body) => typeof body?.version === 'string' && body.version.
126
126
  * sources are directly comparable.
127
127
  */
128
128
  const GITHUB_EXTRACT = (body) => {
129
- const tag = body?.tag_name ?? body?.name;
129
+ const rec = body;
130
+ const tag = rec?.tag_name ?? rec?.name;
130
131
  return typeof tag === 'string' && tag.trim() ? tag.trim() : null;
131
132
  };
132
133
  /**
@@ -271,13 +272,14 @@ function resolveTimeoutMs(override) {
271
272
  * `cause.code` is the useful part (`ENOTFOUND`, `ECONNREFUSED`,
272
273
  * `CERT_HAS_EXPIRED`, `UND_ERR_SOCKET`); the wrapper message is noise. */
273
274
  function describeFetchError(err, source, timeoutMs) {
274
- const code = err?.cause?.code || err?.code;
275
+ const e = err;
276
+ const code = e?.cause?.code || e?.code;
275
277
  if (code)
276
278
  return `${source.id}: ${code}`;
277
- const name = String(err?.name ?? '');
279
+ const name = String(e?.name ?? '');
278
280
  if (name === 'AbortError' || name === 'TimeoutError')
279
281
  return `${source.id}: timeout after ${timeoutMs}ms`;
280
- const message = String(err?.message ?? '').trim();
282
+ const message = String(e?.message ?? '').trim();
281
283
  return message ? `${source.id}: ${message.split('\n')[0].slice(0, 60)}` : `${source.id}: request failed`;
282
284
  }
283
285
  /**
package/dist/pm2.d.ts CHANGED
@@ -1,9 +1,23 @@
1
1
  #!/usr/bin/env node
2
+ import { type BotEntry } from './modules/bot_settings.js';
2
3
  import { buildScopedChildEnv } from './modules/launcher/child_env.js';
3
4
  import { usesAmaGridPrice } from './modules/dexbot_maintenance_runtime.js';
4
- declare function needsMarketAdapter(bots: any): any;
5
- declare function isServiceApp(app: any): boolean;
6
- declare function countManagedBots(apps: any): any;
5
+ interface Pm2App {
6
+ name: string;
7
+ script: string;
8
+ cwd: string;
9
+ args?: string;
10
+ env?: Record<string, string>;
11
+ [key: string]: unknown;
12
+ }
13
+ interface CredentialBootstrap {
14
+ socketPath: string;
15
+ waitForTransfer(): Promise<unknown>;
16
+ close(): void;
17
+ }
18
+ declare function needsMarketAdapter(bots: BotEntry[] | null | undefined): boolean;
19
+ declare function isServiceApp(app: Pm2App | null | undefined): boolean;
20
+ declare function countManagedBots(apps: Pm2App[] | null | undefined): number;
7
21
  /**
8
22
  * Build PM2 app definitions for the current runtime.
9
23
  * @param {Array<Object>} bots - Active bot entries.
@@ -11,24 +25,12 @@ declare function countManagedBots(apps: any): any;
11
25
  * @param {boolean} [options.includeUpdater=true] - Whether to add the updater service.
12
26
  * @returns {Array<Object>} PM2 app definitions.
13
27
  */
14
- declare function buildEcosystemApps(bots: any, { includeUpdater }?: {
28
+ declare function buildEcosystemApps(bots: BotEntry[] | null | undefined, { includeUpdater }?: {
15
29
  includeUpdater?: boolean;
16
- }): any;
30
+ }): Pm2App[];
17
31
  declare function buildCredentialDaemonApp({ credentialEnv }?: {
18
- credentialEnv?: any;
19
- }): {
20
- name: string;
21
- script: string;
22
- cwd: string;
23
- autorestart: boolean;
24
- error_file: string;
25
- out_file: string;
26
- log_date_format: string;
27
- merge_logs: boolean;
28
- combine_logs: boolean;
29
- max_size: string;
30
- env: any;
31
- };
32
+ credentialEnv?: Record<string, string>;
33
+ }): Pm2App;
32
34
  /**
33
35
  * Generate ecosystem.config.cjs from bots.json or claw-only mode.
34
36
  * @param {Object} [options={}] - Generation options.
@@ -41,10 +43,9 @@ declare function generateEcosystemConfig({ botNameFilter, clawOnly, exitOnError
41
43
  botNameFilter?: string | null;
42
44
  clawOnly?: boolean;
43
45
  exitOnError?: boolean;
44
- }): any;
46
+ }): Pm2App[];
45
47
  declare function ensureCredentialDaemonPM2({ forceRefresh, headless, passwordFile }?: {
46
48
  forceRefresh?: boolean;
47
- logReuse?: any;
48
49
  headless?: boolean;
49
50
  passwordFile?: string | null;
50
51
  }): Promise<boolean>;
@@ -62,8 +63,8 @@ declare function main({ botNameFilter, clawOnly, headless, passwordFile }?: {
62
63
  passwordFile?: string | null;
63
64
  }): Promise<void>;
64
65
  declare function startManagedRuntimePM2({ apps, bootstrap }?: {
65
- apps?: any;
66
- bootstrap?: any;
66
+ apps?: Pm2App[] | null;
67
+ bootstrap?: CredentialBootstrap | null;
67
68
  }): Promise<void>;
68
69
  /**
69
70
  * Stop PM2 processes based on target.
@@ -71,15 +72,15 @@ declare function startManagedRuntimePM2({ apps, bootstrap }?: {
71
72
  * @returns {Promise<void>}
72
73
  * @throws {Error} If target not found or stopping fails.
73
74
  */
74
- declare function stopPM2Processes(target: any): Promise<void>;
75
+ declare function stopPM2Processes(target: string): Promise<void>;
75
76
  /**
76
77
  * Delete PM2 processes based on target.
77
78
  * @param {string} target - 'all' or specific bot name.
78
79
  * @returns {Promise<void>}
79
80
  * @throws {Error} If target not found or deleting fails.
80
81
  */
81
- declare function deletePM2Processes(target: any): Promise<void>;
82
- declare function restartPM2Processes(target: any, { headless, passwordFile }?: {
82
+ declare function deletePM2Processes(target: string): Promise<void>;
83
+ declare function restartPM2Processes(target: string, { headless, passwordFile }?: {
83
84
  headless?: boolean;
84
85
  passwordFile?: string | null;
85
86
  }): Promise<void>;
@@ -91,7 +92,7 @@ declare function restartPM2Processes(target: any, { headless, passwordFile }?: {
91
92
  * @returns {Promise<void>}
92
93
  * @throws {Error} If target not found, is dexbot-cred, or reloading fails.
93
94
  */
94
- declare function reloadPM2Processes(target: any): Promise<void>;
95
+ declare function reloadPM2Processes(target: string): Promise<void>;
95
96
  export { buildCredentialDaemonApp, buildEcosystemApps, buildScopedChildEnv, countManagedBots, deletePM2Processes, ensureCredentialDaemonPM2, generateEcosystemConfig, isServiceApp, main, needsMarketAdapter, reloadPM2Processes, restartPM2Processes, stopPM2Processes, startManagedRuntimePM2, usesAmaGridPrice };
96
97
  declare const _default: {
97
98
  buildCredentialDaemonApp: typeof buildCredentialDaemonApp;