@senpi-ai/runtime 1.1.3 → 3.0.4

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 (483) hide show
  1. package/README.md +10 -9
  2. package/dist/actions/action-runtime-module.d.ts.map +1 -1
  3. package/dist/actions/action-runtime-module.js +1 -1
  4. package/dist/actions/action-runtime-module.js.map +1 -1
  5. package/dist/actions/close-position/close-position.action.d.ts.map +1 -1
  6. package/dist/actions/close-position/close-position.action.js +61 -14
  7. package/dist/actions/close-position/close-position.action.js.map +1 -1
  8. package/dist/actions/decision-engine.d.ts.map +1 -1
  9. package/dist/actions/decision-engine.js +3 -0
  10. package/dist/actions/decision-engine.js.map +1 -1
  11. package/dist/actions/open-position/open-position.action.d.ts.map +1 -1
  12. package/dist/actions/open-position/open-position.action.js +155 -35
  13. package/dist/actions/open-position/open-position.action.js.map +1 -1
  14. package/dist/actions/open-position/resolve-margin.d.ts +18 -3
  15. package/dist/actions/open-position/resolve-margin.d.ts.map +1 -1
  16. package/dist/actions/open-position/resolve-margin.js +22 -9
  17. package/dist/actions/open-position/resolve-margin.js.map +1 -1
  18. package/dist/actions/position-tracker/position-tracker.action.d.ts +6 -0
  19. package/dist/actions/position-tracker/position-tracker.action.d.ts.map +1 -1
  20. package/dist/actions/position-tracker/position-tracker.action.js +48 -0
  21. package/dist/actions/position-tracker/position-tracker.action.js.map +1 -1
  22. package/dist/actions/tracking-helpers.d.ts +16 -1
  23. package/dist/actions/tracking-helpers.d.ts.map +1 -1
  24. package/dist/actions/tracking-helpers.js +55 -9
  25. package/dist/actions/tracking-helpers.js.map +1 -1
  26. package/dist/actions/types.d.ts +10 -2
  27. package/dist/actions/types.d.ts.map +1 -1
  28. package/dist/actions/types.js +8 -0
  29. package/dist/actions/types.js.map +1 -1
  30. package/dist/cli/guide-commands.d.ts.map +1 -1
  31. package/dist/cli/guide-commands.js +102 -82
  32. package/dist/cli/guide-commands.js.map +1 -1
  33. package/dist/cli/senpi-commands.d.ts.map +1 -1
  34. package/dist/cli/senpi-commands.js +16 -110
  35. package/dist/cli/senpi-commands.js.map +1 -1
  36. package/dist/constants/dsl/index.d.ts +2 -0
  37. package/dist/constants/dsl/index.d.ts.map +1 -1
  38. package/dist/constants/dsl/index.js +2 -0
  39. package/dist/constants/dsl/index.js.map +1 -1
  40. package/dist/dsl/config/parse-tiers.d.ts.map +1 -1
  41. package/dist/dsl/config/parse-tiers.js +6 -2
  42. package/dist/dsl/config/parse-tiers.js.map +1 -1
  43. package/dist/dsl/engine-client/config-mapping.d.ts +3 -1
  44. package/dist/dsl/engine-client/config-mapping.d.ts.map +1 -1
  45. package/dist/dsl/engine-client/config-mapping.js +3 -1
  46. package/dist/dsl/engine-client/config-mapping.js.map +1 -1
  47. package/dist/dsl/engine-client/event-mapping.d.ts +2 -0
  48. package/dist/dsl/engine-client/event-mapping.d.ts.map +1 -1
  49. package/dist/dsl/engine-client/event-mapping.js +3 -0
  50. package/dist/dsl/engine-client/event-mapping.js.map +1 -1
  51. package/dist/dsl/events/build-closed-event.d.ts.map +1 -1
  52. package/dist/dsl/events/build-closed-event.js +1 -0
  53. package/dist/dsl/events/build-closed-event.js.map +1 -1
  54. package/dist/dsl/events/guards.d.ts.map +1 -1
  55. package/dist/dsl/events/guards.js +10 -0
  56. package/dist/dsl/events/guards.js.map +1 -1
  57. package/dist/dsl/events/handlers.d.ts +18 -2
  58. package/dist/dsl/events/handlers.d.ts.map +1 -1
  59. package/dist/dsl/events/handlers.js +304 -208
  60. package/dist/dsl/events/handlers.js.map +1 -1
  61. package/dist/dsl/events/initial-state.d.ts.map +1 -1
  62. package/dist/dsl/events/initial-state.js +3 -1
  63. package/dist/dsl/events/initial-state.js.map +1 -1
  64. package/dist/dsl/monitor/create-monitor.d.ts +15 -0
  65. package/dist/dsl/monitor/create-monitor.d.ts.map +1 -1
  66. package/dist/dsl/monitor/create-monitor.js +76 -9
  67. package/dist/dsl/monitor/create-monitor.js.map +1 -1
  68. package/dist/dsl/monitor/process-one-position.d.ts.map +1 -1
  69. package/dist/dsl/monitor/process-one-position.js +268 -82
  70. package/dist/dsl/monitor/process-one-position.js.map +1 -1
  71. package/dist/dsl/plugin/index.d.ts +16 -1
  72. package/dist/dsl/plugin/index.d.ts.map +1 -1
  73. package/dist/dsl/plugin/index.js +35 -4
  74. package/dist/dsl/plugin/index.js.map +1 -1
  75. package/dist/dsl/plugin/options.d.ts +18 -0
  76. package/dist/dsl/plugin/options.d.ts.map +1 -1
  77. package/dist/index.d.ts +14 -1
  78. package/dist/index.d.ts.map +1 -1
  79. package/dist/index.js +276 -32
  80. package/dist/index.js.map +1 -1
  81. package/dist/recording/emitter.d.ts +27 -0
  82. package/dist/recording/emitter.d.ts.map +1 -0
  83. package/dist/recording/emitter.js +2 -0
  84. package/dist/recording/emitter.js.map +1 -0
  85. package/dist/recording/identity.d.ts +34 -0
  86. package/dist/recording/identity.d.ts.map +1 -0
  87. package/dist/recording/identity.js +2 -0
  88. package/dist/recording/identity.js.map +1 -0
  89. package/dist/recording/index.d.ts +11 -0
  90. package/dist/recording/index.d.ts.map +1 -0
  91. package/dist/recording/index.js +2 -0
  92. package/dist/recording/index.js.map +1 -0
  93. package/dist/recording/noop-emitter.d.ts +23 -0
  94. package/dist/recording/noop-emitter.d.ts.map +1 -0
  95. package/dist/recording/noop-emitter.js +22 -0
  96. package/dist/recording/noop-emitter.js.map +1 -0
  97. package/dist/recording/otel/attributes.d.ts +35 -0
  98. package/dist/recording/otel/attributes.d.ts.map +1 -0
  99. package/dist/recording/otel/attributes.js +131 -0
  100. package/dist/recording/otel/attributes.js.map +1 -0
  101. package/dist/recording/otel/constants.d.ts +123 -0
  102. package/dist/recording/otel/constants.d.ts.map +1 -0
  103. package/dist/recording/otel/constants.js +172 -0
  104. package/dist/recording/otel/constants.js.map +1 -0
  105. package/dist/recording/otel/ids.d.ts +25 -0
  106. package/dist/recording/otel/ids.d.ts.map +1 -0
  107. package/dist/recording/otel/ids.js +37 -0
  108. package/dist/recording/otel/ids.js.map +1 -0
  109. package/dist/recording/otel/index.d.ts +13 -0
  110. package/dist/recording/otel/index.d.ts.map +1 -0
  111. package/dist/recording/otel/index.js +9 -0
  112. package/dist/recording/otel/index.js.map +1 -0
  113. package/dist/recording/otel/mappers.d.ts +100 -0
  114. package/dist/recording/otel/mappers.d.ts.map +1 -0
  115. package/dist/recording/otel/mappers.js +683 -0
  116. package/dist/recording/otel/mappers.js.map +1 -0
  117. package/dist/recording/otel/otel-emitter.d.ts +43 -0
  118. package/dist/recording/otel/otel-emitter.d.ts.map +1 -0
  119. package/dist/recording/otel/otel-emitter.js +99 -0
  120. package/dist/recording/otel/otel-emitter.js.map +1 -0
  121. package/dist/recording/otel/redaction.d.ts +47 -0
  122. package/dist/recording/otel/redaction.d.ts.map +1 -0
  123. package/dist/recording/otel/redaction.js +88 -0
  124. package/dist/recording/otel/redaction.js.map +1 -0
  125. package/dist/recording/records.d.ts +565 -0
  126. package/dist/recording/records.d.ts.map +1 -0
  127. package/dist/recording/records.js +14 -0
  128. package/dist/recording/records.js.map +1 -0
  129. package/dist/recording/transport/batcher.d.ts +59 -0
  130. package/dist/recording/transport/batcher.d.ts.map +1 -0
  131. package/dist/recording/transport/batcher.js +234 -0
  132. package/dist/recording/transport/batcher.js.map +1 -0
  133. package/dist/recording/transport/client.d.ts +41 -0
  134. package/dist/recording/transport/client.d.ts.map +1 -0
  135. package/dist/recording/transport/client.js +69 -0
  136. package/dist/recording/transport/client.js.map +1 -0
  137. package/dist/recording/transport/config.d.ts +53 -0
  138. package/dist/recording/transport/config.d.ts.map +1 -0
  139. package/dist/recording/transport/config.js +41 -0
  140. package/dist/recording/transport/config.js.map +1 -0
  141. package/dist/recording/transport/index.d.ts +16 -0
  142. package/dist/recording/transport/index.d.ts.map +1 -0
  143. package/dist/recording/transport/index.js +12 -0
  144. package/dist/recording/transport/index.js.map +1 -0
  145. package/dist/recording/transport/rows.d.ts +88 -0
  146. package/dist/recording/transport/rows.d.ts.map +1 -0
  147. package/dist/recording/transport/rows.js +15 -0
  148. package/dist/recording/transport/rows.js.map +1 -0
  149. package/dist/recording/wiring/emitter-factory.d.ts +39 -0
  150. package/dist/recording/wiring/emitter-factory.d.ts.map +1 -0
  151. package/dist/recording/wiring/emitter-factory.js +62 -0
  152. package/dist/recording/wiring/emitter-factory.js.map +1 -0
  153. package/dist/recording/wiring/identity.d.ts +27 -0
  154. package/dist/recording/wiring/identity.d.ts.map +1 -0
  155. package/dist/recording/wiring/identity.js +51 -0
  156. package/dist/recording/wiring/identity.js.map +1 -0
  157. package/dist/recording/wiring/index.d.ts +12 -0
  158. package/dist/recording/wiring/index.d.ts.map +1 -0
  159. package/dist/recording/wiring/index.js +9 -0
  160. package/dist/recording/wiring/index.js.map +1 -0
  161. package/dist/recording/wiring/record-builders.d.ts +107 -0
  162. package/dist/recording/wiring/record-builders.d.ts.map +1 -0
  163. package/dist/recording/wiring/record-builders.js +706 -0
  164. package/dist/recording/wiring/record-builders.js.map +1 -0
  165. package/dist/recording/wiring/subscriber.d.ts +28 -0
  166. package/dist/recording/wiring/subscriber.d.ts.map +1 -0
  167. package/dist/recording/wiring/subscriber.js +173 -0
  168. package/dist/recording/wiring/subscriber.js.map +1 -0
  169. package/dist/recording/wiring/values.d.ts +19 -0
  170. package/dist/recording/wiring/values.d.ts.map +1 -0
  171. package/dist/recording/wiring/values.js +49 -0
  172. package/dist/recording/wiring/values.js.map +1 -0
  173. package/dist/runtime/auto-update/command-runner.d.ts.map +1 -1
  174. package/dist/runtime/auto-update/command-runner.js +5 -1
  175. package/dist/runtime/auto-update/command-runner.js.map +1 -1
  176. package/dist/runtime/auto-update/resolve-package-name.d.ts +10 -0
  177. package/dist/runtime/auto-update/resolve-package-name.d.ts.map +1 -0
  178. package/dist/runtime/auto-update/resolve-package-name.js +35 -0
  179. package/dist/runtime/auto-update/resolve-package-name.js.map +1 -0
  180. package/dist/runtime/auto-update/run-update-command.d.ts +2 -0
  181. package/dist/runtime/auto-update/run-update-command.d.ts.map +1 -0
  182. package/dist/runtime/auto-update/run-update-command.js +37 -0
  183. package/dist/runtime/auto-update/run-update-command.js.map +1 -0
  184. package/dist/runtime/create-runtime-context.d.ts +2 -0
  185. package/dist/runtime/create-runtime-context.d.ts.map +1 -1
  186. package/dist/runtime/create-runtime-context.js +1 -0
  187. package/dist/runtime/create-runtime-context.js.map +1 -1
  188. package/dist/runtime/create-scanner-module.d.ts +4 -3
  189. package/dist/runtime/create-scanner-module.d.ts.map +1 -1
  190. package/dist/runtime/create-scanner-module.js +14 -5
  191. package/dist/runtime/create-scanner-module.js.map +1 -1
  192. package/dist/runtime/create-scanner-providers-for-run.d.ts.map +1 -1
  193. package/dist/runtime/create-scanner-providers-for-run.js +12 -1
  194. package/dist/runtime/create-scanner-providers-for-run.js.map +1 -1
  195. package/dist/runtime/load-runtime-config.d.ts +9 -0
  196. package/dist/runtime/load-runtime-config.d.ts.map +1 -1
  197. package/dist/runtime/load-runtime-config.js +41 -8
  198. package/dist/runtime/load-runtime-config.js.map +1 -1
  199. package/dist/runtime/map-strategies-registration.js +7 -8
  200. package/dist/runtime/map-strategies-registration.js.map +1 -1
  201. package/dist/runtime/map-strategies.d.ts.map +1 -1
  202. package/dist/runtime/map-strategies.js +12 -3
  203. package/dist/runtime/map-strategies.js.map +1 -1
  204. package/dist/runtime/recipe-version.d.ts +1 -1
  205. package/dist/runtime/recipe-version.d.ts.map +1 -1
  206. package/dist/runtime/recipe-version.js +1 -1
  207. package/dist/runtime/recipe-version.js.map +1 -1
  208. package/dist/runtime/reconcile-decide.d.ts +73 -0
  209. package/dist/runtime/reconcile-decide.d.ts.map +1 -0
  210. package/dist/runtime/reconcile-decide.js +186 -0
  211. package/dist/runtime/reconcile-decide.js.map +1 -0
  212. package/dist/runtime/reconcile-run.d.ts +62 -0
  213. package/dist/runtime/reconcile-run.d.ts.map +1 -0
  214. package/dist/runtime/reconcile-run.js +173 -0
  215. package/dist/runtime/reconcile-run.js.map +1 -0
  216. package/dist/runtime/reconcile-state.d.ts +44 -0
  217. package/dist/runtime/reconcile-state.d.ts.map +1 -1
  218. package/dist/runtime/reconcile-state.js +80 -44
  219. package/dist/runtime/reconcile-state.js.map +1 -1
  220. package/dist/runtime/risk-guard.d.ts.map +1 -1
  221. package/dist/runtime/risk-guard.js +17 -12
  222. package/dist/runtime/risk-guard.js.map +1 -1
  223. package/dist/runtime/run.d.ts.map +1 -1
  224. package/dist/runtime/run.js +3 -2
  225. package/dist/runtime/run.js.map +1 -1
  226. package/dist/runtime/runtime-schema.d.ts +4056 -793
  227. package/dist/runtime/runtime-schema.d.ts.map +1 -1
  228. package/dist/runtime/runtime-schema.js +183 -46
  229. package/dist/runtime/runtime-schema.js.map +1 -1
  230. package/dist/runtime/runtime-version.d.ts +3 -6
  231. package/dist/runtime/runtime-version.d.ts.map +1 -1
  232. package/dist/runtime/runtime-version.js +3 -6
  233. package/dist/runtime/runtime-version.js.map +1 -1
  234. package/dist/runtime/runtime.d.ts +47 -0
  235. package/dist/runtime/runtime.d.ts.map +1 -1
  236. package/dist/runtime/runtime.js +516 -146
  237. package/dist/runtime/runtime.js.map +1 -1
  238. package/dist/runtime/scanner-registry.d.ts +1 -1
  239. package/dist/runtime/scanner-registry.d.ts.map +1 -1
  240. package/dist/runtime/scanner-registry.js +3 -12
  241. package/dist/runtime/scanner-registry.js.map +1 -1
  242. package/dist/runtime/strategy-registry.d.ts +6 -0
  243. package/dist/runtime/strategy-registry.d.ts.map +1 -1
  244. package/dist/runtime/strategy-registry.js +1 -0
  245. package/dist/runtime/strategy-registry.js.map +1 -1
  246. package/dist/runtime/supervisor/long-running-supervisor.d.ts +222 -0
  247. package/dist/runtime/supervisor/long-running-supervisor.d.ts.map +1 -0
  248. package/dist/runtime/supervisor/long-running-supervisor.js +625 -0
  249. package/dist/runtime/supervisor/long-running-supervisor.js.map +1 -0
  250. package/dist/runtime/supervisor/orphan-sweep.d.ts +36 -0
  251. package/dist/runtime/supervisor/orphan-sweep.d.ts.map +1 -0
  252. package/dist/runtime/supervisor/orphan-sweep.js +255 -0
  253. package/dist/runtime/supervisor/orphan-sweep.js.map +1 -0
  254. package/dist/runtime/supervisor/supervisor-utils.d.ts +37 -0
  255. package/dist/runtime/supervisor/supervisor-utils.d.ts.map +1 -0
  256. package/dist/runtime/supervisor/supervisor-utils.js +175 -0
  257. package/dist/runtime/supervisor/supervisor-utils.js.map +1 -0
  258. package/dist/runtime-api/handlers/ingest-signals.d.ts +3 -3
  259. package/dist/runtime-api/handlers/ingest-signals.js +3 -3
  260. package/dist/runtime-api/intake/acceptance-record.d.ts +103 -0
  261. package/dist/runtime-api/intake/acceptance-record.d.ts.map +1 -0
  262. package/dist/runtime-api/intake/acceptance-record.js +192 -0
  263. package/dist/runtime-api/intake/acceptance-record.js.map +1 -0
  264. package/dist/runtime-api/intake/intake-context.d.ts +31 -0
  265. package/dist/runtime-api/intake/intake-context.d.ts.map +1 -0
  266. package/dist/runtime-api/intake/intake-context.js +21 -0
  267. package/dist/runtime-api/intake/intake-context.js.map +1 -0
  268. package/dist/runtime-api/intake/intake-mount.d.ts +118 -0
  269. package/dist/runtime-api/intake/intake-mount.d.ts.map +1 -0
  270. package/dist/runtime-api/intake/intake-mount.js +202 -0
  271. package/dist/runtime-api/intake/intake-mount.js.map +1 -0
  272. package/dist/runtime-api/intake/liveness-store.d.ts +32 -0
  273. package/dist/runtime-api/intake/liveness-store.d.ts.map +1 -0
  274. package/dist/runtime-api/intake/liveness-store.js +31 -0
  275. package/dist/runtime-api/intake/liveness-store.js.map +1 -0
  276. package/dist/runtime-api/intake/process-error-post.d.ts +15 -0
  277. package/dist/runtime-api/intake/process-error-post.d.ts.map +1 -0
  278. package/dist/runtime-api/intake/process-error-post.js +19 -0
  279. package/dist/runtime-api/intake/process-error-post.js.map +1 -0
  280. package/dist/runtime-api/intake/process-signal-post.d.ts +73 -0
  281. package/dist/runtime-api/intake/process-signal-post.d.ts.map +1 -0
  282. package/dist/runtime-api/intake/process-signal-post.js +188 -0
  283. package/dist/runtime-api/intake/process-signal-post.js.map +1 -0
  284. package/dist/runtime-api/intake/scanner-launcher.d.ts +133 -0
  285. package/dist/runtime-api/intake/scanner-launcher.d.ts.map +1 -0
  286. package/dist/runtime-api/intake/scanner-launcher.js +204 -0
  287. package/dist/runtime-api/intake/scanner-launcher.js.map +1 -0
  288. package/dist/runtime-api/intake/scanner-registry.d.ts +36 -0
  289. package/dist/runtime-api/intake/scanner-registry.d.ts.map +1 -0
  290. package/dist/runtime-api/intake/scanner-registry.js +29 -0
  291. package/dist/runtime-api/intake/scanner-registry.js.map +1 -0
  292. package/dist/runtime-api/intake/types.d.ts +60 -0
  293. package/dist/runtime-api/intake/types.d.ts.map +1 -0
  294. package/dist/runtime-api/intake/types.js +8 -0
  295. package/dist/runtime-api/intake/types.js.map +1 -0
  296. package/dist/runtime-api/routes/signals.d.ts +20 -40
  297. package/dist/runtime-api/routes/signals.d.ts.map +1 -1
  298. package/dist/runtime-api/routes/signals.js +120 -75
  299. package/dist/runtime-api/routes/signals.js.map +1 -1
  300. package/dist/runtime-api/routes/signals.schema.d.ts +23 -86
  301. package/dist/runtime-api/routes/signals.schema.d.ts.map +1 -1
  302. package/dist/runtime-api/routes/signals.schema.js +37 -50
  303. package/dist/runtime-api/routes/signals.schema.js.map +1 -1
  304. package/dist/runtime-api/server.d.ts +15 -6
  305. package/dist/runtime-api/server.d.ts.map +1 -1
  306. package/dist/runtime-api/server.js +12 -12
  307. package/dist/runtime-api/server.js.map +1 -1
  308. package/dist/scanners/events.d.ts +6 -0
  309. package/dist/scanners/events.d.ts.map +1 -1
  310. package/dist/scanners/events.js.map +1 -1
  311. package/dist/scanners/external/scaffold/__init__.py +16 -0
  312. package/dist/scanners/external/scaffold/__main__.py +155 -0
  313. package/dist/scanners/external/scaffold/ctx.py +78 -0
  314. package/dist/scanners/external/scaffold/delivery.py +282 -0
  315. package/dist/scanners/external/scaffold/entrypoint_loader.py +151 -0
  316. package/dist/scanners/external/scaffold/http_post.py +70 -0
  317. package/dist/scanners/external/scaffold/journal.py +247 -0
  318. package/dist/scanners/external/scaffold/loop_primitives.py +65 -0
  319. package/dist/scanners/external/scaffold/requirements.txt +11 -0
  320. package/dist/scanners/external/scaffold/scaffold.py +361 -0
  321. package/dist/scanners/external/scaffold/scaffold_state.py +114 -0
  322. package/dist/scanners/external/scaffold/senpi_mcp.py +250 -0
  323. package/dist/scanners/external/scaffold/signal_envelope.py +258 -0
  324. package/dist/scanners/external/scaffold/state_manager.py +175 -0
  325. package/dist/scanners/external-scanner-receiver.d.ts +23 -1
  326. package/dist/scanners/external-scanner-receiver.d.ts.map +1 -1
  327. package/dist/scanners/external-scanner-receiver.js +24 -3
  328. package/dist/scanners/external-scanner-receiver.js.map +1 -1
  329. package/dist/scanners/implementations/external-scanner.d.ts.map +1 -1
  330. package/dist/scanners/implementations/external-scanner.js +7 -1
  331. package/dist/scanners/implementations/external-scanner.js.map +1 -1
  332. package/dist/scanners/implementations/momentum.d.ts.map +1 -1
  333. package/dist/scanners/implementations/momentum.js +16 -0
  334. package/dist/scanners/implementations/momentum.js.map +1 -1
  335. package/dist/scanners/providers/factory.d.ts.map +1 -1
  336. package/dist/scanners/providers/factory.js +17 -19
  337. package/dist/scanners/providers/factory.js.map +1 -1
  338. package/dist/scanners/runtime-module.d.ts.map +1 -1
  339. package/dist/scanners/runtime-module.js +9 -1
  340. package/dist/scanners/runtime-module.js.map +1 -1
  341. package/dist/scripts/run-dsl-standalone-live.d.ts +1 -1
  342. package/dist/scripts/run-dsl-standalone-live.js +5 -3
  343. package/dist/scripts/run-dsl-standalone-live.js.map +1 -1
  344. package/dist/senpi/client.d.ts +56 -4
  345. package/dist/senpi/client.d.ts.map +1 -1
  346. package/dist/senpi/client.js +123 -24
  347. package/dist/senpi/client.js.map +1 -1
  348. package/dist/senpi/index.d.ts +2 -1
  349. package/dist/senpi/index.d.ts.map +1 -1
  350. package/dist/senpi/index.js +1 -1
  351. package/dist/senpi/index.js.map +1 -1
  352. package/dist/senpi/types.d.ts +1 -2
  353. package/dist/senpi/types.d.ts.map +1 -1
  354. package/dist/state/state-manager.d.ts +17 -0
  355. package/dist/state/state-manager.d.ts.map +1 -1
  356. package/dist/state/state-manager.js +55 -4
  357. package/dist/state/state-manager.js.map +1 -1
  358. package/dist/strategy/strategy-state.d.ts +9 -1
  359. package/dist/strategy/strategy-state.d.ts.map +1 -1
  360. package/dist/strategy/strategy-state.js +78 -28
  361. package/dist/strategy/strategy-state.js.map +1 -1
  362. package/dist/tracking/build-rehydrate-items.d.ts +15 -0
  363. package/dist/tracking/build-rehydrate-items.d.ts.map +1 -0
  364. package/dist/tracking/build-rehydrate-items.js +19 -0
  365. package/dist/tracking/build-rehydrate-items.js.map +1 -0
  366. package/dist/tracking/constants.d.ts.map +1 -1
  367. package/dist/tracking/constants.js +2 -0
  368. package/dist/tracking/constants.js.map +1 -1
  369. package/dist/tracking/index.d.ts +3 -0
  370. package/dist/tracking/index.d.ts.map +1 -1
  371. package/dist/tracking/index.js +2 -0
  372. package/dist/tracking/index.js.map +1 -1
  373. package/dist/tracking/position-id-registry.d.ts +69 -0
  374. package/dist/tracking/position-id-registry.d.ts.map +1 -0
  375. package/dist/tracking/position-id-registry.js +139 -0
  376. package/dist/tracking/position-id-registry.js.map +1 -0
  377. package/dist/tracking/spans/fan-out-span-transport.d.ts +22 -0
  378. package/dist/tracking/spans/fan-out-span-transport.d.ts.map +1 -0
  379. package/dist/tracking/spans/fan-out-span-transport.js +49 -0
  380. package/dist/tracking/spans/fan-out-span-transport.js.map +1 -0
  381. package/dist/tracking/spans/otel/fit-row-budget.d.ts +22 -0
  382. package/dist/tracking/spans/otel/fit-row-budget.d.ts.map +1 -0
  383. package/dist/tracking/spans/otel/fit-row-budget.js +91 -0
  384. package/dist/tracking/spans/otel/fit-row-budget.js.map +1 -0
  385. package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts +16 -0
  386. package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts.map +1 -0
  387. package/dist/tracking/spans/otel/map-span-to-trace-row.js +227 -0
  388. package/dist/tracking/spans/otel/map-span-to-trace-row.js.map +1 -0
  389. package/dist/tracking/spans/otel/recording-span-transport.d.ts +43 -0
  390. package/dist/tracking/spans/otel/recording-span-transport.d.ts.map +1 -0
  391. package/dist/tracking/spans/otel/recording-span-transport.js +67 -0
  392. package/dist/tracking/spans/otel/recording-span-transport.js.map +1 -0
  393. package/dist/tracking/spans/otel/span-ids.d.ts +22 -0
  394. package/dist/tracking/spans/otel/span-ids.d.ts.map +1 -0
  395. package/dist/tracking/spans/otel/span-ids.js +32 -0
  396. package/dist/tracking/spans/otel/span-ids.js.map +1 -0
  397. package/dist/tracking/spans/plugin-span-tracker.d.ts +6 -0
  398. package/dist/tracking/spans/plugin-span-tracker.d.ts.map +1 -1
  399. package/dist/tracking/spans/plugin-span-tracker.js +82 -9
  400. package/dist/tracking/spans/plugin-span-tracker.js.map +1 -1
  401. package/dist/tracking/spans/redact-pii.d.ts +3 -1
  402. package/dist/tracking/spans/redact-pii.d.ts.map +1 -1
  403. package/dist/tracking/spans/redact-pii.js +5 -1
  404. package/dist/tracking/spans/redact-pii.js.map +1 -1
  405. package/dist/tracking/spans/span-transport.d.ts +6 -0
  406. package/dist/tracking/spans/span-transport.d.ts.map +1 -1
  407. package/dist/tracking/spans/span-transport.js +1 -1
  408. package/dist/tracking/spans/span-transport.js.map +1 -1
  409. package/dist/types/dsl/index.d.ts +24 -1
  410. package/dist/types/dsl/index.d.ts.map +1 -1
  411. package/dist/types/runtime.d.ts +6 -0
  412. package/dist/types/runtime.d.ts.map +1 -1
  413. package/dist/types/scanner.d.ts +16 -0
  414. package/dist/types/scanner.d.ts.map +1 -1
  415. package/dist/types/strategy.d.ts +3 -1
  416. package/dist/types/strategy.d.ts.map +1 -1
  417. package/dist/utils/clearing-house-aggregate.d.ts +32 -0
  418. package/dist/utils/clearing-house-aggregate.d.ts.map +1 -0
  419. package/dist/utils/clearing-house-aggregate.js +41 -0
  420. package/dist/utils/clearing-house-aggregate.js.map +1 -0
  421. package/dist/utils/keyed-mutex.d.ts +37 -0
  422. package/dist/utils/keyed-mutex.d.ts.map +1 -0
  423. package/dist/utils/keyed-mutex.js +77 -0
  424. package/dist/utils/keyed-mutex.js.map +1 -0
  425. package/dist/utils/safe-spawn.d.ts +6 -0
  426. package/dist/utils/safe-spawn.d.ts.map +1 -0
  427. package/dist/utils/safe-spawn.js +62 -0
  428. package/dist/utils/safe-spawn.js.map +1 -0
  429. package/examples/strategies/README.md +17 -12
  430. package/examples/strategies/iguana/README.md +135 -0
  431. package/examples/strategies/iguana/recipe.yaml +137 -0
  432. package/examples/strategies/iguana/scanners/scan.py +242 -0
  433. package/examples/strategies/iguana/scanners/scoring.py +152 -0
  434. package/examples/strategies/raptor/README.md +156 -0
  435. package/examples/strategies/raptor/recipe.yaml +154 -0
  436. package/examples/strategies/raptor/scanners/scan.py +348 -0
  437. package/examples/strategies/raptor/scanners/scoring.py +452 -0
  438. package/examples/strategies/spider/README.md +89 -0
  439. package/examples/strategies/spider/scalp/recipe.yaml +129 -0
  440. package/examples/strategies/spider/scalp/scanners/scan.py +219 -0
  441. package/examples/strategies/spider/scalp/scanners/scoring.py +179 -0
  442. package/examples/strategies/spider/swing/recipe.yaml +137 -0
  443. package/examples/strategies/spider/swing/scanners/scan.py +334 -0
  444. package/examples/strategies/spider/swing/scanners/scoring.py +184 -0
  445. package/examples/strategies/turbine/README.md +169 -0
  446. package/examples/strategies/turbine/recipe-runners.yaml +123 -0
  447. package/examples/strategies/turbine/recipe-volume.yaml +129 -0
  448. package/examples/strategies/turbine/scanners/scan.py +287 -0
  449. package/examples/strategies/turbine/scanners/scoring.py +190 -0
  450. package/openclaw.plugin.json +12 -1
  451. package/package.json +3 -3
  452. package/dist/runtime-api/handlers/group-by-scanner.d.ts +0 -43
  453. package/dist/runtime-api/handlers/group-by-scanner.d.ts.map +0 -1
  454. package/dist/runtime-api/handlers/group-by-scanner.js +0 -43
  455. package/dist/runtime-api/handlers/group-by-scanner.js.map +0 -1
  456. package/dist/scanners/external/liquidation-watchdog/README.md +0 -107
  457. package/dist/scanners/external/liquidation-watchdog/liquidation-watchdog.yaml +0 -48
  458. package/dist/scanners/external/liquidation-watchdog/producer.mjs +0 -336
  459. package/dist/scanners/external/momentum/README.md +0 -148
  460. package/dist/scanners/external/momentum/momentum.yaml +0 -116
  461. package/dist/scanners/external/momentum/producer.mjs +0 -251
  462. package/dist/scanners/external/shared/ingest.mjs +0 -112
  463. package/examples/README.md +0 -89
  464. package/examples/scanners-consumer-quickstart.mjs +0 -134
  465. package/examples/scanners-emerging-movers-v4.mjs +0 -287
  466. package/examples/scanners-liquidation-watchdog.mjs +0 -341
  467. package/examples/scanners-live-mcp.mjs +0 -208
  468. package/examples/scanners-multi-strategy.mjs +0 -165
  469. package/examples/scanners-position-tracker-e2e.mjs +0 -225
  470. package/examples/scanners-scheduled-events.mjs +0 -96
  471. package/examples/scanners-senpi-provider-client.mjs +0 -182
  472. package/examples/scanners-single-strategy.mjs +0 -198
  473. package/examples/strategies/dsl-showcase.yaml +0 -68
  474. package/examples/strategies/dsl.yaml +0 -51
  475. package/examples/strategies/fox-minimal-loosened.yaml +0 -240
  476. package/examples/strategies/fox-minimal.yaml +0 -242
  477. package/examples/strategies/minimal.yaml +0 -46
  478. package/examples/strategies/momentum/how-it-works.md +0 -48
  479. package/examples/strategies/momentum/momentum-guarded.yaml +0 -161
  480. package/examples/strategies/risk-showcase.yaml +0 -93
  481. package/examples/strategies/viper.yaml +0 -67
  482. package/examples/strategies/wolf.yaml +0 -72
  483. package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +0 -123
