@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,202 @@
1
+ /**
2
+ * Intake mount builder — the testable factory for the production mount.
3
+ *
4
+ * Exports:
5
+ * buildIntakeMount(ctx, runtimeHandles, cfg) → { launcher, onAccepted }
6
+ * selectScanners(config) → ExternalScannerSpec[]
7
+ *
8
+ * This module is the unit-testable seam that index.ts calls; it keeps
9
+ * index.ts thin and gives the wiring a clean test surface without forking python.
10
+ */
11
+ import * as fs from "node:fs";
12
+ import * as path from "node:path";
13
+ import { join } from "node:path";
14
+ import { ScannerLauncher } from "./scanner-launcher.js";
15
+ import { sweepOrphans } from "../../runtime/supervisor/orphan-sweep.js";
16
+ // ── intake URL ───────────────────────────────────────────────────────────────
17
+ /**
18
+ * The base URL the scaffold child POSTs to. The child always reaches the
19
+ * runtime over loopback regardless of which interface the server binds, so a
20
+ * wildcard bind host (`0.0.0.0` / `::`) or an empty host is mapped to
21
+ * `127.0.0.1` — `0.0.0.0` is not a valid connect target on macOS, which would
22
+ * silently break the supervised intake path under a non-default bind host.
23
+ */
24
+ export function intakeUrlFor(host, port) {
25
+ const loopback = host === "0.0.0.0" || host === "::" || host === "" ? "127.0.0.1" : host;
26
+ return `http://${loopback}:${port}`;
27
+ }
28
+ // ── buildIntakeMount ───────────────────────────────────────────────────────────────
29
+ /**
30
+ * Build the production launcher + onAccepted closure for one runtime.
31
+ *
32
+ * The `onAccepted` closure:
33
+ * - resolves scanner_id via the shared registry → scannerName + runtimeId,
34
+ * - looks up the runtime handle,
35
+ * - maps IntakeSignal → ExternalScannerIngestRequest,
36
+ * - calls handle.ingestExternalScannerData() fire-and-forget (.catch + log, never throws).
37
+ *
38
+ * The `launcher` is a `ScannerLauncher` built over the SHARED IntakeContext so
39
+ * the route's registry and the launcher's registry are the same object.
40
+ */
41
+ export function buildIntakeMount(ctx, runtimeHandles, cfg) {
42
+ const { logger } = cfg;
43
+ // The production onAccepted closure — maps an intake signal → ingest request.
44
+ const onAccepted = (signal, _correlationId, scannerId) => {
45
+ const entry = ctx.registry.resolve(scannerId);
46
+ if (!entry)
47
+ return; // zombie fence — should not happen post-accept
48
+ const handle = runtimeHandles.get(entry.runtimeId);
49
+ if (!handle)
50
+ return;
51
+ const request = {
52
+ scanner: entry.scannerName, // configured NAME from registry, not scanner_id
53
+ signal_id: signal.signal_id, // greppable handle across intake→ingest (obs only)
54
+ asset: signal.asset,
55
+ direction: signal.direction,
56
+ ...(signal.signal_type !== undefined && { signal_type: signal.signal_type }),
57
+ data: signal.data,
58
+ // Per-signal sizing rides at the top level (parity with the live index.ts
59
+ // closure); the open-position action reads these directly, else a supervised
60
+ // signal's sizing is lost ("no margin source resolved").
61
+ ...(signal.marginPct !== undefined && { marginPct: signal.marginPct }),
62
+ ...(signal.leverage !== undefined && { leverage: signal.leverage }),
63
+ // Intentionally omitted: score (intake has none, defaults to 0 downstream),
64
+ // valid_until/produced_at (acceptance-pipeline concerns, not ingest fields),
65
+ // signals[] (single-signal shape: data, not signals[]).
66
+ };
67
+ // Trace the sizing-relevant fields the narrowed request carries, so a field
68
+ // dropped at this seam is visible instead of vanishing silently.
69
+ logger.debug(`[intake] ingest req signal_id=${signal.signal_id} scanner=${entry.scannerName} asset=${signal.asset} direction=${signal.direction} marginPct=${signal.marginPct} leverage=${signal.leverage}`);
70
+ void handle
71
+ .ingestExternalScannerData(request)
72
+ .then(() => {
73
+ logger.info(`[intake] ingest ok signal_id=${signal.signal_id} scanner=${entry.scannerName} asset=${signal.asset} scanner_id=${scannerId}`);
74
+ })
75
+ .catch((err) => logger.error("[intake] ingest failed", { scannerId, err }));
76
+ };
77
+ // Build the launcher over the SHARED registry/record/liveness so the route
78
+ // and the launcher resolve against the same in-process Map.
79
+ const launcher = new ScannerLauncher({
80
+ runtimeId: cfg.runtimeId,
81
+ wallet: cfg.wallet,
82
+ scanners: cfg.scanners,
83
+ registry: ctx.registry,
84
+ record: ctx.record,
85
+ liveness: ctx.liveness,
86
+ intakeUrl: cfg.intakeUrl,
87
+ scaffoldPackageDir: cfg.scaffoldPackageDir,
88
+ launchConfigDir: cfg.launchConfigDir,
89
+ logger: cfg.logger,
90
+ mintScannerId: cfg.mintScannerId,
91
+ createSupervisor: cfg.createSupervisor,
92
+ onSupervisorEvent: cfg.onSupervisorEvent,
93
+ supervisorOptions: cfg.supervisorOptions,
94
+ });
95
+ return { launcher, onAccepted };
96
+ }
97
+ // ── selectScanners ───────────────────────────────────────────────────────────
98
+ /**
99
+ * Filter a parsed RuntimeConfig to the external scanner specs that should
100
+ * be supervised by the launcher.
101
+ *
102
+ * Returns [] for a config with no external_scanner entries that declare both
103
+ * `path` and `entrypoint`. Selection is by scanner shape only — `version` is
104
+ * ignored metadata and never gates supervision.
105
+ */
106
+ export function selectScanners(config, baseDir) {
107
+ const scanners = config.scanners ?? [];
108
+ const result = [];
109
+ for (const scanner of scanners) {
110
+ if (scanner.type !== "external_scanner")
111
+ continue;
112
+ if (!scanner.path || !scanner.entrypoint)
113
+ continue;
114
+ // v2.0.0: interval_seconds is an integer read directly (no duration-string
115
+ // parse). Default 30 when omitted (design §1).
116
+ const intervalSeconds = typeof scanner.interval_seconds === "number" ? scanner.interval_seconds : 30;
117
+ // signal_data_schema is the per-signal data{} schema (replaces config.fields).
118
+ const fields = (scanner.signal_data_schema ?? {});
119
+ // Resolve a relative scanner path against the recipe's directory, so the
120
+ // scaffold's sys.path is correct regardless of the supervisor's working
121
+ // directory. An absolute path is taken as-is.
122
+ const resolvedPath = baseDir && !path.isAbsolute(scanner.path)
123
+ ? path.resolve(baseDir, scanner.path)
124
+ : scanner.path;
125
+ // ── Loud path/entrypoint validation (external_scanner only; FS check, not Zod). ──
126
+ // Resolve the entrypoint against the resolved scan-module dir and assert the
127
+ // file exists. On miss, throw naming the EXACT expected absolute path so the
128
+ // operator can fix it without guessing (design §4). Only enforced when a recipe
129
+ // dir is supplied — inline YAML (no on-disk recipe) has no directory to resolve
130
+ // a relative path against.
131
+ if (baseDir !== undefined) {
132
+ const expectedEntrypoint = path.resolve(resolvedPath, scanner.entrypoint);
133
+ if (!fs.existsSync(expectedEntrypoint)) {
134
+ throw new Error(`external_scanner "${scanner.name}": entrypoint not found. ` +
135
+ `Expected the scan module at: ${expectedEntrypoint} ` +
136
+ `(resolved from path "${scanner.path}" + entrypoint "${scanner.entrypoint}").`);
137
+ }
138
+ }
139
+ // default_signal_validity_seconds is schema-required (int seconds); read directly.
140
+ const defaultSignalValiditySeconds = scanner.default_signal_validity_seconds;
141
+ const spec = {
142
+ name: scanner.name,
143
+ path: resolvedPath,
144
+ entrypoint: scanner.entrypoint,
145
+ intervalSeconds,
146
+ fields,
147
+ defaultSignalValiditySeconds,
148
+ };
149
+ if (scanner.timeout_seconds !== undefined) {
150
+ spec.timeoutSeconds = scanner.timeout_seconds;
151
+ }
152
+ if (scanner.state_history_max_count !== undefined) {
153
+ spec.stateHistoryMaxCount = scanner.state_history_max_count;
154
+ }
155
+ // Author-tunable knobs (recipe `inputs`) → scan() first arg. Only set when present.
156
+ if (scanner.inputs !== undefined) {
157
+ spec.inputs = scanner.inputs;
158
+ }
159
+ result.push(spec);
160
+ }
161
+ return result;
162
+ }
163
+ /**
164
+ * Build (do NOT start) the launcher for ONE runtime.
165
+ *
166
+ * Returns null for runtimes with no qualifying external scanners. The caller
167
+ * starts the returned launcher after the API is listening (boot) or immediately
168
+ * (hot-install, API already listening).
169
+ *
170
+ * The launcher's constructor eagerly registers all scanners into sharedCtx.registry
171
+ * so the route can resolve them before start() is called. start() then spawns
172
+ * the scaffold children.
173
+ */
174
+ export function wireRuntime(deps) {
175
+ const { runtimeConfig, recipeDir, runtimeId, wallet, sharedCtx, runtimeHandles, intakeUrl, scaffoldPackageDir, runtimeStateDir, logger, mintScannerId, createSupervisor, onSupervisorEvent, supervisorOptions, sweep, } = deps;
176
+ const scanners = selectScanners(runtimeConfig, recipeDir);
177
+ if (scanners.length === 0)
178
+ return null;
179
+ // Sweep orphan scaffold children for this runtime before building a new launcher.
180
+ (sweep ?? sweepOrphans)(runtimeId, logger);
181
+ const { launcher } = buildIntakeMount(sharedCtx, runtimeHandles, {
182
+ runtimeId,
183
+ wallet,
184
+ scanners,
185
+ intakeUrl,
186
+ scaffoldPackageDir,
187
+ launchConfigDir: join(runtimeStateDir, "scanner-launch"),
188
+ logger,
189
+ mintScannerId,
190
+ createSupervisor,
191
+ onSupervisorEvent,
192
+ supervisorOptions,
193
+ });
194
+ // Eagerly register scanners and build supervisors (but do NOT start them).
195
+ // This makes the shared registry immediately observable — the caller can
196
+ // inspect it between wireRuntime() and launcher.start(), and the /signals
197
+ // route can fence unknown scanner_ids before any scaffold child has spawned.
198
+ // start() detects that _buildAndRegister() already ran and skips the repeat.
199
+ launcher._buildAndRegister();
200
+ return launcher;
201
+ }
202
+ //# sourceMappingURL=intake-mount.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intake-mount.js","sourceRoot":"","sources":["../../../src/runtime-api/intake/intake-mount.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Shared liveness seam between the intake route and the LongRunningSupervisor.
3
+ *
4
+ * The route writes via touch(); the supervisor reads via lastAliveAt(). Both
5
+ * reference the same MapLivenessStore instance — no channel, no IPC, just a
6
+ * plain in-process Map.
7
+ *
8
+ * Silence-kill contract (from the supervisor spec). On silence the supervisor
9
+ * kills the scaffold child process (python `-m scaffold`) for that scanner; the
10
+ * resulting exit feeds the normal restart-with-backoff path (subject to the
11
+ * crash-loop guard), which relaunches it:
12
+ * - null → heartbeat not yet started; silence-kill stays disarmed.
13
+ * - 0 → a real epoch-ms timestamp (boundary value, not "never").
14
+ * - >0 → last POST timestamp; kill the scaffold child if
15
+ * Date.now() - ts >= maxSilenceMs.
16
+ */
17
+ export interface LivenessStore {
18
+ /** Called by the route's updateLiveness on every accepted POST. */
19
+ touch(scannerId: string, now: number): void;
20
+ /** Called by the supervisor's lastAliveAt callback on every silence poll. */
21
+ lastAliveAt(scannerId: string): number | null;
22
+ }
23
+ /**
24
+ * Default Map-backed implementation. A future durable store will
25
+ * implement the same interface; swap without touching callers.
26
+ */
27
+ export declare class MapLivenessStore implements LivenessStore {
28
+ private readonly store;
29
+ touch(scannerId: string, now: number): void;
30
+ lastAliveAt(scannerId: string): number | null;
31
+ }
32
+ //# sourceMappingURL=liveness-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"liveness-store.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/intake/liveness-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,6EAA6E;IAC7E,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAI3C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAI9C"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Shared liveness seam between the intake route and the LongRunningSupervisor.
3
+ *
4
+ * The route writes via touch(); the supervisor reads via lastAliveAt(). Both
5
+ * reference the same MapLivenessStore instance — no channel, no IPC, just a
6
+ * plain in-process Map.
7
+ *
8
+ * Silence-kill contract (from the supervisor spec). On silence the supervisor
9
+ * kills the scaffold child process (python `-m scaffold`) for that scanner; the
10
+ * resulting exit feeds the normal restart-with-backoff path (subject to the
11
+ * crash-loop guard), which relaunches it:
12
+ * - null → heartbeat not yet started; silence-kill stays disarmed.
13
+ * - 0 → a real epoch-ms timestamp (boundary value, not "never").
14
+ * - >0 → last POST timestamp; kill the scaffold child if
15
+ * Date.now() - ts >= maxSilenceMs.
16
+ */
17
+ /**
18
+ * Default Map-backed implementation. A future durable store will
19
+ * implement the same interface; swap without touching callers.
20
+ */
21
+ export class MapLivenessStore {
22
+ store = new Map();
23
+ touch(scannerId, now) {
24
+ this.store.set(scannerId, now);
25
+ }
26
+ lastAliveAt(scannerId) {
27
+ const value = this.store.get(scannerId);
28
+ return value !== undefined ? value : null;
29
+ }
30
+ }
31
+ //# sourceMappingURL=liveness-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"liveness-store.js","sourceRoot":"","sources":["../../../src/runtime-api/intake/liveness-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACV,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEnD,KAAK,CAAC,SAAiB,EAAE,GAAW;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;CACF"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * /errors handler.
3
+ *
4
+ * Resolves scanner_id, updates liveness, calls the onError seam.
5
+ */
6
+ import type { ScannerRegistry } from "./scanner-registry.js";
7
+ import type { ErrorsBody, ErrorsResponse } from "./types.js";
8
+ export interface ProcessErrorPostDeps {
9
+ registry: ScannerRegistry;
10
+ now: () => number;
11
+ updateLiveness: (scannerId: string, now: number) => void;
12
+ onError: (scannerId: string, error: Record<string, unknown>) => void;
13
+ }
14
+ export declare function processErrorPost(body: ErrorsBody, deps: ProcessErrorPostDeps): Promise<ErrorsResponse>;
15
+ //# sourceMappingURL=process-error-post.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"process-error-post.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/intake/process-error-post.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,eAAe,CAAC;IAC1B,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACtE;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,cAAc,CAAC,CAezB"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * /errors handler.
3
+ *
4
+ * Resolves scanner_id, updates liveness, calls the onError seam.
5
+ */
6
+ export async function processErrorPost(body, deps) {
7
+ // Resolve scanner_id.
8
+ const entry = deps.registry.resolve(body.scanner_id);
9
+ if (!entry) {
10
+ return { ok: false, reason: "UNKNOWN_SCANNER" };
11
+ }
12
+ // Update liveness (it ran, it failed → still alive).
13
+ const now = deps.now();
14
+ deps.updateLiveness(body.scanner_id, now);
15
+ // Call the seam.
16
+ deps.onError(body.scanner_id, body.error);
17
+ return { ok: true };
18
+ }
19
+ //# sourceMappingURL=process-error-post.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"process-error-post.js","sourceRoot":"","sources":["../../../src/runtime-api/intake/process-error-post.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAgB,EAChB,IAA0B;IAE1B,sBAAsB;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAClD,CAAC;IAED,qDAAqD;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAE1C,iBAAiB;IACjB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAE1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Signal intake POST-level + per-signal pipeline.
3
+ *
4
+ * Pure-ish: takes deps (registry, acceptance record, clock, etc.),
5
+ * returns the response object. No Fastify.
6
+ *
7
+ * Pipeline:
8
+ * 1. Shape valid → assumed guaranteed by TypeBox at route level.
9
+ * 2. scanner_id known? → POST-level reject if unknown.
10
+ * 3. Update liveness clock.
11
+ * 4. Empty signals list? → no-op, return empty array.
12
+ * 5–9. Per signal, independently:
13
+ * 5. Well-formed (asset, direction, produced_at, valid_until, data)?
14
+ * 6. Still valid in time? (now < valid_until).
15
+ * 7. Newer than acceptance record?
16
+ * 8. Data matches config.fields?
17
+ * 9. Accepted → mint correlationId, persist record (high-water-mark), THEN
18
+ * call onAccepted seam (persist-before-act: a persist failure dispatches
19
+ * no trade, preventing a double-trade on retry).
20
+ */
21
+ import type { AcceptanceRecord } from "./acceptance-record.js";
22
+ import type { ScannerRegistry } from "./scanner-registry.js";
23
+ import type { SignalsBody, IntakeSignal, PerSignalStatus } from "./types.js";
24
+ export interface ProcessSignalPostDeps {
25
+ registry: ScannerRegistry;
26
+ record: AcceptanceRecord;
27
+ now: () => number;
28
+ mintCorrelationId: () => string;
29
+ updateLiveness: (scannerId: string, now: number) => void;
30
+ onAccepted: (signal: IntakeSignal, correlationId: string, scannerId: string) => void;
31
+ }
32
+ export type ProcessSignalPostResult = {
33
+ ok: true;
34
+ signals: PerSignalStatus[];
35
+ } | {
36
+ ok: false;
37
+ reason: string;
38
+ };
39
+ /**
40
+ * Process a signal POST, applying the full acceptance pipeline.
41
+ * Returns per-signal statuses in input order.
42
+ */
43
+ /**
44
+ * The acceptance high-water-mark is keyed by the scanner's STABLE identity
45
+ * (runtime + scanner name), NOT the ephemeral scanner_id. A relaunch mints a
46
+ * new scanner_id; keying on it would reset the high-water-mark and let a
47
+ * replayed / already-accepted signal be accepted again under the new id.
48
+ */
49
+ export declare function acceptanceKeyFor(entry: {
50
+ runtimeId: string;
51
+ scannerName: string;
52
+ }): string;
53
+ /**
54
+ * Asset-slot key under which a SEEN signal_id is recorded in the AcceptanceRecord.
55
+ *
56
+ * The signal_id dedup layer is ADDITIVE on top of the per-(scanner,asset,
57
+ * produced_at) high-water-mark. To persist it across POSTs without a separate
58
+ * store (and so it rides the SAME durable seam as the high-water-mark — surviving
59
+ * a restart with FileAcceptanceRecord), each accepted signal_id is recorded as a
60
+ * reserved pseudo-"asset" slot in the record. The leading-space " sigid " prefix
61
+ * cannot collide with a real asset symbol (asset names are trimmed, non-empty,
62
+ * and never carry a leading space), so this never shadows a genuine
63
+ * (scanner,asset) mark.
64
+ */
65
+ /**
66
+ * Reserved key prefix for signal_id dedup slots. The leading space is what makes
67
+ * the slot keyspace disjoint from real asset symbols (which are trimmed and never
68
+ * carry a leading space). Slots are pruned by matching this prefix.
69
+ */
70
+ export declare const SIGNAL_ID_SLOT_PREFIX = " sigid ";
71
+ export declare function signalIdSlot(signalId: string): string;
72
+ export declare function processSignalPost(body: SignalsBody, deps: ProcessSignalPostDeps): Promise<ProcessSignalPostResult>;
73
+ //# sourceMappingURL=process-signal-post.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"process-signal-post.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/intake/process-signal-post.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACtF;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;GAGG;AACH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAET;AAED;;;;;;;;;;;GAWG;AACH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,uBAAuB,CAAC,CA0BlC"}
@@ -0,0 +1,188 @@
1
+ /**
2
+ * Signal intake POST-level + per-signal pipeline.
3
+ *
4
+ * Pure-ish: takes deps (registry, acceptance record, clock, etc.),
5
+ * returns the response object. No Fastify.
6
+ *
7
+ * Pipeline:
8
+ * 1. Shape valid → assumed guaranteed by TypeBox at route level.
9
+ * 2. scanner_id known? → POST-level reject if unknown.
10
+ * 3. Update liveness clock.
11
+ * 4. Empty signals list? → no-op, return empty array.
12
+ * 5–9. Per signal, independently:
13
+ * 5. Well-formed (asset, direction, produced_at, valid_until, data)?
14
+ * 6. Still valid in time? (now < valid_until).
15
+ * 7. Newer than acceptance record?
16
+ * 8. Data matches config.fields?
17
+ * 9. Accepted → mint correlationId, persist record (high-water-mark), THEN
18
+ * call onAccepted seam (persist-before-act: a persist failure dispatches
19
+ * no trade, preventing a double-trade on retry).
20
+ */
21
+ import { validateDataAgainstFieldSchema, ExternalScannerIngestError, } from "../../scanners/external-scanner-receiver.js";
22
+ /**
23
+ * Process a signal POST, applying the full acceptance pipeline.
24
+ * Returns per-signal statuses in input order.
25
+ */
26
+ /**
27
+ * The acceptance high-water-mark is keyed by the scanner's STABLE identity
28
+ * (runtime + scanner name), NOT the ephemeral scanner_id. A relaunch mints a
29
+ * new scanner_id; keying on it would reset the high-water-mark and let a
30
+ * replayed / already-accepted signal be accepted again under the new id.
31
+ */
32
+ export function acceptanceKeyFor(entry) {
33
+ return `${entry.runtimeId} ${entry.scannerName}`;
34
+ }
35
+ /**
36
+ * Asset-slot key under which a SEEN signal_id is recorded in the AcceptanceRecord.
37
+ *
38
+ * The signal_id dedup layer is ADDITIVE on top of the per-(scanner,asset,
39
+ * produced_at) high-water-mark. To persist it across POSTs without a separate
40
+ * store (and so it rides the SAME durable seam as the high-water-mark — surviving
41
+ * a restart with FileAcceptanceRecord), each accepted signal_id is recorded as a
42
+ * reserved pseudo-"asset" slot in the record. The leading-space " sigid " prefix
43
+ * cannot collide with a real asset symbol (asset names are trimmed, non-empty,
44
+ * and never carry a leading space), so this never shadows a genuine
45
+ * (scanner,asset) mark.
46
+ */
47
+ /**
48
+ * Reserved key prefix for signal_id dedup slots. The leading space is what makes
49
+ * the slot keyspace disjoint from real asset symbols (which are trimmed and never
50
+ * carry a leading space). Slots are pruned by matching this prefix.
51
+ */
52
+ export const SIGNAL_ID_SLOT_PREFIX = " sigid ";
53
+ export function signalIdSlot(signalId) {
54
+ return `${SIGNAL_ID_SLOT_PREFIX}${signalId}`;
55
+ }
56
+ export async function processSignalPost(body, deps) {
57
+ // Step 2: scanner_id known?
58
+ const entry = deps.registry.resolve(body.scanner_id);
59
+ if (!entry) {
60
+ return { ok: false, reason: "UNKNOWN_SCANNER" };
61
+ }
62
+ // Step 3: Update liveness clock.
63
+ const now = deps.now();
64
+ deps.updateLiveness(body.scanner_id, now);
65
+ // Step 4: Empty signals list → no-op.
66
+ const signals = body.signals ?? [];
67
+ if (signals.length === 0) {
68
+ return { ok: true, signals: [] };
69
+ }
70
+ // Per-signal pipeline.
71
+ const results = [];
72
+ for (const signal of signals) {
73
+ const status = processOneSignal(signal, entry, deps, now);
74
+ results.push(status);
75
+ }
76
+ return { ok: true, signals: results };
77
+ }
78
+ /**
79
+ * Process one signal through the acceptance pipeline.
80
+ * Each step is independent; errors become rejected statuses, not thrown.
81
+ */
82
+ function processOneSignal(signal, entry, deps, now) {
83
+ // The acceptance high-water-mark is keyed by the scanner's STABLE identity
84
+ // (runtime + scanner name), NOT the ephemeral scanner_id. A relaunch mints a
85
+ // new scanner_id; keying on it would reset the high-water-mark and let a
86
+ // replayed/already-accepted signal be accepted again under the new id.
87
+ const acceptanceKey = acceptanceKeyFor(entry);
88
+ // Step 5: Well-formed?
89
+ const wellFormed = isWellFormed(signal, now);
90
+ if (!wellFormed.ok) {
91
+ return { status: "rejected", reason: wellFormed.reason };
92
+ }
93
+ // Step 6: Still valid in time? (Check this BEFORE the superseded checks below.)
94
+ if (now >= signal.valid_until) {
95
+ return { status: "expired" };
96
+ }
97
+ // Step 6b: signal_id dedup — the ADDITIVE layer (sits ALONGSIDE the high-water
98
+ // mark below, never replaces it). If this exact producer id was already
99
+ // accepted, the producer's idempotency key has already won: dedup it. This is
100
+ // the case the high-water-mark CANNOT catch — a replay that reuses the same
101
+ // signal_id but carries a strictly NEWER produced_at would otherwise advance the
102
+ // mark and double-trade. A FRESH signal_id (e.g. a recompute after state loss)
103
+ // is NOT caught here and correctly falls through to the high-water-mark.
104
+ if (deps.record.get(acceptanceKey, signalIdSlot(signal.signal_id)) !== undefined) {
105
+ return { status: "superseded" };
106
+ }
107
+ // Step 7: Newer than the acceptance record? (the per-(scanner,asset,produced_at)
108
+ // high-water-mark — UNCHANGED, still fires under a fresh signal_id.)
109
+ const prev = deps.record.get(acceptanceKey, signal.asset);
110
+ if (prev !== undefined && signal.produced_at <= prev) {
111
+ return { status: "superseded" };
112
+ }
113
+ // Step 8: Data matches config.fields?
114
+ try {
115
+ validateDataAgainstFieldSchema(entry.scannerName, signal.data, entry.fields);
116
+ }
117
+ catch (err) {
118
+ const message = err instanceof ExternalScannerIngestError ? err.message : String(err);
119
+ return { status: "rejected", reason: message };
120
+ }
121
+ // Step 9: Accepted. Persist-before-act: advance the
122
+ // high-water-mark FIRST, then dispatch the trade. record.set() can throw on a
123
+ // disk/rename failure; if it does, onAccepted is never reached, so NO trade is
124
+ // dispatched. Dispatching first would leave a trade fired against an
125
+ // un-persisted mark — a retry would re-accept and DOUBLE-TRADE. This reorder
126
+ // converts that into the safer lost-signal direction (a persist failure drops
127
+ // the signal rather than risking a duplicate execution), and makes true the
128
+ // invariant documented in acceptance-record.ts (mark durable before acted on).
129
+ //
130
+ // PARTIAL FIX: this closes the persist-vs-dispatch window only. Full
131
+ // no-double-execution still requires submit-side idempotency — an exchange
132
+ // idempotency key + reconcile for a crash mid-submit (untracked follow-up,
133
+ // cross-repo) — to guard against a dispatch that itself partially succeeds;
134
+ // not attempted here.
135
+ const correlationId = deps.mintCorrelationId();
136
+ deps.record.set(acceptanceKey, signal.asset, signal.produced_at);
137
+ // Bound the additive dedup layer: drop every expired signal_id slot under this
138
+ // key before recording the new one. Retention is bounded by the active validity
139
+ // window, not by total signals ever seen. Safe because step 6 rejects any
140
+ // expired signal BEFORE the dedup check, so a pruned signal_id can never be
141
+ // re-accepted while still valid. Assumes a given signal_id carries a stable
142
+ // valid_until (a recompute mints a fresh signal_id — see step 6b), so pruning at
143
+ // valid_until cannot drop a slot still needed.
144
+ deps.record.pruneExpiredSlots(acceptanceKey, SIGNAL_ID_SLOT_PREFIX, now);
145
+ // Record the signal_id as seen (the additive dedup layer), persist-before-act
146
+ // like the high-water-mark: if either set() throws on a disk failure, no trade
147
+ // is dispatched. The value stored is valid_until so the slot is prunable by its
148
+ // own expiry (step 6b only existence-checks it, never compares the value).
149
+ deps.record.set(acceptanceKey, signalIdSlot(signal.signal_id), signal.valid_until);
150
+ deps.onAccepted(signal, correlationId, entry.scannerId);
151
+ return { status: "accepted", correlationId };
152
+ }
153
+ /**
154
+ * Check if a signal is well-formed.
155
+ * Returns { ok: true } or { ok: false, reason: string }.
156
+ */
157
+ function isWellFormed(signal, now) {
158
+ // signal_id: non-empty string (the dedup key — an empty/missing id would
159
+ // collapse every such signal into one dedup bucket).
160
+ if (typeof signal.signal_id !== "string" || signal.signal_id.trim().length === 0) {
161
+ return { ok: false, reason: "signal_id must be a non-empty string" };
162
+ }
163
+ // asset: non-empty string
164
+ if (typeof signal.asset !== "string" || signal.asset.length === 0) {
165
+ return { ok: false, reason: "asset must be a non-empty string" };
166
+ }
167
+ // direction: LONG or SHORT (not null, not missing)
168
+ if (signal.direction !== "LONG" && signal.direction !== "SHORT") {
169
+ return { ok: false, reason: "direction must be LONG or SHORT" };
170
+ }
171
+ // produced_at: finite number, not in the future
172
+ if (typeof signal.produced_at !== "number" || !Number.isFinite(signal.produced_at)) {
173
+ return { ok: false, reason: "produced_at must be a finite number" };
174
+ }
175
+ if (signal.produced_at > now) {
176
+ return { ok: false, reason: "produced_at must not be in the future" };
177
+ }
178
+ // valid_until: finite number
179
+ if (typeof signal.valid_until !== "number" || !Number.isFinite(signal.valid_until)) {
180
+ return { ok: false, reason: "valid_until must be a finite number" };
181
+ }
182
+ // data: object
183
+ if (!signal.data || typeof signal.data !== "object" || Array.isArray(signal.data)) {
184
+ return { ok: false, reason: "data must be an object" };
185
+ }
186
+ return { ok: true };
187
+ }
188
+ //# sourceMappingURL=process-signal-post.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"process-signal-post.js","sourceRoot":"","sources":["../../../src/runtime-api/intake/process-signal-post.ts"],"names":[],"mappings":"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"}