@senpi/runtime 1.0.95-dev.feat-dsl-backend-int.20260416023008 → 1.0.95-dev.runtime-phase-2.20260416194608

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 (285) hide show
  1. package/README.md +72 -0
  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 +444 -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 +55 -20
  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/llm-decision/shared.d.ts +1 -1
  14. package/dist/actions/llm-decision/shared.d.ts.map +1 -1
  15. package/dist/actions/llm-decision/shared.js +1 -1
  16. package/dist/actions/llm-decision/shared.js.map +1 -1
  17. package/dist/actions/notifications/formatter.d.ts +39 -0
  18. package/dist/actions/notifications/formatter.d.ts.map +1 -0
  19. package/dist/actions/notifications/formatter.js +68 -0
  20. package/dist/actions/notifications/formatter.js.map +1 -0
  21. package/dist/actions/notifications/index.d.ts +37 -0
  22. package/dist/actions/notifications/index.d.ts.map +1 -0
  23. package/dist/actions/notifications/index.js +89 -0
  24. package/dist/actions/notifications/index.js.map +1 -0
  25. package/dist/actions/open-position/open-position.action.d.ts +1 -0
  26. package/dist/actions/open-position/open-position.action.d.ts.map +1 -1
  27. package/dist/actions/open-position/open-position.action.js +132 -27
  28. package/dist/actions/open-position/open-position.action.js.map +1 -1
  29. package/dist/actions/open-position/resolve-margin.d.ts +22 -0
  30. package/dist/actions/open-position/resolve-margin.d.ts.map +1 -0
  31. package/dist/actions/open-position/resolve-margin.js +30 -0
  32. package/dist/actions/open-position/resolve-margin.js.map +1 -0
  33. package/dist/actions/position-tracker/position-tracker.action.d.ts.map +1 -1
  34. package/dist/actions/position-tracker/position-tracker.action.js +4 -1
  35. package/dist/actions/position-tracker/position-tracker.action.js.map +1 -1
  36. package/dist/actions/store/action-store.d.ts +45 -0
  37. package/dist/actions/store/action-store.d.ts.map +1 -0
  38. package/dist/actions/store/action-store.js +127 -0
  39. package/dist/actions/store/action-store.js.map +1 -0
  40. package/dist/actions/store/index.d.ts +11 -0
  41. package/dist/actions/store/index.d.ts.map +1 -0
  42. package/dist/actions/store/index.js +9 -0
  43. package/dist/actions/store/index.js.map +1 -0
  44. package/dist/actions/store/paths.d.ts +15 -0
  45. package/dist/actions/store/paths.d.ts.map +1 -0
  46. package/dist/actions/store/paths.js +29 -0
  47. package/dist/actions/store/paths.js.map +1 -0
  48. package/dist/actions/store/types.d.ts +114 -0
  49. package/dist/actions/store/types.d.ts.map +1 -0
  50. package/dist/actions/store/types.js +48 -0
  51. package/dist/actions/store/types.js.map +1 -0
  52. package/dist/actions/tracking-helpers.d.ts +13 -0
  53. package/dist/actions/tracking-helpers.d.ts.map +1 -0
  54. package/dist/actions/tracking-helpers.js +47 -0
  55. package/dist/actions/tracking-helpers.js.map +1 -0
  56. package/dist/actions/types.d.ts +8 -0
  57. package/dist/actions/types.d.ts.map +1 -1
  58. package/dist/cli/guide-commands.d.ts.map +1 -1
  59. package/dist/cli/guide-commands.js +105 -3
  60. package/dist/cli/guide-commands.js.map +1 -1
  61. package/dist/cli/senpi-commands.d.ts.map +1 -1
  62. package/dist/cli/senpi-commands.js +428 -1
  63. package/dist/cli/senpi-commands.js.map +1 -1
  64. package/dist/constants/order-types.d.ts +7 -0
  65. package/dist/constants/order-types.d.ts.map +1 -0
  66. package/dist/constants/order-types.js +6 -0
  67. package/dist/constants/order-types.js.map +1 -0
  68. package/dist/context/interpolate.d.ts +6 -2
  69. package/dist/context/interpolate.d.ts.map +1 -1
  70. package/dist/context/interpolate.js +6 -2
  71. package/dist/context/interpolate.js.map +1 -1
  72. package/dist/context/types.d.ts +8 -1
  73. package/dist/context/types.d.ts.map +1 -1
  74. package/dist/context/types.js +8 -1
  75. package/dist/context/types.js.map +1 -1
  76. package/dist/dsl/config/exit-block.d.ts +7 -0
  77. package/dist/dsl/config/exit-block.d.ts.map +1 -1
  78. package/dist/dsl/config/parse-plugin-config.d.ts.map +1 -1
  79. package/dist/dsl/config/parse-plugin-config.js +27 -1
  80. package/dist/dsl/config/parse-plugin-config.js.map +1 -1
  81. package/dist/dsl/config/unknown-keys.d.ts.map +1 -1
  82. package/dist/dsl/config/unknown-keys.js +3 -1
  83. package/dist/dsl/config/unknown-keys.js.map +1 -1
  84. package/dist/dsl/monitor/create-monitor.d.ts +4 -0
  85. package/dist/dsl/monitor/create-monitor.d.ts.map +1 -1
  86. package/dist/dsl/monitor/create-monitor.js +8 -5
  87. package/dist/dsl/monitor/create-monitor.js.map +1 -1
  88. package/dist/dsl/monitor/process-one-position.d.ts +4 -0
  89. package/dist/dsl/monitor/process-one-position.d.ts.map +1 -1
  90. package/dist/dsl/monitor/process-one-position.js +8 -2
  91. package/dist/dsl/monitor/process-one-position.js.map +1 -1
  92. package/dist/dsl/plugin/index.d.ts.map +1 -1
  93. package/dist/dsl/plugin/index.js +3 -1
  94. package/dist/dsl/plugin/index.js.map +1 -1
  95. package/dist/health/index.d.ts +5 -2
  96. package/dist/health/index.d.ts.map +1 -1
  97. package/dist/health/index.js +106 -6
  98. package/dist/health/index.js.map +1 -1
  99. package/dist/health/types.d.ts +102 -0
  100. package/dist/health/types.d.ts.map +1 -1
  101. package/dist/health/types.js +7 -1
  102. package/dist/health/types.js.map +1 -1
  103. package/dist/index.d.ts +2 -2
  104. package/dist/index.d.ts.map +1 -1
  105. package/dist/index.js +98 -1
  106. package/dist/index.js.map +1 -1
  107. package/dist/risk/guardrail.types.d.ts +53 -0
  108. package/dist/risk/guardrail.types.d.ts.map +1 -0
  109. package/dist/risk/guardrail.types.js +5 -0
  110. package/dist/risk/guardrail.types.js.map +1 -0
  111. package/dist/risk/index.d.ts +2 -4
  112. package/dist/risk/index.d.ts.map +1 -1
  113. package/dist/risk/index.js +2 -6
  114. package/dist/risk/index.js.map +1 -1
  115. package/dist/risk/risk-audit-log.d.ts +25 -0
  116. package/dist/risk/risk-audit-log.d.ts.map +1 -0
  117. package/dist/risk/risk-audit-log.js +30 -0
  118. package/dist/risk/risk-audit-log.js.map +1 -0
  119. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.d.ts +162 -0
  120. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.d.ts.map +1 -0
  121. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.js +285 -0
  122. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.js.map +1 -0
  123. package/dist/runtime/create-actions.d.ts +6 -2
  124. package/dist/runtime/create-actions.d.ts.map +1 -1
  125. package/dist/runtime/create-actions.js +18 -7
  126. package/dist/runtime/create-actions.js.map +1 -1
  127. package/dist/runtime/create-scanner-module.d.ts +5 -0
  128. package/dist/runtime/create-scanner-module.d.ts.map +1 -1
  129. package/dist/runtime/create-scanner-module.js +12 -1
  130. package/dist/runtime/create-scanner-module.js.map +1 -1
  131. package/dist/runtime/load-runtime-config.d.ts +1 -1
  132. package/dist/runtime/load-runtime-config.d.ts.map +1 -1
  133. package/dist/runtime/load-runtime-config.js +37 -1
  134. package/dist/runtime/load-runtime-config.js.map +1 -1
  135. package/dist/runtime/map-strategies.d.ts +1 -1
  136. package/dist/runtime/map-strategies.d.ts.map +1 -1
  137. package/dist/runtime/map-strategies.js +38 -1
  138. package/dist/runtime/map-strategies.js.map +1 -1
  139. package/dist/runtime/risk-guard.d.ts +23 -2
  140. package/dist/runtime/risk-guard.d.ts.map +1 -1
  141. package/dist/runtime/risk-guard.js +441 -5
  142. package/dist/runtime/risk-guard.js.map +1 -1
  143. package/dist/runtime/run.d.ts +7 -0
  144. package/dist/runtime/run.d.ts.map +1 -1
  145. package/dist/runtime/run.js +3 -0
  146. package/dist/runtime/run.js.map +1 -1
  147. package/dist/runtime/runtime-schema.d.ts +1169 -24
  148. package/dist/runtime/runtime-schema.d.ts.map +1 -1
  149. package/dist/runtime/runtime-schema.js +105 -2
  150. package/dist/runtime/runtime-schema.js.map +1 -1
  151. package/dist/runtime/runtime.d.ts +26 -0
  152. package/dist/runtime/runtime.d.ts.map +1 -1
  153. package/dist/runtime/runtime.js +192 -6
  154. package/dist/runtime/runtime.js.map +1 -1
  155. package/dist/runtime/scanner-composition.d.ts +10 -0
  156. package/dist/runtime/scanner-composition.d.ts.map +1 -1
  157. package/dist/runtime/scanner-composition.js +10 -0
  158. package/dist/runtime/scanner-composition.js.map +1 -1
  159. package/dist/runtime/scanner-registry.d.ts +39 -1
  160. package/dist/runtime/scanner-registry.d.ts.map +1 -1
  161. package/dist/runtime/scanner-registry.js +105 -2
  162. package/dist/runtime/scanner-registry.js.map +1 -1
  163. package/dist/runtime/state-layout.d.ts +2 -0
  164. package/dist/runtime/state-layout.d.ts.map +1 -1
  165. package/dist/runtime/state-layout.js +1 -0
  166. package/dist/runtime/state-layout.js.map +1 -1
  167. package/dist/runtime/validate-action-prompts.d.ts +30 -0
  168. package/dist/runtime/validate-action-prompts.d.ts.map +1 -0
  169. package/dist/runtime/validate-action-prompts.js +110 -0
  170. package/dist/runtime/validate-action-prompts.js.map +1 -0
  171. package/dist/scanners/__tests__/test-helpers.d.ts +10 -0
  172. package/dist/scanners/__tests__/test-helpers.d.ts.map +1 -1
  173. package/dist/scanners/__tests__/test-helpers.js +52 -0
  174. package/dist/scanners/__tests__/test-helpers.js.map +1 -1
  175. package/dist/scanners/engine/engine.d.ts +37 -0
  176. package/dist/scanners/engine/engine.d.ts.map +1 -1
  177. package/dist/scanners/engine/engine.js +132 -14
  178. package/dist/scanners/engine/engine.js.map +1 -1
  179. package/dist/scanners/engine/result-builder.d.ts +16 -0
  180. package/dist/scanners/engine/result-builder.d.ts.map +1 -1
  181. package/dist/scanners/engine/result-builder.js +22 -0
  182. package/dist/scanners/engine/result-builder.js.map +1 -1
  183. package/dist/scanners/engine/strategy-registry.d.ts +2 -0
  184. package/dist/scanners/engine/strategy-registry.d.ts.map +1 -1
  185. package/dist/scanners/engine/strategy-registry.js +5 -1
  186. package/dist/scanners/engine/strategy-registry.js.map +1 -1
  187. package/dist/scanners/external-scanner-receiver.d.ts +118 -0
  188. package/dist/scanners/external-scanner-receiver.d.ts.map +1 -0
  189. package/dist/scanners/external-scanner-receiver.js +266 -0
  190. package/dist/scanners/external-scanner-receiver.js.map +1 -0
  191. package/dist/scanners/implementations/external-scanner.d.ts +17 -0
  192. package/dist/scanners/implementations/external-scanner.d.ts.map +1 -0
  193. package/dist/scanners/implementations/external-scanner.js +51 -0
  194. package/dist/scanners/implementations/external-scanner.js.map +1 -0
  195. package/dist/scanners/implementations/index.d.ts +1 -0
  196. package/dist/scanners/implementations/index.d.ts.map +1 -1
  197. package/dist/scanners/implementations/index.js +1 -0
  198. package/dist/scanners/implementations/index.js.map +1 -1
  199. package/dist/scanners/implementations/position-tracker.d.ts.map +1 -1
  200. package/dist/scanners/implementations/position-tracker.js +3 -1
  201. package/dist/scanners/implementations/position-tracker.js.map +1 -1
  202. package/dist/scanners/index.d.ts +4 -1
  203. package/dist/scanners/index.d.ts.map +1 -1
  204. package/dist/scanners/index.js +2 -0
  205. package/dist/scanners/index.js.map +1 -1
  206. package/dist/scanners/protocol/scanner.d.ts +3 -1
  207. package/dist/scanners/protocol/scanner.d.ts.map +1 -1
  208. package/dist/scanners/providers/client.d.ts.map +1 -1
  209. package/dist/scanners/providers/client.js +0 -8
  210. package/dist/scanners/providers/client.js.map +1 -1
  211. package/dist/scanners/runtime-module.d.ts +10 -0
  212. package/dist/scanners/runtime-module.d.ts.map +1 -1
  213. package/dist/scanners/runtime-module.js +19 -3
  214. package/dist/scanners/runtime-module.js.map +1 -1
  215. package/dist/scanners/scanner-definition.d.ts +12 -1
  216. package/dist/scanners/scanner-definition.d.ts.map +1 -1
  217. package/dist/scanners/types.d.ts +3 -0
  218. package/dist/scanners/types.d.ts.map +1 -1
  219. package/dist/scanners/types.js.map +1 -1
  220. package/dist/scripts/run-dsl-standalone-live.js +1 -1
  221. package/dist/scripts/run-dsl-standalone-live.js.map +1 -1
  222. package/dist/scripts/run-dsl-standalone-mock.js +1 -1
  223. package/dist/scripts/run-dsl-standalone-mock.js.map +1 -1
  224. package/dist/senpi/client.d.ts +27 -2
  225. package/dist/senpi/client.d.ts.map +1 -1
  226. package/dist/senpi/client.js +74 -1
  227. package/dist/senpi/client.js.map +1 -1
  228. package/dist/senpi/index.d.ts +1 -1
  229. package/dist/senpi/index.d.ts.map +1 -1
  230. package/dist/senpi/types.d.ts +68 -0
  231. package/dist/senpi/types.d.ts.map +1 -1
  232. package/dist/strategy/strategy-state.d.ts +4 -1
  233. package/dist/strategy/strategy-state.d.ts.map +1 -1
  234. package/dist/strategy/strategy-state.js +7 -2
  235. package/dist/strategy/strategy-state.js.map +1 -1
  236. package/dist/tracking/constants.d.ts +24 -0
  237. package/dist/tracking/constants.d.ts.map +1 -0
  238. package/dist/tracking/constants.js +46 -0
  239. package/dist/tracking/constants.js.map +1 -0
  240. package/dist/tracking/index.d.ts +12 -0
  241. package/dist/tracking/index.d.ts.map +1 -0
  242. package/dist/tracking/index.js +8 -0
  243. package/dist/tracking/index.js.map +1 -0
  244. package/dist/tracking/tracker.d.ts +22 -0
  245. package/dist/tracking/tracker.d.ts.map +1 -0
  246. package/dist/tracking/tracker.js +44 -0
  247. package/dist/tracking/tracker.js.map +1 -0
  248. package/dist/tracking/tracking-handler.d.ts +12 -0
  249. package/dist/tracking/tracking-handler.d.ts.map +1 -0
  250. package/dist/tracking/tracking-handler.js +148 -0
  251. package/dist/tracking/tracking-handler.js.map +1 -0
  252. package/dist/tracking/transport.d.ts +35 -0
  253. package/dist/tracking/transport.d.ts.map +1 -0
  254. package/dist/tracking/transport.js +117 -0
  255. package/dist/tracking/transport.js.map +1 -0
  256. package/dist/tracking/types.d.ts +21 -0
  257. package/dist/tracking/types.d.ts.map +1 -0
  258. package/dist/tracking/types.js +6 -0
  259. package/dist/tracking/types.js.map +1 -0
  260. package/dist/types/action.d.ts +13 -2
  261. package/dist/types/action.d.ts.map +1 -1
  262. package/dist/types/dsl/index.d.ts +3 -0
  263. package/dist/types/dsl/index.d.ts.map +1 -1
  264. package/dist/types/strategy.d.ts +9 -3
  265. package/dist/types/strategy.d.ts.map +1 -1
  266. package/dist/utils/logger.d.ts +1 -0
  267. package/dist/utils/logger.d.ts.map +1 -1
  268. package/dist/utils/logger.js +19 -1
  269. package/dist/utils/logger.js.map +1 -1
  270. package/dist/utils/resolve-order-type.d.ts +5 -0
  271. package/dist/utils/resolve-order-type.d.ts.map +1 -0
  272. package/dist/utils/resolve-order-type.js +29 -0
  273. package/dist/utils/resolve-order-type.js.map +1 -0
  274. package/examples/strategies/dsl-showcase.yaml +7 -2
  275. package/examples/strategies/dsl.yaml +5 -1
  276. package/examples/strategies/fox-minimal-loosened.yaml +18 -3
  277. package/examples/strategies/fox-minimal.yaml +25 -3
  278. package/examples/strategies/minimal.yaml +4 -2
  279. package/examples/strategies/momentum/how-it-works.md +47 -0
  280. package/examples/strategies/momentum/momentum-guarded.yaml +161 -0
  281. package/examples/strategies/risk-showcase.yaml +93 -0
  282. package/examples/strategies/viper.yaml +11 -3
  283. package/examples/strategies/wolf.yaml +11 -3
  284. package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +12 -4
  285. package/package.json +4 -4
