@senpi-ai/runtime 1.1.2 → 3.0.3

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 (481) 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 +161 -26
  13. package/dist/actions/open-position/open-position.action.js.map +1 -1
  14. package/dist/actions/position-tracker/position-tracker.action.d.ts +6 -0
  15. package/dist/actions/position-tracker/position-tracker.action.d.ts.map +1 -1
  16. package/dist/actions/position-tracker/position-tracker.action.js +48 -0
  17. package/dist/actions/position-tracker/position-tracker.action.js.map +1 -1
  18. package/dist/actions/tracking-helpers.d.ts +16 -1
  19. package/dist/actions/tracking-helpers.d.ts.map +1 -1
  20. package/dist/actions/tracking-helpers.js +55 -9
  21. package/dist/actions/tracking-helpers.js.map +1 -1
  22. package/dist/actions/types.d.ts +10 -2
  23. package/dist/actions/types.d.ts.map +1 -1
  24. package/dist/actions/types.js +8 -0
  25. package/dist/actions/types.js.map +1 -1
  26. package/dist/cli/guide-commands.d.ts.map +1 -1
  27. package/dist/cli/guide-commands.js +84 -82
  28. package/dist/cli/guide-commands.js.map +1 -1
  29. package/dist/cli/senpi-commands.d.ts.map +1 -1
  30. package/dist/cli/senpi-commands.js +16 -110
  31. package/dist/cli/senpi-commands.js.map +1 -1
  32. package/dist/constants/dsl/index.d.ts +2 -0
  33. package/dist/constants/dsl/index.d.ts.map +1 -1
  34. package/dist/constants/dsl/index.js +2 -0
  35. package/dist/constants/dsl/index.js.map +1 -1
  36. package/dist/dsl/config/parse-tiers.d.ts.map +1 -1
  37. package/dist/dsl/config/parse-tiers.js +6 -2
  38. package/dist/dsl/config/parse-tiers.js.map +1 -1
  39. package/dist/dsl/engine-client/config-mapping.d.ts +3 -1
  40. package/dist/dsl/engine-client/config-mapping.d.ts.map +1 -1
  41. package/dist/dsl/engine-client/config-mapping.js +3 -1
  42. package/dist/dsl/engine-client/config-mapping.js.map +1 -1
  43. package/dist/dsl/engine-client/event-mapping.d.ts +2 -0
  44. package/dist/dsl/engine-client/event-mapping.d.ts.map +1 -1
  45. package/dist/dsl/engine-client/event-mapping.js +3 -0
  46. package/dist/dsl/engine-client/event-mapping.js.map +1 -1
  47. package/dist/dsl/events/build-closed-event.d.ts.map +1 -1
  48. package/dist/dsl/events/build-closed-event.js +1 -0
  49. package/dist/dsl/events/build-closed-event.js.map +1 -1
  50. package/dist/dsl/events/guards.d.ts.map +1 -1
  51. package/dist/dsl/events/guards.js +10 -0
  52. package/dist/dsl/events/guards.js.map +1 -1
  53. package/dist/dsl/events/handlers.d.ts +18 -2
  54. package/dist/dsl/events/handlers.d.ts.map +1 -1
  55. package/dist/dsl/events/handlers.js +304 -208
  56. package/dist/dsl/events/handlers.js.map +1 -1
  57. package/dist/dsl/events/initial-state.d.ts.map +1 -1
  58. package/dist/dsl/events/initial-state.js +3 -1
  59. package/dist/dsl/events/initial-state.js.map +1 -1
  60. package/dist/dsl/monitor/create-monitor.d.ts +15 -0
  61. package/dist/dsl/monitor/create-monitor.d.ts.map +1 -1
  62. package/dist/dsl/monitor/create-monitor.js +76 -9
  63. package/dist/dsl/monitor/create-monitor.js.map +1 -1
  64. package/dist/dsl/monitor/process-one-position.d.ts.map +1 -1
  65. package/dist/dsl/monitor/process-one-position.js +268 -82
  66. package/dist/dsl/monitor/process-one-position.js.map +1 -1
  67. package/dist/dsl/plugin/index.d.ts +16 -1
  68. package/dist/dsl/plugin/index.d.ts.map +1 -1
  69. package/dist/dsl/plugin/index.js +35 -4
  70. package/dist/dsl/plugin/index.js.map +1 -1
  71. package/dist/dsl/plugin/options.d.ts +18 -0
  72. package/dist/dsl/plugin/options.d.ts.map +1 -1
  73. package/dist/index.d.ts +14 -1
  74. package/dist/index.d.ts.map +1 -1
  75. package/dist/index.js +272 -32
  76. package/dist/index.js.map +1 -1
  77. package/dist/recording/emitter.d.ts +27 -0
  78. package/dist/recording/emitter.d.ts.map +1 -0
  79. package/dist/recording/emitter.js +2 -0
  80. package/dist/recording/emitter.js.map +1 -0
  81. package/dist/recording/identity.d.ts +34 -0
  82. package/dist/recording/identity.d.ts.map +1 -0
  83. package/dist/recording/identity.js +2 -0
  84. package/dist/recording/identity.js.map +1 -0
  85. package/dist/recording/index.d.ts +11 -0
  86. package/dist/recording/index.d.ts.map +1 -0
  87. package/dist/recording/index.js +2 -0
  88. package/dist/recording/index.js.map +1 -0
  89. package/dist/recording/noop-emitter.d.ts +23 -0
  90. package/dist/recording/noop-emitter.d.ts.map +1 -0
  91. package/dist/recording/noop-emitter.js +22 -0
  92. package/dist/recording/noop-emitter.js.map +1 -0
  93. package/dist/recording/otel/attributes.d.ts +35 -0
  94. package/dist/recording/otel/attributes.d.ts.map +1 -0
  95. package/dist/recording/otel/attributes.js +131 -0
  96. package/dist/recording/otel/attributes.js.map +1 -0
  97. package/dist/recording/otel/constants.d.ts +123 -0
  98. package/dist/recording/otel/constants.d.ts.map +1 -0
  99. package/dist/recording/otel/constants.js +172 -0
  100. package/dist/recording/otel/constants.js.map +1 -0
  101. package/dist/recording/otel/ids.d.ts +25 -0
  102. package/dist/recording/otel/ids.d.ts.map +1 -0
  103. package/dist/recording/otel/ids.js +37 -0
  104. package/dist/recording/otel/ids.js.map +1 -0
  105. package/dist/recording/otel/index.d.ts +13 -0
  106. package/dist/recording/otel/index.d.ts.map +1 -0
  107. package/dist/recording/otel/index.js +9 -0
  108. package/dist/recording/otel/index.js.map +1 -0
  109. package/dist/recording/otel/mappers.d.ts +100 -0
  110. package/dist/recording/otel/mappers.d.ts.map +1 -0
  111. package/dist/recording/otel/mappers.js +683 -0
  112. package/dist/recording/otel/mappers.js.map +1 -0
  113. package/dist/recording/otel/otel-emitter.d.ts +43 -0
  114. package/dist/recording/otel/otel-emitter.d.ts.map +1 -0
  115. package/dist/recording/otel/otel-emitter.js +99 -0
  116. package/dist/recording/otel/otel-emitter.js.map +1 -0
  117. package/dist/recording/otel/redaction.d.ts +47 -0
  118. package/dist/recording/otel/redaction.d.ts.map +1 -0
  119. package/dist/recording/otel/redaction.js +88 -0
  120. package/dist/recording/otel/redaction.js.map +1 -0
  121. package/dist/recording/records.d.ts +565 -0
  122. package/dist/recording/records.d.ts.map +1 -0
  123. package/dist/recording/records.js +14 -0
  124. package/dist/recording/records.js.map +1 -0
  125. package/dist/recording/transport/batcher.d.ts +59 -0
  126. package/dist/recording/transport/batcher.d.ts.map +1 -0
  127. package/dist/recording/transport/batcher.js +234 -0
  128. package/dist/recording/transport/batcher.js.map +1 -0
  129. package/dist/recording/transport/client.d.ts +41 -0
  130. package/dist/recording/transport/client.d.ts.map +1 -0
  131. package/dist/recording/transport/client.js +69 -0
  132. package/dist/recording/transport/client.js.map +1 -0
  133. package/dist/recording/transport/config.d.ts +53 -0
  134. package/dist/recording/transport/config.d.ts.map +1 -0
  135. package/dist/recording/transport/config.js +41 -0
  136. package/dist/recording/transport/config.js.map +1 -0
  137. package/dist/recording/transport/index.d.ts +16 -0
  138. package/dist/recording/transport/index.d.ts.map +1 -0
  139. package/dist/recording/transport/index.js +12 -0
  140. package/dist/recording/transport/index.js.map +1 -0
  141. package/dist/recording/transport/rows.d.ts +88 -0
  142. package/dist/recording/transport/rows.d.ts.map +1 -0
  143. package/dist/recording/transport/rows.js +15 -0
  144. package/dist/recording/transport/rows.js.map +1 -0
  145. package/dist/recording/wiring/emitter-factory.d.ts +39 -0
  146. package/dist/recording/wiring/emitter-factory.d.ts.map +1 -0
  147. package/dist/recording/wiring/emitter-factory.js +62 -0
  148. package/dist/recording/wiring/emitter-factory.js.map +1 -0
  149. package/dist/recording/wiring/identity.d.ts +27 -0
  150. package/dist/recording/wiring/identity.d.ts.map +1 -0
  151. package/dist/recording/wiring/identity.js +51 -0
  152. package/dist/recording/wiring/identity.js.map +1 -0
  153. package/dist/recording/wiring/index.d.ts +12 -0
  154. package/dist/recording/wiring/index.d.ts.map +1 -0
  155. package/dist/recording/wiring/index.js +9 -0
  156. package/dist/recording/wiring/index.js.map +1 -0
  157. package/dist/recording/wiring/record-builders.d.ts +107 -0
  158. package/dist/recording/wiring/record-builders.d.ts.map +1 -0
  159. package/dist/recording/wiring/record-builders.js +706 -0
  160. package/dist/recording/wiring/record-builders.js.map +1 -0
  161. package/dist/recording/wiring/subscriber.d.ts +28 -0
  162. package/dist/recording/wiring/subscriber.d.ts.map +1 -0
  163. package/dist/recording/wiring/subscriber.js +173 -0
  164. package/dist/recording/wiring/subscriber.js.map +1 -0
  165. package/dist/recording/wiring/values.d.ts +19 -0
  166. package/dist/recording/wiring/values.d.ts.map +1 -0
  167. package/dist/recording/wiring/values.js +49 -0
  168. package/dist/recording/wiring/values.js.map +1 -0
  169. package/dist/runtime/auto-update/command-runner.d.ts.map +1 -1
  170. package/dist/runtime/auto-update/command-runner.js +5 -1
  171. package/dist/runtime/auto-update/command-runner.js.map +1 -1
  172. package/dist/runtime/auto-update/resolve-package-name.d.ts +10 -0
  173. package/dist/runtime/auto-update/resolve-package-name.d.ts.map +1 -0
  174. package/dist/runtime/auto-update/resolve-package-name.js +35 -0
  175. package/dist/runtime/auto-update/resolve-package-name.js.map +1 -0
  176. package/dist/runtime/auto-update/run-update-command.d.ts +2 -0
  177. package/dist/runtime/auto-update/run-update-command.d.ts.map +1 -0
  178. package/dist/runtime/auto-update/run-update-command.js +37 -0
  179. package/dist/runtime/auto-update/run-update-command.js.map +1 -0
  180. package/dist/runtime/create-runtime-context.d.ts +2 -0
  181. package/dist/runtime/create-runtime-context.d.ts.map +1 -1
  182. package/dist/runtime/create-runtime-context.js +1 -0
  183. package/dist/runtime/create-runtime-context.js.map +1 -1
  184. package/dist/runtime/create-scanner-module.d.ts +4 -3
  185. package/dist/runtime/create-scanner-module.d.ts.map +1 -1
  186. package/dist/runtime/create-scanner-module.js +14 -5
  187. package/dist/runtime/create-scanner-module.js.map +1 -1
  188. package/dist/runtime/create-scanner-providers-for-run.d.ts.map +1 -1
  189. package/dist/runtime/create-scanner-providers-for-run.js +12 -1
  190. package/dist/runtime/create-scanner-providers-for-run.js.map +1 -1
  191. package/dist/runtime/load-runtime-config.d.ts +9 -0
  192. package/dist/runtime/load-runtime-config.d.ts.map +1 -1
  193. package/dist/runtime/load-runtime-config.js +41 -8
  194. package/dist/runtime/load-runtime-config.js.map +1 -1
  195. package/dist/runtime/map-strategies-registration.js +7 -8
  196. package/dist/runtime/map-strategies-registration.js.map +1 -1
  197. package/dist/runtime/map-strategies.d.ts.map +1 -1
  198. package/dist/runtime/map-strategies.js +12 -3
  199. package/dist/runtime/map-strategies.js.map +1 -1
  200. package/dist/runtime/recipe-version.d.ts +1 -1
  201. package/dist/runtime/recipe-version.d.ts.map +1 -1
  202. package/dist/runtime/recipe-version.js +1 -1
  203. package/dist/runtime/recipe-version.js.map +1 -1
  204. package/dist/runtime/reconcile-decide.d.ts +73 -0
  205. package/dist/runtime/reconcile-decide.d.ts.map +1 -0
  206. package/dist/runtime/reconcile-decide.js +186 -0
  207. package/dist/runtime/reconcile-decide.js.map +1 -0
  208. package/dist/runtime/reconcile-run.d.ts +62 -0
  209. package/dist/runtime/reconcile-run.d.ts.map +1 -0
  210. package/dist/runtime/reconcile-run.js +173 -0
  211. package/dist/runtime/reconcile-run.js.map +1 -0
  212. package/dist/runtime/reconcile-state.d.ts +44 -0
  213. package/dist/runtime/reconcile-state.d.ts.map +1 -1
  214. package/dist/runtime/reconcile-state.js +80 -44
  215. package/dist/runtime/reconcile-state.js.map +1 -1
  216. package/dist/runtime/risk-guard.d.ts +10 -0
  217. package/dist/runtime/risk-guard.d.ts.map +1 -1
  218. package/dist/runtime/risk-guard.js +23 -24
  219. package/dist/runtime/risk-guard.js.map +1 -1
  220. package/dist/runtime/run.d.ts.map +1 -1
  221. package/dist/runtime/run.js +3 -2
  222. package/dist/runtime/run.js.map +1 -1
  223. package/dist/runtime/runtime-schema.d.ts +4056 -793
  224. package/dist/runtime/runtime-schema.d.ts.map +1 -1
  225. package/dist/runtime/runtime-schema.js +183 -46
  226. package/dist/runtime/runtime-schema.js.map +1 -1
  227. package/dist/runtime/runtime-version.d.ts +3 -6
  228. package/dist/runtime/runtime-version.d.ts.map +1 -1
  229. package/dist/runtime/runtime-version.js +3 -6
  230. package/dist/runtime/runtime-version.js.map +1 -1
  231. package/dist/runtime/runtime.d.ts +47 -0
  232. package/dist/runtime/runtime.d.ts.map +1 -1
  233. package/dist/runtime/runtime.js +517 -134
  234. package/dist/runtime/runtime.js.map +1 -1
  235. package/dist/runtime/scanner-registry.d.ts +1 -1
  236. package/dist/runtime/scanner-registry.d.ts.map +1 -1
  237. package/dist/runtime/scanner-registry.js +3 -12
  238. package/dist/runtime/scanner-registry.js.map +1 -1
  239. package/dist/runtime/strategy-lifecycle.d.ts +45 -0
  240. package/dist/runtime/strategy-lifecycle.d.ts.map +1 -0
  241. package/dist/runtime/strategy-lifecycle.js +117 -0
  242. package/dist/runtime/strategy-lifecycle.js.map +1 -0
  243. package/dist/runtime/strategy-registry.d.ts +6 -0
  244. package/dist/runtime/strategy-registry.d.ts.map +1 -1
  245. package/dist/runtime/strategy-registry.js +1 -0
  246. package/dist/runtime/strategy-registry.js.map +1 -1
  247. package/dist/runtime/supervisor/long-running-supervisor.d.ts +222 -0
  248. package/dist/runtime/supervisor/long-running-supervisor.d.ts.map +1 -0
  249. package/dist/runtime/supervisor/long-running-supervisor.js +625 -0
  250. package/dist/runtime/supervisor/long-running-supervisor.js.map +1 -0
  251. package/dist/runtime/supervisor/orphan-sweep.d.ts +36 -0
  252. package/dist/runtime/supervisor/orphan-sweep.d.ts.map +1 -0
  253. package/dist/runtime/supervisor/orphan-sweep.js +255 -0
  254. package/dist/runtime/supervisor/orphan-sweep.js.map +1 -0
  255. package/dist/runtime/supervisor/supervisor-utils.d.ts +37 -0
  256. package/dist/runtime/supervisor/supervisor-utils.d.ts.map +1 -0
  257. package/dist/runtime/supervisor/supervisor-utils.js +175 -0
  258. package/dist/runtime/supervisor/supervisor-utils.js.map +1 -0
  259. package/dist/runtime-api/handlers/ingest-signals.d.ts +3 -3
  260. package/dist/runtime-api/handlers/ingest-signals.js +3 -3
  261. package/dist/runtime-api/intake/acceptance-record.d.ts +103 -0
  262. package/dist/runtime-api/intake/acceptance-record.d.ts.map +1 -0
  263. package/dist/runtime-api/intake/acceptance-record.js +192 -0
  264. package/dist/runtime-api/intake/acceptance-record.js.map +1 -0
  265. package/dist/runtime-api/intake/intake-context.d.ts +31 -0
  266. package/dist/runtime-api/intake/intake-context.d.ts.map +1 -0
  267. package/dist/runtime-api/intake/intake-context.js +21 -0
  268. package/dist/runtime-api/intake/intake-context.js.map +1 -0
  269. package/dist/runtime-api/intake/intake-mount.d.ts +118 -0
  270. package/dist/runtime-api/intake/intake-mount.d.ts.map +1 -0
  271. package/dist/runtime-api/intake/intake-mount.js +193 -0
  272. package/dist/runtime-api/intake/intake-mount.js.map +1 -0
  273. package/dist/runtime-api/intake/liveness-store.d.ts +32 -0
  274. package/dist/runtime-api/intake/liveness-store.d.ts.map +1 -0
  275. package/dist/runtime-api/intake/liveness-store.js +31 -0
  276. package/dist/runtime-api/intake/liveness-store.js.map +1 -0
  277. package/dist/runtime-api/intake/process-error-post.d.ts +15 -0
  278. package/dist/runtime-api/intake/process-error-post.d.ts.map +1 -0
  279. package/dist/runtime-api/intake/process-error-post.js +19 -0
  280. package/dist/runtime-api/intake/process-error-post.js.map +1 -0
  281. package/dist/runtime-api/intake/process-signal-post.d.ts +73 -0
  282. package/dist/runtime-api/intake/process-signal-post.d.ts.map +1 -0
  283. package/dist/runtime-api/intake/process-signal-post.js +188 -0
  284. package/dist/runtime-api/intake/process-signal-post.js.map +1 -0
  285. package/dist/runtime-api/intake/scanner-launcher.d.ts +133 -0
  286. package/dist/runtime-api/intake/scanner-launcher.d.ts.map +1 -0
  287. package/dist/runtime-api/intake/scanner-launcher.js +204 -0
  288. package/dist/runtime-api/intake/scanner-launcher.js.map +1 -0
  289. package/dist/runtime-api/intake/scanner-registry.d.ts +36 -0
  290. package/dist/runtime-api/intake/scanner-registry.d.ts.map +1 -0
  291. package/dist/runtime-api/intake/scanner-registry.js +29 -0
  292. package/dist/runtime-api/intake/scanner-registry.js.map +1 -0
  293. package/dist/runtime-api/intake/types.d.ts +61 -0
  294. package/dist/runtime-api/intake/types.d.ts.map +1 -0
  295. package/dist/runtime-api/intake/types.js +8 -0
  296. package/dist/runtime-api/intake/types.js.map +1 -0
  297. package/dist/runtime-api/routes/signals.d.ts +20 -40
  298. package/dist/runtime-api/routes/signals.d.ts.map +1 -1
  299. package/dist/runtime-api/routes/signals.js +119 -75
  300. package/dist/runtime-api/routes/signals.js.map +1 -1
  301. package/dist/runtime-api/routes/signals.schema.d.ts +24 -86
  302. package/dist/runtime-api/routes/signals.schema.d.ts.map +1 -1
  303. package/dist/runtime-api/routes/signals.schema.js +35 -50
  304. package/dist/runtime-api/routes/signals.schema.js.map +1 -1
  305. package/dist/runtime-api/server.d.ts +15 -6
  306. package/dist/runtime-api/server.d.ts.map +1 -1
  307. package/dist/runtime-api/server.js +12 -12
  308. package/dist/runtime-api/server.js.map +1 -1
  309. package/dist/scanners/events.d.ts +6 -0
  310. package/dist/scanners/events.d.ts.map +1 -1
  311. package/dist/scanners/events.js.map +1 -1
  312. package/dist/scanners/external/scaffold/__init__.py +16 -0
  313. package/dist/scanners/external/scaffold/__main__.py +155 -0
  314. package/dist/scanners/external/scaffold/ctx.py +78 -0
  315. package/dist/scanners/external/scaffold/delivery.py +263 -0
  316. package/dist/scanners/external/scaffold/entrypoint_loader.py +151 -0
  317. package/dist/scanners/external/scaffold/http_post.py +70 -0
  318. package/dist/scanners/external/scaffold/journal.py +247 -0
  319. package/dist/scanners/external/scaffold/loop_primitives.py +65 -0
  320. package/dist/scanners/external/scaffold/requirements.txt +11 -0
  321. package/dist/scanners/external/scaffold/scaffold.py +361 -0
  322. package/dist/scanners/external/scaffold/scaffold_state.py +114 -0
  323. package/dist/scanners/external/scaffold/senpi_mcp.py +250 -0
  324. package/dist/scanners/external/scaffold/signal_envelope.py +220 -0
  325. package/dist/scanners/external/scaffold/state_manager.py +175 -0
  326. package/dist/scanners/external-scanner-receiver.d.ts +17 -1
  327. package/dist/scanners/external-scanner-receiver.d.ts.map +1 -1
  328. package/dist/scanners/external-scanner-receiver.js +16 -3
  329. package/dist/scanners/external-scanner-receiver.js.map +1 -1
  330. package/dist/scanners/implementations/external-scanner.d.ts.map +1 -1
  331. package/dist/scanners/implementations/external-scanner.js +7 -1
  332. package/dist/scanners/implementations/external-scanner.js.map +1 -1
  333. package/dist/scanners/implementations/momentum.d.ts.map +1 -1
  334. package/dist/scanners/implementations/momentum.js +16 -0
  335. package/dist/scanners/implementations/momentum.js.map +1 -1
  336. package/dist/scanners/runtime-module.d.ts.map +1 -1
  337. package/dist/scanners/runtime-module.js +9 -1
  338. package/dist/scanners/runtime-module.js.map +1 -1
  339. package/dist/scripts/run-dsl-standalone-live.d.ts +1 -1
  340. package/dist/scripts/run-dsl-standalone-live.js +5 -3
  341. package/dist/scripts/run-dsl-standalone-live.js.map +1 -1
  342. package/dist/senpi/client.d.ts +56 -4
  343. package/dist/senpi/client.d.ts.map +1 -1
  344. package/dist/senpi/client.js +123 -24
  345. package/dist/senpi/client.js.map +1 -1
  346. package/dist/senpi/index.d.ts +2 -1
  347. package/dist/senpi/index.d.ts.map +1 -1
  348. package/dist/senpi/index.js +1 -1
  349. package/dist/senpi/index.js.map +1 -1
  350. package/dist/senpi/types.d.ts +1 -2
  351. package/dist/senpi/types.d.ts.map +1 -1
  352. package/dist/state/state-manager.d.ts +17 -0
  353. package/dist/state/state-manager.d.ts.map +1 -1
  354. package/dist/state/state-manager.js +55 -4
  355. package/dist/state/state-manager.js.map +1 -1
  356. package/dist/strategy/strategy-state.d.ts +9 -1
  357. package/dist/strategy/strategy-state.d.ts.map +1 -1
  358. package/dist/strategy/strategy-state.js +62 -9
  359. package/dist/strategy/strategy-state.js.map +1 -1
  360. package/dist/tracking/build-rehydrate-items.d.ts +15 -0
  361. package/dist/tracking/build-rehydrate-items.d.ts.map +1 -0
  362. package/dist/tracking/build-rehydrate-items.js +19 -0
  363. package/dist/tracking/build-rehydrate-items.js.map +1 -0
  364. package/dist/tracking/constants.d.ts.map +1 -1
  365. package/dist/tracking/constants.js +2 -0
  366. package/dist/tracking/constants.js.map +1 -1
  367. package/dist/tracking/index.d.ts +3 -0
  368. package/dist/tracking/index.d.ts.map +1 -1
  369. package/dist/tracking/index.js +2 -0
  370. package/dist/tracking/index.js.map +1 -1
  371. package/dist/tracking/position-id-registry.d.ts +69 -0
  372. package/dist/tracking/position-id-registry.d.ts.map +1 -0
  373. package/dist/tracking/position-id-registry.js +139 -0
  374. package/dist/tracking/position-id-registry.js.map +1 -0
  375. package/dist/tracking/spans/fan-out-span-transport.d.ts +22 -0
  376. package/dist/tracking/spans/fan-out-span-transport.d.ts.map +1 -0
  377. package/dist/tracking/spans/fan-out-span-transport.js +49 -0
  378. package/dist/tracking/spans/fan-out-span-transport.js.map +1 -0
  379. package/dist/tracking/spans/otel/fit-row-budget.d.ts +22 -0
  380. package/dist/tracking/spans/otel/fit-row-budget.d.ts.map +1 -0
  381. package/dist/tracking/spans/otel/fit-row-budget.js +91 -0
  382. package/dist/tracking/spans/otel/fit-row-budget.js.map +1 -0
  383. package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts +16 -0
  384. package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts.map +1 -0
  385. package/dist/tracking/spans/otel/map-span-to-trace-row.js +227 -0
  386. package/dist/tracking/spans/otel/map-span-to-trace-row.js.map +1 -0
  387. package/dist/tracking/spans/otel/recording-span-transport.d.ts +43 -0
  388. package/dist/tracking/spans/otel/recording-span-transport.d.ts.map +1 -0
  389. package/dist/tracking/spans/otel/recording-span-transport.js +67 -0
  390. package/dist/tracking/spans/otel/recording-span-transport.js.map +1 -0
  391. package/dist/tracking/spans/otel/span-ids.d.ts +22 -0
  392. package/dist/tracking/spans/otel/span-ids.d.ts.map +1 -0
  393. package/dist/tracking/spans/otel/span-ids.js +32 -0
  394. package/dist/tracking/spans/otel/span-ids.js.map +1 -0
  395. package/dist/tracking/spans/plugin-span-tracker.d.ts +6 -0
  396. package/dist/tracking/spans/plugin-span-tracker.d.ts.map +1 -1
  397. package/dist/tracking/spans/plugin-span-tracker.js +82 -9
  398. package/dist/tracking/spans/plugin-span-tracker.js.map +1 -1
  399. package/dist/tracking/spans/redact-pii.d.ts +3 -1
  400. package/dist/tracking/spans/redact-pii.d.ts.map +1 -1
  401. package/dist/tracking/spans/redact-pii.js +5 -1
  402. package/dist/tracking/spans/redact-pii.js.map +1 -1
  403. package/dist/tracking/spans/span-transport.d.ts +6 -0
  404. package/dist/tracking/spans/span-transport.d.ts.map +1 -1
  405. package/dist/tracking/spans/span-transport.js +1 -1
  406. package/dist/tracking/spans/span-transport.js.map +1 -1
  407. package/dist/types/dsl/index.d.ts +24 -1
  408. package/dist/types/dsl/index.d.ts.map +1 -1
  409. package/dist/types/hooks.d.ts +1 -0
  410. package/dist/types/hooks.d.ts.map +1 -1
  411. package/dist/types/hooks.js +1 -0
  412. package/dist/types/hooks.js.map +1 -1
  413. package/dist/types/runtime.d.ts +6 -0
  414. package/dist/types/runtime.d.ts.map +1 -1
  415. package/dist/types/scanner.d.ts +7 -0
  416. package/dist/types/scanner.d.ts.map +1 -1
  417. package/dist/types/strategy.d.ts +3 -1
  418. package/dist/types/strategy.d.ts.map +1 -1
  419. package/dist/utils/keyed-mutex.d.ts +37 -0
  420. package/dist/utils/keyed-mutex.d.ts.map +1 -0
  421. package/dist/utils/keyed-mutex.js +77 -0
  422. package/dist/utils/keyed-mutex.js.map +1 -0
  423. package/dist/utils/safe-spawn.d.ts +6 -0
  424. package/dist/utils/safe-spawn.d.ts.map +1 -0
  425. package/dist/utils/safe-spawn.js +62 -0
  426. package/dist/utils/safe-spawn.js.map +1 -0
  427. package/examples/strategies/README.md +17 -12
  428. package/examples/strategies/iguana/README.md +135 -0
  429. package/examples/strategies/iguana/recipe.yaml +137 -0
  430. package/examples/strategies/iguana/scanners/scan.py +243 -0
  431. package/examples/strategies/iguana/scanners/scoring.py +152 -0
  432. package/examples/strategies/raptor/README.md +156 -0
  433. package/examples/strategies/raptor/recipe.yaml +154 -0
  434. package/examples/strategies/raptor/scanners/scan.py +349 -0
  435. package/examples/strategies/raptor/scanners/scoring.py +452 -0
  436. package/examples/strategies/spider/README.md +89 -0
  437. package/examples/strategies/spider/scalp/recipe.yaml +129 -0
  438. package/examples/strategies/spider/scalp/scanners/scan.py +219 -0
  439. package/examples/strategies/spider/scalp/scanners/scoring.py +179 -0
  440. package/examples/strategies/spider/swing/recipe.yaml +137 -0
  441. package/examples/strategies/spider/swing/scanners/scan.py +334 -0
  442. package/examples/strategies/spider/swing/scanners/scoring.py +184 -0
  443. package/examples/strategies/turbine/README.md +166 -0
  444. package/examples/strategies/turbine/recipe-runners.yaml +123 -0
  445. package/examples/strategies/turbine/recipe-volume.yaml +129 -0
  446. package/examples/strategies/turbine/scanners/scan.py +283 -0
  447. package/examples/strategies/turbine/scanners/scoring.py +190 -0
  448. package/openclaw.plugin.json +12 -1
  449. package/package.json +3 -3
  450. package/dist/runtime-api/handlers/group-by-scanner.d.ts +0 -43
  451. package/dist/runtime-api/handlers/group-by-scanner.d.ts.map +0 -1
  452. package/dist/runtime-api/handlers/group-by-scanner.js +0 -43
  453. package/dist/runtime-api/handlers/group-by-scanner.js.map +0 -1
  454. package/dist/scanners/external/liquidation-watchdog/README.md +0 -107
  455. package/dist/scanners/external/liquidation-watchdog/liquidation-watchdog.yaml +0 -48
  456. package/dist/scanners/external/liquidation-watchdog/producer.mjs +0 -336
  457. package/dist/scanners/external/momentum/README.md +0 -148
  458. package/dist/scanners/external/momentum/momentum.yaml +0 -116
  459. package/dist/scanners/external/momentum/producer.mjs +0 -251
  460. package/dist/scanners/external/shared/ingest.mjs +0 -112
  461. package/examples/README.md +0 -89
  462. package/examples/scanners-consumer-quickstart.mjs +0 -134
  463. package/examples/scanners-emerging-movers-v4.mjs +0 -287
  464. package/examples/scanners-liquidation-watchdog.mjs +0 -341
  465. package/examples/scanners-live-mcp.mjs +0 -208
  466. package/examples/scanners-multi-strategy.mjs +0 -165
  467. package/examples/scanners-position-tracker-e2e.mjs +0 -225
  468. package/examples/scanners-scheduled-events.mjs +0 -96
  469. package/examples/scanners-senpi-provider-client.mjs +0 -182
  470. package/examples/scanners-single-strategy.mjs +0 -198
  471. package/examples/strategies/dsl-showcase.yaml +0 -68
  472. package/examples/strategies/dsl.yaml +0 -51
  473. package/examples/strategies/fox-minimal-loosened.yaml +0 -240
  474. package/examples/strategies/fox-minimal.yaml +0 -242
  475. package/examples/strategies/minimal.yaml +0 -46
  476. package/examples/strategies/momentum/how-it-works.md +0 -48
  477. package/examples/strategies/momentum/momentum-guarded.yaml +0 -161
  478. package/examples/strategies/risk-showcase.yaml +0 -93
  479. package/examples/strategies/viper.yaml +0 -67
  480. package/examples/strategies/wolf.yaml +0 -72
  481. package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +0 -123
