@senpi-ai/runtime 1.0.73

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 (715) hide show
  1. package/README.md +123 -0
  2. package/dist/actions/close-position/close-position.action.d.ts +16 -0
  3. package/dist/actions/close-position/close-position.action.d.ts.map +1 -0
  4. package/dist/actions/close-position/close-position.action.js +220 -0
  5. package/dist/actions/close-position/close-position.action.js.map +1 -0
  6. package/dist/actions/decision-engine.d.ts +32 -0
  7. package/dist/actions/decision-engine.d.ts.map +1 -0
  8. package/dist/actions/decision-engine.js +103 -0
  9. package/dist/actions/decision-engine.js.map +1 -0
  10. package/dist/actions/llm-decision/anthropic-llm-decision.d.ts +12 -0
  11. package/dist/actions/llm-decision/anthropic-llm-decision.d.ts.map +1 -0
  12. package/dist/actions/llm-decision/anthropic-llm-decision.js +74 -0
  13. package/dist/actions/llm-decision/anthropic-llm-decision.js.map +1 -0
  14. package/dist/actions/llm-decision/factory.d.ts +17 -0
  15. package/dist/actions/llm-decision/factory.d.ts.map +1 -0
  16. package/dist/actions/llm-decision/factory.js +29 -0
  17. package/dist/actions/llm-decision/factory.js.map +1 -0
  18. package/dist/actions/llm-decision/index.d.ts +8 -0
  19. package/dist/actions/llm-decision/index.d.ts.map +1 -0
  20. package/dist/actions/llm-decision/index.js +5 -0
  21. package/dist/actions/llm-decision/index.js.map +1 -0
  22. package/dist/actions/llm-decision/openclaw-llm-decision.d.ts +14 -0
  23. package/dist/actions/llm-decision/openclaw-llm-decision.d.ts.map +1 -0
  24. package/dist/actions/llm-decision/openclaw-llm-decision.js +58 -0
  25. package/dist/actions/llm-decision/openclaw-llm-decision.js.map +1 -0
  26. package/dist/actions/llm-decision/shared.d.ts +41 -0
  27. package/dist/actions/llm-decision/shared.d.ts.map +1 -0
  28. package/dist/actions/llm-decision/shared.js +117 -0
  29. package/dist/actions/llm-decision/shared.js.map +1 -0
  30. package/dist/actions/open-position/open-position.action.d.ts +16 -0
  31. package/dist/actions/open-position/open-position.action.d.ts.map +1 -0
  32. package/dist/actions/open-position/open-position.action.js +278 -0
  33. package/dist/actions/open-position/open-position.action.js.map +1 -0
  34. package/dist/actions/position-tracker/position-tracker.action.d.ts +14 -0
  35. package/dist/actions/position-tracker/position-tracker.action.d.ts.map +1 -0
  36. package/dist/actions/position-tracker/position-tracker.action.js +201 -0
  37. package/dist/actions/position-tracker/position-tracker.action.js.map +1 -0
  38. package/dist/actions/types.d.ts +123 -0
  39. package/dist/actions/types.d.ts.map +1 -0
  40. package/dist/actions/types.js +3 -0
  41. package/dist/actions/types.js.map +1 -0
  42. package/dist/cli/guide-commands.d.ts +27 -0
  43. package/dist/cli/guide-commands.d.ts.map +1 -0
  44. package/dist/cli/guide-commands.js +481 -0
  45. package/dist/cli/guide-commands.js.map +1 -0
  46. package/dist/cli/senpi-cli-config.d.ts +33 -0
  47. package/dist/cli/senpi-cli-config.d.ts.map +1 -0
  48. package/dist/cli/senpi-cli-config.js +130 -0
  49. package/dist/cli/senpi-cli-config.js.map +1 -0
  50. package/dist/cli/senpi-commands.d.ts +21 -0
  51. package/dist/cli/senpi-commands.d.ts.map +1 -0
  52. package/dist/cli/senpi-commands.js +471 -0
  53. package/dist/cli/senpi-commands.js.map +1 -0
  54. package/dist/cli/senpi-config-commands.d.ts +11 -0
  55. package/dist/cli/senpi-config-commands.d.ts.map +1 -0
  56. package/dist/cli/senpi-config-commands.js +113 -0
  57. package/dist/cli/senpi-config-commands.js.map +1 -0
  58. package/dist/constants/dsl/index.d.ts +62 -0
  59. package/dist/constants/dsl/index.d.ts.map +1 -0
  60. package/dist/constants/dsl/index.js +62 -0
  61. package/dist/constants/dsl/index.js.map +1 -0
  62. package/dist/context/context-builder.d.ts +14 -0
  63. package/dist/context/context-builder.d.ts.map +1 -0
  64. package/dist/context/context-builder.js +38 -0
  65. package/dist/context/context-builder.js.map +1 -0
  66. package/dist/context/index.d.ts +5 -0
  67. package/dist/context/index.d.ts.map +1 -0
  68. package/dist/context/index.js +5 -0
  69. package/dist/context/index.js.map +1 -0
  70. package/dist/context/interpolate.d.ts +6 -0
  71. package/dist/context/interpolate.d.ts.map +1 -0
  72. package/dist/context/interpolate.js +15 -0
  73. package/dist/context/interpolate.js.map +1 -0
  74. package/dist/context/providers/asset-trend.provider.d.ts +42 -0
  75. package/dist/context/providers/asset-trend.provider.d.ts.map +1 -0
  76. package/dist/context/providers/asset-trend.provider.js +90 -0
  77. package/dist/context/providers/asset-trend.provider.js.map +1 -0
  78. package/dist/context/providers/index.d.ts +5 -0
  79. package/dist/context/providers/index.d.ts.map +1 -0
  80. package/dist/context/providers/index.js +5 -0
  81. package/dist/context/providers/index.js.map +1 -0
  82. package/dist/context/providers/scanner-context.provider.d.ts +10 -0
  83. package/dist/context/providers/scanner-context.provider.d.ts.map +1 -0
  84. package/dist/context/providers/scanner-context.provider.js +20 -0
  85. package/dist/context/providers/scanner-context.provider.js.map +1 -0
  86. package/dist/context/providers/signal.provider.d.ts +11 -0
  87. package/dist/context/providers/signal.provider.d.ts.map +1 -0
  88. package/dist/context/providers/signal.provider.js +30 -0
  89. package/dist/context/providers/signal.provider.js.map +1 -0
  90. package/dist/context/providers/strategy.provider.d.ts +14 -0
  91. package/dist/context/providers/strategy.provider.d.ts.map +1 -0
  92. package/dist/context/providers/strategy.provider.js +71 -0
  93. package/dist/context/providers/strategy.provider.js.map +1 -0
  94. package/dist/context/types.d.ts +45 -0
  95. package/dist/context/types.d.ts.map +1 -0
  96. package/dist/context/types.js +18 -0
  97. package/dist/context/types.js.map +1 -0
  98. package/dist/debug.d.ts +2 -0
  99. package/dist/debug.d.ts.map +1 -0
  100. package/dist/debug.js +591 -0
  101. package/dist/debug.js.map +1 -0
  102. package/dist/dsl/config/exit-block.d.ts +11 -0
  103. package/dist/dsl/config/exit-block.d.ts.map +1 -0
  104. package/dist/dsl/config/exit-block.js +5 -0
  105. package/dist/dsl/config/exit-block.js.map +1 -0
  106. package/dist/dsl/config/index.d.ts +8 -0
  107. package/dist/dsl/config/index.d.ts.map +1 -0
  108. package/dist/dsl/config/index.js +6 -0
  109. package/dist/dsl/config/index.js.map +1 -0
  110. package/dist/dsl/config/parse-phase.d.ts +14 -0
  111. package/dist/dsl/config/parse-phase.d.ts.map +1 -0
  112. package/dist/dsl/config/parse-phase.js +78 -0
  113. package/dist/dsl/config/parse-phase.js.map +1 -0
  114. package/dist/dsl/config/parse-plugin-config.d.ts +8 -0
  115. package/dist/dsl/config/parse-plugin-config.d.ts.map +1 -0
  116. package/dist/dsl/config/parse-plugin-config.js +27 -0
  117. package/dist/dsl/config/parse-plugin-config.js.map +1 -0
  118. package/dist/dsl/config/parse-preset.d.ts +7 -0
  119. package/dist/dsl/config/parse-preset.d.ts.map +1 -0
  120. package/dist/dsl/config/parse-preset.js +99 -0
  121. package/dist/dsl/config/parse-preset.js.map +1 -0
  122. package/dist/dsl/config/parse-tiers.d.ts +7 -0
  123. package/dist/dsl/config/parse-tiers.d.ts.map +1 -0
  124. package/dist/dsl/config/parse-tiers.js +31 -0
  125. package/dist/dsl/config/parse-tiers.js.map +1 -0
  126. package/dist/dsl/config/parse-timeouts.d.ts +16 -0
  127. package/dist/dsl/config/parse-timeouts.d.ts.map +1 -0
  128. package/dist/dsl/config/parse-timeouts.js +75 -0
  129. package/dist/dsl/config/parse-timeouts.js.map +1 -0
  130. package/dist/dsl/config/raw-types.d.ts +45 -0
  131. package/dist/dsl/config/raw-types.d.ts.map +1 -0
  132. package/dist/dsl/config/raw-types.js +5 -0
  133. package/dist/dsl/config/raw-types.js.map +1 -0
  134. package/dist/dsl/config/unknown-keys.d.ts +7 -0
  135. package/dist/dsl/config/unknown-keys.d.ts.map +1 -0
  136. package/dist/dsl/config/unknown-keys.js +119 -0
  137. package/dist/dsl/config/unknown-keys.js.map +1 -0
  138. package/dist/dsl/config/validation.d.ts +21 -0
  139. package/dist/dsl/config/validation.d.ts.map +1 -0
  140. package/dist/dsl/config/validation.js +45 -0
  141. package/dist/dsl/config/validation.js.map +1 -0
  142. package/dist/dsl/constants/index.d.ts +3 -0
  143. package/dist/dsl/constants/index.d.ts.map +1 -0
  144. package/dist/dsl/constants/index.js +3 -0
  145. package/dist/dsl/constants/index.js.map +1 -0
  146. package/dist/dsl/engine/exchange-stop.d.ts +16 -0
  147. package/dist/dsl/engine/exchange-stop.d.ts.map +1 -0
  148. package/dist/dsl/engine/exchange-stop.js +20 -0
  149. package/dist/dsl/engine/exchange-stop.js.map +1 -0
  150. package/dist/dsl/engine/floors.d.ts +32 -0
  151. package/dist/dsl/engine/floors.d.ts.map +1 -0
  152. package/dist/dsl/engine/floors.js +115 -0
  153. package/dist/dsl/engine/floors.js.map +1 -0
  154. package/dist/dsl/engine/index.d.ts +7 -0
  155. package/dist/dsl/engine/index.d.ts.map +1 -0
  156. package/dist/dsl/engine/index.js +7 -0
  157. package/dist/dsl/engine/index.js.map +1 -0
  158. package/dist/dsl/engine/round.d.ts +5 -0
  159. package/dist/dsl/engine/round.d.ts.map +1 -0
  160. package/dist/dsl/engine/round.js +9 -0
  161. package/dist/dsl/engine/round.js.map +1 -0
  162. package/dist/dsl/engine/state-updates.d.ts +8 -0
  163. package/dist/dsl/engine/state-updates.d.ts.map +1 -0
  164. package/dist/dsl/engine/state-updates.js +60 -0
  165. package/dist/dsl/engine/state-updates.js.map +1 -0
  166. package/dist/dsl/engine/tick.d.ts +6 -0
  167. package/dist/dsl/engine/tick.d.ts.map +1 -0
  168. package/dist/dsl/engine/tick.js +174 -0
  169. package/dist/dsl/engine/tick.js.map +1 -0
  170. package/dist/dsl/events/bus-types.d.ts +7 -0
  171. package/dist/dsl/events/bus-types.d.ts.map +1 -0
  172. package/dist/dsl/events/bus-types.js +6 -0
  173. package/dist/dsl/events/bus-types.js.map +1 -0
  174. package/dist/dsl/events/guards.d.ts +17 -0
  175. package/dist/dsl/events/guards.d.ts.map +1 -0
  176. package/dist/dsl/events/guards.js +116 -0
  177. package/dist/dsl/events/guards.js.map +1 -0
  178. package/dist/dsl/events/handlers.d.ts +18 -0
  179. package/dist/dsl/events/handlers.d.ts.map +1 -0
  180. package/dist/dsl/events/handlers.js +376 -0
  181. package/dist/dsl/events/handlers.js.map +1 -0
  182. package/dist/dsl/events/index.d.ts +4 -0
  183. package/dist/dsl/events/index.d.ts.map +1 -0
  184. package/dist/dsl/events/index.js +4 -0
  185. package/dist/dsl/events/index.js.map +1 -0
  186. package/dist/dsl/events/initial-state.d.ts +7 -0
  187. package/dist/dsl/events/initial-state.d.ts.map +1 -0
  188. package/dist/dsl/events/initial-state.js +96 -0
  189. package/dist/dsl/events/initial-state.js.map +1 -0
  190. package/dist/dsl/events/normalize-position-opened.d.ts +10 -0
  191. package/dist/dsl/events/normalize-position-opened.d.ts.map +1 -0
  192. package/dist/dsl/events/normalize-position-opened.js +13 -0
  193. package/dist/dsl/events/normalize-position-opened.js.map +1 -0
  194. package/dist/dsl/index.d.ts +13 -0
  195. package/dist/dsl/index.d.ts.map +1 -0
  196. package/dist/dsl/index.js +37 -0
  197. package/dist/dsl/index.js.map +1 -0
  198. package/dist/dsl/monitor/create-monitor.d.ts +19 -0
  199. package/dist/dsl/monitor/create-monitor.d.ts.map +1 -0
  200. package/dist/dsl/monitor/create-monitor.js +133 -0
  201. package/dist/dsl/monitor/create-monitor.js.map +1 -0
  202. package/dist/dsl/monitor/effective-dex.d.ts +7 -0
  203. package/dist/dsl/monitor/effective-dex.d.ts.map +1 -0
  204. package/dist/dsl/monitor/effective-dex.js +11 -0
  205. package/dist/dsl/monitor/effective-dex.js.map +1 -0
  206. package/dist/dsl/monitor/exchange-sync.d.ts +16 -0
  207. package/dist/dsl/monitor/exchange-sync.d.ts.map +1 -0
  208. package/dist/dsl/monitor/exchange-sync.js +37 -0
  209. package/dist/dsl/monitor/exchange-sync.js.map +1 -0
  210. package/dist/dsl/monitor/index.d.ts +6 -0
  211. package/dist/dsl/monitor/index.d.ts.map +1 -0
  212. package/dist/dsl/monitor/index.js +5 -0
  213. package/dist/dsl/monitor/index.js.map +1 -0
  214. package/dist/dsl/monitor/market-price.d.ts +5 -0
  215. package/dist/dsl/monitor/market-price.d.ts.map +1 -0
  216. package/dist/dsl/monitor/market-price.js +24 -0
  217. package/dist/dsl/monitor/market-price.js.map +1 -0
  218. package/dist/dsl/monitor/process-one-position.d.ts +17 -0
  219. package/dist/dsl/monitor/process-one-position.d.ts.map +1 -0
  220. package/dist/dsl/monitor/process-one-position.js +430 -0
  221. package/dist/dsl/monitor/process-one-position.js.map +1 -0
  222. package/dist/dsl/notifications/formatter.d.ts +18 -0
  223. package/dist/dsl/notifications/formatter.d.ts.map +1 -0
  224. package/dist/dsl/notifications/formatter.js +69 -0
  225. package/dist/dsl/notifications/formatter.js.map +1 -0
  226. package/dist/dsl/notifications/index.d.ts +19 -0
  227. package/dist/dsl/notifications/index.d.ts.map +1 -0
  228. package/dist/dsl/notifications/index.js +90 -0
  229. package/dist/dsl/notifications/index.js.map +1 -0
  230. package/dist/dsl/plugin/index.d.ts +65 -0
  231. package/dist/dsl/plugin/index.d.ts.map +1 -0
  232. package/dist/dsl/plugin/index.js +395 -0
  233. package/dist/dsl/plugin/index.js.map +1 -0
  234. package/dist/dsl/plugin/options.d.ts +40 -0
  235. package/dist/dsl/plugin/options.d.ts.map +1 -0
  236. package/dist/dsl/plugin/options.js +5 -0
  237. package/dist/dsl/plugin/options.js.map +1 -0
  238. package/dist/dsl/types/index.d.ts +3 -0
  239. package/dist/dsl/types/index.d.ts.map +1 -0
  240. package/dist/dsl/types/index.js +3 -0
  241. package/dist/dsl/types/index.js.map +1 -0
  242. package/dist/health/index.d.ts +29 -0
  243. package/dist/health/index.d.ts.map +1 -0
  244. package/dist/health/index.js +191 -0
  245. package/dist/health/index.js.map +1 -0
  246. package/dist/health/types.d.ts +114 -0
  247. package/dist/health/types.d.ts.map +1 -0
  248. package/dist/health/types.js +2 -0
  249. package/dist/health/types.js.map +1 -0
  250. package/dist/index.d.ts +96 -0
  251. package/dist/index.d.ts.map +1 -0
  252. package/dist/index.js +654 -0
  253. package/dist/index.js.map +1 -0
  254. package/dist/leverage/max-leverage-cache.d.ts +10 -0
  255. package/dist/leverage/max-leverage-cache.d.ts.map +1 -0
  256. package/dist/leverage/max-leverage-cache.js +51 -0
  257. package/dist/leverage/max-leverage-cache.js.map +1 -0
  258. package/dist/leverage/resolve-leverage.d.ts +9 -0
  259. package/dist/leverage/resolve-leverage.d.ts.map +1 -0
  260. package/dist/leverage/resolve-leverage.js +15 -0
  261. package/dist/leverage/resolve-leverage.js.map +1 -0
  262. package/dist/risk/index.d.ts +9 -0
  263. package/dist/risk/index.d.ts.map +1 -0
  264. package/dist/risk/index.js +9 -0
  265. package/dist/risk/index.js.map +1 -0
  266. package/dist/runtime/action-registry.d.ts +12 -0
  267. package/dist/runtime/action-registry.d.ts.map +1 -0
  268. package/dist/runtime/action-registry.js +22 -0
  269. package/dist/runtime/action-registry.js.map +1 -0
  270. package/dist/runtime/build-action-scan-payload.d.ts +20 -0
  271. package/dist/runtime/build-action-scan-payload.d.ts.map +1 -0
  272. package/dist/runtime/build-action-scan-payload.js +36 -0
  273. package/dist/runtime/build-action-scan-payload.js.map +1 -0
  274. package/dist/runtime/bus.d.ts +6 -0
  275. package/dist/runtime/bus.d.ts.map +1 -0
  276. package/dist/runtime/bus.js +22 -0
  277. package/dist/runtime/bus.js.map +1 -0
  278. package/dist/runtime/create-action-context.d.ts +34 -0
  279. package/dist/runtime/create-action-context.d.ts.map +1 -0
  280. package/dist/runtime/create-action-context.js +22 -0
  281. package/dist/runtime/create-action-context.js.map +1 -0
  282. package/dist/runtime/create-actions.d.ts +30 -0
  283. package/dist/runtime/create-actions.d.ts.map +1 -0
  284. package/dist/runtime/create-actions.js +70 -0
  285. package/dist/runtime/create-actions.js.map +1 -0
  286. package/dist/runtime/create-runtime-context.d.ts +35 -0
  287. package/dist/runtime/create-runtime-context.d.ts.map +1 -0
  288. package/dist/runtime/create-runtime-context.js +35 -0
  289. package/dist/runtime/create-runtime-context.js.map +1 -0
  290. package/dist/runtime/create-scanner-module.d.ts +14 -0
  291. package/dist/runtime/create-scanner-module.d.ts.map +1 -0
  292. package/dist/runtime/create-scanner-module.js +31 -0
  293. package/dist/runtime/create-scanner-module.js.map +1 -0
  294. package/dist/runtime/create-scanner-providers-for-run.d.ts +20 -0
  295. package/dist/runtime/create-scanner-providers-for-run.d.ts.map +1 -0
  296. package/dist/runtime/create-scanner-providers-for-run.js +34 -0
  297. package/dist/runtime/create-scanner-providers-for-run.js.map +1 -0
  298. package/dist/runtime/default-state-dir.d.ts +10 -0
  299. package/dist/runtime/default-state-dir.d.ts.map +1 -0
  300. package/dist/runtime/default-state-dir.js +22 -0
  301. package/dist/runtime/default-state-dir.js.map +1 -0
  302. package/dist/runtime/env-resolve.d.ts +17 -0
  303. package/dist/runtime/env-resolve.d.ts.map +1 -0
  304. package/dist/runtime/env-resolve.js +45 -0
  305. package/dist/runtime/env-resolve.js.map +1 -0
  306. package/dist/runtime/hook-system.d.ts +7 -0
  307. package/dist/runtime/hook-system.d.ts.map +1 -0
  308. package/dist/runtime/hook-system.js +16 -0
  309. package/dist/runtime/hook-system.js.map +1 -0
  310. package/dist/runtime/index.d.ts +37 -0
  311. package/dist/runtime/index.d.ts.map +1 -0
  312. package/dist/runtime/index.js +26 -0
  313. package/dist/runtime/index.js.map +1 -0
  314. package/dist/runtime/load-runtime-config.d.ts +23 -0
  315. package/dist/runtime/load-runtime-config.d.ts.map +1 -0
  316. package/dist/runtime/load-runtime-config.js +176 -0
  317. package/dist/runtime/load-runtime-config.js.map +1 -0
  318. package/dist/runtime/map-exit-config.d.ts +11 -0
  319. package/dist/runtime/map-exit-config.d.ts.map +1 -0
  320. package/dist/runtime/map-exit-config.js +86 -0
  321. package/dist/runtime/map-exit-config.js.map +1 -0
  322. package/dist/runtime/map-strategies-registration.d.ts +14 -0
  323. package/dist/runtime/map-strategies-registration.d.ts.map +1 -0
  324. package/dist/runtime/map-strategies-registration.js +44 -0
  325. package/dist/runtime/map-strategies-registration.js.map +1 -0
  326. package/dist/runtime/map-strategies.d.ts +14 -0
  327. package/dist/runtime/map-strategies.d.ts.map +1 -0
  328. package/dist/runtime/map-strategies.js +64 -0
  329. package/dist/runtime/map-strategies.js.map +1 -0
  330. package/dist/runtime/notifications.d.ts +19 -0
  331. package/dist/runtime/notifications.d.ts.map +1 -0
  332. package/dist/runtime/notifications.js +88 -0
  333. package/dist/runtime/notifications.js.map +1 -0
  334. package/dist/runtime/parse-interval.d.ts +11 -0
  335. package/dist/runtime/parse-interval.d.ts.map +1 -0
  336. package/dist/runtime/parse-interval.js +35 -0
  337. package/dist/runtime/parse-interval.js.map +1 -0
  338. package/dist/runtime/recipe-version.d.ts +15 -0
  339. package/dist/runtime/recipe-version.d.ts.map +1 -0
  340. package/dist/runtime/recipe-version.js +25 -0
  341. package/dist/runtime/recipe-version.js.map +1 -0
  342. package/dist/runtime/reconcile-state.d.ts +37 -0
  343. package/dist/runtime/reconcile-state.d.ts.map +1 -0
  344. package/dist/runtime/reconcile-state.js +171 -0
  345. package/dist/runtime/reconcile-state.js.map +1 -0
  346. package/dist/runtime/risk-guard.d.ts +6 -0
  347. package/dist/runtime/risk-guard.d.ts.map +1 -0
  348. package/dist/runtime/risk-guard.js +14 -0
  349. package/dist/runtime/risk-guard.js.map +1 -0
  350. package/dist/runtime/run.d.ts +30 -0
  351. package/dist/runtime/run.d.ts.map +1 -0
  352. package/dist/runtime/run.js +46 -0
  353. package/dist/runtime/run.js.map +1 -0
  354. package/dist/runtime/runtime-config.d.ts +6 -0
  355. package/dist/runtime/runtime-config.d.ts.map +1 -0
  356. package/dist/runtime/runtime-config.js +5 -0
  357. package/dist/runtime/runtime-config.js.map +1 -0
  358. package/dist/runtime/runtime-schema.d.ts +1859 -0
  359. package/dist/runtime/runtime-schema.d.ts.map +1 -0
  360. package/dist/runtime/runtime-schema.js +110 -0
  361. package/dist/runtime/runtime-schema.js.map +1 -0
  362. package/dist/runtime/runtime.d.ts +53 -0
  363. package/dist/runtime/runtime.d.ts.map +1 -0
  364. package/dist/runtime/runtime.js +336 -0
  365. package/dist/runtime/runtime.js.map +1 -0
  366. package/dist/runtime/scanner-composition.d.ts +23 -0
  367. package/dist/runtime/scanner-composition.d.ts.map +1 -0
  368. package/dist/runtime/scanner-composition.js +168 -0
  369. package/dist/runtime/scanner-composition.js.map +1 -0
  370. package/dist/runtime/scanner-registry.d.ts +28 -0
  371. package/dist/runtime/scanner-registry.d.ts.map +1 -0
  372. package/dist/runtime/scanner-registry.js +114 -0
  373. package/dist/runtime/scanner-registry.js.map +1 -0
  374. package/dist/runtime/state-layout.d.ts +48 -0
  375. package/dist/runtime/state-layout.d.ts.map +1 -0
  376. package/dist/runtime/state-layout.js +87 -0
  377. package/dist/runtime/state-layout.js.map +1 -0
  378. package/dist/runtime/strategy-registry.d.ts +73 -0
  379. package/dist/runtime/strategy-registry.d.ts.map +1 -0
  380. package/dist/runtime/strategy-registry.js +243 -0
  381. package/dist/runtime/strategy-registry.js.map +1 -0
  382. package/dist/runtime/validate-dsl-position-tracking.d.ts +3 -0
  383. package/dist/runtime/validate-dsl-position-tracking.d.ts.map +1 -0
  384. package/dist/runtime/validate-dsl-position-tracking.js +27 -0
  385. package/dist/runtime/validate-dsl-position-tracking.js.map +1 -0
  386. package/dist/scanners/__tests__/default-engine-test-composition.d.ts +9 -0
  387. package/dist/scanners/__tests__/default-engine-test-composition.d.ts.map +1 -0
  388. package/dist/scanners/__tests__/default-engine-test-composition.js +84 -0
  389. package/dist/scanners/__tests__/default-engine-test-composition.js.map +1 -0
  390. package/dist/scanners/__tests__/fixtures/index.d.ts +3 -0
  391. package/dist/scanners/__tests__/fixtures/index.d.ts.map +1 -0
  392. package/dist/scanners/__tests__/fixtures/index.js +3 -0
  393. package/dist/scanners/__tests__/fixtures/index.js.map +1 -0
  394. package/dist/scanners/__tests__/fixtures/position-tracker-scenarios.d.ts +21 -0
  395. package/dist/scanners/__tests__/fixtures/position-tracker-scenarios.d.ts.map +1 -0
  396. package/dist/scanners/__tests__/fixtures/position-tracker-scenarios.js +198 -0
  397. package/dist/scanners/__tests__/fixtures/position-tracker-scenarios.js.map +1 -0
  398. package/dist/scanners/__tests__/fixtures/scan-results.d.ts +23 -0
  399. package/dist/scanners/__tests__/fixtures/scan-results.d.ts.map +1 -0
  400. package/dist/scanners/__tests__/fixtures/scan-results.js +128 -0
  401. package/dist/scanners/__tests__/fixtures/scan-results.js.map +1 -0
  402. package/dist/scanners/__tests__/fixtures/signals.d.ts +18 -0
  403. package/dist/scanners/__tests__/fixtures/signals.d.ts.map +1 -0
  404. package/dist/scanners/__tests__/fixtures/signals.js +84 -0
  405. package/dist/scanners/__tests__/fixtures/signals.js.map +1 -0
  406. package/dist/scanners/__tests__/test-helpers.d.ts +4 -0
  407. package/dist/scanners/__tests__/test-helpers.d.ts.map +1 -0
  408. package/dist/scanners/__tests__/test-helpers.js +23 -0
  409. package/dist/scanners/__tests__/test-helpers.js.map +1 -0
  410. package/dist/scanners/artifacts.d.ts +131 -0
  411. package/dist/scanners/artifacts.d.ts.map +1 -0
  412. package/dist/scanners/artifacts.js +72 -0
  413. package/dist/scanners/artifacts.js.map +1 -0
  414. package/dist/scanners/context-source-mapping.d.ts +4 -0
  415. package/dist/scanners/context-source-mapping.d.ts.map +1 -0
  416. package/dist/scanners/context-source-mapping.js +10 -0
  417. package/dist/scanners/context-source-mapping.js.map +1 -0
  418. package/dist/scanners/create-scanner.d.ts +13 -0
  419. package/dist/scanners/create-scanner.d.ts.map +1 -0
  420. package/dist/scanners/create-scanner.js +11 -0
  421. package/dist/scanners/create-scanner.js.map +1 -0
  422. package/dist/scanners/engine/config-validator.d.ts +7 -0
  423. package/dist/scanners/engine/config-validator.d.ts.map +1 -0
  424. package/dist/scanners/engine/config-validator.js +16 -0
  425. package/dist/scanners/engine/config-validator.js.map +1 -0
  426. package/dist/scanners/engine/data-providers.d.ts +48 -0
  427. package/dist/scanners/engine/data-providers.d.ts.map +1 -0
  428. package/dist/scanners/engine/data-providers.js +28 -0
  429. package/dist/scanners/engine/data-providers.js.map +1 -0
  430. package/dist/scanners/engine/engine.d.ts +92 -0
  431. package/dist/scanners/engine/engine.d.ts.map +1 -0
  432. package/dist/scanners/engine/engine.js +478 -0
  433. package/dist/scanners/engine/engine.js.map +1 -0
  434. package/dist/scanners/engine/index.d.ts +9 -0
  435. package/dist/scanners/engine/index.d.ts.map +1 -0
  436. package/dist/scanners/engine/index.js +7 -0
  437. package/dist/scanners/engine/index.js.map +1 -0
  438. package/dist/scanners/engine/input-resolver.d.ts +33 -0
  439. package/dist/scanners/engine/input-resolver.d.ts.map +1 -0
  440. package/dist/scanners/engine/input-resolver.js +216 -0
  441. package/dist/scanners/engine/input-resolver.js.map +1 -0
  442. package/dist/scanners/engine/lifecycle.d.ts +21 -0
  443. package/dist/scanners/engine/lifecycle.d.ts.map +1 -0
  444. package/dist/scanners/engine/lifecycle.js +2 -0
  445. package/dist/scanners/engine/lifecycle.js.map +1 -0
  446. package/dist/scanners/engine/result-builder.d.ts +30 -0
  447. package/dist/scanners/engine/result-builder.d.ts.map +1 -0
  448. package/dist/scanners/engine/result-builder.js +129 -0
  449. package/dist/scanners/engine/result-builder.js.map +1 -0
  450. package/dist/scanners/engine/strategy-registry.d.ts +48 -0
  451. package/dist/scanners/engine/strategy-registry.d.ts.map +1 -0
  452. package/dist/scanners/engine/strategy-registry.js +103 -0
  453. package/dist/scanners/engine/strategy-registry.js.map +1 -0
  454. package/dist/scanners/events.d.ts +41 -0
  455. package/dist/scanners/events.d.ts.map +1 -0
  456. package/dist/scanners/events.js +33 -0
  457. package/dist/scanners/events.js.map +1 -0
  458. package/dist/scanners/implementations/emerging-movers.d.ts +215 -0
  459. package/dist/scanners/implementations/emerging-movers.d.ts.map +1 -0
  460. package/dist/scanners/implementations/emerging-movers.js +713 -0
  461. package/dist/scanners/implementations/emerging-movers.js.map +1 -0
  462. package/dist/scanners/implementations/index.d.ts +9 -0
  463. package/dist/scanners/implementations/index.d.ts.map +1 -0
  464. package/dist/scanners/implementations/index.js +9 -0
  465. package/dist/scanners/implementations/index.js.map +1 -0
  466. package/dist/scanners/implementations/indicators.d.ts +40 -0
  467. package/dist/scanners/implementations/indicators.d.ts.map +1 -0
  468. package/dist/scanners/implementations/indicators.js +114 -0
  469. package/dist/scanners/implementations/indicators.js.map +1 -0
  470. package/dist/scanners/implementations/liquidation-watchdog.d.ts +66 -0
  471. package/dist/scanners/implementations/liquidation-watchdog.d.ts.map +1 -0
  472. package/dist/scanners/implementations/liquidation-watchdog.js +293 -0
  473. package/dist/scanners/implementations/liquidation-watchdog.js.map +1 -0
  474. package/dist/scanners/implementations/market-regime.d.ts +52 -0
  475. package/dist/scanners/implementations/market-regime.d.ts.map +1 -0
  476. package/dist/scanners/implementations/market-regime.js +205 -0
  477. package/dist/scanners/implementations/market-regime.js.map +1 -0
  478. package/dist/scanners/implementations/momentum.d.ts +21 -0
  479. package/dist/scanners/implementations/momentum.d.ts.map +1 -0
  480. package/dist/scanners/implementations/momentum.js +132 -0
  481. package/dist/scanners/implementations/momentum.js.map +1 -0
  482. package/dist/scanners/implementations/oi-tracker.d.ts +13 -0
  483. package/dist/scanners/implementations/oi-tracker.d.ts.map +1 -0
  484. package/dist/scanners/implementations/oi-tracker.js +71 -0
  485. package/dist/scanners/implementations/oi-tracker.js.map +1 -0
  486. package/dist/scanners/implementations/opportunity.d.ts +104 -0
  487. package/dist/scanners/implementations/opportunity.d.ts.map +1 -0
  488. package/dist/scanners/implementations/opportunity.js +445 -0
  489. package/dist/scanners/implementations/opportunity.js.map +1 -0
  490. package/dist/scanners/implementations/position-tracker.d.ts +120 -0
  491. package/dist/scanners/implementations/position-tracker.d.ts.map +1 -0
  492. package/dist/scanners/implementations/position-tracker.js +360 -0
  493. package/dist/scanners/implementations/position-tracker.js.map +1 -0
  494. package/dist/scanners/implementations/prescreener.d.ts +20 -0
  495. package/dist/scanners/implementations/prescreener.d.ts.map +1 -0
  496. package/dist/scanners/implementations/prescreener.js +101 -0
  497. package/dist/scanners/implementations/prescreener.js.map +1 -0
  498. package/dist/scanners/implementations/sm-flip.d.ts +43 -0
  499. package/dist/scanners/implementations/sm-flip.d.ts.map +1 -0
  500. package/dist/scanners/implementations/sm-flip.js +205 -0
  501. package/dist/scanners/implementations/sm-flip.js.map +1 -0
  502. package/dist/scanners/index.d.ts +26 -0
  503. package/dist/scanners/index.d.ts.map +1 -0
  504. package/dist/scanners/index.js +19 -0
  505. package/dist/scanners/index.js.map +1 -0
  506. package/dist/scanners/input-descriptors.d.ts +61 -0
  507. package/dist/scanners/input-descriptors.d.ts.map +1 -0
  508. package/dist/scanners/input-descriptors.js +43 -0
  509. package/dist/scanners/input-descriptors.js.map +1 -0
  510. package/dist/scanners/prepare-scanner-inputs.d.ts +12 -0
  511. package/dist/scanners/prepare-scanner-inputs.d.ts.map +1 -0
  512. package/dist/scanners/prepare-scanner-inputs.js +21 -0
  513. package/dist/scanners/prepare-scanner-inputs.js.map +1 -0
  514. package/dist/scanners/protocol/context.d.ts +95 -0
  515. package/dist/scanners/protocol/context.d.ts.map +1 -0
  516. package/dist/scanners/protocol/context.js +2 -0
  517. package/dist/scanners/protocol/context.js.map +1 -0
  518. package/dist/scanners/protocol/hooks.d.ts +18 -0
  519. package/dist/scanners/protocol/hooks.d.ts.map +1 -0
  520. package/dist/scanners/protocol/hooks.js +12 -0
  521. package/dist/scanners/protocol/hooks.js.map +1 -0
  522. package/dist/scanners/protocol/index.d.ts +5 -0
  523. package/dist/scanners/protocol/index.d.ts.map +1 -0
  524. package/dist/scanners/protocol/index.js +2 -0
  525. package/dist/scanners/protocol/index.js.map +1 -0
  526. package/dist/scanners/protocol/scanner.d.ts +47 -0
  527. package/dist/scanners/protocol/scanner.d.ts.map +1 -0
  528. package/dist/scanners/protocol/scanner.js +2 -0
  529. package/dist/scanners/protocol/scanner.js.map +1 -0
  530. package/dist/scanners/providers/adapter.d.ts +23 -0
  531. package/dist/scanners/providers/adapter.d.ts.map +1 -0
  532. package/dist/scanners/providers/adapter.js +227 -0
  533. package/dist/scanners/providers/adapter.js.map +1 -0
  534. package/dist/scanners/providers/cache.d.ts +20 -0
  535. package/dist/scanners/providers/cache.d.ts.map +1 -0
  536. package/dist/scanners/providers/cache.js +61 -0
  537. package/dist/scanners/providers/cache.js.map +1 -0
  538. package/dist/scanners/providers/client.d.ts +53 -0
  539. package/dist/scanners/providers/client.d.ts.map +1 -0
  540. package/dist/scanners/providers/client.js +174 -0
  541. package/dist/scanners/providers/client.js.map +1 -0
  542. package/dist/scanners/providers/factory.d.ts +43 -0
  543. package/dist/scanners/providers/factory.d.ts.map +1 -0
  544. package/dist/scanners/providers/factory.js +242 -0
  545. package/dist/scanners/providers/factory.js.map +1 -0
  546. package/dist/scanners/providers/types.d.ts +61 -0
  547. package/dist/scanners/providers/types.d.ts.map +1 -0
  548. package/dist/scanners/providers/types.js +6 -0
  549. package/dist/scanners/providers/types.js.map +1 -0
  550. package/dist/scanners/runtime-module.d.ts +79 -0
  551. package/dist/scanners/runtime-module.d.ts.map +1 -0
  552. package/dist/scanners/runtime-module.js +362 -0
  553. package/dist/scanners/runtime-module.js.map +1 -0
  554. package/dist/scanners/scanner-definition.d.ts +81 -0
  555. package/dist/scanners/scanner-definition.d.ts.map +1 -0
  556. package/dist/scanners/scanner-definition.js +19 -0
  557. package/dist/scanners/scanner-definition.js.map +1 -0
  558. package/dist/scanners/schema-utils.d.ts +6 -0
  559. package/dist/scanners/schema-utils.d.ts.map +1 -0
  560. package/dist/scanners/schema-utils.js +14 -0
  561. package/dist/scanners/schema-utils.js.map +1 -0
  562. package/dist/scanners/score-utils.d.ts +19 -0
  563. package/dist/scanners/score-utils.d.ts.map +1 -0
  564. package/dist/scanners/score-utils.js +47 -0
  565. package/dist/scanners/score-utils.js.map +1 -0
  566. package/dist/scanners/store/fs-utils.d.ts +12 -0
  567. package/dist/scanners/store/fs-utils.d.ts.map +1 -0
  568. package/dist/scanners/store/fs-utils.js +47 -0
  569. package/dist/scanners/store/fs-utils.js.map +1 -0
  570. package/dist/scanners/store/index.d.ts +5 -0
  571. package/dist/scanners/store/index.d.ts.map +1 -0
  572. package/dist/scanners/store/index.js +5 -0
  573. package/dist/scanners/store/index.js.map +1 -0
  574. package/dist/scanners/store/runtime-store.d.ts +50 -0
  575. package/dist/scanners/store/runtime-store.d.ts.map +1 -0
  576. package/dist/scanners/store/runtime-store.js +91 -0
  577. package/dist/scanners/store/runtime-store.js.map +1 -0
  578. package/dist/scanners/store/shared-artifact-store.d.ts +35 -0
  579. package/dist/scanners/store/shared-artifact-store.d.ts.map +1 -0
  580. package/dist/scanners/store/shared-artifact-store.js +89 -0
  581. package/dist/scanners/store/shared-artifact-store.js.map +1 -0
  582. package/dist/scanners/store/signal-store.d.ts +36 -0
  583. package/dist/scanners/store/signal-store.d.ts.map +1 -0
  584. package/dist/scanners/store/signal-store.js +135 -0
  585. package/dist/scanners/store/signal-store.js.map +1 -0
  586. package/dist/scanners/types.d.ts +115 -0
  587. package/dist/scanners/types.d.ts.map +1 -0
  588. package/dist/scanners/types.js +3 -0
  589. package/dist/scanners/types.js.map +1 -0
  590. package/dist/scripts/run-dsl-standalone-live.d.ts +48 -0
  591. package/dist/scripts/run-dsl-standalone-live.d.ts.map +1 -0
  592. package/dist/scripts/run-dsl-standalone-live.js +531 -0
  593. package/dist/scripts/run-dsl-standalone-live.js.map +1 -0
  594. package/dist/scripts/run-dsl-standalone-mock.d.ts +13 -0
  595. package/dist/scripts/run-dsl-standalone-mock.d.ts.map +1 -0
  596. package/dist/scripts/run-dsl-standalone-mock.js +264 -0
  597. package/dist/scripts/run-dsl-standalone-mock.js.map +1 -0
  598. package/dist/senpi/client.d.ts +85 -0
  599. package/dist/senpi/client.d.ts.map +1 -0
  600. package/dist/senpi/client.js +709 -0
  601. package/dist/senpi/client.js.map +1 -0
  602. package/dist/senpi/constants.d.ts +7 -0
  603. package/dist/senpi/constants.d.ts.map +1 -0
  604. package/dist/senpi/constants.js +7 -0
  605. package/dist/senpi/constants.js.map +1 -0
  606. package/dist/senpi/index.d.ts +3 -0
  607. package/dist/senpi/index.d.ts.map +1 -0
  608. package/dist/senpi/index.js +2 -0
  609. package/dist/senpi/index.js.map +1 -0
  610. package/dist/senpi/types.d.ts +132 -0
  611. package/dist/senpi/types.d.ts.map +1 -0
  612. package/dist/senpi/types.js +3 -0
  613. package/dist/senpi/types.js.map +1 -0
  614. package/dist/state/index.d.ts +3 -0
  615. package/dist/state/index.d.ts.map +1 -0
  616. package/dist/state/index.js +3 -0
  617. package/dist/state/index.js.map +1 -0
  618. package/dist/state/paths.d.ts +18 -0
  619. package/dist/state/paths.d.ts.map +1 -0
  620. package/dist/state/paths.js +51 -0
  621. package/dist/state/paths.js.map +1 -0
  622. package/dist/state/state-manager.d.ts +83 -0
  623. package/dist/state/state-manager.d.ts.map +1 -0
  624. package/dist/state/state-manager.js +380 -0
  625. package/dist/state/state-manager.js.map +1 -0
  626. package/dist/strategy/index.d.ts +2 -0
  627. package/dist/strategy/index.d.ts.map +1 -0
  628. package/dist/strategy/index.js +2 -0
  629. package/dist/strategy/index.js.map +1 -0
  630. package/dist/strategy/strategy-state.d.ts +51 -0
  631. package/dist/strategy/strategy-state.d.ts.map +1 -0
  632. package/dist/strategy/strategy-state.js +208 -0
  633. package/dist/strategy/strategy-state.js.map +1 -0
  634. package/dist/types/action.d.ts +15 -0
  635. package/dist/types/action.d.ts.map +1 -0
  636. package/dist/types/action.js +2 -0
  637. package/dist/types/action.js.map +1 -0
  638. package/dist/types/dsl/index.d.ts +286 -0
  639. package/dist/types/dsl/index.d.ts.map +1 -0
  640. package/dist/types/dsl/index.js +5 -0
  641. package/dist/types/dsl/index.js.map +1 -0
  642. package/dist/types/event-bus.d.ts +13 -0
  643. package/dist/types/event-bus.d.ts.map +1 -0
  644. package/dist/types/event-bus.js +6 -0
  645. package/dist/types/event-bus.js.map +1 -0
  646. package/dist/types/hooks.d.ts +30 -0
  647. package/dist/types/hooks.d.ts.map +1 -0
  648. package/dist/types/hooks.js +18 -0
  649. package/dist/types/hooks.js.map +1 -0
  650. package/dist/types/index.d.ts +6 -0
  651. package/dist/types/index.d.ts.map +1 -0
  652. package/dist/types/index.js +6 -0
  653. package/dist/types/index.js.map +1 -0
  654. package/dist/types/notification.d.ts +4 -0
  655. package/dist/types/notification.d.ts.map +1 -0
  656. package/dist/types/notification.js +3 -0
  657. package/dist/types/notification.js.map +1 -0
  658. package/dist/types/runtime.d.ts +18 -0
  659. package/dist/types/runtime.d.ts.map +1 -0
  660. package/dist/types/runtime.js +2 -0
  661. package/dist/types/runtime.js.map +1 -0
  662. package/dist/types/scanner.d.ts +59 -0
  663. package/dist/types/scanner.d.ts.map +1 -0
  664. package/dist/types/scanner.js +13 -0
  665. package/dist/types/scanner.js.map +1 -0
  666. package/dist/types/strategy.d.ts +104 -0
  667. package/dist/types/strategy.d.ts.map +1 -0
  668. package/dist/types/strategy.js +2 -0
  669. package/dist/types/strategy.js.map +1 -0
  670. package/dist/utils/logger/dsl.d.ts +8 -0
  671. package/dist/utils/logger/dsl.d.ts.map +1 -0
  672. package/dist/utils/logger/dsl.js +7 -0
  673. package/dist/utils/logger/dsl.js.map +1 -0
  674. package/dist/utils/logger.d.ts +23 -0
  675. package/dist/utils/logger.d.ts.map +1 -0
  676. package/dist/utils/logger.js +97 -0
  677. package/dist/utils/logger.js.map +1 -0
  678. package/dist/utils/perp-coin.d.ts +19 -0
  679. package/dist/utils/perp-coin.d.ts.map +1 -0
  680. package/dist/utils/perp-coin.js +40 -0
  681. package/dist/utils/perp-coin.js.map +1 -0
  682. package/dist/utils/response.d.ts +14 -0
  683. package/dist/utils/response.d.ts.map +1 -0
  684. package/dist/utils/response.js +44 -0
  685. package/dist/utils/response.js.map +1 -0
  686. package/dist/utils/retry.d.ts +19 -0
  687. package/dist/utils/retry.d.ts.map +1 -0
  688. package/dist/utils/retry.js +32 -0
  689. package/dist/utils/retry.js.map +1 -0
  690. package/dist/version.d.ts +6 -0
  691. package/dist/version.d.ts.map +1 -0
  692. package/dist/version.js +21 -0
  693. package/dist/version.js.map +1 -0
  694. package/examples/.env.example +25 -0
  695. package/examples/README.md +89 -0
  696. package/examples/scanners-consumer-quickstart.mjs +134 -0
  697. package/examples/scanners-emerging-movers-v4.mjs +287 -0
  698. package/examples/scanners-liquidation-watchdog.mjs +341 -0
  699. package/examples/scanners-live-mcp.mjs +208 -0
  700. package/examples/scanners-multi-strategy.mjs +165 -0
  701. package/examples/scanners-position-tracker-e2e.mjs +225 -0
  702. package/examples/scanners-scheduled-events.mjs +96 -0
  703. package/examples/scanners-senpi-provider-client.mjs +182 -0
  704. package/examples/scanners-single-strategy.mjs +198 -0
  705. package/examples/strategies/README.md +45 -0
  706. package/examples/strategies/dsl-showcase.yaml +63 -0
  707. package/examples/strategies/dsl.yaml +47 -0
  708. package/examples/strategies/fox-minimal-loosened.yaml +225 -0
  709. package/examples/strategies/fox-minimal.yaml +220 -0
  710. package/examples/strategies/minimal.yaml +44 -0
  711. package/examples/strategies/viper.yaml +59 -0
  712. package/examples/strategies/wolf.yaml +64 -0
  713. package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +115 -0
  714. package/openclaw.plugin.json +21 -0
  715. package/package.json +54 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config-validator.js","sourceRoot":"","sources":["../../../src/scanners/engine/config-validator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAC/B,UAA6B,EAC7B,MAAe,EACf,OAAe,EACf,SAAoB;IAEpB,IAAI,kBAAkB,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;QACxD,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,+BAA+B,SAAS,kBAAkB,OAAO,MAAM,6BAA6B,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CACxI,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,UAAoE,EACpE,KAAc,EACd,OAAe,EACf,SAAoB,EACpB,OAAO,GAAG,OAAO;IAEjB,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,kBAAkB,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,iBAAiB,SAAS,kBAAkB,OAAO,MAAM,6BAA6B,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAC1I,CAAC;AACJ,CAAC"}
