@senpi-ai/runtime 1.0.97 → 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 (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
package/README.md CHANGED
@@ -16,6 +16,8 @@ Event-driven automated trading plugin for OpenClaw. Orchestrates scanners, LLM-b
16
16
  openclaw plugins install @senpi-ai/runtime
17
17
  ```
18
18
 
19
+ **Custom installs (Git checkout, `dist/`-only copy, or Docker without devDependencies):** run `npm install` in the package root (or `npm ci --omit=dev` from a lockfile) so `node_modules` includes runtime dependencies. The runtime uses **TypeBox** at load time for scanner option validation (`@sinclair/typebox` / `@sinclair/typebox/value`); if that package is missing, the gateway will fail to load the plugin with `Cannot find module '@sinclair/typebox/value'`.
20
+
19
21
  ## Configure
20
22
 
21
23
  Add the plugin to your OpenClaw config (e.g. `~/.openclaw/openclaw.json` or via `openclaw config set`). Use the plugin **id** `@senpi-ai/runtime` as the key:
@@ -28,7 +30,8 @@ Add the plugin to your OpenClaw config (e.g. `~/.openclaw/openclaw.json` or via
28
30
  "enabled": true,
29
31
  "config": {
30
32
  "stateDir": "~/.openclaw/senpi-state",
31
- "apiKey": "YOUR_SENPI_API_KEY"
33
+ "apiKey": "YOUR_SENPI_API_KEY",
34
+ "logLevel": "info"
32
35
  }
33
36
  }
34
37
  }
@@ -36,6 +39,51 @@ Add the plugin to your OpenClaw config (e.g. `~/.openclaw/openclaw.json` or via
36
39
  }
37
40
  ```
38
41
 
42
+ ## Log level
43
+
44
+ The runtime's minimum log level defaults to `info`. Accepted values are `debug`, `info`, `warn`, and `error` (case-insensitive); anything else falls back to `info` with a one-time console warning at startup.
45
+
46
+ Resolution order (highest priority first):
47
+
48
+ 1. **Plugin config `logLevel`** — set it inside the plugin `config` block in `openclaw.json`. This is the recommended place so the level lives next to the rest of the runtime's configuration and survives gateway restarts without shell env wiring.
49
+ 2. **`SENPI_LOG_LEVEL` env var** — useful for one-off overrides or when running the gateway under Docker Compose where env vars are easier to inject than config patches.
50
+ 3. **Default** — `info`.
51
+
52
+ ```jsonc
53
+ // ~/.openclaw/openclaw.json
54
+ {
55
+ "plugins": {
56
+ "entries": {
57
+ "@senpi-ai/runtime": {
58
+ "enabled": true,
59
+ "config": {
60
+ "logLevel": "debug"
61
+ }
62
+ }
63
+ }
64
+ }
65
+ }
66
+ ```
67
+
68
+ ```bash
69
+ # Env-var alternative (ignored if plugin config logLevel is set)
70
+ export SENPI_LOG_LEVEL=warn
71
+ ```
72
+
73
+ The runtime logs the resolved level and its source on plugin start:
74
+
75
+ ```
76
+ [senpi-runtime] log level: info (source: default). Set plugin config "logLevel" or env SENPI_LOG_LEVEL to debug|info|warn|error to override.
77
+ ```
78
+
79
+ The `source:` field will be one of `plugin config logLevel`, `env SENPI_LOG_LEVEL`, or `default`. You can confirm the active level at any time with `openclaw senpi status`, which prints a `Log Level: <level>` line for each running runtime (also available under `openclaw senpi state`).
80
+
81
+ ### What each level shows
82
+
83
+ - `warn` / `error` — failures, retries, clearinghouse unavailable, scanner watchdog alerts.
84
+ - `info` (default) — the above, plus lifecycle events (open/close positions, scanner signal processed), DSL monitor ticks when there are active positions, position-tracker scans when positions or deltas change.
85
+ - `debug` — the above, plus per-tick scanner heartbeats, DSL monitor ticks with zero active positions, and full MCP tool-call request/response envelopes (with secrets redacted). Useful for diagnosing individual scan or price-fetch behavior; very noisy.
86
+
39
87
  ## Notifications
40
88
 
41
89
  - **Strategy-level:** Set `notifications.telegram_chat_id` in your strategy YAML to receive alerts (e.g. open/close, decision errors, scanner watchdog). The plugin sends messages via the OpenClaw gateway `message` tool (`action: send`, `target: telegram:<chatId>`).
@@ -73,6 +121,10 @@ Set `"enabled": false` inside the `autoUpdate` block to disable it entirely.
73
121
 
74
122
  **Known limitation:** If the gateway cannot be restarted automatically (wrong reload mode or missing config access), runtimes that were stopped for the update remain stopped until you restart the gateway manually.
75
123
 
124
+ ## Risk guardrails
125
+
126
+ Strategy YAML may include a `risk` block with `guard_rails` (daily loss, drawdown, max entries per day, consecutive-loss cooldown, per-asset cooldown, and optional bypass when the day is profitable at the entry cap). Gates are evaluated in real time via MCP before each open. See [docs/risk-component.md](docs/risk-component.md) for gate order, data sources, and semantics.
127
+
76
128
  ## Quickstart
77
129
 
78
130
  1. Copy a minimal recipe template and set your wallet:
@@ -124,6 +176,65 @@ Templates live under `examples/strategies/` in the package. See [examples/strate
124
176
  - `openclaw senpi guide schema` — full YAML schema
125
177
  - `openclaw senpi guide version` — plugin version and changelog URL
126
178
 
179
+ ## HTTP API
180
+
181
+ The runtime exposes an HTTP API on `127.0.0.1:8787` (default; configurable via plugin config). Use it to ingest signals from external sources, query audit history, and check liveness.
182
+
183
+ **Three endpoints:**
184
+ - `POST /signals` — ingest external scanner signals; body is a JSON array of signal items
185
+ - `GET /audit?address=<wallet>` — query strategy audit history via MCP
186
+ - `GET /health` — liveness probe with per-runtime signal queue depth
187
+
188
+ **Default binding:** `127.0.0.1:8787` (localhost-only). For Postman testing on the same host, flip `api.host` to `0.0.0.0` in `openclaw.json` and add a Docker port mapping `127.0.0.1:8787:8787` (the `127.0.0.1:` prefix is mandatory to avoid LAN exposure). See [docs/runtime-docs/runtime-api.md](docs/runtime-docs/runtime-api.md) for full details and the Postman testing recipe.
189
+
190
+ **Latency benchmark:** `npm run bench` runs `benchmarks/ingest-latency.ts` — compares the in-process gateway-shim path against HTTP `POST /signals` across three scenarios and prints p50/p95/p99 with a PASS/FAIL gate.
191
+
192
+ ## External scanners
193
+
194
+ Use `type: external_scanner` when the signal or context source lives outside the
195
+ runtime and should push data in through the gateway instead of being scheduled
196
+ on an `interval`.
197
+
198
+ ```yaml
199
+ scanners:
200
+ - name: funding_arb
201
+ type: external_scanner
202
+ outputs:
203
+ signals: true
204
+ context: false
205
+ retention: rolling_window
206
+ retention_max_runs: 50
207
+ config:
208
+ fields:
209
+ funding_rate: { type: number, required: true }
210
+ spread: { type: number, required: true }
211
+ exchange: { type: string }
212
+ ```
213
+
214
+ Ingest data with the gateway RPC:
215
+
216
+ ```bash
217
+ openclaw gateway call senpi.ingestExternalScannerData --params '{
218
+ "address": "0xYourStrategyWallet",
219
+ "scanner": "funding_arb",
220
+ "asset": "ETH-PERP",
221
+ "direction": "LONG",
222
+ "score": 0.91,
223
+ "signal_type": "EXTERNAL_FUNDING_ARB",
224
+ "data": {
225
+ "funding_rate": 0.015,
226
+ "spread": 0.003,
227
+ "exchange": "binance"
228
+ }
229
+ }'
230
+ ```
231
+
232
+ Prompt access stays namespaced:
233
+
234
+ - `{{signal_funding_arb}}` for ingested signals
235
+ - `{{context_custom_regime}}` for retained external context
236
+ - flat aliases like `{{funding_arb}}` are not created
237
+
127
238
  ## Guide skill
128
239
 
129
240
  Once published, the **@senpi-guide** skill on ClawHub provides the same reference in chat. Install with `clawhub install skills/senpi-guide/` (or from the ClawHub UI).
@@ -135,7 +246,7 @@ If you already have OpenClaw installed (local, VPS, or self-hosted), see [Instal
135
246
  ## Docs
136
247
 
137
248
  - [Architecture](docs/runtime-docs/design/architecture.md)
138
- - [Skills YAML schema](docs/runtime-docs/design/skills-yaml-schema.md)
249
+ - [Strategy YAML specification](docs/runtime-docs/strategy-yaml-spec.md)
139
250
  - [Integration guide](docs/runtime-docs/integration-guide.md)
140
251
  - [Runtime API](docs/runtime-docs/runtime-api.md)
141
252
 
@@ -0,0 +1,55 @@
1
+ /**
2
+ * Action-layer telemetry, persistence, and health/state reporting for the runtime.
3
+ *
4
+ * @module
5
+ */
6
+ import type { Action, ActionConfig, ActionResult, HookEvent } from "./types.js";
7
+ import type { ActionExecutionRecord, ActionLatestState, ActionTelemetry } from "./store/types.js";
8
+ import type { ActionComponentHealthStatus, ActionSystemState, ComponentHealth, StateStatusProvider } from "../health/types.js";
9
+ /**
10
+ * Resolves JSONL retention from an action’s optional `params.history_retention_hours` (hours).
11
+ *
12
+ * @param config - Parsed action config; reads `config.params.history_retention_hours` when set to a positive number or numeric string.
13
+ * @returns Retention window in milliseconds (default 24h).
14
+ */
15
+ export declare function resolveHistoryRetentionMs(config: ActionConfig): number;
16
+ /**
17
+ * Per-action health from counters and last run (actions are event-driven, no "overdue").
18
+ */
19
+ export declare function deriveActionHealth(telemetry: ActionTelemetry): ComponentHealth;
20
+ export interface ActionRuntimeModuleOptions {
21
+ stateDir: string;
22
+ now?: () => number;
23
+ }
24
+ /**
25
+ * Wraps action execution with telemetry, audit records, and health aggregation.
26
+ */
27
+ export declare class ActionRuntimeModule implements StateStatusProvider<ActionComponentHealthStatus, ActionSystemState> {
28
+ private readonly actionStore;
29
+ private readonly now;
30
+ private readonly telemetry;
31
+ private readonly configs;
32
+ constructor(options: ActionRuntimeModuleOptions);
33
+ /**
34
+ * Registers an action instance for health reporting and seeds telemetry from persisted `latest.json`
35
+ * so cumulative counters survive process restarts.
36
+ */
37
+ registerAction(address: string, actionName: string, config: ActionConfig): Promise<void>;
38
+ /**
39
+ * Wraps `action.handle(event)` with timing, persistence, and counter updates.
40
+ */
41
+ wrapHandle(address: string, action: Action, config: ActionConfig, event: HookEvent): Promise<ActionResult>;
42
+ /** Reads persisted latest snapshot (for gateway/CLI). */
43
+ readLatest(address: string, actionName: string): Promise<ActionLatestState | null>;
44
+ /** Reads rolling history (for gateway/CLI). */
45
+ readHistory(address: string, actionName: string, opts?: import("./store/types.js").ReadActionHistoryOptions): Promise<ActionExecutionRecord[]>;
46
+ /** Lists latest snapshots across strategies (for gateway list command). */
47
+ readAllLatest(filter?: import("./store/types.js").ActionFilter): Promise<ActionLatestState[]>;
48
+ getHealthStatus(): Promise<ActionComponentHealthStatus>;
49
+ getSystemState(): Promise<ActionSystemState>;
50
+ private ensureTelemetry;
51
+ private applyResultToTelemetry;
52
+ private buildRecord;
53
+ private buildLatestState;
54
+ }
55
+ //# sourceMappingURL=action-runtime-module.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"action-runtime-module.d.ts","sourceRoot":"","sources":["../../src/actions/action-runtime-module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAA4B,SAAS,EAAE,MAAM,YAAY,CAAC;AAG1G,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EACV,2BAA2B,EAG3B,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAa5B;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAYtE;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,eAAe,GAAG,eAAe,CAe9E;AAsKD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,mBACX,YAAW,mBAAmB,CAAC,2BAA2B,EAAE,iBAAiB,CAAC;IAE9E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;gBAE/C,OAAO,EAAE,0BAA0B;IAK/C;;;OAGG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB9F;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,YAAY,CAAC;IAoExB,yDAAyD;IACzD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAI9C,+CAA+C;IAC/C,WAAW,CACT,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,OAAO,kBAAkB,EAAE,wBAAwB;IAK5D,2EAA2E;IAC3E,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,kBAAkB,EAAE,YAAY;IAIxD,eAAe,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAgDvD,cAAc,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAgDlD,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,sBAAsB;IAyC9B,OAAO,CAAC,WAAW;IAoCnB,OAAO,CAAC,gBAAgB;CA0BzB"}