@senpi-ai/runtime 1.0.97 → 1.0.99

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 (428) hide show
  1. package/README.md +113 -2
  2. package/dist/actions/action-runtime-module.d.ts +55 -0
  3. package/dist/actions/action-runtime-module.d.ts.map +1 -0
  4. package/dist/actions/action-runtime-module.js +491 -0
  5. package/dist/actions/action-runtime-module.js.map +1 -0
  6. package/dist/actions/close-position/close-position.action.d.ts +1 -0
  7. package/dist/actions/close-position/close-position.action.d.ts.map +1 -1
  8. package/dist/actions/close-position/close-position.action.js +93 -25
  9. package/dist/actions/close-position/close-position.action.js.map +1 -1
  10. package/dist/actions/decision-engine.d.ts.map +1 -1
  11. package/dist/actions/decision-engine.js +5 -0
  12. package/dist/actions/decision-engine.js.map +1 -1
  13. package/dist/actions/decision-meta.d.ts +9 -0
  14. package/dist/actions/decision-meta.d.ts.map +1 -0
  15. package/dist/actions/decision-meta.js +18 -0
  16. package/dist/actions/decision-meta.js.map +1 -0
  17. package/dist/actions/llm-decision/openclaw-llm-decision.d.ts.map +1 -1
  18. package/dist/actions/llm-decision/openclaw-llm-decision.js +6 -0
  19. package/dist/actions/llm-decision/openclaw-llm-decision.js.map +1 -1
  20. package/dist/actions/llm-decision/shared.d.ts +1 -1
  21. package/dist/actions/llm-decision/shared.d.ts.map +1 -1
  22. package/dist/actions/llm-decision/shared.js +1 -1
  23. package/dist/actions/llm-decision/shared.js.map +1 -1
  24. package/dist/actions/notifications/formatter.d.ts +39 -0
  25. package/dist/actions/notifications/formatter.d.ts.map +1 -0
  26. package/dist/actions/notifications/formatter.js +68 -0
  27. package/dist/actions/notifications/formatter.js.map +1 -0
  28. package/dist/actions/notifications/index.d.ts +37 -0
  29. package/dist/actions/notifications/index.d.ts.map +1 -0
  30. package/dist/actions/notifications/index.js +89 -0
  31. package/dist/actions/notifications/index.js.map +1 -0
  32. package/dist/actions/open-position/open-position.action.d.ts +1 -0
  33. package/dist/actions/open-position/open-position.action.d.ts.map +1 -1
  34. package/dist/actions/open-position/open-position.action.js +197 -34
  35. package/dist/actions/open-position/open-position.action.js.map +1 -1
  36. package/dist/actions/open-position/resolve-margin.d.ts +30 -0
  37. package/dist/actions/open-position/resolve-margin.d.ts.map +1 -0
  38. package/dist/actions/open-position/resolve-margin.js +41 -0
  39. package/dist/actions/open-position/resolve-margin.js.map +1 -0
  40. package/dist/actions/position-tracker/position-tracker.action.d.ts.map +1 -1
  41. package/dist/actions/position-tracker/position-tracker.action.js +4 -1
  42. package/dist/actions/position-tracker/position-tracker.action.js.map +1 -1
  43. package/dist/actions/store/action-store.d.ts +45 -0
  44. package/dist/actions/store/action-store.d.ts.map +1 -0
  45. package/dist/actions/store/action-store.js +127 -0
  46. package/dist/actions/store/action-store.js.map +1 -0
  47. package/dist/actions/store/index.d.ts +11 -0
  48. package/dist/actions/store/index.d.ts.map +1 -0
  49. package/dist/actions/store/index.js +9 -0
  50. package/dist/actions/store/index.js.map +1 -0
  51. package/dist/actions/store/paths.d.ts +15 -0
  52. package/dist/actions/store/paths.d.ts.map +1 -0
  53. package/dist/actions/store/paths.js +29 -0
  54. package/dist/actions/store/paths.js.map +1 -0
  55. package/dist/actions/store/types.d.ts +126 -0
  56. package/dist/actions/store/types.d.ts.map +1 -0
  57. package/dist/actions/store/types.js +48 -0
  58. package/dist/actions/store/types.js.map +1 -0
  59. package/dist/actions/tracking-helpers.d.ts +13 -0
  60. package/dist/actions/tracking-helpers.d.ts.map +1 -0
  61. package/dist/actions/tracking-helpers.js +47 -0
  62. package/dist/actions/tracking-helpers.js.map +1 -0
  63. package/dist/actions/types.d.ts +8 -0
  64. package/dist/actions/types.d.ts.map +1 -1
  65. package/dist/cli/guide-commands.d.ts.map +1 -1
  66. package/dist/cli/guide-commands.js +106 -4
  67. package/dist/cli/guide-commands.js.map +1 -1
  68. package/dist/cli/senpi-commands.d.ts.map +1 -1
  69. package/dist/cli/senpi-commands.js +447 -1
  70. package/dist/cli/senpi-commands.js.map +1 -1
  71. package/dist/constants/dsl/index.d.ts +12 -0
  72. package/dist/constants/dsl/index.d.ts.map +1 -1
  73. package/dist/constants/dsl/index.js +12 -0
  74. package/dist/constants/dsl/index.js.map +1 -1
  75. package/dist/constants/order-types.d.ts +7 -0
  76. package/dist/constants/order-types.d.ts.map +1 -0
  77. package/dist/constants/order-types.js +6 -0
  78. package/dist/constants/order-types.js.map +1 -0
  79. package/dist/context/interpolate.d.ts +6 -2
  80. package/dist/context/interpolate.d.ts.map +1 -1
  81. package/dist/context/interpolate.js +6 -2
  82. package/dist/context/interpolate.js.map +1 -1
  83. package/dist/context/types.d.ts +8 -1
  84. package/dist/context/types.d.ts.map +1 -1
  85. package/dist/context/types.js +8 -1
  86. package/dist/context/types.js.map +1 -1
  87. package/dist/dsl/config/exit-block.d.ts +7 -0
  88. package/dist/dsl/config/exit-block.d.ts.map +1 -1
  89. package/dist/dsl/config/parse-plugin-config.d.ts.map +1 -1
  90. package/dist/dsl/config/parse-plugin-config.js +27 -1
  91. package/dist/dsl/config/parse-plugin-config.js.map +1 -1
  92. package/dist/dsl/config/unknown-keys.d.ts.map +1 -1
  93. package/dist/dsl/config/unknown-keys.js +3 -1
  94. package/dist/dsl/config/unknown-keys.js.map +1 -1
  95. package/dist/dsl/engine-client/event-mapping.d.ts +21 -1
  96. package/dist/dsl/engine-client/event-mapping.d.ts.map +1 -1
  97. package/dist/dsl/engine-client/event-mapping.js +10 -0
  98. package/dist/dsl/engine-client/event-mapping.js.map +1 -1
  99. package/dist/dsl/engine-client/index.d.ts +1 -1
  100. package/dist/dsl/engine-client/index.d.ts.map +1 -1
  101. package/dist/dsl/events/build-closed-event.d.ts +15 -0
  102. package/dist/dsl/events/build-closed-event.d.ts.map +1 -0
  103. package/dist/dsl/events/build-closed-event.js +31 -0
  104. package/dist/dsl/events/build-closed-event.js.map +1 -0
  105. package/dist/dsl/events/handlers.d.ts +2 -1
  106. package/dist/dsl/events/handlers.d.ts.map +1 -1
  107. package/dist/dsl/events/handlers.js +15 -10
  108. package/dist/dsl/events/handlers.js.map +1 -1
  109. package/dist/dsl/events/initial-state.d.ts +2 -2
  110. package/dist/dsl/events/initial-state.d.ts.map +1 -1
  111. package/dist/dsl/events/initial-state.js +4 -1
  112. package/dist/dsl/events/initial-state.js.map +1 -1
  113. package/dist/dsl/index.js +1 -1
  114. package/dist/dsl/index.js.map +1 -1
  115. package/dist/dsl/monitor/create-monitor.d.ts +4 -0
  116. package/dist/dsl/monitor/create-monitor.d.ts.map +1 -1
  117. package/dist/dsl/monitor/create-monitor.js +8 -5
  118. package/dist/dsl/monitor/create-monitor.js.map +1 -1
  119. package/dist/dsl/monitor/process-one-position.d.ts +4 -0
  120. package/dist/dsl/monitor/process-one-position.d.ts.map +1 -1
  121. package/dist/dsl/monitor/process-one-position.js +129 -40
  122. package/dist/dsl/monitor/process-one-position.js.map +1 -1
  123. package/dist/dsl/notifications/close-resolver.d.ts +92 -0
  124. package/dist/dsl/notifications/close-resolver.d.ts.map +1 -0
  125. package/dist/dsl/notifications/close-resolver.js +309 -0
  126. package/dist/dsl/notifications/close-resolver.js.map +1 -0
  127. package/dist/dsl/notifications/format-utils.d.ts +24 -0
  128. package/dist/dsl/notifications/format-utils.d.ts.map +1 -0
  129. package/dist/dsl/notifications/format-utils.js +102 -0
  130. package/dist/dsl/notifications/format-utils.js.map +1 -0
  131. package/dist/dsl/notifications/formatter.d.ts +23 -4
  132. package/dist/dsl/notifications/formatter.d.ts.map +1 -1
  133. package/dist/dsl/notifications/formatter.js +109 -34
  134. package/dist/dsl/notifications/formatter.js.map +1 -1
  135. package/dist/dsl/notifications/index.d.ts +7 -0
  136. package/dist/dsl/notifications/index.d.ts.map +1 -1
  137. package/dist/dsl/notifications/index.js +22 -10
  138. package/dist/dsl/notifications/index.js.map +1 -1
  139. package/dist/dsl/notifications/types.d.ts +27 -0
  140. package/dist/dsl/notifications/types.d.ts.map +1 -0
  141. package/dist/dsl/notifications/types.js +5 -0
  142. package/dist/dsl/notifications/types.js.map +1 -0
  143. package/dist/dsl/plugin/index.d.ts +1 -1
  144. package/dist/dsl/plugin/index.d.ts.map +1 -1
  145. package/dist/dsl/plugin/index.js +29 -1
  146. package/dist/dsl/plugin/index.js.map +1 -1
  147. package/dist/health/index.d.ts +5 -2
  148. package/dist/health/index.d.ts.map +1 -1
  149. package/dist/health/index.js +106 -6
  150. package/dist/health/index.js.map +1 -1
  151. package/dist/health/types.d.ts +102 -0
  152. package/dist/health/types.d.ts.map +1 -1
  153. package/dist/health/types.js +7 -1
  154. package/dist/health/types.js.map +1 -1
  155. package/dist/index.d.ts +10 -2
  156. package/dist/index.d.ts.map +1 -1
  157. package/dist/index.js +459 -9
  158. package/dist/index.js.map +1 -1
  159. package/dist/risk/guardrail.types.d.ts +58 -0
  160. package/dist/risk/guardrail.types.d.ts.map +1 -0
  161. package/dist/risk/guardrail.types.js +5 -0
  162. package/dist/risk/guardrail.types.js.map +1 -0
  163. package/dist/risk/index.d.ts +2 -4
  164. package/dist/risk/index.d.ts.map +1 -1
  165. package/dist/risk/index.js +2 -6
  166. package/dist/risk/index.js.map +1 -1
  167. package/dist/risk/risk-audit-log.d.ts +25 -0
  168. package/dist/risk/risk-audit-log.d.ts.map +1 -0
  169. package/dist/risk/risk-audit-log.js +30 -0
  170. package/dist/risk/risk-audit-log.js.map +1 -0
  171. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.d.ts +162 -0
  172. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.d.ts.map +1 -0
  173. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.js +285 -0
  174. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.js.map +1 -0
  175. package/dist/runtime/audit-query.types.d.ts +113 -0
  176. package/dist/runtime/audit-query.types.d.ts.map +1 -0
  177. package/dist/runtime/audit-query.types.js +35 -0
  178. package/dist/runtime/audit-query.types.js.map +1 -0
  179. package/dist/runtime/create-actions.d.ts +6 -2
  180. package/dist/runtime/create-actions.d.ts.map +1 -1
  181. package/dist/runtime/create-actions.js +30 -8
  182. package/dist/runtime/create-actions.js.map +1 -1
  183. package/dist/runtime/create-scanner-module.d.ts +5 -0
  184. package/dist/runtime/create-scanner-module.d.ts.map +1 -1
  185. package/dist/runtime/create-scanner-module.js +12 -1
  186. package/dist/runtime/create-scanner-module.js.map +1 -1
  187. package/dist/runtime/load-runtime-config.d.ts +1 -1
  188. package/dist/runtime/load-runtime-config.d.ts.map +1 -1
  189. package/dist/runtime/load-runtime-config.js +37 -1
  190. package/dist/runtime/load-runtime-config.js.map +1 -1
  191. package/dist/runtime/map-exit-config.d.ts +2 -1
  192. package/dist/runtime/map-exit-config.d.ts.map +1 -1
  193. package/dist/runtime/map-exit-config.js +11 -1
  194. package/dist/runtime/map-exit-config.js.map +1 -1
  195. package/dist/runtime/map-strategies.d.ts +1 -1
  196. package/dist/runtime/map-strategies.d.ts.map +1 -1
  197. package/dist/runtime/map-strategies.js +38 -1
  198. package/dist/runtime/map-strategies.js.map +1 -1
  199. package/dist/runtime/notifications.d.ts.map +1 -1
  200. package/dist/runtime/notifications.js +53 -7
  201. package/dist/runtime/notifications.js.map +1 -1
  202. package/dist/runtime/risk-guard.d.ts +26 -2
  203. package/dist/runtime/risk-guard.d.ts.map +1 -1
  204. package/dist/runtime/risk-guard.js +539 -5
  205. package/dist/runtime/risk-guard.js.map +1 -1
  206. package/dist/runtime/run.d.ts +96 -2
  207. package/dist/runtime/run.d.ts.map +1 -1
  208. package/dist/runtime/run.js +21 -0
  209. package/dist/runtime/run.js.map +1 -1
  210. package/dist/runtime/runtime-schema.d.ts +1169 -24
  211. package/dist/runtime/runtime-schema.d.ts.map +1 -1
  212. package/dist/runtime/runtime-schema.js +105 -2
  213. package/dist/runtime/runtime-schema.js.map +1 -1
  214. package/dist/runtime/runtime.d.ts +85 -2
  215. package/dist/runtime/runtime.d.ts.map +1 -1
  216. package/dist/runtime/runtime.js +374 -10
  217. package/dist/runtime/runtime.js.map +1 -1
  218. package/dist/runtime/scanner-composition.d.ts +10 -0
  219. package/dist/runtime/scanner-composition.d.ts.map +1 -1
  220. package/dist/runtime/scanner-composition.js +10 -0
  221. package/dist/runtime/scanner-composition.js.map +1 -1
  222. package/dist/runtime/scanner-registry.d.ts +39 -1
  223. package/dist/runtime/scanner-registry.d.ts.map +1 -1
  224. package/dist/runtime/scanner-registry.js +105 -2
  225. package/dist/runtime/scanner-registry.js.map +1 -1
  226. package/dist/runtime/state-layout.d.ts +2 -0
  227. package/dist/runtime/state-layout.d.ts.map +1 -1
  228. package/dist/runtime/state-layout.js +1 -0
  229. package/dist/runtime/state-layout.js.map +1 -1
  230. package/dist/runtime/validate-action-prompts.d.ts +30 -0
  231. package/dist/runtime/validate-action-prompts.d.ts.map +1 -0
  232. package/dist/runtime/validate-action-prompts.js +110 -0
  233. package/dist/runtime/validate-action-prompts.js.map +1 -0
  234. package/dist/runtime-api/config.d.ts +47 -0
  235. package/dist/runtime-api/config.d.ts.map +1 -0
  236. package/dist/runtime-api/config.js +74 -0
  237. package/dist/runtime-api/config.js.map +1 -0
  238. package/dist/runtime-api/handlers/audit.d.ts +78 -0
  239. package/dist/runtime-api/handlers/audit.d.ts.map +1 -0
  240. package/dist/runtime-api/handlers/audit.js +65 -0
  241. package/dist/runtime-api/handlers/audit.js.map +1 -0
  242. package/dist/runtime-api/handlers/group-by-scanner.d.ts +43 -0
  243. package/dist/runtime-api/handlers/group-by-scanner.d.ts.map +1 -0
  244. package/dist/runtime-api/handlers/group-by-scanner.js +43 -0
  245. package/dist/runtime-api/handlers/group-by-scanner.js.map +1 -0
  246. package/dist/runtime-api/handlers/ingest-signals.d.ts +54 -0
  247. package/dist/runtime-api/handlers/ingest-signals.d.ts.map +1 -0
  248. package/dist/runtime-api/handlers/ingest-signals.js +124 -0
  249. package/dist/runtime-api/handlers/ingest-signals.js.map +1 -0
  250. package/dist/runtime-api/handlers/runtime-lookup.d.ts +36 -0
  251. package/dist/runtime-api/handlers/runtime-lookup.d.ts.map +1 -0
  252. package/dist/runtime-api/handlers/runtime-lookup.js +31 -0
  253. package/dist/runtime-api/handlers/runtime-lookup.js.map +1 -0
  254. package/dist/runtime-api/handlers/types.d.ts +85 -0
  255. package/dist/runtime-api/handlers/types.d.ts.map +1 -0
  256. package/dist/runtime-api/handlers/types.js +8 -0
  257. package/dist/runtime-api/handlers/types.js.map +1 -0
  258. package/dist/runtime-api/lifecycle.d.ts +98 -0
  259. package/dist/runtime-api/lifecycle.d.ts.map +1 -0
  260. package/dist/runtime-api/lifecycle.js +137 -0
  261. package/dist/runtime-api/lifecycle.js.map +1 -0
  262. package/dist/runtime-api/readiness.d.ts +37 -0
  263. package/dist/runtime-api/readiness.d.ts.map +1 -0
  264. package/dist/runtime-api/readiness.js +35 -0
  265. package/dist/runtime-api/readiness.js.map +1 -0
  266. package/dist/runtime-api/routes/audit.d.ts +40 -0
  267. package/dist/runtime-api/routes/audit.d.ts.map +1 -0
  268. package/dist/runtime-api/routes/audit.js +90 -0
  269. package/dist/runtime-api/routes/audit.js.map +1 -0
  270. package/dist/runtime-api/routes/audit.schema.d.ts +75 -0
  271. package/dist/runtime-api/routes/audit.schema.d.ts.map +1 -0
  272. package/dist/runtime-api/routes/audit.schema.js +78 -0
  273. package/dist/runtime-api/routes/audit.schema.js.map +1 -0
  274. package/dist/runtime-api/routes/health.d.ts +53 -0
  275. package/dist/runtime-api/routes/health.d.ts.map +1 -0
  276. package/dist/runtime-api/routes/health.js +48 -0
  277. package/dist/runtime-api/routes/health.js.map +1 -0
  278. package/dist/runtime-api/routes/signals.d.ts +50 -0
  279. package/dist/runtime-api/routes/signals.d.ts.map +1 -0
  280. package/dist/runtime-api/routes/signals.js +90 -0
  281. package/dist/runtime-api/routes/signals.js.map +1 -0
  282. package/dist/runtime-api/routes/signals.schema.d.ts +94 -0
  283. package/dist/runtime-api/routes/signals.schema.d.ts.map +1 -0
  284. package/dist/runtime-api/routes/signals.schema.js +58 -0
  285. package/dist/runtime-api/routes/signals.schema.js.map +1 -0
  286. package/dist/runtime-api/routes/state.d.ts +51 -0
  287. package/dist/runtime-api/routes/state.d.ts.map +1 -0
  288. package/dist/runtime-api/routes/state.js +94 -0
  289. package/dist/runtime-api/routes/state.js.map +1 -0
  290. package/dist/runtime-api/server.d.ts +79 -0
  291. package/dist/runtime-api/server.d.ts.map +1 -0
  292. package/dist/runtime-api/server.js +114 -0
  293. package/dist/runtime-api/server.js.map +1 -0
  294. package/dist/scanners/__tests__/test-helpers.d.ts +10 -0
  295. package/dist/scanners/__tests__/test-helpers.d.ts.map +1 -1
  296. package/dist/scanners/__tests__/test-helpers.js +52 -0
  297. package/dist/scanners/__tests__/test-helpers.js.map +1 -1
  298. package/dist/scanners/engine/engine.d.ts +37 -0
  299. package/dist/scanners/engine/engine.d.ts.map +1 -1
  300. package/dist/scanners/engine/engine.js +132 -14
  301. package/dist/scanners/engine/engine.js.map +1 -1
  302. package/dist/scanners/engine/result-builder.d.ts +16 -0
  303. package/dist/scanners/engine/result-builder.d.ts.map +1 -1
  304. package/dist/scanners/engine/result-builder.js +22 -0
  305. package/dist/scanners/engine/result-builder.js.map +1 -1
  306. package/dist/scanners/engine/strategy-registry.d.ts +2 -0
  307. package/dist/scanners/engine/strategy-registry.d.ts.map +1 -1
  308. package/dist/scanners/engine/strategy-registry.js +5 -1
  309. package/dist/scanners/engine/strategy-registry.js.map +1 -1
  310. package/dist/scanners/external/liquidation-watchdog/README.md +107 -0
  311. package/dist/scanners/external/liquidation-watchdog/liquidation-watchdog.yaml +48 -0
  312. package/dist/scanners/external/liquidation-watchdog/producer.mjs +336 -0
  313. package/dist/scanners/external/momentum/README.md +148 -0
  314. package/dist/scanners/external/momentum/momentum.yaml +116 -0
  315. package/dist/scanners/external/momentum/producer.mjs +251 -0
  316. package/dist/scanners/external/shared/ingest.mjs +112 -0
  317. package/dist/scanners/external-scanner-receiver.d.ts +118 -0
  318. package/dist/scanners/external-scanner-receiver.d.ts.map +1 -0
  319. package/dist/scanners/external-scanner-receiver.js +266 -0
  320. package/dist/scanners/external-scanner-receiver.js.map +1 -0
  321. package/dist/scanners/implementations/external-scanner.d.ts +17 -0
  322. package/dist/scanners/implementations/external-scanner.d.ts.map +1 -0
  323. package/dist/scanners/implementations/external-scanner.js +51 -0
  324. package/dist/scanners/implementations/external-scanner.js.map +1 -0
  325. package/dist/scanners/implementations/index.d.ts +1 -0
  326. package/dist/scanners/implementations/index.d.ts.map +1 -1
  327. package/dist/scanners/implementations/index.js +1 -0
  328. package/dist/scanners/implementations/index.js.map +1 -1
  329. package/dist/scanners/implementations/position-tracker.d.ts.map +1 -1
  330. package/dist/scanners/implementations/position-tracker.js +3 -1
  331. package/dist/scanners/implementations/position-tracker.js.map +1 -1
  332. package/dist/scanners/index.d.ts +4 -1
  333. package/dist/scanners/index.d.ts.map +1 -1
  334. package/dist/scanners/index.js +2 -0
  335. package/dist/scanners/index.js.map +1 -1
  336. package/dist/scanners/protocol/scanner.d.ts +3 -1
  337. package/dist/scanners/protocol/scanner.d.ts.map +1 -1
  338. package/dist/scanners/providers/client.d.ts.map +1 -1
  339. package/dist/scanners/providers/client.js +0 -8
  340. package/dist/scanners/providers/client.js.map +1 -1
  341. package/dist/scanners/runtime-module.d.ts +10 -0
  342. package/dist/scanners/runtime-module.d.ts.map +1 -1
  343. package/dist/scanners/runtime-module.js +19 -3
  344. package/dist/scanners/runtime-module.js.map +1 -1
  345. package/dist/scanners/scanner-definition.d.ts +12 -1
  346. package/dist/scanners/scanner-definition.d.ts.map +1 -1
  347. package/dist/scanners/schema-utils.d.ts +22 -2
  348. package/dist/scanners/schema-utils.d.ts.map +1 -1
  349. package/dist/scanners/schema-utils.js +14 -2
  350. package/dist/scanners/schema-utils.js.map +1 -1
  351. package/dist/scanners/types.d.ts +3 -0
  352. package/dist/scanners/types.d.ts.map +1 -1
  353. package/dist/scanners/types.js.map +1 -1
  354. package/dist/scripts/run-dsl-standalone-live.js +2 -2
  355. package/dist/scripts/run-dsl-standalone-live.js.map +1 -1
  356. package/dist/scripts/run-dsl-standalone-mock.js +2 -2
  357. package/dist/scripts/run-dsl-standalone-mock.js.map +1 -1
  358. package/dist/senpi/client.d.ts +123 -4
  359. package/dist/senpi/client.d.ts.map +1 -1
  360. package/dist/senpi/client.js +304 -15
  361. package/dist/senpi/client.js.map +1 -1
  362. package/dist/senpi/index.d.ts +1 -1
  363. package/dist/senpi/index.d.ts.map +1 -1
  364. package/dist/senpi/types.d.ts +70 -0
  365. package/dist/senpi/types.d.ts.map +1 -1
  366. package/dist/state/state-manager.d.ts +3 -0
  367. package/dist/state/state-manager.d.ts.map +1 -1
  368. package/dist/state/state-manager.js +9 -0
  369. package/dist/state/state-manager.js.map +1 -1
  370. package/dist/strategy/strategy-state.d.ts +4 -1
  371. package/dist/strategy/strategy-state.d.ts.map +1 -1
  372. package/dist/strategy/strategy-state.js +7 -2
  373. package/dist/strategy/strategy-state.js.map +1 -1
  374. package/dist/tracking/constants.d.ts +24 -0
  375. package/dist/tracking/constants.d.ts.map +1 -0
  376. package/dist/tracking/constants.js +50 -0
  377. package/dist/tracking/constants.js.map +1 -0
  378. package/dist/tracking/index.d.ts +13 -0
  379. package/dist/tracking/index.d.ts.map +1 -0
  380. package/dist/tracking/index.js +9 -0
  381. package/dist/tracking/index.js.map +1 -0
  382. package/dist/tracking/plugin-event-tracker.d.ts +13 -0
  383. package/dist/tracking/plugin-event-tracker.d.ts.map +1 -0
  384. package/dist/tracking/plugin-event-tracker.js +27 -0
  385. package/dist/tracking/plugin-event-tracker.js.map +1 -0
  386. package/dist/tracking/tracker.d.ts +30 -0
  387. package/dist/tracking/tracker.d.ts.map +1 -0
  388. package/dist/tracking/tracker.js +66 -0
  389. package/dist/tracking/tracker.js.map +1 -0
  390. package/dist/tracking/tracking-handler.d.ts +12 -0
  391. package/dist/tracking/tracking-handler.d.ts.map +1 -0
  392. package/dist/tracking/tracking-handler.js +148 -0
  393. package/dist/tracking/tracking-handler.js.map +1 -0
  394. package/dist/tracking/transport.d.ts +35 -0
  395. package/dist/tracking/transport.d.ts.map +1 -0
  396. package/dist/tracking/transport.js +133 -0
  397. package/dist/tracking/transport.js.map +1 -0
  398. package/dist/tracking/types.d.ts +21 -0
  399. package/dist/tracking/types.d.ts.map +1 -0
  400. package/dist/tracking/types.js +6 -0
  401. package/dist/tracking/types.js.map +1 -0
  402. package/dist/types/action.d.ts +13 -2
  403. package/dist/types/action.d.ts.map +1 -1
  404. package/dist/types/dsl/index.d.ts +72 -3
  405. package/dist/types/dsl/index.d.ts.map +1 -1
  406. package/dist/types/strategy.d.ts +11 -3
  407. package/dist/types/strategy.d.ts.map +1 -1
  408. package/dist/utils/logger.d.ts +6 -1
  409. package/dist/utils/logger.d.ts.map +1 -1
  410. package/dist/utils/logger.js +35 -2
  411. package/dist/utils/logger.js.map +1 -1
  412. package/dist/utils/resolve-order-type.d.ts +5 -0
  413. package/dist/utils/resolve-order-type.d.ts.map +1 -0
  414. package/dist/utils/resolve-order-type.js +29 -0
  415. package/dist/utils/resolve-order-type.js.map +1 -0
  416. package/examples/strategies/dsl-showcase.yaml +7 -2
  417. package/examples/strategies/dsl.yaml +5 -1
  418. package/examples/strategies/fox-minimal-loosened.yaml +18 -3
  419. package/examples/strategies/fox-minimal.yaml +25 -3
  420. package/examples/strategies/minimal.yaml +4 -2
  421. package/examples/strategies/momentum/how-it-works.md +48 -0
  422. package/examples/strategies/momentum/momentum-guarded.yaml +161 -0
  423. package/examples/strategies/risk-showcase.yaml +93 -0
  424. package/examples/strategies/viper.yaml +11 -3
  425. package/examples/strategies/wolf.yaml +11 -3
  426. package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +12 -4
  427. package/openclaw.plugin.json +35 -1
  428. package/package.json +12 -7