@@ -0,0 +1,133 @@
1
+ /**
2
+ * ScannerLauncher — the supervisor wiring component.
3
+ *
4
+ * For each ExternalScannerSpec it:
5
+ * 1. Mints an ephemeral scanner_id.
6
+ * 2. Registers it in the shared registry so the intake can resolve it.
7
+ * 3. Writes a launch-config JSON that the scaffold reads on startup.
8
+ * 4. Builds a LongRunningSpec with the correct env + stable marker.
9
+ * 5. Constructs + starts a LongRunningSupervisor.
10
+ * 6. On the supervisor's "restarting" event: unregisters the old id, mints
11
+ * a fresh one, re-registers, and rewrites the spec env so the relaunched
12
+ * child carries the new id (zombie fence).
13
+ */
14
+ import { EventEmitter } from "node:events";
15
+ import type { Logger } from "../../utils/logger.js";
16
+ import type { ExternalFieldDefinition } from "../../scanners/scanner-definition.js";
17
+ import type { LongRunningSpec } from "../../runtime/supervisor/long-running-supervisor.js";
18
+ import type { ScannerRegistry } from "./scanner-registry.js";
19
+ import type { AcceptanceRecord } from "./acceptance-record.js";
20
+ import type { LivenessStore } from "./liveness-store.js";
21
+ export interface ExternalScannerSpec {
22
+ name: string;
23
+ /** Absolute path to the scanner's working directory (added to sys.path). */
24
+ path: string;
25
+ /** Function name inside the module that the scaffold calls. */
26
+ entrypoint: string;
27
+ /** Tick cadence in integer seconds (read directly from recipe `interval_seconds`). */
28
+ intervalSeconds: number;
29
+ /** Optional per-tick timeout in seconds. */
30
+ timeoutSeconds?: number;
31
+ /** Per-signal `data{}` schema (recipe `signal_data_schema`). */
32
+ fields: Record<string, ExternalFieldDefinition>;
33
+ /** Author-tunable knobs (recipe `inputs`) passed as the scan() first arg. Optional. */
34
+ inputs?: Record<string, unknown>;
35
+ /** Required fallback signal TTL in integer seconds (recipe `default_signal_validity_seconds`). */
36
+ defaultSignalValiditySeconds: number;
37
+ /** Bound on the persisted state series (recipe `state_history_max_count`); 0/unset = disabled. */
38
+ stateHistoryMaxCount?: number;
39
+ }
40
+ /**
41
+ * The behavioral contract the launcher requires of a supervisor — an
42
+ * EventEmitter with start/stop methods and a mutable `spec`. The default
43
+ * implementation is LongRunningSupervisor; injected via the `createSupervisor`
44
+ * dep for unit tests.
45
+ *
46
+ * Naming (PR #155 review): renamed from `SupervisorLike`, which read as
47
+ * "resembles a supervisor but isn't" — misleading, since this IS the surface
48
+ * the launcher depends on. Two alternatives were considered and rejected:
49
+ * - `SupervisorInterface` — names the type after its TS mechanism (a
50
+ * technicality), not its role; same noise as an `I` prefix, which this
51
+ * codebase deliberately avoids (cf. LivenessStore, AcceptanceRecord).
52
+ * - `ScannerSupervisor` — reads like a concrete class/role, but this is the
53
+ * abstract contract, not the implementation (that's LongRunningSupervisor).
54
+ * `SupervisorContract` names the behavioral agreement itself.
55
+ */
56
+ export interface SupervisorContract extends EventEmitter {
57
+ spec: LongRunningSpec;
58
+ start(): void;
59
+ stop(): Promise<void>;
60
+ on(event: "event", cb: (e: unknown) => void): this;
61
+ }
62
+ export interface ScannerLauncherDeps {
63
+ runtimeId: string;
64
+ wallet: string;
65
+ scanners: ExternalScannerSpec[];
66
+ registry: ScannerRegistry;
67
+ /** Unused by the launcher directly; carried for symmetry and tests. */
68
+ record: AcceptanceRecord;
69
+ liveness: LivenessStore;
70
+ /** Base URL the scaffold POSTs to, e.g. http://127.0.0.1:<port>. */
71
+ intakeUrl: string;
72
+ /** Absolute path to the directory that contains the `scaffold/` package. */
73
+ scaffoldPackageDir: string;
74
+ /**
75
+ * Directory where per-scanner launch-config JSONs are written:
76
+ * <baseStateDir>/<runtimeId>-<wallet>/scanner-launch/<scannerId>.launch.json
77
+ * (empty wallet → a literal trailing hyphen: `<runtimeId>-`).
78
+ * baseStateDir precedence (see resolveSenpiBaseStateDir): plugin stateDir >
79
+ * stored STATE_DIR > SENPI_STATE_DIR > OpenClaw <state>/senpi-state >
80
+ * getDefaultStateDir (~/.openclaw/senpi-state, or process.cwd() if no home).
81
+ * Always derived — never set by hand.
82
+ */
83
+ launchConfigDir: string;
84
+ logger: Logger;
85
+ /**
86
+ * MCP creds injected into the scaffold child so ctx.senpi_mcp can reach the
87
+ * server. When unset, the launcher falls back to process.env.SENPI_API_KEY /
88
+ * process.env.SENPI_MCP_URL ("regardless of how the key was supplied").
89
+ * Explicit deps win over the env. Absent/empty values are OMITTED from
90
+ * spec.env — never written as "" — so the Python client stays loud at first
91
+ * use rather than masked by a fabricated empty cred.
92
+ */
93
+ senpiApiKey?: string;
94
+ senpiMcpUrl?: string;
95
+ /** Default: makeId("scanner"). Inject for deterministic ids in tests. */
96
+ mintScannerId?: () => string;
97
+ /** Default: new LongRunningSupervisor(spec, logger). Inject to avoid forking. */
98
+ createSupervisor?: (spec: LongRunningSpec, logger: Logger) => SupervisorContract;
99
+ /** Optional hook called for every supervisor event (used by E2E to capture pid). */
100
+ onSupervisorEvent?: (e: {
101
+ type: string;
102
+ pid?: number;
103
+ [key: string]: unknown;
104
+ }) => void;
105
+ /** Extra LongRunningSpec fields (backoff/silence knobs) for tests. */
106
+ supervisorOptions?: Partial<LongRunningSpec>;
107
+ }
108
+ export declare class ScannerLauncher {
109
+ private readonly deps;
110
+ private readonly active;
111
+ /**
112
+ * Set to true once `_buildAndRegister()` has run (either from `start()` or
113
+ * from `wireRuntime`). Prevents double-registration when `start()` is
114
+ * called after eager wiring.
115
+ */
116
+ private _initialized;
117
+ constructor(rawDeps: ScannerLauncherDeps);
118
+ /**
119
+ * Mint IDs, register scanners, write launch configs, build supervisors
120
+ * (but do NOT call supervisor.start()). Called by start() the first time,
121
+ * or eagerly by wireRuntime so the registry is populated before the API
122
+ * starts listening.
123
+ *
124
+ * Synchronous — all FS calls (mkdirSync/writeFileSync) are sync. Marked
125
+ * with a leading underscore to signal "internal / framework use only".
126
+ * Public so that wireRuntime (in a sibling module) can call it without
127
+ * TypeScript's private access restriction.
128
+ */
129
+ _buildAndRegister(): void;
130
+ start(): Promise<void>;
131
+ stop(): Promise<void>;
132
+ }
133
+ //# sourceMappingURL=scanner-launcher.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scanner-launcher.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/intake/scanner-launcher.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,204 @@
1
+ /**
2
+ * ScannerLauncher — the supervisor wiring component.
3
+ *
4
+ * For each ExternalScannerSpec it:
5
+ * 1. Mints an ephemeral scanner_id.
6
+ * 2. Registers it in the shared registry so the intake can resolve it.
7
+ * 3. Writes a launch-config JSON that the scaffold reads on startup.
8
+ * 4. Builds a LongRunningSpec with the correct env + stable marker.
9
+ * 5. Constructs + starts a LongRunningSupervisor.
10
+ * 6. On the supervisor's "restarting" event: unregisters the old id, mints
11
+ * a fresh one, re-registers, and rewrites the spec env so the relaunched
12
+ * child carries the new id (zombie fence).
13
+ */
14
+ import * as fs from "node:fs";
15
+ import * as path from "node:path";
16
+ import { LongRunningSupervisor } from "../../runtime/supervisor/long-running-supervisor.js";
17
+ import { makeId } from "../../runtime/supervisor/supervisor-utils.js";
18
+ // ── ScannerLauncher ────────────────────────────────────────────────────────────
19
+ export class ScannerLauncher {
20
+ deps;
21
+ active = [];
22
+ /**
23
+ * Set to true once `_buildAndRegister()` has run (either from `start()` or
24
+ * from `wireRuntime`). Prevents double-registration when `start()` is
25
+ * called after eager wiring.
26
+ */
27
+ _initialized = false;
28
+ constructor(rawDeps) {
29
+ this.deps = rawDeps;
30
+ }
31
+ /**
32
+ * Mint IDs, register scanners, write launch configs, build supervisors
33
+ * (but do NOT call supervisor.start()). Called by start() the first time,
34
+ * or eagerly by wireRuntime so the registry is populated before the API
35
+ * starts listening.
36
+ *
37
+ * Synchronous — all FS calls (mkdirSync/writeFileSync) are sync. Marked
38
+ * with a leading underscore to signal "internal / framework use only".
39
+ * Public so that wireRuntime (in a sibling module) can call it without
40
+ * TypeScript's private access restriction.
41
+ */
42
+ _buildAndRegister() {
43
+ if (this._initialized)
44
+ return;
45
+ const { runtimeId, wallet, scanners, registry, liveness, intakeUrl, scaffoldPackageDir, launchConfigDir, logger, supervisorOptions = {}, } = this.deps;
46
+ // Resolve MCP creds: explicit deps win, else fall back to process.env.
47
+ // Empty/absent values are dropped so we never inject a misleading "".
48
+ const senpiApiKey = this.deps.senpiApiKey || process.env.SENPI_API_KEY || undefined;
49
+ const senpiMcpUrl = this.deps.senpiMcpUrl || process.env.SENPI_MCP_URL || undefined;
50
+ const mintScannerId = this.deps.mintScannerId ?? (() => makeId("scanner"));
51
+ const createSupervisor = this.deps.createSupervisor ??
52
+ ((spec, lg) => new LongRunningSupervisor(spec, lg));
53
+ const onSupervisorEvent = this.deps.onSupervisorEvent;
54
+ // Track ids registered in this call so we can roll back on partial failure.
55
+ const registeredInThisCall = [];
56
+ try {
57
+ for (let i = 0; i < scanners.length; i++) {
58
+ const scanner = scanners[i];
59
+ if (!scanner.path) {
60
+ throw new Error(`ScannerLauncher: scanner "${scanner.name}" is missing required field "path"`);
61
+ }
62
+ if (!scanner.entrypoint) {
63
+ throw new Error(`ScannerLauncher: scanner "${scanner.name}" is missing required field "entrypoint"`);
64
+ }
65
+ // 1. Mint.
66
+ const scannerId = mintScannerId();
67
+ // 2. Register.
68
+ registry.register({
69
+ scannerId,
70
+ runtimeId,
71
+ scannerName: scanner.name,
72
+ wallet,
73
+ fields: scanner.fields,
74
+ });
75
+ registeredInThisCall.push(scannerId);
76
+ // 3. Write launch config. The filename is keyed on the unique scanner_id
77
+ // so two scanners that share a name never overwrite each other on disk.
78
+ // The state directory is keyed on the scanner NAME so it is stable
79
+ // across relaunch — the restarted child resumes its state and replays
80
+ // its delivery journal (the scaffold derives the journal from state_path).
81
+ const cfgPath = path.join(launchConfigDir, `${scannerId}.launch.json`);
82
+ const safeName = scanner.name.replace(/[^a-zA-Z0-9_-]/g, "_");
83
+ // Include the scanner's array index so two scanners that share a name (or
84
+ // whose names sanitize to the same string) never share a state directory
85
+ // or delivery journal. The index is stable across relaunch (same config
86
+ // position), so state and the journal survive a restart.
87
+ const stateDir = path.join(launchConfigDir, "scanner-state", `${safeName}-${i}`);
88
+ fs.mkdirSync(stateDir, { recursive: true });
89
+ // Launch-config JSON — the FROZEN launcher↔scaffold key contract (design §4a).
90
+ // Hard cut: `interval` → `interval_seconds`, `params` → `inputs`.
91
+ const launchCfg = {
92
+ path: scanner.path,
93
+ entrypoint: scanner.entrypoint,
94
+ interval_seconds: scanner.intervalSeconds,
95
+ state_path: path.join(stateDir, "state.json"),
96
+ default_signal_validity_seconds: scanner.defaultSignalValiditySeconds,
97
+ // Per-signal data{} schema (recipe `signal_data_schema`, held here as
98
+ // `scanner.fields`). The scaffold reads it and validates each signal's
99
+ // `data` scaffold-side, POSTing a violation to /errors for early, loud
100
+ // feedback. Additive — intake keeps its authoritative server-side check.
101
+ signal_data_schema: scanner.fields,
102
+ wallet,
103
+ scanner_name: scanner.name,
104
+ };
105
+ if (scanner.timeoutSeconds !== undefined) {
106
+ launchCfg.timeout_seconds = scanner.timeoutSeconds;
107
+ }
108
+ if (scanner.inputs !== undefined) {
109
+ launchCfg.inputs = scanner.inputs;
110
+ }
111
+ if (scanner.stateHistoryMaxCount !== undefined) {
112
+ launchCfg.state_history_max_count = scanner.stateHistoryMaxCount;
113
+ }
114
+ fs.writeFileSync(cfgPath, JSON.stringify(launchCfg, null, 2), "utf8");
115
+ // Mutable id holder so the lastAliveAt closure always reads the current id.
116
+ const idHolder = { value: scannerId };
117
+ // 4. Build spawn spec.
118
+ const pythonBin = process.env.PYTHON ?? "python3";
119
+ const existingPythonPath = process.env.PYTHONPATH ?? "";
120
+ const pythonPath = existingPythonPath
121
+ ? `${scaffoldPackageDir}:${existingPythonPath}`
122
+ : scaffoldPackageDir;
123
+ const maxSilenceMs = Math.max(scanner.intervalSeconds * 2, 30) * 1000;
124
+ const spec = {
125
+ command: pythonBin,
126
+ args: ["-m", "scaffold", cfgPath],
127
+ env: {
128
+ EXTERNAL_SCANNER_ID: scannerId,
129
+ SIGNAL_INGESTION_URL: intakeUrl,
130
+ PYTHONPATH: pythonPath,
131
+ // Inject MCP creds only when present — omit (never "") when absent so
132
+ // the Python ctx.senpi_mcp client stays loud at first use.
133
+ ...(senpiApiKey ? { SENPI_API_KEY: senpiApiKey } : {}),
134
+ ...(senpiMcpUrl ? { SENPI_MCP_URL: senpiMcpUrl } : {}),
135
+ },
136
+ marker: runtimeId,
137
+ initialDelayMs: i * 250,
138
+ lastAliveAt: () => liveness.lastAliveAt(idHolder.value),
139
+ maxSilenceMs,
140
+ ...supervisorOptions,
141
+ };
142
+ // 5. Construct supervisor (NOT started yet — start() calls supervisor.start()).
143
+ const supervisor = createSupervisor(spec, logger);
144
+ // Wire the supervisor event hook (used by E2E to capture pid).
145
+ if (onSupervisorEvent) {
146
+ supervisor.on("event", (e) => {
147
+ onSupervisorEvent(e);
148
+ });
149
+ }
150
+ // 6. Subscribe to restarting for remint.
151
+ supervisor.on("event", (e) => {
152
+ const evt = e;
153
+ if (evt.type === "restarting") {
154
+ const oldId = idHolder.value;
155
+ registry.unregister(oldId);
156
+ const newId = mintScannerId();
157
+ idHolder.value = newId;
158
+ registry.register({
159
+ scannerId: newId,
160
+ runtimeId,
161
+ scannerName: scanner.name,
162
+ wallet,
163
+ fields: scanner.fields,
164
+ });
165
+ // Rewrite env so the next spawn carries the new id.
166
+ supervisor.spec.env = {
167
+ ...supervisor.spec.env,
168
+ EXTERNAL_SCANNER_ID: newId,
169
+ };
170
+ }
171
+ });
172
+ this.active.push({ currentId: idHolder, supervisor });
173
+ }
174
+ // Mark as initialized only after the full loop succeeds (so a partial
175
+ // failure does not prevent a clean retry on start()).
176
+ this._initialized = true;
177
+ }
178
+ catch (err) {
179
+ // All-or-nothing: roll back every registration made in this call so the
180
+ // registry stays clean and a retry does not see stale or duplicate ids.
181
+ for (const id of registeredInThisCall) {
182
+ registry.unregister(id);
183
+ }
184
+ // Clear any partially-built active entries (supervisors were constructed
185
+ // but never started; no processes to kill).
186
+ this.active.length = 0;
187
+ throw err;
188
+ }
189
+ }
190
+ async start() {
191
+ this._buildAndRegister();
192
+ for (const { supervisor } of this.active) {
193
+ supervisor.start();
194
+ }
195
+ }
196
+ async stop() {
197
+ await Promise.all(this.active.map(async ({ currentId, supervisor }) => {
198
+ this.deps.registry.unregister(currentId.value);
199
+ await supervisor.stop();
200
+ }));
201
+ this.active.length = 0;
202
+ }
203
+ }
204
+ //# sourceMappingURL=scanner-launcher.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scanner-launcher.js","sourceRoot":"","sources":["../../../src/runtime-api/intake/scanner-launcher.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * A2 — in-memory scanner_id → (runtime, scanner) registry.
3
+ *
4
+ * A5 (supervisor) populates this at launch; until then it is empty and every
5
+ * POST is rejected as unknown scanner_id.
6
+ *
7
+ * Default implementation: Map-backed. A6 will not replace this interface;
8
+ * it will only add durable persistence behind it.
9
+ */
10
+ import type { ExternalFieldDefinition } from "../../scanners/scanner-definition.js";
11
+ export interface ScannerRegistryEntry {
12
+ scannerId: string;
13
+ runtimeId: string;
14
+ scannerName: string;
15
+ wallet: string;
16
+ fields: Record<string, ExternalFieldDefinition>;
17
+ }
18
+ export interface ScannerRegistry {
19
+ resolve(scannerId: string): ScannerRegistryEntry | undefined;
20
+ register(entry: ScannerRegistryEntry): void;
21
+ unregister(scannerId: string): void;
22
+ }
23
+ /**
24
+ * Default Map-backed implementation of ScannerRegistry.
25
+ *
26
+ * Zombie fence: resolve(unknown or unregistered) returns undefined.
27
+ * When A5 relaunches a scanner, it unregisters the old id, so leftover
28
+ * processes carrying the old id are refused.
29
+ */
30
+ export declare class MapScannerRegistry implements ScannerRegistry {
31
+ private store;
32
+ resolve(scannerId: string): ScannerRegistryEntry | undefined;
33
+ register(entry: ScannerRegistryEntry): void;
34
+ unregister(scannerId: string): void;
35
+ }
36
+ //# sourceMappingURL=scanner-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scanner-registry.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/intake/scanner-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,KAAK,CAA2C;IAExD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAI5D,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAI3C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAGpC"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * A2 — in-memory scanner_id → (runtime, scanner) registry.
3
+ *
4
+ * A5 (supervisor) populates this at launch; until then it is empty and every
5
+ * POST is rejected as unknown scanner_id.
6
+ *
7
+ * Default implementation: Map-backed. A6 will not replace this interface;
8
+ * it will only add durable persistence behind it.
9
+ */
10
+ /**
11
+ * Default Map-backed implementation of ScannerRegistry.
12
+ *
13
+ * Zombie fence: resolve(unknown or unregistered) returns undefined.
14
+ * When A5 relaunches a scanner, it unregisters the old id, so leftover
15
+ * processes carrying the old id are refused.
16
+ */
17
+ export class MapScannerRegistry {
18
+ store = new Map();
19
+ resolve(scannerId) {
20
+ return this.store.get(scannerId);
21
+ }
22
+ register(entry) {
23
+ this.store.set(entry.scannerId, entry);
24
+ }
25
+ unregister(scannerId) {
26
+ this.store.delete(scannerId);
27
+ }
28
+ }
29
+ //# sourceMappingURL=scanner-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scanner-registry.js","sourceRoot":"","sources":["../../../src/runtime-api/intake/scanner-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACrB,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IAExD,OAAO,CAAC,SAAiB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ,CAAC,KAA2B;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;CACF"}
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Signal intake types and response shapes.
3
+ *
4
+ * These types describe the wire contract for the supervised intake pipeline:
5
+ * scanner_id-routed requests with per-signal acceptance/rejection statuses.
6
+ */
7
+ /** One signal in a POST /signals batch. */
8
+ export interface IntakeSignal {
9
+ /**
10
+ * Producer-minted idempotency key (the scaffold journal eid). REQUIRED on the
11
+ * wire — it is the dedup key intake uses. It is a SEPARATE id from
12
+ * `correlationId` on PerSignalStatus (which intake mints server-side).
13
+ */
14
+ signal_id: string;
15
+ asset: string;
16
+ direction: "LONG" | "SHORT";
17
+ produced_at: number;
18
+ valid_until: number;
19
+ data: Record<string, unknown>;
20
+ signal_type?: string;
21
+ /**
22
+ * Per-signal sizing, optional. The producer scaffold lifts these to the top
23
+ * level and the open-position action reads them directly. `marginUsd` is the
24
+ * canonical USD margin; `margin` is the legacy alias the consumer still
25
+ * accepts; `leverage` is the per-signal leverage override. All positive when
26
+ * present (the wire schema rejects zero/negative/non-number).
27
+ */
28
+ marginUsd?: number;
29
+ margin?: number;
30
+ leverage?: number;
31
+ }
32
+ /** Request body for POST /signals. */
33
+ export interface SignalsBody {
34
+ scanner_id: string;
35
+ signals: IntakeSignal[];
36
+ }
37
+ /** Per-signal outcome in the response. */
38
+ export interface PerSignalStatus {
39
+ status: "accepted" | "expired" | "superseded" | "rejected";
40
+ correlationId?: string;
41
+ reason?: string;
42
+ }
43
+ /** Success response for POST /signals. */
44
+ export interface SignalsSuccessResponse {
45
+ signals: PerSignalStatus[];
46
+ }
47
+ /** Error response for POST-level rejections. */
48
+ export interface SignalsErrorResponse {
49
+ reason: string;
50
+ }
51
+ /** Request body for POST /errors. */
52
+ export interface ErrorsBody {
53
+ scanner_id: string;
54
+ error: Record<string, unknown>;
55
+ }
56
+ /** Response for POST /errors. */
57
+ export interface ErrorsResponse {
58
+ ok: boolean;
59
+ reason?: string;
60
+ }
61
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/intake/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,CAAC;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Signal intake types and response shapes.
3
+ *
4
+ * These types describe the wire contract for the supervised intake pipeline:
5
+ * scanner_id-routed requests with per-signal acceptance/rejection statuses.
6
+ */
7
+ export {};
8
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime-api/intake/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
@@ -1,50 +1,30 @@
1
1
  /**
2
- * Fastify route: `POST /signals`.
3
- *
4
- * Accepts a batch of signal items targeting one or more runtime wallets,
5
- * groups them by `(address, scanner)` to avoid the per-key ingest lock, fans
6
- * out groups in parallel, processes items within each group sequentially, and
7
- * returns per-item results in input order.
8
- *
9
- * Business logic lives entirely in:
10
- * - `handlers/ingest-signals.ts` — per-item dispatch + error translation.
11
- * - `handlers/group-by-scanner.ts` — lock-aware grouping helper.
12
- *
13
- * This file contains only Fastify wiring and the handler-level cap check.
2
+ * Fastify route wiring for the supervised intake /signals and /errors routes.
3
+ * The route IS mounted via createApi when intakeContext is present.
14
4
  */
