@senpi-ai/runtime 1.0.96 → 1.0.98

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 (436) 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 -8
  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/auto-update/coordinator.d.ts +12 -8
  180. package/dist/runtime/auto-update/coordinator.d.ts.map +1 -1
  181. package/dist/runtime/auto-update/coordinator.js +18 -17
  182. package/dist/runtime/auto-update/coordinator.js.map +1 -1
  183. package/dist/runtime/auto-update/gateway-restart.d.ts +9 -2
  184. package/dist/runtime/auto-update/gateway-restart.d.ts.map +1 -1
  185. package/dist/runtime/auto-update/gateway-restart.js +23 -13
  186. package/dist/runtime/auto-update/gateway-restart.js.map +1 -1
  187. package/dist/runtime/create-actions.d.ts +6 -2
  188. package/dist/runtime/create-actions.d.ts.map +1 -1
  189. package/dist/runtime/create-actions.js +30 -8
  190. package/dist/runtime/create-actions.js.map +1 -1
  191. package/dist/runtime/create-scanner-module.d.ts +5 -0
  192. package/dist/runtime/create-scanner-module.d.ts.map +1 -1
  193. package/dist/runtime/create-scanner-module.js +12 -1
  194. package/dist/runtime/create-scanner-module.js.map +1 -1
  195. package/dist/runtime/load-runtime-config.d.ts +1 -1
  196. package/dist/runtime/load-runtime-config.d.ts.map +1 -1
  197. package/dist/runtime/load-runtime-config.js +37 -1
  198. package/dist/runtime/load-runtime-config.js.map +1 -1
  199. package/dist/runtime/map-exit-config.d.ts +2 -1
  200. package/dist/runtime/map-exit-config.d.ts.map +1 -1
  201. package/dist/runtime/map-exit-config.js +11 -1
  202. package/dist/runtime/map-exit-config.js.map +1 -1
  203. package/dist/runtime/map-strategies.d.ts +1 -1
  204. package/dist/runtime/map-strategies.d.ts.map +1 -1
  205. package/dist/runtime/map-strategies.js +38 -1
  206. package/dist/runtime/map-strategies.js.map +1 -1
  207. package/dist/runtime/notifications.d.ts.map +1 -1
  208. package/dist/runtime/notifications.js +53 -7
  209. package/dist/runtime/notifications.js.map +1 -1
  210. package/dist/runtime/risk-guard.d.ts +26 -2
  211. package/dist/runtime/risk-guard.d.ts.map +1 -1
  212. package/dist/runtime/risk-guard.js +539 -5
  213. package/dist/runtime/risk-guard.js.map +1 -1
  214. package/dist/runtime/run.d.ts +96 -2
  215. package/dist/runtime/run.d.ts.map +1 -1
  216. package/dist/runtime/run.js +21 -0
  217. package/dist/runtime/run.js.map +1 -1
  218. package/dist/runtime/runtime-schema.d.ts +1169 -24
  219. package/dist/runtime/runtime-schema.d.ts.map +1 -1
  220. package/dist/runtime/runtime-schema.js +105 -2
  221. package/dist/runtime/runtime-schema.js.map +1 -1
  222. package/dist/runtime/runtime.d.ts +85 -2
  223. package/dist/runtime/runtime.d.ts.map +1 -1
  224. package/dist/runtime/runtime.js +374 -10
  225. package/dist/runtime/runtime.js.map +1 -1
  226. package/dist/runtime/scanner-composition.d.ts +10 -0
  227. package/dist/runtime/scanner-composition.d.ts.map +1 -1
  228. package/dist/runtime/scanner-composition.js +10 -0
  229. package/dist/runtime/scanner-composition.js.map +1 -1
  230. package/dist/runtime/scanner-registry.d.ts +39 -1
  231. package/dist/runtime/scanner-registry.d.ts.map +1 -1
  232. package/dist/runtime/scanner-registry.js +105 -2
  233. package/dist/runtime/scanner-registry.js.map +1 -1
  234. package/dist/runtime/state-layout.d.ts +2 -0
  235. package/dist/runtime/state-layout.d.ts.map +1 -1
  236. package/dist/runtime/state-layout.js +1 -0
  237. package/dist/runtime/state-layout.js.map +1 -1
  238. package/dist/runtime/validate-action-prompts.d.ts +30 -0
  239. package/dist/runtime/validate-action-prompts.d.ts.map +1 -0
  240. package/dist/runtime/validate-action-prompts.js +110 -0
  241. package/dist/runtime/validate-action-prompts.js.map +1 -0
  242. package/dist/runtime-api/config.d.ts +47 -0
  243. package/dist/runtime-api/config.d.ts.map +1 -0
  244. package/dist/runtime-api/config.js +74 -0
  245. package/dist/runtime-api/config.js.map +1 -0
  246. package/dist/runtime-api/handlers/audit.d.ts +78 -0
  247. package/dist/runtime-api/handlers/audit.d.ts.map +1 -0
  248. package/dist/runtime-api/handlers/audit.js +65 -0
  249. package/dist/runtime-api/handlers/audit.js.map +1 -0
  250. package/dist/runtime-api/handlers/group-by-scanner.d.ts +43 -0
  251. package/dist/runtime-api/handlers/group-by-scanner.d.ts.map +1 -0
  252. package/dist/runtime-api/handlers/group-by-scanner.js +43 -0
  253. package/dist/runtime-api/handlers/group-by-scanner.js.map +1 -0
  254. package/dist/runtime-api/handlers/ingest-signals.d.ts +54 -0
  255. package/dist/runtime-api/handlers/ingest-signals.d.ts.map +1 -0
  256. package/dist/runtime-api/handlers/ingest-signals.js +124 -0
  257. package/dist/runtime-api/handlers/ingest-signals.js.map +1 -0
  258. package/dist/runtime-api/handlers/runtime-lookup.d.ts +36 -0
  259. package/dist/runtime-api/handlers/runtime-lookup.d.ts.map +1 -0
  260. package/dist/runtime-api/handlers/runtime-lookup.js +31 -0
  261. package/dist/runtime-api/handlers/runtime-lookup.js.map +1 -0
  262. package/dist/runtime-api/handlers/types.d.ts +85 -0
  263. package/dist/runtime-api/handlers/types.d.ts.map +1 -0
  264. package/dist/runtime-api/handlers/types.js +8 -0
  265. package/dist/runtime-api/handlers/types.js.map +1 -0
  266. package/dist/runtime-api/lifecycle.d.ts +98 -0
  267. package/dist/runtime-api/lifecycle.d.ts.map +1 -0
  268. package/dist/runtime-api/lifecycle.js +137 -0
  269. package/dist/runtime-api/lifecycle.js.map +1 -0
  270. package/dist/runtime-api/readiness.d.ts +37 -0
  271. package/dist/runtime-api/readiness.d.ts.map +1 -0
  272. package/dist/runtime-api/readiness.js +35 -0
  273. package/dist/runtime-api/readiness.js.map +1 -0
  274. package/dist/runtime-api/routes/audit.d.ts +40 -0
  275. package/dist/runtime-api/routes/audit.d.ts.map +1 -0
  276. package/dist/runtime-api/routes/audit.js +90 -0
  277. package/dist/runtime-api/routes/audit.js.map +1 -0
  278. package/dist/runtime-api/routes/audit.schema.d.ts +75 -0
  279. package/dist/runtime-api/routes/audit.schema.d.ts.map +1 -0
  280. package/dist/runtime-api/routes/audit.schema.js +78 -0
  281. package/dist/runtime-api/routes/audit.schema.js.map +1 -0
  282. package/dist/runtime-api/routes/health.d.ts +53 -0
  283. package/dist/runtime-api/routes/health.d.ts.map +1 -0
  284. package/dist/runtime-api/routes/health.js +48 -0
  285. package/dist/runtime-api/routes/health.js.map +1 -0
  286. package/dist/runtime-api/routes/signals.d.ts +50 -0
  287. package/dist/runtime-api/routes/signals.d.ts.map +1 -0
  288. package/dist/runtime-api/routes/signals.js +90 -0
  289. package/dist/runtime-api/routes/signals.js.map +1 -0
  290. package/dist/runtime-api/routes/signals.schema.d.ts +94 -0
  291. package/dist/runtime-api/routes/signals.schema.d.ts.map +1 -0
  292. package/dist/runtime-api/routes/signals.schema.js +58 -0
  293. package/dist/runtime-api/routes/signals.schema.js.map +1 -0
  294. package/dist/runtime-api/routes/state.d.ts +51 -0
  295. package/dist/runtime-api/routes/state.d.ts.map +1 -0
  296. package/dist/runtime-api/routes/state.js +94 -0
  297. package/dist/runtime-api/routes/state.js.map +1 -0
  298. package/dist/runtime-api/server.d.ts +79 -0
  299. package/dist/runtime-api/server.d.ts.map +1 -0
  300. package/dist/runtime-api/server.js +114 -0
  301. package/dist/runtime-api/server.js.map +1 -0
  302. package/dist/scanners/__tests__/test-helpers.d.ts +10 -0
  303. package/dist/scanners/__tests__/test-helpers.d.ts.map +1 -1
  304. package/dist/scanners/__tests__/test-helpers.js +52 -0
  305. package/dist/scanners/__tests__/test-helpers.js.map +1 -1
  306. package/dist/scanners/engine/engine.d.ts +37 -0
  307. package/dist/scanners/engine/engine.d.ts.map +1 -1
  308. package/dist/scanners/engine/engine.js +132 -14
  309. package/dist/scanners/engine/engine.js.map +1 -1
  310. package/dist/scanners/engine/result-builder.d.ts +16 -0
  311. package/dist/scanners/engine/result-builder.d.ts.map +1 -1
  312. package/dist/scanners/engine/result-builder.js +22 -0
  313. package/dist/scanners/engine/result-builder.js.map +1 -1
  314. package/dist/scanners/engine/strategy-registry.d.ts +2 -0
  315. package/dist/scanners/engine/strategy-registry.d.ts.map +1 -1
  316. package/dist/scanners/engine/strategy-registry.js +5 -1
  317. package/dist/scanners/engine/strategy-registry.js.map +1 -1
  318. package/dist/scanners/external/liquidation-watchdog/README.md +107 -0
  319. package/dist/scanners/external/liquidation-watchdog/liquidation-watchdog.yaml +48 -0
  320. package/dist/scanners/external/liquidation-watchdog/producer.mjs +336 -0
  321. package/dist/scanners/external/momentum/README.md +148 -0
  322. package/dist/scanners/external/momentum/momentum.yaml +116 -0
  323. package/dist/scanners/external/momentum/producer.mjs +251 -0
  324. package/dist/scanners/external/shared/ingest.mjs +112 -0
  325. package/dist/scanners/external-scanner-receiver.d.ts +118 -0
  326. package/dist/scanners/external-scanner-receiver.d.ts.map +1 -0
  327. package/dist/scanners/external-scanner-receiver.js +266 -0
  328. package/dist/scanners/external-scanner-receiver.js.map +1 -0
  329. package/dist/scanners/implementations/external-scanner.d.ts +17 -0
  330. package/dist/scanners/implementations/external-scanner.d.ts.map +1 -0
  331. package/dist/scanners/implementations/external-scanner.js +51 -0
  332. package/dist/scanners/implementations/external-scanner.js.map +1 -0
  333. package/dist/scanners/implementations/index.d.ts +1 -0
  334. package/dist/scanners/implementations/index.d.ts.map +1 -1
  335. package/dist/scanners/implementations/index.js +1 -0
  336. package/dist/scanners/implementations/index.js.map +1 -1
  337. package/dist/scanners/implementations/position-tracker.d.ts.map +1 -1
  338. package/dist/scanners/implementations/position-tracker.js +3 -1
  339. package/dist/scanners/implementations/position-tracker.js.map +1 -1
  340. package/dist/scanners/index.d.ts +4 -1
  341. package/dist/scanners/index.d.ts.map +1 -1
  342. package/dist/scanners/index.js +2 -0
  343. package/dist/scanners/index.js.map +1 -1
  344. package/dist/scanners/protocol/scanner.d.ts +3 -1
  345. package/dist/scanners/protocol/scanner.d.ts.map +1 -1
  346. package/dist/scanners/providers/client.d.ts.map +1 -1
  347. package/dist/scanners/providers/client.js +0 -8
  348. package/dist/scanners/providers/client.js.map +1 -1
  349. package/dist/scanners/runtime-module.d.ts +10 -0
  350. package/dist/scanners/runtime-module.d.ts.map +1 -1
  351. package/dist/scanners/runtime-module.js +19 -3
  352. package/dist/scanners/runtime-module.js.map +1 -1
  353. package/dist/scanners/scanner-definition.d.ts +12 -1
  354. package/dist/scanners/scanner-definition.d.ts.map +1 -1
  355. package/dist/scanners/schema-utils.d.ts +22 -2
  356. package/dist/scanners/schema-utils.d.ts.map +1 -1
  357. package/dist/scanners/schema-utils.js +14 -2
  358. package/dist/scanners/schema-utils.js.map +1 -1
  359. package/dist/scanners/types.d.ts +3 -0
  360. package/dist/scanners/types.d.ts.map +1 -1
  361. package/dist/scanners/types.js.map +1 -1
  362. package/dist/scripts/run-dsl-standalone-live.js +2 -2
  363. package/dist/scripts/run-dsl-standalone-live.js.map +1 -1
  364. package/dist/scripts/run-dsl-standalone-mock.js +2 -2
  365. package/dist/scripts/run-dsl-standalone-mock.js.map +1 -1
  366. package/dist/senpi/client.d.ts +123 -4
  367. package/dist/senpi/client.d.ts.map +1 -1
  368. package/dist/senpi/client.js +304 -15
  369. package/dist/senpi/client.js.map +1 -1
  370. package/dist/senpi/index.d.ts +1 -1
  371. package/dist/senpi/index.d.ts.map +1 -1
  372. package/dist/senpi/types.d.ts +70 -0
  373. package/dist/senpi/types.d.ts.map +1 -1
  374. package/dist/state/state-manager.d.ts +3 -0
  375. package/dist/state/state-manager.d.ts.map +1 -1
  376. package/dist/state/state-manager.js +9 -0
  377. package/dist/state/state-manager.js.map +1 -1
  378. package/dist/strategy/strategy-state.d.ts +4 -1
  379. package/dist/strategy/strategy-state.d.ts.map +1 -1
  380. package/dist/strategy/strategy-state.js +7 -2
  381. package/dist/strategy/strategy-state.js.map +1 -1
  382. package/dist/tracking/constants.d.ts +24 -0
  383. package/dist/tracking/constants.d.ts.map +1 -0
  384. package/dist/tracking/constants.js +50 -0
  385. package/dist/tracking/constants.js.map +1 -0
  386. package/dist/tracking/index.d.ts +13 -0
  387. package/dist/tracking/index.d.ts.map +1 -0
  388. package/dist/tracking/index.js +9 -0
  389. package/dist/tracking/index.js.map +1 -0
  390. package/dist/tracking/plugin-event-tracker.d.ts +13 -0
  391. package/dist/tracking/plugin-event-tracker.d.ts.map +1 -0
  392. package/dist/tracking/plugin-event-tracker.js +27 -0
  393. package/dist/tracking/plugin-event-tracker.js.map +1 -0
  394. package/dist/tracking/tracker.d.ts +30 -0
  395. package/dist/tracking/tracker.d.ts.map +1 -0
  396. package/dist/tracking/tracker.js +66 -0
  397. package/dist/tracking/tracker.js.map +1 -0
  398. package/dist/tracking/tracking-handler.d.ts +12 -0
  399. package/dist/tracking/tracking-handler.d.ts.map +1 -0
  400. package/dist/tracking/tracking-handler.js +148 -0
  401. package/dist/tracking/tracking-handler.js.map +1 -0
  402. package/dist/tracking/transport.d.ts +35 -0
  403. package/dist/tracking/transport.d.ts.map +1 -0
  404. package/dist/tracking/transport.js +133 -0
  405. package/dist/tracking/transport.js.map +1 -0
  406. package/dist/tracking/types.d.ts +21 -0
  407. package/dist/tracking/types.d.ts.map +1 -0
  408. package/dist/tracking/types.js +6 -0
  409. package/dist/tracking/types.js.map +1 -0
  410. package/dist/types/action.d.ts +13 -2
  411. package/dist/types/action.d.ts.map +1 -1
  412. package/dist/types/dsl/index.d.ts +72 -3
  413. package/dist/types/dsl/index.d.ts.map +1 -1
  414. package/dist/types/strategy.d.ts +11 -3
  415. package/dist/types/strategy.d.ts.map +1 -1
  416. package/dist/utils/logger.d.ts +6 -1
  417. package/dist/utils/logger.d.ts.map +1 -1
  418. package/dist/utils/logger.js +35 -2
  419. package/dist/utils/logger.js.map +1 -1
  420. package/dist/utils/resolve-order-type.d.ts +5 -0
  421. package/dist/utils/resolve-order-type.d.ts.map +1 -0
  422. package/dist/utils/resolve-order-type.js +29 -0
  423. package/dist/utils/resolve-order-type.js.map +1 -0
  424. package/examples/strategies/dsl-showcase.yaml +7 -2
  425. package/examples/strategies/dsl.yaml +5 -1
  426. package/examples/strategies/fox-minimal-loosened.yaml +18 -3
  427. package/examples/strategies/fox-minimal.yaml +25 -3
  428. package/examples/strategies/minimal.yaml +4 -2
  429. package/examples/strategies/momentum/how-it-works.md +48 -0
  430. package/examples/strategies/momentum/momentum-guarded.yaml +161 -0
  431. package/examples/strategies/risk-showcase.yaml +93 -0
  432. package/examples/strategies/viper.yaml +11 -3
  433. package/examples/strategies/wolf.yaml +11 -3
  434. package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +12 -4
  435. package/openclaw.plugin.json +35 -1
  436. package/package.json +12 -7
