@senpi-ai/runtime 1.1.3 → 3.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (483) hide show
  1. package/README.md +10 -9
  2. package/dist/actions/action-runtime-module.d.ts.map +1 -1
  3. package/dist/actions/action-runtime-module.js +1 -1
  4. package/dist/actions/action-runtime-module.js.map +1 -1
  5. package/dist/actions/close-position/close-position.action.d.ts.map +1 -1
  6. package/dist/actions/close-position/close-position.action.js +61 -14
  7. package/dist/actions/close-position/close-position.action.js.map +1 -1
  8. package/dist/actions/decision-engine.d.ts.map +1 -1
  9. package/dist/actions/decision-engine.js +3 -0
  10. package/dist/actions/decision-engine.js.map +1 -1
  11. package/dist/actions/open-position/open-position.action.d.ts.map +1 -1
  12. package/dist/actions/open-position/open-position.action.js +155 -35
  13. package/dist/actions/open-position/open-position.action.js.map +1 -1
  14. package/dist/actions/open-position/resolve-margin.d.ts +18 -3
  15. package/dist/actions/open-position/resolve-margin.d.ts.map +1 -1
  16. package/dist/actions/open-position/resolve-margin.js +22 -9
  17. package/dist/actions/open-position/resolve-margin.js.map +1 -1
  18. package/dist/actions/position-tracker/position-tracker.action.d.ts +6 -0
  19. package/dist/actions/position-tracker/position-tracker.action.d.ts.map +1 -1
  20. package/dist/actions/position-tracker/position-tracker.action.js +48 -0
  21. package/dist/actions/position-tracker/position-tracker.action.js.map +1 -1
  22. package/dist/actions/tracking-helpers.d.ts +16 -1
  23. package/dist/actions/tracking-helpers.d.ts.map +1 -1
  24. package/dist/actions/tracking-helpers.js +55 -9
  25. package/dist/actions/tracking-helpers.js.map +1 -1
  26. package/dist/actions/types.d.ts +10 -2
  27. package/dist/actions/types.d.ts.map +1 -1
  28. package/dist/actions/types.js +8 -0
  29. package/dist/actions/types.js.map +1 -1
  30. package/dist/cli/guide-commands.d.ts.map +1 -1
  31. package/dist/cli/guide-commands.js +102 -82
  32. package/dist/cli/guide-commands.js.map +1 -1
  33. package/dist/cli/senpi-commands.d.ts.map +1 -1
  34. package/dist/cli/senpi-commands.js +16 -110
  35. package/dist/cli/senpi-commands.js.map +1 -1
  36. package/dist/constants/dsl/index.d.ts +2 -0
  37. package/dist/constants/dsl/index.d.ts.map +1 -1
  38. package/dist/constants/dsl/index.js +2 -0
  39. package/dist/constants/dsl/index.js.map +1 -1
  40. package/dist/dsl/config/parse-tiers.d.ts.map +1 -1
  41. package/dist/dsl/config/parse-tiers.js +6 -2
  42. package/dist/dsl/config/parse-tiers.js.map +1 -1
  43. package/dist/dsl/engine-client/config-mapping.d.ts +3 -1
  44. package/dist/dsl/engine-client/config-mapping.d.ts.map +1 -1
  45. package/dist/dsl/engine-client/config-mapping.js +3 -1
  46. package/dist/dsl/engine-client/config-mapping.js.map +1 -1
  47. package/dist/dsl/engine-client/event-mapping.d.ts +2 -0
  48. package/dist/dsl/engine-client/event-mapping.d.ts.map +1 -1
  49. package/dist/dsl/engine-client/event-mapping.js +3 -0
  50. package/dist/dsl/engine-client/event-mapping.js.map +1 -1
  51. package/dist/dsl/events/build-closed-event.d.ts.map +1 -1
  52. package/dist/dsl/events/build-closed-event.js +1 -0
  53. package/dist/dsl/events/build-closed-event.js.map +1 -1
  54. package/dist/dsl/events/guards.d.ts.map +1 -1
  55. package/dist/dsl/events/guards.js +10 -0
  56. package/dist/dsl/events/guards.js.map +1 -1
  57. package/dist/dsl/events/handlers.d.ts +18 -2
  58. package/dist/dsl/events/handlers.d.ts.map +1 -1
  59. package/dist/dsl/events/handlers.js +304 -208
  60. package/dist/dsl/events/handlers.js.map +1 -1
  61. package/dist/dsl/events/initial-state.d.ts.map +1 -1
  62. package/dist/dsl/events/initial-state.js +3 -1
  63. package/dist/dsl/events/initial-state.js.map +1 -1
  64. package/dist/dsl/monitor/create-monitor.d.ts +15 -0
  65. package/dist/dsl/monitor/create-monitor.d.ts.map +1 -1
  66. package/dist/dsl/monitor/create-monitor.js +76 -9
  67. package/dist/dsl/monitor/create-monitor.js.map +1 -1
  68. package/dist/dsl/monitor/process-one-position.d.ts.map +1 -1
  69. package/dist/dsl/monitor/process-one-position.js +268 -82
  70. package/dist/dsl/monitor/process-one-position.js.map +1 -1
  71. package/dist/dsl/plugin/index.d.ts +16 -1
  72. package/dist/dsl/plugin/index.d.ts.map +1 -1
  73. package/dist/dsl/plugin/index.js +35 -4
  74. package/dist/dsl/plugin/index.js.map +1 -1
  75. package/dist/dsl/plugin/options.d.ts +18 -0
  76. package/dist/dsl/plugin/options.d.ts.map +1 -1
  77. package/dist/index.d.ts +14 -1
  78. package/dist/index.d.ts.map +1 -1
  79. package/dist/index.js +276 -32
  80. package/dist/index.js.map +1 -1
  81. package/dist/recording/emitter.d.ts +27 -0
  82. package/dist/recording/emitter.d.ts.map +1 -0
  83. package/dist/recording/emitter.js +2 -0
  84. package/dist/recording/emitter.js.map +1 -0
  85. package/dist/recording/identity.d.ts +34 -0
  86. package/dist/recording/identity.d.ts.map +1 -0
  87. package/dist/recording/identity.js +2 -0
  88. package/dist/recording/identity.js.map +1 -0
  89. package/dist/recording/index.d.ts +11 -0
  90. package/dist/recording/index.d.ts.map +1 -0
  91. package/dist/recording/index.js +2 -0
  92. package/dist/recording/index.js.map +1 -0
  93. package/dist/recording/noop-emitter.d.ts +23 -0
  94. package/dist/recording/noop-emitter.d.ts.map +1 -0
  95. package/dist/recording/noop-emitter.js +22 -0
  96. package/dist/recording/noop-emitter.js.map +1 -0
  97. package/dist/recording/otel/attributes.d.ts +35 -0
  98. package/dist/recording/otel/attributes.d.ts.map +1 -0
  99. package/dist/recording/otel/attributes.js +131 -0
  100. package/dist/recording/otel/attributes.js.map +1 -0
  101. package/dist/recording/otel/constants.d.ts +123 -0
  102. package/dist/recording/otel/constants.d.ts.map +1 -0
  103. package/dist/recording/otel/constants.js +172 -0
  104. package/dist/recording/otel/constants.js.map +1 -0
  105. package/dist/recording/otel/ids.d.ts +25 -0
  106. package/dist/recording/otel/ids.d.ts.map +1 -0
  107. package/dist/recording/otel/ids.js +37 -0
  108. package/dist/recording/otel/ids.js.map +1 -0
  109. package/dist/recording/otel/index.d.ts +13 -0
  110. package/dist/recording/otel/index.d.ts.map +1 -0
  111. package/dist/recording/otel/index.js +9 -0
  112. package/dist/recording/otel/index.js.map +1 -0
  113. package/dist/recording/otel/mappers.d.ts +100 -0
  114. package/dist/recording/otel/mappers.d.ts.map +1 -0
  115. package/dist/recording/otel/mappers.js +683 -0
  116. package/dist/recording/otel/mappers.js.map +1 -0
  117. package/dist/recording/otel/otel-emitter.d.ts +43 -0
  118. package/dist/recording/otel/otel-emitter.d.ts.map +1 -0
  119. package/dist/recording/otel/otel-emitter.js +99 -0
  120. package/dist/recording/otel/otel-emitter.js.map +1 -0
  121. package/dist/recording/otel/redaction.d.ts +47 -0
  122. package/dist/recording/otel/redaction.d.ts.map +1 -0
  123. package/dist/recording/otel/redaction.js +88 -0
  124. package/dist/recording/otel/redaction.js.map +1 -0
  125. package/dist/recording/records.d.ts +565 -0
  126. package/dist/recording/records.d.ts.map +1 -0
  127. package/dist/recording/records.js +14 -0
  128. package/dist/recording/records.js.map +1 -0
  129. package/dist/recording/transport/batcher.d.ts +59 -0
  130. package/dist/recording/transport/batcher.d.ts.map +1 -0
  131. package/dist/recording/transport/batcher.js +234 -0
  132. package/dist/recording/transport/batcher.js.map +1 -0
  133. package/dist/recording/transport/client.d.ts +41 -0
  134. package/dist/recording/transport/client.d.ts.map +1 -0
  135. package/dist/recording/transport/client.js +69 -0
  136. package/dist/recording/transport/client.js.map +1 -0
  137. package/dist/recording/transport/config.d.ts +53 -0
  138. package/dist/recording/transport/config.d.ts.map +1 -0
  139. package/dist/recording/transport/config.js +41 -0
  140. package/dist/recording/transport/config.js.map +1 -0
  141. package/dist/recording/transport/index.d.ts +16 -0
  142. package/dist/recording/transport/index.d.ts.map +1 -0
  143. package/dist/recording/transport/index.js +12 -0
  144. package/dist/recording/transport/index.js.map +1 -0
  145. package/dist/recording/transport/rows.d.ts +88 -0
  146. package/dist/recording/transport/rows.d.ts.map +1 -0
  147. package/dist/recording/transport/rows.js +15 -0
  148. package/dist/recording/transport/rows.js.map +1 -0
  149. package/dist/recording/wiring/emitter-factory.d.ts +39 -0
  150. package/dist/recording/wiring/emitter-factory.d.ts.map +1 -0
  151. package/dist/recording/wiring/emitter-factory.js +62 -0
  152. package/dist/recording/wiring/emitter-factory.js.map +1 -0
  153. package/dist/recording/wiring/identity.d.ts +27 -0
  154. package/dist/recording/wiring/identity.d.ts.map +1 -0
  155. package/dist/recording/wiring/identity.js +51 -0
  156. package/dist/recording/wiring/identity.js.map +1 -0
  157. package/dist/recording/wiring/index.d.ts +12 -0
  158. package/dist/recording/wiring/index.d.ts.map +1 -0
  159. package/dist/recording/wiring/index.js +9 -0
  160. package/dist/recording/wiring/index.js.map +1 -0
  161. package/dist/recording/wiring/record-builders.d.ts +107 -0
  162. package/dist/recording/wiring/record-builders.d.ts.map +1 -0
  163. package/dist/recording/wiring/record-builders.js +706 -0
  164. package/dist/recording/wiring/record-builders.js.map +1 -0
  165. package/dist/recording/wiring/subscriber.d.ts +28 -0
  166. package/dist/recording/wiring/subscriber.d.ts.map +1 -0
  167. package/dist/recording/wiring/subscriber.js +173 -0
  168. package/dist/recording/wiring/subscriber.js.map +1 -0
  169. package/dist/recording/wiring/values.d.ts +19 -0
  170. package/dist/recording/wiring/values.d.ts.map +1 -0
  171. package/dist/recording/wiring/values.js +49 -0
  172. package/dist/recording/wiring/values.js.map +1 -0
  173. package/dist/runtime/auto-update/command-runner.d.ts.map +1 -1
  174. package/dist/runtime/auto-update/command-runner.js +5 -1
  175. package/dist/runtime/auto-update/command-runner.js.map +1 -1
  176. package/dist/runtime/auto-update/resolve-package-name.d.ts +10 -0
  177. package/dist/runtime/auto-update/resolve-package-name.d.ts.map +1 -0
  178. package/dist/runtime/auto-update/resolve-package-name.js +35 -0
  179. package/dist/runtime/auto-update/resolve-package-name.js.map +1 -0
  180. package/dist/runtime/auto-update/run-update-command.d.ts +2 -0
  181. package/dist/runtime/auto-update/run-update-command.d.ts.map +1 -0
  182. package/dist/runtime/auto-update/run-update-command.js +37 -0
  183. package/dist/runtime/auto-update/run-update-command.js.map +1 -0
  184. package/dist/runtime/create-runtime-context.d.ts +2 -0
  185. package/dist/runtime/create-runtime-context.d.ts.map +1 -1
  186. package/dist/runtime/create-runtime-context.js +1 -0
  187. package/dist/runtime/create-runtime-context.js.map +1 -1
  188. package/dist/runtime/create-scanner-module.d.ts +4 -3
  189. package/dist/runtime/create-scanner-module.d.ts.map +1 -1
  190. package/dist/runtime/create-scanner-module.js +14 -5
  191. package/dist/runtime/create-scanner-module.js.map +1 -1
  192. package/dist/runtime/create-scanner-providers-for-run.d.ts.map +1 -1
  193. package/dist/runtime/create-scanner-providers-for-run.js +12 -1
  194. package/dist/runtime/create-scanner-providers-for-run.js.map +1 -1
  195. package/dist/runtime/load-runtime-config.d.ts +9 -0
  196. package/dist/runtime/load-runtime-config.d.ts.map +1 -1
  197. package/dist/runtime/load-runtime-config.js +41 -8
  198. package/dist/runtime/load-runtime-config.js.map +1 -1
  199. package/dist/runtime/map-strategies-registration.js +7 -8
  200. package/dist/runtime/map-strategies-registration.js.map +1 -1
  201. package/dist/runtime/map-strategies.d.ts.map +1 -1
  202. package/dist/runtime/map-strategies.js +12 -3
  203. package/dist/runtime/map-strategies.js.map +1 -1
  204. package/dist/runtime/recipe-version.d.ts +1 -1
  205. package/dist/runtime/recipe-version.d.ts.map +1 -1
  206. package/dist/runtime/recipe-version.js +1 -1
  207. package/dist/runtime/recipe-version.js.map +1 -1
  208. package/dist/runtime/reconcile-decide.d.ts +73 -0
  209. package/dist/runtime/reconcile-decide.d.ts.map +1 -0
  210. package/dist/runtime/reconcile-decide.js +186 -0
  211. package/dist/runtime/reconcile-decide.js.map +1 -0
  212. package/dist/runtime/reconcile-run.d.ts +62 -0
  213. package/dist/runtime/reconcile-run.d.ts.map +1 -0
  214. package/dist/runtime/reconcile-run.js +173 -0
  215. package/dist/runtime/reconcile-run.js.map +1 -0
  216. package/dist/runtime/reconcile-state.d.ts +44 -0
  217. package/dist/runtime/reconcile-state.d.ts.map +1 -1
  218. package/dist/runtime/reconcile-state.js +80 -44
  219. package/dist/runtime/reconcile-state.js.map +1 -1
  220. package/dist/runtime/risk-guard.d.ts.map +1 -1
  221. package/dist/runtime/risk-guard.js +17 -12
  222. package/dist/runtime/risk-guard.js.map +1 -1
  223. package/dist/runtime/run.d.ts.map +1 -1
  224. package/dist/runtime/run.js +3 -2
  225. package/dist/runtime/run.js.map +1 -1
  226. package/dist/runtime/runtime-schema.d.ts +4056 -793
  227. package/dist/runtime/runtime-schema.d.ts.map +1 -1
  228. package/dist/runtime/runtime-schema.js +183 -46
  229. package/dist/runtime/runtime-schema.js.map +1 -1
  230. package/dist/runtime/runtime-version.d.ts +3 -6
  231. package/dist/runtime/runtime-version.d.ts.map +1 -1
  232. package/dist/runtime/runtime-version.js +3 -6
  233. package/dist/runtime/runtime-version.js.map +1 -1
  234. package/dist/runtime/runtime.d.ts +47 -0
  235. package/dist/runtime/runtime.d.ts.map +1 -1
  236. package/dist/runtime/runtime.js +516 -146
  237. package/dist/runtime/runtime.js.map +1 -1
  238. package/dist/runtime/scanner-registry.d.ts +1 -1
  239. package/dist/runtime/scanner-registry.d.ts.map +1 -1
  240. package/dist/runtime/scanner-registry.js +3 -12
  241. package/dist/runtime/scanner-registry.js.map +1 -1
  242. package/dist/runtime/strategy-registry.d.ts +6 -0
  243. package/dist/runtime/strategy-registry.d.ts.map +1 -1
  244. package/dist/runtime/strategy-registry.js +1 -0
  245. package/dist/runtime/strategy-registry.js.map +1 -1
  246. package/dist/runtime/supervisor/long-running-supervisor.d.ts +222 -0
  247. package/dist/runtime/supervisor/long-running-supervisor.d.ts.map +1 -0
  248. package/dist/runtime/supervisor/long-running-supervisor.js +625 -0
  249. package/dist/runtime/supervisor/long-running-supervisor.js.map +1 -0
  250. package/dist/runtime/supervisor/orphan-sweep.d.ts +36 -0
  251. package/dist/runtime/supervisor/orphan-sweep.d.ts.map +1 -0
  252. package/dist/runtime/supervisor/orphan-sweep.js +255 -0
  253. package/dist/runtime/supervisor/orphan-sweep.js.map +1 -0
  254. package/dist/runtime/supervisor/supervisor-utils.d.ts +37 -0
  255. package/dist/runtime/supervisor/supervisor-utils.d.ts.map +1 -0
  256. package/dist/runtime/supervisor/supervisor-utils.js +175 -0
  257. package/dist/runtime/supervisor/supervisor-utils.js.map +1 -0
  258. package/dist/runtime-api/handlers/ingest-signals.d.ts +3 -3
  259. package/dist/runtime-api/handlers/ingest-signals.js +3 -3
  260. package/dist/runtime-api/intake/acceptance-record.d.ts +103 -0
  261. package/dist/runtime-api/intake/acceptance-record.d.ts.map +1 -0
  262. package/dist/runtime-api/intake/acceptance-record.js +192 -0
  263. package/dist/runtime-api/intake/acceptance-record.js.map +1 -0
  264. package/dist/runtime-api/intake/intake-context.d.ts +31 -0
  265. package/dist/runtime-api/intake/intake-context.d.ts.map +1 -0
  266. package/dist/runtime-api/intake/intake-context.js +21 -0
  267. package/dist/runtime-api/intake/intake-context.js.map +1 -0
  268. package/dist/runtime-api/intake/intake-mount.d.ts +118 -0
  269. package/dist/runtime-api/intake/intake-mount.d.ts.map +1 -0
  270. package/dist/runtime-api/intake/intake-mount.js +202 -0
  271. package/dist/runtime-api/intake/intake-mount.js.map +1 -0
  272. package/dist/runtime-api/intake/liveness-store.d.ts +32 -0
  273. package/dist/runtime-api/intake/liveness-store.d.ts.map +1 -0
  274. package/dist/runtime-api/intake/liveness-store.js +31 -0
  275. package/dist/runtime-api/intake/liveness-store.js.map +1 -0
  276. package/dist/runtime-api/intake/process-error-post.d.ts +15 -0
  277. package/dist/runtime-api/intake/process-error-post.d.ts.map +1 -0
  278. package/dist/runtime-api/intake/process-error-post.js +19 -0
  279. package/dist/runtime-api/intake/process-error-post.js.map +1 -0
  280. package/dist/runtime-api/intake/process-signal-post.d.ts +73 -0
  281. package/dist/runtime-api/intake/process-signal-post.d.ts.map +1 -0
  282. package/dist/runtime-api/intake/process-signal-post.js +188 -0
  283. package/dist/runtime-api/intake/process-signal-post.js.map +1 -0
  284. package/dist/runtime-api/intake/scanner-launcher.d.ts +133 -0
  285. package/dist/runtime-api/intake/scanner-launcher.d.ts.map +1 -0
  286. package/dist/runtime-api/intake/scanner-launcher.js +204 -0
  287. package/dist/runtime-api/intake/scanner-launcher.js.map +1 -0
  288. package/dist/runtime-api/intake/scanner-registry.d.ts +36 -0
  289. package/dist/runtime-api/intake/scanner-registry.d.ts.map +1 -0
  290. package/dist/runtime-api/intake/scanner-registry.js +29 -0
  291. package/dist/runtime-api/intake/scanner-registry.js.map +1 -0
  292. package/dist/runtime-api/intake/types.d.ts +60 -0
  293. package/dist/runtime-api/intake/types.d.ts.map +1 -0
  294. package/dist/runtime-api/intake/types.js +8 -0
  295. package/dist/runtime-api/intake/types.js.map +1 -0
  296. package/dist/runtime-api/routes/signals.d.ts +20 -40
  297. package/dist/runtime-api/routes/signals.d.ts.map +1 -1
  298. package/dist/runtime-api/routes/signals.js +120 -75
  299. package/dist/runtime-api/routes/signals.js.map +1 -1
  300. package/dist/runtime-api/routes/signals.schema.d.ts +23 -86
  301. package/dist/runtime-api/routes/signals.schema.d.ts.map +1 -1
  302. package/dist/runtime-api/routes/signals.schema.js +37 -50
  303. package/dist/runtime-api/routes/signals.schema.js.map +1 -1
  304. package/dist/runtime-api/server.d.ts +15 -6
  305. package/dist/runtime-api/server.d.ts.map +1 -1
  306. package/dist/runtime-api/server.js +12 -12
  307. package/dist/runtime-api/server.js.map +1 -1
  308. package/dist/scanners/events.d.ts +6 -0
  309. package/dist/scanners/events.d.ts.map +1 -1
  310. package/dist/scanners/events.js.map +1 -1
  311. package/dist/scanners/external/scaffold/__init__.py +16 -0
  312. package/dist/scanners/external/scaffold/__main__.py +155 -0
  313. package/dist/scanners/external/scaffold/ctx.py +78 -0
  314. package/dist/scanners/external/scaffold/delivery.py +282 -0
  315. package/dist/scanners/external/scaffold/entrypoint_loader.py +151 -0
  316. package/dist/scanners/external/scaffold/http_post.py +70 -0
  317. package/dist/scanners/external/scaffold/journal.py +247 -0
  318. package/dist/scanners/external/scaffold/loop_primitives.py +65 -0
  319. package/dist/scanners/external/scaffold/requirements.txt +11 -0
  320. package/dist/scanners/external/scaffold/scaffold.py +361 -0
  321. package/dist/scanners/external/scaffold/scaffold_state.py +114 -0
  322. package/dist/scanners/external/scaffold/senpi_mcp.py +250 -0
  323. package/dist/scanners/external/scaffold/signal_envelope.py +258 -0
  324. package/dist/scanners/external/scaffold/state_manager.py +175 -0
  325. package/dist/scanners/external-scanner-receiver.d.ts +23 -1
  326. package/dist/scanners/external-scanner-receiver.d.ts.map +1 -1
  327. package/dist/scanners/external-scanner-receiver.js +24 -3
  328. package/dist/scanners/external-scanner-receiver.js.map +1 -1
  329. package/dist/scanners/implementations/external-scanner.d.ts.map +1 -1
  330. package/dist/scanners/implementations/external-scanner.js +7 -1
  331. package/dist/scanners/implementations/external-scanner.js.map +1 -1
  332. package/dist/scanners/implementations/momentum.d.ts.map +1 -1
  333. package/dist/scanners/implementations/momentum.js +16 -0
  334. package/dist/scanners/implementations/momentum.js.map +1 -1
  335. package/dist/scanners/providers/factory.d.ts.map +1 -1
  336. package/dist/scanners/providers/factory.js +17 -19
  337. package/dist/scanners/providers/factory.js.map +1 -1
  338. package/dist/scanners/runtime-module.d.ts.map +1 -1
  339. package/dist/scanners/runtime-module.js +9 -1
  340. package/dist/scanners/runtime-module.js.map +1 -1
  341. package/dist/scripts/run-dsl-standalone-live.d.ts +1 -1
  342. package/dist/scripts/run-dsl-standalone-live.js +5 -3
  343. package/dist/scripts/run-dsl-standalone-live.js.map +1 -1
  344. package/dist/senpi/client.d.ts +56 -4
  345. package/dist/senpi/client.d.ts.map +1 -1
  346. package/dist/senpi/client.js +123 -24
  347. package/dist/senpi/client.js.map +1 -1
  348. package/dist/senpi/index.d.ts +2 -1
  349. package/dist/senpi/index.d.ts.map +1 -1
  350. package/dist/senpi/index.js +1 -1
  351. package/dist/senpi/index.js.map +1 -1
  352. package/dist/senpi/types.d.ts +1 -2
  353. package/dist/senpi/types.d.ts.map +1 -1
  354. package/dist/state/state-manager.d.ts +17 -0
  355. package/dist/state/state-manager.d.ts.map +1 -1
  356. package/dist/state/state-manager.js +55 -4
  357. package/dist/state/state-manager.js.map +1 -1
  358. package/dist/strategy/strategy-state.d.ts +9 -1
  359. package/dist/strategy/strategy-state.d.ts.map +1 -1
  360. package/dist/strategy/strategy-state.js +78 -28
  361. package/dist/strategy/strategy-state.js.map +1 -1
  362. package/dist/tracking/build-rehydrate-items.d.ts +15 -0
  363. package/dist/tracking/build-rehydrate-items.d.ts.map +1 -0
  364. package/dist/tracking/build-rehydrate-items.js +19 -0
  365. package/dist/tracking/build-rehydrate-items.js.map +1 -0
  366. package/dist/tracking/constants.d.ts.map +1 -1
  367. package/dist/tracking/constants.js +2 -0
  368. package/dist/tracking/constants.js.map +1 -1
  369. package/dist/tracking/index.d.ts +3 -0
  370. package/dist/tracking/index.d.ts.map +1 -1
  371. package/dist/tracking/index.js +2 -0
  372. package/dist/tracking/index.js.map +1 -1
  373. package/dist/tracking/position-id-registry.d.ts +69 -0
  374. package/dist/tracking/position-id-registry.d.ts.map +1 -0
  375. package/dist/tracking/position-id-registry.js +139 -0
  376. package/dist/tracking/position-id-registry.js.map +1 -0
  377. package/dist/tracking/spans/fan-out-span-transport.d.ts +22 -0
  378. package/dist/tracking/spans/fan-out-span-transport.d.ts.map +1 -0
  379. package/dist/tracking/spans/fan-out-span-transport.js +49 -0
  380. package/dist/tracking/spans/fan-out-span-transport.js.map +1 -0
  381. package/dist/tracking/spans/otel/fit-row-budget.d.ts +22 -0
  382. package/dist/tracking/spans/otel/fit-row-budget.d.ts.map +1 -0
  383. package/dist/tracking/spans/otel/fit-row-budget.js +91 -0
  384. package/dist/tracking/spans/otel/fit-row-budget.js.map +1 -0
  385. package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts +16 -0
  386. package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts.map +1 -0
  387. package/dist/tracking/spans/otel/map-span-to-trace-row.js +227 -0
  388. package/dist/tracking/spans/otel/map-span-to-trace-row.js.map +1 -0
  389. package/dist/tracking/spans/otel/recording-span-transport.d.ts +43 -0
  390. package/dist/tracking/spans/otel/recording-span-transport.d.ts.map +1 -0
  391. package/dist/tracking/spans/otel/recording-span-transport.js +67 -0
  392. package/dist/tracking/spans/otel/recording-span-transport.js.map +1 -0
  393. package/dist/tracking/spans/otel/span-ids.d.ts +22 -0
  394. package/dist/tracking/spans/otel/span-ids.d.ts.map +1 -0
  395. package/dist/tracking/spans/otel/span-ids.js +32 -0
  396. package/dist/tracking/spans/otel/span-ids.js.map +1 -0
  397. package/dist/tracking/spans/plugin-span-tracker.d.ts +6 -0
  398. package/dist/tracking/spans/plugin-span-tracker.d.ts.map +1 -1
  399. package/dist/tracking/spans/plugin-span-tracker.js +82 -9
  400. package/dist/tracking/spans/plugin-span-tracker.js.map +1 -1
  401. package/dist/tracking/spans/redact-pii.d.ts +3 -1
  402. package/dist/tracking/spans/redact-pii.d.ts.map +1 -1
  403. package/dist/tracking/spans/redact-pii.js +5 -1
  404. package/dist/tracking/spans/redact-pii.js.map +1 -1
  405. package/dist/tracking/spans/span-transport.d.ts +6 -0
  406. package/dist/tracking/spans/span-transport.d.ts.map +1 -1
  407. package/dist/tracking/spans/span-transport.js +1 -1
  408. package/dist/tracking/spans/span-transport.js.map +1 -1
  409. package/dist/types/dsl/index.d.ts +24 -1
  410. package/dist/types/dsl/index.d.ts.map +1 -1
  411. package/dist/types/runtime.d.ts +6 -0
  412. package/dist/types/runtime.d.ts.map +1 -1
  413. package/dist/types/scanner.d.ts +16 -0
  414. package/dist/types/scanner.d.ts.map +1 -1
  415. package/dist/types/strategy.d.ts +3 -1
  416. package/dist/types/strategy.d.ts.map +1 -1
  417. package/dist/utils/clearing-house-aggregate.d.ts +32 -0
  418. package/dist/utils/clearing-house-aggregate.d.ts.map +1 -0
  419. package/dist/utils/clearing-house-aggregate.js +41 -0
  420. package/dist/utils/clearing-house-aggregate.js.map +1 -0
  421. package/dist/utils/keyed-mutex.d.ts +37 -0
  422. package/dist/utils/keyed-mutex.d.ts.map +1 -0
  423. package/dist/utils/keyed-mutex.js +77 -0
  424. package/dist/utils/keyed-mutex.js.map +1 -0
  425. package/dist/utils/safe-spawn.d.ts +6 -0
  426. package/dist/utils/safe-spawn.d.ts.map +1 -0
  427. package/dist/utils/safe-spawn.js +62 -0
  428. package/dist/utils/safe-spawn.js.map +1 -0
  429. package/examples/strategies/README.md +17 -12
  430. package/examples/strategies/iguana/README.md +135 -0
  431. package/examples/strategies/iguana/recipe.yaml +137 -0
  432. package/examples/strategies/iguana/scanners/scan.py +242 -0
  433. package/examples/strategies/iguana/scanners/scoring.py +152 -0
  434. package/examples/strategies/raptor/README.md +156 -0
  435. package/examples/strategies/raptor/recipe.yaml +154 -0
  436. package/examples/strategies/raptor/scanners/scan.py +348 -0
  437. package/examples/strategies/raptor/scanners/scoring.py +452 -0
  438. package/examples/strategies/spider/README.md +89 -0
  439. package/examples/strategies/spider/scalp/recipe.yaml +129 -0
  440. package/examples/strategies/spider/scalp/scanners/scan.py +219 -0
  441. package/examples/strategies/spider/scalp/scanners/scoring.py +179 -0
  442. package/examples/strategies/spider/swing/recipe.yaml +137 -0
  443. package/examples/strategies/spider/swing/scanners/scan.py +334 -0
  444. package/examples/strategies/spider/swing/scanners/scoring.py +184 -0
  445. package/examples/strategies/turbine/README.md +169 -0
  446. package/examples/strategies/turbine/recipe-runners.yaml +123 -0
  447. package/examples/strategies/turbine/recipe-volume.yaml +129 -0
  448. package/examples/strategies/turbine/scanners/scan.py +287 -0
  449. package/examples/strategies/turbine/scanners/scoring.py +190 -0
  450. package/openclaw.plugin.json +12 -1
  451. package/package.json +3 -3
  452. package/dist/runtime-api/handlers/group-by-scanner.d.ts +0 -43
  453. package/dist/runtime-api/handlers/group-by-scanner.d.ts.map +0 -1
  454. package/dist/runtime-api/handlers/group-by-scanner.js +0 -43
  455. package/dist/runtime-api/handlers/group-by-scanner.js.map +0 -1
  456. package/dist/scanners/external/liquidation-watchdog/README.md +0 -107
  457. package/dist/scanners/external/liquidation-watchdog/liquidation-watchdog.yaml +0 -48
  458. package/dist/scanners/external/liquidation-watchdog/producer.mjs +0 -336
  459. package/dist/scanners/external/momentum/README.md +0 -148
  460. package/dist/scanners/external/momentum/momentum.yaml +0 -116
  461. package/dist/scanners/external/momentum/producer.mjs +0 -251
  462. package/dist/scanners/external/shared/ingest.mjs +0 -112
  463. package/examples/README.md +0 -89
  464. package/examples/scanners-consumer-quickstart.mjs +0 -134
  465. package/examples/scanners-emerging-movers-v4.mjs +0 -287
  466. package/examples/scanners-liquidation-watchdog.mjs +0 -341
  467. package/examples/scanners-live-mcp.mjs +0 -208
  468. package/examples/scanners-multi-strategy.mjs +0 -165
  469. package/examples/scanners-position-tracker-e2e.mjs +0 -225
  470. package/examples/scanners-scheduled-events.mjs +0 -96
  471. package/examples/scanners-senpi-provider-client.mjs +0 -182
  472. package/examples/scanners-single-strategy.mjs +0 -198
  473. package/examples/strategies/dsl-showcase.yaml +0 -68
  474. package/examples/strategies/dsl.yaml +0 -51
  475. package/examples/strategies/fox-minimal-loosened.yaml +0 -240
  476. package/examples/strategies/fox-minimal.yaml +0 -242
  477. package/examples/strategies/minimal.yaml +0 -46
  478. package/examples/strategies/momentum/how-it-works.md +0 -48
  479. package/examples/strategies/momentum/momentum-guarded.yaml +0 -161
  480. package/examples/strategies/risk-showcase.yaml +0 -93
  481. package/examples/strategies/viper.yaml +0 -67
  482. package/examples/strategies/wolf.yaml +0 -72
  483. package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +0 -123