@@ -0,0 +1,285 @@
1
+ import { mkdtempSync, rmSync } from "node:fs";
2
+ import { tmpdir } from "node:os";
3
+ import { join } from "node:path";
4
+ import { expect, vi } from "vitest";
5
+ import { SharedArtifactStore } from "../../../scanners/store/shared-artifact-store.js";
6
+ import { loadRuntimeConfig } from "../../load-runtime-config.js";
7
+ import { Runtime } from "../../runtime.js";
8
+ /**
9
+ * Default MCP transport used by runtime integration tests that do not care
10
+ * about real tool behavior.
11
+ *
12
+ * The runtime expects `list_open_positions` to resolve cleanly even when no
13
+ * positions exist, so the helper returns an empty list there and a generic
14
+ * success envelope elsewhere.
15
+ */
16
+ export async function noopTransport(method, _params) {
17
+ if (method === "list_open_positions") {
18
+ return [];
19
+ }
20
+ return { success: true, results: [] };
21
+ }
22
+ /**
23
+ * Creates a dedicated temporary runtime state directory for one test.
24
+ *
25
+ * The caller supplies the prefix so failures remain easy to attribute from temp
26
+ * paths and filesystem inspection.
27
+ */
28
+ export function createRuntimeStateDir(prefix) {
29
+ return mkdtempSync(join(tmpdir(), prefix));
30
+ }
31
+ /**
32
+ * Captures OpenClaw gateway requests while returning a deterministic no-op
33
+ * decision response.
34
+ *
35
+ * This helper keeps the real action layer, prompt interpolation, and context
36
+ * building in play without making network calls or depending on gateway
37
+ * availability.
38
+ */
39
+ export class GatewayCapture {
40
+ calls = [];
41
+ originalGatewayToken = process.env.OPENCLAW_GATEWAY_TOKEN;
42
+ reasoning;
43
+ actionType;
44
+ fetchMock;
45
+ constructor(options = {}) {
46
+ this.reasoning = options.reasoning ?? "test-harness";
47
+ this.actionType = options.actionType ?? "OPEN_POSITION";
48
+ this.fetchMock = vi.fn(async (_url, init) => {
49
+ const request = parseGatewayInvokeRequest(init?.body);
50
+ this.calls.push(request);
51
+ return {
52
+ ok: true,
53
+ status: 200,
54
+ json: async () => ({
55
+ ok: true,
56
+ result: {
57
+ json: {
58
+ execute: false,
59
+ confidence: 4,
60
+ reasoning: this.reasoning,
61
+ actionType: this.actionType,
62
+ payload: {},
63
+ },
64
+ usage: {
65
+ inputTokens: 0,
66
+ outputTokens: 0,
67
+ },
68
+ },
69
+ }),
70
+ text: async () => JSON.stringify({ ok: true }),
71
+ };
72
+ });
73
+ }
74
+ /**
75
+ * Installs the fetch stub and a deterministic gateway token expected by the
76
+ * real action-layer client.
77
+ */
78
+ install() {
79
+ process.env.OPENCLAW_GATEWAY_TOKEN = "test-token";
80
+ vi.stubGlobal("fetch", this.fetchMock);
81
+ }
82
+ /**
83
+ * Restores the original fetch global and gateway token after a test.
84
+ *
85
+ * Restoring the env var matters because some runtime tests explicitly verify
86
+ * behavior when the token is absent.
87
+ */
88
+ restore() {
89
+ vi.unstubAllGlobals();
90
+ if (this.originalGatewayToken !== undefined) {
91
+ process.env.OPENCLAW_GATEWAY_TOKEN = this.originalGatewayToken;
92
+ return;
93
+ }
94
+ delete process.env.OPENCLAW_GATEWAY_TOKEN;
95
+ }
96
+ /**
97
+ * Waits until the expected number of gateway calls has been captured.
98
+ *
99
+ * The runtime routes actions through an async serial consumer, so tests must
100
+ * poll briefly instead of assuming the request exists immediately after a
101
+ * scanner run or ingest call resolves.
102
+ */
103
+ async waitForCallCount(expectedCount) {
104
+ const deadline = Date.now() + 1_000;
105
+ while (Date.now() < deadline) {
106
+ if (this.calls.length >= expectedCount) {
107
+ return;
108
+ }
109
+ await sleep(10);
110
+ }
111
+ throw new Error(`Timed out waiting for ${expectedCount} gateway call(s); saw ${this.calls.length}.`);
112
+ }
113
+ /**
114
+ * Asserts that no gateway requests were emitted after a short stabilization
115
+ * window.
116
+ *
117
+ * This guards tests that expect dependency failures or skips to prevent any
118
+ * downstream LLM routing.
119
+ */
120
+ async expectNoCalls() {
121
+ await sleep(100);
122
+ expect(this.calls).toHaveLength(0);
123
+ }
124
+ }
125
+ /**
126
+ * Shared integration harness for runtime tests that need real scanner-module
127
+ * behavior plus captured action-layer gateway requests.
128
+ *
129
+ * The harness centralizes the repetitive bootstrap/teardown logic so scenario
130
+ * tests can stay focused on their domain-specific setup and assertions.
131
+ */
132
+ export class RuntimeGatewayHarness {
133
+ options;
134
+ runtime = null;
135
+ address = null;
136
+ gateway;
137
+ mcpTransport;
138
+ constructor(options) {
139
+ this.options = options;
140
+ this.gateway = new GatewayCapture({
141
+ reasoning: options.gatewayReasoning,
142
+ actionType: options.gatewayActionType,
143
+ });
144
+ this.mcpTransport = options.mcpTransport ?? noopTransport;
145
+ }
146
+ /** Installs the gateway capture so the real action path can run offline. */
147
+ installGatewayCapture() {
148
+ this.gateway.install();
149
+ }
150
+ /**
151
+ * Starts the runtime from an inline YAML recipe string and resolves the
152
+ * strategy address once boot completes.
153
+ */
154
+ async start(recipeYaml) {
155
+ const config = await loadRuntimeConfig(recipeYaml, { fromPath: false });
156
+ this.runtime = new Runtime(config, {
157
+ stateDir: this.options.stateDir,
158
+ mcpTransport: this.mcpTransport,
159
+ });
160
+ await this.runtime.start();
161
+ this.address = resolveStrategyAddress(this.runtime);
162
+ }
163
+ /**
164
+ * Stops the runtime, restores gateway globals, and removes the temporary
165
+ * state directory.
166
+ */
167
+ async dispose() {
168
+ if (this.runtime) {
169
+ await this.runtime.stop();
170
+ this.runtime = null;
171
+ }
172
+ this.address = null;
173
+ this.gateway.restore();
174
+ vi.restoreAllMocks();
175
+ try {
176
+ rmSync(this.options.stateDir, { recursive: true, force: true });
177
+ }
178
+ catch {
179
+ // ignore temp-dir cleanup failures so test assertions surface first
180
+ }
181
+ }
182
+ /** Runs one configured scanner through the real scanner module. */
183
+ async runScanner(scannerId) {
184
+ return this.scannerModule.runOnce(this.requireAddress(), scannerId);
185
+ }
186
+ /** Runs one scanner plus its dependency chain through the real scanner module. */
187
+ async runScannerChain(scannerId) {
188
+ return this.scannerModule.runChain(this.requireAddress(), scannerId);
189
+ }
190
+ /** Reads retained scanner context for the active runtime strategy. */
191
+ async readScannerContext(scannerId) {
192
+ return this.scannerModule.getScannerContext(this.requireAddress(), scannerId);
193
+ }
194
+ /** Queries persisted latest signals for the active runtime strategy. */
195
+ async querySignals(scannerId) {
196
+ return this.scannerModule.querySignals({
197
+ address: this.requireAddress(),
198
+ scannerId,
199
+ });
200
+ }
201
+ /** Forwards one external ingest request through the real runtime surface. */
202
+ async ingestExternalScannerData(request) {
203
+ return this.requireRuntime().ingestExternalScannerData(request);
204
+ }
205
+ /**
206
+ * Returns the most recent captured gateway request after waiting for the
207
+ * action queue to emit it.
208
+ */
209
+ async waitForGatewayRequest() {
210
+ await this.gateway.waitForCallCount(1);
211
+ const request = this.gateway.calls.at(-1);
212
+ if (!request) {
213
+ throw new Error("Expected a captured gateway request, but none was recorded.");
214
+ }
215
+ return request;
216
+ }
217
+ /** Asserts that the runtime did not emit any gateway requests. */
218
+ async expectNoGatewayRequests() {
219
+ await this.gateway.expectNoCalls();
220
+ }
221
+ /**
222
+ * Seeds one retained-context envelope directly into the shared-artifact store.
223
+ *
224
+ * This is intentionally test-only: it lets dependency-focused scenarios start
225
+ * from an already-published context snapshot without forcing an upstream
226
+ * scanner run first.
227
+ */
228
+ async seedRetainedContext(options) {
229
+ const store = new SharedArtifactStore(this.options.stateDir);
230
+ await store.saveEnvelopeByScanner(options.address, options.scannerId, {
231
+ updatedAt: options.updatedAt,
232
+ data: options.value,
233
+ }, {
234
+ contract: options.contract,
235
+ });
236
+ }
237
+ /** Returns the active strategy address once the runtime has started. */
238
+ getAddress() {
239
+ return this.requireAddress();
240
+ }
241
+ get scannerModule() {
242
+ const runtime = this.requireRuntime();
243
+ return runtime.scannerModule;
244
+ }
245
+ requireRuntime() {
246
+ if (!this.runtime) {
247
+ throw new Error("Runtime has not been started for this test harness.");
248
+ }
249
+ return this.runtime;
250
+ }
251
+ requireAddress() {
252
+ if (!this.address) {
253
+ throw new Error("Runtime strategy address is not available before start().");
254
+ }
255
+ return this.address;
256
+ }
257
+ }
258
+ /**
259
+ * Reads the strategy wallet address from the real runtime internals after
260
+ * start-up validation has finished.
261
+ */
262
+ function resolveStrategyAddress(runtime) {
263
+ const address = runtime.strategyConfig.address;
264
+ if (typeof address !== "string" || address.length === 0) {
265
+ throw new Error("Expected runtime to expose a non-empty strategy address.");
266
+ }
267
+ return address;
268
+ }
269
+ /**
270
+ * Parses the JSON request body sent by the OpenClaw client.
271
+ *
272
+ * Failing fast on non-string bodies protects the helper against silent drift in
273
+ * the gateway client contract.
274
+ */
275
+ function parseGatewayInvokeRequest(body) {
276
+ if (typeof body !== "string") {
277
+ throw new Error("Expected OpenClaw fetch body to be a JSON string.");
278
+ }
279
+ return JSON.parse(body);
280
+ }
281
+ /** Small async sleep helper used by polling assertions. */
282
+ function sleep(ms) {
283
+ return new Promise((resolve) => setTimeout(resolve, ms));
284
+ }
285
+ //# sourceMappingURL=runtime-gateway-harness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-gateway-harness.js","sourceRoot":"","sources":["../../../../src/runtime/__tests__/helpers/runtime-gateway-harness.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,113 @@
1
+ /**
2
+ * Type definitions for the `RuntimeHandle.auditQuery` public method.
3
+ *
4
+ * These mirror the MCP `audit_query` tool contract (defined in
5
+ * senpi-hyperliquid-mcp/src/tools/audit.tools.ts) but expressed as plain
6
+ * TypeScript interfaces — Zod stays inside MCP, TypeBox stays inside
7
+ * runtime-api. Anything new added to the MCP zod schema must be reflected
8
+ * here as well.
9
+ *
10
+ * The implementation owns four MCP arguments and silently overrides any
11
+ * caller-supplied values — these are intentionally absent from
12
+ * {@link AuditQueryArgs}:
13
+ * - `resource_type` (always `"strategy"`)
14
+ * - `resource_id` (resolved wallet → strategyId)
15
+ * - `user_ids` (server-controlled — the MCP API key user)
16
+ * - `usernames` (server-controlled — same)
17
+ */
18
+ /**
19
+ * Caller-controlled subset of MCP `audit_query` parameters.
20
+ *
21
+ * Every field is optional. Field names match the MCP schema verbatim so
22
+ * pass-through to the underlying tool stays drift-free.
23
+ *
24
+ * @see senpi-hyperliquid-mcp/src/tools/audit.tools.ts (`auditQueryInputSchema`)
25
+ */
26
+ export interface AuditQueryArgs {
27
+ /** Filter by exact tool name (e.g. `create_position`). */
28
+ tool_name?: string;
29
+ /** Filter by action classification. */
30
+ action_type?: "read" | "create" | "update" | "delete";
31
+ /** Filter by success/failure. */
32
+ success?: boolean;
33
+ /** ISO 8601 inclusive lower bound on `requested_at`. */
34
+ start_time?: string;
35
+ /** ISO 8601 inclusive upper bound on `requested_at`. */
36
+ end_time?: string;
37
+ /** Minimum end-to-end duration in ms (find slow operations). */
38
+ min_duration_ms?: number;
39
+ /** Maximum end-to-end duration in ms (find fast operations). */
40
+ max_duration_ms?: number;
41
+ /** Page size; MCP defaults to 100, max 1000. */
42
+ limit?: number;
43
+ /** Offset-based pagination skip count; MCP default 0. */
44
+ offset?: number;
45
+ /** Cursor timestamp for keyset pagination (must pair with `cursor_id`). */
46
+ cursor_requested_at?: string;
47
+ /** Cursor id (UUID) for keyset pagination (must pair with `cursor_requested_at`). */
48
+ cursor_id?: string;
49
+ }
50
+ /**
51
+ * Single audit-log entry as returned by MCP `audit_query`.
52
+ *
53
+ * @see senpi-hyperliquid-mcp/src/tools/audit.tools.ts (JSDoc on `handleAuditQuery`)
54
+ */
55
+ export interface AuditEntry {
56
+ /** Unique audit-entry identifier. */
57
+ id: string;
58
+ /** Request identifier; correlates to MCP request id. */
59
+ request_id: string;
60
+ /** When the tool was invoked (ISO 8601). */
61
+ timestamp: string;
62
+ /** When execution finished (ISO 8601); may be absent on in-flight or partial entries. */
63
+ completed_at: string | null;
64
+ /** End-to-end execution time in milliseconds, including downstream latency. */
65
+ duration_ms: number | null;
66
+ /** Authenticated Senpi user id who performed the action. */
67
+ user_id: string;
68
+ /** Exact tool name invoked. */
69
+ tool: string;
70
+ /** Action classification. */
71
+ action_type: "read" | "create" | "update" | "delete";
72
+ /** AI-generated reasoning string; null for read tools. */
73
+ ai_reasoning: string | null;
74
+ /** Boolean indicating successful completion. */
75
+ success: boolean;
76
+ /** Error code when `success === false`. */
77
+ error_code: string | null;
78
+ /** Failure details when `success === false`. */
79
+ error_message: string | null;
80
+ /** Resources touched by the action (each `{ type, id }`). */
81
+ affected_resources: Array<{
82
+ type: string;
83
+ id: string;
84
+ }>;
85
+ }
86
+ /**
87
+ * Pass-through MCP `audit_query` response payload (the `.data` portion of
88
+ * the MCP envelope, after `unwrapEnvelope` strips `success`/`meta`).
89
+ */
90
+ export interface AuditQueryResult {
91
+ /** Audit entries on the current page. */
92
+ entries: AuditEntry[];
93
+ /** Number of entries on the current page. */
94
+ count: number;
95
+ /** Approximate total matching entries (exact for small sets). */
96
+ total: number;
97
+ /** Whether further results exist beyond the current page. */
98
+ has_more: boolean;
99
+ }
100
+ /**
101
+ * Discriminated error class thrown by {@link RuntimeHandle.auditQuery}.
102
+ *
103
+ * Codes:
104
+ * - `NOT_FOUND` — `listStrategies` returned 0 matches for the runtime's
105
+ * wallet (the wallet does not belong to the API-key user).
106
+ * - `UPSTREAM` — MCP returned an error (network, auth, schema).
107
+ * - `ABORTED` — caller aborted via `opts.signal` before MCP responded.
108
+ */
109
+ export declare class AuditQueryError extends Error {
110
+ readonly code: "NOT_FOUND" | "UPSTREAM" | "ABORTED";
111
+ constructor(code: "NOT_FOUND" | "UPSTREAM" | "ABORTED", message: string);
112
+ }
113
+ //# sourceMappingURL=audit-query.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit-query.types.d.ts","sourceRoot":"","sources":["../../src/runtime/audit-query.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtD,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrD,0DAA0D;IAC1D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gDAAgD;IAChD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6DAA6D;IAC7D,kBAAkB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;gBAE/C,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM;CAKxE"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Type definitions for the `RuntimeHandle.auditQuery` public method.
3
+ *
4
+ * These mirror the MCP `audit_query` tool contract (defined in
5
+ * senpi-hyperliquid-mcp/src/tools/audit.tools.ts) but expressed as plain
6
+ * TypeScript interfaces — Zod stays inside MCP, TypeBox stays inside
7
+ * runtime-api. Anything new added to the MCP zod schema must be reflected
8
+ * here as well.
9
+ *
10
+ * The implementation owns four MCP arguments and silently overrides any
11
+ * caller-supplied values — these are intentionally absent from
12
+ * {@link AuditQueryArgs}:
13
+ * - `resource_type` (always `"strategy"`)
14
+ * - `resource_id` (resolved wallet → strategyId)
15
+ * - `user_ids` (server-controlled — the MCP API key user)
16
+ * - `usernames` (server-controlled — same)
17
+ */
18
+ /**
19
+ * Discriminated error class thrown by {@link RuntimeHandle.auditQuery}.
20
+ *
21
+ * Codes:
22
+ * - `NOT_FOUND` — `listStrategies` returned 0 matches for the runtime's
23
+ * wallet (the wallet does not belong to the API-key user).
24
+ * - `UPSTREAM` — MCP returned an error (network, auth, schema).
25
+ * - `ABORTED` — caller aborted via `opts.signal` before MCP responded.
26
+ */
27
+ export class AuditQueryError extends Error {
28
+ code;
29
+ constructor(code, message) {
30
+ super(message);
31
+ this.name = "AuditQueryError";
32
+ this.code = code;
33
+ }
34
+ }
35
+ //# sourceMappingURL=audit-query.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit-query.types.js","sourceRoot":"","sources":["../../src/runtime/audit-query.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAoFH;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxB,IAAI,CAAuC;IAE3D,YAAY,IAA0C,EAAE,OAAe;QACrE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}
@@ -1,7 +1,8 @@
1
1
  /**
2
2
  * Instantiate actions from skills config and expose runActionsForSignal for serial processing.
3
3
  */