@@ -11,9 +11,8 @@ description: > #required
11
11
  # ── STRATEGY ──
12
12
  strategy: #required
13
13
  wallet: "0x71ce3f0e27c178cbdcf01c4d068278034df75fbc"
14
- budget: "100"
15
14
  slots: 3
16
- margin_per_slot: 150
15
+ margin_pct: 10
17
16
  trading_risk: aggressive
18
17
  enabled: true
19
18
 
@@ -36,7 +35,12 @@ actions: #required
36
35
  decision_mode: llm #required
37
36
  decision_model: claude-sonnet-4-6 #required
38
37
  scanners: [emerging_movers] #required
39
- min_confidence: 2 #required
38
+ min_confidence: 2 #required
39
+ params:
40
+ order_type: FEE_OPTIMIZED_LIMIT
41
+ fee_optimized_limit_options:
42
+ ensure_execution_as_taker: true
43
+ execution_timeout_seconds: 15
40
44
  context: #optional
41
45
  - type: signal
42
46
  value: emerging_movers
@@ -84,7 +88,7 @@ actions: #required
84
88
  "reasoning": "one sentence",
85
89
  "payload": {
86
90
  "signals": [
87
- { "asset": "<coin_ticker>", "direction": "LONG" or "SHORT", "reason": "one sentence", "rotate_out": "<asset_to_cut>" }
91
+ { "asset": "<coin_ticker>", "direction": "LONG" or "SHORT", "reason": "one sentence", "rotate_out": "<asset_to_cut>", "leverage": "<optional number>", "margin": "<optional $ amount>" }
88
92
  ]
89
93
  }
