@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,47 @@
1
+ import type { ScannerDefinition } from "../scanner-definition.js";
2
+ import type { ScannerScanOutput } from "../types.js";
3
+ import type { ScanContext, ScannerInitContext } from "./context.js";
4
+ import type { ScannerHooks } from "./hooks.js";
5
+ /**
6
+ * Core scanner contract implemented by all strategy-runtime scanners.
7
+ *
8
+ * Each scanner declares a {@link ScannerDefinition} describing its identity,
9
+ * provider-backed inputs, shared market intelligence contracts, scheduling interval, and persistence/retention policies. The engine
10
+ * calls {@link initialize} once per (address, scannerId) registration, then
11
+ * calls {@link scan} on each scheduled or manual run.
12
+ *
13
+ * **Lifecycle:**
14
+ * 1. Engine loads/creates runtime state and builds an init context.
15
+ * 2. `initialize(ctx)` is called once — use it to bootstrap scanner-local state
16
+ * or validate prerequisites. The init context provides `setState()` for persisting
17
+ * initial state and `loadSharedArtifact()` / `saveSharedArtifact()` for shared market intelligence.
18
+ * 3. On each run, the engine builds a scan context with resolved provider-backed
19
+ * inputs plus shared market intelligence under `ctx.inputs.artifacts`.
20
+ * 4. If `hooks.beforeScan` is defined, it runs first and may throw `SkipScan` to abort.
21
+ * 5. `scan(ctx)` executes scanner logic and returns signals + metadata.
22
+ * 6. The engine normalizes scores to [0, 1], applies `hooks.isActionable` filtering,
23
+ * and persists results according to the scanner's policies.
24
+ *
25
+ * @typeParam Cfg - Scanner configuration type (validated against `definition.configSchema`).
26
+ * @typeParam St - Scanner-local mutable state type (persisted across runs via `ctx.setState()`).
27
+ */
28
+ export interface Scanner<Cfg = unknown, St = unknown> {
29
+ /** Static scanner metadata: identity, input contracts, scheduling, persistence. */
30
+ definition: ScannerDefinition<Cfg, St>;
31
+ /** Optional pre/post-scan behavior customizations. */
32
+ hooks?: ScannerHooks<Cfg, St>;
33
+ /**
34
+ * Called once per (address, scannerId) registration before the first scan.
35
+ * Use this to initialize scanner-local state, validate config, or load prerequisites.
36
+ * The context provides `setState()` for persisting initial state to disk.
37
+ */
38
+ initialize: (ctx: ScannerInitContext<Cfg, St>) => Promise<void>;
39
+ /**
40
+ * Executes one scanner run and returns signals with execution metadata.
41
+ * The context includes resolved provider-backed inputs, shared market intelligence,
42
+ * current config/state, and shared artifact accessors. Signals returned here are normalized by the
43
+ * engine (score clamping, factor coercion) before persistence.
44
+ */
45
+ scan: (ctx: ScanContext<Cfg, St>) => Promise<ScannerScanOutput>;
46
+ }
47
+ //# sourceMappingURL=scanner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/scanners/protocol/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,OAAO,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO;IAClD,mFAAmF;IACnF,UAAU,EAAE,iBAAiB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAEvC,sDAAsD;IACtD,KAAK,CAAC,EAAE,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAE9B;;;;OAIG;IACH,UAAU,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjE"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=scanner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../../src/scanners/protocol/scanner.ts"],"names":[],"mappings":""}
@@ -0,0 +1,23 @@
1
+ import type { CandleResult, Instrument, SmMarket } from "../types.js";
2
+ /** Summary of rows/issues encountered while normalizing one provider payload. */
3
+ export interface NormalizationDiagnostics {
4
+ acceptedCount: number;
5
+ discardedCount: number;
6
+ issueCounts: Record<string, number>;
7
+ }
8
+ /** Normalized value paired with diagnostics describing discarded rows/issues. */
9
+ export interface NormalizationResult<T> {
10
+ value: T;
11
+ diagnostics: NormalizationDiagnostics;
12
+ }
13
+ /** Strictly maps `market_list_instruments` payload into scanner `Instrument[]`. */
14
+ export declare function normalizeInstruments(raw: unknown): Instrument[];
15
+ /** Strictly maps `market_list_instruments` payload and reports discarded-row diagnostics. */
16
+ export declare function normalizeInstrumentsWithDiagnostics(raw: unknown): NormalizationResult<Instrument[]>;
17
+ /** Strictly maps one `market_get_asset_data` payload into scanner `CandleResult`. */
18
+ export declare function normalizeAssetCandles(raw: unknown): CandleResult;
19
+ /** Strictly maps `leaderboard_get_markets` payload into scanner `SmMarket[]`. */
20
+ export declare function normalizeSmMarkets(raw: unknown): SmMarket[];
21
+ /** Strictly maps `leaderboard_get_markets` payload and reports discarded-row diagnostics. */
22
+ export declare function normalizeSmMarketsWithDiagnostics(raw: unknown): NormalizationResult<SmMarket[]>;
23
+ //# sourceMappingURL=adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/scanners/providers/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAS9E,iFAAiF;AACjF,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,iFAAiF;AACjF,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,EAAE,wBAAwB,CAAC;CACvC;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,CAE/D;AAED,6FAA6F;AAC7F,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,OAAO,GACX,mBAAmB,CAAC,UAAU,EAAE,CAAC,CAuEnC;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAqChE;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,EAAE,CAE3D;AAED,6FAA6F;AAC7F,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,OAAO,GACX,mBAAmB,CAAC,QAAQ,EAAE,CAAC,CAiDjC"}
@@ -0,0 +1,227 @@
1
+ import { isRecord, unwrapEnvelope, asString, asNumber } from "../../utils/response.js";
2
+ /** Strictly maps `market_list_instruments` payload into scanner `Instrument[]`. */
3
+ export function normalizeInstruments(raw) {
4
+ return normalizeInstrumentsWithDiagnostics(raw).value;
5
+ }
6
+ /** Strictly maps `market_list_instruments` payload and reports discarded-row diagnostics. */
7
+ export function normalizeInstrumentsWithDiagnostics(raw) {
8
+ const diagnostics = createNormalizationDiagnostics();
9
+ const unwrapped = unwrapEnvelope(raw);
10
+ if (!isRecord(unwrapped)) {
11
+ recordIssue(diagnostics, "invalid_payload");
12
+ return createNormalizationResult([], diagnostics);
13
+ }
14
+ const instrumentsRaw = unwrapped.instruments;
15
+ if (!Array.isArray(instrumentsRaw)) {
16
+ recordIssue(diagnostics, "missing_instruments_array");
17
+ return createNormalizationResult([], diagnostics);
18
+ }
19
+ const result = [];
20
+ for (const row of instrumentsRaw) {
21
+ if (!isRecord(row)) {
22
+ recordDiscard(diagnostics, "invalid_row_shape");
23
+ continue;
24
+ }
25
+ const name = asString(row.name);
26
+ const isDelisted = asBoolean(row.is_delisted);
27
+ const maxLeverage = asNumber(row.max_leverage);
28
+ const context = isRecord(row.context) ? row.context : null;
29
+ if (name === null ||
30
+ isDelisted === null ||
31
+ maxLeverage === null ||
32
+ context === null) {
33
+ recordDiscard(diagnostics, "missing_required_fields");
34
+ continue;
35
+ }
36
+ const markPx = asNumber(context.markPx);
37
+ const prevDayPx = asNumber(context.prevDayPx);
38
+ const midPx = asNumber(context.midPx);
39
+ const dayNtlVlm = asNumber(context.dayNtlVlm);
40
+ const openInterest = asNumber(context.openInterest);
41
+ const funding = asNumber(context.funding);
42
+ if (markPx === null ||
43
+ prevDayPx === null ||
44
+ midPx === null ||
45
+ dayNtlVlm === null ||
46
+ openInterest === null ||
47
+ funding === null) {
48
+ recordDiscard(diagnostics, "invalid_context_fields");
49
+ continue;
50
+ }
51
+ result.push({
52
+ name,
53
+ isDelisted,
54
+ maxLeverage,
55
+ context: {
56
+ ...context,
57
+ markPx,
58
+ prevDayPx,
59
+ midPx,
60
+ dayNtlVlm,
61
+ openInterest,
62
+ funding,
63
+ },
64
+ });
65
+ diagnostics.acceptedCount += 1;
66
+ }
67
+ return createNormalizationResult(result, diagnostics);
68
+ }
69
+ /** Strictly maps one `market_get_asset_data` payload into scanner `CandleResult`. */
70
+ export function normalizeAssetCandles(raw) {
71
+ const unwrapped = unwrapEnvelope(raw);
72
+ if (!isRecord(unwrapped)) {
73
+ return {
74
+ candles: {},
75
+ error: "Invalid asset data payload.",
76
+ };
77
+ }
78
+ const payload = unwrapped;
79
+ const candleMap = isRecord(payload.candles) ? payload.candles : {};
80
+ const candles = {};
81
+ let invalidRows = 0;
82
+ for (const [timeframe, series] of Object.entries(candleMap)) {
83
+ if (!Array.isArray(series)) {
84
+ invalidRows += 1;
85
+ continue;
86
+ }
87
+ const normalized = series
88
+ .map((row) => normalizeCandleRow(row))
89
+ .filter((row) => row !== null);
90
+ invalidRows += series.length - normalized.length;
91
+ candles[timeframe] = normalized;
92
+ }
93
+ const providerError = typeof payload.error === "string" ? payload.error : undefined;
94
+ const parseError = invalidRows > 0
95
+ ? `Discarded ${invalidRows} candle rows due to invalid shape.`
96
+ : undefined;
97
+ return {
98
+ candles,
99
+ error: [providerError, parseError].filter(Boolean).join(" | ") || undefined,
100
+ };
101
+ }
102
+ /** Strictly maps `leaderboard_get_markets` payload into scanner `SmMarket[]`. */
103
+ export function normalizeSmMarkets(raw) {
104
+ return normalizeSmMarketsWithDiagnostics(raw).value;
105
+ }
106
+ /** Strictly maps `leaderboard_get_markets` payload and reports discarded-row diagnostics. */
107
+ export function normalizeSmMarketsWithDiagnostics(raw) {
108
+ const diagnostics = createNormalizationDiagnostics();
109
+ const unwrapped = unwrapEnvelope(raw);
110
+ const rows = readRawMarketRows(unwrapped);
111
+ if (rows.length === 0) {
112
+ if (!Array.isArray(unwrapped) && !isRecord(unwrapped)) {
113
+ recordIssue(diagnostics, "invalid_payload");
114
+ }
115
+ else {
116
+ recordIssue(diagnostics, "missing_markets_array");
117
+ }
118
+ return createNormalizationResult([], diagnostics);
119
+ }
120
+ const result = [];
121
+ for (const row of rows) {
122
+ if (!isRecord(row)) {
123
+ recordDiscard(diagnostics, "invalid_row_shape");
124
+ continue;
125
+ }
126
+ const token = asString(row.token);
127
+ const direction = asString(row.direction);
128
+ const pctOfTopTradersGain = asNumber(row.pct_of_top_traders_gain);
129
+ const traderCount = asNumber(row.trader_count);
130
+ const tokenPriceChangePct4h = asNumber(row.token_price_change_pct_4h);
131
+ if (token === null ||
132
+ direction === null ||
133
+ pctOfTopTradersGain === null ||
134
+ traderCount === null ||
135
+ tokenPriceChangePct4h === null) {
136
+ recordDiscard(diagnostics, "missing_required_fields");
137
+ continue;
138
+ }
139
+ const dex = asString(row.dex);
140
+ result.push({
141
+ token,
142
+ direction,
143
+ pctOfTopTradersGain,
144
+ traderCount,
145
+ tokenPriceChangePct4h,
146
+ ...(dex !== null ? { dex } : {}),
147
+ });
148
+ diagnostics.acceptedCount += 1;
149
+ }
150
+ return createNormalizationResult(result, diagnostics);
151
+ }
152
+ function normalizeCandleRow(raw) {
153
+ if (!isRecord(raw)) {
154
+ return null;
155
+ }
156
+ const row = {
157
+ t: raw.t,
158
+ o: raw.o,
159
+ h: raw.h,
160
+ l: raw.l,
161
+ c: raw.c,
162
+ v: raw.v,
163
+ };
164
+ const timestamp = asNumber(row.t);
165
+ const open = asNumber(row.o);
166
+ const high = asNumber(row.h);
167
+ const low = asNumber(row.l);
168
+ const close = asNumber(row.c);
169
+ const volume = asNumber(row.v);
170
+ if (timestamp === null ||
171
+ open === null ||
172
+ high === null ||
173
+ low === null ||
174
+ close === null ||
175
+ volume === null) {
176
+ return null;
177
+ }
178
+ return {
179
+ timestamp,
180
+ open,
181
+ high,
182
+ low,
183
+ close,
184
+ volume,
185
+ };
186
+ }
187
+ function readRawMarketRows(input) {
188
+ if (Array.isArray(input)) {
189
+ return input;
190
+ }
191
+ if (!isRecord(input)) {
192
+ return [];
193
+ }
194
+ const markets = input.markets;
195
+ if (Array.isArray(markets)) {
196
+ return markets;
197
+ }
198
+ if (!isRecord(markets)) {
199
+ return [];
200
+ }
201
+ const nested = markets.markets;
202
+ return Array.isArray(nested) ? nested : [];
203
+ }
204
+ function asBoolean(value) {
205
+ return typeof value === "boolean" ? value : null;
206
+ }
207
+ function createNormalizationDiagnostics() {
208
+ return {
209
+ acceptedCount: 0,
210
+ discardedCount: 0,
211
+ issueCounts: {},
212
+ };
213
+ }
214
+ function recordDiscard(diagnostics, issue) {
215
+ diagnostics.discardedCount += 1;
216
+ diagnostics.issueCounts[issue] = (diagnostics.issueCounts[issue] ?? 0) + 1;
217
+ }
218
+ function recordIssue(diagnostics, issue) {
219
+ diagnostics.issueCounts[issue] = (diagnostics.issueCounts[issue] ?? 0) + 1;
220
+ }
221
+ function createNormalizationResult(value, diagnostics) {
222
+ return {
223
+ value,
224
+ diagnostics,
225
+ };
226
+ }
227
+ //# sourceMappingURL=adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/scanners/providers/adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Small in-memory cache with TTL + in-flight de-duplication.
3
+ * Intended for provider-layer request fanout control.
4
+ */
5
+ /** Cache used by providers to reuse recent responses and collapse concurrent calls. */
6
+ export declare class ProviderCache {
7
+ private readonly now;
8
+ private readonly entries;
9
+ private readonly inflight;
10
+ constructor(now?: () => number);
11
+ /**
12
+ * Returns cached value when fresh; otherwise executes loader once for all callers.
13
+ * `ttlMs <= 0` disables persistence but still preserves in-flight de-duplication.
14
+ */
15
+ getOrLoad<T>(key: string, ttlMs: number, loader: () => Promise<T>): Promise<T>;
16
+ /** Drops all cached and in-flight entries. */
17
+ clear(): void;
18
+ private readCached;
19
+ }
20
+ //# sourceMappingURL=cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/scanners/providers/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,uFAAuF;AACvF,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;gBAEnC,GAAG,GAAE,MAAM,MAAiB;IAEzD;;;OAGG;IACG,SAAS,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC;IA8Bb,8CAA8C;IAC9C,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,UAAU;CAWnB"}
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Small in-memory cache with TTL + in-flight de-duplication.
3
+ * Intended for provider-layer request fanout control.
4
+ */
5
+ /** Cache used by providers to reuse recent responses and collapse concurrent calls. */
6
+ export class ProviderCache {
7
+ now;
8
+ entries = new Map();
9
+ inflight = new Map();
10
+ constructor(now = Date.now) {
11
+ this.now = now;
12
+ }
13
+ /**
14
+ * Returns cached value when fresh; otherwise executes loader once for all callers.
15
+ * `ttlMs <= 0` disables persistence but still preserves in-flight de-duplication.
16
+ */
17
+ async getOrLoad(key, ttlMs, loader) {
18
+ const cached = this.readCached(key);
19
+ if (cached !== null) {
20
+ return cached;
21
+ }
22
+ const existingInflight = this.inflight.get(key);
23
+ if (existingInflight) {
24
+ return existingInflight;
25
+ }
26
+ const promise = (async () => {
27
+ try {
28
+ const value = await loader();
29
+ if (ttlMs > 0) {
30
+ this.entries.set(key, {
31
+ value,
32
+ expiresAt: this.now() + ttlMs,
33
+ });
34
+ }
35
+ return value;
36
+ }
37
+ finally {
38
+ this.inflight.delete(key);
39
+ }
40
+ })();
41
+ this.inflight.set(key, promise);
42
+ return promise;
43
+ }
44
+ /** Drops all cached and in-flight entries. */
45
+ clear() {
46
+ this.entries.clear();
47
+ this.inflight.clear();
48
+ }
49
+ readCached(key) {
50
+ const entry = this.entries.get(key);
51
+ if (!entry) {
52
+ return null;
53
+ }
54
+ if (entry.expiresAt <= this.now()) {
55
+ this.entries.delete(key);
56
+ return null;
57
+ }
58
+ return entry.value;
59
+ }
60
+ }
61
+ //# sourceMappingURL=cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/scanners/providers/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,uFAAuF;AACvF,MAAM,OAAO,aAAa;IAIK;IAHZ,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACxC,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEhE,YAA6B,MAAoB,IAAI,CAAC,GAAG;QAA5B,QAAG,GAAH,GAAG,CAAyB;IAAG,CAAC;IAE7D;;;OAGG;IACH,KAAK,CAAC,SAAS,CACb,GAAW,EACX,KAAa,EACb,MAAwB;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAI,GAAG,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,gBAA8B,CAAC;QACxC,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YAC1B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC;gBAC7B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;wBACpB,KAAK;wBACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;qBAC9B,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,8CAA8C;IAC9C,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEO,UAAU,CAAI,GAAW;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;CACF"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Provider-side client wrapper for MCP tool calls.
3
+ * Adds retries, timeout, and structured logging with optional debug envelope dumps.
4
+ */
5
+ export type ProviderLogLevel = "error" | "warn" | "info" | "debug";
6
+ /** Minimal logger contract used by providers. */
7
+ export interface ProviderLogger {
8
+ error: (message: string, meta?: Record<string, unknown>) => void;
9
+ warn: (message: string, meta?: Record<string, unknown>) => void;
10
+ info: (message: string, meta?: Record<string, unknown>) => void;
11
+ debug: (message: string, meta?: Record<string, unknown>) => void;
12
+ }
13
+ /** Base tool client expected by scanner providers. */
14
+ export interface SenpiToolClient {
15
+ callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
16
+ }
17
+ /** Optional metadata included in tool-call logs. */
18
+ export interface ToolCallContext {
19
+ address?: string;
20
+ scannerId?: string;
21
+ }
22
+ /** Per-call overrides for retry/timeout behavior. */
23
+ export interface ToolCallOptions extends ToolCallContext {
24
+ retries?: number;
25
+ timeoutMs?: number;
26
+ }
27
+ /** Provider client wrapper options. */
28
+ export interface ProviderClientOptions {
29
+ logger?: ProviderLogger;
30
+ logLevel?: ProviderLogLevel;
31
+ retries?: number;
32
+ timeoutMs?: number;
33
+ redactKeys?: string[];
34
+ }
35
+ /** Provider tool client with instrumentation and guardrails. */
36
+ export interface ProviderToolClient {
37
+ callTool<T = unknown>(name: string, args: Record<string, unknown>, options?: ToolCallOptions): Promise<T>;
38
+ }
39
+ /** Creates a provider client wrapper around a raw MCP tool client. */
40
+ export declare function createProviderClient(client: SenpiToolClient, options?: ProviderClientOptions): ProviderToolClient;
41
+ /** Console-backed provider logger used when no custom logger is supplied. */
42
+ export declare function createConsoleProviderLogger(): ProviderLogger;
43
+ /**
44
+ * Wraps a winston-style logger (`debug/info/warn/error` methods) so providers
45
+ * can use it without importing winston types directly.
46
+ */
47
+ export declare function createWinstonProviderLogger(logger: {
48
+ debug: (message: string, meta?: Record<string, unknown>) => void;
49
+ info: (message: string, meta?: Record<string, unknown>) => void;
50
+ warn: (message: string, meta?: Record<string, unknown>) => void;
51
+ error: (message: string, meta?: Record<string, unknown>) => void;
52
+ }): ProviderLogger;
53
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/scanners/providers/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,qBAA0B,GAClC,kBAAkB,CA0FpB;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,IAAI,cAAc,CAE5D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE,GAAG,cAAc,CAOjB"}
@@ -0,0 +1,174 @@
1
+ /**
2
+ * Provider-side client wrapper for MCP tool calls.
3
+ * Adds retries, timeout, and structured logging with optional debug envelope dumps.
4
+ */
5
+ /** Creates a provider client wrapper around a raw MCP tool client. */
6
+ export function createProviderClient(client, options = {}) {
7
+ const logger = options.logger ?? createConsoleLogger();
8
+ const level = options.logLevel ?? "info";
9
+ const defaultRetries = options.retries ?? 2;
10
+ const defaultTimeoutMs = options.timeoutMs ?? 10_000;
11
+ const redactKeys = new Set(options.redactKeys ?? [
12
+ "authorization",
13
+ "api_key",
14
+ "apikey",
15
+ "password",
16
+ "secret",
17
+ "x-api-key",
18
+ ]);
19
+ return {
20
+ async callTool(name, args, callOptions) {
21
+ const retries = callOptions?.retries ?? defaultRetries;
22
+ const timeoutMs = callOptions?.timeoutMs ?? defaultTimeoutMs;
23
+ let lastError;
24
+ for (let attempt = 1; attempt <= retries + 1; attempt += 1) {
25
+ const startedAt = Date.now();
26
+ try {
27
+ if (shouldLog(level, "debug")) {
28
+ logger.debug("Provider tool call request.", {
29
+ tool: name,
30
+ attempt,
31
+ timeoutMs,
32
+ ...readCallContext(callOptions),
33
+ request: redactValue(args, redactKeys),
34
+ });
35
+ }
36
+ const response = (await withTimeout(client.callTool(name, args), timeoutMs));
37
+ const durationMs = Date.now() - startedAt;
38
+ if (shouldLog(level, "debug")) {
39
+ logger.debug("Provider tool call response.", {
40
+ tool: name,
41
+ attempt,
42
+ durationMs,
43
+ ...readCallContext(callOptions),
44
+ response: redactValue(response, redactKeys),
45
+ });
46
+ }
47
+ else if (shouldLog(level, "info")) {
48
+ logger.info("Provider tool call succeeded.", {
49
+ tool: name,
50
+ attempt,
51
+ durationMs,
52
+ ...readCallContext(callOptions),
53
+ });
54
+ }
55
+ return response;
56
+ }
57
+ catch (error) {
58
+ lastError = error;
59
+ const durationMs = Date.now() - startedAt;
60
+ const meta = {
61
+ tool: name,
62
+ attempt,
63
+ durationMs,
64
+ retriesRemaining: retries + 1 - attempt,
65
+ ...readCallContext(callOptions),
66
+ error: toErrorMessage(error),
67
+ };
68
+ if (attempt <= retries) {
69
+ if (shouldLog(level, "warn")) {
70
+ logger.warn("Provider tool call failed, retrying.", meta);
71
+ }
72
+ continue;
73
+ }
74
+ logger.error("Provider tool call failed.", meta);
75
+ throw error;
76
+ }
77
+ }
78
+ throw new Error(`Provider tool call failed: ${toErrorMessage(lastError)}`);
79
+ },
80
+ };
81
+ }
82
+ /** Console-backed provider logger used when no custom logger is supplied. */
83
+ export function createConsoleProviderLogger() {
84
+ return createConsoleLogger();
85
+ }
86
+ /**
87
+ * Wraps a winston-style logger (`debug/info/warn/error` methods) so providers
88
+ * can use it without importing winston types directly.
89
+ */
90
+ export function createWinstonProviderLogger(logger) {
91
+ return {
92
+ debug: (message, meta) => logger.debug(message, meta),
93
+ info: (message, meta) => logger.info(message, meta),
94
+ warn: (message, meta) => logger.warn(message, meta),
95
+ error: (message, meta) => logger.error(message, meta),
96
+ };
97
+ }
98
+ function createConsoleLogger() {
99
+ return {
100
+ debug: (message, meta) => {
101
+ console.debug(message, meta ?? {});
102
+ },
103
+ info: (message, meta) => {
104
+ console.info(message, meta ?? {});
105
+ },
106
+ warn: (message, meta) => {
107
+ console.warn(message, meta ?? {});
108
+ },
109
+ error: (message, meta) => {
110
+ console.error(message, meta ?? {});
111
+ },
112
+ };
113
+ }
114
+ function shouldLog(current, required) {
115
+ return toPriority(current) >= toPriority(required);
116
+ }
117
+ function toPriority(level) {
118
+ switch (level) {
119
+ case "error":
120
+ return 1;
121
+ case "warn":
122
+ return 2;
123
+ case "info":
124
+ return 3;
125
+ case "debug":
126
+ return 4;
127
+ }
128
+ }
129
+ function readCallContext(options) {
130
+ return {
131
+ address: options?.address,
132
+ scannerId: options?.scannerId,
133
+ };
134
+ }
135
+ function redactValue(value, redactKeys) {
136
+ if (Array.isArray(value)) {
137
+ return value.map((entry) => redactValue(entry, redactKeys));
138
+ }
139
+ if (typeof value !== "object" || value === null) {
140
+ return value;
141
+ }
142
+ const source = value;
143
+ const target = {};
144
+ for (const [key, entry] of Object.entries(source)) {
145
+ const lowered = key.toLowerCase();
146
+ if (redactKeys.has(lowered)) {
147
+ target[key] = "[REDACTED]";
148
+ continue;
149
+ }
150
+ target[key] = redactValue(entry, redactKeys);
151
+ }
152
+ return target;
153
+ }
154
+ async function withTimeout(promise, timeoutMs) {
155
+ if (timeoutMs <= 0) {
156
+ return promise;
157
+ }
158
+ return await Promise.race([
159
+ promise,
160
+ new Promise((_, reject) => {
161
+ const timeout = setTimeout(() => {
162
+ reject(new Error(`Timeout after ${timeoutMs}ms.`));
163
+ }, timeoutMs);
164
+ timeout.unref?.();
165
+ }),
166
+ ]);
167
+ }
168
+ function toErrorMessage(error) {
169
+ if (error instanceof Error) {
170
+ return error.message;
171
+ }
172
+ return String(error);
173
+ }
174
+ //# sourceMappingURL=client.js.map