@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
package/dist/index.js CHANGED
@@ -24,7 +24,7 @@ if (process.env.DD_TRACE_ENABLED === "true") {
24
24
  __require("dd-trace").init();
25
25
  }
26
26
  import { readFileSync } from "node:fs";
27
- import { join } from "node:path";
27
+ import { join, dirname } from "node:path";
28
28
  import { SenpiClient } from "./senpi/client.js";
29
29
  import { buildRuntimeStateDir, archiveStateDir } from "./runtime/state-layout.js";
30
30
  import { registerSenpiCli } from "./cli/senpi-commands.js";
@@ -33,7 +33,6 @@ import { getDefaultStateDir } from "./runtime/default-state-dir.js";
33
33
  import { createNotificationService } from "./runtime/notifications.js";
34
34
  import { run } from "./runtime/run.js";
35
35
  import { AutoUpdateCoordinator } from "./runtime/auto-update/coordinator.js";
36
- import { runCommand } from "./runtime/auto-update/command-runner.js";
37
36
  import { resolveAutoUpdateConfig } from "./runtime/auto-update/types.js";
38
37
  import { SkillsCoordinatorUnavailableError, SkillsUpdateCoordinator, resolveSkillsManagerConfig, } from "./skills-manager/index.js";
39
38
  import { createScannerProvidersForRun } from "./runtime/create-scanner-providers-for-run.js";
@@ -41,15 +40,21 @@ import { initDsl } from "./dsl/index.js";
41
40
  import { initHealth } from "./health/index.js";
42
41
  import { initRisk } from "./risk/index.js";
43
42
  import { VERSION } from "./version.js";
43
+ import { resolvePackageName } from "./runtime/auto-update/resolve-package-name.js";
44
+ import { runOpenClawPluginsUpdate } from "./runtime/auto-update/run-update-command.js";
44
45
  import { BUS_EVENT_MAP } from "./tracking/constants.js";
45
46
  import { createPluginEventTracker } from "./tracking/plugin-event-tracker.js";
46
47
  import { createPluginSpanTracker, registerSpanHooks, setDefaultSpanTracker, } from "./tracking/spans/index.js";
47
48
  import { getLogLevel, getLogLevelSource, parseLogLevel, setErrorNotifier, setLogLevel, } from "./utils/logger.js";
48
49
  import { ExternalScannerIngestError, } from "./scanners/external-scanner-receiver.js";
49
50
  import { createLogger } from "./utils/logger.js";
51
+ import { fileURLToPath } from "node:url";
50
52
  import { loadApiConfig } from "./runtime-api/config.js";
51
53
  import { startApi } from "./runtime-api/lifecycle.js";
52
54
  import { ingestSignalsHandler } from "./runtime-api/handlers/ingest-signals.js";
55
+ import { createIntakeContext } from "./runtime-api/intake/intake-context.js";
56
+ import { wireRuntime, intakeUrlFor } from "./runtime-api/intake/intake-mount.js";
57
+ import { loadRuntimeConfig } from "./runtime/load-runtime-config.js";
53
58
  /** Initialize all core features (DSL, risk, health) on the given event bus. */