4
- import type { Action, HookEvent } from "../actions/types.js";
4
+ import type { Action, ActionConfig, HookEvent } from "../actions/types.js";
5
+ import type { ActionRuntimeModule } from "../actions/action-runtime-module.js";
5
6
  import type { SenpiEventBus } from "../types/event-bus.js";
6
7
  import type { RuntimeContext } from "../types/runtime.js";
7
8
  import type { RuntimeConfig } from "./runtime-config.js";
@@ -10,11 +11,14 @@ export interface CreateActionsOptions extends Omit<CreateActionContextDeps, "str
10
11
  bus: SenpiEventBus;
11
12
  /** When provided, this context is reused for all actions (built once per trading recipe by the runtime). */
12
13
  runtimeContext?: RuntimeContext;
14
+ /** When set, wraps each action invocation with telemetry and persistence. */
15
+ actionModule?: ActionRuntimeModule;
13
16
  }
14
17
  export interface ActionWithMeta {
15
18
  action: Action;
16
19
  name: string;
17
20
  eventsConsumed: string[];
21
+ config: ActionConfig;
18
22
  }
19
23
  export interface CreateActionsResult {
20
24
  actions: ActionWithMeta[];
@@ -26,5 +30,5 @@ export interface CreateActionsResult {
26
30
  * and runActionsForSignal so the runtime can process signals serially (one at a time) to avoid slot races.
27
31
  * When options.runtimeContext is provided (e.g. by Runtime), it is reused for all action factories.
28
32
  */
29
- export declare function createActions(config: RuntimeConfig, options: CreateActionsOptions): CreateActionsResult;
33
+ export declare function createActions(config: RuntimeConfig, options: CreateActionsOptions): Promise<CreateActionsResult>;
30
34
  //# sourceMappingURL=create-actions.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"create-actions.d.ts","sourceRoot":"","sources":["../../src/runtime/create-actions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAgB,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAK1E,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,uBAAuB,EAAE,UAAU,GAAG,UAAU,CAAC;IAClG,GAAG,EAAE,aAAa,CAAC;IACnB,4GAA4G;IAC5G,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,mBAAmB,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAyDvG"}
1
+ {"version":3,"file":"create-actions.d.ts","sourceRoot":"","sources":["../../src/runtime/create-actions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAc,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAK1E,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,uBAAuB,EAAE,UAAU,GAAG,UAAU,CAAC;IAClG,GAAG,EAAE,aAAa,CAAC;IACnB,4GAA4G;IAC5G,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,mBAAmB,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwFtH"}
@@ -12,7 +12,7 @@ import { MaxLeverageCache } from "../leverage/max-leverage-cache.js";
12
12
  * and runActionsForSignal so the runtime can process signals serially (one at a time) to avoid slot races.
13
13
  * When options.runtimeContext is provided (e.g. by Runtime), it is reused for all action factories.
14
14
  */
15
- export function createActions(config, options) {
15
+ export async function createActions(config, options) {
16
16
  const context = options.runtimeContext ??
17
17
  createRuntimeContext(resolveStrategyConfig(config), {
18
18
  senpi: options.senpi,
@@ -25,12 +25,14 @@ export function createActions(config, options) {
25
25
  });
26
26
  const actions = [];
27
27
  const actionList = config.actions ?? [];
28
+ const strategyAddress = resolveStrategyConfig(config).address;
29
+ const actionModule = options.actionModule;
28
30
  for (const entry of actionList) {
29
31
  const factory = ActionRegistry.get(entry.action_type);
30
32
  if (!factory) {
31
33
  throw new Error(`Unknown action_type: ${entry.action_type}`);
32
34
  }
33
- const config = {
35
+ const actionConfig = {
34
36
  name: entry.name,
35
37
  action_type: entry.action_type,
36
38
  decision_mode: entry.decision_mode ?? "none",
@@ -41,27 +43,47 @@ export function createActions(config, options) {
41
43
  decision_prompt: entry.decision_prompt,
42
44
  params: entry.params,
43
45
  };
44
- const action = factory(config, context);
46
+ const action = factory(actionConfig, context);
47
+ if (actionModule) {
48
+ await actionModule.registerAction(strategyAddress, entry.name, actionConfig);
49
+ }
45
50
  const actionWithManifest = action;
46
51
  const manifest = actionWithManifest?.manifest?.eventsConsumed ?? [HOOK_EVENT.ON_SIGNAL_DETECTED];
47
52
  actions.push({
48
53
  action,
49
54
  name: entry.name,
50
55
  eventsConsumed: manifest,
56
+ config: actionConfig,
51
57
  });
52
58
  }
53
59
  function runActionsForSignal(event) {
54
60
  const scanPayload = event?.data;
55
61
  const scannerId = scanPayload?.scanResult?.scannerId;
62
+ const address = event.address;
63
+ console.info("[senpi-runtime] [ingest-trace] runActionsForSignal entry", JSON.stringify({
64
+ address,
65
+ scannerId,
66
+ registeredActions: actions.map((a) => ({
67
+ name: a.name,
68
+ scannersFilter: a.config.scanners ?? null,
69
+ })),
70
+ }));
56
71
  const promises = [];
57
- for (const { action } of actions) {
58
- const cfg = action.config;
59
- const scanners = cfg?.scanners;
72
+ for (const { action, name, config: cfg } of actions) {
73
+ const scanners = cfg.scanners;
60
74
  if (Array.isArray(scanners) && scanners.length > 0) {
61
- if (scannerId == null || !scanners.includes(scannerId))
75
+ if (scannerId == null || !scanners.includes(scannerId)) {
76
+ console.info("[senpi-runtime] [ingest-trace] runActionsForSignal SKIP (scanner mismatch)", JSON.stringify({ action: name, requiredScanners: scanners, signalScannerId: scannerId }));
62
77
  continue;
78
+ }
79
+ }
80
+ console.info("[senpi-runtime] [ingest-trace] runActionsForSignal FIRE", JSON.stringify({ action: name, scannerId, address }));
81
+ if (actionModule) {
82
+ promises.push(actionModule.wrapHandle(address, action, cfg, event));
83
+ }
84
+ else {
85
+ promises.push(Promise.resolve(action.handle(event)));
63
86
  }
64
- promises.push(Promise.resolve(action.handle(event)));
65
87
  }
66
88
  return Promise.all(promises).then(() => undefined);
67
89
  }
@@ -1 +1 @@
1
- {"version":3,"file":"create-actions.js","sourceRoot":"","sources":["../../src/runtime/create-actions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAmBrE;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB,EAAE,OAA6B;IAChF,MAAM,OAAO,GACX,OAAO,CAAC,cAAc;QACtB,oBAAoB,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE;YAClD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,gBAAgB,EAAE,IAAI,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC;SACtD,CAAC,CAAC;IACL,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,WAAiD,CAAC,CAAC;QAC5F,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,MAAM,GAAiB;YAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,aAAa,EAAG,KAAK,CAAC,aAA+C,IAAI,MAAM;YAC/E,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,kBAAkB,GAAG,MAAgE,CAAC;QAC5F,MAAM,QAAQ,GAAG,kBAAkB,EAAE,QAAQ,EAAE,cAAc,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QACjG,OAAO,CAAC,IAAI,CAAC;YACX,MAAM;YACN,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,cAAc,EAAE,QAAQ;SACzB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,mBAAmB,CAAC,KAAgB;QAC3C,MAAM,WAAW,GAAG,KAAK,EAAE,IAA2D,CAAC;QACvF,MAAM,SAAS,GAAG,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC;QACrD,MAAM,QAAQ,GAAuB,EAAE,CAAC;QACxC,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,GAAG,GAAI,MAA+C,CAAC,MAAM,CAAC;YACpE,MAAM,QAAQ,GAAG,GAAG,EAAE,QAAQ,CAAC;YAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnD,IAAI,SAAS,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;oBAAE,SAAS;YACnE,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC1C,CAAC"}
1
+ {"version":3,"file":"create-actions.js","sourceRoot":"","sources":["../../src/runtime/create-actions.ts"],"names":[],"mappings":"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"}
@@ -9,6 +9,11 @@ import type { RuntimeConfig } from "./runtime-config.js";
9
9
  * Builds the standalone scanner runtime module from parsed trading recipe config.
10
10
  * Scanner registrations are normalized into factories so YAML-level ids and
11
11
  * optional config overrides become strategy-scoped scanner instances.
12
+ *
13
+ * External scanners feed the same composition builder as built-in scanners.
14
+ * Their declared `outputs` metadata and synthesized retained-context contract
15
+ * are what make external context producers available to `depends_on` and
16
+ * action-context validation.
12
17
  */
13
18
  export declare function createScannerModuleFromRuntimeConfig(config: RuntimeConfig, stateDir: string, providers?: ScannerDataProviders, logger?: ScannerLogger): ReturnType<typeof createScannerRuntimeModule>;
14
19
  //# sourceMappingURL=create-scanner-module.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"create-scanner-module.d.ts","sourceRoot":"","sources":["../../src/runtime/create-scanner-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,oBAAoB,EAChC,MAAM,CAAC,EAAE,aAAa,GACrB,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAsB/C"}
1
+ {"version":3,"file":"create-scanner-module.d.ts","sourceRoot":"","sources":["../../src/runtime/create-scanner-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,oBAAoB,EAChC,MAAM,CAAC,EAAE,aAAa,GACrB,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAkC/C"}
@@ -10,12 +10,23 @@ import { buildScannerComposition } from "./scanner-composition.js";
10
10
  * Builds the standalone scanner runtime module from parsed trading recipe config.
11
11
  * Scanner registrations are normalized into factories so YAML-level ids and
12
12
  * optional config overrides become strategy-scoped scanner instances.
13
+ *
14
+ * External scanners feed the same composition builder as built-in scanners.
15
+ * Their declared `outputs` metadata and synthesized retained-context contract
16
+ * are what make external context producers available to `depends_on` and
17
+ * action-context validation.
13
18
  */
14
19
  export function createScannerModuleFromRuntimeConfig(config, stateDir, providers, logger) {
15
20
  const strategy = resolveStrategyRegistration(config);
16
21
  const scanners = [];
17
22
  for (const sc of config.scanners ?? []) {
18
- scanners.push(ScannerRegistry.createScanner(sc.type, sc.name, sc.config, sc.depends_on));
23
+ scanners.push(ScannerRegistry.createScanner(sc.type, sc.name, sc.config, sc.depends_on, sc.type === "external_scanner"
24
+ ? {
25
+ outputs: sc.outputs,
26
+ retention: sc.retention,
27
+ retentionMaxRuns: sc.retention_max_runs,
28
+ }
29
+ : undefined));
19
30
  }
20
31
  const preparedScanners = prepareScannerInputs(scanners);
21
32
  const composition = buildScannerComposition(config, preparedScanners.map((scanner) => scanner.definition), logger);
@@ -1 +1 @@
1
- {"version":3,"file":"create-scanner-module.js","sourceRoot":"","sources":["../../src/runtime/create-scanner-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,UAAU,oCAAoC,CAClD,MAAqB,EACrB,QAAgB,EAChB,SAAgC,EAChC,MAAsB;IAEtB,MAAM,QAAQ,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CACX,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,CAC1E,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,uBAAuB,CACzC,MAAM,EACN,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EACrD,MAAM,CACP,CAAC;IACF,OAAO,0BAA0B,CAAC;QAChC,QAAQ;QACR,QAAQ;QACR,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QAC5D,WAAW;QACX,SAAS;QACT,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}
1
+ {"version":3,"file":"create-scanner-module.js","sourceRoot":"","sources":["../../src/runtime/create-scanner-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;;;;GASG;AACH,MAAM,UAAU,oCAAoC,CAClD,MAAqB,EACrB,QAAgB,EAChB,SAAgC,EAChC,MAAsB;IAEtB,MAAM,QAAQ,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CACX,eAAe,CAAC,aAAa,CAC3B,EAAE,CAAC,IAAI,EACP,EAAE,CAAC,IAAI,EACP,EAAE,CAAC,MAAM,EACT,EAAE,CAAC,UAAU,EACb,EAAE,CAAC,IAAI,KAAK,kBAAkB;YAC5B,CAAC,CAAC;gBACE,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,gBAAgB,EAAE,EAAE,CAAC,kBAAkB;aACxC;YACH,CAAC,CAAC,SAAS,CACd,CACF,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,uBAAuB,CACzC,MAAM,EACN,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EACrD,MAAM,CACP,CAAC;IACF,OAAO,0BAA0B,CAAC;QAChC,QAAQ;QACR,QAAQ;QACR,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QAC5D,WAAW;QACX,SAAS;QACT,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}
@@ -11,7 +11,7 @@ export interface LoadRuntimeConfigOptions {
11
11
  * Minimal valid YAML structure shown in validation errors so users can fix their file.
12
12
  * Keep this in sync with runtimeConfigSchema (name + strategy with wallet).
13
13
  */
14
- export declare const MINIMAL_RECIPE_YAML_SAMPLE = "# Required: name and a strategy with a wallet\nname: my-recipe\n# version: 1 # optional; defaults to current (1). Supports integer or semver string.\nstrategy:\n wallet: \"your-wallet-address\"\n # optional: budget, slots, enabled, etc.\n\n# Optional: scanners, actions, exit. Run: openclaw senpi guide examples\n";
14
+ export declare const MINIMAL_RECIPE_YAML_SAMPLE = "# Required: name and a strategy with a wallet\nname: my-recipe\n# version: 1 # optional; defaults to current (1). Supports integer or semver string.\nstrategy:\n wallet: \"your-wallet-address\"\n # optional: slots, margin_pct, margin_per_slot, enabled, etc.\n\n# Optional: scanners, actions, exit. Run: openclaw senpi guide examples\n";
15
15
  /**
16
16
  * Load trading recipe from a file path or YAML string.
17
17
  * - If fromPath is true, pathOrContent is a file path.