@@ -0,0 +1,151 @@
1
+ """Entrypoint loading and scan() compatibility verification.
2
+
3
+ Pure, unit-testable helpers — no side effects beyond sys.path mutation and imports.
4
+
5
+ Exported error types:
6
+ ScanEntrypointError — import failure, missing/non-callable scan.
7
+ ScanSignatureError — scan call-shape incompatible with the scaffold contract.
8
+
9
+ Both are importable from here AND from the package root (scaffold).
10
+ """
11
+
12
+ import importlib
13
+ import inspect
14
+ import sys
15
+ from typing import Any, Callable
16
+
17
+
18
+ class ScanEntrypointError(Exception):
19
+ """Import failure, or scan is missing / not callable."""
20
+
21
+
22
+ class ScanSignatureError(Exception):
23
+ """scan's call shape is incompatible with scan(inputs, ctx)."""
24
+
25
+
26
+ def add_path_to_sys_path(path: str) -> None:
27
+ """Insert `path` at sys.path[0]. Idempotent — never inserts a duplicate."""
28
+ if path not in sys.path:
29
+ sys.path.insert(0, path)
30
+
31
+
32
+ def import_entrypoint(path: str, entrypoint: str):
33
+ """Put `path` on sys.path, then import `entrypoint` by module name.
34
+
35
+ The recipe expresses `entrypoint` as a FILENAME (e.g. `scan.py`, the shape the
36
+ B1 launcher writes verbatim into the launch config and the §4a entrypoint FS
37
+ check validates). importlib needs a MODULE name, so a trailing `.py` is
38
+ stripped here — the only place the filename<->module-name bridge lives.
39
+
40
+ Raises ScanEntrypointError on any import/syntax/missing-sibling failure,
41
+ chaining the underlying exception.
42
+ """
43
+ add_path_to_sys_path(path)
44
+ module_name = entrypoint[:-3] if entrypoint.endswith(".py") else entrypoint
45
+ try:
46
+ # Force re-import when the module has been previously imported so that
47
+ # tests can write fresh modules to tmp_path without cache collisions.
48
+ if module_name in sys.modules:
49
+ del sys.modules[module_name]
50
+ return importlib.import_module(module_name)
51
+ except Exception as exc:
52
+ raise ScanEntrypointError(
53
+ f"Failed to import entrypoint '{entrypoint}' from '{path}': {exc}"
54
+ ) from exc
55
+
56
+
57
+ def locate_scan(module) -> Callable:
58
+ """Return the module's `scan` callable.
59
+
60
+ Raises ScanEntrypointError if scan is missing, None, or not callable.
61
+ """
62
+ scan = getattr(module, "scan", _MISSING)
63
+ if scan is _MISSING:
64
+ raise ScanEntrypointError(
65
+ f"Module '{getattr(module, '__name__', module)}' has no 'scan' attribute."
66
+ )
67
+ if scan is None or not callable(scan):
68
+ raise ScanEntrypointError(
69
+ f"'scan' in module '{getattr(module, '__name__', module)}' is not callable "
70
+ f"(got {type(scan).__name__!r})."
71
+ )
72
+ return scan
73
+
74
+
75
+ def verify_scan_signature(scan: Callable) -> None:
76
+ """Verify scan's call shape is compatible with the v2 contract scan(inputs, ctx).
77
+
78
+ v2 calls scan with EXACTLY two positionals (inputs, ctx). A signature must be
79
+ callable that way.
80
+
81
+ Accepted shapes:
82
+ scan(inputs, ctx) — 2 required (the canonical shape)
83
+ scan(inputs, ctx, extra=None) — 2 required + defaulted extra
84
+ scan(inputs, ctx, *args) — variadic absorbs nothing extra here
85
+ scan(*args, **kwargs) — fully variadic, accepts anything
86
+
87
+ Rejected shapes:
88
+ scan() — 0 required
89
+ scan(inputs) — 1 required
90
+ scan(params, state, client) — 3 required (the OLD v1 client shape)
91
+ scan(a, b, c, d) — >=4 required
92
+
93
+ The contract is now EXACTLY two positionals: a 3rd REQUIRED positional cannot
94
+ be satisfied by scan(inputs, ctx) and is rejected.
95
+
96
+ Raises ScanSignatureError naming the found arity on mismatch.
97
+ """
98
+ try:
99
+ sig = inspect.signature(scan)
100
+ except (ValueError, TypeError):
101
+ # Builtins or C extensions without introspectable signatures: accept.
102
+ return
103
+
104
+ params = list(sig.parameters.values())
105
+
106
+ has_var_positional = any(
107
+ p.kind == inspect.Parameter.VAR_POSITIONAL for p in params
108
+ )
109
+
110
+ # Required (non-defaulted) fixed positional params.
111
+ required_fixed = [
112
+ p for p in params
113
+ if p.kind in (
114
+ inspect.Parameter.POSITIONAL_ONLY,
115
+ inspect.Parameter.POSITIONAL_OR_KEYWORD,
116
+ )
117
+ and p.default is inspect.Parameter.empty
118
+ ]
119
+ n_required = len(required_fixed)
120
+
121
+ # A *args (or *args/**kwargs) signature accepts the 2-positional call as long
122
+ # as it has no MORE than 2 required fixed positionals ahead of *args.
123
+ if has_var_positional:
124
+ if n_required > 2:
125
+ raise ScanSignatureError(
126
+ f"scan requires {n_required} fixed positional params; the v2 "
127
+ f"contract calls scan(inputs, ctx) — exactly 2. Found arity: {n_required}."
128
+ )
129
+ return
130
+
131
+ if n_required < 2:
132
+ raise ScanSignatureError(
133
+ f"scan has {n_required} required positional param(s); the v2 contract "
134
+ f"requires exactly 2 (inputs, ctx). Found arity: {n_required}."
135
+ )
136
+
137
+ if n_required > 2:
138
+ raise ScanSignatureError(
139
+ f"scan has {n_required} required positional params; the v2 contract "
140
+ f"calls scan(inputs, ctx) — exactly 2. A 3rd required positional "
141
+ f"(the old v1 client shape) is no longer accepted. Found arity: {n_required}."
142
+ )
143
+
144
+
145
+ # Private sentinel — distinct from None so getattr(..., None) doesn't hide a
146
+ # real `scan = None` attribute.
147
+ class _MissingSentinel:
148
+ pass
149
+
150
+
151
+ _MISSING = _MissingSentinel()
@@ -0,0 +1,70 @@
1
+ """Minimal stdlib HTTP POST helper.
2
+
3
+ post_json(url, body, timeout) -> (status_code, parsed_or_None)
4
+
5
+ POSTs `body` (a dict) as JSON to `url`. Fresh connection per call (no pooling).
6
+ Returns (status_code, parsed_json) on a parseable response.
7
+ Returns (status_code, None) when the response body is not valid JSON.
8
+ Raises TransportError on connection failure, timeout, or transport-level error.
9
+
10
+ Constants:
11
+ SIGNALS_PATH = "/signals"
12
+ ERRORS_PATH = "/errors"
13
+
14
+ No third-party dependencies.
15
+
16
+ Note: the intake route is mounted at /signals. SIGNALS_PATH is already correct.
17
+ """
18
+
19
+ from __future__ import annotations
20
+
21
+ import json
22
+ import urllib.error
23
+ import urllib.request
24
+ from typing import Any
25
+
26
+
27
+ SIGNALS_PATH = "/signals"
28
+ ERRORS_PATH = "/errors"
29
+
30
+
31
+ class TransportError(Exception):
32
+ """Raised on connection failure, timeout, or non-JSON transport body."""
33
+
34
+
35
+ def post_json(url: str, body: dict, timeout: float) -> tuple[int, Any]:
36
+ """POST body as JSON to url.
37
+
38
+ Returns (status_code, parsed_json_or_None).
39
+ Raises TransportError on connection/timeout failures.
40
+ """
41
+ data = json.dumps(body).encode("utf-8")
42
+ req = urllib.request.Request(
43
+ url,
44
+ data=data,
45
+ headers={
46
+ "Content-Type": "application/json",
47
+ "Content-Length": str(len(data)),
48
+ },
49
+ method="POST",
50
+ )
51
+ try:
52
+ with urllib.request.urlopen(req, timeout=timeout) as resp:
53
+ status = resp.status
54
+ raw = resp.read()
55
+ except urllib.error.HTTPError as exc:
56
+ # HTTPError has a status and a response body
57
+ status = exc.code
58
+ try:
59
+ raw = exc.read()
60
+ except Exception:
61
+ raw = b""
62
+ except (urllib.error.URLError, OSError, TimeoutError) as exc:
63
+ raise TransportError(str(exc)) from exc
64
+
65
+ try:
66
+ parsed = json.loads(raw.decode("utf-8")) if raw else None
67
+ except (json.JSONDecodeError, UnicodeDecodeError):
68
+ parsed = None
69
+
70
+ return (status, parsed)
@@ -0,0 +1,247 @@
1
+ """On-disk delivery journal: append-only JSON-lines.
2
+
3
+ Journal(path: str | None)
4
+ path=None -> in-memory only; no file written. Never raises on corrupt file.
5
+
6
+ journal.record_produced(signal, *, now_ms) -> str
7
+ Appends a 'produced' line BEFORE the POST. Returns entry id (uuid4 hex).
8
+ If the asset already has a pending (undelivered) entry, drops the older
9
+ one with a 'dropped_superseded' outcome line and replaces it.
10
+
11
+ journal.record_outcome(entry_id, outcome, **fields) -> None
12
+ Appends a terminal 'outcome' line. Marks the id settled.
13
+
14
+ journal.pending() -> list
15
+ In-memory queue: newest undelivered per asset. Each entry exposes
16
+ .id, .asset, .signal, .valid_until (attribute access).
17
+
18
+ journal.replay(now_ms) -> None
19
+ Re-read the file, rebuild the settled set, re-queue valid+unsettled+newest
20
+ per-asset entries. Writes drop lines for stale/superseded. Skips corrupt
21
+ lines (logs journal_corrupt_line). Never raises.
22
+
23
+ journal.is_settled(entry_id) -> bool
24
+ """
25
+
26
+ from __future__ import annotations
27
+
28
+ import json
29
+ import os
30
+ import sys
31
+ import uuid
32
+ from dataclasses import dataclass
33
+ from typing import Any
34
+
35
+
36
+ def _log(event: str, **fields: Any) -> None:
37
+ import time
38
+ record = {"event": event, "ts": time.time(), **fields}
39
+ print(f"[scaffold] {json.dumps(record)}", file=sys.stderr, flush=True)
40
+
41
+
42
+ @dataclass
43
+ class _Entry:
44
+ id: str
45
+ asset: str
46
+ signal: dict
47
+ valid_until: int
48
+
49
+
50
+ class Journal:
51
+ """Append-only JSONL delivery journal, in-memory or on-disk."""
52
+
53
+ def __init__(self, path: str | None) -> None:
54
+ self._path = path
55
+ self._settled: set[str] = set()
56
+ # asset -> _Entry (newest undelivered per asset)
57
+ self._queue: dict[str, _Entry] = {}
58
+
59
+ # ------------------------------------------------------------------
60
+ # Write helpers
61
+ # ------------------------------------------------------------------
62
+
63
+ def _append(self, record: dict) -> None:
64
+ if self._path is None:
65
+ return
66
+ line = json.dumps(record) + "\n"
67
+ try:
68
+ with open(self._path, "a", encoding="utf-8") as fh:
69
+ fh.write(line)
70
+ except OSError as exc:
71
+ # Append failed (disk full, read-only fs, permissions, I/O error).
72
+ # We do NOT let this tear down the delivery sink: the safe direction
73
+ # is a dropped/lost signal (fail toward NOT trading), not a crash of
74
+ # the sink that would take down delivery for every other candidate.
75
+ # Log explicitly so the at-risk candidate is observable.
76
+ # TODO(observability): journal_append_failed must be captured by the
77
+ # observability stack and alerted on — a persistent append failure
78
+ # means signals are being silently dropped on this scanner.
79
+ _log(
80
+ "journal_append_failed",
81
+ path=self._path,
82
+ error=str(exc),
83
+ kind=record.get("kind"),
84
+ entry_id=record.get("id"),
85
+ asset=record.get("asset"),
86
+ )
87
+
88
+ # ------------------------------------------------------------------
89
+ # Public API
90
+ # ------------------------------------------------------------------
91
+
92
+ def record_produced(self, signal: dict, *, now_ms: int) -> str:
93
+ """Write a 'produced' line and enqueue the signal. Returns entry id.
94
+
95
+ The entry id IS the wire `signal_id`: the journal stamps `signal_id` onto
96
+ the persisted/queued signal so the POSTed signal carries the dedup key, and
97
+ a replay re-uses the SAME id (no fresh id minted on restart). If the signal
98
+ already carries a `signal_id` (the delivery sink threaded the eid in via the
99
+ envelope), that id is re-used as the entry id; otherwise one is minted.
100
+ """
101
+ existing = signal.get("signal_id")
102
+ entry_id = existing if isinstance(existing, str) and existing else uuid.uuid4().hex
103
+ # Stamp the id onto the wire signal so the persisted produced line and the
104
+ # POSTed body both carry signal_id == entry id.
105
+ signal["signal_id"] = entry_id
106
+ asset = signal.get("asset", "")
107
+ valid_until = signal.get("valid_until", 0)
108
+
109
+ # If there's already a pending entry for this asset, drop the old one.
110
+ if asset in self._queue:
111
+ old = self._queue[asset]
112
+ self._append({
113
+ "kind": "outcome",
114
+ "id": old.id,
115
+ "outcome": "dropped_superseded",
116
+ })
117
+ self._settled.add(old.id)
118
+
119
+ record = {
120
+ "kind": "produced",
121
+ "id": entry_id,
122
+ "asset": asset,
123
+ "produced_at": signal.get("produced_at", now_ms),
124
+ "valid_until": valid_until,
125
+ "signal": signal,
126
+ }
127
+ self._append(record)
128
+
129
+ entry = _Entry(id=entry_id, asset=asset, signal=signal, valid_until=valid_until)
130
+ self._queue[asset] = entry
131
+ return entry_id
132
+
133
+ def record_outcome(self, entry_id: str, outcome: str, **fields) -> None:
134
+ """Write a terminal outcome line and mark the id settled."""
135
+ record = {"kind": "outcome", "id": entry_id, "outcome": outcome, **fields}
136
+ self._append(record)
137
+ self._settled.add(entry_id)
138
+ # Remove from in-memory queue
139
+ to_remove = [a for a, e in self._queue.items() if e.id == entry_id]
140
+ for a in to_remove:
141
+ del self._queue[a]
142
+
143
+ def pending(self) -> list:
144
+ """Return list of pending _Entry objects (newest undelivered per asset)."""
145
+ return list(self._queue.values())
146
+
147
+ def is_settled(self, entry_id: str) -> bool:
148
+ return entry_id in self._settled
149
+
150
+ def replay(self, now_ms: int) -> None:
151
+ """Re-read the journal file and rebuild the in-memory state.
152
+
153
+ Re-queues entries that are:
154
+ - not settled
155
+ - still valid (now_ms < valid_until; boundary == is expired)
156
+ - newest per asset (by produced_at)
157
+
158
+ Writes drop lines for stale/superseded unsettled entries.
159
+ Skips corrupt lines (logs journal_corrupt_line). Never raises.
160
+ """
161
+ # Reset in-memory state before replay
162
+ self._settled = set()
163
+ self._queue = {}
164
+
165
+ if self._path is None or not os.path.exists(self._path):
166
+ return
167
+
168
+ produced: dict[str, dict] = {} # id -> produced record
169
+ settled: set[str] = set()
170
+
171
+ # --- Pass 1: parse all lines ---
172
+ try:
173
+ with open(self._path, "r", encoding="utf-8", errors="replace") as fh:
174
+ lines = fh.readlines()
175
+ except OSError:
176
+ return
177
+
178
+ for line in lines:
179
+ line = line.strip()
180
+ if not line:
181
+ continue
182
+ try:
183
+ obj = json.loads(line)
184
+ except (json.JSONDecodeError, ValueError, UnicodeDecodeError):
185
+ _log("journal_corrupt_line", path=self._path)
186
+ continue
187
+
188
+ if not isinstance(obj, dict):
189
+ _log("journal_corrupt_line", path=self._path)
190
+ continue
191
+
192
+ kind = obj.get("kind")
193
+ if kind == "produced":
194
+ eid = obj.get("id")
195
+ if eid:
196
+ produced[eid] = obj
197
+ elif kind == "outcome":
198
+ eid = obj.get("id")
199
+ if eid:
200
+ settled.add(eid)
201
+
202
+ self._settled = settled
203
+
204
+ # --- Pass 2: find newest per asset among unsettled produced ---
205
+ # unsettled produced: id -> record
206
+ unsettled = {eid: rec for eid, rec in produced.items() if eid not in settled}
207
+
208
+ # Build newest-per-asset map: asset -> (produced_at, id, record)
209
+ newest: dict[str, tuple] = {} # asset -> (produced_at, id, record)
210
+ for eid, rec in unsettled.items():
211
+ asset = rec.get("asset", "")
212
+ pat = rec.get("produced_at", 0)
213
+ # Guard: non-numeric produced_at cannot be compared (would TypeError).
214
+ # Treat it as 0 so numeric entries always win the newest comparison;
215
+ # the entry will still be candidate-winner only if it is the sole one
216
+ # for its asset — and it will then be dropped at the valid_until check.
217
+ if not isinstance(pat, (int, float)) or isinstance(pat, bool):
218
+ pat = 0
219
+ if asset not in newest or pat > newest[asset][0]:
220
+ newest[asset] = (pat, eid, rec)
221
+
222
+ # For each asset, the winner is re-queued if still valid; losers get dropped.
223
+ winners = {info[1] for info in newest.values()}
224
+
225
+ # Entries that are unsettled but NOT the newest for their asset -> dropped_superseded
226
+ for eid, rec in unsettled.items():
227
+ if eid not in winners:
228
+ self._append({"kind": "outcome", "id": eid, "outcome": "dropped_superseded"})
229
+ self._settled.add(eid)
230
+
231
+ # Re-queue winners: valid -> queue, expired or non-numeric -> dropped_expired
232
+ for asset, (pat, eid, rec) in newest.items():
233
+ valid_until = rec.get("valid_until", 0)
234
+ if not isinstance(valid_until, (int, float)) or isinstance(valid_until, bool):
235
+ # Non-numeric valid_until from a corrupt/poisoned persisted line.
236
+ # Drop it — do not attempt comparison (would TypeError).
237
+ _log("journal_corrupt_line", path=self._path, reason="valid_until_not_numeric", entry_id=eid)
238
+ self._append({"kind": "outcome", "id": eid, "outcome": "dropped_expired"})
239
+ self._settled.add(eid)
240
+ continue
241
+ if now_ms < valid_until:
242
+ signal = rec.get("signal", {})
243
+ entry = _Entry(id=eid, asset=asset, signal=signal, valid_until=valid_until)
244
+ self._queue[asset] = entry
245
+ else:
246
+ self._append({"kind": "outcome", "id": eid, "outcome": "dropped_expired"})
247
+ self._settled.add(eid)
@@ -0,0 +1,65 @@
1
+ """Loop primitives: SIGALRM time-box, shutdown handlers, interruptible sleep,
2
+ and a tiny log_event.
3
+
4
+ Self-contained — no dependency on the old vendored senpi_runtime_helpers package.
5
+ """
6
+
7
+ import json
8
+ import signal
9
+ import sys
10
+ import threading
11
+ import time
12
+ from contextlib import suppress
13
+
14
+
15
+ class _TickTimeout(BaseException):
16
+ """Raised internally when a single tick exceeds its wall-clock budget."""
17
+
18
+
19
+ def log_event(event: str, **fields) -> None:
20
+ """Write a JSON lifecycle event to stderr with a [scaffold] prefix."""
21
+ record = {"event": event, "ts": time.time(), **fields}
22
+ print(f"[scaffold] {json.dumps(record)}", file=sys.stderr, flush=True)
23
+
24
+
25
+ def _install_shutdown_handlers(stop_event: threading.Event) -> None:
26
+ """Install SIGTERM and SIGINT handlers that set stop_event gracefully."""
27
+ def handler(signum: int, _frame: object) -> None:
28
+ if not stop_event.is_set():
29
+ log_event("scaffold_signal", signum=signum, action="graceful_shutdown_requested")
30
+ stop_event.set()
31
+
32
+ with suppress(ValueError): # only installable on the main thread
33
+ signal.signal(signal.SIGTERM, handler)
34
+ signal.signal(signal.SIGINT, handler)
35
+
36
+
37
+ def _arm_tick_alarm(seconds: float) -> bool:
38
+ """Arm SIGALRM to enforce per-tick wall-clock budget. Returns True if armed."""
39
+ if not hasattr(signal, "SIGALRM"):
40
+ return False
41
+
42
+ def alarm_handler(_signum: int, _frame: object) -> None:
43
+ raise _TickTimeout(f"tick exceeded {seconds:g}s")
44
+
45
+ try:
46
+ signal.signal(signal.SIGALRM, alarm_handler)
47
+ signal.setitimer(signal.ITIMER_REAL, seconds)
48
+ return True
49
+ except (ValueError, OSError):
50
+ return False
51
+
52
+
53
+ def _disarm_tick_alarm() -> None:
54
+ """Disarm any pending SIGALRM timer."""
55
+ if hasattr(signal, "SIGALRM"):
56
+ with suppress(ValueError, OSError):
57
+ signal.setitimer(signal.ITIMER_REAL, 0)
58
+
59
+
60
+ def _interruptible_sleep(seconds: float, stop_event: threading.Event) -> bool:
61
+ """Sleep up to `seconds`, returning early if stop_event fires.
62
+
63
+ Returns True if the full sleep elapsed, False if woken early.
64
+ """
65
+ return not stop_event.wait(seconds)
@@ -0,0 +1,11 @@
1
+ # Runtime dependencies for the scaffold harness (src/scanners/external/scaffold/).
2
+ #
3
+ # The scaffold is shipped to the scanner box and run via `python3 -m scaffold`.
4
+ # `mcp` (the official Model Context Protocol Python SDK) backs ctx.senpi_mcp:
5
+ # `streamablehttp_client` + a single persistent `ClientSession` (see senpi_mcp.py).
6
+ # It is LAZY-IMPORTED at first use, so the package still imports where `mcp` is
7
+ # absent (e.g. unit tests inject a fake SDK) — install this on the box that runs
8
+ # scanners that call ctx.senpi_mcp.
9
+ #
10
+ # `mcp[cli]` is NOT needed — only the client transport + ClientSession surface.
11
+ mcp>=1.9.0