@@ -0,0 +1,48 @@
1
+ import type { SharedArtifactContract } from "../artifacts.js";
2
+ import type { RuntimeStore } from "../store/runtime-store.js";
3
+ import type { SharedArtifactStore } from "../store/shared-artifact-store.js";
4
+ import type { SignalStore } from "../store/signal-store.js";
5
+ import type { CandlesByAsset, ScannerLogger, SharedArtifactAccessor } from "../protocol/context.js";
6
+ import type { Instrument, ScannerId, SmMarket } from "../types.js";
7
+ import type { ClearingHouseState } from "../implementations/liquidation-watchdog.js";
8
+ import type { DslState } from "../../types/dsl/index.js";
9
+ import type { ScannerEngineLifecycle } from "./lifecycle.js";
10
+ /** Minimal active-position shape consumed by scanner contexts. */
11
+ export type ActivePosition = Record<string, unknown>;
12
+ /** Optional metadata passed to candle providers to optimize request fanout. */
13
+ export interface CandleProviderOptions {
14
+ /** Scanner id requesting candle data. */
15
+ scannerId?: ScannerId;
16
+ /** Preferred candidate assets pre-selected by upstream artifacts (for example prescreener). */
17
+ preferredAssets?: string[];
18
+ }
19
+ /**
20
+ * External data sources used by the engine for provider-backed inputs only.
21
+ * Shared market intelligence is resolved separately through shared artifact bindings.
22
+ */
23
+ export interface ScannerDataProviders {
24
+ getInstruments?: (address: string) => Promise<Instrument[]>;
25
+ getCandles?: (address: string, instruments: Instrument[], options?: CandleProviderOptions) => Promise<CandlesByAsset>;
26
+ getOiHistory?: (address: string) => Promise<Record<string, import("../types.js").OiSnapshot[]>>;
27
+ getSmData?: (address: string) => Promise<SmMarket[]>;
28
+ getActivePositions?: (address: string) => Promise<ActivePosition[]>;
29
+ getClearingHouseState?: (address: string) => Promise<ClearingHouseState>;
30
+ getDslStatesForStrategy?: (address: string) => Promise<DslState[]>;
31
+ }
32
+ /** Stores required by the scanner engine runtime. */
33
+ export interface ScannerEngineStores {
34
+ runtimeStore: RuntimeStore;
35
+ signalStore: SignalStore;
36
+ sharedArtifactStore: SharedArtifactStore;
37
+ }
38
+ /** Constructor options for scanner engine orchestration. */
39
+ export interface ScannerEngineDependencies {
40
+ stores: ScannerEngineStores;
41
+ providers?: ScannerDataProviders;
42
+ logger?: ScannerLogger;
43
+ lifecycle?: ScannerEngineLifecycle;
44
+ now?: () => number;
45
+ }
46
+ /** Shared-artifact store accessors exposed through scanner init/run contexts. */
47
+ export declare function createSharedArtifactAccessor(address: string, scannerId: ScannerId, producedContract: SharedArtifactContract | undefined, sharedArtifactStore: SharedArtifactStore, resolveSourceScannerId: (artifactKey: string) => ScannerId | undefined): SharedArtifactAccessor;
48
+ //# sourceMappingURL=data-providers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"data-providers.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/data-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,QAAQ,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAChG,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACpE,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzE,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CACpE;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,sBAAsB,GAAG,SAAS,EACpD,mBAAmB,EAAE,mBAAmB,EACxC,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,GACrE,sBAAsB,CA8BxB"}
@@ -0,0 +1,28 @@
1
+ /** Shared-artifact store accessors exposed through scanner init/run contexts. */
2
+ export function createSharedArtifactAccessor(address, scannerId, producedContract, sharedArtifactStore, resolveSourceScannerId) {
3
+ return {
4
+ loadSharedArtifact: (artifact, opts) => sharedArtifactStore.loadByScanner(address, resolveSharedArtifactScannerId(artifact, resolveSourceScannerId), {
5
+ contract: typeof artifact === "string" ? undefined : artifact,
6
+ maxAgeMs: opts?.maxAgeMs,
7
+ }),
8
+ saveSharedArtifact: (artifact, value) => {
9
+ const contract = typeof artifact === "string" ? producedContract : artifact;
10
+ const artifactKey = typeof artifact === "string" ? artifact : artifact.key;
11
+ if (producedContract && artifactKey !== producedContract.key) {
12
+ throw new Error(`Scanner '${scannerId}' can only save its declared retained context '${producedContract.key}', but tried to save '${artifactKey}'.`);
13
+ }
14
+ return sharedArtifactStore.saveByScanner(address, scannerId, value, {
15
+ contract,
16
+ });
17
+ },
18
+ };
19
+ }
20
+ function resolveSharedArtifactScannerId(artifact, resolveSourceScannerId) {
21
+ const key = typeof artifact === "string" ? artifact : artifact.key;
22
+ const scannerId = resolveSourceScannerId(key);
23
+ if (!scannerId) {
24
+ throw new Error(`No source scanner is registered for retained context '${key}'.`);
25
+ }
26
+ return scannerId;
27
+ }
28
+ //# sourceMappingURL=data-providers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"data-providers.js","sourceRoot":"","sources":["../../../src/scanners/engine/data-providers.ts"],"names":[],"mappings":"AAkEA,iFAAiF;AACjF,MAAM,UAAU,4BAA4B,CAC1C,OAAe,EACf,SAAoB,EACpB,gBAAoD,EACpD,mBAAwC,EACxC,sBAAsE;IAEtE,OAAO;QACL,kBAAkB,EAAE,CAClB,QAA2C,EAC3C,IAA4B,EACc,EAAE,CAC5C,mBAAmB,CAAC,aAAa,CAC/B,OAAO,EACP,8BAA8B,CAAC,QAAQ,EAAE,sBAAsB,CAAC,EAChE;YACE,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAC7D,QAAQ,EAAE,IAAI,EAAE,QAAQ;SACzB,CAC0C;QAC/C,kBAAkB,EAAE,CAClB,QAA2C,EAC3C,KAA+B,EAChB,EAAE;YACjB,MAAM,QAAQ,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC5E,MAAM,WAAW,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC3E,IAAI,gBAAgB,IAAI,WAAW,KAAK,gBAAgB,CAAC,GAAG,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CACb,YAAY,SAAS,kDAAkD,gBAAgB,CAAC,GAAG,yBAAyB,WAAW,IAAI,CACpI,CAAC;YACJ,CAAC;YACD,OAAO,mBAAmB,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE;gBAClE,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CACrC,QAAyC,EACzC,sBAAsE;IAEtE,MAAM,GAAG,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;IACnE,MAAM,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yDAAyD,GAAG,IAAI,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
@@ -0,0 +1,92 @@
1
+ import type { Scanner } from "../protocol/scanner.js";
2
+ import type { ScanResult, ScannerId, StrategyRegistration } from "../types.js";
3
+ import { type ScannerEngineDependencies } from "./data-providers.js";
4
+ import { StrategyRegistry } from "./strategy-registry.js";
5
+ import type { ScannerComposition } from "../../runtime/scanner-composition.js";
6
+ /** Public scanner registration shape exposed for list operations. */
7
+ export interface ScannerRegistrationSummary {
8
+ address: string;
9
+ scannerId: ScannerId;
10
+ enabled: boolean;
11
+ intervalSeconds: number;
12
+ }
13
+ export interface ScannerRegistrationStateSummary extends ScannerRegistrationSummary {
14
+ initialized: boolean;
15
+ inFlight: boolean;
16
+ nextRunAt: number | null;
17
+ }
18
+ /** Runtime engine for scanner registration, scheduling, and one-off execution. */
19
+ export declare class ScannerEngine {
20
+ private readonly deps;
21
+ private readonly composition;
22
+ private readonly providers;
23
+ private readonly now;
24
+ private readonly registry;
25
+ private started;
26
+ private readonly inFlight;
27
+ constructor(deps: ScannerEngineDependencies, composition: ScannerComposition, registry?: StrategyRegistry);
28
+ /** Registers one scanner for one strategy runtime. */
29
+ register<Cfg = unknown, St = unknown>(strategy: StrategyRegistration, scanner: Scanner<Cfg, St>): void;
30
+ /** Enables scanner execution for one strategy + scanner key. */
31
+ enable(address: string, scannerId: ScannerId): void;
32
+ /** Disables scanner execution and clears active timer if present. */
33
+ disable(address: string, scannerId: ScannerId): void;
34
+ /** Starts interval scheduling for all enabled scanner registrations. */
35
+ start(): Promise<void>;
36
+ /** Stops all interval schedules and awaits in-flight runs before resolving. */
37
+ stop(): Promise<void>;
38
+ /** Lists registered scanners, optionally constrained to one strategy address. */
39
+ list(address?: string): ScannerRegistrationSummary[];
40
+ /** Lists detailed registration state used by health/state inspection surfaces. */
41
+ describeRegistrations(address?: string): ScannerRegistrationStateSummary[];
42
+ /** Reads scanner runtime config, bootstrapping runtime state when missing. */
43
+ getConfig(address: string, scannerId: ScannerId): Promise<unknown>;
44
+ /** Writes scanner runtime config after schema validation. */
45
+ setConfig(address: string, scannerId: ScannerId, config: unknown): Promise<void>;
46
+ /**
47
+ * Executes one scanner run for one (address, scannerId) key.
48
+ * Flow: overlap-guard -> runtime/config -> beforeScan -> scan -> normalize -> persist.
49
+ */
50
+ runOnce(address: string, scannerId: ScannerId): Promise<ScanResult>;
51
+ /** Executes one scanner plus its dependency chain immediately in topological order. */
52
+ runChain(address: string, scannerId: ScannerId): Promise<ScanResult[]>;
53
+ /** Reads one scanner's retained context payload, or null when it is unavailable. */
54
+ getScannerContext(address: string, scannerId: ScannerId): Promise<unknown | null>;
55
+ /**
56
+ * Builds a terminal result for pre-run guard failures such as disabled scanners
57
+ * or an overlapping in-flight execution for the same strategy/scanner pair.
58
+ */
59
+ private buildEarlyExitResult;
60
+ /**
61
+ * Ensures persisted runtime state exists, validates config/state, and runs the
62
+ * scanner's one-time initialization lifecycle before the first scan.
63
+ */
64
+ private ensureInitializedRuntime;
65
+ /**
66
+ * Builds the scan context for one run and applies the optional `beforeScan`
67
+ * hook, allowing scanners to gate or augment the prepared context.
68
+ */
69
+ private buildPreparedContext;
70
+ private buildFailureResult;
71
+ private schedule;
72
+ private buildInitContext;
73
+ private buildScanContext;
74
+ /**
75
+ * Persists a terminal run result only when the scanner's persistence policy
76
+ * says the result should be written to disk.
77
+ */
78
+ private persistIfNeeded;
79
+ /**
80
+ * Returns the registered strategy/scanner runtime entry or throws when the
81
+ * requested pair is unknown to the engine.
82
+ */
83
+ private requireRegistration;
84
+ private defaultStateFor;
85
+ private ensureValidState;
86
+ private emitRunStart;
87
+ private emitRunResult;
88
+ private bootstrapContextDependencies;
89
+ private buildAvailableScannerDefinitions;
90
+ private resolveSourceScannerId;
91
+ }
92
+ //# sourceMappingURL=engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EAET,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EACL,gBAAgB,EAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAI/E,qEAAqE;AACrE,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAAgC,SAAQ,0BAA0B;IACjF,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,kFAAkF;AAClF,qBAAa,aAAa;IAQtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAR9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;gBAGrC,IAAI,EAAE,yBAAyB,EAC/B,WAAW,EAAE,kBAAkB,EAChD,QAAQ,CAAC,EAAE,gBAAgB;IAO7B,sDAAsD;IACtD,QAAQ,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EAClC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,GACxB,IAAI;IASP,gEAAgE;IAChE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAYnD,qEAAqE;IACrE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAYpD,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B,+EAA+E;IACzE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,iFAAiF;IACjF,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,0BAA0B,EAAE;IASpD,kFAAkF;IAClF,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,+BAA+B,EAAE;IAY1E,8EAA8E;IACxE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxE,6DAA6D;IACvD,SAAS,CACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAgDzE,uFAAuF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAS5E,oFAAoF;IAC9E,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAU1B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;;OAGG;YACW,wBAAwB;IAgCtC;;;OAGG;YACW,oBAAoB;IAYlC,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,QAAQ;IAyChB,OAAO,CAAC,gBAAgB;YA0CV,gBAAgB;IAsB9B;;;OAGG;YACW,eAAe;IAW7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;YAqBT,gBAAgB;IA2B9B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,aAAa;YAYP,4BAA4B;IAgC1C,OAAO,CAAC,gCAAgC;IAaxC,OAAO,CAAC,sBAAsB;CAQ/B"}
@@ -0,0 +1,478 @@
1
+ import { SkipScan } from "../protocol/hooks.js";
2
+ import { ScanStatus as ScanStatusEnum } from "../types.js";
3
+ import { assertValidConfig, assertValidState } from "./config-validator.js";
4
+ import { createSharedArtifactAccessor, } from "./data-providers.js";
5
+ import { resolveScanInputs } from "./input-resolver.js";
6
+ import { buildResult, buildRunResult, formatError, shouldPersist, } from "./result-builder.js";
7
+ import { StrategyRegistry, } from "./strategy-registry.js";
8
+ /** Runtime engine for scanner registration, scheduling, and one-off execution. */
9
+ export class ScannerEngine {
10
+ deps;
11
+ composition;
12
+ providers;
13
+ now;
14
+ registry;
15
+ started = false;
16
+ inFlight = new Set();
17
+ constructor(deps, composition, registry) {
18
+ this.deps = deps;
19
+ this.composition = composition;
20
+ this.providers = deps.providers ?? {};
21
+ this.now = deps.now ?? Date.now;
22
+ this.registry = registry ?? new StrategyRegistry();
23
+ }
24
+ /** Registers one scanner for one strategy runtime. */
25
+ register(strategy, scanner) {
26
+ this.registry.registerStrategy(strategy);
27
+ const entry = this.registry.registerScanner(strategy.id, scanner);
28
+ assertValidConfig(scanner.definition, entry.initialConfig, strategy.id, scanner.definition.id);
29
+ if (this.started && entry.enabled) {
30
+ this.schedule(entry);
31
+ }
32
+ }
33
+ /** Enables scanner execution for one strategy + scanner key. */
34
+ enable(address, scannerId) {
35
+ this.registry.setEnabled(address, scannerId, true);
36
+ if (!this.started) {
37
+ return;
38
+ }
39
+ const entry = this.registry.get(address, scannerId);
40
+ if (entry) {
41
+ this.schedule(entry);
42
+ }
43
+ }
44
+ /** Disables scanner execution and clears active timer if present. */
45
+ disable(address, scannerId) {
46
+ this.registry.setEnabled(address, scannerId, false);
47
+ this.registry.setNextRunAt(address, scannerId, null);
48
+ const entry = this.registry.get(address, scannerId);
49
+ if (!entry?.timer) {
50
+ return;
51
+ }
52
+ clearInterval(entry.timer);
53
+ this.registry.setTimer(address, scannerId, null);
54
+ }
55
+ /** Starts interval scheduling for all enabled scanner registrations. */
56
+ async start() {
57
+ if (this.started) {
58
+ this.deps.logger?.info?.("Scanner engine start() skipped (already started)");
59
+ return;
60
+ }
61
+ this.deps.logger?.info?.("Scanner engine start() entered");
62
+ this.started = true;
63
+ const entries = this.registry.list();
64
+ const toSchedule = entries.filter((e) => e.enabled);
65
+ const summary = {
66
+ total: entries.length,
67
+ enabled: toSchedule.length,
68
+ scanners: toSchedule.map((e) => ({
69
+ address: e.address,
70
+ scannerId: e.scanner.definition.id,
71
+ intervalSeconds: e.intervalSeconds,
72
+ })),
73
+ };
74
+ this.deps.logger?.info?.("Scanner engine start: scheduling scanners", summary);
75
+ await this.bootstrapContextDependencies();
76
+ for (const entry of toSchedule) {
77
+ this.schedule(entry);
78
+ }
79
+ this.deps.logger?.info?.("Scanner engine start() complete");
80
+ }
81
+ /** Stops all interval schedules and awaits in-flight runs before resolving. */
82
+ async stop() {
83
+ this.started = false;
84
+ this.registry.clearAllTimers();
85
+ const pending = Array.from(this.inFlight);
86
+ if (pending.length > 0) {
87
+ await Promise.allSettled(pending);
88
+ }
89
+ }
90
+ /** Lists registered scanners, optionally constrained to one strategy address. */
91
+ list(address) {
92
+ return this.registry.list(address).map((entry) => ({
93
+ address: entry.address,
94
+ scannerId: entry.scanner.definition.id,
95
+ enabled: entry.enabled,
96
+ intervalSeconds: entry.intervalSeconds,
97
+ }));
98
+ }
99
+ /** Lists detailed registration state used by health/state inspection surfaces. */
100
+ describeRegistrations(address) {
101
+ return this.registry.list(address).map((entry) => ({
102
+ address: entry.address,
103
+ scannerId: entry.scanner.definition.id,
104
+ enabled: entry.enabled,
105
+ intervalSeconds: entry.intervalSeconds,
106
+ initialized: entry.initialized,
107
+ inFlight: entry.lastScanTime !== null,
108
+ nextRunAt: entry.nextRunAt,
109
+ }));
110
+ }
111
+ /** Reads scanner runtime config, bootstrapping runtime state when missing. */
112
+ async getConfig(address, scannerId) {
113
+ const entry = this.requireRegistration(address, scannerId);
114
+ const runtime = await this.deps.stores.runtimeStore.ensure(address, scannerId, {
115
+ config: entry.initialConfig,
116
+ state: this.defaultStateFor(entry),
117
+ });
118
+ assertValidConfig(entry.scanner.definition, runtime.config, address, scannerId);
119
+ return runtime.config;
120
+ }
121
+ /** Writes scanner runtime config after schema validation. */
122
+ async setConfig(address, scannerId, config) {
123
+ const entry = this.requireRegistration(address, scannerId);
124
+ assertValidConfig(entry.scanner.definition, config, address, scannerId);
125
+ entry.initialConfig = config;
126
+ const existing = await this.deps.stores.runtimeStore.read(address, scannerId);
127
+ if (existing) {
128
+ await this.deps.stores.runtimeStore.setConfig(address, scannerId, config);
129
+ return;
130
+ }
131
+ await this.deps.stores.runtimeStore.ensure(address, scannerId, {
132
+ config,
133
+ state: this.defaultStateFor(entry),
134
+ });
135
+ }
136
+ /**
137
+ * Executes one scanner run for one (address, scannerId) key.
138
+ * Flow: overlap-guard -> runtime/config -> beforeScan -> scan -> normalize -> persist.
139
+ */
140
+ async runOnce(address, scannerId) {
141
+ const entry = this.requireRegistration(address, scannerId);
142
+ const attemptTimestamp = this.now();
143
+ this.deps.logger?.info?.("Scan initiated", {
144
+ address,
145
+ scannerId,
146
+ timestamp: attemptTimestamp,
147
+ });
148
+ const earlyExit = this.buildEarlyExitResult(entry, attemptTimestamp);
149
+ if (earlyExit) {
150
+ this.emitRunResult(earlyExit);
151
+ return earlyExit;
152
+ }
153
+ this.emitRunStart({
154
+ address,
155
+ scannerId,
156
+ timestamp: attemptTimestamp,
157
+ });
158
+ this.registry.setLastScanTime(address, scannerId, attemptTimestamp);
159
+ try {
160
+ const runtime = await this.ensureInitializedRuntime(entry);
161
+ const context = await this.buildPreparedContext(entry, runtime, attemptTimestamp);
162
+ const output = await entry.scanner.scan(context);
163
+ const result = buildRunResult(entry, context, output, this.now, this.deps.logger);
164
+ await this.persistIfNeeded(entry, result);
165
+ this.emitRunResult(result);
166
+ return result;
167
+ }
168
+ catch (error) {
169
+ const result = this.buildFailureResult(entry, error);
170
+ if (!(error instanceof SkipScan)) {
171
+ this.deps.logger?.error?.("Scanner run failed.", {
172
+ address,
173
+ scannerId,
174
+ error,
175
+ });
176
+ }
177
+ await this.persistIfNeeded(entry, result);
178
+ this.emitRunResult(result);
179
+ return result;
180
+ }
181
+ finally {
182
+ this.registry.setLastScanTime(address, scannerId, null);
183
+ }
184
+ }
185
+ /** Executes one scanner plus its dependency chain immediately in topological order. */
186
+ async runChain(address, scannerId) {
187
+ const chain = this.composition.getRunChain(scannerId);
188
+ const results = [];
189
+ for (const dependencyId of chain) {
190
+ results.push(await this.runOnce(address, dependencyId));
191
+ }
192
+ return results;
193
+ }
194
+ /** Reads one scanner's retained context payload, or null when it is unavailable. */
195
+ async getScannerContext(address, scannerId) {
196
+ const contract = this.composition.producedContextByScanner.get(scannerId);
197
+ if (!contract) {
198
+ return null;
199
+ }
200
+ return this.deps.stores.sharedArtifactStore.loadByScanner(address, scannerId, {
201
+ contract,
202
+ });
203
+ }
204
+ /**
205
+ * Builds a terminal result for pre-run guard failures such as disabled scanners
206
+ * or an overlapping in-flight execution for the same strategy/scanner pair.
207
+ */
208
+ buildEarlyExitResult(entry, timestamp) {
209
+ if (!entry.enabled) {
210
+ return buildResult({
211
+ address: entry.address,
212
+ scannerId: entry.scanner.definition.id,
213
+ timestamp,
214
+ status: ScanStatusEnum.DISABLED,
215
+ reason: "Scanner is disabled.",
216
+ summary: {},
217
+ });
218
+ }
219
+ if (entry.lastScanTime !== null) {
220
+ return buildResult({
221
+ address: entry.address,
222
+ scannerId: entry.scanner.definition.id,
223
+ timestamp,
224
+ status: ScanStatusEnum.HALTED,
225
+ reason: "Scanner run already in progress.",
226
+ summary: {
227
+ inFlightSince: entry.lastScanTime,
228
+ },
229
+ });
230
+ }
231
+ return null;
232
+ }
233
+ /**
234
+ * Ensures persisted runtime state exists, validates config/state, and runs the
235
+ * scanner's one-time initialization lifecycle before the first scan.
236
+ */
237
+ async ensureInitializedRuntime(entry) {
238
+ const address = entry.address;
239
+ const scannerId = entry.scanner.definition.id;
240
+ let runtime = await this.deps.stores.runtimeStore.ensure(address, scannerId, {
241
+ config: entry.initialConfig,
242
+ state: this.defaultStateFor(entry),
243
+ });
244
+ assertValidConfig(entry.scanner.definition, runtime.config, address, scannerId);
245
+ runtime = await this.ensureValidState(entry, runtime);
246
+ if (!entry.initialized) {
247
+ await entry.scanner.initialize(this.buildInitContext(entry, runtime));
248
+ this.registry.setInitialized(address, scannerId, true);
249
+ runtime =
250
+ (await this.deps.stores.runtimeStore.read(address, scannerId)) ?? runtime;
251
+ runtime = await this.ensureValidState(entry, runtime);
252
+ }
253
+ return runtime;
254
+ }
255
+ /**
256
+ * Builds the scan context for one run and applies the optional `beforeScan`
257
+ * hook, allowing scanners to gate or augment the prepared context.
258
+ */
259
+ async buildPreparedContext(entry, runtime, runStartedAt) {
260
+ let context = await this.buildScanContext(entry, runtime, runStartedAt);
261
+ if (entry.scanner.hooks?.beforeScan) {
262
+ context = await entry.scanner.hooks.beforeScan(context);
263
+ }
264
+ return context;
265
+ }
266
+ buildFailureResult(entry, error) {
267
+ if (error instanceof SkipScan) {
268
+ return buildResult({
269
+ address: entry.address,
270
+ scannerId: entry.scanner.definition.id,
271
+ timestamp: this.now(),
272
+ status: error.status,
273
+ reason: error.message,
274
+ summary: {},
275
+ });
276
+ }
277
+ return buildResult({
278
+ address: entry.address,
279
+ scannerId: entry.scanner.definition.id,
280
+ timestamp: this.now(),
281
+ status: ScanStatusEnum.ERROR,
282
+ reason: formatError(error),
283
+ summary: {
284
+ errorName: error instanceof Error ? error.name : "UnknownError",
285
+ },
286
+ });
287
+ }
288
+ schedule(entry) {
289
+ const scannerId = entry.scanner.definition.id;
290
+ if (entry.timer || !entry.enabled) {
291
+ return;
292
+ }
293
+ const intervalMs = Math.max(entry.intervalSeconds, 1) * 1000;
294
+ const scheduleMeta = {
295
+ address: entry.address,
296
+ scannerId,
297
+ intervalSeconds: entry.intervalSeconds,
298
+ intervalMs,
299
+ };
300
+ this.deps.logger?.info?.("Scanner scheduled", scheduleMeta);
301
+ this.registry.setNextRunAt(entry.address, scannerId, this.now() + intervalMs);
302
+ const timer = setInterval(() => {
303
+ this.registry.setNextRunAt(entry.address, scannerId, this.now() + intervalMs);
304
+ this.deps.logger?.info?.("Scheduled timer fired, invoking runOnce", {
305
+ address: entry.address,
306
+ scannerId,
307
+ });
308
+ const p = this.runOnce(entry.address, scannerId);
309
+ this.inFlight.add(p);
310
+ void p
311
+ .catch((error) => {
312
+ this.deps.logger?.error?.("Scheduled scanner run failed.", {
313
+ address: entry.address,
314
+ scannerId,
315
+ error,
316
+ });
317
+ })
318
+ .finally(() => {
319
+ this.inFlight.delete(p);
320
+ });
321
+ }, intervalMs);
322
+ this.registry.setTimer(entry.address, scannerId, timer);
323
+ }
324
+ buildInitContext(entry, runtime) {
325
+ const sharedArtifacts = createSharedArtifactAccessor(entry.address, entry.scanner.definition.id, entry.scanner.definition.artifacts?.produces?.[0], this.deps.stores.sharedArtifactStore, (artifactKey) => this.resolveSourceScannerId(artifactKey));
326
+ const context = {
327
+ ...sharedArtifacts,
328
+ address: entry.address,
329
+ scannerId: entry.scanner.definition.id,
330
+ definition: entry.scanner.definition,
331
+ runtime,
332
+ config: runtime.config,
333
+ state: runtime.state,
334
+ now: this.now,
335
+ logger: this.deps.logger,
336
+ setState: async (nextState) => {
337
+ assertValidState(entry.scanner.definition, nextState, entry.address, entry.scanner.definition.id);
338
+ const next = await this.deps.stores.runtimeStore.setState(entry.address, entry.scanner.definition.id, nextState);
339
+ context.runtime = next;
340
+ context.state = next.state;
341
+ },
342
+ };
343
+ return context;
344
+ }
345
+ async buildScanContext(entry, runtime, runStartedAt) {
346
+ const inputs = await resolveScanInputs({
347
+ address: entry.address,
348
+ definition: entry.scanner.definition,
349
+ providers: this.providers,
350
+ sharedArtifactStore: this.deps.stores.sharedArtifactStore,
351
+ availableScanners: this.buildAvailableScannerDefinitions(entry.address),
352
+ now: this.now,
353
+ });
354
+ return {
355
+ ...this.buildInitContext(entry, runtime),
356
+ runStartedAt,
357
+ inputs: inputs.inputs,
358
+ dependencies: inputs.dependencies,
359
+ };
360
+ }
361
+ /**
362
+ * Persists a terminal run result only when the scanner's persistence policy
363
+ * says the result should be written to disk.
364
+ */
365
+ async persistIfNeeded(entry, result) {
366
+ if (!shouldPersist(entry.scanner.definition.persistence, result)) {
367
+ return;
368
+ }
369
+ await this.deps.stores.signalStore.write(result, entry.scanner.definition);
370
+ }
371
+ /**
372
+ * Returns the registered strategy/scanner runtime entry or throws when the
373
+ * requested pair is unknown to the engine.
374
+ */
375
+ requireRegistration(address, scannerId) {
376
+ const entry = this.registry.get(address, scannerId);
377
+ if (!entry) {
378
+ throw new Error(`Scanner '${scannerId}' is not registered for strategy '${address}'.`);
379
+ }
380
+ return entry;
381
+ }
382
+ defaultStateFor(entry) {
383
+ const definition = entry.scanner.definition;
384
+ if (definition.defaultState === undefined) {
385
+ if (definition.stateSchema) {
386
+ throw new Error(`Scanner '${definition.id}' declares stateSchema but is missing defaultState.`);
387
+ }
388
+ return {};
389
+ }
390
+ assertValidState(definition, definition.defaultState, entry.address, definition.id, "default state");
391
+ return cloneRuntimeValue(definition.defaultState);
392
+ }
393
+ async ensureValidState(entry, runtime) {
394
+ try {
395
+ assertValidState(entry.scanner.definition, runtime.state, entry.address, entry.scanner.definition.id);
396
+ return runtime;
397
+ }
398
+ catch (error) {
399
+ const nextState = this.defaultStateFor(entry);
400
+ this.deps.logger?.warn?.("Scanner state failed validation; resetting to default state.", {
401
+ address: entry.address,
402
+ scannerId: entry.scanner.definition.id,
403
+ error,
404
+ });
405
+ return this.deps.stores.runtimeStore.setState(entry.address, entry.scanner.definition.id, nextState);
406
+ }
407
+ }
408
+ emitRunStart(event) {
409
+ try {
410
+ this.deps.lifecycle?.onRunStart?.(event);
411
+ }
412
+ catch (error) {
413
+ this.deps.logger?.warn?.("Scanner run-start lifecycle callback failed.", {
414
+ address: event.address,
415
+ scannerId: event.scannerId,
416
+ error,
417
+ });
418
+ }
419
+ }
420
+ emitRunResult(result) {
421
+ try {
422
+ this.deps.lifecycle?.onRunResult?.(result);
423
+ }
424
+ catch (error) {
425
+ this.deps.logger?.warn?.("Scanner run-result lifecycle callback failed.", {
426
+ address: result.address,
427
+ scannerId: result.scannerId,
428
+ error,
429
+ });
430
+ }
431
+ }
432
+ async bootstrapContextDependencies() {
433
+ const sourceIds = this.composition.topologicalOrder.filter((scannerId) => {
434
+ const node = this.composition.scanners.get(scannerId);
435
+ return Boolean(node &&
436
+ this.composition.dependencySources.has(scannerId) &&
437
+ node.outputs.context &&
438
+ !node.outputs.signals);
439
+ });
440
+ for (const scannerId of sourceIds) {
441
+ for (const entry of this.registry.list().filter((candidate) => {
442
+ return candidate.scanner.definition.id === scannerId && candidate.enabled;
443
+ })) {
444
+ const producedContract = entry.scanner.definition.artifacts?.produces?.[0];
445
+ if (!producedContract) {
446
+ continue;
447
+ }
448
+ const existing = await this.deps.stores.sharedArtifactStore.loadEnvelopeByScanner(entry.address, scannerId, { contract: producedContract });
449
+ if (existing) {
450
+ continue;
451
+ }
452
+ await this.runOnce(entry.address, scannerId);
453
+ }
454
+ }
455
+ }
456
+ buildAvailableScannerDefinitions(address) {
457
+ const definitions = new Map();
458
+ for (const entry of this.registry.list(address)) {
459
+ definitions.set(entry.scanner.definition.id, entry.scanner.definition);
460
+ }
461
+ return definitions;
462
+ }
463
+ resolveSourceScannerId(artifactKey) {
464
+ for (const [scannerId, contract] of this.composition.producedContextByScanner) {
465
+ if (contract.key === artifactKey) {
466
+ return scannerId;
467
+ }
468
+ }
469
+ return undefined;
470
+ }
471
+ }
472
+ function cloneRuntimeValue(value) {
473
+ if (value === null || typeof value !== "object") {
474
+ return value;
475
+ }
476
+ return structuredClone(value);
477
+ }
478
+ //# sourceMappingURL=engine.js.map