54
59
  export function initCore(bus) {
55
60
  initDsl(bus);
@@ -186,12 +191,23 @@ function readPluginManifestVersion() {
186
191
  return VERSION;
187
192
  }
188
193
  const PLUGIN_MANIFEST_VERSION = readPluginManifestVersion();
194
+ /**
195
+ * NPM package name resolved from the installed `package.json` at runtime.
196
+ * Lets the auto-updater poll whichever npm package this plugin was published
197
+ * under (e.g. `@senpi-ai/runtime` in prod, `@senpi/runtime` on the
198
+ * openclaw-upgrade dev channel). Falls back to the prod name when unreadable.
199
+ * See `runtime/auto-update/resolve-package-name.ts`.
200
+ */
201
+ const PLUGIN_PACKAGE_NAME = resolvePackageName();
189
202
  /**
190
203
  * OpenClaw plugin entry.
191
204
  * Boots from internal registry (installed_runtimes.json) in stateDir; does not read runtime list from config.
192
205
  */
193
206
  const senpiRuntimePlugin = {
194
- id: "@senpi-ai/runtime",
207
+ // Must match openclaw.plugin.json `id` — openclaw loader rejects the plugin
208
+ // when `installed_plugins.json` record id (sourced from the manifest) and
209
+ // the runtime export id differ. v2026.5.x is strict; v2026.2.x was lenient.
210
+ id: "runtime",
195
211
  name: "Senpi Trading Runtime",
196
212
  version: VERSION,
197
213
  description: "Senpi trading runtime plugin for OpenClaw — orchestrates scanners, actions, and DSL exit engine",
@@ -247,6 +263,10 @@ const senpiRuntimePlugin = {
247
263
  pluginLogger.error("[senpi-runtime] mcpTransport or apiKey is required (provide via gateway, api, or config)");
248
264
  return;
249
265
  }
266
+ // Self-report the MCP transport path so a deployed box never leaves it ambiguous.
267
+ // mcpTransport = gateway-injected (no eager connect); apiKey = self-managed SenpiClient
268
+ // (lazy connect — the R7 boot-resilience path). No secret is logged, only presence + url.
269
+ pluginLogger.info(`[senpi-runtime] MCP transport: ${mcpTransport ? "mcpTransport (gateway-injected)" : "apiKey (self-managed SenpiClient)"}; mcpUrl=${process.env.SENPI_MCP_URL ?? "(default)"}`);
250
270
  const pluginEventTracker = createPluginEventTracker(apiKey ?? process.env.SENPI_API_KEY);
251
271
  // Span telemetry — one tracker per gateway, shared across all hosted runtimes
252
272
  // and OpenClaw hook activity. Captures llm/tool/subagent/agent_end via
@@ -265,6 +285,40 @@ const senpiRuntimePlugin = {
265
285
  }
266
286
  const runtimeHandles = new Map();
267
287
  let apiHandle;
288
+ // Supervised scanner state — module-scoped so stop() can reach them.
289
+ // Created eagerly at register() time (not deferred to start()) so that
290
+ // senpi.installRuntime can wire scanners regardless of whether start()
291
+ // has already been called (the gateway may invoke installRuntime before
292
+ // start() completes, or even before start() is ever called).
293
+ //
294
+ // FAIL-CLOSED on corrupt acceptance record: if the FileAcceptanceRecord
295
+ // inside createIntakeContext throws (corrupt / unreadable dedup file), we
296
+ // catch here and DISABLE supervised intake rather than crashing the whole
297
+ // gateway. A corrupt INTAKE dedup file must NOT take down DSL monitoring /
298
+ // reconcile that protects already-open positions. With intake disabled:
299
+ // - /signals is not mounted (no new trade acceptance)
300
+ // - supervised-scanner launchers are not built or started
301
+ // - DSL monitor + reconcile boot normally for existing positions
302
+ // Remediation: clear or repair the acceptance-record.json file and restart.
303
+ let sharedIntakeContext;
304
+ try {
305
+ sharedIntakeContext = createIntakeContext({
306
+ // Durable acceptance high-water-mark: a gateway restart must NOT re-accept an
307
+ // already-accepted signal (double-process / double-trade risk, proven on the
308
+ // box). One file for the box; keys are namespaced by runtimeId+scannerName so
309
+ // runtimes never mix marks.
310
+ acceptanceRecordPath: join(baseStateDir, "acceptance-record.json"),
311
+ logger: pluginLogger,
312
+ });
313
+ }
314
+ catch (intakeErr) {
315
+ pluginLogger.error(`[senpi-runtime] FATAL: corrupt acceptance record at ${join(baseStateDir, "acceptance-record.json")}` +
316
+ ` — supervised intake DISABLED; DSL monitor and reconcile will boot normally.` +
317
+ ` Remediation: clear or repair the file and restart.`, { err: intakeErr });
318
+ // sharedIntakeContext remains undefined — callers below are guarded.
319
+ }
320
+ let routeAcceptedSignalToRuntime;
321
+ const launchers = new Map();
268
322
  // Dedicated logger for the runtime-api subtree — required because the
269
323
  // PluginLogger surface (info/warn/error) lacks `debug`, while the
270
324
  // Logger contract used by `runtime-api/` includes it.
@@ -304,7 +358,7 @@ const senpiRuntimePlugin = {
304
358
  const autoUpdateCoordinator = new AutoUpdateCoordinator({
305
359
  enabled: true,
306
360
  config: autoUpdateConfig,
307
- packageName: "@senpi-ai/runtime",
361
+ packageName: PLUGIN_PACKAGE_NAME,
308
362
  currentVersion: VERSION,
309
363
  stateDir: join(baseStateDir, "auto-update"),
310
364
  logger: pluginLogger,
@@ -312,18 +366,21 @@ const senpiRuntimePlugin = {
312
366
  ? (msg) => lifecycleNotifications.notify(msg)
313
367
  : async () => { },
314
368
  stopRuntimesForUpdate: async () => {
369
+ // Stop supervised scanner children BEFORE stopping runtime handles so
370
+ // scaffold processes do not POST to a handle that is already torn down.
371
+ // Mirrors the service stop() teardown order.
372
+ if (launchers.size > 0) {
373
+ await Promise.allSettled([...launchers.values()].map((l) => l.stop()));
374
+ launchers.clear();
375
+ }
315
376
  for (const [, handle] of runtimeHandles) {
316
377
  await handle.stop();
317
378
  }
318
379
  },
319
- runUpdateCommand: async () => {
320
- const result = await runCommand("sh", ["-lc", "yes | openclaw plugins update runtime"], {
321
- timeoutMs: 120_000,
322
- });
323
- if (result.code !== 0) {
324
- throw new Error(result.stderr || `openclaw plugins update failed with code ${result.code}`);
325
- }
326
- },
380
+ // Use the resolved npm package name (not a hardcoded plugin id) so
381
+ // the update follows the same npm channel as the version check —
382
+ // see runtime/auto-update/run-update-command.ts.
383
+ runUpdateCommand: runOpenClawPluginsUpdate,
327
384
  configFromApi: api.config,
328
385
  loadConfig: api.runtime?.config
329
386
  ? () => api.runtime.config.loadConfig()
@@ -373,6 +430,46 @@ const senpiRuntimePlugin = {
373
430
  mcpTransport,
374
431
  apiKey,
375
432
  });
433
+ // Wire the shared accepted callback now that runtimeHandles is
434
+ // being populated. sharedIntakeContext was created eagerly at register()
435
+ // time so /signals can be mounted even for a pure-legacy box.
436
+ // The single server-level onAccepted resolves registry → runtimeId
437
+ // → handle for any runtime's scanner (shared across all runtimes).
438
+ // Guard: if intake context is disabled (corrupt record at boot), skip wiring —
439
+ // /signals will not be mounted and no signals will be routed.
440
+ if (sharedIntakeContext) {
441
+ const ctx = sharedIntakeContext;
442
+ routeAcceptedSignalToRuntime = (signal, _correlationId, scannerId) => {
443
+ const resolved = ctx.registry.resolve(scannerId);
444
+ if (!resolved)
445
+ return;
446
+ const h = runtimeHandles.get(resolved.runtimeId);
447
+ if (!h)
448
+ return;
449
+ const request = {
450
+ scanner: resolved.scannerName,
451
+ signal_id: signal.signal_id, // greppable handle across intake→ingest (obs only)
452
+ asset: signal.asset,
453
+ direction: signal.direction,
454
+ ...(signal.signal_type !== undefined && { signal_type: signal.signal_type }),
455
+ data: signal.data,
456
+ // Per-signal sizing rides at the top level; the open-position action
457
+ // reads request.marginPct / request.leverage directly. Without this a
458
+ // supervised signal's sizing is lost ("no margin source resolved").
459
+ ...(signal.marginPct !== undefined && { marginPct: signal.marginPct }),
460
+ ...(signal.leverage !== undefined && { leverage: signal.leverage }),
461
+ };
462
+ // Trace the sizing-relevant fields the narrowed request carries, so a
463
+ // field dropped at this seam is visible instead of vanishing silently.
464
+ apiLogger.debug(`[intake] ingest req signal_id=${signal.signal_id} scanner=${resolved.scannerName} asset=${signal.asset} direction=${signal.direction} marginPct=${signal.marginPct} leverage=${signal.leverage}`);
465
+ void h
466
+ .ingestExternalScannerData(request)
467
+ .then(() => {
468
+ apiLogger.info(`[intake] ingest ok signal_id=${signal.signal_id} scanner=${resolved.scannerName} asset=${signal.asset} scanner_id=${scannerId}`);
469
+ })
470
+ .catch((err) => apiLogger.error("[intake] ingest failed", { scannerId, err }));
471
+ };
472
+ }
376
473
  const started = [];
377
474
  try {
378
475
  for (const entry of registry.runtimes) {
@@ -394,9 +491,51 @@ const senpiRuntimePlugin = {
394
491
  });
395
492
  runtimeHandles.set(entry.id, handle);
396
493
  started.push(entry.id);
494
+ // ── supervised scanner mount (additive; guarded) ──────────────────
495
+ // Boot path: used for runtimes already present in the registry at
496
+ // startup. A runtime installed live, after the API is listening,
497
+ // takes the hotLauncher path instead (see "hot-install" below).
498
+ // wireRuntime returns null for pure-legacy runtimes — no behavior
499
+ // change for those. For supervised runtimes the launcher is built
500
+ // (scanners registered into sharedIntakeContext) but NOT started;
501
+ // start() is deferred until after the HTTP API is listening below.
502
+ // Skip entirely if intake context is disabled (corrupt acceptance record).
503
+ if (sharedIntakeContext) {
504
+ try {
505
+ const runtimeConfig = await loadRuntimeConfig(pathOrContent, { fromPath: hasPath });
506
+ // Content-installed runtimes carry their recipe dir in the registry
507
+ // entry (runtimeYamlDir) so relative scanner paths still resolve
508
+ // after a restart; path-installed ones derive it from the path.
509
+ const recipeDir = hasPath ? dirname(pathOrContent) : entry.runtimeYamlDir;
510
+ const scaffoldPackageDir = fileURLToPath(new URL("./scanners/external", import.meta.url));
511
+ const apiConfig = loadApiConfig(api.pluginConfig);
512
+ const launcher = wireRuntime({
513
+ runtimeConfig,
514
+ recipeDir,
515
+ runtimeId: entry.id,
516
+ wallet: runtimeConfig.strategy?.wallet ?? entry.wallet ?? "",
517
+ sharedCtx: sharedIntakeContext,
518
+ runtimeHandles,
519
+ intakeUrl: intakeUrlFor(apiConfig.host, apiConfig.port),
520
+ scaffoldPackageDir,
521
+ runtimeStateDir: entryStateDir,
522
+ logger: apiLogger,
523
+ });
524
+ if (launcher)
525
+ launchers.set(entry.id, launcher);
526
+ }
527
+ catch (mountErr) {
528
+ // Mount failure is non-fatal: the runtime itself is already up.
529
+ // Log and skip the launcher for this runtime.
530
+ apiLogger.error("[senpi-runtime] scanner mount failed — runtime running without supervised scanners", { runtimeId: entry.id, err: mountErr });
531
+ }
532
+ }
397
533
  }
398
534
  }
399
535
  catch (err) {
536
+ // On runtime loop failure, stop any launchers we already built.
537
+ await Promise.allSettled([...launchers.values()].map((l) => l.stop()));
538
+ launchers.clear();
400
539
  for (let i = started.length - 1; i >= 0; i--) {
401
540
  const h = runtimeHandles.get(started[i]);
402
541
  if (h)
@@ -424,11 +563,17 @@ const senpiRuntimePlugin = {
424
563
  if (process.env.SENPI_RUNTIME_API_DISABLED !== "true") {
425
564
  try {
426
565
  const apiConfig = loadApiConfig(api.pluginConfig);
566
+ // Always mount /signals: Fastify cannot add routes after listen(),
567
+ // so a pure-legacy box must have the route pre-mounted to support a
568
+ // later hot-install of a supervised recipe. With an empty registry
569
+ // the route returns UNKNOWN_SCANNER — harmless.
427
570
  apiHandle = await startApi({
428
571
  runtimeHandles,
429
572
  apiConfig,
430
573
  logger: apiLogger,
431
574
  version: PLUGIN_MANIFEST_VERSION,
575
+ intakeContext: sharedIntakeContext,
576
+ onAccepted: routeAcceptedSignalToRuntime,
432
577
  });
433
578
  apiHandle.ready();
434
579
  }
@@ -439,6 +584,9 @@ const senpiRuntimePlugin = {
439
584
  // mid-rollback, then stop every runtime handle that was hydrated
440
585
  // above.
441
586
  await autoUpdateCoordinator.stop().catch(() => { });
587
+ // Stop any launchers so spawned scaffolds are not leaked.
588
+ await Promise.allSettled([...launchers.values()].map((l) => l.stop()));
589
+ launchers.clear();
442
590
  for (let i = started.length - 1; i >= 0; i--) {
443
591
  const h = runtimeHandles.get(started[i]);
444
592
  if (h)
@@ -447,6 +595,20 @@ const senpiRuntimePlugin = {
447
595
  }
448
596
  throw err;
449
597
  }
598
+ // The HTTP API is now listening — start the supervised scanners.
599
+ // Each start is isolated: a partial-spawn failure removes that launcher
600
+ // from the map immediately (no orphaned children until shutdown) and
601
+ // the runtime stays up without supervised scanners.
602
+ for (const [id, launcher] of launchers) {
603
+ try {
604
+ await launcher.start();
605
+ }
606
+ catch (startErr) {
607
+ await launcher.stop().catch(() => { });
608
+ launchers.delete(id);
609
+ apiLogger.error("[senpi-runtime] supervised scanner launch failed — runtime running without it", { err: startErr });
610
+ }
611
+ }
450
612
  }
451
613
  if (lifecycleNotifications) {
452
614
  const n = started.length;
@@ -469,6 +631,14 @@ const senpiRuntimePlugin = {
469
631
  await apiHandle.close();
470
632
  apiHandle = undefined;
471
633
  }
634
+ // Stop launchers: unregister scanner_ids + await supervisor.stop()
635
+ // (kills children + descendants). Runs AFTER apiHandle.close() so no
636
+ // in-flight POST races the teardown. Promise.allSettled so a
637
+ // launcher failure never blocks the remaining teardown.
638
+ if (launchers.size > 0) {
639
+ await Promise.allSettled([...launchers.values()].map((l) => l.stop()));
640
+ launchers.clear();
641
+ }
472
642
  // Stop the coordinator next so it cannot schedule a new tick or call
473
643
  // stopRuntimesForUpdate() (auto-restart path after an update) while
474
644
  // we are tearing down the handles below.
@@ -506,6 +676,12 @@ const senpiRuntimePlugin = {
506
676
  const id = typeof params?.id === "string" ? params.id : undefined;
507
677
  const runtimeYamlPath = typeof params?.runtimeYamlPath === "string" ? params.runtimeYamlPath : undefined;
508
678
  const runtimeYamlContent = typeof params?.runtimeYamlContent === "string" ? params.runtimeYamlContent : undefined;
679
+ // Recipe directory hint. The CLI reads the -p file and sends its CONTENT
680
+ // (so remote gateways work), which loses the recipe's directory — needed to
681
+ // resolve an external scanner's relative `path: ./` and to let the scaffold
682
+ // import the author's scan module. The CLI forwards the dir here so we can
683
+ // still resolve relative paths even though only content was sent.
684
+ const runtimeYamlDir = typeof params?.runtimeYamlDir === "string" && params.runtimeYamlDir.length > 0 ? params.runtimeYamlDir : undefined;
509
685
  const hasPath = runtimeYamlPath !== undefined && runtimeYamlPath.length > 0;
510
686
  const hasContent = runtimeYamlContent !== undefined;
511
687
  if (!hasPath && !hasContent) {
@@ -518,14 +694,16 @@ const senpiRuntimePlugin = {
518
694
  }
519
695
  const pathOrContent = runtimeYamlPath ?? runtimeYamlContent;
520
696
  // Parse YAML first to extract name, version, and wallet for ID derivation.
697
+ // parsedConfig is lifted to function scope so the install-wire block can use it.
521
698
  let parsedSchemaVersion;
522
699
  let runtimeName = "";
523
700
  let wallet = "";
701
+ let parsedConfig;
524
702
  try {
525
- const { loadRuntimeConfig } = await import("./runtime/load-runtime-config.js");
526
- const { extractMajorVersion } = await import("./runtime/runtime-version.js");
527
- const parsedConfig = await loadRuntimeConfig(pathOrContent, { fromPath: hasPath });
528
- parsedSchemaVersion = extractMajorVersion(parsedConfig.version);
703
+ const { loadRuntimeConfig: lrc } = await import("./runtime/load-runtime-config.js");
704
+ const { extractMajorVersion: emv } = await import("./runtime/runtime-version.js");
705
+ parsedConfig = await lrc(pathOrContent, { fromPath: hasPath });
706
+ parsedSchemaVersion = emv(parsedConfig.version);
529
707
  runtimeName = parsedConfig.name;
530
708
  wallet = parsedConfig.strategy?.wallet ?? "";
531
709
  }
@@ -627,7 +805,15 @@ const senpiRuntimePlugin = {
627
805
  }
628
806
  const entry = hasPath
629
807
  ? { id: resolvedId, runtimeYamlPath, schemaVersion: parsedSchemaVersion, wallet }
630
- : { id: resolvedId, runtimeYamlContent: runtimeYamlContent, schemaVersion: parsedSchemaVersion, wallet };
808
+ : {
809
+ id: resolvedId,
810
+ runtimeYamlContent: runtimeYamlContent,
811
+ schemaVersion: parsedSchemaVersion,
812
+ wallet,
813
+ // Persist the recipe dir so a gateway restart can resolve an
814
+ // external scanner's relative `path: ./` (content installs drop it).
815
+ ...(runtimeYamlDir ? { runtimeYamlDir } : {}),
816
+ };
631
817
  const valid = validateEntry(entry);
632
818
  if (!valid.ok) {
633
819
  respond(false, undefined, toError(valid.error));
@@ -665,6 +851,56 @@ const senpiRuntimePlugin = {
665
851
  runtimeId: resolvedId,
666
852
  });
667
853
  runtimeHandles.set(resolvedId, handle);
854
+ // ── hot-install supervised scanner wire ───────────────────────────────
855
+ // Live-install path: used when a runtime is registered after boot via
856
+ // senpi.installRuntime, while the API is already listening — the
857
+ // counterpart to the boot-time `launcher` above. A runtime takes exactly
858
+ // one path: boot-present → `launcher` (deferred start); installed live →
859
+ // `hotLauncher` (immediate start). The two are mutually exclusive because
860
+ // installRuntime rejects any id/wallet already in the registry before
861
+ // wiring (the hasId guard), so a boot-present runtime never re-enters here.
862
+ // The API is already listening at this point, so we wire and start
863
+ // immediately (no deferred start needed). Any failure is swallowed so
864
+ // the install itself is not rolled back — the runtime is already up.
865
+ // Gate on the same API-disabled flag as the boot path: when the HTTP API
866
+ // is off (a test-only seam), the /signals route is never mounted, so
867
+ // starting scanners would only spawn children that POST to a closed port.
868
+ if (parsedConfig &&
869
+ sharedIntakeContext &&
870
+ process.env.SENPI_RUNTIME_API_DISABLED !== "true") {
871
+ try {
872
+ const apiConfig = loadApiConfig(api.pluginConfig);
873
+ const scaffoldPackageDir = fileURLToPath(new URL("./scanners/external", import.meta.url));
874
+ const entryStateDir = buildRuntimeStateDir(baseStateDir, resolvedId, wallet);
875
+ const hotLauncher = wireRuntime({
876
+ runtimeConfig: parsedConfig,
877
+ recipeDir: hasPath ? dirname(pathOrContent) : runtimeYamlDir,
878
+ runtimeId: resolvedId,
879
+ wallet,
880
+ sharedCtx: sharedIntakeContext,
881
+ runtimeHandles,
882
+ intakeUrl: intakeUrlFor(apiConfig.host, apiConfig.port),
883
+ scaffoldPackageDir,
884
+ runtimeStateDir: entryStateDir,
885
+ logger: apiLogger,
886
+ });
887
+ if (hotLauncher) {
888
+ try {
889
+ await hotLauncher.start();
890
+ launchers.set(resolvedId, hotLauncher);
891
+ }
892
+ catch (startErr) {
893
+ await hotLauncher.stop().catch(() => { });
894
+ apiLogger.error("[senpi-runtime] hot-install supervised scanner launch failed — runtime running without it", { runtimeId: resolvedId, err: startErr });
895
+ }
896
+ }
897
+ }
898
+ catch (wireErr) {
899
+ // Wire failure must NOT fail the install — the runtime is already up.
900
+ apiLogger.error("[senpi-runtime] hot-install wiring failed — runtime running without supervised scanners", { runtimeId: resolvedId, err: wireErr });
901
+ }
902
+ }
903
+ // ──────────────────────────────────────────────────────────────────────
668
904
  respond(true, { id: resolvedId, name: runtimeName, wallet });
669
905
  }
670
906
  catch (err) {
@@ -673,7 +909,7 @@ const senpiRuntimePlugin = {
673
909
  const msg = err instanceof Error ? err.message : String(err);
674
910
  respond(false, undefined, toUnavailable(`Could not start the runtime. This is usually due to invalid or incomplete YAML.\n\n${msg}`));
675
911
  }
676
- });
912
+ }, { scope: "operator.write" });
677
913
  api.registerGatewayMethod("senpi.listRuntimes", async (ctx) => {
678
914
  const respond = ctx.respond;
679
915
  const { readRegistry } = await import("./runtime/strategy-registry.js");
@@ -685,7 +921,7 @@ const senpiRuntimePlugin = {
685
921
  status: runtimeHandles.has(e.id) ? "running" : "stopped",
686
922
  }));
687
923
  respond(true, { runtimes });
688
- });
924
+ }, { scope: "operator.read" });
689
925
  api.registerGatewayMethod("senpi.deleteRuntime", async (ctx) => {
690
926
  const { params } = ctx;
691
927
  const respond = ctx.respond;
@@ -731,6 +967,14 @@ const senpiRuntimePlugin = {
731
967
  await handle.stop();
732
968
  runtimeHandles.delete(targetId);
733
969
  }
970
+ // Stop and remove the launcher for this runtime (if any).
971
+ // No-op for legacy runtimes. .stop() kills scaffold children + unregisters
972
+ // scanner_ids from the shared registry.
973
+ const launcherToStop = launchers.get(targetId);
974
+ if (launcherToStop) {
975
+ await launcherToStop.stop().catch(() => { });
976
+ launchers.delete(targetId);
977
+ }
734
978
  // Archive state directory before removing from registry
735
979
  if (deletedEntry) {
736
980
  const runtimeStateDir = buildRuntimeStateDir(baseStateDir, targetId, deletedEntry.wallet ?? "");
@@ -763,7 +1007,7 @@ const senpiRuntimePlugin = {
763
1007
  await writeRegistry(baseStateDir, { ...registry, runtimes: next });
764
1008
  }
765
1009
  respond(true, { id: targetId });
766
- });
1010
+ }, { scope: "operator.write" });
767
1011
  /**
768
1012
  * Gateway shim for `senpi.ingestExternalScannerData`.
769
1013
  *
@@ -851,7 +1095,7 @@ const senpiRuntimePlugin = {
851
1095
  message: `Failed to ingest external scanner data: ${formatGatewayError(error)}`,
852
1096
  });
853
1097
  }
854
- });
1098
+ }, { scope: "operator.write" });
855
1099
  api.registerGatewayMethod("senpi.listDslPositions", async (ctx) => {
856
1100
  const respond = ctx.respond;
857
1101
  const runtimeId = typeof ctx.params?.runtimeId === "string" ? ctx.params.runtimeId : undefined;
@@ -876,7 +1120,7 @@ const senpiRuntimePlugin = {
876
1120
  }
877
1121
  }
878
1122
  respond(true, { positions });
879
- });
1123
+ }, { scope: "operator.read" });
880
1124
  api.registerGatewayMethod("senpi.getDslPositionState", async (ctx) => {
881
1125
  const respond = ctx.respond;
882
1126
  const asset = typeof ctx.params?.asset === "string" ? ctx.params.asset : undefined;
@@ -917,7 +1161,7 @@ const senpiRuntimePlugin = {
917
1161
  return;
918
1162
  }
919
1163
  respond(true, { positions: matches });
920
- });
1164
+ }, { scope: "operator.read" });
921
1165
  api.registerGatewayMethod("senpi.listDslArchives", async (ctx) => {
922
1166
  const respond = ctx.respond;
923
1167
  const runtimeId = typeof ctx.params?.runtimeId === "string" ? ctx.params.runtimeId : undefined;
@@ -943,7 +1187,7 @@ const senpiRuntimePlugin = {
943
1187
  if (limit && limit > 0)
944
1188
  closes = closes.slice(0, limit);
945
1189
  respond(true, { closes });
946
- });
1190
+ }, { scope: "operator.read" });
947
1191
  api.registerGatewayMethod("senpi.getHealthStatus", async (ctx) => {
948
1192
  const respond = ctx.respond;
949
1193
  const updater = autoUpdateCoordinator.getSnapshot();
@@ -971,7 +1215,7 @@ const senpiRuntimePlugin = {
971
1215
  }
972
1216
  const statuses = await collectRuntimeHealthStatuses(runtimeHandles, api.logger);
973
1217
  respond(true, { statuses, updater });
974
- });
1218
+ }, { scope: "operator.read" });
975
1219
  api.registerGatewayMethod("senpi.getSystemState", async (ctx) => {
976
1220
  const respond = ctx.respond;
977
1221
  const updater = autoUpdateCoordinator.getSnapshot();
@@ -999,7 +1243,7 @@ const senpiRuntimePlugin = {
999
1243
  }
1000
1244
  const states = await collectRuntimeSystemStates(runtimeHandles, api.logger, baseStateDir);
1001
1245
  respond(true, { states, updater });
1002
- });
1246
+ }, { scope: "operator.read" });
1003
1247
  /**
1004
1248
  * Action layer — read-only inspection.
1005
1249
  *
@@ -1048,7 +1292,7 @@ const senpiRuntimePlugin = {
1048
1292
  }
1049
1293
  }
1050
1294
  respond(true, { actions: merged });
1051
- });
1295
+ }, { scope: "operator.read" });
1052
1296
  api.registerGatewayMethod("senpi.getActionState", async (ctx) => {
1053
1297
  const respond = ctx.respond;
1054
1298
  const runtimeId = typeof ctx.params?.runtimeId === "string" ? ctx.params.runtimeId : undefined;
@@ -1085,7 +1329,7 @@ const senpiRuntimePlugin = {
1085
1329
  message: `Failed to read action state: ${formatGatewayError(err)}`,
1086
1330
  });
1087
1331
  }
1088
- });
1332
+ }, { scope: "operator.read" });
1089
1333
  api.registerGatewayMethod("senpi.getActionHistory", async (ctx) => {
1090
1334
  const respond = ctx.respond;
1091
1335
  const runtimeId = typeof ctx.params?.runtimeId === "string" ? ctx.params.runtimeId : undefined;
@@ -1149,13 +1393,13 @@ const senpiRuntimePlugin = {
1149
1393
  message: `Failed to read action history: ${formatGatewayError(err)}`,
1150
1394
  });
1151
1395
  }
1152
- });
1396
+ }, { scope: "operator.read" });
1153
1397
  // ─── Skills manager — read + mutate ──────────────────────────────────────
1154
1398
  api.registerGatewayMethod("senpi.skills.status", async (ctx) => {
1155
1399
  const respond = ctx.respond;
1156
1400
  const snapshot = skillsCoordinator.getSnapshot();
1157
1401
  respond(true, { snapshot });
1158
- });
1402
+ }, { scope: "operator.read" });
1159
1403
  api.registerGatewayMethod("senpi.skills.update", async (ctx) => {
1160
1404
  const respond = ctx.respond;
1161
1405
  const name = typeof ctx.params?.name === "string" ? ctx.params.name.trim() : undefined;
@@ -1180,7 +1424,7 @@ const senpiRuntimePlugin = {
1180
1424
  message: err instanceof Error ? err.message : String(err),
1181
1425
  });
1182
1426
  }
1183
- });
1427
+ }, { scope: "operator.write" });
1184
1428
  api.registerGatewayMethod("senpi.skills.updateAll", async (ctx) => {
1185
1429
  const respond = ctx.respond;
1186
1430
  try {
@@ -1200,7 +1444,7 @@ const senpiRuntimePlugin = {
1200
1444
  message: err instanceof Error ? err.message : String(err),
1201
1445
  });
1202
1446
  }
1203
- });
1447
+ }, { scope: "operator.write" });
1204
1448
  api.logger.info(`[senpi-runtime] v${VERSION} plugin registered — stateDir: ${baseStateDir}`);
1205
1449
  },
1206
1450
  };