@@ -10,9 +10,59 @@ import { shouldSyncExchangeSl } from "./exchange-sync.js";
10
10
  import { mapTiersToEngineConfig, mapEnginePositionToStateFields, parseSlOrderId } from "../engine-client/config-mapping.js";
11
11
  import { mapBackendEventToBusEvent } from "../engine-client/event-mapping.js";
12
12
  import { buildDslClosedEventFromState } from "../events/build-closed-event.js";
13
- async function isDslKeyStillActive(stateManager, key) {
14
- const s = await stateManager.getOrLoad(key);
15
- return Boolean(s?.active);
13
+ import { parseCloseFillDetail } from "../../senpi/client.js";
14
+ /**
15
+ * Re-read the key under its per-key lock; if it is still active, archive it and return true.
16
+ * If a competing locked writer already archived/inactivated it, skip and return false (WARN).
17
+ *
18
+ * The re-read and the archive run inside ONE withKeyLock so the decision and the write are
19
+ * atomic against the other writers (bus close handler, reconcile) that mutate the same key
20
+ * under the same lock. The caller emits bus events only when this returns true, keeping the
21
+ * emit OUTSIDE the lock (the close handlers take the same key lock — emitting inside would
22
+ * nest a non-reentrant lock).
23
+ */
24
+ async function archiveIfStillActive(stateManager, key, address, asset, dex, buildClosedState, ctx) {
25
+ return stateManager.withKeyLock(key, async () => {
26
+ const current = await stateManager.getOrLoad(key);
27
+ if (!current?.active) {
28
+ logger.warn(ctx.skipMessage, { tickId: ctx.tickId, address, asset, key });
29
+ return false;
30
+ }
31
+ await stateManager.archiveAndDeleteDslState(address, asset, dex, buildClosedState(current));
32
+ return true;
33
+ });
34
+ }
35
+ /**
36
+ * Re-read the key under its per-key lock; if it is still active, persist the next state and
37
+ * return true. If a competing locked writer already archived/inactivated it, skip and return
38
+ * false (WARN) so the monitor cannot resurrect a closed position by writing active:true onto a
39
+ * deleted key. `buildNext` receives the fresh in-lock state so read-modify-writes (counter bumps,
40
+ * field stamps) merge onto current values; callers persisting a fully-computed replacement (e.g.
41
+ * the dslTick result) may ignore it and return their own state.
42
+ */
43
+ async function setIfStillActive(stateManager, key, address, asset, buildNext, ctx) {
44
+ return stateManager.withKeyLock(key, async () => {
45
+ const current = await stateManager.getOrLoad(key);
46
+ if (!current?.active) {
47
+ logger.warn(ctx.skipMessage, { tickId: ctx.tickId, address, asset, key });
48
+ return false;
49
+ }
50
+ await stateManager.set(key, buildNext(current));
51
+ return true;
52
+ });
53
+ }
54
+ /**
55
+ * Telemetry stamps for a flat POSITION_CLOSED emit: the cross-flow position.id plus the
56
+ * closing-order fill detail when a close response (or SL order id) is available. Data-only —
57
+ * no consumer branches on these; the venue `orderId` is the fills-ledger join key for
58
+ * post-hoc lifecycle correlation.
59
+ */
60
+ function closedEmitStamps(state, fill = {}) {
61
+ return {
62
+ __positionId: state.positionId ?? state.correlationId,
63
+ __correlationId: state.correlationId,
64
+ ...fill,
65
+ };
16
66
  }
17
67
  export async function processOnePosition(ctx, key, state, price) {
18
68
  const { tickId, ts, now: isoNow, stateManager, strategyStates, bus, isSlPlacementInProgress = () => false } = ctx;
@@ -56,18 +106,18 @@ export async function processOnePosition(ctx, key, state, price) {
56
106
  slOrderId: state.slOrderId,
57
107
  address: state.address,
58
108
  });
59
- if (!(await isDslKeyStillActive(stateManager, key))) {
60
- logger.info("[dsl] skip SL-hit archive: state already cleared (concurrent close)", { tickId, key });
61
- return;
62
- }
63
109
  const closedState = { ...state, active: false, closedAt: ts, closeReason: CLOSE_REASON.EXCHANGE_SL_HIT };
64
- await stateManager.archiveAndDeleteDslState(state.address, state.asset, effectiveDex(state), closedState);
110
+ const archived = await archiveIfStillActive(stateManager, key, state.address, state.asset, effectiveDex(state), () => closedState, { tickId, skipMessage: "[dsl] skip SL-hit archive: state already cleared (concurrent close)" });
111
+ if (!archived)
112
+ return;
65
113
  bus.emit(EVENTS.POSITION_CLOSED, {
66
114
  address: state.address,
67
115
  asset: state.asset,
68
116
  wallet: state.wallet,
69
117
  reason: CLOSE_REASON.EXCHANGE_SL_HIT,
70
118
  closeReason: CLOSE_REASON.EXCHANGE_SL_HIT,
119
+ // The closing order IS the exchange SL order — its id joins the closing fill.
120
+ ...closedEmitStamps(state, state.slOrderId != null ? { orderId: String(state.slOrderId) } : {}),
71
121
  timestamp: ts,
72
122
  });
73
123
  bus.emit(DSL_EVENTS.CLOSED, buildDslClosedEventFromState(closedState, {
@@ -95,8 +145,10 @@ export async function processOnePosition(ctx, key, state, price) {
95
145
  reason: closeReasonToUse,
96
146
  attempt: next.consecutiveCloseFailures,
97
147
  });
148
+ const closeStartedAt = Date.now();
149
+ let closeAttemptEmitted = false;
98
150
  try {
99
- await withRetry(() => strategy.closePosition(state.asset, closeReasonToUse, state.dex || undefined, {
151
+ const closeResult = await withRetry(() => strategy.closePosition(state.asset, closeReasonToUse, state.dex || undefined, {
100
152
  orderType: ctx.closeOrderType,
101
153
  feeOptimizedLimitOptions: ctx.feeOptimizedLimitOptions,
102
154
  }), {
@@ -105,23 +157,38 @@ export async function processOnePosition(ctx, key, state, price) {
105
157
  label: "closePosition (pendingClose)",
106
158
  onRetry: (attempt, remaining, err) => logger.warn("[dsl] closePosition retry", { asset: state.asset, attempt, remaining, err }),
107
159
  });
160
+ // Telemetry-only fire-and-forget: the venue-call window for the dsl.close_attempt span.
161
+ bus.emit("tracking.dsl_close_attempt", {
162
+ tickId,
163
+ key,
164
+ asset: state.asset,
165
+ dex,
166
+ positionId: state.positionId ?? state.correlationId,
167
+ startedAt: closeStartedAt,
168
+ endedAt: Date.now(),
169
+ outcome: "ok",
170
+ closeReason: closeReasonToUse,
171
+ attempt: next.consecutiveCloseFailures,
172
+ timestamp: isoNow(),
173
+ });
174
+ closeAttemptEmitted = true;
175
+ const closeFill = parseCloseFillDetail(closeResult);
108
176
  logger.info("[dsl] closePosition succeeded, archiving (pendingClose)", {
109
177
  tickId,
110
178
  asset: state.asset,
111
179
  reason: closeReasonToUse,
112
180
  });
113
- if (!(await isDslKeyStillActive(stateManager, key))) {
114
- logger.info("[dsl] skip pendingClose archive: state already cleared (concurrent close)", { tickId, key });
115
- return;
116
- }
117
181
  const closedState = { ...next, active: false, closedAt: ts, closeReason: closeReasonToUse };
118
- await stateManager.archiveAndDeleteDslState(state.address, state.asset, effectiveDex(state), closedState);
182
+ const archived = await archiveIfStillActive(stateManager, key, state.address, state.asset, effectiveDex(state), () => closedState, { tickId, skipMessage: "[dsl] skip pendingClose archive: state already cleared (concurrent close)" });
183
+ if (!archived)
184
+ return;
119
185
  bus.emit(EVENTS.POSITION_CLOSED, {
120
186
  address: state.address,
121
187
  asset: state.asset,
122
188
  wallet: state.wallet,
123
189
  reason: closeReasonToUse,
124
190
  closeReason: closeReasonToUse,
191
+ ...closedEmitStamps(state, closeFill),
125
192
  timestamp: ts,
126
193
  });
127
194
  bus.emit(DSL_EVENTS.CLOSED, buildDslClosedEventFromState(closedState, {
@@ -132,22 +199,40 @@ export async function processOnePosition(ctx, key, state, price) {
132
199
  }
133
200
  catch (e) {
134
201
  logger.warn("closePosition retry failed", { asset: state.asset, err: e });
202
+ // Telemetry-only fire-and-forget: the failed venue-call window (dsl.close_attempt, error).
203
+ // Guarded: when the ok emit already fired, the venue call itself succeeded — a later
204
+ // state-write throw must not be misattributed to the venue.
205
+ if (!closeAttemptEmitted) {
206
+ bus.emit("tracking.dsl_close_attempt", {
207
+ tickId,
208
+ key,
209
+ asset: state.asset,
210
+ dex,
211
+ positionId: state.positionId ?? state.correlationId,
212
+ startedAt: closeStartedAt,
213
+ endedAt: Date.now(),
214
+ outcome: "error",
215
+ closeReason: closeReasonToUse,
216
+ attempt: next.consecutiveCloseFailures,
217
+ error: String(e),
218
+ timestamp: isoNow(),
219
+ });
220
+ }
135
221
  next.lastError = String(e);
136
222
  next.lastErrorAt = ts;
137
- await stateManager.set(key, next);
138
- if ((next.consecutiveCloseFailures ?? 0) >= MAX_CONSECUTIVE_CLOSE_FAILURES) {
139
- if (!(await isDslKeyStillActive(stateManager, key))) {
140
- logger.info("[dsl] skip close-fail archive: state already cleared (concurrent close)", { tickId, key });
141
- return;
142
- }
223
+ const crossedThreshold = (next.consecutiveCloseFailures ?? 0) >= MAX_CONSECUTIVE_CLOSE_FAILURES;
224
+ if (crossedThreshold) {
143
225
  const failedCloseState = { ...next, active: false, closedAt: isoNow(), closeReason: CLOSE_REASON.CLOSE_POSITION_FAILED };
144
- await stateManager.archiveAndDeleteDslState(state.address, state.asset, effectiveDex(state), failedCloseState);
226
+ const archived = await archiveIfStillActive(stateManager, key, state.address, state.asset, effectiveDex(state), () => failedCloseState, { tickId, skipMessage: "[dsl] skip close-fail archive: state already cleared (concurrent close)" });
227
+ if (!archived)
228
+ return;
145
229
  bus.emit(EVENTS.POSITION_CLOSED, {
146
230
  address: state.address,
147
231
  asset: state.asset,
148
232
  wallet: state.wallet,
149
233
  reason: "error",
150
234
  closeReason: CLOSE_REASON.CLOSE_POSITION_FAILED,
235
+ ...closedEmitStamps(state),
151
236
  timestamp: isoNow(),
152
237
  });
153
238
  bus.emit(DSL_EVENTS.CLOSED, buildDslClosedEventFromState(failedCloseState, {
@@ -157,11 +242,13 @@ export async function processOnePosition(ctx, key, state, price) {
157
242
  }));
158
243
  }
159
244
  else {
245
+ await setIfStillActive(stateManager, key, state.address, state.asset, (current) => ({ ...current, lastError: String(e), lastErrorAt: ts, consecutiveCloseFailures: next.consecutiveCloseFailures }), { tickId, skipMessage: "[dsl] skip pendingClose error write: state already cleared (concurrent close)" });
160
246
  bus.emit(DSL_EVENTS.CLOSE_PENDING, {
161
247
  address: state.address,
162
248
  asset: state.asset,
163
249
  attempt: next.consecutiveCloseFailures,
164
250
  triggerReason: state.triggerReason,
251
+ __positionId: state.positionId ?? state.correlationId,
165
252
  __correlationId: state.correlationId,
166
253
  timestamp: isoNow(),
167
254
  });
@@ -172,7 +259,11 @@ export async function processOnePosition(ctx, key, state, price) {
172
259
  if (price == null) {
173
260
  const next = { ...state, consecutiveFetchFailures: (state.consecutiveFetchFailures ?? 0) + 1 };
174
261
  next.tickCount = (state.tickCount ?? 0) + 1;
175
- await stateManager.set(key, next);
262
+ await setIfStillActive(stateManager, key, state.address, state.asset, (current) => ({
263
+ ...current,
264
+ consecutiveFetchFailures: (current.consecutiveFetchFailures ?? 0) + 1,
265
+ tickCount: (current.tickCount ?? 0) + 1,
266
+ }), { tickId, skipMessage: "[dsl] skip no-price counter write: state already cleared (concurrent close)" });
176
267
  if (next.consecutiveFetchFailures >= DSL_PRICE_FETCH_FAILURE_WARN_THRESHOLD) {
177
268
  logger.warn("[dsl] sustained price fetch failures for position", {
178
269
  tickId,
@@ -199,7 +290,12 @@ export async function processOnePosition(ctx, key, state, price) {
199
290
  if (next.handoffStatus === "pending" && !strategy) {
200
291
  next.handoffStatus = null;
201
292
  }
202
- await stateManager.set(key, next);
293
+ if (!(await setIfStillActive(stateManager, key, state.address, state.asset, () => next, {
294
+ tickId,
295
+ skipMessage: "[dsl] skip dslTick result write: state already cleared (concurrent close)",
296
+ }))) {
297
+ return;
298
+ }
203
299
  logger.info("[dsl] monitor dslTick result", {
204
300
  tickId,
205
301
  key,
@@ -224,8 +320,7 @@ export async function processOnePosition(ctx, key, state, price) {
224
320
  key,
225
321
  asset: state.asset,
226
322
  });
227
- const cleared = { ...next, closeReason: null };
228
- await stateManager.set(key, cleared);
323
+ await setIfStillActive(stateManager, key, state.address, state.asset, (current) => ({ ...current, closeReason: null }), { tickId, skipMessage: "[dsl] skip spurious-breach clear: state already cleared (concurrent close)" });
229
324
  return;
230
325
  }
231
326
  logger.info("[dsl] dsl close: sending closePosition to exchange", {
@@ -257,8 +352,11 @@ export async function processOnePosition(ctx, key, state, price) {
257
352
  });
258
353
  }
259
354
  }
355
+ let closeFill = {};
356
+ const closeStartedAt = Date.now();
357
+ let closeAttemptEmitted = false;
260
358
  try {
261
- await withRetry(() => strategy.closePosition(state.asset, closeReasonToUse, state.dex || undefined, {
359
+ const closeResult = await withRetry(() => strategy.closePosition(state.asset, closeReasonToUse, state.dex || undefined, {
262
360
  orderType: ctx.closeOrderType,
263
361
  feeOptimizedLimitOptions: ctx.feeOptimizedLimitOptions,
264
362
  }), {
@@ -267,6 +365,23 @@ export async function processOnePosition(ctx, key, state, price) {
267
365
  label: "closePosition (dsl breach/timeout)",
268
366
  onRetry: (attempt, remaining, err) => logger.warn("[dsl] closePosition retry", { asset: state.asset, attempt, remaining, err }),
269
367
  });
368
+ // Telemetry-only fire-and-forget: the venue-call window for the dsl.close_attempt span.
369
+ // Emitted before any post-venue work (fill parsing) so its outcome reflects the venue call alone.
370
+ bus.emit("tracking.dsl_close_attempt", {
371
+ tickId,
372
+ key,
373
+ asset: state.asset,
374
+ dex,
375
+ positionId: state.positionId ?? state.correlationId,
376
+ startedAt: closeStartedAt,
377
+ endedAt: Date.now(),
378
+ outcome: "ok",
379
+ closeReason: closeReasonToUse,
380
+ attempt: (next.consecutiveCloseFailures ?? 0) + 1,
381
+ timestamp: isoNow(),
382
+ });
383
+ closeAttemptEmitted = true;
384
+ closeFill = parseCloseFillDetail(closeResult);
270
385
  }
271
386
  catch (e) {
272
387
  logger.warn("closePosition failed", { asset: state.asset, err: e });
@@ -278,20 +393,37 @@ export async function processOnePosition(ctx, key, state, price) {
278
393
  lastError: String(e),
279
394
  lastErrorAt: ts,
280
395
  };
281
- await stateManager.set(key, pending);
396
+ // Telemetry-only fire-and-forget: the failed venue-call window (dsl.close_attempt, error).
397
+ // Guarded: when the ok emit already fired, the venue call itself succeeded — a later
398
+ // post-venue throw must not be misattributed to the venue.
399
+ if (!closeAttemptEmitted) {
400
+ bus.emit("tracking.dsl_close_attempt", {
401
+ tickId,
402
+ key,
403
+ asset: state.asset,
404
+ dex,
405
+ positionId: state.positionId ?? state.correlationId,
406
+ startedAt: closeStartedAt,
407
+ endedAt: Date.now(),
408
+ outcome: "error",
409
+ closeReason: closeReasonToUse,
410
+ attempt: pending.consecutiveCloseFailures,
411
+ error: String(e),
412
+ timestamp: isoNow(),
413
+ });
414
+ }
282
415
  if ((pending.consecutiveCloseFailures ?? 0) >= MAX_CONSECUTIVE_CLOSE_FAILURES) {
283
- if (!(await isDslKeyStillActive(stateManager, key))) {
284
- logger.info("[dsl] skip breach close-fail archive: state already cleared (concurrent close)", { tickId, key });
285
- return;
286
- }
287
416
  const failedCloseState = { ...pending, active: false, closedAt: isoNow(), closeReason: CLOSE_REASON.CLOSE_POSITION_FAILED };
288
- await stateManager.archiveAndDeleteDslState(state.address, state.asset, effectiveDex(state), failedCloseState);
417
+ const archived = await archiveIfStillActive(stateManager, key, state.address, state.asset, effectiveDex(state), () => failedCloseState, { tickId, skipMessage: "[dsl] skip breach close-fail archive: state already cleared (concurrent close)" });
418
+ if (!archived)
419
+ return;
289
420
  bus.emit(EVENTS.POSITION_CLOSED, {
290
421
  address: state.address,
291
422
  asset: state.asset,
292
423
  wallet: state.wallet,
293
424
  reason: "error",
294
425
  closeReason: CLOSE_REASON.CLOSE_POSITION_FAILED,
426
+ ...closedEmitStamps(state),
295
427
  timestamp: isoNow(),
296
428
  });
297
429
  bus.emit(DSL_EVENTS.CLOSED, buildDslClosedEventFromState(failedCloseState, {
@@ -301,11 +433,13 @@ export async function processOnePosition(ctx, key, state, price) {
301
433
  }));
302
434
  }
303
435
  else {
436
+ await setIfStillActive(stateManager, key, state.address, state.asset, () => pending, { tickId, skipMessage: "[dsl] skip breach close-pending write: state already cleared (concurrent close)" });
304
437
  bus.emit(DSL_EVENTS.CLOSE_PENDING, {
305
438
  address: state.address,
306
439
  asset: state.asset,
307
440
  attempt: pending.consecutiveCloseFailures,
308
441
  triggerReason: state.triggerReason,
442
+ __positionId: state.positionId ?? state.correlationId,
309
443
  __correlationId: state.correlationId,
310
444
  timestamp: isoNow(),
311
445
  });
@@ -317,18 +451,17 @@ export async function processOnePosition(ctx, key, state, price) {
317
451
  asset: state.asset,
318
452
  reason: closeReasonToUse,
319
453
  });
320
- if (!(await isDslKeyStillActive(stateManager, key))) {
321
- logger.info("[dsl] skip dsl-breach archive: state already cleared (concurrent close)", { tickId, key });
322
- return;
323
- }
324
454
  const closedState = { ...next, active: false, closedAt: ts, closeReason: closeReasonToUse };
325
- await stateManager.archiveAndDeleteDslState(state.address, state.asset, effectiveDex(state), closedState);
455
+ const archived = await archiveIfStillActive(stateManager, key, state.address, state.asset, effectiveDex(state), () => closedState, { tickId, skipMessage: "[dsl] skip dsl-breach archive: state already cleared (concurrent close)" });
456
+ if (!archived)
457
+ return;
326
458
  bus.emit(EVENTS.POSITION_CLOSED, {
327
459
  address: state.address,
328
460
  asset: state.asset,
329
461
  wallet: state.wallet,
330
462
  reason: closeReasonToUse,
331
463
  closeReason: closeReasonToUse,
464
+ ...closedEmitStamps(state, closeFill),
332
465
  timestamp: ts,
333
466
  });
334
467
  bus.emit(DSL_EVENTS.CLOSED, buildDslClosedEventFromState(closedState, {
@@ -354,6 +487,7 @@ export async function processOnePosition(ctx, key, state, price) {
354
487
  triggerPct: tier.triggerPct,
355
488
  newFloorPrice: dslEffectiveFloor,
356
489
  triggerReason: next.triggerReason,
490
+ __positionId: next.positionId ?? next.correlationId,
357
491
  __correlationId: next.correlationId,
358
492
  timestamp: ts,
359
493
  direction: next.direction,
@@ -365,10 +499,7 @@ export async function processOnePosition(ctx, key, state, price) {
365
499
  lastPrice: next.lastPrice,
366
500
  lockedProfitPct: next.lockedProfitPct,
367
501
  });
368
- const afterTier = (await stateManager.getOrLoad(key)) ?? next;
369
- if (afterTier?.active) {
370
- await stateManager.set(key, { ...afterTier, lastTierNotificationAt: ts });
371
- }
502
+ await setIfStillActive(stateManager, key, state.address, state.asset, (current) => ({ ...current, lastTierNotificationAt: ts }), { tickId, skipMessage: "[dsl] skip tier-notification stamp: state already cleared (concurrent close)" });
372
503
  }
373
504
  else {
374
505
  logger.error("[dsl] TIER_ADVANCED skipped: tier missing at index (tiers must come from YAML/config)", {
@@ -387,6 +518,7 @@ export async function processOnePosition(ctx, key, state, price) {
387
518
  phase: result.newPhase ?? 2,
388
519
  tierIndex: result.newTierIndex ?? 0,
389
520
  triggerReason: next.triggerReason,
521
+ __positionId: next.positionId ?? next.correlationId,
390
522
  __correlationId: next.correlationId,
391
523
  timestamp: ts,
392
524
  });
@@ -406,7 +538,7 @@ export async function processOnePosition(ctx, key, state, price) {
406
538
  asset: state.asset,
407
539
  });
408
540
  next.handoffStatus = "pending";
409
- await stateManager.set(key, next);
541
+ await setIfStillActive(stateManager, key, state.address, state.asset, () => next, { tickId, skipMessage: "[dsl] skip catch-up handoff-pending write: state already cleared (concurrent close)" });
410
542
  }
411
543
  if (next.handoffStatus === "pending" && strategy) {
412
544
  await attemptHandoffRegistration(ctx, key, next, state, strategy);
@@ -453,6 +585,8 @@ export async function processOnePosition(ctx, key, state, price) {
453
585
  phaseChanged: result.phaseChanged,
454
586
  prevSlOrderId: next.slOrderId,
455
587
  });
588
+ const slSyncStartedAt = Date.now();
589
+ let slUpdateEmitted = false;
456
590
  try {
457
591
  const res = await withRetry(() => strategy.editPosition({
458
592
  coin: state.asset,
@@ -464,21 +598,44 @@ export async function processOnePosition(ctx, key, state, price) {
464
598
  label: "editPosition (SL sync)",
465
599
  onRetry: (attempt, remaining, err) => logger.warn("[dsl] editPosition retry", { asset: state.asset, attempt, remaining, err }),
466
600
  });
467
- const freshAfterSl = await stateManager.getOrLoad(key);
468
- if (!freshAfterSl?.active) {
469
- logger.info("[dsl] skip SL sync write: state no longer active (concurrent close)", { tickId, key });
601
+ const slSyncEndedAt = Date.now();
602
+ // Telemetry-only fire-and-forget: the venue-call window for the dsl.sl_update span. Emitted
603
+ // immediately after the venue call resolves — before any state read/write — so it fires even
604
+ // when a concurrent close returns early below, and reports the venue's own answer
605
+ // (`res.slOrderId`), the honest venue-call fact.
606
+ bus.emit("tracking.dsl_sl_update", {
607
+ tickId,
608
+ key,
609
+ asset: state.asset,
610
+ dex,
611
+ positionId: state.positionId ?? state.correlationId,
612
+ startedAt: slSyncStartedAt,
613
+ endedAt: slSyncEndedAt,
614
+ outcome: "ok",
615
+ newSLPrice: exchangeTriggerPx,
616
+ slOrderId: res.slOrderId,
617
+ syncReason,
618
+ timestamp: isoNow(),
619
+ });
620
+ slUpdateEmitted = true;
621
+ let syncedForEmit = null;
622
+ await setIfStillActive(stateManager, key, state.address, state.asset, (current) => {
623
+ const synced = {
624
+ ...current,
625
+ slOrderId: res.slOrderId ?? current.slOrderId,
626
+ lastSyncedFloorPrice: exchangeTriggerPx,
627
+ slOrderIdUpdatedAt: ts,
628
+ lastSlSyncError: null,
629
+ slSyncFailureCount: 0,
630
+ lastError: null,
631
+ lastErrorAt: null,
632
+ };
633
+ syncedForEmit = synced;
634
+ return synced;
635
+ }, { tickId, skipMessage: "[dsl] skip SL sync write: state no longer active (concurrent close)" });
636
+ if (!syncedForEmit)
470
637
  return;
471
- }
472
- const synced = {
473
- ...freshAfterSl,
474
- slOrderId: res.slOrderId ?? freshAfterSl.slOrderId,
475
- lastSyncedFloorPrice: exchangeTriggerPx,
476
- slOrderIdUpdatedAt: ts,
477
- lastSlSyncError: null,
478
- slSyncFailureCount: 0,
479
- lastError: null,
480
- lastErrorAt: null,
481
- };
638
+ const synced = syncedForEmit;
482
639
  logger.info("[dsl] exchange SL created/updated", {
483
640
  tickId,
484
641
  asset: state.asset,
@@ -487,37 +644,56 @@ export async function processOnePosition(ctx, key, state, price) {
487
644
  dslEffectiveFloor,
488
645
  resSlOrderId: res.slOrderId,
489
646
  });
490
- await stateManager.set(key, synced);
491
647
  bus.emit(DSL_EVENTS.SL_UPDATED, {
492
648
  address: state.address,
493
649
  asset: state.asset,
494
650
  newSLPrice: exchangeTriggerPx,
495
651
  slOrderId: synced.slOrderId ?? 0,
496
652
  triggerReason: synced.triggerReason,
653
+ __positionId: synced.positionId ?? synced.correlationId,
497
654
  __correlationId: synced.correlationId,
498
655
  timestamp: ts,
499
656
  });
500
657
  }
501
658
  catch (e) {
502
- const freshAfterSl = await stateManager.getOrLoad(key);
503
- if (!freshAfterSl?.active) {
504
- logger.info("[dsl] skip SL sync-failure write: state no longer active (concurrent close)", { tickId, key });
505
- return;
659
+ // Telemetry-only fire-and-forget: the failed venue-call window (dsl.sl_update, error).
660
+ // Guarded: when the ok emit already fired, the venue call itself succeeded — a later
661
+ // state-write throw must not be misattributed to the venue.
662
+ if (!slUpdateEmitted) {
663
+ bus.emit("tracking.dsl_sl_update", {
664
+ tickId,
665
+ key,
666
+ asset: state.asset,
667
+ dex,
668
+ positionId: state.positionId ?? state.correlationId,
669
+ startedAt: slSyncStartedAt,
670
+ endedAt: Date.now(),
671
+ outcome: "error",
672
+ newSLPrice: exchangeTriggerPx,
673
+ syncReason,
674
+ error: String(e),
675
+ timestamp: isoNow(),
676
+ });
506
677
  }
507
- const syncFailed = {
508
- ...freshAfterSl,
509
- lastSlSyncError: String(e),
510
- lastError: String(e),
511
- lastErrorAt: ts,
512
- slSyncFailureCount: (freshAfterSl.slSyncFailureCount ?? 0) + 1,
513
- };
514
- await stateManager.set(key, syncFailed);
678
+ let syncFailureCount = null;
679
+ await setIfStillActive(stateManager, key, state.address, state.asset, (current) => {
680
+ syncFailureCount = (current.slSyncFailureCount ?? 0) + 1;
681
+ return {
682
+ ...current,
683
+ lastSlSyncError: String(e),
684
+ lastError: String(e),
685
+ lastErrorAt: ts,
686
+ slSyncFailureCount: syncFailureCount,
687
+ };
688
+ }, { tickId, skipMessage: "[dsl] skip SL sync-failure write: state no longer active (concurrent close)" });
689
+ if (syncFailureCount == null)
690
+ return;
515
691
  logger.warn("[dsl] editPosition (SL update) failed", {
516
692
  tickId,
517
693
  asset: state.asset,
518
694
  exchangeTriggerPx,
519
695
  dslEffectiveFloor,
520
- slSyncFailureCount: syncFailed.slSyncFailureCount,
696
+ slSyncFailureCount: syncFailureCount,
521
697
  err: e,
522
698
  });
523
699
  }
@@ -551,13 +727,14 @@ export async function processOnePosition(ctx, key, state, price) {
551
727
  currentTierIndex: hbState.currentTierIndex,
552
728
  elapsedMinutes: hbState.elapsedMinutes,
553
729
  triggerReason: hbState.triggerReason,
730
+ __positionId: hbState.positionId ?? hbState.correlationId,
554
731
  __correlationId: hbState.correlationId,
555
732
  margin: hbState.leverage > 0
556
733
  ? (hbState.size * hbState.entryPrice) / hbState.leverage
557
734
  : 0,
558
735
  timestamp: ts,
559
736
  });
560
- await stateManager.set(key, { ...hbState, lastHeartbeatAt: ts });
737
+ await setIfStillActive(stateManager, key, hbState.address, hbState.asset, (current) => ({ ...current, lastHeartbeatAt: ts }), { tickId, skipMessage: "[dsl] skip heartbeat stamp: state already cleared (concurrent close)" });
561
738
  }
562
739
  }
563
740
  }
@@ -574,10 +751,10 @@ const BACKEND_TERMINAL_STATUSES = new Set([
574
751
  "DELETED",
575
752
  ]);
576
753
  /**
577
- * A Phase 2 handoff is only "ok" once the backend confirms it has placed a live
578
- * exchange stop-loss. The exchange SL is the position's only price protection in
579
- * Phase 2, so without a confirmed `activeSLOrderId` the runtime must keep the
580
- * handoff "pending" and manage the SL itself rather than trust the backend.
754
+ * A Phase-2 handoff is only "ok" once the backend confirms it has placed a live
755
+ * exchange stop-loss (a numeric activeSLOrderId). Without one, the runtime must
756
+ * keep the handoff "pending" and manage the SL itself rather than trust a backend
757
+ * that has accepted the position but not yet armed a stop (MA-3).
581
758
  */
582
759
  function backendHasLiveSl(pos) {
583
760
  return parseSlOrderId(pos.activeSLOrderId) != null;
@@ -612,7 +789,7 @@ async function attemptHandoffRegistration(ctx, key, next, _original, strategy) {
612
789
  backendDslPositionId: adopted.id,
613
790
  lastBackendDslTick: ts,
614
791
  };
615
- await stateManager.set(key, updated);
792
+ await setIfStillActive(stateManager, key, next.address, next.asset, () => updated, { tickId, skipMessage: "[dsl] skip handoff adopt write: state already cleared (concurrent close)" });
616
793
  Object.assign(next, updated);
617
794
  return;
618
795
  }
@@ -647,7 +824,7 @@ async function attemptHandoffRegistration(ctx, key, next, _original, strategy) {
647
824
  rawResult: JSON.stringify(result).slice(0, 1000),
648
825
  });
649
826
  const aborted = { ...next, handoffStatus: "aborted" };
650
- await stateManager.set(key, aborted);
827
+ await setIfStillActive(stateManager, key, next.address, next.asset, () => aborted, { tickId, skipMessage: "[dsl] skip handoff abort write: state already cleared (concurrent close)" });
651
828
  Object.assign(next, aborted);
652
829
  return;
653
830
  }
@@ -667,7 +844,7 @@ async function attemptHandoffRegistration(ctx, key, next, _original, strategy) {
667
844
  backendDslPositionId: result.position.id,
668
845
  lastBackendDslTick: ts,
669
846
  };
670
- await stateManager.set(key, updated);
847
+ await setIfStillActive(stateManager, key, next.address, next.asset, () => updated, { tickId, skipMessage: "[dsl] skip handoff register write: state already cleared (concurrent close)" });
671
848
  Object.assign(next, updated);
672
849
  logger.info("[dsl] handoff registered with backend", {
673
850
  tickId,
@@ -724,7 +901,7 @@ async function handleHandoffOk(ctx, key, next, original, strategy) {
724
901
  backendDslPositionId: null,
725
902
  lastBackendDslTick: null,
726
903
  };
727
- await stateManager.set(key, rolledBack);
904
+ await setIfStillActive(stateManager, key, original.address, original.asset, () => rolledBack, { tickId, skipMessage: "[dsl] skip handoff rollback write: state already cleared (concurrent close)" });
728
905
  return;
729
906
  }
730
907
  else {
@@ -741,13 +918,17 @@ async function handleHandoffOk(ctx, key, next, original, strategy) {
741
918
  closedAt: ts,
742
919
  closeReason,
743
920
  };
744
- await stateManager.archiveAndDeleteDslState(original.address, original.asset, effectiveDex(original), closedState);
921
+ const archived = await archiveIfStillActive(stateManager, key, original.address, original.asset, effectiveDex(original), () => closedState, { tickId, skipMessage: "[dsl] skip backend-terminal archive: state already cleared (concurrent close)" });
922
+ if (!archived)
923
+ return;
745
924
  bus.emit(EVENTS.POSITION_CLOSED, {
746
925
  address: original.address,
747
926
  asset: original.asset,
748
927
  wallet: original.wallet,
749
928
  reason: closeReason,
750
929
  closeReason,
930
+ // Backend-driven close: the closing order id is not locally verifiable — stamp ids only.
931
+ ...closedEmitStamps(updated),
751
932
  timestamp: ts,
752
933
  });
753
934
  bus.emit(DSL_EVENTS.CLOSED, buildDslClosedEventFromState(closedState, {
@@ -790,6 +971,7 @@ async function handleHandoffOk(ctx, key, next, original, strategy) {
790
971
  tiers: original.tiers,
791
972
  triggerReason: updated.triggerReason,
792
973
  correlationId: updated.correlationId,
974
+ positionId: updated.positionId ?? updated.correlationId,
793
975
  tierEnrichment: {
794
976
  direction: updated.direction,
795
977
  entryPrice: updated.entryPrice,
@@ -868,13 +1050,17 @@ async function handleHandoffOk(ctx, key, next, original, strategy) {
868
1050
  closedAt: ts,
869
1051
  closeReason,
870
1052
  };
871
- await stateManager.archiveAndDeleteDslState(original.address, original.asset, effectiveDex(original), closedState);
1053
+ const archived = await archiveIfStillActive(stateManager, key, original.address, original.asset, effectiveDex(original), () => closedState, { tickId, skipMessage: "[dsl] skip backend-CLOSED archive: state already cleared (concurrent close)" });
1054
+ if (!archived)
1055
+ return;
872
1056
  bus.emit(EVENTS.POSITION_CLOSED, {
873
1057
  address: original.address,
874
1058
  asset: original.asset,
875
1059
  wallet: original.wallet,
876
1060
  reason: closeReason,
877
1061
  closeReason,
1062
+ // Backend-driven close: the closing order id is not locally verifiable — stamp ids only.
1063
+ ...closedEmitStamps(updated),
878
1064
  timestamp: ts,
879
1065
  });
880
1066
  return;
@@ -888,6 +1074,6 @@ async function handleHandoffOk(ctx, key, next, original, strategy) {
888
1074
  err: e,
889
1075
  });
890
1076
  }
891
- await stateManager.set(key, updated);
1077
+ await setIfStillActive(stateManager, key, original.address, original.asset, () => updated, { tickId, skipMessage: "[dsl] skip handoff poll final write: state already cleared (concurrent close)" });
892
1078
  }
893
1079
  //# sourceMappingURL=process-one-position.js.map