@@ -0,0 +1 @@
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/tracking/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,uCAAuC,CAAC;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAE3D,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AASnC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAyC;IACjE,qBAAqB;IACrB,kBAAkB,EAAE,EAAE,SAAS,EAAE,0BAA0B,EAAE,QAAQ,EAAE,UAAU,EAAE;IACnF,uBAAuB,EAAE,EAAE,SAAS,EAAE,+BAA+B,EAAE,QAAQ,EAAE,UAAU,EAAE;IAC7F,kBAAkB,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE;IAC1E,kBAAkB,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE;IAC1E,mBAAmB,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,UAAU,EAAE;IAC5E,qBAAqB,EAAE,EAAE,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE;IAChF,qBAAqB,EAAE,EAAE,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE;IAEhF,MAAM;IACN,aAAa,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC5D,mBAAmB,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACxE,mBAAmB,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACxE,gBAAgB,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAClE,YAAY,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1D,mBAAmB,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACxE,aAAa,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;IAE5D,QAAQ;IACR,uBAAuB,EAAE,EAAE,SAAS,EAAE,yBAAyB,EAAE,QAAQ,EAAE,OAAO,EAAE;IAEpF,4CAA4C;IAC5C,0BAA0B,EAAE,EAAE,SAAS,EAAE,2BAA2B,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7F,0BAA0B,EAAE,EAAE,SAAS,EAAE,2BAA2B,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7F,wDAAwD;IACxD,0BAA0B,EAAE,EAAE,SAAS,EAAE,2BAA2B,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7F,+DAA+D;IAC/D,0BAA0B,EAAE,EAAE,SAAS,EAAE,2BAA2B,EAAE,QAAQ,EAAE,WAAW,EAAE;IAE7F,0CAA0C;IAC1C,sBAAsB,EAAE,EAAE,SAAS,EAAE,sBAAsB,EAAE,QAAQ,EAAE,SAAS,EAAE;CACnF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAC/D,MAAM,CAAC,MAAM,gCAAgC,GAAG,wBAAwB,CAAC"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Event tracking barrel export.
3
+ */
4
+ export type { TrackingEvent, TrackingTransport } from "./types.js";
5
+ export { EventTracker } from "./tracker.js";
6
+ export type { CaptureOptions } from "./tracker.js";
7
+ export { BatchingTransport, NoOpTransport } from "./transport.js";
8
+ export type { BatchingTransportOptions } from "./transport.js";
9
+ export { createTrackingHandler } from "./tracking-handler.js";
10
+ export type { TrackingHandler } from "./tracking-handler.js";
11
+ export { TRACKING_API_BASE_URL } from "./constants.js";
12
+ export { createPluginEventTracker, PLUGIN_TRACKING_RUNTIME_NAME, } from "./plugin-event-tracker.js";
13
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracking/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Event tracking barrel export.
3
+ */
4
+ export { EventTracker } from "./tracker.js";
5
+ export { BatchingTransport, NoOpTransport } from "./transport.js";
6
+ export { createTrackingHandler } from "./tracking-handler.js";
7
+ export { TRACKING_API_BASE_URL } from "./constants.js";
8
+ export { createPluginEventTracker, PLUGIN_TRACKING_RUNTIME_NAME, } from "./plugin-event-tracker.js";
9
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracking/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * EventTracker for OpenClaw plugin–scoped lifecycle telemetry (install/delete).
3
+ * Uses the same transport contract as `Runtime` per-runtime tracking.
4
+ */
5
+ import { EventTracker } from "./tracker.js";
6
+ /** Display name for envelopes when events are not tied to a single recipe instance. */
7
+ export declare const PLUGIN_TRACKING_RUNTIME_NAME = "senpi-plugin";
8
+ /**
9
+ * Tracker for `lifecycle.runtime.created` / `lifecycle.runtime.deleted`.
10
+ * Strategy wallet must be passed per capture via `address` when known.
11
+ */
12
+ export declare function createPluginEventTracker(apiKey: string | undefined): EventTracker;
13
+ //# sourceMappingURL=plugin-event-tracker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-event-tracker.d.ts","sourceRoot":"","sources":["../../src/tracking/plugin-event-tracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAK5C,uFAAuF;AACvF,eAAO,MAAM,4BAA4B,iBAAiB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAWjF"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * EventTracker for OpenClaw plugin–scoped lifecycle telemetry (install/delete).
3
+ * Uses the same transport contract as `Runtime` per-runtime tracking.
4
+ */
5
+ import { VERSION } from "../version.js";
6
+ import { createLogger } from "../utils/logger.js";
7
+ import { TRACKING_API_BASE_URL } from "./constants.js";
8
+ import { EventTracker } from "./tracker.js";
9
+ import { BatchingTransport, NoOpTransport } from "./transport.js";
10
+ const logger = createLogger("[senpi-core][plugin-tracking]");
11
+ /** Display name for envelopes when events are not tied to a single recipe instance. */
12
+ export const PLUGIN_TRACKING_RUNTIME_NAME = "senpi-plugin";
13
+ /**
14
+ * Tracker for `lifecycle.runtime.created` / `lifecycle.runtime.deleted`.
15
+ * Strategy wallet must be passed per capture via `address` when known.
16
+ */
17
+ export function createPluginEventTracker(apiKey) {
18
+ const trackingBaseUrl = process.env.SENPI_TRACKING_URL ?? TRACKING_API_BASE_URL;
19
+ const transport = apiKey
20
+ ? new BatchingTransport({ baseUrl: trackingBaseUrl, apiKey })
21
+ : (() => {
22
+ logger.warn("plugin lifecycle telemetry disabled: set SENPI_API_KEY (or pass apiKey) so events reach senpi-agent-telemetry; NoOpTransport drops events");
23
+ return new NoOpTransport();
24
+ })();
25
+ return new EventTracker(transport, PLUGIN_TRACKING_RUNTIME_NAME, VERSION, "");
26
+ }
27
+ //# sourceMappingURL=plugin-event-tracker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-event-tracker.js","sourceRoot":"","sources":["../../src/tracking/plugin-event-tracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAElE,MAAM,MAAM,GAAG,YAAY,CAAC,+BAA+B,CAAC,CAAC;AAE7D,uFAAuF;AACvF,MAAM,CAAC,MAAM,4BAA4B,GAAG,cAAc,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAA0B;IACjE,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,qBAAqB,CAAC;IAChF,MAAM,SAAS,GAAG,MAAM;QACtB,CAAC,CAAC,IAAI,iBAAiB,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;QAC7D,CAAC,CAAC,CAAC,GAAG,EAAE;YACJ,MAAM,CAAC,IAAI,CACT,2IAA2I,CAC5I,CAAC;YACF,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,IAAI,YAAY,CAAC,SAAS,EAAE,4BAA4B,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * EventTracker: synchronous capture interface.
3
+ * Builds a `TrackingEvent` envelope and enqueues it on the transport.
4
+ * Never throws — all errors are caught and logged.
5
+ *
6
+ * **Ingest contract:** `senpi-agent-telemetry` requires `correlationId` to be UUID v4
7
+ * (see `validateEventBatch`). Bus payloads may use opaque `__correlationId` strings;
8
+ * those are replaced here so batches are not rejected with HTTP 400.
9
+ */
10
+ import type { TrackingTransport } from "./types.js";
11
+ export interface CaptureOptions {
12
+ eventType: string;
13
+ category: string;
14
+ address: string;
15
+ /**
16
+ * From the bus (`__correlationId`); v4 values are sent as-is, otherwise a new v4 is used.
17
+ */
18
+ correlationId?: string | null;
19
+ data: Record<string, unknown>;
20
+ }
21
+ export declare class EventTracker {
22
+ private readonly transport;
23
+ private readonly runtimeName;
24
+ private readonly runtimeVersion;
25
+ private readonly strategyWallet;
26
+ constructor(transport: TrackingTransport, runtimeName: string, runtimeVersion: string, strategyWallet: string);
27
+ capture(options: CaptureOptions): void;
28
+ shutdown(): Promise<void>;
29
+ }
30
+ //# sourceMappingURL=tracker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/tracking/tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAsBnE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAHd,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM;IAGzC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAyBhC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}
@@ -0,0 +1,66 @@
1
+ /**
2
+ * EventTracker: synchronous capture interface.
3
+ * Builds a `TrackingEvent` envelope and enqueues it on the transport.
4
+ * Never throws — all errors are caught and logged.
5
+ *
6
+ * **Ingest contract:** `senpi-agent-telemetry` requires `correlationId` to be UUID v4
7
+ * (see `validateEventBatch`). Bus payloads may use opaque `__correlationId` strings;
8
+ * those are replaced here so batches are not rejected with HTTP 400.
9
+ */
10
+ import { randomUUID } from "node:crypto";
11
+ import { createLogger } from "../utils/logger.js";
12
+ const logger = createLogger("[senpi-core][tracking-tracker]");
13
+ const ADDRESS_RE = /^0x[a-f0-9]{40}$/i;
14
+ /** Matches `senpi-agent-telemetry` `validateEventBatch` (UUID v4 for `correlationId`). */
15
+ const CORRELATION_ID_UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
16
+ /**
17
+ * Returns a UUID v4 suitable for the telemetry API. Omitted, empty, or invalid
18
+ * values are replaced; valid v4 strings from the bus are kept for correlation.
19
+ */
20
+ function normalizeCorrelationId(raw) {
21
+ if (typeof raw !== "string" || !CORRELATION_ID_UUID_V4.test(raw)) {
22
+ return randomUUID();
23
+ }
24
+ return raw;
25
+ }
26
+ export class EventTracker {
27
+ transport;
28
+ runtimeName;
29
+ runtimeVersion;
30
+ strategyWallet;
31
+ constructor(transport, runtimeName, runtimeVersion, strategyWallet) {
32
+ this.transport = transport;
33
+ this.runtimeName = runtimeName;
34
+ this.runtimeVersion = runtimeVersion;
35
+ this.strategyWallet = strategyWallet;
36
+ }
37
+ capture(options) {
38
+ try {
39
+ const address = ADDRESS_RE.test(options.address)
40
+ ? options.address
41
+ : this.strategyWallet;
42
+ const event = {
43
+ id: randomUUID(),
44
+ timestamp: Date.now(),
45
+ runtimeName: this.runtimeName,
46
+ address,
47
+ correlationId: normalizeCorrelationId(options.correlationId),
48
+ eventType: options.eventType,
49
+ category: options.category,
50
+ data: options.data,
51
+ runtimeVersion: this.runtimeVersion,
52
+ };
53
+ this.transport.enqueue(event);
54
+ }
55
+ catch (err) {
56
+ logger.warn("tracking capture failed", {
57
+ eventType: options.eventType,
58
+ err: err instanceof Error ? err.message : String(err),
59
+ });
60
+ }
61
+ }
62
+ async shutdown() {
63
+ await this.transport.shutdown();
64
+ }
65
+ }
66
+ //# sourceMappingURL=tracker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../src/tracking/tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,YAAY,CAAC,gCAAgC,CAAC,CAAC;AAE9D,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,0FAA0F;AAC1F,MAAM,sBAAsB,GAC1B,wEAAwE,CAAC;AAE3E;;;GAGG;AACH,SAAS,sBAAsB,CAAC,GAA8B;IAC5D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAaD,MAAM,OAAO,YAAY;IAEJ;IACA;IACA;IACA;IAJnB,YACmB,SAA4B,EAC5B,WAAmB,EACnB,cAAsB,EACtB,cAAsB;QAHtB,cAAS,GAAT,SAAS,CAAmB;QAC5B,gBAAW,GAAX,WAAW,CAAQ;QACnB,mBAAc,GAAd,cAAc,CAAQ;QACtB,mBAAc,GAAd,cAAc,CAAQ;IACtC,CAAC;IAEJ,OAAO,CAAC,OAAuB;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC9C,CAAC,CAAC,OAAO,CAAC,OAAO;gBACjB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;YACxB,MAAM,KAAK,GAAkB;gBAC3B,EAAE,EAAE,UAAU,EAAE;gBAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,OAAO;gBACP,aAAa,EAAE,sBAAsB,CAAC,OAAO,CAAC,aAAa,CAAC;gBAC5D,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC;YACF,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE;gBACrC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACtD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;CACF"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Tracking handler: subscribes to bus events and forwards them to EventTracker.
3
+ * Pattern follows src/dsl/notifications/index.ts — subscribe, return dispose().
4
+ * Never throws into the bus event loop.
5
+ */
6
+ import type { SenpiEventBus } from "../types/event-bus.js";
7
+ import type { EventTracker } from "./tracker.js";
8
+ export interface TrackingHandler {
9
+ dispose(): Promise<void>;
10
+ }
11
+ export declare function createTrackingHandler(bus: SenpiEventBus, tracker: EventTracker): TrackingHandler;
12
+ //# sourceMappingURL=tracking-handler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracking-handler.d.ts","sourceRoot":"","sources":["../../src/tracking/tracking-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAUjD,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAiFD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,YAAY,GACpB,eAAe,CAgEjB"}
@@ -0,0 +1,148 @@
1
+ /**
2
+ * Tracking handler: subscribes to bus events and forwards them to EventTracker.
3
+ * Pattern follows src/dsl/notifications/index.ts — subscribe, return dispose().
4
+ * Never throws into the bus event loop.
5
+ */
6
+ import { BUS_EVENT_MAP, TRACKING_DECISION_BUS_EVENT, TRACKING_ACTION_RESULT_BUS_EVENT, } from "./constants.js";
7
+ import { createLogger } from "../utils/logger.js";
8
+ const logger = createLogger("[senpi-core][tracking-handler]");
9
+ /**
10
+ * Extract address from a bus event payload.
11
+ * HookEvents have `event.address`, DSL events have `payload.address`.
12
+ */
13
+ function extractAddress(payload) {
14
+ if (payload && typeof payload === "object") {
15
+ const p = payload;
16
+ if (typeof p.address === "string")
17
+ return p.address;
18
+ if (p.data && typeof p.data === "object") {
19
+ const d = p.data;
20
+ if (typeof d.address === "string")
21
+ return d.address;
22
+ }
23
+ }
24
+ return "";
25
+ }
26
+ /**
27
+ * Extract __correlationId from a bus event payload.
28
+ * It may be at payload.data.__correlationId (HookEvent) or payload.__correlationId.
29
+ */
30
+ function extractCorrelationId(payload) {
31
+ if (payload && typeof payload === "object") {
32
+ const p = payload;
33
+ if (typeof p.__correlationId === "string")
34
+ return p.__correlationId;
35
+ if (p.data && typeof p.data === "object") {
36
+ const d = p.data;
37
+ if (typeof d.__correlationId === "string")
38
+ return d.__correlationId;
39
+ }
40
+ }
41
+ return null;
42
+ }
43
+ /** Convert payload to a plain data object for tracking. */
44
+ function toData(payload) {
45
+ if (payload && typeof payload === "object" && !Array.isArray(payload)) {
46
+ return payload;
47
+ }
48
+ return { raw: payload };
49
+ }
50
+ /**
51
+ * Resolve decision event type from payload.
52
+ * Inspects data.decision to determine executed/rejected/below_confidence/error.
53
+ */
54
+ function resolveDecisionEventType(payload) {
55
+ const data = toData(payload);
56
+ const decision = data.decision ?? (data.data && typeof data.data === "object" ? data.data.decision : undefined);
57
+ if (decision && typeof decision === "object") {
58
+ const d = decision;
59
+ if (d.error)
60
+ return "decision.error";
61
+ if (d.execute === false)
62
+ return "decision.rejected";
63
+ }
64
+ // Check for below_confidence via skipReason in the tracking.decision payload data
65
+ const innerData = data.data && typeof data.data === "object" ? data.data : data;
66
+ if (typeof innerData.skipReason === "string" && innerData.skipReason === "below_confidence") {
67
+ return "decision.below_confidence";
68
+ }
69
+ return "decision.executed";
70
+ }
71
+ /**
72
+ * Resolve action result event type from payload.
73
+ * Inspects data.result.skipped to determine result vs skipped.
74
+ */
75
+ function resolveActionResultEventType(payload) {
76
+ const data = toData(payload);
77
+ const result = data.result ?? (data.data && typeof data.data === "object" ? data.data.result : undefined);
78
+ if (result && typeof result === "object") {
79
+ const r = result;
80
+ if (r.skipped === true)
81
+ return "action.skipped";
82
+ }
83
+ return "action.result";
84
+ }
85
+ export function createTrackingHandler(bus, tracker) {
86
+ const handlers = [];
87
+ function subscribe(busEvent, handler) {
88
+ bus.on(busEvent, handler);
89
+ handlers.push({ event: busEvent, handler });
90
+ }
91
+ // Subscribe to all statically mapped bus events
92
+ for (const [busEvent, mapping] of Object.entries(BUS_EVENT_MAP)) {
93
+ subscribe(busEvent, (payload) => {
94
+ try {
95
+ tracker.capture({
96
+ eventType: mapping.eventType,
97
+ category: mapping.category,
98
+ address: extractAddress(payload),
99
+ correlationId: extractCorrelationId(payload),
100
+ data: toData(payload),
101
+ });
102
+ }
103
+ catch (err) {
104
+ logger.warn("tracking handler error", { busEvent, err });
105
+ }
106
+ });
107
+ }
108
+ // Decision events (require payload inspection)
109
+ subscribe(TRACKING_DECISION_BUS_EVENT, (payload) => {
110
+ try {
111
+ tracker.capture({
112
+ eventType: resolveDecisionEventType(payload),
113
+ category: "decision",
114
+ address: extractAddress(payload),
115
+ correlationId: extractCorrelationId(payload),
116
+ data: toData(payload),
117
+ });
118
+ }
119
+ catch (err) {
120
+ logger.warn("tracking handler error (decision)", { err });
121
+ }
122
+ });
123
+ // Action result events (require payload inspection)
124
+ subscribe(TRACKING_ACTION_RESULT_BUS_EVENT, (payload) => {
125
+ try {
126
+ tracker.capture({
127
+ eventType: resolveActionResultEventType(payload),
128
+ category: "action",
129
+ address: extractAddress(payload),
130
+ correlationId: extractCorrelationId(payload),
131
+ data: toData(payload),
132
+ });
133
+ }
134
+ catch (err) {
135
+ logger.warn("tracking handler error (action_result)", { err });
136
+ }
137
+ });
138
+ return {
139
+ async dispose() {
140
+ for (const { event, handler } of handlers) {
141
+ bus.off(event, handler);
142
+ }
143
+ handlers.length = 0;
144
+ await tracker.shutdown();
145
+ },
146
+ };
147
+ }
148
+ //# sourceMappingURL=tracking-handler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracking-handler.js","sourceRoot":"","sources":["../../src/tracking/tracking-handler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Tracking transports: BatchingTransport (HTTP POST) and NoOpTransport.
3
+ *
4
+ * Both implement TrackingTransport. Never throw — all errors are caught and logged.
5
+ * The batching transport buffers events and flushes on a timer or threshold.
6
+ */
7
+ import type { TrackingEvent, TrackingTransport } from "./types.js";
8
+ export interface BatchingTransportOptions {
9
+ baseUrl: string;
10
+ apiKey: string;
11
+ flushIntervalMs?: number;
12
+ flushThreshold?: number;
13
+ maxBufferSize?: number;
14
+ }
15
+ export declare class BatchingTransport implements TrackingTransport {
16
+ private buffer;
17
+ private timer;
18
+ private flushing;
19
+ private readonly url;
20
+ private readonly apiKey;
21
+ private readonly flushIntervalMs;
22
+ private readonly flushThreshold;
23
+ private readonly maxBufferSize;
24
+ constructor(options: BatchingTransportOptions);
25
+ enqueue(event: TrackingEvent): void;
26
+ flush(): Promise<void>;
27
+ shutdown(): Promise<void>;
28
+ private pushBack;
29
+ }
30
+ export declare class NoOpTransport implements TrackingTransport {
31
+ enqueue(_event: TrackingEvent): void;
32
+ flush(): Promise<void>;
33
+ shutdown(): Promise<void>;
34
+ }
35
+ //# sourceMappingURL=transport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/tracking/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAanE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,EAAE,wBAAwB;IAgB7C,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAY7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkDtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB/B,OAAO,CAAC,QAAQ;CAQjB;AAID,qBAAa,aAAc,YAAW,iBAAiB;IACrD,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAChC"}
@@ -0,0 +1,133 @@
1
+ /**
2
+ * Tracking transports: BatchingTransport (HTTP POST) and NoOpTransport.
3
+ *
4
+ * Both implement TrackingTransport. Never throw — all errors are caught and logged.
5
+ * The batching transport buffers events and flushes on a timer or threshold.
6
+ */
7
+ import { TRACKING_API_PATH, FLUSH_INTERVAL_MS, FLUSH_THRESHOLD, MAX_BUFFER_SIZE, } from "./constants.js";
8
+ import { createLogger } from "../utils/logger.js";
9
+ const logger = createLogger("[senpi-core][tracking-transport]");
10
+ export class BatchingTransport {
11
+ buffer = [];
12
+ timer = null;
13
+ flushing = false;
14
+ url;
15
+ apiKey;
16
+ flushIntervalMs;
17
+ flushThreshold;
18
+ maxBufferSize;
19
+ constructor(options) {
20
+ this.url = `${options.baseUrl.replace(/\/+$/, "")}${TRACKING_API_PATH}`;
21
+ this.apiKey = options.apiKey;
22
+ this.flushIntervalMs = options.flushIntervalMs ?? FLUSH_INTERVAL_MS;
23
+ this.flushThreshold = options.flushThreshold ?? FLUSH_THRESHOLD;
24
+ this.maxBufferSize = options.maxBufferSize ?? MAX_BUFFER_SIZE;
25
+ this.timer = setInterval(() => {
26
+ void this.flush();
27
+ }, this.flushIntervalMs);
28
+ // Don't keep the process alive just for tracking flushes
29
+ if (this.timer && typeof this.timer === "object" && "unref" in this.timer) {
30
+ this.timer.unref();
31
+ }
32
+ }
33
+ enqueue(event) {
34
+ if (this.buffer.length >= this.maxBufferSize) {
35
+ // FIFO eviction: drop oldest
36
+ this.buffer.shift();
37
+ }
38
+ this.buffer.push(event);
39
+ if (this.buffer.length >= this.flushThreshold) {
40
+ void this.flush();
41
+ }
42
+ }
43
+ async flush() {
44
+ if (this.flushing || this.buffer.length === 0)
45
+ return;
46
+ this.flushing = true;
47
+ const batch = this.buffer.splice(0, this.flushThreshold);
48
+ try {
49
+ const response = await fetch(this.url, {
50
+ method: "POST",
51
+ headers: {
52
+ "Content-Type": "application/json",
53
+ Authorization: `Bearer ${this.apiKey}`,
54
+ },
55
+ body: JSON.stringify({ events: batch }),
56
+ signal: AbortSignal.timeout(15_000),
57
+ });
58
+ if (!response.ok) {
59
+ const body = await response.text().catch(() => "<unreadable>");
60
+ // Ingest returns JSON `{ accepted, rejected, errors? }` on 400 when `errors` is set
61
+ let validationErrors;
62
+ if (response.status === 400) {
63
+ try {
64
+ const parsed = JSON.parse(body);
65
+ if (Array.isArray(parsed.errors))
66
+ validationErrors = parsed.errors;
67
+ }
68
+ catch {
69
+ /* not JSON */
70
+ }
71
+ }
72
+ logger.warn("tracking flush failed", {
73
+ status: response.status,
74
+ eventCount: batch.length,
75
+ body: body.slice(0, 500),
76
+ validationErrors,
77
+ sample: batch[0],
78
+ });
79
+ // Push back for retry (front of buffer, capped by maxBufferSize)
80
+ this.pushBack(batch);
81
+ }
82
+ }
83
+ catch (err) {
84
+ logger.warn("tracking flush error", {
85
+ err: err instanceof Error ? err.message : String(err),
86
+ eventCount: batch.length,
87
+ });
88
+ this.pushBack(batch);
89
+ }
90
+ finally {
91
+ this.flushing = false;
92
+ }
93
+ }
94
+ async shutdown() {
95
+ if (this.timer) {
96
+ clearInterval(this.timer);
97
+ this.timer = null;
98
+ }
99
+ // Drain the buffer — flush() pulls at most flushThreshold events per call,
100
+ // so loop until empty. Cap attempts to avoid an infinite loop when the
101
+ // server keeps failing and pushBack restores everything.
102
+ this.flushing = false;
103
+ const maxAttempts = Math.ceil(this.maxBufferSize / this.flushThreshold) + 1;
104
+ for (let i = 0; i < maxAttempts && this.buffer.length > 0; i++) {
105
+ const before = this.buffer.length;
106
+ await this.flush();
107
+ // If the flush made no progress (all events pushed back on failure),
108
+ // stop instead of looping forever.
109
+ if (this.buffer.length >= before)
110
+ break;
111
+ }
112
+ if (this.buffer.length > 0) {
113
+ logger.warn("tracking shutdown: dropping events that failed to flush", {
114
+ dropped: this.buffer.length,
115
+ });
116
+ }
117
+ }
118
+ pushBack(events) {
119
+ // Put failed events back at the front, but respect max buffer
120
+ const space = this.maxBufferSize - this.buffer.length;
121
+ if (space > 0) {
122
+ const toRestore = events.slice(0, space);
123
+ this.buffer.unshift(...toRestore);
124
+ }
125
+ }
126
+ }
127
+ // ─── NoOpTransport ──────────────────────────────────────────────────────────
128
+ export class NoOpTransport {
129
+ enqueue(_event) { }
130
+ async flush() { }
131
+ async shutdown() { }
132
+ }
133
+ //# sourceMappingURL=transport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/tracking/transport.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Event tracking types — runtime side.
3
+ * Matches the TrackingEvent envelope expected by POST /api/v1/tracking/events.
4
+ */
5
+ export interface TrackingEvent {
6
+ id: string;
7
+ timestamp: number;
8
+ runtimeName: string;
9
+ address: string;
10
+ correlationId: string;
11
+ eventType: string;
12
+ category: string;
13
+ data: Record<string, unknown>;
14
+ runtimeVersion: string;
15
+ }
16
+ export interface TrackingTransport {
17
+ enqueue(event: TrackingEvent): void;
18
+ flush(): Promise<void>;
19
+ shutdown(): Promise<void>;
20
+ }
21
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tracking/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Event tracking types — runtime side.
3
+ * Matches the TrackingEvent envelope expected by POST /api/v1/tracking/events.
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tracking/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
@@ -4,12 +4,23 @@ export interface StateManager {
4
4
  /** Keys in the returned record are strategy addresses (wallet). */
5
5
  getUsedSlotsByStrategy(addresses: string[]): Promise<Record<string, number>>;
6
6
  }
