@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,36 @@
1
+ /**
2
+ * Startup orphan sweep — Option C long-running mode.
3
+ *
4
+ * Every child spawned by LongRunningSupervisor carries a marker env var:
5
+ * SENPI_SUPERVISED=<supervisorId>
6
+ *
7
+ * When the runtime is killed hard (SIGKILL, OOM, power-cycle) the graceful
8
+ * shutdown code never runs and supervised children become orphans. The sweep
9
+ * scans `ps` for processes carrying the marker and kills them (group kill +
10
+ * descendant reap). It must be called by the host BEFORE any new spawning.
11
+ *
12
+ * This is a static, standalone utility — no class, no instance state.
13
+ */
14
+ import type { Logger } from "../../utils/logger.js";
15
+ /** The env-var name stamped on every supervised child. */
16
+ export declare const SENPI_SUPERVISED_ENV = "SENPI_SUPERVISED";
17
+ /** Result of a single orphan-sweep run. */
18
+ export interface SweepResult {
19
+ /** Number of orphaned root processes found (carrying the marker). */
20
+ found: number;
21
+ /** PIDs that were signalled (best-effort; some may have already been gone). */
22
+ killed: number[];
23
+ }
24
+ /**
25
+ * Scan `ps` for processes carrying `SENPI_SUPERVISED[=<supervisorId>]` in
26
+ * their environment, kill them (SIGKILL to process group + descendant reap),
27
+ * and return a summary.
28
+ *
29
+ * @param supervisorId If provided, only sweep orphans for this specific
30
+ * supervisor; otherwise sweep ALL `SENPI_SUPERVISED` orphans (full reset).
31
+ * @param logger Structured logger.
32
+ *
33
+ * POSIX-only. On Windows returns { found: 0, killed: [] } immediately.
34
+ */
35
+ export declare function sweepOrphans(supervisorId: string | undefined, logger: Logger): SweepResult;
36
+ //# sourceMappingURL=orphan-sweep.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orphan-sweep.d.ts","sourceRoot":"","sources":["../../../src/runtime/supervisor/orphan-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,GACb,WAAW,CAgDb"}
@@ -0,0 +1,255 @@
1
+ /**
2
+ * Startup orphan sweep — Option C long-running mode.
3
+ *
4
+ * Every child spawned by LongRunningSupervisor carries a marker env var:
5
+ * SENPI_SUPERVISED=<supervisorId>
6
+ *
7
+ * When the runtime is killed hard (SIGKILL, OOM, power-cycle) the graceful
8
+ * shutdown code never runs and supervised children become orphans. The sweep
9
+ * scans `ps` for processes carrying the marker and kills them (group kill +
10
+ * descendant reap). It must be called by the host BEFORE any new spawning.
11
+ *
12
+ * This is a static, standalone utility — no class, no instance state.
13
+ */
14
+ import { execFileSync } from "../../utils/safe-spawn.js";
15
+ import { readFileSync } from "node:fs";
16
+ import { collectDescendants, reapSurvivors } from "./supervisor-utils.js";
17
+ /** The env-var name stamped on every supervised child. */
18
+ export const SENPI_SUPERVISED_ENV = "SENPI_SUPERVISED";
19
+ /**
20
+ * Scan `ps` for processes carrying `SENPI_SUPERVISED[=<supervisorId>]` in
21
+ * their environment, kill them (SIGKILL to process group + descendant reap),
22
+ * and return a summary.
23
+ *
24
+ * @param supervisorId If provided, only sweep orphans for this specific
25
+ * supervisor; otherwise sweep ALL `SENPI_SUPERVISED` orphans (full reset).
26
+ * @param logger Structured logger.
27
+ *
28
+ * POSIX-only. On Windows returns { found: 0, killed: [] } immediately.
29
+ */
30
+ export function sweepOrphans(supervisorId, logger) {
31
+ if (process.platform === "win32") {
32
+ return { found: 0, killed: [] };
33
+ }
34
+ const matcher = buildMarkerMatcher(supervisorId);
35
+ const orphanPids = findOrphanPids(matcher, logger);
36
+ const killed = [];
37
+ for (const pid of orphanPids) {
38
+ // Snapshot descendants BEFORE we kill the process (still alive, still parenting).
39
+ const descendants = collectDescendants(pid, logger);
40
+ // Try group kill first, then direct kill.
41
+ let signalled = false;
42
+ try {
43
+ process.kill(-pid, "SIGKILL");
44
+ signalled = true;
45
+ }
46
+ catch {
47
+ try {
48
+ process.kill(pid, "SIGKILL");
49
+ signalled = true;
50
+ }
51
+ catch {
52
+ // Already dead or not permitted — move on.
53
+ }
54
+ }
55
+ if (signalled) {
56
+ killed.push(pid);
57
+ logger.warn("orphan-sweep: killed orphaned supervised process", {
58
+ pid,
59
+ supervisorId: supervisorId ?? "*",
60
+ });
61
+ }
62
+ // Reap any surviving descendants.
63
+ reapSurvivors(descendants, "SIGKILL", logger);
64
+ }
65
+ if (orphanPids.length > 0) {
66
+ logger.info("orphan-sweep: complete", {
67
+ found: orphanPids.length,
68
+ killed: killed.length,
69
+ supervisorId: supervisorId ?? "*",
70
+ });
71
+ }
72
+ return { found: orphanPids.length, killed };
73
+ }
74
+ function buildMarkerMatcher(supervisorId) {
75
+ const prefix = `${SENPI_SUPERVISED_ENV}=`;
76
+ if (supervisorId !== undefined) {
77
+ const exact = `${prefix}${supervisorId}`;
78
+ return {
79
+ matchesEntry: (entry) => entry === exact,
80
+ // (start | space) SENPI_SUPERVISED=<id> (end | space)
81
+ envSectionRegex: new RegExp(`(^|\\s)${escapeRegex(exact)}(\\s|$)`),
82
+ };
83
+ }
84
+ return {
85
+ // Wildcard: KEY must be exactly SENPI_SUPERVISED (entry is `SENPI_SUPERVISED=<anything>`).
86
+ matchesEntry: (entry) => entry.startsWith(prefix),
87
+ // (start | space) SENPI_SUPERVISED= ... (value runs to next space or end)
88
+ envSectionRegex: new RegExp(`(^|\\s)${escapeRegex(prefix)}`),
89
+ };
90
+ }
91
+ function escapeRegex(s) {
92
+ return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
93
+ }
94
+ /**
95
+ * Enumerate all pids and return those whose ENVIRONMENT carries the marker.
96
+ * - Linux: read `/proc/<pid>/environ` (NUL-delimited, clean env).
97
+ * - macOS/BSD: isolate the env section from `ps` output (see
98
+ * macosProcessHasMarker) and match whole env tokens only.
99
+ *
100
+ * macOS cost note: the precise per-pid probe costs TWO `ps` execs per pid —
101
+ * exhaustively probing every pid is O(2N) synchronous subprocess spawns
102
+ * (~5s of blocked event loop for ~600 pids). So on macOS we first run ONE
103
+ * batched `ps` over the whole table and only run the precise probe on pids
104
+ * whose line mentions the marker name at all. The prefilter is intentionally
105
+ * over-inclusive (argv mentions included) — the precise probe still makes the
106
+ * kill decision, so the false-positive guarantees are unchanged.
107
+ */
108
+ function findOrphanPids(matcher, logger) {
109
+ if (process.platform !== "linux") {
110
+ const candidates = macosCandidatePids(logger);
111
+ if (candidates !== null) {
112
+ return candidates.filter((pid) => processHasMarker(pid, matcher, logger));
113
+ }
114
+ // Prefilter unusable — fall through to the exhaustive scan.
115
+ }
116
+ const allPids = listAllPids(logger);
117
+ if (allPids.length === 0)
118
+ return [];
119
+ const orphans = [];
120
+ for (const pid of allPids) {
121
+ if (processHasMarker(pid, matcher, logger)) {
122
+ orphans.push(pid);
123
+ }
124
+ }
125
+ return orphans;
126
+ }
127
+ /**
128
+ * macOS/BSD prefilter: one batched `ps -A -Eww -o pid=,args=` over the whole
129
+ * process table; any line containing the marker NAME yields a candidate pid.
130
+ *
131
+ * Line-per-process is safe: BSD `ps` vis-encodes control characters (a raw
132
+ * newline in argv prints as `\012`), so hostile argv cannot split a record.
133
+ * Belt-and-braces: if a marker-bearing line ever has no parseable leading pid
134
+ * (unattributable record), return null so the caller degrades to the
135
+ * exhaustive per-pid scan instead of missing an orphan.
136
+ *
137
+ * Returns null when the batched ps is unavailable/unparseable.
138
+ */
139
+ function macosCandidatePids(logger) {
140
+ let raw;
141
+ try {
142
+ raw = execFileSync("ps", ["-A", "-Eww", "-o", "pid=,args="], {
143
+ encoding: "utf8",
144
+ timeout: 5000,
145
+ maxBuffer: 64 * 1024 * 1024,
146
+ });
147
+ }
148
+ catch (err) {
149
+ logger.warn("orphan-sweep: batched ps -E prefilter failed — using exhaustive scan", {
150
+ error: err instanceof Error ? err.message : String(err),
151
+ });
152
+ return null;
153
+ }
154
+ const candidates = new Set();
155
+ for (const line of raw.split("\n")) {
156
+ if (!line.includes(SENPI_SUPERVISED_ENV))
157
+ continue;
158
+ const m = /^\s*(\d+)\s/.exec(line);
159
+ if (m === null) {
160
+ logger.warn("orphan-sweep: marker text on an unattributable ps line — using exhaustive scan");
161
+ return null;
162
+ }
163
+ candidates.add(parseInt(m[1], 10));
164
+ }
165
+ return [...candidates];
166
+ }
167
+ /** Return all PIDs currently in the process table. */
168
+ function listAllPids(logger) {
169
+ try {
170
+ const raw = execFileSync("ps", ["-A", "-o", "pid="], {
171
+ encoding: "utf8",
172
+ timeout: 3000,
173
+ maxBuffer: 8 * 1024 * 1024,
174
+ });
175
+ return raw
176
+ .split("\n")
177
+ .map((l) => parseInt(l.trim(), 10))
178
+ .filter((n) => Number.isInteger(n) && n > 0);
179
+ }
180
+ catch (err) {
181
+ logger.warn("orphan-sweep: could not list pids", {
182
+ error: err instanceof Error ? err.message : String(err),
183
+ });
184
+ return [];
185
+ }
186
+ }
187
+ /**
188
+ * Check whether the process at `pid` carries the marker in its ENVIRONMENT.
189
+ * Uses `/proc/<pid>/environ` on Linux, `ps` env-section isolation on macOS/BSD.
190
+ */
191
+ function processHasMarker(pid, matcher, logger) {
192
+ // Skip our own process.
193
+ if (pid === process.pid)
194
+ return false;
195
+ try {
196
+ if (process.platform === "linux") {
197
+ return linuxProcessHasMarker(pid, matcher);
198
+ }
199
+ else {
200
+ return macosProcessHasMarker(pid, matcher, logger);
201
+ }
202
+ }
203
+ catch {
204
+ return false;
205
+ }
206
+ }
207
+ function linuxProcessHasMarker(pid, matcher) {
208
+ // NOTE: must be the static ESM import above — this package is "type":
209
+ // "module", so a bare CJS `require("node:fs")` here throws ReferenceError at
210
+ // runtime, the catch below swallows it, and the Linux sweep silently finds
211
+ // ZERO orphans in production while every macOS test stays green.
212
+ try {
213
+ // /proc/<pid>/environ is NUL-delimited KEY=VALUE pairs — a clean env, with
214
+ // no argv contamination. Match whole entries only.
215
+ const raw = readFileSync(`/proc/${pid}/environ`);
216
+ const env = raw.toString("utf8").split("\0");
217
+ return env.some((entry) => matcher.matchesEntry(entry));
218
+ }
219
+ catch {
220
+ return false;
221
+ }
222
+ }
223
+ function macosProcessHasMarker(pid, matcher, logger) {
224
+ try {
225
+ // macOS `ps -Eww -o args=` concatenates argv + env on one line with no
226
+ // delimiter, so a naive substring match would false-positive on any process
227
+ // whose ARGV merely contains the marker string. We isolate the env section
228
+ // by subtracting the argv-only output (same `ps`, without -E) from the
229
+ // argv+env output, then match whole env tokens against the anchored regex.
230
+ const argvEnv = execFileSync("ps", ["-Eww", "-p", String(pid), "-o", "args="], {
231
+ encoding: "utf8",
232
+ timeout: 1000,
233
+ }).replace(/\n$/, "");
234
+ const argvOnly = execFileSync("ps", ["-ww", "-p", String(pid), "-o", "args="], {
235
+ encoding: "utf8",
236
+ timeout: 1000,
237
+ }).replace(/\n$/, "");
238
+ // The env section is whatever trails the argv prefix. If the prefixes don't
239
+ // line up (rare ps quirk), fall back to the full blob — still anchored, so
240
+ // an exact `SENPI_SUPERVISED=<id>` token in argv is the only residual risk.
241
+ const envSection = argvEnv.startsWith(argvOnly)
242
+ ? argvEnv.slice(argvOnly.length)
243
+ : argvEnv;
244
+ return matcher.envSectionRegex.test(envSection);
245
+ }
246
+ catch (err) {
247
+ // ESRCH: process is already gone — not an error worth logging.
248
+ const msg = err instanceof Error ? err.message : String(err);
249
+ if (!msg.includes("No such process") && !msg.includes("exited with")) {
250
+ logger.debug?.("orphan-sweep: ps -E probe failed", { pid, error: msg });
251
+ }
252
+ return false;
253
+ }
254
+ }
255
+ //# sourceMappingURL=orphan-sweep.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orphan-sweep.js","sourceRoot":"","sources":["../../../src/runtime/supervisor/orphan-sweep.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Shared low-level utilities (process kill/reap, id minting) used across the
3
+ * supervisor stack — LongRunningSupervisor and the orphan sweep.
4
+ *
5
+ * Extracted so the kill/reap machinery is maintained in one place.
6
+ */
7
+ import type { ChildProcess } from "../../utils/safe-spawn.js";
8
+ import type { Logger } from "../../utils/logger.js";
9
+ /**
10
+ * Send SIGTERM to `child` (and its process group), then SIGKILL after the
11
+ * grace period if still alive. Safe to call on an already-dead child.
12
+ *
13
+ * Returns once the child (and any stragglers found in the pre-kill descendant
14
+ * snapshot) are all gone.
15
+ */
16
+ export declare function killChild(child: ChildProcess, reason: string, graceMs: number, logger: Logger): Promise<void>;
17
+ /**
18
+ * SIGKILL any pids from a pre-kill descendant snapshot that are still alive.
19
+ */
20
+ export declare function reapSurvivors(pids: number[], sig: "SIGKILL", logger: Logger): void;
21
+ /**
22
+ * Signal the child's process group (negative pid) when detached, falling back
23
+ * to the direct child. Returns false if the process is already gone.
24
+ */
25
+ export declare function signalChild(child: ChildProcess, sig: "SIGTERM" | "SIGKILL"): boolean;
26
+ /**
27
+ * Collect every transitive descendant pid of `rootPid` by reading the full
28
+ * process table once and walking the ppid graph.
29
+ *
30
+ * POSIX-only (uses `ps`). Returns empty list on Windows or if `ps` is
31
+ * unavailable. `rootPid` itself is NOT included.
32
+ */
33
+ export declare function collectDescendants(rootPid: number, logger: Logger): number[];
34
+ export declare function errorMessage(err: unknown): string;
35
+ export declare function isErrno(err: unknown, code: string): boolean;
36
+ export declare function makeId(prefix: string): string;
37
+ //# sourceMappingURL=supervisor-utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"supervisor-utils.d.ts","sourceRoot":"","sources":["../../../src/runtime/supervisor/supervisor-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIpD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAiDf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,GACb,IAAI,CAcN;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,SAAS,GAAG,SAAS,GACzB,OAAO,CAgBT;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA2C5E;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAM3D;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7C"}
@@ -0,0 +1,175 @@
1
+ /**
2
+ * Shared low-level utilities (process kill/reap, id minting) used across the
3
+ * supervisor stack — LongRunningSupervisor and the orphan sweep.
4
+ *
5
+ * Extracted so the kill/reap machinery is maintained in one place.
6
+ */
7
+ import { execFileSync } from "../../utils/safe-spawn.js";
8
+ // ─── kill / reap ──────────────────────────────────────────────────────────────
9
+ /**
10
+ * Send SIGTERM to `child` (and its process group), then SIGKILL after the
11
+ * grace period if still alive. Safe to call on an already-dead child.
12
+ *
13
+ * Returns once the child (and any stragglers found in the pre-kill descendant
14
+ * snapshot) are all gone.
15
+ */
16
+ export async function killChild(child, reason, graceMs, logger) {
17
+ // Already exited — nothing to do.
18
+ if (child.exitCode !== null || child.signalCode !== null) {
19
+ return;
20
+ }
21
+ // Snapshot descendant tree BEFORE sending SIGTERM so daemonizing grandchildren
22
+ // (which may re-session out of the group) are captured while their ppid still
23
+ // points to the child.
24
+ const descendants = child.pid !== undefined ? collectDescendants(child.pid, logger) : [];
25
+ if (!signalChild(child, "SIGTERM")) {
26
+ // Already gone or not permitted — still sweep any captured descendants.
27
+ reapSurvivors(descendants, "SIGKILL", logger);
28
+ return;
29
+ }
30
+ await new Promise((resolve) => {
31
+ let done = false;
32
+ let killTimer = null;
33
+ let hardTimer = null;
34
+ const finish = () => {
35
+ if (done)
36
+ return;
37
+ done = true;
38
+ if (killTimer !== null)
39
+ clearTimeout(killTimer);
40
+ if (hardTimer !== null)
41
+ clearTimeout(hardTimer);
42
+ child.removeListener("exit", finish);
43
+ resolve();
44
+ };
45
+ child.once("exit", finish);
46
+ killTimer = setTimeout(() => {
47
+ if (done)
48
+ return;
49
+ logger.warn("killChild: escalating SIGTERM → SIGKILL", {
50
+ pid: child.pid,
51
+ reason,
52
+ graceMs,
53
+ });
54
+ signalChild(child, "SIGKILL");
55
+ // Hard-stop in case the exit event somehow never fires.
56
+ hardTimer = setTimeout(finish, graceMs);
57
+ }, graceMs);
58
+ });
59
+ // Sweep any escaped descendants — daemonized grandchildren that re-sessioned.
60
+ reapSurvivors(descendants, "SIGKILL", logger);
61
+ }
62
+ /**
63
+ * SIGKILL any pids from a pre-kill descendant snapshot that are still alive.
64
+ */
65
+ export function reapSurvivors(pids, sig, logger) {
66
+ for (const pid of pids) {
67
+ try {
68
+ process.kill(pid, 0); // throws ESRCH if already gone
69
+ }
70
+ catch {
71
+ continue;
72
+ }
73
+ try {
74
+ process.kill(pid, sig);
75
+ logger.warn("reapSurvivors: reaped escaped descendant", { pid });
76
+ }
77
+ catch {
78
+ // Already gone or not permitted.
79
+ }
80
+ }
81
+ }
82
+ /**
83
+ * Signal the child's process group (negative pid) when detached, falling back
84
+ * to the direct child. Returns false if the process is already gone.
85
+ */
86
+ export function signalChild(child, sig) {
87
+ const pid = child.pid;
88
+ if (pid === undefined)
89
+ return false;
90
+ try {
91
+ process.kill(-pid, sig);
92
+ return true;
93
+ }
94
+ catch (err) {
95
+ if (isErrno(err, "EPERM") || isErrno(err, "ESRCH")) {
96
+ // fall through to direct kill
97
+ }
98
+ }
99
+ try {
100
+ return child.kill(sig);
101
+ }
102
+ catch {
103
+ return false;
104
+ }
105
+ }
106
+ /**
107
+ * Collect every transitive descendant pid of `rootPid` by reading the full
108
+ * process table once and walking the ppid graph.
109
+ *
110
+ * POSIX-only (uses `ps`). Returns empty list on Windows or if `ps` is
111
+ * unavailable. `rootPid` itself is NOT included.
112
+ */
113
+ export function collectDescendants(rootPid, logger) {
114
+ if (process.platform === "win32")
115
+ return [];
116
+ let raw;
117
+ try {
118
+ raw = execFileSync("ps", ["-A", "-o", "pid=,ppid="], {
119
+ encoding: "utf8",
120
+ timeout: 2000,
121
+ maxBuffer: 8 * 1024 * 1024,
122
+ });
123
+ }
124
+ catch (err) {
125
+ logger.warn("collectDescendants: could not enumerate processes", {
126
+ error: errorMessage(err),
127
+ });
128
+ return [];
129
+ }
130
+ const childrenOf = new Map();
131
+ for (const line of raw.split("\n")) {
132
+ const trimmed = line.trim();
133
+ if (trimmed === "")
134
+ continue;
135
+ const parts = trimmed.split(/\s+/);
136
+ if (parts.length < 2)
137
+ continue;
138
+ const pid = Number(parts[0]);
139
+ const ppid = Number(parts[1]);
140
+ if (!Number.isInteger(pid) || !Number.isInteger(ppid))
141
+ continue;
142
+ const arr = childrenOf.get(ppid);
143
+ if (arr)
144
+ arr.push(pid);
145
+ else
146
+ childrenOf.set(ppid, [pid]);
147
+ }
148
+ const result = [];
149
+ const seen = new Set([rootPid]);
150
+ const queue = [rootPid];
151
+ while (queue.length > 0) {
152
+ const cur = queue.shift();
153
+ for (const kid of childrenOf.get(cur) ?? []) {
154
+ if (seen.has(kid))
155
+ continue;
156
+ seen.add(kid);
157
+ result.push(kid);
158
+ queue.push(kid);
159
+ }
160
+ }
161
+ return result;
162
+ }
163
+ // ─── tiny shared utilities ────────────────────────────────────────────────────
164
+ export function errorMessage(err) {
165
+ return err instanceof Error ? err.message : String(err);
166
+ }
167
+ export function isErrno(err, code) {
168
+ return (typeof err === "object" &&
169
+ err !== null &&
170
+ err.code === code);
171
+ }
172
+ export function makeId(prefix) {
173
+ return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
174
+ }
175
+ //# sourceMappingURL=supervisor-utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"supervisor-utils.js","sourceRoot":"","sources":["../../../src/runtime/supervisor/supervisor-utils.ts"],"names":[],"mappings":"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"}
@@ -43,10 +43,10 @@ export interface IngestSignalsDeps {
43
43
  * message before the engine lock is acquired.)
