@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
@@ -1,4 +1,22 @@
1
- import type { McpTransport, SenpiClientConfig, CreatePositionRequest, CreatePositionResult, EditPositionResult, GetPositionResult, OpenPosition, GetStrategyResult, GetOpenOrdersResult, GetTraderHistoryOptions, TraderHistoryEntry, StrategyFundResult, ClosePositionsRequest, GetPnlHistoryOptions, ListStrategiesFilters, StrategySummary, RatchetStopPosition, RatchetStopEvent, AddRatchetStopInput, EditRatchetStopInput, DeleteRatchetStopInput, QueryRatchetStopsInput, QueryRatchetStopEventsInput } from './types.js';
1
+ import type { McpTransport, SenpiClientConfig, CreatePositionRequest, CreatePositionResult, EditPositionResult, GetPositionResult, OpenPosition, GetStrategyResult, GetOpenOrdersResult, GetTraderHistoryOptions, TraderHistoryEntry, GetTraderStateOptions, TraderStateResult, StrategyFundResult, ClosePositionsRequest, GetPnlHistoryOptions, ListStrategiesFilters, StrategySummary, RatchetStopPosition, RatchetStopEvent, AddRatchetStopInput, EditRatchetStopInput, DeleteRatchetStopInput, QueryRatchetStopsInput, QueryRatchetStopEventsInput } from './types.js';
2
+ /**
3
+ * Typed error thrown by `SenpiClient` mutation methods when the response
4
+ * reports a failure at either layer (outer MCP envelope or inner engine
5
+ * result). Callers that today only catch `throw` will fire on real
6
+ * failures instead of silently treating phantom-success responses as
7
+ * success — preventing the orphaned-DSL-state class of bug.
8
+ *
9
+ * Codes:
10
+ * - `UNEXPECTED_RESPONSE` — response shape is not the expected object.
11
+ * - `UPSTREAM_ERROR` — outer MCP envelope `success === false`.
12
+ * - `ENGINE_FAILURE` — outer envelope ok, but inner engine result
13
+ * reported `success === false` (e.g. CREATE_ORDER_RESTING).
14
+ */
15
+ export declare class SenpiClientError extends Error {
16
+ readonly code: "UNEXPECTED_RESPONSE" | "UPSTREAM_ERROR" | "ENGINE_FAILURE";
17
+ readonly details: unknown;
18
+ constructor(code: "UNEXPECTED_RESPONSE" | "UPSTREAM_ERROR" | "ENGINE_FAILURE", message: string, details?: unknown);
19
+ }
2
20
  export declare class SenpiClient {
3
21
  private readonly injectedTransport;
4
22
  private readonly config;
@@ -10,6 +28,27 @@ export declare class SenpiClient {
10
28
  connect(): Promise<void>;
11
29
  disconnect(): Promise<void>;
12
30
  private callTool;
31
+ /**
32
+ * Run an MCP `audit_query` and return the unwrapped response payload.
33
+ *
34
+ * Stays a thin pass-through so the runtime layer (which owns the
35
+ * wallet→strategyId resolution and error mapping) can compose the call
36
+ * with full type-safety. Callers must already have set
37
+ * `resource_type` / `resource_id` if scoping is desired — this method
38
+ * does not interpret arguments.
39
+ *
40
+ * @param args Arbitrary key/value map forwarded verbatim as the MCP
41
+ * tool input. Caller is responsible for matching the
42
+ * MCP `audit_query` schema.
43
+ * @param opts Optional AbortSignal; when fired, the underlying MCP
44
+ * `callTool` is cancelled (the SDK rejects with an
45
+ * AbortError).
46
+ * @returns The `.data` field of the MCP envelope when present;
47
+ * otherwise the raw response.
48
+ */
49
+ auditQuery(args: Record<string, unknown>, opts?: {
50
+ signal?: AbortSignal;
51
+ }): Promise<unknown>;
13
52
  /**
14
53
  * Returns an adapter compatible with SenpiToolClient so the same connection
15
54
  * can be used for scanner provider MCP tool calls (e.g. leaderboard_get_markets).
@@ -17,14 +56,36 @@ export declare class SenpiClient {
17
56
  asToolClient(): {
18
57
  callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
19
58
  };
59
+ /**
60
+ * Register a backend ratchet-stop (DSL Phase 2 handoff).
61
+ *
62
+ * Throws `SenpiClientError` on outer envelope failure or inner engine
63
+ * `success: false`. Callers' existing `if (result.success && result.position)`
64
+ * branches now treat the success path only — failures land in the
65
+ * surrounding try/catch instead of falling through.
66
+ */
20
67
  addRatchetStop(input: AddRatchetStopInput): Promise<{
21
68
  success: boolean;
22
69
  position?: RatchetStopPosition;
23
70
  }>;
71
+ /**
72
+ * Update an existing backend ratchet-stop.
73
+ *
74
+ * Throws `SenpiClientError` on outer envelope failure or inner engine
75
+ * `success: false`.
76
+ */
24
77
  editRatchetStop(input: EditRatchetStopInput): Promise<{
25
78
  success: boolean;
26
79
  position?: RatchetStopPosition;
27
80
  }>;
81
+ /**
82
+ * Delete a backend ratchet-stop. Used during DSL teardown / handoff close.
83
+ *
84
+ * Throws `SenpiClientError` on outer envelope failure or inner engine
85
+ * `success: false`. Previously this method's `{ success: boolean }` return
86
+ * was ignored by every caller (only `throw` was caught), which left
87
+ * zombie ratchet-stops on the backend when the engine reported failure.
88
+ */
28
89
  deleteRatchetStop(input: DeleteRatchetStopInput): Promise<{
29
90
  success: boolean;
30
91
  }>;
@@ -44,6 +105,21 @@ export declare class SenpiClient {
44
105
  * Set/update SL (and optionally TP) on an open position. Uses MCP edit_position.
45
106
  * For XYZ DEX pass dex: "xyz" so coin is sent as "xyz:COIN"; otherwise main DEX uses plain coin.
46
107
  */
108
+ /**
109
+ * Set / update an exchange-side stop loss (or perform other position
110
+ * edits) on an open position.
111
+ *
112
+ * Throws `SenpiClientError` when either response layer reports failure:
113
+ * - `UPSTREAM_ERROR` — MCP envelope `success: false`.
114
+ * - `ENGINE_FAILURE` — outer ok, inner engine `success: false`
115
+ * (e.g. position not found, SL placement rejected).
116
+ *
117
+ * Returning normally means the engine accepted the edit. The returned
118
+ * `EditPositionResult` carries `slOrderId` when an SL was placed/updated;
119
+ * a `null` slOrderId on a non-throwing return indicates the engine reported
120
+ * success without the expected SL artifact — caller should treat that as
121
+ * a soft failure (logged as a warn) and re-attempt on the next sync tick.
122
+ */
47
123
  editPosition(wallet: string, payload: {
48
124
  coin: string;
49
125
  dex?: string;
@@ -85,6 +161,8 @@ export declare class SenpiClient {
85
161
  closePosition(wallet: string, coin: string, params: {
86
162
  reason: string;
87
163
  dex?: string;
164
+ orderType?: import("./types.js").CloseOrderType;
165
+ feeOptimizedLimitOptions?: import("./types.js").FeeOptimizedLimitOptions;
88
166
  }): Promise<unknown>;
89
167
  /**
90
168
  * List open positions for reconciliation by parsing `strategy_get_clearinghouse_state` (same source as
@@ -95,12 +173,30 @@ export declare class SenpiClient {
95
173
  getStrategy(wallet: string): Promise<GetStrategyResult | null>;
96
174
  listStrategies(filters?: ListStrategiesFilters): Promise<StrategySummary[]>;
97
175
  getOpenOrders(wallet: string): Promise<GetOpenOrdersResult[]>;
176
+ /**
177
+ * Closed-position history from MCP `discovery_get_trader_history`.
178
+ * Parsed `openTime` and `closedTime` are Unix epoch **seconds** (same as MCP `openTime` / `closeTime`).
179
+ */
98
180
  getTraderHistory(wallet: string, opts?: GetTraderHistoryOptions): Promise<TraderHistoryEntry[]>;
99
181
  topUp(wallet: string, amount: number): Promise<StrategyFundResult>;
100
182
  withdrawFunds(wallet: string, amount: number): Promise<StrategyFundResult>;
101
183
  closeStrategy(wallet: string): Promise<StrategyFundResult>;
102
- closePositions(wallet: string, positions: ClosePositionsRequest[]): Promise<unknown>;
103
- cancelOrder(wallet: string, orderId: number): Promise<unknown>;
184
+ /**
185
+ * Submit a batch close_positions MCP call.
186
+ *
187
+ * Throws `SenpiClientError` on outer envelope or inner engine failure
188
+ * (same shape as {@link closePosition}). Successful return means the
189
+ * batch was accepted; per-position confirmation must still come from
190
+ * position-tracker scanner events.
191
+ */
192
+ closePositions(wallet: string, positions: ClosePositionsRequest[]): Promise<Record<string, unknown>>;
193
+ /**
194
+ * Cancel an outstanding order by id.
195
+ *
196
+ * Throws `SenpiClientError` on outer envelope or inner engine failure
197
+ * (same shape as {@link closePosition}).
198
+ */
199
+ cancelOrder(wallet: string, orderId: number): Promise<Record<string, unknown>>;
104
200
  getAssetTradingLimits(wallet: string, coin: string, dex?: string): Promise<{
105
201
  maxLeverage: number;
106
202
  } | null>;
@@ -108,6 +204,29 @@ export declare class SenpiClient {
108
204
  name: string;
109
205
  maxLeverage: number;
110
206
  }>>;
111
- getPnlHistory(wallet: string, opts?: GetPnlHistoryOptions): Promise<unknown>;
207
+ /**
208
+ * Fetch PnL and account value history plus the today_snapshot (UTC-day-scoped metrics)
209
+ * via MCP `strategy_get_pnl_and_account_value_history`.
210
+ *
211
+ * Returns `history_by_period` (perpDay, perpWeek, perpMonth, perpAllTime) and a
212
+ * `today_snapshot` with derived pnl, account_value, and drawdown metrics for the current
213
+ * UTC calendar day. today_snapshot is absent if perpDay data is unavailable.
214
+ *
215
+ * @param wallet - Strategy wallet address (42-char hex).
216
+ * @param opts.drawdownResetOnDayRollover - When false, PnL peak carries from pre-midnight (~24h).
217
+ * Default true resets at UTC midnight (intraday drawdown only).
218
+ */
219
+ getPnlHistoryWithSnapshot(wallet: string, opts?: GetPnlHistoryOptions): Promise<unknown>;
220
+ /**
221
+ * Fetch current state for a single wallet via MCP `discovery_get_trader_state`.
222
+ *
223
+ * When opts.includePositionAge is true, each open position includes startTime
224
+ * (Unix seconds, ClickHouse) and durationInSeconds. Required for Gate 5
225
+ * (max entries/day) to count positions opened today.
226
+ *
227
+ * Returns null when the MCP response is missing or the trader is not found.
228
+ * Callers implementing fail-closed gates must treat null as a CLOSED signal.
229
+ */
230
+ getTraderState(wallet: string, opts?: GetTraderStateOptions): Promise<TraderStateResult | null>;
112
231
  }
113
232
  //# sourceMappingURL=client.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/senpi/client.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EAGpB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AA2BpB,qBAAa,WAAW;IAEtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsB;IAGxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,SAAS,CAAuB;IAExC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAuC;IAG9E,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAK;IAC3C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAEnC,iBAAiB,EAAE,YAAY,GAAG,iBAAiB;IAUzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAYnB,QAAQ;IAwBtB;;;OAGG;IACH,YAAY,IAAI;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE;IAQrF,cAAc,CAClB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAQ1D,eAAe,CACnB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAQ1D,iBAAiB,CACrB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAQ1B,iBAAiB,CACrB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAY3B,sBAAsB,CAC1B,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAY9B,OAAO,CAAC,uBAAuB;IAWzB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAYnF;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAiBzG;;;OAGG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GACxE,OAAO,CAAC,kBAAkB,CAAC;IA8CxB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAS3F;;;;;;OAMG;IACG,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IA6BpF;;;OAGG;YACW,2BAA2B;IA0BzC,qCAAqC;IACrC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAMhG;;OAEG;IACG,qBAAqB,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAalE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAS7G;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkB1D,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAmB9D,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAuB3E,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAgB7D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAyB/F,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOlE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAO1E,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAO1D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO9D,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAiB1G,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAmBxE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;CAKnF"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/senpi/client.ts"],"names":[],"mappings":"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"}
@@ -6,6 +6,99 @@ import { extractMinClearingHouseTime, createClearingHouseStalenessGuard } from "
6
6
  import { normalizeDslCoinDex, reconcileDexFromClearingHouseKey } from "../utils/perp-coin.js";
7
7
  import { createLogger } from "../utils/logger.js";
8
8
  const logger = createLogger("[senpi][client]");
9
+ /**
10
+ * Typed error thrown by `SenpiClient` mutation methods when the response
11
+ * reports a failure at either layer (outer MCP envelope or inner engine
12
+ * result). Callers that today only catch `throw` will fire on real
13
+ * failures instead of silently treating phantom-success responses as
14
+ * success — preventing the orphaned-DSL-state class of bug.
15
+ *
16
+ * Codes:
17
+ * - `UNEXPECTED_RESPONSE` — response shape is not the expected object.
18
+ * - `UPSTREAM_ERROR` — outer MCP envelope `success === false`.
19
+ * - `ENGINE_FAILURE` — outer envelope ok, but inner engine result
20
+ * reported `success === false` (e.g. CREATE_ORDER_RESTING).
21
+ */
22
+ export class SenpiClientError extends Error {
23
+ code;
24
+ details;
25
+ constructor(code, message, details) {
26
+ super(message);
27
+ this.name = "SenpiClientError";
28
+ this.code = code;
29
+ this.details = details;
30
+ }
31
+ }
32
+ /**
33
+ * Best-effort engine error message extraction. Mirrors the resolver used
34
+ * inside the MCP server's mutation handlers (Task 2 fix shape) so DSL/
35
+ * action logs surface the same string the operator sees in audit logs.
36
+ */
37
+ function extractEngineMessage(data) {
38
+ const err = data.error;
39
+ if (err && typeof err === "object") {
40
+ const errObj = err;
41
+ const description = typeof errObj.description === "string" ? errObj.description : undefined;
42
+ const errMessage = typeof errObj.message === "string" ? errObj.message : undefined;
43
+ const errCode = typeof errObj.code === "string" ? errObj.code : undefined;
44
+ const text = description ?? errMessage;
45
+ if (text && errCode)
46
+ return `${errCode}: ${text}`;
47
+ if (text)
48
+ return text;
49
+ if (errCode)
50
+ return errCode;
51
+ }
52
+ else if (typeof err === "string" && err.length > 0) {
53
+ return err;
54
+ }
55
+ if (typeof data.message === "string" && data.message.length > 0)
56
+ return data.message;
57
+ if (typeof data.errorCode === "string" && data.errorCode.length > 0)
58
+ return data.errorCode;
59
+ return "Trading engine reported failure";
60
+ }
61
+ /**
62
+ * Enforces success at both response layers and returns the unwrapped
63
+ * inner data. Throws `SenpiClientError` on any reported failure.
64
+ *
65
+ * Resolution order:
66
+ * 1. `raw` is not an object → `UNEXPECTED_RESPONSE`.
67
+ * 2. Outer envelope `success === false` → `UPSTREAM_ERROR` with the
68
+ * envelope's error.code / error.message preserved.
69
+ * 3. Unwrap envelope to inner data; if not an object → `UNEXPECTED_RESPONSE`.
70
+ * 4. Inner data carries a boolean `success === false` → `ENGINE_FAILURE`
71
+ * with a best-effort engine message.
72
+ * 5. Otherwise return the inner data.
73
+ *
74
+ * Used by every mutation method (createPosition, editPosition,
75
+ * closePosition, etc.) so DSL/actions can rely on `throw` semantics
76
+ * matching real failures, instead of trusting an outer-envelope-only
77
+ * "success" that may mask an engine rejection.
78
+ */
79
+ function requireMutationSuccess(tool, raw) {
80
+ if (!isRecord(raw)) {
81
+ throw new SenpiClientError("UNEXPECTED_RESPONSE", `${tool}: response is not an object`, raw);
82
+ }
83
+ // Outer envelope check — only present on direct MCP responses.
84
+ if (raw.success === false) {
85
+ const errObj = isRecord(raw.error) ? raw.error : undefined;
86
+ const code = (errObj && typeof errObj.code === "string") ? errObj.code : "UPSTREAM_ERROR";
87
+ const message = (errObj && typeof errObj.message === "string")
88
+ ? errObj.message
89
+ : `${tool}: outer envelope reported failure`;
90
+ throw new SenpiClientError("UPSTREAM_ERROR", `${tool}: ${code}: ${message}`, raw);
91
+ }
92
+ const data = unwrapEnvelope(raw) ?? raw;
93
+ if (!isRecord(data)) {
94
+ throw new SenpiClientError("UNEXPECTED_RESPONSE", `${tool}: inner data is not an object`, raw);
95
+ }
96
+ // Inner engine-level success check (only when the field is explicitly boolean).
97
+ if (typeof data.success === "boolean" && data.success === false) {
98
+ throw new SenpiClientError("ENGINE_FAILURE", `${tool}: ${extractEngineMessage(data)}`, data);
99
+ }
100
+ return data;
101
+ }
9
102
  /**
10
103
  * execution_get_order_status payloads vary: flat `{ filled, status }` vs Hyperliquid-style
11
104
  * `{ status: "order", order: { status: "filled", order: {...} } }`. Top-level `status` may be a
@@ -34,6 +127,38 @@ function parseExecutionOrderFilled(obj) {
34
127
  }
35
128
  return false;
36
129
  }
130
+ /** MCP `createErrorResponse.error` or trading-engine `ClosePosition.error` (code + message/description). */
131
+ function formatSenpiCloseFailureError(error) {
132
+ if (error == null)
133
+ return "";
134
+ if (typeof error === "string")
135
+ return error;
136
+ if (!isRecord(error))
137
+ return JSON.stringify(error);
138
+ const code = asString(error.code) ?? "unknown";
139
+ const msg = asString(error.message) ??
140
+ asString(error.description) ??
141
+ (typeof error.details === "string" ? error.details : "");
142
+ return msg ? `${code}: ${msg}` : code;
143
+ }
144
+ /**
145
+ * close_position must not be treated as success when the MCP envelope or trading-engine payload
146
+ * reports failure (Senpi MCP returns `{ success, data }` with engine outcome under `data`).
147
+ */
148
+ function assertClosePositionSucceeded(raw, ctx) {
149
+ if (!isRecord(raw)) {
150
+ throw new Error(`close_position: expected object response for ${ctx.coin} (${ctx.wallet})`);
151
+ }
152
+ const hasData = "data" in raw;
153
+ if (raw.success === false && (!hasData || raw.data == null)) {
154
+ throw new Error(`close_position failed (${ctx.wallet} ${ctx.coin}): ${formatSenpiCloseFailureError(raw.error) || "unknown error"}`);
155
+ }
156
+ const payload = unwrapEnvelope(raw) ?? raw;
157
+ if (isRecord(payload) && payload.success === false) {
158
+ const detail = formatSenpiCloseFailureError(payload.error);
159
+ throw new Error(`close_position rejected (${ctx.wallet} ${ctx.coin}): ${detail || "success=false"}`);
160
+ }
161
+ }
37
162
  export class SenpiClient {
38
163
  // Injected mode
39
164
  injectedTransport;
@@ -93,7 +218,7 @@ export class SenpiClient {
93
218
  this.mcpClient = null;
94
219
  }
95
220
  }
96
- async callTool(toolName, args) {
221
+ async callTool(toolName, args, opts) {
97
222
  // Injected mode: delegate directly
98
223
  if (this.injectedTransport) {
99
224
  return this.injectedTransport(toolName, args);
@@ -102,7 +227,9 @@ export class SenpiClient {
102
227
  if (!this.mcpClient) {
103
228
  throw new Error('SenpiClient not connected — call connect() first');
104
229
  }
105
- const result = await this.mcpClient.callTool({ name: toolName, arguments: args });
230
+ const result = opts?.signal
231
+ ? await this.mcpClient.callTool({ name: toolName, arguments: args }, undefined, { signal: opts.signal })
232
+ : await this.mcpClient.callTool({ name: toolName, arguments: args });
106
233
  if (result.content && Array.isArray(result.content) && result.content.length > 0) {
107
234
  const part = result.content[0];
108
235
  if (part && 'text' in part && typeof part.text === 'string') {
@@ -116,6 +243,28 @@ export class SenpiClient {
116
243
  }
117
244
  return result;
118
245
  }
246
+ /**
247
+ * Run an MCP `audit_query` and return the unwrapped response payload.
248
+ *
249
+ * Stays a thin pass-through so the runtime layer (which owns the
250
+ * wallet→strategyId resolution and error mapping) can compose the call
251
+ * with full type-safety. Callers must already have set
252
+ * `resource_type` / `resource_id` if scoping is desired — this method
253
+ * does not interpret arguments.
254
+ *
255
+ * @param args Arbitrary key/value map forwarded verbatim as the MCP
256
+ * tool input. Caller is responsible for matching the
257
+ * MCP `audit_query` schema.
258
+ * @param opts Optional AbortSignal; when fired, the underlying MCP
259
+ * `callTool` is cancelled (the SDK rejects with an
260
+ * AbortError).
261
+ * @returns The `.data` field of the MCP envelope when present;
262
+ * otherwise the raw response.
263
+ */
264
+ async auditQuery(args, opts) {
265
+ const raw = await this.callTool('audit_query', args, opts);
266
+ return unwrapEnvelope(raw) ?? raw;
267
+ }
119
268
  /**
120
269
  * Returns an adapter compatible with SenpiToolClient so the same connection
121
270
  * can be used for scanner provider MCP tool calls (e.g. leaderboard_get_markets).
@@ -126,26 +275,48 @@ export class SenpiClient {
126
275
  };
127
276
  }
128
277
  // ─── Ratchet stop (DSL backend engine) ──────────────────────────────────────
278
+ /**
279
+ * Register a backend ratchet-stop (DSL Phase 2 handoff).
280
+ *
281
+ * Throws `SenpiClientError` on outer envelope failure or inner engine
282
+ * `success: false`. Callers' existing `if (result.success && result.position)`
283
+ * branches now treat the success path only — failures land in the
284
+ * surrounding try/catch instead of falling through.
285
+ */
129
286
  async addRatchetStop(input) {
130
287
  const raw = await this.callTool("ratchet_stop_add", {
131
288
  ...input,
132
289
  asset: dexQualifiedAsset(input.asset, input.dex),
133
290
  });
134
- return this.unwrapRatchetStopResult(raw, "ratchet_stop_add");
291
+ return requireMutationSuccess("ratchet_stop_add", raw);
135
292
  }
293
+ /**
294
+ * Update an existing backend ratchet-stop.
295
+ *
296
+ * Throws `SenpiClientError` on outer envelope failure or inner engine
297
+ * `success: false`.
298
+ */
136
299
  async editRatchetStop(input) {
137
300
  const raw = await this.callTool("ratchet_stop_edit", {
138
301
  ...input,
139
302
  asset: dexQualifiedAsset(input.asset, input.dex),
140
303
  });
141
- return this.unwrapRatchetStopResult(raw, "ratchet_stop_edit");
304
+ return requireMutationSuccess("ratchet_stop_edit", raw);
142
305
  }
306
+ /**
307
+ * Delete a backend ratchet-stop. Used during DSL teardown / handoff close.
308
+ *
309
+ * Throws `SenpiClientError` on outer envelope failure or inner engine
310
+ * `success: false`. Previously this method's `{ success: boolean }` return
311
+ * was ignored by every caller (only `throw` was caught), which left
312
+ * zombie ratchet-stops on the backend when the engine reported failure.
313
+ */
143
314
  async deleteRatchetStop(input) {
144
315
  const raw = await this.callTool("ratchet_stop_delete", {
145
316
  ...input,
146
317
  asset: dexQualifiedAsset(input.asset, input.dex),
147
318
  });
148
- return this.unwrapRatchetStopResult(raw, "ratchet_stop_delete");
319
+ return requireMutationSuccess("ratchet_stop_delete", raw);
149
320
  }
150
321
  async queryRatchetStops(input) {
151
322
  const qualifiedAsset = input.asset ? dexQualifiedAsset(input.asset, input.dex) : undefined;
@@ -215,6 +386,21 @@ export class SenpiClient {
215
386
  * Set/update SL (and optionally TP) on an open position. Uses MCP edit_position.
216
387
  * For XYZ DEX pass dex: "xyz" so coin is sent as "xyz:COIN"; otherwise main DEX uses plain coin.
217
388
  */
389
+ /**
390
+ * Set / update an exchange-side stop loss (or perform other position
391
+ * edits) on an open position.
392
+ *
393
+ * Throws `SenpiClientError` when either response layer reports failure:
394
+ * - `UPSTREAM_ERROR` — MCP envelope `success: false`.
395
+ * - `ENGINE_FAILURE` — outer ok, inner engine `success: false`
396
+ * (e.g. position not found, SL placement rejected).
397
+ *
398
+ * Returning normally means the engine accepted the edit. The returned
399
+ * `EditPositionResult` carries `slOrderId` when an SL was placed/updated;
400
+ * a `null` slOrderId on a non-throwing return indicates the engine reported
401
+ * success without the expected SL artifact — caller should treat that as
402
+ * a soft failure (logged as a warn) and re-attempt on the next sync tick.
403
+ */
218
404
  async editPosition(wallet, payload) {
219
405
  const coin = payload.dex === "xyz" && payload.coin && !payload.coin.startsWith("xyz:")
220
406
  ? `xyz:${payload.coin}`
@@ -234,7 +420,10 @@ export class SenpiClient {
234
420
  rawKeys: isRecord(raw) ? Object.keys(raw) : [],
235
421
  rawShape: isRecord(raw) ? JSON.stringify(raw).slice(0, 500) : String(raw),
236
422
  });
237
- const result = (unwrapEnvelope(raw) ?? raw);
423
+ // Throws on outer/inner success: false. Returning means the engine
424
+ // accepted the edit. Older callers that only catch `throw` will now
425
+ // see real failures instead of silently treating them as success.
426
+ const result = requireMutationSuccess("edit_position", raw);
238
427
  if (result && typeof result === "object" && !Array.isArray(result)) {
239
428
  const ro = result;
240
429
  const slOrderId = extractSlOrderId(ro, raw);
@@ -356,11 +545,15 @@ export class SenpiClient {
356
545
  }
357
546
  async closePosition(wallet, coin, params) {
358
547
  const effectiveCoin = params.dex === "xyz" && coin && !coin.startsWith("xyz:") ? `xyz:${coin}` : coin;
359
- return this.callTool("close_position", {
548
+ const raw = await this.callTool("close_position", {
360
549
  strategyWalletAddress: wallet,
361
550
  coin: effectiveCoin,
362
551
  ...(params.reason ? { reason: params.reason } : {}),
552
+ ...(params.orderType ? { orderType: params.orderType } : {}),
553
+ ...(params.feeOptimizedLimitOptions ? { feeOptimizedLimitOptions: params.feeOptimizedLimitOptions } : {}),
363
554
  });
555
+ assertClosePositionSucceeded(raw, { wallet, coin: effectiveCoin });
556
+ return unwrapEnvelope(raw) ?? raw;
364
557
  }
365
558
  /**
366
559
  * List open positions for reconciliation by parsing `strategy_get_clearinghouse_state` (same source as
@@ -443,8 +636,12 @@ export class SenpiClient {
443
636
  timestamp: asNumber(o.timestamp) ?? 0,
444
637
  }));
445
638
  }
639
+ /**
640
+ * Closed-position history from MCP `discovery_get_trader_history`.
641
+ * Parsed `openTime` and `closedTime` are Unix epoch **seconds** (same as MCP `openTime` / `closeTime`).
642
+ */
446
643
  async getTraderHistory(wallet, opts) {
447
- const args = { traderAddress: wallet, latest: true };
644
+ const args = { trader_address: wallet, latest: true };
448
645
  if (opts?.limit != null)
449
646
  args.limit = opts.limit;
450
647
  if (opts?.offset != null)
@@ -455,17 +652,22 @@ export class SenpiClient {
455
652
  args.sort_direction = opts.sort_direction;
456
653
  const raw = await this.callTool("discovery_get_trader_history", args);
457
654
  const data = unwrapEnvelope(raw);
458
- const arr = Array.isArray(data) ? data : (isRecord(data) && Array.isArray(data.trades) ? data.trades : []);
655
+ const rec = isRecord(data) ? data : undefined;
656
+ const arr = Array.isArray(data) ? data : (rec && Array.isArray(rec.closed_positions) ? rec.closed_positions : []);
459
657
  return arr.filter(isRecord).map((t) => {
460
658
  const szi = asNumber(t.szi) ?? 0;
659
+ const dexRaw = asString(t.dex);
660
+ const typeStr = asString(t.type)?.toUpperCase() ?? "";
661
+ const direction = typeStr.includes("SHORT") ? "SHORT" : typeStr.includes("LONG") ? "LONG" : (szi >= 0 ? "LONG" : "SHORT");
461
662
  return {
462
663
  coin: asString(t.coin) ?? "",
463
- direction: (szi >= 0 ? "LONG" : "SHORT"),
664
+ ...(dexRaw ? { dex: dexRaw } : {}),
665
+ direction,
464
666
  entryPx: asNumber(t.entryPx) ?? 0,
465
- closePx: asNumber(t.closePx) ?? 0,
667
+ closePx: asNumber(t.exitPx) ?? 0,
466
668
  szi,
467
669
  realizedPnl: asNumber(t.realizedPnl) ?? 0,
468
- closedTime: asNumber(t.closedTime) ?? asNumber(t.closeTime) ?? 0,
670
+ closedTime: asNumber(t.closeTime) ?? 0,
469
671
  openTime: asNumber(t.openTime) ?? 0,
470
672
  totalFees: asNumber(t.totalFees) ?? 0,
471
673
  };
@@ -492,17 +694,33 @@ export class SenpiClient {
492
694
  return { success: false };
493
695
  return { success: data.success === true, message: asString(data.message) ?? undefined };
494
696
  }
697
+ /**
698
+ * Submit a batch close_positions MCP call.
699
+ *
700
+ * Throws `SenpiClientError` on outer envelope or inner engine failure
701
+ * (same shape as {@link closePosition}). Successful return means the
702
+ * batch was accepted; per-position confirmation must still come from
703
+ * position-tracker scanner events.
704
+ */
495
705
  async closePositions(wallet, positions) {
496
- return this.callTool("strategy_close_positions", {
706
+ const raw = await this.callTool("strategy_close_positions", {
497
707
  strategy_wallet: wallet,
498
708
  positions,
499
709
  });
710
+ return requireMutationSuccess("strategy_close_positions", raw);
500
711
  }
712
+ /**
713
+ * Cancel an outstanding order by id.
714
+ *
715
+ * Throws `SenpiClientError` on outer envelope or inner engine failure
716
+ * (same shape as {@link closePosition}).
717
+ */
501
718
  async cancelOrder(wallet, orderId) {
502
- return this.callTool("cancel_order", {
719
+ const raw = await this.callTool("cancel_order", {
503
720
  strategyWalletAddress: wallet,
504
721
  orderId,
505
722
  });
723
+ return requireMutationSuccess("cancel_order", raw);
506
724
  }
507
725
  async getAssetTradingLimits(wallet, coin, dex) {
508
726
  try {
@@ -545,12 +763,83 @@ export class SenpiClient {
545
763
  }
546
764
  return result;
547
765
  }
548
- async getPnlHistory(wallet, opts) {
766
+ /**
767
+ * Fetch PnL and account value history plus the today_snapshot (UTC-day-scoped metrics)
768
+ * via MCP `strategy_get_pnl_and_account_value_history`.
769
+ *
770
+ * Returns `history_by_period` (perpDay, perpWeek, perpMonth, perpAllTime) and a
771
+ * `today_snapshot` with derived pnl, account_value, and drawdown metrics for the current
772
+ * UTC calendar day. today_snapshot is absent if perpDay data is unavailable.
773
+ *
774
+ * @param wallet - Strategy wallet address (42-char hex).
775
+ * @param opts.drawdownResetOnDayRollover - When false, PnL peak carries from pre-midnight (~24h).
776
+ * Default true resets at UTC midnight (intraday drawdown only).
777
+ */
778
+ async getPnlHistoryWithSnapshot(wallet, opts) {
549
779
  const args = { strategy_wallet: wallet };
550
780
  if (opts?.period != null)
551
781
  args.period = opts.period;
782
+ if (opts?.drawdownResetOnDayRollover != null)
783
+ args.drawdown_reset_on_day_rollover = opts.drawdownResetOnDayRollover;
552
784
  return this.callTool("strategy_get_pnl_and_account_value_history", args);
553
785
  }
786
+ /**
787
+ * Fetch current state for a single wallet via MCP `discovery_get_trader_state`.
788
+ *
789
+ * When opts.includePositionAge is true, each open position includes startTime
790
+ * (Unix seconds, ClickHouse) and durationInSeconds. Required for Gate 5
791
+ * (max entries/day) to count positions opened today.
792
+ *
793
+ * Returns null when the MCP response is missing or the trader is not found.
794
+ * Callers implementing fail-closed gates must treat null as a CLOSED signal.
795
+ */
796
+ async getTraderState(wallet, opts) {
797
+ const raw = await this.callTool("discovery_get_trader_state", {
798
+ trader_addresses: [wallet],
799
+ include_position_age: opts?.includePositionAge ?? false,
800
+ latest: opts?.latest ?? true,
801
+ });
802
+ const data = unwrapEnvelope(raw);
803
+ if (!isRecord(data))
804
+ return null;
805
+ const tradersRaw = Array.isArray(data.traders) ? data.traders : [];
806
+ const traderRaw = tradersRaw[0] ?? data.trader;
807
+ if (!isRecord(traderRaw))
808
+ return null;
809
+ const openPositions = (Array.isArray(traderRaw.openPositions) ? traderRaw.openPositions : []).filter(isRecord).map((p) => {
810
+ const lev = isRecord(p.leverage) ? p.leverage : {};
811
+ return {
812
+ coin: asString(p.coin) ?? "",
813
+ szi: asString(p.szi) ?? "0",
814
+ entryPx: p.entryPx ?? "0",
815
+ positionValue: p.positionValue ?? "0",
816
+ unrealizedPnl: p.unrealizedPnl ?? "0",
817
+ leverage: { type: asString(lev.type) ?? "cross", value: asNumber(lev.value) ?? 0 },
818
+ marginUsed: p.marginUsed ?? "0",
819
+ returnOnEquity: p.returnOnEquity ?? null,
820
+ liquidationPx: p.liquidationPx ?? null,
821
+ startTime: typeof p.startTime === "number" ? p.startTime : null,
822
+ durationInSeconds: typeof p.durationInSeconds === "number" ? p.durationInSeconds : null,
823
+ };
824
+ });
825
+ const ms = isRecord(traderRaw.marginSummary) ? traderRaw.marginSummary : {};
826
+ const cms = isRecord(traderRaw.crossMarginSummary) ? traderRaw.crossMarginSummary : null;
827
+ const parseMs = (obj) => ({
828
+ accountValue: obj.accountValue ?? null,
829
+ totalMarginUsed: obj.totalMarginUsed ?? null,
830
+ totalNtlPos: obj.totalNtlPos ?? null,
831
+ totalRawUsd: obj.totalRawUsd ?? null,
832
+ });
833
+ return {
834
+ address: asString(traderRaw.address) ?? wallet,
835
+ openPositions,
836
+ openOrders: Array.isArray(traderRaw.openOrders) ? traderRaw.openOrders : [],
837
+ marginSummary: parseMs(ms),
838
+ crossMarginSummary: cms ? parseMs(cms) : null,
839
+ withdrawable: traderRaw.withdrawable ?? null,
840
+ marginPercentage: asNumber(traderRaw.marginPercentage) ?? null,
841
+ };
842
+ }
554
843
  }
555
844
  // ─── Response parsing ────────────────────────────────────────────────────────
556
845
  /**