@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
@@ -0,0 +1,706 @@
1
+ /**
2
+ * Pure builders: bus-event payloads → recording records. No I/O, no emitter — each function reads a
3
+ * loosely-typed payload defensively and returns a fully-populated record (or `null` when the event
4
+ * cannot yield one). Redaction is NOT done here — records are populated faithfully; the mapper is the
5
+ * single redaction seam.
6
+ *
7
+ * Timestamps: the bus carries ISO strings (and, for a scan result, an epoch-ms number); every record
8
+ * stores epoch ms, converted once here.
9
+ */
10
+ import { asObject, bool, num, str, toEpochMs } from "./values.js";
11
+ /** `"LONG"`/`"SHORT"` → {@link TradeDirection}, else `null` (non-directional). */
12
+ function direction(value) {
13
+ return value === "LONG" || value === "SHORT" ? value : null;
14
+ }
15
+ /** Strict direction (no null) for records that never carry a non-directional value (DSL). */
16
+ function strictDirection(value) {
17
+ return direction(value) ?? undefined;
18
+ }
19
+ /** A boolean, or `null` when explicitly null (preserves the "unfilled" signal), else `undefined`. */
20
+ function boolOrNull(value) {
21
+ if (typeof value === "boolean")
22
+ return value;
23
+ return value === null ? null : undefined;
24
+ }
25
+ function numOrNull(value) {
26
+ if (value === null)
27
+ return null;
28
+ return num(value);
29
+ }
30
+ // ─── Scanner run ─────────────────────────────────────────────────────────────
31
+ function scannerOutcome(status) {
32
+ switch (status) {
33
+ case "error":
34
+ return "error";
35
+ case "skipped":
36
+ case "disabled":
37
+ case "halted":
38
+ return "skipped";
39
+ default:
40
+ return "complete";
41
+ }
42
+ }
43
+ function buildSignalSummary(raw, fallbackTs) {
44
+ const s = asObject(raw) ?? {};
45
+ return {
46
+ signalType: str(s.signalType) ?? "",
47
+ asset: str(s.asset) ?? "",
48
+ direction: direction(s.direction),
49
+ score: num(s.score) ?? 0,
50
+ timestamp: num(s.timestamp) ?? fallbackTs,
51
+ factors: asObject(s.factors),
52
+ meta: asObject(s.meta),
53
+ };
54
+ }
55
+ /** From a `tracking.scanner_run` / `tracking.scanner_run_skipped` / `tracking.scanner_run_error`
56
+ * event (complete runs carry the whole `ScanResult`; skip/error carry status + reason). */
57
+ export function buildScannerRun(payload, nowMs) {
58
+ const p = asObject(payload);
59
+ const data = asObject(p?.data);
60
+ if (!data)
61
+ return null;
62
+ const ts = toEpochMs(data.timestamp, toEpochMs(p?.timestamp, nowMs));
63
+ // The runtime surfaces the run start additively on the event; when absent (older payloads),
64
+ // startedAt = endedAt. Clamped so endedAt ≥ startedAt always holds for the mapper.
65
+ const startedAt = Math.min(toEpochMs(data.startedAt, ts), ts);
66
+ const status = str(data.status);
67
+ const outcome = scannerOutcome(status);
68
+ const signals = Array.isArray(data.signals)
69
+ ? data.signals.map((s) => buildSignalSummary(s, ts))
70
+ : undefined;
71
+ return {
72
+ type: "scanner_run",
73
+ scannerId: str(data.scannerId) ?? "",
74
+ runId: str(data.runId),
75
+ outcome,
76
+ statusDetail: status,
77
+ startedAt,
78
+ endedAt: ts,
79
+ scannedCount: num(data.scannedCount),
80
+ actionableCount: num(data.actionableCount),
81
+ signalCount: signals?.length,
82
+ signals,
83
+ summary: asObject(data.summary),
84
+ reason: str(data.reason),
85
+ error: outcome === "error" ? str(data.reason) : undefined,
86
+ };
87
+ }
88
+ // ─── Scanner funnel summary (Task 8a, derived from `tracking.scanner_run`) ────────
89
+ /**
90
+ * The `scanner.summary` anti-spam log record, derived from the SAME `tracking.scanner_run` payload
91
+ * that {@link buildScannerRun} reads (its `data.summary.funnel.dropped`) — no new bus event.
92
+ *
93
+ * Returns `null` when there is no `data.summary.funnel`: skip/error runs and scanners without a
94
+ * funnel produce no summary event (the survivors are detailed by their own `signal.outcome` events,
95
+ * and "didn't run at all" is `scanner_run.skipped`). One record per scan; the dropped candidates are
96
+ * one Body array, never one row per drop.
97
+ */
98
+ export function buildScannerSummary(payload, nowMs) {
99
+ const p = asObject(payload);
100
+ const data = asObject(p?.data);
101
+ if (!data)
102
+ return null;
103
+ const summary = asObject(data.summary);
104
+ const funnel = asObject(summary?.funnel);
105
+ if (!funnel)
106
+ return null;
107
+ const droppedCandidates = Array.isArray(funnel.dropped)
108
+ ? funnel.dropped
109
+ .map((d) => asObject(d))
110
+ .filter((d) => d !== undefined)
111
+ : [];
112
+ // Survivors: the emitted signals' assets — a small linkage list to the per-signal events.
113
+ const passedAssets = Array.isArray(data.signals)
114
+ ? data.signals
115
+ .map((s) => str(asObject(s)?.asset))
116
+ .filter((a) => a !== undefined)
117
+ : [];
118
+ const droppedByReason = {};
119
+ for (const d of droppedCandidates) {
120
+ const reason = str(d.reason);
121
+ if (reason === undefined)
122
+ continue;
123
+ droppedByReason[reason] = (droppedByReason[reason] ?? 0) + 1;
124
+ }
125
+ const droppedCount = droppedCandidates.length;
126
+ const passedCount = num(data.signalCount) ?? passedAssets.length;
127
+ // Grain is "one per scan that *considered* candidates": an idle scan (nothing passed, nothing
128
+ // dropped) carries an empty funnel and yields no summary — emitting an all-empty row every tick
129
+ // would defeat the anti-spam intent and risk evicting high-value rows on transport overflow.
130
+ if (droppedCount === 0 && passedCount === 0)
131
+ return null;
132
+ return {
133
+ type: "scanner_summary",
134
+ occurredAt: toEpochMs(data.timestamp, toEpochMs(p?.timestamp, nowMs)),
135
+ scannerId: str(data.scannerId) ?? "",
136
+ scannedCount: num(data.scannedCount) ?? passedCount + droppedCount,
137
+ passedCount,
138
+ droppedCount,
139
+ droppedByReason: Object.keys(droppedByReason).length > 0 ? droppedByReason : undefined,
140
+ passedAssets: passedAssets.length > 0 ? passedAssets : undefined,
141
+ droppedCandidates: droppedCount > 0 ? droppedCandidates : undefined,
142
+ };
143
+ }
144
+ // ─── Signal evaluation (single-sourced from `tracking.action_result`) ────────────
145
+ /** Reason codes where the system evaluated a trade and actively blocked it (see {@link classifyOutcome}). */
146
+ const REJECTED_REASONS = new Set(["insufficient_margin", "invalid_direction", "no_margin_configured", "below_min_notional"]);
147
+ /** Reason codes where no trade was applicable / attempted. */
148
+ const SKIPPED_REASONS = new Set(["no_slots", "position_already_exists", "no_open_position"]);
149
+ /**
150
+ * Coarse per-signal classification from the action's per-signal result entry. Semantic, not
151
+ * success-flag-driven: the coarse axis answers "actively blocked vs. not attempted", and the
152
+ * producer's `success` flag encodes "handled without error" — flag-driven mapping would bury
153
+ * risk-gate trips among benign skips like `position_already_exists`.
154
+ * - `executed` — an order was placed (open: `reason:"submitted"`; close: success with a `closeReason`)
155
+ * - `error` — `reason:"exception"` or a carried error message (e.g. `position_open_failed`)
156
+ * - `rejected` — evaluated and actively blocked: `risk_gate_*`, `insufficient_margin`,
157
+ * `invalid_direction`, `no_margin_configured`, `below_min_notional`
158
+ * - `skipped` — not applicable / no capacity: `no_slots`, `position_already_exists`, `no_open_position`
159
+ * Unknown reason codes fall back to the success flag (`false` → rejected, else skipped).
160
+ */
161
+ function classifyOutcome(reason, success, error, closeReason) {
162
+ if (reason === "submitted" || (success === true && closeReason !== undefined))
163
+ return "executed";
164
+ if (reason === "exception" || error !== undefined)
165
+ return "error";
166
+ if (reason !== undefined) {
167
+ if (reason.startsWith("risk_gate_") || REJECTED_REASONS.has(reason))
168
+ return "rejected";
169
+ if (SKIPPED_REASONS.has(reason))
170
+ return "skipped";
171
+ }
172
+ return success === false ? "rejected" : "skipped";
173
+ }
174
+ function buildOutcome(raw, positionId) {
175
+ const r = asObject(raw) ?? {};
176
+ const reason = str(r.reason);
177
+ const success = bool(r.success);
178
+ const error = str(r.error);
179
+ const closeReason = str(r.closeReason);
180
+ return {
181
+ result: classifyOutcome(reason, success, error, closeReason),
182
+ positionId,
183
+ reasonCode: reason,
184
+ reason: closeReason,
185
+ error,
186
+ leverage: num(r.leverage),
187
+ marginAmount: num(r.marginAmount),
188
+ notionalValue: num(r.notionalValue),
189
+ orderId: str(r.orderId),
190
+ entryPrice: num(r.entryPrice),
191
+ size: num(r.size),
192
+ filled: boolOrNull(r.filled),
193
+ executionAsMaker: boolOrNull(r.executionAsMaker),
194
+ requiredMarginAmount: num(r.requiredMarginAmount),
195
+ availableMarginAmount: num(r.availableMarginAmount),
196
+ };
197
+ }
198
+ /** The `data` envelope, embedded `result`, and per-signal `results[]` entries from a `tracking.action_result` payload. */
199
+ function actionResults(actionResultPayload) {
200
+ const p = asObject(actionResultPayload);
201
+ const data = asObject(p?.data);
202
+ const result = asObject(data?.result);
203
+ const resultData = asObject(result?.data);
204
+ return { data, result, resultData, results: Array.isArray(resultData?.results) ? resultData.results : [] };
205
+ }
206
+ /**
207
+ * The V2 stamping rule: every per-signal outcome that pertains to a real position — open,
208
+ * just-submitted, or evaluated on a held asset (even when rejected/skipped) — carries that
209
+ * position's id; only a signal on an asset with no live position resolves to nothing. The
210
+ * lookup is deliberately unconditional on the outcome classification. The result entry's own
211
+ * `dex` is used (open/close actions stamp it per signal); absent dex = main book, matching
212
+ * the registry key normalization.
213
+ */
214
+ function resolveOutcomePositionId(resolve, address, r, asset) {
215
+ if (!resolve || address === undefined || asset === undefined || asset === "")
216
+ return undefined;
217
+ return resolve(address, str(r.dex) ?? "", asset);
218
+ }
219
+ /**
220
+ * One {@link SignalEvaluation} per per-signal result entry, each enriched with the matching input
221
+ * signal (via `findSignal`) or a synthesized summary from the result entry itself when none matches.
222
+ *
223
+ * The per-signal work window (`startedAt`/`endedAt`, stamped by the action loop) is threaded onto
224
+ * the evaluation. A half window is fabricated extent, so both stamps must be present or neither is
225
+ * kept; on clock skew (`endedAt < startedAt`) the start is pulled up to the end, matching the
226
+ * pass-window convention.
227
+ */
228
+ function buildEvaluations(results, findSignal, fallbackTs, resolvePositionId, address) {
229
+ return results.map((raw) => {
230
+ const r = asObject(raw) ?? {};
231
+ const asset = str(r.asset);
232
+ const signal = (asset !== undefined ? findSignal(asset) : undefined) ?? {
233
+ signalType: "",
234
+ asset: asset ?? "",
235
+ direction: direction(r.direction),
236
+ score: num(r.score) ?? 0,
237
+ timestamp: fallbackTs,
238
+ };
239
+ let startedAt = num(r.startedAt);
240
+ const endedAt = num(r.endedAt);
241
+ if (startedAt !== undefined && endedAt !== undefined && endedAt < startedAt)
242
+ startedAt = endedAt;
243
+ return {
244
+ signal,
245
+ outcome: buildOutcome(r, resolveOutcomePositionId(resolvePositionId, address, r, asset)),
246
+ ...(startedAt !== undefined && endedAt !== undefined ? { startedAt, endedAt } : {}),
247
+ };
248
+ });
249
+ }
250
+ /**
251
+ * Build the whole pass record from a `tracking.action_result` payload alone — the producers echo
252
+ * the decision window and scan provenance onto the payload (`scannerId`, `scannerSignals`,
253
+ * `minConfidence`, `decisionStartedAt`, `decisionEndedAt`, `runId`), and the decision itself rides
254
+ * `result.data._decisionMeta`, so no pairing with `tracking.decision` is needed.
255
+ *
256
+ * `evaluations` is one entry per per-signal result, each enriched with the matching input signal
257
+ * (or a summary synthesized from the result entry when none matches — e.g. close-position's
258
+ * static-params path, which carries no `scannerSignals`). A pass without `_decisionMeta` yields no
259
+ * `decision` (the contract allows a decision-less pass).
260
+ *
261
+ * The pass span runs `decisionStartedAt` → action_result-ts; when the start stamp is absent
262
+ * (defensive only — the bus is in-process) `startedAt = endedAt`. On clock skew
263
+ * (`endedAt < startedAt`) the start is pulled up to `endedAt`, yielding a zero (never negative)
264
+ * duration.
265
+ */
266
+ export function buildSignalEvaluated(actionResultPayload, nowMs, resolvePositionId) {
267
+ const { data, result, resultData, results } = actionResults(actionResultPayload);
268
+ if (!data)
269
+ return null;
270
+ const p = asObject(actionResultPayload);
271
+ const endedAt = toEpochMs(p?.timestamp, nowMs);
272
+ let startedAt = num(data.decisionStartedAt) ?? endedAt;
273
+ if (endedAt < startedAt)
274
+ startedAt = endedAt;
275
+ const signals = Array.isArray(data.scannerSignals)
276
+ ? data.scannerSignals.map((s) => buildSignalSummary(s, startedAt))
277
+ : [];
278
+ // Indexed once (first occurrence wins, matching find() semantics) — this runs in the producer's
279
+ // synchronous emit path, so the per-evaluation lookup must not rescan the signal array.
280
+ const byAsset = new Map();
281
+ for (const s of signals)
282
+ if (!byAsset.has(s.asset))
283
+ byAsset.set(s.asset, s);
284
+ const evaluations = buildEvaluations(results, (asset) => byAsset.get(asset), startedAt, resolvePositionId, str(p?.address));
285
+ const meta = asObject(resultData?._decisionMeta);
286
+ const decision = meta
287
+ ? {
288
+ execute: bool(meta.execute) ?? false,
289
+ actionType: str(result?.action_type) ?? "",
290
+ actionName: str(data.actionName),
291
+ mode: str(meta.mode),
292
+ confidence: num(meta.confidence) ?? 0,
293
+ confidenceThreshold: num(data.minConfidence),
294
+ reasoning: str(meta.reasoning) ?? "",
295
+ model: str(meta.model),
296
+ tokensUsed: numOrNull(meta.tokensUsed),
297
+ durationMs: num(meta.durationMs),
298
+ endedAt: num(data.decisionEndedAt),
299
+ }
300
+ : undefined;
301
+ return {
302
+ type: "signal_evaluated",
303
+ scannerId: str(data.scannerId),
304
+ runId: str(data.runId),
305
+ startedAt,
306
+ endedAt,
307
+ decision,
308
+ evaluations,
309
+ };
310
+ }
311
+ // ─── Self-learning event log: decision.made + signal.outcome (Task 8) ─────────────
312
+ //
313
+ // Both are DERIVED from the SAME built SignalEvaluatedRecord (single-source, DRY) — no re-parse of
314
+ // the payload, no new bus event. The mapper does the redaction; these builders populate faithfully.
315
+ /** Decision action type → the coarse open/close/none intent. */
316
+ function actionIntent(actionType) {
317
+ if (actionType === "open_position")
318
+ return "open";
319
+ if (actionType === "close_position")
320
+ return "close";
321
+ return "none";
322
+ }
323
+ /** The four-value disposition from the granular per-signal {@link SignalOutcomeResult}. */
324
+ function disposition(result) {
325
+ switch (result) {
326
+ case "executed":
327
+ return "accepted";
328
+ case "below_confidence":
329
+ return "rejected";
330
+ case "error":
331
+ return "error";
332
+ // rejected (actively blocked by a gate) and skipped (not attempted) both read as "blocked"
333
+ // at the disposition grain; the granular `reasonCode` is kept verbatim for the why.
334
+ default:
335
+ return "blocked";
336
+ }
337
+ }
338
+ /**
339
+ * The pass's `decision.made` log record, derived from the built pass record — `null` when the pass
340
+ * carried no decision (a decision-less pass yields no judgment event). One per pass.
341
+ */
342
+ export function buildDecisionMade(record) {
343
+ const d = record.decision;
344
+ if (!d)
345
+ return null;
346
+ return {
347
+ type: "decision_made",
348
+ occurredAt: record.endedAt,
349
+ mode: d.mode,
350
+ byLlm: d.mode === "llm",
351
+ model: d.model,
352
+ tokensUsed: d.tokensUsed,
353
+ confidence: d.confidence,
354
+ confidenceThreshold: d.confidenceThreshold,
355
+ durationMs: d.durationMs,
356
+ actionIntent: actionIntent(d.actionType),
357
+ // Market context + marginSource are NOT on the payload today → left undefined (see impl notes).
358
+ reasoning: d.reasoning,
359
+ };
360
+ }
361
+ /**
362
+ * One `signal.outcome` log record per evaluation in the pass, derived from the built pass record.
363
+ * `rawSignal` is the evaluation's {@link SignalSummary} (incl. its `meta`/`factors`) — the variable
364
+ * scanner evidence; redaction over it happens in the mapper, not here.
365
+ */
366
+ export function buildSignalOutcomes(record) {
367
+ return record.evaluations.map((ev) => {
368
+ const { signal, outcome } = ev;
369
+ return {
370
+ type: "signal_outcome",
371
+ occurredAt: record.endedAt,
372
+ scannerId: record.scannerId,
373
+ signalType: signal.signalType !== "" ? signal.signalType : undefined,
374
+ asset: signal.asset,
375
+ direction: signal.direction,
376
+ score: signal.score,
377
+ signalTs: signal.timestamp,
378
+ factors: signal.factors,
379
+ result: disposition(outcome.result),
380
+ reasonCode: outcome.reasonCode,
381
+ positionId: outcome.positionId,
382
+ marginAmount: outcome.marginAmount,
383
+ leverage: outcome.leverage,
384
+ notionalValue: outcome.notionalValue,
385
+ size: outcome.size,
386
+ // marginSource is NOT on the payload today → left undefined (see impl notes).
387
+ orderId: outcome.orderId,
388
+ errorName: outcome.errorName,
389
+ rawSignal: { ...signal },
390
+ };
391
+ });
392
+ }
393
+ // ─── Self-learning event log: dsl.close_attempt (Task 8) ──────────────────────────
394
+ /** Coerces the producer's outcome string to the close-attempt result enum; default `error`. */
395
+ function closeAttemptResult(value) {
396
+ return value === "ok" ? "ok" : "error";
397
+ }
398
+ /**
399
+ * From the existing `tracking.dsl_close_attempt` monitor event — the second consumer (alongside the
400
+ * tick trace). Fields at the payload root: `positionId`, `asset`, `dex`, `closeReason`, `attempt`,
401
+ * `outcome` ("ok"|"error"), `error`, ISO `timestamp`. `null` when the payload is not an object.
402
+ */
403
+ export function buildDslCloseAttempt(payload, nowMs) {
404
+ const p = asObject(payload);
405
+ if (!p)
406
+ return null;
407
+ return {
408
+ type: "dsl_close_attempt",
409
+ occurredAt: toEpochMs(p.timestamp, nowMs),
410
+ positionId: str(p.positionId),
411
+ asset: str(p.asset),
412
+ dex: str(p.dex),
413
+ reason: str(p.closeReason),
414
+ attempt: num(p.attempt),
415
+ result: closeAttemptResult(p.outcome),
416
+ error: str(p.error),
417
+ };
418
+ }
419
+ // ─── Self-learning event log: order.{placed,filled,failed} (Task 8a) ──────────────
420
+ /**
421
+ * From the additive `tracking.order_*` events the open/close actions fire (the HookEvent shape:
422
+ * fields under a `data` envelope). One record per event; `eventKind` discriminates which fields the
423
+ * payload carries (placed: order/size; filled: fill; failed: reason/error). `positionId` maps from
424
+ * `__positionId`. `null` when no `asset` is resolvable — the asset is the one always-present scalar.
425
+ *
426
+ * Faithful population only (no redaction here — the mapper is the single redaction seam).
427
+ */
428
+ export function buildOrderEvent(eventKind, payload, nowMs) {
429
+ const p = asObject(payload);
430
+ const data = asObject(p?.data);
431
+ if (!data)
432
+ return null;
433
+ const asset = str(data.asset);
434
+ if (asset === undefined)
435
+ return null;
436
+ return {
437
+ type: "order_event",
438
+ event: eventKind,
439
+ occurredAt: toEpochMs(p?.timestamp, nowMs),
440
+ positionId: str(data.__positionId),
441
+ orderId: str(data.orderId),
442
+ asset,
443
+ direction: direction(data.direction),
444
+ orderType: str(data.orderType),
445
+ size: num(data.size),
446
+ limitPrice: num(data.limitPrice),
447
+ reduceOnly: bool(data.reduceOnly),
448
+ fillPrice: num(data.fillPrice),
449
+ fillSize: num(data.fillSize),
450
+ executionAsMaker: boolOrNull(data.executionAsMaker),
451
+ fees: num(data.fees),
452
+ partial: bool(data.partial),
453
+ reason: str(data.reason),
454
+ errorName: str(data.errorName),
455
+ error: str(data.error),
456
+ };
457
+ }
458
+ // ─── Position lifecycle ──────────────────────────────────────────────────────
459
+ /** Absolute size from a signed-size string/number (`szi`). */
460
+ function absSize(value) {
461
+ const n = num(value);
462
+ return n === undefined ? undefined : Math.abs(n);
463
+ }
464
+ /**
465
+ * From an `on_position_*` event. Action-driven events arrive as HookEvents (fields under a `data`
466
+ * envelope); the DSL monitor / reconcile paths emit `on_position_closed` flat (fields at the root,
467
+ * always with an `asset`), so a flat payload carrying an `asset` is read as-is. The DSL archive
468
+ * handler's re-broadcast of a close is marked `source: "dsl_archive"` and skipped — the close it
469
+ * mirrors was already recorded from the original emit. (`on_open_order_submitted` is deliberately
470
+ * not recorded — its submit fact is already on the signal-evaluation view, avoiding a double count.)
471
+ */
472
+ export function buildPositionLifecycle(event, payload, nowMs) {
473
+ const p = asObject(payload);
474
+ if (!p)
475
+ return null;
476
+ if (str(p.source) === "dsl_archive")
477
+ return null;
478
+ const data = asObject(p.data) ?? (str(p.asset) !== undefined ? p : undefined);
479
+ if (!data)
480
+ return null;
481
+ return {
482
+ type: "position_lifecycle",
483
+ event,
484
+ occurredAt: toEpochMs(p?.timestamp, nowMs),
485
+ positionId: str(data.__positionId),
486
+ asset: str(data.asset) ?? "",
487
+ dex: str(data.dex),
488
+ direction: direction(data.direction),
489
+ entryPrice: num(data.entryPrice) ?? num(data.entryPx),
490
+ size: num(data.size) ?? absSize(data.szi),
491
+ leverage: num(data.leverage),
492
+ leverageType: str(data.leverageType),
493
+ margin: num(data.margin),
494
+ unrealizedPnl: num(data.unrealizedPnl),
495
+ roe: num(data.roe),
496
+ liquidationPrice: numOrNull(data.liquidationPrice),
497
+ reason: str(data.reason),
498
+ closeReason: str(data.closeReason),
499
+ closedPrice: num(data.closedPrice),
500
+ closedSize: num(data.closedSize),
501
+ executionAsMaker: boolOrNull(data.executionAsMaker),
502
+ previousEntryPrice: num(data.previousEntryPrice),
503
+ previousSize: num(data.previousSize),
504
+ sizeDelta: num(data.sizeDelta),
505
+ newAsset: str(data.newAsset) ?? str(data.coin),
506
+ orderId: str(data.orderId),
507
+ orderType: str(data.orderType),
508
+ marginAmount: num(data.marginAmount),
509
+ filled: boolOrNull(data.filled),
510
+ reasoning: str(data.reasoning),
511
+ // Stamped by the position-tracker action on `on_position_opened` only (absent elsewhere).
512
+ reconciliationSource: str(data.reconciliationSource),
513
+ };
514
+ }
515
+ // ─── DSL transitions ─────────────────────────────────────────────────────────
516
+ /** From a `dsl.*` event (fields live at the payload root, with an ISO `timestamp`). */
517
+ export function buildDslTransition(transition, payload, nowMs) {
518
+ const p = asObject(payload);
519
+ if (!p)
520
+ return null;
521
+ const occurredAt = toEpochMs(p.timestamp, nowMs);
522
+ const tiers = Array.isArray(p.tiers)
523
+ ? p.tiers.map((t) => {
524
+ const tier = asObject(t) ?? {};
525
+ return { triggerPct: num(tier.triggerPct) ?? 0, lockHwPct: num(tier.lockHwPct) ?? 0 };
526
+ })
527
+ : undefined;
528
+ const phaseRaw = num(p.phase);
529
+ const phase = phaseRaw === 1 || phaseRaw === 2 ? phaseRaw : undefined;
530
+ return {
531
+ type: "dsl_transition",
532
+ transition,
533
+ occurredAt,
534
+ positionId: str(p.__positionId),
535
+ asset: str(p.asset) ?? "",
536
+ dex: str(p.dex),
537
+ triggerReason: str(p.triggerReason),
538
+ preset: str(p.preset),
539
+ tiers,
540
+ direction: strictDirection(p.direction),
541
+ entryPrice: num(p.entryPrice),
542
+ leverage: num(p.leverage),
543
+ margin: num(p.margin),
544
+ size: num(p.size),
545
+ floorPrice: num(p.floorPrice),
546
+ newFloorPrice: num(p.newFloorPrice),
547
+ phase,
548
+ tierIndex: num(p.tierIndex) ?? num(p.tier) ?? numOrNull(p.currentTierIndex),
549
+ lockHwPct: num(p.lockHwPct),
550
+ triggerPct: num(p.triggerPct),
551
+ lockedProfitPct: num(p.lockedProfitPct),
552
+ newSLPrice: num(p.newSLPrice),
553
+ slOrderId: num(p.slOrderId),
554
+ reason: str(p.reason),
555
+ closeReason: str(p.closeReason),
556
+ createdAt: p.createdAt !== undefined ? toEpochMs(p.createdAt, occurredAt) : undefined,
557
+ currentROE: num(p.currentROE),
558
+ highWaterRoe: num(p.highWaterRoe),
559
+ highWaterPrice: num(p.highWaterPrice),
560
+ peakROE: num(p.peakROE),
561
+ lastPrice: num(p.lastPrice),
562
+ attempt: num(p.attempt),
563
+ updated: Array.isArray(p.updated) ? p.updated.filter((x) => typeof x === "string") : undefined,
564
+ backendDslPositionId: typeof p.backendDslPositionId === "string" ? p.backendDslPositionId : p.backendDslPositionId === null ? null : undefined,
565
+ };
566
+ }
567
+ // ─── DSL monitor tick work units ─────────────────────────────────────────────
568
+ /** Coerces the producer's outcome string to the record's closed enum; anything else is dropped. */
569
+ function dslTickOutcome(value) {
570
+ return value === "ok" || value === "error" ? value : undefined;
571
+ }
572
+ /**
573
+ * From the monitor's `tracking.dsl_tick` / `tracking.dsl_position` / `tracking.dsl_close_attempt`
574
+ * / `tracking.dsl_sl_update` events (fields at the payload root). Each event yields one record —
575
+ * the deterministic ids derived from `tickId` (and `tickId:positionKey`, both bootId-scoped by
576
+ * the mapper) thread them into one trace, so no pairing is needed here. Essentials are `tickId`
577
+ * plus a numeric work window; on clock skew (`endedAt < startedAt`) the start is pulled up to the
578
+ * end, matching the pass-window convention. The price-fetch window is kept only when both stamps
579
+ * are present (a half window is fabricated extent). No `nowMs` fallback: work windows are
580
+ * producer-stamped; nothing here is fabricated.
581
+ */
582
+ export function buildDslTick(unit, payload) {
583
+ const p = asObject(payload);
584
+ if (!p)
585
+ return null;
586
+ const tickId = str(p.tickId);
587
+ let startedAt = num(p.startedAt);
588
+ const endedAt = num(p.endedAt);
589
+ if (tickId === undefined || startedAt === undefined || endedAt === undefined)
590
+ return null;
591
+ if (endedAt < startedAt)
592
+ startedAt = endedAt;
593
+ const pricesStartedAt = num(p.pricesStartedAt);
594
+ const pricesEndedAt = num(p.pricesEndedAt);
595
+ const bothPrices = pricesStartedAt !== undefined && pricesEndedAt !== undefined;
596
+ return {
597
+ type: "dsl_tick",
598
+ unit,
599
+ tickId,
600
+ startedAt,
601
+ endedAt,
602
+ strategyCount: num(p.strategyCount),
603
+ activePositionCount: num(p.activePositionCount),
604
+ positionsProcessed: num(p.positionsProcessed),
605
+ pricesStartedAt: bothPrices ? pricesStartedAt : undefined,
606
+ pricesEndedAt: bothPrices ? pricesEndedAt : undefined,
607
+ positionKey: str(p.key),
608
+ positionId: str(p.positionId),
609
+ asset: str(p.asset),
610
+ dex: str(p.dex),
611
+ outcome: dslTickOutcome(p.outcome),
612
+ error: str(p.error),
613
+ closeReason: str(p.closeReason),
614
+ attempt: num(p.attempt),
615
+ newSLPrice: num(p.newSLPrice),
616
+ slOrderId: num(p.slOrderId),
617
+ syncReason: str(p.syncReason),
618
+ };
619
+ }
620
+ // ─── Runtime error ───────────────────────────────────────────────────────────
621
+ /** From `signal_processing_error` — a bucket-2 error with no specific domain record home. */
622
+ export function buildRuntimeError(payload, nowMs) {
623
+ const p = asObject(payload);
624
+ if (!p)
625
+ return null;
626
+ const err = p.error;
627
+ let message;
628
+ let errorName;
629
+ let stack;
630
+ if (err instanceof Error) {
631
+ message = err.message;
632
+ errorName = err.name;
633
+ stack = err.stack;
634
+ }
635
+ else {
636
+ const e = asObject(err);
637
+ message = str(e?.message) ?? String(err);
638
+ errorName = str(e?.name);
639
+ stack = str(e?.stack);
640
+ }
641
+ return {
642
+ type: "runtime_error",
643
+ occurredAt: toEpochMs(p.timestamp, nowMs),
644
+ phase: "signal_processing",
645
+ message,
646
+ errorName,
647
+ scannerId: str(p.scannerId),
648
+ runId: str(p.runId),
649
+ stack,
650
+ };
651
+ }
652
+ // ─── Runtime lifecycle ───────────────────────────────────────────────────────
653
+ /**
654
+ * From `tracking.runtime_started`. The `config` blob is the injected **unresolved** config (not the
655
+ * resolved `data.config` on the bus): resolving inlines secrets, and the unresolved form is what the
656
+ * `configHash` is computed over, so blob and hash agree.
657
+ */
658
+ export function buildRuntimeStarted(payload, unresolvedConfig, nowMs) {
659
+ const p = asObject(payload);
660
+ const data = asObject(p?.data);
661
+ if (!data)
662
+ return null;
663
+ return {
664
+ type: "runtime_lifecycle",
665
+ phase: "started",
666
+ occurredAt: toEpochMs(p?.timestamp, nowMs),
667
+ runtimeVersion: str(data.runtimeVersion),
668
+ hasDsl: bool(data.hasDsl),
669
+ scannerCount: num(data.scannerCount),
670
+ actionCount: num(data.actionCount),
671
+ config: unresolvedConfig,
672
+ };
673
+ }
674
+ /** From `tracking.runtime_stopped`. */
675
+ export function buildRuntimeStopped(payload, nowMs) {
676
+ const p = asObject(payload);
677
+ const data = asObject(p?.data);
678
+ if (!data)
679
+ return null;
680
+ return {
681
+ type: "runtime_lifecycle",
682
+ phase: "stopped",
683
+ occurredAt: toEpochMs(p?.timestamp, nowMs),
684
+ runtimeVersion: str(data.runtimeVersion),
685
+ uptimeMs: num(data.uptimeMs),
686
+ };
687
+ }
688
+ // ─── Runtime state (self-pause) ──────────────────────────────────────────────
689
+ /** From the self-pause HookEvents (`on_strategy_self_paused`/`on_daily_limit_hit`/`on_drawdown_cap_hit`). */
690
+ export function buildRuntimePaused(payload, fallbackGateId, nowMs) {
691
+ const p = asObject(payload);
692
+ const data = asObject(p?.data);
693
+ if (!data)
694
+ return null;
695
+ return {
696
+ type: "runtime_state",
697
+ phase: "paused",
698
+ occurredAt: toEpochMs(p?.timestamp, nowMs),
699
+ gateId: str(data.gateId) ?? fallbackGateId,
700
+ gateName: str(data.gateName),
701
+ source: str(data.source),
702
+ reason: str(data.reason),
703
+ metrics: asObject(data.metrics) ?? null,
704
+ };
705
+ }
706
+ //# sourceMappingURL=record-builders.js.map