44
44
  *
45
45
  * Per-(address, scanner) ingest lock is the engine's concern; callers should
46
- * use {@link groupByAddressScanner} or nest multiple signals in `signals[]`
47
- * rather than submitting concurrent top-level items for the same key.
46
+ * nest multiple signals in `signals[]` rather than submitting concurrent
47
+ * top-level items for the same key.
48
48
  *
49
- * @param item A single element from the `POST /signals` request body.
49
+ * @param item A single signal item.
50
50
  * @param deps Injected dependencies.
51
51
  * @returns A resolved `SignalResult` — never rejects.
52
52
  */
@@ -23,10 +23,10 @@ import { findRuntimeHandleByAddress } from "./runtime-lookup.js";
23
23
  * message before the engine lock is acquired.)
24
24
  *
25
25
  * Per-(address, scanner) ingest lock is the engine's concern; callers should
26
- * use {@link groupByAddressScanner} or nest multiple signals in `signals[]`
27
- * rather than submitting concurrent top-level items for the same key.
26
+ * nest multiple signals in `signals[]` rather than submitting concurrent
27
+ * top-level items for the same key.
28
28
  *
29
- * @param item A single element from the `POST /signals` request body.
29
+ * @param item A single signal item.
30
30
  * @param deps Injected dependencies.
31
31
  * @returns A resolved `SignalResult` — never rejects.
32
32
  */