7
+ import type { RiskGateEvaluation, RiskSource } from "../health/types.js";
7
8
  export interface GateCheckResult {
8
9
  gate: 'OPEN' | 'COOLDOWN' | 'CLOSED';
9
10
  reason?: string;
10
11
  }
12
+ /** Extended result returned when `evaluateAll: true` — includes per-gate details. */
13
+ export interface FullGateCheckResult extends GateCheckResult {
14
+ gates: RiskGateEvaluation[];
15
+ }
16
+ export interface CheckGateOpts {
17
+ candidateAsset?: string;
18
+ source?: RiskSource;
19
+ evaluateAll?: boolean;
20
+ }
11
21
  export interface RiskGuard {
12
- checkGate(address: string, guardRails?: Record<string, unknown>): GateCheckResult;
13
- recordEntry(address: string, guardRails?: Record<string, unknown>): void;
22
+ /** Evaluate all risk gates in real-time via MCP API calls. Fail-closed on any error. */
23
+ checkGate(address: string, opts?: CheckGateOpts): Promise<GateCheckResult>;
24
+ getGateForStrategies(addresses: string[]): Promise<Record<string, GateCheckResult>>;
14
25
  }
15
26
  //# sourceMappingURL=action.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/types/action.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,mEAAmE;IACnE,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC;IAClF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1E"}
1
+ {"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/types/action.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,mEAAmE;IACnE,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9E;AAED,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qFAAqF;AACrF,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,wFAAwF;IACxF,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3E,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;CACrF"}