90
94
  }
@@ -94,6 +98,10 @@ actions: #required
94
98
  exit: #required
95
99
  engine: dsl
96
100
  interval_seconds: 30
101
+ order_type: FEE_OPTIMIZED_LIMIT
102
+ fee_optimized_limit_options:
103
+ ensure_execution_as_taker: true
104
+ execution_timeout_seconds: 15
97
105
  dsl_preset:
98
106
  phase1:
99
107
  enabled: true
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@senpi/runtime",
3
- "version": "1.0.95-dev.feat-dsl-backend-int.20260416023008",
3
+ "version": "1.0.95-dev.runtime-phase-2.20260416194608",
4
4
  "description": "Senpi runtime plugin for OpenClaw",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -29,11 +29,11 @@
29
29
  },
30
30
  "dependencies": {
31
31
  "@anthropic-ai/sdk": "^0.39.0",
32
- "dotenv": "^16.4.5",
33
32
  "@modelcontextprotocol/sdk": "^1.0.0",
34
- "zod": "^3.23.0",
33
+ "dotenv": "^16.4.5",
35
34
  "mcporter": "^0.7.3",
36
- "yaml": "^2.8.0"
35
+ "yaml": "^2.8.0",
36
+ "zod": "^3.23.0"
37
37
  },
38
38
  "peerDependencies": {
39
39
  "openclaw": ">=2026.2.0"