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.
- package/CHANGELOG.md +67 -4
- package/README.md +2 -1
- package/analysis/README.md +11 -11
- package/analysis/ama_fitting/README.md +5 -3
- package/analysis/tradingview/README.md +1 -1
- package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
- package/claw/README.md +1 -0
- package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
- package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
- package/claw/modules/chain_broadcast.ts +7 -1
- package/claw/modules/claw_bridge.ts +0 -3
- package/claw/modules/claw_launcher.ts +1 -1
- package/claw/modules/claw_skill_md.ts +1 -0
- package/claw/modules/launcher_mode_detector.ts +9 -2
- package/claw/package.json +3 -3
- package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
- package/claw/runtimes/openclaw-plugin/package.json +1 -1
- package/claw/tsconfig.json +2 -2
- package/dist/analysis/account_resolver.d.ts +1 -1
- package/dist/analysis/account_resolver.js +2 -1
- package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
- package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
- package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
- package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
- package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
- package/dist/analysis/analyze_args.d.ts +43 -0
- package/dist/analysis/analyze_args.js +61 -0
- package/dist/analysis/analyze_dynamic_weight.js +7 -17
- package/dist/analysis/analyze_kalman.js +7 -17
- package/dist/analysis/analyze_regime.js +7 -17
- package/dist/analysis/analyze_regime_windows.js +8 -18
- package/dist/analysis/analyze_risk_profile.js +8 -18
- package/dist/analysis/analyze_trade_heatmap.js +7 -17
- package/dist/analysis/analyze_volatility.js +7 -17
- package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
- package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
- package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
- package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
- package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
- package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
- package/dist/analysis/bot_fitting/shared_utils.js +125 -9
- package/dist/analysis/bot_key_utils.d.ts +18 -10
- package/dist/analysis/bot_key_utils.js +7 -4
- package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
- package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
- package/dist/analysis/chain_pool.d.ts +3 -1
- package/dist/analysis/chart_ui.d.ts +35 -3
- package/dist/analysis/chart_ui.js +43 -4
- package/dist/analysis/chart_utils.d.ts +5 -5
- package/dist/analysis/chart_utils.js +9 -0
- package/dist/analysis/fills_cache.d.ts +4 -24
- package/dist/analysis/fills_cache.js +3 -84
- package/dist/analysis/fills_source.d.ts +33 -3
- package/dist/analysis/fills_source.js +83 -13
- package/dist/analysis/grid_correction_check.d.ts +2 -24
- package/dist/analysis/grid_correction_check.js +27 -69
- package/dist/analysis/math_utils.d.ts +91 -6
- package/dist/analysis/math_utils.js +119 -7
- package/dist/analysis/pnl_report.js +29 -29
- package/dist/analysis/price_sources.d.ts +30 -9
- package/dist/analysis/price_sources.js +28 -4
- package/dist/analysis/resolve_bot_accounts.js +2 -2
- package/dist/analysis/resolve_source.d.ts +1 -1
- package/dist/analysis/resolve_source.js +31 -10
- package/dist/analysis/trade_profitability.d.ts +29 -2
- package/dist/analysis/trade_profitability.js +73 -147
- package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
- package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
- package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
- package/dist/analysis/tradingview/grid_reset_config.js +23 -11
- package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
- package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
- package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
- package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
- package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
- package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
- package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
- package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
- package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
- package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
- package/dist/analysis/worker_pool.d.ts +38 -0
- package/dist/analysis/worker_pool.js +67 -0
- package/dist/credential-daemon.js +34 -20
- package/dist/dexbot.js +78 -59
- package/dist/market_adapter/ama_signal_runner.js +21 -54
- package/dist/market_adapter/candle_utils.d.ts +29 -19
- package/dist/market_adapter/candle_utils.js +35 -21
- package/dist/market_adapter/cli_args.d.ts +22 -0
- package/dist/market_adapter/cli_args.js +30 -0
- package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
- package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
- package/dist/market_adapter/core/config_normalizers.js +11 -6
- package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
- package/dist/market_adapter/core/kibana_candles.js +12 -9
- package/dist/market_adapter/core/kibana_client.d.ts +9 -1
- package/dist/market_adapter/core/kibana_client.js +8 -7
- package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
- package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
- package/dist/market_adapter/core/market_adapter_service.js +228 -269
- package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
- package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
- package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
- package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
- package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
- package/dist/market_adapter/core/strategies/ama.js +2 -4
- package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
- package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
- package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
- package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
- package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
- package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
- package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
- package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
- package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
- package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
- package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
- package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
- package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
- package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
- package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
- package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
- package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
- package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
- package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
- package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
- package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
- package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
- package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
- package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
- package/dist/market_adapter/inputs/kibana_source.js +2 -2
- package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
- package/dist/market_adapter/inputs/window_cache.js +59 -184
- package/dist/market_adapter/interval_utils.d.ts +15 -5
- package/dist/market_adapter/interval_utils.js +16 -1
- package/dist/market_adapter/log_format.d.ts +6 -6
- package/dist/market_adapter/log_format.js +28 -21
- package/dist/market_adapter/lp_chart_core.d.ts +22 -1
- package/dist/market_adapter/lp_chart_core.js +26 -192
- package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
- package/dist/market_adapter/lp_chart_runner.js +37 -19
- package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
- package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
- package/dist/market_adapter/market_adapter.d.ts +94 -32
- package/dist/market_adapter/market_adapter.js +94 -120
- package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
- package/dist/market_adapter/utils/adapter_client.js +2 -2
- package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
- package/dist/market_adapter/utils/chain.d.ts +50 -41
- package/dist/market_adapter/utils/chain.js +40 -46
- package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
- package/dist/market_adapter/utils/data_discovery.js +220 -27
- package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
- package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
- package/dist/market_adapter/utils/file_lock.d.ts +28 -14
- package/dist/market_adapter/utils/file_lock.js +36 -32
- package/dist/market_adapter/utils/month_shards.d.ts +84 -0
- package/dist/market_adapter/utils/month_shards.js +237 -0
- package/dist/market_adapter/utils/native_history.d.ts +9 -2
- package/dist/market_adapter/utils/native_history.js +35 -28
- package/dist/modules/account_bots.d.ts +578 -21
- package/dist/modules/account_bots.js +272 -267
- package/dist/modules/account_orders.d.ts +79 -30
- package/dist/modules/account_orders.js +60 -64
- package/dist/modules/authority_resolver.d.ts +12 -2
- package/dist/modules/authority_resolver.js +15 -8
- package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
- package/dist/modules/bitshares-native/chain_client.js +59 -59
- package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
- package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
- package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
- package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
- package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
- package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
- package/dist/modules/bitshares-native/index.d.ts +1 -1
- package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
- package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
- package/dist/modules/bitshares-native/resolvers.js +22 -25
- package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
- package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
- package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
- package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
- package/dist/modules/bitshares-native/serial/serializer.js +7 -13
- package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
- package/dist/modules/bitshares-native/serial/types.js +73 -108
- package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
- package/dist/modules/bitshares-native/signing_client.js +19 -14
- package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
- package/dist/modules/bitshares-native/subscriptions.js +12 -12
- package/dist/modules/bitshares-native/transport.d.ts +5 -4
- package/dist/modules/bitshares-native/transport.js +5 -4
- package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
- package/dist/modules/bitshares-native/tx/builder.js +4 -3
- package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
- package/dist/modules/bitshares_client.d.ts +45 -13
- package/dist/modules/bitshares_client.js +28 -19
- package/dist/modules/bot_defaults.d.ts +8 -16
- package/dist/modules/bot_defaults.js +1 -5
- package/dist/modules/bot_settings.d.ts +44 -10
- package/dist/modules/bot_settings.js +11 -8
- package/dist/modules/bots_file_lock.d.ts +6 -6
- package/dist/modules/bots_file_lock.js +16 -12
- package/dist/modules/broadcast_failure.d.ts +4 -3
- package/dist/modules/broadcast_failure.js +5 -4
- package/dist/modules/chain_keys.d.ts +42 -40
- package/dist/modules/chain_keys.js +53 -45
- package/dist/modules/chain_orders.d.ts +94 -60
- package/dist/modules/chain_orders.js +81 -118
- package/dist/modules/cli_start_onboarding.d.ts +2 -1
- package/dist/modules/constants.d.ts +534 -32
- package/dist/modules/constants.js +35 -48
- package/dist/modules/cr_planner.d.ts +41 -3
- package/dist/modules/cr_planner.js +1 -5
- package/dist/modules/credential_policy.d.ts +68 -8
- package/dist/modules/credential_policy.js +37 -31
- package/dist/modules/credential_session_cache.d.ts +2 -2
- package/dist/modules/credit_pricing.d.ts +43 -6
- package/dist/modules/credit_pricing.js +70 -60
- package/dist/modules/credit_runtime.d.ts +283 -118
- package/dist/modules/credit_runtime.js +500 -231
- package/dist/modules/crypto/browser_provider.js +6 -4
- package/dist/modules/crypto/node_provider.js +1 -1
- package/dist/modules/crypto/pure_scrypt.js +35 -4
- package/dist/modules/crypto/pure_secp256k1.js +72 -26
- package/dist/modules/crypto/sync.d.ts +9 -9
- package/dist/modules/crypto/sync.js +16 -9
- package/dist/modules/daemon_node_health.d.ts +4 -3
- package/dist/modules/dexbot_class.d.ts +213 -146
- package/dist/modules/dexbot_class.js +183 -86
- package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
- package/dist/modules/dexbot_cow_runtime.js +302 -234
- package/dist/modules/dexbot_credential_client.d.ts +19 -18
- package/dist/modules/dexbot_credential_client.js +1 -2
- package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
- package/dist/modules/dexbot_fill_runtime.js +53 -47
- package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
- package/dist/modules/dexbot_maintenance_runtime.js +187 -147
- package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
- package/dist/modules/dexbot_startup_runtime.js +56 -57
- package/dist/modules/dexbot_state_recovery.d.ts +13 -12
- package/dist/modules/dexbot_state_recovery.js +18 -13
- package/dist/modules/fund_registry.d.ts +4 -2
- package/dist/modules/fund_registry.js +10 -10
- package/dist/modules/general_settings.d.ts +30 -4
- package/dist/modules/graceful_shutdown.d.ts +3 -3
- package/dist/modules/graceful_shutdown.js +19 -13
- package/dist/modules/grid_price_source.d.ts +1 -1
- package/dist/modules/key_store.d.ts +14 -8
- package/dist/modules/key_store.js +7 -7
- package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
- package/dist/modules/launcher/adapter_requirement.js +5 -5
- package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
- package/dist/modules/launcher/bot_supervisor.js +12 -11
- package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
- package/dist/modules/launcher/credential_bootstrap.js +1 -1
- package/dist/modules/launcher/credential_daemon.d.ts +4 -4
- package/dist/modules/launcher/credential_daemon.js +2 -2
- package/dist/modules/launcher/credential_secret.d.ts +1 -1
- package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
- package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
- package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
- package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
- package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
- package/dist/modules/launcher/status_reporting.d.ts +22 -14
- package/dist/modules/launcher/supervisor_control.d.ts +8 -1
- package/dist/modules/launcher/supervisor_control.js +4 -2
- package/dist/modules/lazy_shim.d.ts +11 -0
- package/dist/modules/lazy_shim.js +16 -0
- package/dist/modules/market_adapter_whitelist.d.ts +9 -3
- package/dist/modules/market_adapter_whitelist.js +15 -3
- package/dist/modules/node_connect_policy.d.ts +3 -2
- package/dist/modules/node_failure_ledger.d.ts +6 -5
- package/dist/modules/node_manager.d.ts +41 -11
- package/dist/modules/node_manager.js +5 -4
- package/dist/modules/order/accounting.d.ts +53 -24
- package/dist/modules/order/accounting.js +16 -15
- package/dist/modules/order/async_lock.d.ts +5 -2
- package/dist/modules/order/async_lock.js +1 -1
- package/dist/modules/order/export.d.ts +7 -6
- package/dist/modules/order/export.js +1 -7
- package/dist/modules/order/format.d.ts +16 -7
- package/dist/modules/order/format.js +15 -3
- package/dist/modules/order/genesis_policy.d.ts +24 -21
- package/dist/modules/order/genesis_policy.js +17 -10
- package/dist/modules/order/grid.d.ts +144 -36
- package/dist/modules/order/grid.js +226 -145
- package/dist/modules/order/grid_reconcile.d.ts +21 -20
- package/dist/modules/order/grid_reconcile.js +13 -12
- package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
- package/dist/modules/order/grid_reconcile_internal.js +28 -19
- package/dist/modules/order/index.d.ts +264 -1
- package/dist/modules/order/logger.d.ts +46 -19
- package/dist/modules/order/logger.js +38 -49
- package/dist/modules/order/logger_state.d.ts +4 -4
- package/dist/modules/order/manager.d.ts +232 -191
- package/dist/modules/order/manager.js +110 -130
- package/dist/modules/order/processed_fill_store.d.ts +18 -3
- package/dist/modules/order/processed_fill_store.js +16 -27
- package/dist/modules/order/strategy.d.ts +21 -13
- package/dist/modules/order/strategy.js +5 -6
- package/dist/modules/order/sync_engine.d.ts +91 -33
- package/dist/modules/order/sync_engine.js +84 -53
- package/dist/modules/order/utils/math.d.ts +157 -102
- package/dist/modules/order/utils/math.js +77 -38
- package/dist/modules/order/utils/order.d.ts +310 -110
- package/dist/modules/order/utils/order.js +153 -126
- package/dist/modules/order/utils/slot.d.ts +1 -1
- package/dist/modules/order/utils/system.d.ts +156 -26
- package/dist/modules/order/utils/system.js +103 -71
- package/dist/modules/order/utils/validate.d.ts +89 -41
- package/dist/modules/order/utils/validate.js +26 -24
- package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
- package/dist/modules/order/utils/withPoolRef.js +18 -12
- package/dist/modules/order/working_grid.d.ts +14 -13
- package/dist/modules/paths.d.ts +1 -4
- package/dist/modules/paths.js +33 -61
- package/dist/modules/process_discovery.d.ts +1 -1
- package/dist/modules/process_discovery.js +2 -1
- package/dist/modules/runtime.d.ts +7 -3
- package/dist/modules/runtime.js +4 -3
- package/dist/modules/runtime_settings.d.ts +14 -11
- package/dist/modules/runtime_settings.js +30 -24
- package/dist/modules/settings_merge.d.ts +29 -3
- package/dist/modules/settings_merge.js +56 -78
- package/dist/modules/socket_json_client.d.ts +9 -5
- package/dist/modules/storage/browser_adapter.d.ts +38 -53
- package/dist/modules/storage/browser_adapter.js +7 -30
- package/dist/modules/storage/index.d.ts +1 -1
- package/dist/modules/storage/node_adapter.d.ts +45 -27
- package/dist/modules/storage/node_adapter.js +9 -9
- package/dist/modules/storage/types.d.ts +5 -4
- package/dist/modules/types.d.ts +1090 -6
- package/dist/modules/types.js +4 -1
- package/dist/modules/utils/asset_symbols.d.ts +2 -1
- package/dist/modules/utils/asset_symbols.js +2 -1
- package/dist/modules/utils/errors.d.ts +9 -0
- package/dist/modules/utils/errors.js +24 -4
- package/dist/modules/utils/time_range.d.ts +1 -12
- package/dist/modules/utils/time_range.js +1 -1
- package/dist/modules/validate_profiles.js +53 -43
- package/dist/modules/version_notice.d.ts +23 -11
- package/dist/modules/version_notice.js +6 -4
- package/dist/pm2.d.ts +28 -27
- package/dist/pm2.js +61 -40
- package/dist/scripts/analyze-credit.d.ts +2 -1
- package/dist/scripts/analyze-credit.js +23 -24
- package/dist/scripts/analyze-git.js +2 -15
- package/dist/scripts/analyze-orders.d.ts +77 -9
- package/dist/scripts/analyze-orders.js +65 -40
- package/dist/scripts/chart_command.d.ts +27 -18
- package/dist/scripts/chart_command.js +15 -13
- package/dist/scripts/check_any.d.ts +22 -0
- package/dist/scripts/check_any.js +158 -0
- package/dist/scripts/diagnose-pool-history.js +13 -13
- package/dist/scripts/print_grid.js +0 -1
- package/dist/scripts/run-tests.js +39 -8
- package/dist/scripts/runner.js +1 -1
- package/dist/scripts/sync-version.js +0 -10
- package/dist/scripts/test-credit-renewal.js +30 -21
- package/dist/scripts/update.d.ts +10 -5
- package/dist/scripts/update.js +168 -103
- package/dist/scripts/update_dist_freshness.js +1 -0
- package/dist/scripts/update_layout.d.ts +61 -0
- package/dist/scripts/update_layout.js +180 -0
- package/dist/scripts/validate_bots.js +2 -1
- package/dist/scripts/verify-browser-bundle.js +8 -0
- package/dist/unlock.d.ts +28 -3
- package/dist/unlock.js +63 -35
- package/docs/BITSHARES_ONBOARDING.md +10 -12
- package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
- package/docs/COW_INVARIANTS.md +13 -6
- package/docs/DEXBOT_COMPARISON.md +8 -8
- package/docs/EVOLUTION.md +10 -8
- package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
- package/docs/GRID_RECALCULATION.md +4 -2
- package/docs/GRID_RECONCILE.md +14 -3
- package/docs/LIFECYCLE.md +11 -11
- package/docs/MPA_CREDIT_USAGE.md +22 -3
- package/docs/README.md +14 -3
- package/docs/WORKFLOW.md +1 -0
- package/docs/architecture.md +31 -19
- package/docs/developer_guide.md +6 -6
- package/market_adapter/README.md +12 -5
- package/modules/README.md +4 -1
- package/package.json +9 -9
- package/scripts/README.md +43 -38
- package/tests/README.md +25 -10
- package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
- package/dist/scripts/diagnose-kibana-candles.js +0 -82
- package/scripts/git-viewer.sh +0 -489
- package/scripts/postinstall.js +0 -16
|
@@ -4,5 +4,5 @@
|
|
|
4
4
|
* Extracted per GRID_PRICE_SLOT_DETERMINISM_PLAN §2.1 to unify duplicate
|
|
5
5
|
* parsers in math.ts:1611 and order.ts:915 and make fail-closed explicit.
|
|
6
6
|
*/
|
|
7
|
-
export declare function parseSlotIndex(id:
|
|
7
|
+
export declare function parseSlotIndex(id: unknown): number | null;
|
|
8
8
|
//# sourceMappingURL=slot.d.ts.map
|
|
@@ -45,9 +45,65 @@
|
|
|
45
45
|
*
|
|
46
46
|
* ===============================================================================
|
|
47
47
|
*/
|
|
48
|
+
import type { OrderManagerLike, BotLike, AccountOrdersLike, ManagedOrder, AccountTotals, CowAction } from '../../types.js';
|
|
49
|
+
import type { WorkingGrid as WorkingGridType } from '../working_grid.js';
|
|
48
50
|
declare const ensureDir: (path: string, options?: {
|
|
49
51
|
mode?: number;
|
|
50
52
|
}) => void;
|
|
53
|
+
/** Minimal structural views of the external BitShares client used here. */
|
|
54
|
+
export interface AssetMeta {
|
|
55
|
+
id?: string;
|
|
56
|
+
precision?: number;
|
|
57
|
+
symbol?: string;
|
|
58
|
+
[key: string]: unknown;
|
|
59
|
+
}
|
|
60
|
+
export interface PoolReserve {
|
|
61
|
+
asset_id?: string;
|
|
62
|
+
amount?: number | string;
|
|
63
|
+
[key: string]: unknown;
|
|
64
|
+
}
|
|
65
|
+
export interface PoolEntry {
|
|
66
|
+
id?: string;
|
|
67
|
+
asset_a?: string;
|
|
68
|
+
asset_b?: string;
|
|
69
|
+
asset_ids?: string[];
|
|
70
|
+
balance_a?: number | string;
|
|
71
|
+
balance_b?: number | string;
|
|
72
|
+
reserves?: PoolReserve[];
|
|
73
|
+
[key: string]: unknown;
|
|
74
|
+
}
|
|
75
|
+
interface BitSharesDb {
|
|
76
|
+
lookup_asset_symbols?: (refs: string[]) => Promise<unknown[]>;
|
|
77
|
+
get_assets?: (refs: string[]) => Promise<unknown[]>;
|
|
78
|
+
get_objects?: (ids: string[]) => Promise<unknown[]>;
|
|
79
|
+
get_order_book?: (base: string, quote: string, depth: number) => Promise<{
|
|
80
|
+
bids?: Array<{
|
|
81
|
+
price?: unknown;
|
|
82
|
+
}>;
|
|
83
|
+
asks?: Array<{
|
|
84
|
+
price?: unknown;
|
|
85
|
+
}>;
|
|
86
|
+
}>;
|
|
87
|
+
get_ticker?: (base: string, quote: string) => Promise<{
|
|
88
|
+
latest?: unknown;
|
|
89
|
+
latest_price?: unknown;
|
|
90
|
+
}>;
|
|
91
|
+
get_liquidity_pools_by_both_assets?: (a: string, b: string) => Promise<PoolEntry[]>;
|
|
92
|
+
get_liquidity_pools_by_share_asset?: (ids: string[], a: boolean, b: boolean) => Promise<PoolEntry[]>;
|
|
93
|
+
list_liquidity_pools?: (pageSize: number, startId: string) => Promise<PoolEntry[]>;
|
|
94
|
+
get_liquidity_pools?: (pageSize: number, startId: string) => Promise<PoolEntry[]>;
|
|
95
|
+
getGlobalProperties?: () => Promise<unknown>;
|
|
96
|
+
call?: (method: string, args: unknown[]) => Promise<unknown>;
|
|
97
|
+
[key: string]: unknown;
|
|
98
|
+
}
|
|
99
|
+
interface BitSharesAssets {
|
|
100
|
+
[symbol: string]: Promise<unknown> | unknown;
|
|
101
|
+
}
|
|
102
|
+
export interface BitSharesClient {
|
|
103
|
+
db?: BitSharesDb;
|
|
104
|
+
assets?: BitSharesAssets;
|
|
105
|
+
[key: string]: unknown;
|
|
106
|
+
}
|
|
51
107
|
/**
|
|
52
108
|
* @private Lookup asset by symbol from BitShares blockchain.
|
|
53
109
|
* Tries cached assets first, then falls back to lookup API methods.
|
|
@@ -57,7 +113,7 @@ declare const ensureDir: (path: string, options?: {
|
|
|
57
113
|
* @returns {Promise<Object>} Asset metadata with id, symbol, precision
|
|
58
114
|
* @throws {Error} If asset cannot be found on blockchain
|
|
59
115
|
*/
|
|
60
|
-
export declare const lookupAsset: (BitShares:
|
|
116
|
+
export declare const lookupAsset: (BitShares: BitSharesClient, s: string) => Promise<AssetMeta | null>;
|
|
61
117
|
/**
|
|
62
118
|
* Resolve a full asset object from an asset reference (object ID like 1.3.x or symbol).
|
|
63
119
|
* Routes object IDs to get_assets and symbols to lookup_asset_symbols, trying
|
|
@@ -68,7 +124,7 @@ export declare const lookupAsset: (BitShares: any, s: string) => Promise<any>;
|
|
|
68
124
|
* @param {*} ref - Asset ID (e.g. '1.3.0') or symbol (e.g. 'BTS')
|
|
69
125
|
* @returns {Promise<Object|null>} Asset object or null if unresolvable
|
|
70
126
|
*/
|
|
71
|
-
export declare const resolveAssetByRef: (BitShares:
|
|
127
|
+
export declare const resolveAssetByRef: (BitShares: BitSharesClient, ref: unknown) => Promise<AssetMeta | null>;
|
|
72
128
|
/**
|
|
73
129
|
* Derive price from BitShares DEX order book.
|
|
74
130
|
* Returns price in B/A format (units of asset B per 1 unit of asset A).
|
|
@@ -79,7 +135,7 @@ export declare const resolveAssetByRef: (BitShares: any, ref: any) => Promise<an
|
|
|
79
135
|
* @param {string} symB - Second asset symbol
|
|
80
136
|
* @returns {Promise<number|null>} Derived market price or null if unavailable
|
|
81
137
|
*/
|
|
82
|
-
export declare const deriveMarketPrice: (BitShares:
|
|
138
|
+
export declare const deriveMarketPrice: (BitShares: BitSharesClient, symA: string, symB: string) => Promise<number | null>;
|
|
83
139
|
/**
|
|
84
140
|
* Derive price from BitShares Liquidity Pool (AMM).
|
|
85
141
|
* Returns price in B/A format (units of asset B per 1 unit of asset A).
|
|
@@ -90,13 +146,13 @@ export declare const deriveMarketPrice: (BitShares: any, symA: string, symB: str
|
|
|
90
146
|
* @param {string} symB - Second asset symbol
|
|
91
147
|
* @returns {Promise<number|null>} Derived pool price or null if unavailable
|
|
92
148
|
*/
|
|
93
|
-
export declare const derivePoolPrice: (BitShares:
|
|
149
|
+
export declare const derivePoolPrice: (BitShares: BitSharesClient, symA: string, symB: string) => Promise<number | null>;
|
|
94
150
|
/**
|
|
95
151
|
* Test-only seam: compiled ESM exports cannot be monkey-patched, so tests
|
|
96
152
|
* install a hook here to short-circuit price derivation (offline runs).
|
|
97
153
|
*/
|
|
98
|
-
export declare const setDerivePriceTestHook: (fn: ((...args:
|
|
99
|
-
export declare const derivePrice: (BitShares:
|
|
154
|
+
export declare const setDerivePriceTestHook: (fn: ((...args: unknown[]) => number | null | Promise<number | null>) | null) => void;
|
|
155
|
+
export declare const derivePrice: (BitShares: BitSharesClient, symA: string, symB: string, mode?: string) => Promise<number | null>;
|
|
100
156
|
/**
|
|
101
157
|
* Derive price via bridge assets only (no direct market attempt).
|
|
102
158
|
* Returns price in B/A format (units of asset B per 1 unit of asset A) as
|
|
@@ -110,7 +166,7 @@ export declare const derivePrice: (BitShares: any, symA: string, symB: string, m
|
|
|
110
166
|
* @param {string} [mode='auto'] - Price derivation mode passed to derivePrice
|
|
111
167
|
* @returns {Promise<{rate:number,path:string}|null>} Rate plus 'bridge:<ref>' path, or null
|
|
112
168
|
*/
|
|
113
|
-
export declare function derivePriceViaBridges(BitShares:
|
|
169
|
+
export declare function derivePriceViaBridges(BitShares: BitSharesClient, symA: string, symB: string, bridges?: string[], mode?: string): Promise<{
|
|
114
170
|
rate: number;
|
|
115
171
|
path: string;
|
|
116
172
|
} | null>;
|
|
@@ -129,7 +185,7 @@ export declare function derivePriceViaBridges(BitShares: any, symA: string, symB
|
|
|
129
185
|
* @param {string} [mode='auto'] - Price derivation mode passed to derivePrice
|
|
130
186
|
* @returns {Promise<{rate:number,path:string}|null>} Rate plus 'direct' | 'identity' | 'bridge:<ref>' path, or null
|
|
131
187
|
*/
|
|
132
|
-
export declare function derivePriceWithBridges(BitShares:
|
|
188
|
+
export declare function derivePriceWithBridges(BitShares: BitSharesClient, symA: string, symB: string, bridges?: string[], mode?: string): Promise<{
|
|
133
189
|
rate: number;
|
|
134
190
|
path: string;
|
|
135
191
|
} | null>;
|
|
@@ -148,7 +204,7 @@ export declare function derivePriceWithBridges(BitShares: any, symA: string, sym
|
|
|
148
204
|
* behavior; the credit runtime opts in explicitly.
|
|
149
205
|
* @returns {Promise<number|null>} Value per share in denomination asset, or null
|
|
150
206
|
*/
|
|
151
|
-
export declare function deriveLiquidityPoolTokenValue(BitShares:
|
|
207
|
+
export declare function deriveLiquidityPoolTokenValue(BitShares: BitSharesClient, shareAssetRef: string, denominationAssetRef: string, mode?: string, allowBridges?: boolean): Promise<number | null>;
|
|
152
208
|
/**
|
|
153
209
|
* Load the full dynamic grid snapshot written by market_adapter for a bot.
|
|
154
210
|
* The snapshot is stored atomically at profiles/orders/<botKey>.dynamicgrid.json
|
|
@@ -164,7 +220,22 @@ export declare function deriveLiquidityPoolTokenValue(BitShares: any, shareAsset
|
|
|
164
220
|
* @param {string} botKey - Bot key (e.g. "iob-aaa-bbb-0")
|
|
165
221
|
* @returns {Object|null} Snapshot with center and optional dynamicWeights fields, or null if invalid
|
|
166
222
|
*/
|
|
167
|
-
export
|
|
223
|
+
export interface AmaCenterSnapshot {
|
|
224
|
+
gridCenterPrice: number;
|
|
225
|
+
centerPrice: number;
|
|
226
|
+
amaCenterPrice: number | null;
|
|
227
|
+
source: string | null;
|
|
228
|
+
updatedAt: string | null;
|
|
229
|
+
amaSlopePercentMode: unknown;
|
|
230
|
+
amaSlope: unknown;
|
|
231
|
+
gridRangeScalingAmaSlope: unknown;
|
|
232
|
+
gridPriceOffsetPct: number | null;
|
|
233
|
+
amaSlopeDeltaPercent: number | null;
|
|
234
|
+
amaSlopeThresholdPercent: number | null;
|
|
235
|
+
dynamicWeights: unknown;
|
|
236
|
+
asymmetricBounds: unknown;
|
|
237
|
+
}
|
|
238
|
+
export declare function loadAmaCenterSnapshot(botKey: string): AmaCenterSnapshot | null;
|
|
168
239
|
/**
|
|
169
240
|
* Load the AMA grid center price written by market_adapter for a bot.
|
|
170
241
|
* This is the numeric accessor used by the order engine.
|
|
@@ -172,6 +243,38 @@ export declare function loadAmaCenterSnapshot(botKey: string): any;
|
|
|
172
243
|
* @returns {number|null} Grid center price in B/A format, or null if file absent/invalid
|
|
173
244
|
*/
|
|
174
245
|
export declare function loadAmaCenterPrice(botKey: string): number | null;
|
|
246
|
+
export interface FeeCacheEntryData {
|
|
247
|
+
assetId?: string;
|
|
248
|
+
symbol?: string;
|
|
249
|
+
precision?: number;
|
|
250
|
+
chargesMarketFees?: boolean;
|
|
251
|
+
marketFee?: {
|
|
252
|
+
percent: number;
|
|
253
|
+
};
|
|
254
|
+
takerFee?: {
|
|
255
|
+
percent: number;
|
|
256
|
+
} | null;
|
|
257
|
+
maxMarketFee?: {
|
|
258
|
+
raw: number | string;
|
|
259
|
+
float: number;
|
|
260
|
+
};
|
|
261
|
+
limitOrderCreate?: {
|
|
262
|
+
raw: number;
|
|
263
|
+
satoshis: number;
|
|
264
|
+
bts: number;
|
|
265
|
+
};
|
|
266
|
+
limitOrderCancel?: {
|
|
267
|
+
raw: number;
|
|
268
|
+
satoshis: number;
|
|
269
|
+
bts: number;
|
|
270
|
+
};
|
|
271
|
+
limitOrderUpdate?: {
|
|
272
|
+
raw: number;
|
|
273
|
+
satoshis: number;
|
|
274
|
+
bts: number;
|
|
275
|
+
};
|
|
276
|
+
makerFeeDiscountPercent?: number;
|
|
277
|
+
}
|
|
175
278
|
/**
|
|
176
279
|
* Initialize fee cache from blockchain.
|
|
177
280
|
* Fetches BTS operation fees and asset market fees for all unique assets in config.
|
|
@@ -182,7 +285,10 @@ export declare function loadAmaCenterPrice(botKey: string): number | null;
|
|
|
182
285
|
* @param {Object} BitShares - BitShares client instance
|
|
183
286
|
* @returns {Promise<Object>} Fee cache object keyed by asset symbol
|
|
184
287
|
*/
|
|
185
|
-
export declare function initializeFeeCache(botsConfig:
|
|
288
|
+
export declare function initializeFeeCache(botsConfig: Array<{
|
|
289
|
+
assetA?: string;
|
|
290
|
+
assetB?: string;
|
|
291
|
+
}>, BitShares: BitSharesClient): Promise<Record<string, FeeCacheEntryData>>;
|
|
186
292
|
/**
|
|
187
293
|
* Persist current grid state to storage.
|
|
188
294
|
* Saves all orders, cache funds, fees, boundary index, and asset info.
|
|
@@ -191,9 +297,9 @@ export declare function initializeFeeCache(botsConfig: any[], BitShares: any): P
|
|
|
191
297
|
* @param {Object} accountOrders - AccountOrders data accessor
|
|
192
298
|
* @returns {Promise<boolean>} True if persistence succeeded, false on error
|
|
193
299
|
*/
|
|
194
|
-
export declare function persistGridSnapshot(manager:
|
|
300
|
+
export declare function persistGridSnapshot(manager: OrderManagerLike, accountOrders: AccountOrdersLike, snapshotOrders?: ManagedOrder[], recentFillKeys?: Record<string, number>, fundSnapshot?: {
|
|
195
301
|
btsFeesOwed: number;
|
|
196
|
-
accountTotals:
|
|
302
|
+
accountTotals: AccountTotals | null;
|
|
197
303
|
}): Promise<boolean>;
|
|
198
304
|
/**
|
|
199
305
|
* Restore persisted gap-evacuation streaks into the manager (Phase 3
|
|
@@ -208,7 +314,7 @@ export declare function persistGridSnapshot(manager: any, accountOrders: any, sn
|
|
|
208
314
|
* @param {Object|null} persisted - {slotId: count} from loadGapEvacStreaks
|
|
209
315
|
* @returns {number} Number of streak entries restored
|
|
210
316
|
*/
|
|
211
|
-
export declare function restoreGapEvacStreaks(manager:
|
|
317
|
+
export declare function restoreGapEvacStreaks(manager: OrderManagerLike, persisted: unknown): number;
|
|
212
318
|
/**
|
|
213
319
|
* Normalize a persisted LAST-FILL-GUARD pivot row (shared by the
|
|
214
320
|
* AccountOrders sanitizer/loader and the payload builder's row contract).
|
|
@@ -220,10 +326,10 @@ export declare function restoreGapEvacStreaks(manager: any, persisted: any): num
|
|
|
220
326
|
* - finite fillsAt > 0
|
|
221
327
|
* - non-empty string genesisHash
|
|
222
328
|
*
|
|
223
|
-
* @param {
|
|
329
|
+
* @param {unknown} row - Raw candidate row
|
|
224
330
|
* @returns {Object|null} Normalized row or null
|
|
225
331
|
*/
|
|
226
|
-
export declare function normalizeLastFillPivot(row:
|
|
332
|
+
export declare function normalizeLastFillPivot(row: unknown): {
|
|
227
333
|
price: number;
|
|
228
334
|
type: string;
|
|
229
335
|
fillsAt: number;
|
|
@@ -248,7 +354,7 @@ export declare function normalizeLastFillPivot(row: any): {
|
|
|
248
354
|
* @param {number} [atMs] - Fill timestamp to preserve (defaults to now)
|
|
249
355
|
* @returns {boolean} True when the pivot was written
|
|
250
356
|
*/
|
|
251
|
-
export declare function setLastFillPivot(manager:
|
|
357
|
+
export declare function setLastFillPivot(manager: OrderManagerLike, type: string, price: unknown, provenance: 'fill' | 'book', atMs?: number): boolean;
|
|
252
358
|
/**
|
|
253
359
|
* Clear the manager's LAST-FILL-GUARD pivot to cold state — the FULL scalar
|
|
254
360
|
* family, per-side mirrors included. Clearing only the primary fields would
|
|
@@ -267,7 +373,7 @@ export declare function setLastFillPivot(manager: any, type: any, price: any, pr
|
|
|
267
373
|
* @param {string} reason - Log/debug label
|
|
268
374
|
* @returns {boolean} True when an armed pivot was cleared
|
|
269
375
|
*/
|
|
270
|
-
export declare function resetLastFillPivot(manager:
|
|
376
|
+
export declare function resetLastFillPivot(manager: OrderManagerLike, reason?: string): boolean;
|
|
271
377
|
/**
|
|
272
378
|
* Restore the persisted LAST-FILL-GUARD pivot into the manager.
|
|
273
379
|
*
|
|
@@ -303,9 +409,23 @@ export declare function resetLastFillPivot(manager: any, reason?: string): boole
|
|
|
303
409
|
* @param {number} [options.now] - Injectable clock (tests)
|
|
304
410
|
* @returns {boolean} True when the guard was re-armed from the snapshot
|
|
305
411
|
*/
|
|
306
|
-
export declare function restoreLastFillPivot(manager:
|
|
412
|
+
export declare function restoreLastFillPivot(manager: OrderManagerLike, persisted: unknown, options?: {
|
|
307
413
|
now?: number;
|
|
308
414
|
}): boolean;
|
|
415
|
+
export interface GridResizeResult {
|
|
416
|
+
workingGrid?: WorkingGridType;
|
|
417
|
+
actions?: CowAction[];
|
|
418
|
+
hasWorkingChanges?: boolean;
|
|
419
|
+
}
|
|
420
|
+
export interface CowResult {
|
|
421
|
+
actions: CowAction[];
|
|
422
|
+
workingGrid: WorkingGridType;
|
|
423
|
+
workingIndexes: unknown;
|
|
424
|
+
workingBoundary: number | null;
|
|
425
|
+
refillSlotIds?: unknown;
|
|
426
|
+
aborted: boolean;
|
|
427
|
+
localOnly?: boolean;
|
|
428
|
+
}
|
|
309
429
|
/**
|
|
310
430
|
* Retry grid persistence if previous attempt failed.
|
|
311
431
|
* Clears persistence warning flag if successful.
|
|
@@ -313,7 +433,7 @@ export declare function restoreLastFillPivot(manager: any, persisted: any, optio
|
|
|
313
433
|
* @param {Object} manager - OrderManager instance
|
|
314
434
|
* @returns {Promise<boolean>} True if persisted successfully or no warning, false on error
|
|
315
435
|
*/
|
|
316
|
-
export declare function retryPersistenceIfNeeded(manager:
|
|
436
|
+
export declare function retryPersistenceIfNeeded(manager: OrderManagerLike): Promise<boolean>;
|
|
317
437
|
/**
|
|
318
438
|
* Apply grid corrections for divergence between calculated and active orders.
|
|
319
439
|
* Uses COW (Copy-on-Write): builds a working grid, plans updates/cancels/creates,
|
|
@@ -329,7 +449,10 @@ export declare function retryPersistenceIfNeeded(manager: any): Promise<boolean>
|
|
|
329
449
|
* @param {Function} updateGridFromBlockchainSnapshotFn - Grid resize function (injected to avoid circular dependency with grid.ts)
|
|
330
450
|
* @returns {Promise<void>}
|
|
331
451
|
*/
|
|
332
|
-
export declare function applyGridDivergenceCorrections(manager:
|
|
452
|
+
export declare function applyGridDivergenceCorrections(manager: OrderManagerLike, accountOrders: AccountOrdersLike, _botKey: string, updateOrdersOnChainBatchFn: (cowResult: unknown) => Promise<{
|
|
453
|
+
executed?: boolean;
|
|
454
|
+
reason?: string;
|
|
455
|
+
} | null | undefined>, updateGridFromBlockchainSnapshotFn: (manager: OrderManagerLike, orderType: string, force: boolean, pendingBoundaryIdx: number | null) => Promise<GridResizeResult | undefined>): Promise<{
|
|
333
456
|
committed: boolean;
|
|
334
457
|
reason?: string;
|
|
335
458
|
} | undefined>;
|
|
@@ -438,26 +561,33 @@ export declare function withBlockchainRetry<T>(fn: () => Promise<T>, label: stri
|
|
|
438
561
|
* @param {string} account - Account name (optional)
|
|
439
562
|
* @returns {string|null} Resolved account reference or null
|
|
440
563
|
*/
|
|
441
|
-
export declare function resolveAccountRef(manager:
|
|
564
|
+
export declare function resolveAccountRef(manager: OrderManagerLike, account: string): string | null;
|
|
442
565
|
/**
|
|
443
566
|
* Recursively freezes an object to ensure immutability.
|
|
444
567
|
* @param {Object} obj
|
|
445
568
|
* @returns {Object}
|
|
446
569
|
*/
|
|
447
|
-
export declare function deepFreeze(obj:
|
|
570
|
+
export declare function deepFreeze<T>(obj: T): T;
|
|
448
571
|
/**
|
|
449
572
|
* Creates a shallow clone of a Map.
|
|
450
573
|
* @param {Map} map
|
|
451
574
|
* @returns {Map}
|
|
452
575
|
*/
|
|
453
576
|
export declare function cloneMap<K, V>(map: Map<K, V>): Map<K, V>;
|
|
577
|
+
/**
|
|
578
|
+
* Fire-and-forget structural grid resync. Invokes the manager's handler and
|
|
579
|
+
* logs both a synchronous throw and an async rejection through the manager
|
|
580
|
+
* logger, so escalation sites share one error-handling footer. No-op when the
|
|
581
|
+
* manager has no handler.
|
|
582
|
+
*/
|
|
583
|
+
export declare function fireStructuralResync(bot: BotLike, reason: string, details: Record<string, unknown>, errorLabel: string, level?: string): void;
|
|
454
584
|
/**
|
|
455
585
|
* Parses JSON content that may contain comments (/* or //).
|
|
456
586
|
* Strips block comments then line comments before parsing.
|
|
457
587
|
* @param {string} raw - The raw string content with possible comments.
|
|
458
588
|
* @returns {Object} The parsed JSON object.
|
|
459
589
|
*/
|
|
460
|
-
export declare function parseJsonWithComments(raw: string):
|
|
590
|
+
export declare function parseJsonWithComments(raw: string): Record<string, unknown>;
|
|
461
591
|
export { ensureDir };
|
|
462
592
|
/**
|
|
463
593
|
* Apply persisted-but-uncommitted fill crawls onto the restored boundary.
|
|
@@ -485,8 +615,8 @@ export { ensureDir };
|
|
|
485
615
|
* freshly-constructed store)
|
|
486
616
|
* @returns {Promise<{applied: boolean, from?: number, to?: number, count?: number, reason?: string}>}
|
|
487
617
|
*/
|
|
488
|
-
export declare function applyPersistedPendingCrawls(bot:
|
|
489
|
-
log?: (message: string, level?:
|
|
618
|
+
export declare function applyPersistedPendingCrawls(bot: BotLike, options?: {
|
|
619
|
+
log?: (message: string, level?: string) => void;
|
|
490
620
|
forceReload?: boolean;
|
|
491
621
|
}): Promise<{
|
|
492
622
|
applied: boolean;
|