15
5
  import type { FastifyInstance } from "fastify";
16
- import type { RuntimeHandle } from "../../runtime/run.js";
6
+ import type { ScannerRegistry } from "../intake/scanner-registry.js";
7
+ import type { AcceptanceRecord } from "../intake/acceptance-record.js";
17
8
  import type { Logger } from "../../utils/logger.js";
18
- /**
19
- * Dependencies injected into the `/signals` route at registration time.
20
- */
21
- export interface SignalsRouteDeps {
22
- /** Live runtime handles maintained by the plugin, keyed by lowercased address. */
23
- runtimeHandles: Map<string, RuntimeHandle>;
24
- /** Logger instance for unexpected errors. */
25
- logger: Logger;
26
- /**
27
- * Maximum number of items allowed in a single request.
28
- * Sourced from `config.api.maxItemsPerSignalsRequest` (default 10).
29
- */
30
- maxItems: number;
9
+ export interface RegisterSignalsRouteOpts {
10
+ registry: ScannerRegistry;
11
+ record: AcceptanceRecord;
12
+ now?: () => number;
13
+ mintCorrelationId?: () => string;
14
+ updateLiveness?: (scannerId: string, now: number) => void;
15
+ onAccepted?: (signal: any, correlationId: string, scannerId: string) => void;
16
+ onError?: (scannerId: string, error: Record<string, unknown>) => void;
31
17
  /**
32
- * Transport tag forwarded to the ingest handler for telemetry.
33
- * Fixed as `"http"` for this route; the gateway shim passes `"gateway"`.
18
+ * Max items allowed in a single `signals[]` request
19
+ * (`api.maxItemsPerSignalsRequest`). When undefined, no item-count cap is
20
+ * applied — the server wiring always supplies it from the validated api config.
34
21
  */
35
- transport: "http" | "gateway";
22
+ maxItemsPerSignalsRequest?: number;
23
+ /** Optional logger; defaults to a no-op so existing call sites/tests are unaffected. */
24
+ logger?: Logger;
36
25
  }
37
26
  /**
38
- * Register `POST /signals` on the given Fastify instance.
39
- *
40
- * The route validates the body against the `SignalsBody` TypeBox schema, then:
41
- * 1. Rejects oversized batches (handler-level cap, configurable).
42
- * 2. Groups items by `(address, scanner)` via `groupByAddressScanner`.
43
- * 3. Runs groups in parallel; items within each group run sequentially.
44
- * 4. Re-flattens results back to input order before responding.
45
- *
46
- * @param fastify Fastify instance to register the route on.
47
- * @param deps Route dependencies injected at plugin start.
27
+ * Register the supervised intake /signals and /errors routes.
48
28
  */
49
- export declare function registerSignalsRoute(fastify: FastifyInstance, deps: SignalsRouteDeps): void;
29
+ export declare function registerSignalsRoute(fastify: FastifyInstance, opts: RegisterSignalsRouteOpts): void;
50
30
  //# sourceMappingURL=signals.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/routes/signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAwDpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,gBAAgB,GACrB,IAAI,CA+CN"}
1
+ {"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/routes/signals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAM7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAapD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,wBAAwB,GAC7B,IAAI,CAuJN"}