@senpi-ai/runtime 1.1.3 → 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 (472) 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 +140 -29
  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.map +1 -1
  217. package/dist/runtime/risk-guard.js +17 -12
  218. package/dist/runtime/risk-guard.js.map +1 -1
  219. package/dist/runtime/run.d.ts.map +1 -1
  220. package/dist/runtime/run.js +3 -2
  221. package/dist/runtime/run.js.map +1 -1
  222. package/dist/runtime/runtime-schema.d.ts +4056 -793
  223. package/dist/runtime/runtime-schema.d.ts.map +1 -1
  224. package/dist/runtime/runtime-schema.js +183 -46
  225. package/dist/runtime/runtime-schema.js.map +1 -1
  226. package/dist/runtime/runtime-version.d.ts +3 -6
  227. package/dist/runtime/runtime-version.d.ts.map +1 -1
  228. package/dist/runtime/runtime-version.js +3 -6
  229. package/dist/runtime/runtime-version.js.map +1 -1
  230. package/dist/runtime/runtime.d.ts +47 -0
  231. package/dist/runtime/runtime.d.ts.map +1 -1
  232. package/dist/runtime/runtime.js +516 -146
  233. package/dist/runtime/runtime.js.map +1 -1
  234. package/dist/runtime/scanner-registry.d.ts +1 -1
  235. package/dist/runtime/scanner-registry.d.ts.map +1 -1
  236. package/dist/runtime/scanner-registry.js +3 -12
  237. package/dist/runtime/scanner-registry.js.map +1 -1
  238. package/dist/runtime/strategy-registry.d.ts +6 -0
  239. package/dist/runtime/strategy-registry.d.ts.map +1 -1
  240. package/dist/runtime/strategy-registry.js +1 -0
  241. package/dist/runtime/strategy-registry.js.map +1 -1
  242. package/dist/runtime/supervisor/long-running-supervisor.d.ts +222 -0
  243. package/dist/runtime/supervisor/long-running-supervisor.d.ts.map +1 -0
  244. package/dist/runtime/supervisor/long-running-supervisor.js +625 -0
  245. package/dist/runtime/supervisor/long-running-supervisor.js.map +1 -0
  246. package/dist/runtime/supervisor/orphan-sweep.d.ts +36 -0
  247. package/dist/runtime/supervisor/orphan-sweep.d.ts.map +1 -0
  248. package/dist/runtime/supervisor/orphan-sweep.js +255 -0
  249. package/dist/runtime/supervisor/orphan-sweep.js.map +1 -0
  250. package/dist/runtime/supervisor/supervisor-utils.d.ts +37 -0
  251. package/dist/runtime/supervisor/supervisor-utils.d.ts.map +1 -0
  252. package/dist/runtime/supervisor/supervisor-utils.js +175 -0
  253. package/dist/runtime/supervisor/supervisor-utils.js.map +1 -0
  254. package/dist/runtime-api/handlers/ingest-signals.d.ts +3 -3
  255. package/dist/runtime-api/handlers/ingest-signals.js +3 -3
  256. package/dist/runtime-api/intake/acceptance-record.d.ts +103 -0
  257. package/dist/runtime-api/intake/acceptance-record.d.ts.map +1 -0
  258. package/dist/runtime-api/intake/acceptance-record.js +192 -0
  259. package/dist/runtime-api/intake/acceptance-record.js.map +1 -0
  260. package/dist/runtime-api/intake/intake-context.d.ts +31 -0
  261. package/dist/runtime-api/intake/intake-context.d.ts.map +1 -0
  262. package/dist/runtime-api/intake/intake-context.js +21 -0
  263. package/dist/runtime-api/intake/intake-context.js.map +1 -0
  264. package/dist/runtime-api/intake/intake-mount.d.ts +118 -0
  265. package/dist/runtime-api/intake/intake-mount.d.ts.map +1 -0
  266. package/dist/runtime-api/intake/intake-mount.js +193 -0
  267. package/dist/runtime-api/intake/intake-mount.js.map +1 -0
  268. package/dist/runtime-api/intake/liveness-store.d.ts +32 -0
  269. package/dist/runtime-api/intake/liveness-store.d.ts.map +1 -0
  270. package/dist/runtime-api/intake/liveness-store.js +31 -0
  271. package/dist/runtime-api/intake/liveness-store.js.map +1 -0
  272. package/dist/runtime-api/intake/process-error-post.d.ts +15 -0
  273. package/dist/runtime-api/intake/process-error-post.d.ts.map +1 -0
  274. package/dist/runtime-api/intake/process-error-post.js +19 -0
  275. package/dist/runtime-api/intake/process-error-post.js.map +1 -0
  276. package/dist/runtime-api/intake/process-signal-post.d.ts +73 -0
  277. package/dist/runtime-api/intake/process-signal-post.d.ts.map +1 -0
  278. package/dist/runtime-api/intake/process-signal-post.js +188 -0
  279. package/dist/runtime-api/intake/process-signal-post.js.map +1 -0
  280. package/dist/runtime-api/intake/scanner-launcher.d.ts +133 -0
  281. package/dist/runtime-api/intake/scanner-launcher.d.ts.map +1 -0
  282. package/dist/runtime-api/intake/scanner-launcher.js +204 -0
  283. package/dist/runtime-api/intake/scanner-launcher.js.map +1 -0
  284. package/dist/runtime-api/intake/scanner-registry.d.ts +36 -0
  285. package/dist/runtime-api/intake/scanner-registry.d.ts.map +1 -0
  286. package/dist/runtime-api/intake/scanner-registry.js +29 -0
  287. package/dist/runtime-api/intake/scanner-registry.js.map +1 -0
  288. package/dist/runtime-api/intake/types.d.ts +61 -0
  289. package/dist/runtime-api/intake/types.d.ts.map +1 -0
  290. package/dist/runtime-api/intake/types.js +8 -0
  291. package/dist/runtime-api/intake/types.js.map +1 -0
  292. package/dist/runtime-api/routes/signals.d.ts +20 -40
  293. package/dist/runtime-api/routes/signals.d.ts.map +1 -1
  294. package/dist/runtime-api/routes/signals.js +119 -75
  295. package/dist/runtime-api/routes/signals.js.map +1 -1
  296. package/dist/runtime-api/routes/signals.schema.d.ts +24 -86
  297. package/dist/runtime-api/routes/signals.schema.d.ts.map +1 -1
  298. package/dist/runtime-api/routes/signals.schema.js +35 -50
  299. package/dist/runtime-api/routes/signals.schema.js.map +1 -1
  300. package/dist/runtime-api/server.d.ts +15 -6
  301. package/dist/runtime-api/server.d.ts.map +1 -1
  302. package/dist/runtime-api/server.js +12 -12
  303. package/dist/runtime-api/server.js.map +1 -1
  304. package/dist/scanners/events.d.ts +6 -0
  305. package/dist/scanners/events.d.ts.map +1 -1
  306. package/dist/scanners/events.js.map +1 -1
  307. package/dist/scanners/external/scaffold/__init__.py +16 -0
  308. package/dist/scanners/external/scaffold/__main__.py +155 -0
  309. package/dist/scanners/external/scaffold/ctx.py +78 -0
  310. package/dist/scanners/external/scaffold/delivery.py +263 -0
  311. package/dist/scanners/external/scaffold/entrypoint_loader.py +151 -0
  312. package/dist/scanners/external/scaffold/http_post.py +70 -0
  313. package/dist/scanners/external/scaffold/journal.py +247 -0
  314. package/dist/scanners/external/scaffold/loop_primitives.py +65 -0
  315. package/dist/scanners/external/scaffold/requirements.txt +11 -0
  316. package/dist/scanners/external/scaffold/scaffold.py +361 -0
  317. package/dist/scanners/external/scaffold/scaffold_state.py +114 -0
  318. package/dist/scanners/external/scaffold/senpi_mcp.py +250 -0
  319. package/dist/scanners/external/scaffold/signal_envelope.py +220 -0
  320. package/dist/scanners/external/scaffold/state_manager.py +175 -0
  321. package/dist/scanners/external-scanner-receiver.d.ts +17 -1
  322. package/dist/scanners/external-scanner-receiver.d.ts.map +1 -1
  323. package/dist/scanners/external-scanner-receiver.js +16 -3
  324. package/dist/scanners/external-scanner-receiver.js.map +1 -1
  325. package/dist/scanners/implementations/external-scanner.d.ts.map +1 -1
  326. package/dist/scanners/implementations/external-scanner.js +7 -1
  327. package/dist/scanners/implementations/external-scanner.js.map +1 -1
  328. package/dist/scanners/implementations/momentum.d.ts.map +1 -1
  329. package/dist/scanners/implementations/momentum.js +16 -0
  330. package/dist/scanners/implementations/momentum.js.map +1 -1
  331. package/dist/scanners/runtime-module.d.ts.map +1 -1
  332. package/dist/scanners/runtime-module.js +9 -1
  333. package/dist/scanners/runtime-module.js.map +1 -1
  334. package/dist/scripts/run-dsl-standalone-live.d.ts +1 -1
  335. package/dist/scripts/run-dsl-standalone-live.js +5 -3
  336. package/dist/scripts/run-dsl-standalone-live.js.map +1 -1
  337. package/dist/senpi/client.d.ts +56 -4
  338. package/dist/senpi/client.d.ts.map +1 -1
  339. package/dist/senpi/client.js +123 -24
  340. package/dist/senpi/client.js.map +1 -1
  341. package/dist/senpi/index.d.ts +2 -1
  342. package/dist/senpi/index.d.ts.map +1 -1
  343. package/dist/senpi/index.js +1 -1
  344. package/dist/senpi/index.js.map +1 -1
  345. package/dist/senpi/types.d.ts +1 -2
  346. package/dist/senpi/types.d.ts.map +1 -1
  347. package/dist/state/state-manager.d.ts +17 -0
  348. package/dist/state/state-manager.d.ts.map +1 -1
  349. package/dist/state/state-manager.js +55 -4
  350. package/dist/state/state-manager.js.map +1 -1
  351. package/dist/strategy/strategy-state.d.ts +9 -1
  352. package/dist/strategy/strategy-state.d.ts.map +1 -1
  353. package/dist/strategy/strategy-state.js +62 -9
  354. package/dist/strategy/strategy-state.js.map +1 -1
  355. package/dist/tracking/build-rehydrate-items.d.ts +15 -0
  356. package/dist/tracking/build-rehydrate-items.d.ts.map +1 -0
  357. package/dist/tracking/build-rehydrate-items.js +19 -0
  358. package/dist/tracking/build-rehydrate-items.js.map +1 -0
  359. package/dist/tracking/constants.d.ts.map +1 -1
  360. package/dist/tracking/constants.js +2 -0
  361. package/dist/tracking/constants.js.map +1 -1
  362. package/dist/tracking/index.d.ts +3 -0
  363. package/dist/tracking/index.d.ts.map +1 -1
  364. package/dist/tracking/index.js +2 -0
  365. package/dist/tracking/index.js.map +1 -1
  366. package/dist/tracking/position-id-registry.d.ts +69 -0
  367. package/dist/tracking/position-id-registry.d.ts.map +1 -0
  368. package/dist/tracking/position-id-registry.js +139 -0
  369. package/dist/tracking/position-id-registry.js.map +1 -0
  370. package/dist/tracking/spans/fan-out-span-transport.d.ts +22 -0
  371. package/dist/tracking/spans/fan-out-span-transport.d.ts.map +1 -0
  372. package/dist/tracking/spans/fan-out-span-transport.js +49 -0
  373. package/dist/tracking/spans/fan-out-span-transport.js.map +1 -0
  374. package/dist/tracking/spans/otel/fit-row-budget.d.ts +22 -0
  375. package/dist/tracking/spans/otel/fit-row-budget.d.ts.map +1 -0
  376. package/dist/tracking/spans/otel/fit-row-budget.js +91 -0
  377. package/dist/tracking/spans/otel/fit-row-budget.js.map +1 -0
  378. package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts +16 -0
  379. package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts.map +1 -0
  380. package/dist/tracking/spans/otel/map-span-to-trace-row.js +227 -0
  381. package/dist/tracking/spans/otel/map-span-to-trace-row.js.map +1 -0
  382. package/dist/tracking/spans/otel/recording-span-transport.d.ts +43 -0
  383. package/dist/tracking/spans/otel/recording-span-transport.d.ts.map +1 -0
  384. package/dist/tracking/spans/otel/recording-span-transport.js +67 -0
  385. package/dist/tracking/spans/otel/recording-span-transport.js.map +1 -0
  386. package/dist/tracking/spans/otel/span-ids.d.ts +22 -0
  387. package/dist/tracking/spans/otel/span-ids.d.ts.map +1 -0
  388. package/dist/tracking/spans/otel/span-ids.js +32 -0
  389. package/dist/tracking/spans/otel/span-ids.js.map +1 -0
  390. package/dist/tracking/spans/plugin-span-tracker.d.ts +6 -0
  391. package/dist/tracking/spans/plugin-span-tracker.d.ts.map +1 -1
  392. package/dist/tracking/spans/plugin-span-tracker.js +82 -9
  393. package/dist/tracking/spans/plugin-span-tracker.js.map +1 -1
  394. package/dist/tracking/spans/redact-pii.d.ts +3 -1
  395. package/dist/tracking/spans/redact-pii.d.ts.map +1 -1
  396. package/dist/tracking/spans/redact-pii.js +5 -1
  397. package/dist/tracking/spans/redact-pii.js.map +1 -1
  398. package/dist/tracking/spans/span-transport.d.ts +6 -0
  399. package/dist/tracking/spans/span-transport.d.ts.map +1 -1
  400. package/dist/tracking/spans/span-transport.js +1 -1
  401. package/dist/tracking/spans/span-transport.js.map +1 -1
  402. package/dist/types/dsl/index.d.ts +24 -1
  403. package/dist/types/dsl/index.d.ts.map +1 -1
  404. package/dist/types/runtime.d.ts +6 -0
  405. package/dist/types/runtime.d.ts.map +1 -1
  406. package/dist/types/scanner.d.ts +7 -0
  407. package/dist/types/scanner.d.ts.map +1 -1
  408. package/dist/types/strategy.d.ts +3 -1
  409. package/dist/types/strategy.d.ts.map +1 -1
  410. package/dist/utils/keyed-mutex.d.ts +37 -0
  411. package/dist/utils/keyed-mutex.d.ts.map +1 -0
  412. package/dist/utils/keyed-mutex.js +77 -0
  413. package/dist/utils/keyed-mutex.js.map +1 -0
  414. package/dist/utils/safe-spawn.d.ts +6 -0
  415. package/dist/utils/safe-spawn.d.ts.map +1 -0
  416. package/dist/utils/safe-spawn.js +62 -0
  417. package/dist/utils/safe-spawn.js.map +1 -0
  418. package/examples/strategies/README.md +17 -12
  419. package/examples/strategies/iguana/README.md +135 -0
  420. package/examples/strategies/iguana/recipe.yaml +137 -0
  421. package/examples/strategies/iguana/scanners/scan.py +243 -0
  422. package/examples/strategies/iguana/scanners/scoring.py +152 -0
  423. package/examples/strategies/raptor/README.md +156 -0
  424. package/examples/strategies/raptor/recipe.yaml +154 -0
  425. package/examples/strategies/raptor/scanners/scan.py +349 -0
  426. package/examples/strategies/raptor/scanners/scoring.py +452 -0
  427. package/examples/strategies/spider/README.md +89 -0
  428. package/examples/strategies/spider/scalp/recipe.yaml +129 -0
  429. package/examples/strategies/spider/scalp/scanners/scan.py +219 -0
  430. package/examples/strategies/spider/scalp/scanners/scoring.py +179 -0
  431. package/examples/strategies/spider/swing/recipe.yaml +137 -0
  432. package/examples/strategies/spider/swing/scanners/scan.py +334 -0
  433. package/examples/strategies/spider/swing/scanners/scoring.py +184 -0
  434. package/examples/strategies/turbine/README.md +166 -0
  435. package/examples/strategies/turbine/recipe-runners.yaml +123 -0
  436. package/examples/strategies/turbine/recipe-volume.yaml +129 -0
  437. package/examples/strategies/turbine/scanners/scan.py +283 -0
  438. package/examples/strategies/turbine/scanners/scoring.py +190 -0
  439. package/openclaw.plugin.json +12 -1
  440. package/package.json +3 -3
  441. package/dist/runtime-api/handlers/group-by-scanner.d.ts +0 -43
  442. package/dist/runtime-api/handlers/group-by-scanner.d.ts.map +0 -1
  443. package/dist/runtime-api/handlers/group-by-scanner.js +0 -43
  444. package/dist/runtime-api/handlers/group-by-scanner.js.map +0 -1
  445. package/dist/scanners/external/liquidation-watchdog/README.md +0 -107
  446. package/dist/scanners/external/liquidation-watchdog/liquidation-watchdog.yaml +0 -48
  447. package/dist/scanners/external/liquidation-watchdog/producer.mjs +0 -336
  448. package/dist/scanners/external/momentum/README.md +0 -148
  449. package/dist/scanners/external/momentum/momentum.yaml +0 -116
  450. package/dist/scanners/external/momentum/producer.mjs +0 -251
  451. package/dist/scanners/external/shared/ingest.mjs +0 -112
  452. package/examples/README.md +0 -89
  453. package/examples/scanners-consumer-quickstart.mjs +0 -134
  454. package/examples/scanners-emerging-movers-v4.mjs +0 -287
  455. package/examples/scanners-liquidation-watchdog.mjs +0 -341
  456. package/examples/scanners-live-mcp.mjs +0 -208
  457. package/examples/scanners-multi-strategy.mjs +0 -165
  458. package/examples/scanners-position-tracker-e2e.mjs +0 -225
  459. package/examples/scanners-scheduled-events.mjs +0 -96
  460. package/examples/scanners-senpi-provider-client.mjs +0 -182
  461. package/examples/scanners-single-strategy.mjs +0 -198
  462. package/examples/strategies/dsl-showcase.yaml +0 -68
  463. package/examples/strategies/dsl.yaml +0 -51
  464. package/examples/strategies/fox-minimal-loosened.yaml +0 -240
  465. package/examples/strategies/fox-minimal.yaml +0 -242
  466. package/examples/strategies/minimal.yaml +0 -46
  467. package/examples/strategies/momentum/how-it-works.md +0 -48
  468. package/examples/strategies/momentum/momentum-guarded.yaml +0 -161
  469. package/examples/strategies/risk-showcase.yaml +0 -93
  470. package/examples/strategies/viper.yaml +0 -67
  471. package/examples/strategies/wolf.yaml +0 -72
  472. package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +0 -123
@@ -1,251 +0,0 @@
1
- /**
2
- * External momentum producer.
3
- *
4
- * A standalone momentum scanner that:
5
- * 1. Pulls instruments + latest candles from the live Senpi MCP server.
6
- * 2. Computes last-vs-prev close % move against configurable thresholds.
7
- * 3. Pushes MOMENTUM_BREAKOUT signals into a running runtime via the
8
- * `openclaw senpi external-scanner ingest` CLI command.
9
- *
10
- * Prereqs:
11
- * - `npm run build` so dist/ is current (used only for the MCP provider bridge).
12
- * - A runtime installed from ./momentum.yaml is running for STRATEGY_ADDRESS.
13
- * - `openclaw` CLI on PATH and authenticated against that runtime.
14
- * - SENPI_API_KEY and SENPI_MCP_URL env vars set.
15
- *
16
- * Run: node src/scanners/external/momentum/producer.mjs
17
- */
18
-
19
- import { Client } from "@modelcontextprotocol/sdk/client/index.js";
20
- import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
21
- import { createSenpiScannerProviders } from "../../../../dist/scanners/index.js";
22
- import { pushScannerSignals } from "../shared/ingest.mjs";
23
-
24
- // ─── Config ─────────────────────────────────────────────────────────────────
25
-
26
- const SENPI_API_KEY = process.env.SENPI_API_KEY;
27
- const SENPI_MCP_URL = process.env.SENPI_MCP_URL;
28
- const STRATEGY_ADDRESS = process.env.STRATEGY_ADDRESS;
29
- const SCANNER_NAME =
30
- process.env.EXTERNAL_SCANNER_NAME ?? "external_momentum";
31
- const OPENCLAW_BIN = process.env.OPENCLAW_BIN ?? "openclaw";
32
- const SCANNER_ID = "external-momentum-producer";
33
-
34
- const config = {
35
- timeframe: process.env.TIMEFRAME ?? "1h",
36
- minMovePct: numEnv("MIN_MOVE_PCT", 1.5),
37
- minDayVolume: numEnv("MIN_DAY_VOLUME", 1_000_000),
38
- minLeverage: numEnv("MIN_LEVERAGE", 5),
39
- maxCandidates: numEnv("MAX_CANDIDATES", 20),
40
- minSignalScore: numEnv("MIN_SIGNAL_SCORE", 0.2),
41
- };
42
-
43
- if (!SENPI_API_KEY || !SENPI_MCP_URL || !STRATEGY_ADDRESS) {
44
- console.error(
45
- "Missing required env vars. Set SENPI_API_KEY, SENPI_MCP_URL, and STRATEGY_ADDRESS.\n" +
46
- " export SENPI_API_KEY='...'\n" +
47
- " export SENPI_MCP_URL='https://mcp.prod.senpi.ai/mcp'\n" +
48
- " export STRATEGY_ADDRESS='0x...'",
49
- );
50
- process.exit(1);
51
- }
52
-
53
- function numEnv(name, fallback) {
54
- const raw = process.env[name];
55
- if (raw === undefined || raw === "") return fallback;
56
- const parsed = Number(raw);
57
- if (!Number.isFinite(parsed)) {
58
- throw new Error(`Env ${name} must be a finite number, got "${raw}"`);
59
- }
60
- return parsed;
61
- }
62
-
63
- // ─── MCP → SenpiToolClient bridge ───────────────────────────────────────────
64
-
65
- function createSenpiToolClient(mcpClient) {
66
- return {
67
- async callTool(name, args) {
68
- const result = await mcpClient.callTool({ name, arguments: args });
69
-
70
- if (result.isError) {
71
- const errorText =
72
- Array.isArray(result.content) &&
73
- result.content.length > 0 &&
74
- result.content[0].type === "text"
75
- ? result.content[0].text
76
- : JSON.stringify(result.content);
77
- throw new Error(`MCP tool "${name}" returned error: ${errorText}`);
78
- }
79
-
80
- if (result.structuredContent !== undefined) {
81
- return result.structuredContent;
82
- }
83
-
84
- if (Array.isArray(result.content) && result.content.length > 0) {
85
- const first = result.content[0];
86
- if (first.type === "text") {
87
- try {
88
- return JSON.parse(first.text);
89
- } catch {
90
- return first.text;
91
- }
92
- }
93
- }
94
-
95
- return result.content;
96
- },
97
- };
98
- }
99
-
100
- // ─── Momentum logic ─────────────────────────────────────────────────────────
101
- // Self-contained port of src/scanners/implementations/momentum.ts. Kept free
102
- // of any runtime-internal imports.
103
-
104
- function clamp01(value) {
105
- if (!Number.isFinite(value)) return 0;
106
- if (value < 0) return 0;
107
- if (value > 1) return 1;
108
- return value;
109
- }
110
-
111
- function selectCandidates(instruments, cfg) {
112
- const eligible = instruments.filter((inst) => {
113
- if (inst.isDelisted) return false;
114
- if ((inst.maxLeverage ?? 0) < cfg.minLeverage) return false;
115
- const vol = inst.context?.dayNtlVlm ?? 0;
116
- return vol >= cfg.minDayVolume;
117
- });
118
- eligible.sort(
119
- (a, b) => (b.context?.dayNtlVlm ?? 0) - (a.context?.dayNtlVlm ?? 0),
120
- );
121
- return eligible.slice(0, cfg.maxCandidates);
122
- }
123
-
124
- function computeMovePct(series) {
125
- if (!series || series.length < 2) return null;
126
- const prev = series[series.length - 2]?.close;
127
- const last = series[series.length - 1]?.close;
128
- if (!Number.isFinite(prev) || !Number.isFinite(last) || prev <= 0) {
129
- return null;
130
- }
131
- return { prev, last, movePct: ((last - prev) / prev) * 100 };
132
- }
133
-
134
- function buildSignal({ instrument, move, timeframe, now }) {
135
- const movePct = move.movePct;
136
- const absMove = Math.abs(movePct);
137
- const direction = movePct > 0 ? "LONG" : "SHORT";
138
- // Score scales from 0 at minMovePct to 1 at 5% move, clamped.
139
- const score = clamp01((absMove - config.minMovePct) / (5 - config.minMovePct));
140
-
141
- return {
142
- scannerId: SCANNER_ID,
143
- signalType: "MOMENTUM_BREAKOUT",
144
- asset: instrument.name,
145
- direction,
146
- score,
147
- timestamp: now,
148
- factors: {
149
- breakout: true,
150
- large_move: absMove >= 3,
151
- },
152
- meta: {
153
- timeframe,
154
- movePct,
155
- prev: move.prev,
156
- last: move.last,
157
- dayNtlVlm: instrument.context?.dayNtlVlm ?? 0,
158
- maxLeverage: instrument.maxLeverage,
159
- },
160
- };
161
- }
162
-
163
- // ─── Main ───────────────────────────────────────────────────────────────────
164
-
165
- async function main() {
166
- console.log(`External momentum producer`);
167
- console.log(` MCP: ${SENPI_MCP_URL}`);
168
- console.log(` address: ${STRATEGY_ADDRESS}`);
169
- console.log(` scanner: ${SCANNER_NAME}`);
170
- console.log(` config: ${JSON.stringify(config)}`);
171
-
172
- const transport = new StreamableHTTPClientTransport(new URL(SENPI_MCP_URL), {
173
- requestInit: { headers: { Authorization: `Bearer ${SENPI_API_KEY}` } },
174
- });
175
- const mcpClient = new Client({
176
- name: "external-momentum",
177
- version: "0.0.1",
178
- });
179
- await mcpClient.connect(transport);
180
-
181
- const providers = createSenpiScannerProviders({
182
- client: createSenpiToolClient(mcpClient),
183
- logLevel: "warn",
184
- cacheTtlMs: { instruments: 0, smData: 0, candles: 0 },
185
- candleIntervals: [config.timeframe],
186
- maxCandleAssets: config.maxCandidates,
187
- retries: 2,
188
- });
189
-
190
- try {
191
- const instruments = await providers.getInstruments(STRATEGY_ADDRESS);
192
- const candidates = selectCandidates(instruments, config);
193
- console.log(
194
- `\nInstruments: ${instruments.length}, candidates: ${candidates.length}`,
195
- );
196
-
197
- if (candidates.length === 0) {
198
- console.log("No candidates after filtering — skipping ingest.");
199
- return;
200
- }
201
-
202
- const candles = await providers.getCandles(STRATEGY_ADDRESS, candidates, {
203
- scannerId: SCANNER_ID,
204
- preferredAssets: candidates.map((c) => c.name),
205
- });
206
-
207
- const now = Date.now();
208
- const signals = [];
209
- for (const inst of candidates) {
210
- const series = candles[inst.name]?.candles?.[config.timeframe];
211
- const move = computeMovePct(series);
212
- if (!move) continue;
213
- if (Math.abs(move.movePct) < config.minMovePct) continue;
214
- const signal = buildSignal({
215
- instrument: inst,
216
- move,
217
- timeframe: config.timeframe,
218
- now,
219
- });
220
- if (signal.score < config.minSignalScore) continue;
221
- signals.push(signal);
222
- }
223
-
224
- console.log(`\nSignals: ${signals.length}`);
225
- for (const s of signals) {
226
- console.log(
227
- ` ${s.asset} ${s.direction} move=${s.meta.movePct.toFixed(2)}% score=${s.score.toFixed(2)}`,
228
- );
229
- }
230
-
231
- if (signals.length === 0) {
232
- console.log("\nNothing to ingest — skipping gateway call.");
233
- return;
234
- }
235
-
236
- const response = await pushScannerSignals({
237
- address: STRATEGY_ADDRESS,
238
- scanner: SCANNER_NAME,
239
- signals,
240
- openclawBin: OPENCLAW_BIN,
241
- });
242
- console.log("\nIngest response:", JSON.stringify(response));
243
- } finally {
244
- await transport.close();
245
- }
246
- }
247
-
248
- main().catch((error) => {
249
- console.error("\nProducer failed:", error.message ?? error);
250
- process.exit(1);
251
- });
@@ -1,112 +0,0 @@
1
- /**
2
- * Shared ingest helpers for external-scanner producers under
3
- * `src/scanners/external/`.
4
- *
5
- * Producers all need the same two things:
6
- * 1. Normalize an in-producer signal into the external batch item shape
7
- * expected by `senpi.ingestExternalScannerData`.
8
- * 2. Shell out to the openclaw CLI to actually push the batch and parse the
9
- * response.
10
- *
11
- * Keeping this in one place means producers never diverge on the wire format
12
- * or response-validation rules, and a future CLI contract change only needs to
13
- * be made here.
14
- */
15
-
16
- import { execFile } from "node:child_process";
17
- import { promisify } from "node:util";
18
-
19
- const execFileAsync = promisify(execFile);
20
-
21
- /**
22
- * Convert a producer-native signal object into the batch item shape consumed
23
- * by the external-scanner ingest CLI/RPC.
24
- *
25
- * Producers emit richer signal objects (scannerId/factors/meta/timestamp) but
26
- * the runtime only needs the top-level routing fields plus an opaque `data`
27
- * blob — everything else is preserved under `data.source*` so downstream
28
- * consumers can reconstruct the original context.
29
- */
30
- export function toExternalBatchItem(signal) {
31
- return {
32
- asset: signal.asset,
33
- direction: signal.direction,
34
- score: signal.score,
35
- signal_type: signal.signalType,
36
- data: {
37
- sourceScannerId: signal.scannerId,
38
- sourceSignalType: signal.signalType,
39
- sourceTimestamp: signal.timestamp,
40
- sourceFactors: signal.factors,
41
- sourceMeta: signal.meta,
42
- },
43
- };
44
- }
45
-
46
- /**
47
- * Push a batch of scanner signals from an external producer into a running
48
- * runtime via the `openclaw senpi external-scanner ingest` CLI command.
49
- *
50
- * Named from the producer's point of view: the scanner executing this code
51
- * is pushing its signals out to the senpi-trading-runtime service.
52
- *
53
- * The CLI emits pure JSON on stdout:
54
- * - success: { ok: true, result: { accepted, signalCount, ... } }
55
- * - failure: { ok: false, error: { code, message } }
56
- *
57
- * @param {object} opts
58
- * @param {string} opts.address Strategy wallet address.
59
- * @param {string} opts.scanner Configured external_scanner name.
60
- * @param {Array<object>} opts.signals Producer-native signals (will be
61
- * normalized via `toExternalBatchItem`).
62
- * @param {string} [opts.openclawBin] Path or name of the openclaw CLI
63
- * (defaults to `"openclaw"`).
64
- * @returns {Promise<object>} The inner `result` payload from the
65
- * gateway on success.
66
- */
67
- export async function pushScannerSignals({
68
- address,
69
- scanner,
70
- signals,
71
- openclawBin = "openclaw",
72
- }) {
73
- const payload = {
74
- signals: signals.map(toExternalBatchItem),
75
- };
76
- const { stdout } = await execFileAsync(openclawBin, [
77
- "senpi",
78
- "external-scanner",
79
- "ingest",
80
- "--address",
81
- address,
82
- "--scanner",
83
- scanner,
84
- "--payload",
85
- JSON.stringify(payload),
86
- ]);
87
-
88
- let response;
89
- try {
90
- response = JSON.parse(stdout);
91
- } catch {
92
- throw new Error(`CLI returned non-JSON response:\n${stdout}`);
93
- }
94
-
95
- if (response?.ok !== true) {
96
- const err = response?.error ?? {};
97
- const code = err.code ?? "UNKNOWN";
98
- const message = err.message ?? JSON.stringify(response);
99
- throw new Error(`CLI rejected ingest (${code}): ${message}`);
100
- }
101
-
102
- const result = response.result ?? {};
103
- if (!result.accepted) {
104
- throw new Error(`CLI did not accept ingest: ${JSON.stringify(result)}`);
105
- }
106
- if (result.signalCount !== signals.length) {
107
- throw new Error(
108
- `Expected signalCount=${signals.length}, got ${result.signalCount}`,
109
- );
110
- }
111
- return result;
112
- }
@@ -1,89 +0,0 @@
1
- # Scanners Module Examples
2
-
3
- These examples are real clients of the standalone scanners module.
4
-
5
- If you are integrating the module as a consumer for the first time, start with `scanners-consumer-quickstart.mjs`.
6
-
7
- Each example imports from a built `dist/` entrypoint, so build first:
8
-
9
- ```bash
10
- npm run build
11
- ```
12
-
13
- Run examples:
14
-
15
- ```bash
16
- node examples/scanners-single-strategy.mjs
17
- node examples/scanners-multi-strategy.mjs
18
- node examples/scanners-scheduled-events.mjs
19
- node examples/scanners-senpi-provider-client.mjs
20
- node examples/scanners-consumer-quickstart.mjs
21
- node examples/scanners-emerging-movers-v4.mjs
22
-
23
- # Requires env vars (see below)
24
- node examples/scanners-live-mcp.mjs
25
- node examples/scanners-position-tracker-e2e.mjs
26
- ```
27
-
28
- What each example demonstrates:
29
-
30
- 1. `scanners-consumer-quickstart.mjs`
31
- - Smallest consumer-oriented setup
32
- - Which imports to use
33
- - Required `createScannerRuntimeModule(...)` options
34
- - Manual `runOnce(...)` flow and `querySignals(...)`
35
-
36
- 2. `scanners-single-strategy.mjs`
37
- - One strategy with `prescreener`, `oi-tracker`, `momentum`, `emerging-movers`
38
- - Manual `runOnce` flow and signal query
39
-
40
- 3. `scanners-multi-strategy.mjs`
41
- - Two strategies sharing scanner ids
42
- - Different scanner configs per strategy and isolated outputs
43
-
44
- 4. `scanners-scheduled-events.mjs`
45
- - Interval-driven execution with `start()` / `stop()`
46
- - Pub/sub lifecycle events (`start`, `complete`, `skip`, `error`)
47
-
48
- 5. `scanners-senpi-provider-client.mjs`
49
- - Uses `createSenpiScannerProviders(...)` with a **mock** `callTool` client
50
- - Demonstrates provider wiring for `prescreener`, `momentum`, and `emerging-movers`
51
-
52
- 6. `scanners-emerging-movers-v4.mjs`
53
- - Showcases all five v4 signal types: FIRST_JUMP, CONTRIB_EXPLOSION, IMMEDIATE_MOVER, NEW_ENTRY_DEEP, DEEP_CLIMBER
54
- - Simulates a 50-token SM leaderboard evolving over 4 scans
55
- - Production-like v4 config with all detection thresholds
56
- - Prints signals with priority, reasons, factors, and summary breakdown
57
-
58
- 7. `scanners-live-mcp.mjs`
59
- - Connects to the **real Senpi MCP server** using `@modelcontextprotocol/sdk`
60
- - Bridges `Client.callTool` → `SenpiToolClient` interface
61
- - Runs all four scanners against live market data and prints results
62
- - Requires env vars:
63
- ```bash
64
- export SENPI_API_KEY="your-api-key"
65
- export SENPI_MCP_URL="https://mcp.prod.senpi.ai/mcp"
66
- ```
67
-
68
- 8. `scanners-position-tracker-e2e.mjs`
69
- - Connects to the **real Senpi MCP server** and runs the `position-tracker` scanner
70
- - Fetches clearing house state for a strategy wallet with open positions
71
- - Runs 3 iterations: initial scan (POSITION_OPENED deltas), then 2 steady-state heartbeats
72
- - Prints detailed position snapshots (direction, size, entry, leverage, uPnL, ROE)
73
- - Requires env vars:
74
- ```bash
75
- export SENPI_API_KEY="your-api-key"
76
- export SENPI_MCP_URL="https://mcp.prod.senpi.ai/mcp"
77
- # Optional: override default strategy address
78
- export STRATEGY_ADDRESS="0x..."
79
- ```
80
-
81
- ## Strategy YAML templates
82
-
83
- See [`strategies/`](./strategies/README.md) for production-ready YAML
84
- configs you can copy, fill in your wallet address, and load directly:
85
-
86
- ```bash
87
- openclaw senpi runtime create -p examples/strategies/wolf.yaml
88
- ```
89
-
@@ -1,134 +0,0 @@
1
- import { mkdtemp, rm } from "node:fs/promises";
2
- import { tmpdir } from "node:os";
3
- import { join } from "node:path";
4
- import {
5
- createScannerRuntimeModule,
6
- momentumScanner,
7
- prescreenerScanner,
8
- } from "../dist/index.js";
9
-
10
- function createInstruments() {
11
- return [
12
- {
13
- name: "BTC",
14
- isDelisted: false,
15
- maxLeverage: 10,
16
- context: {
17
- markPx: 105,
18
- prevDayPx: 100,
19
- midPx: 105,
20
- dayNtlVlm: 80_000_000,
21
- openInterest: 2_000_000_000,
22
- funding: 0.001,
23
- },
24
- },
25
- {
26
- name: "ETH",
27
- isDelisted: false,
28
- maxLeverage: 8,
29
- context: {
30
- markPx: 101,
31
- prevDayPx: 100,
32
- midPx: 101,
33
- dayNtlVlm: 40_000_000,
34
- openInterest: 1_000_000_000,
35
- funding: 0.001,
36
- },
37
- },
38
- ];
39
- }
40
-
41
- function createCandles() {
42
- return {
43
- BTC: {
44
- candles: {
45
- "1h": [
46
- { timestamp: 1, open: 100, high: 102, low: 99, close: 100, volume: 1000 },
47
- { timestamp: 2, open: 100, high: 106, low: 100, close: 105, volume: 1400 },
48
- ],
49
- },
50
- },
51
- ETH: {
52
- candles: {
53
- "1h": [
54
- { timestamp: 1, open: 100, high: 101, low: 99, close: 100, volume: 900 },
55
- { timestamp: 2, open: 100, high: 101, low: 99, close: 100.2, volume: 920 },
56
- ],
57
- },
58
- },
59
- };
60
- }
61
-
62
- async function main() {
63
- const stateDir = await mkdtemp(join(tmpdir(), "scanners-consumer-quickstart-"));
64
-
65
- // Required pieces:
66
- // - stateDir
67
- // - at least one strategy
68
- // - scanner factories
69
- // - provider functions required by those scanners
70
- const scannerModule = createScannerRuntimeModule({
71
- stateDir,
72
- strategies: [
73
- {
74
- id: "alpha",
75
- name: "Alpha",
76
- scannerOverrides: {
77
- momentum: {
78
- config: {
79
- timeframe: "1h",
80
- minMovePct: 1.5,
81
- maxCandidates: 20,
82
- minDayVolume: 1_000_000,
83
- minSignalScore: 0.2,
84
- requirePrescreened: true,
85
- },
86
- },
87
- },
88
- },
89
- ],
90
- scanners: [prescreenerScanner, momentumScanner],
91
- providers: {
92
- getInstruments: async () => createInstruments(),
93
- getCandles: async () => createCandles(),
94
- },
95
- });
96
-
97
- scannerModule.on("scanner:run:complete", (event) => {
98
- console.log(
99
- "complete:",
100
- event.scannerId,
101
- "status=",
102
- event.result.status,
103
- "signals=",
104
- event.result.signals.length,
105
- );
106
- });
107
-
108
- try {
109
- // Manual operation
110
- await scannerModule.runOnce("alpha", "prescreener");
111
- await scannerModule.runOnce("alpha", "momentum");
112
-
113
- const signals = await scannerModule.querySignals({
114
- strategyId: "alpha",
115
- scannerId: "momentum",
116
- limit: 10,
117
- });
118
-
119
- console.log("persisted momentum signals =", signals.length);
120
-
121
- // Scheduled operation is also available:
122
- // await scannerModule.start();
123
- // ...
124
- // await scannerModule.stop();
125
- } finally {
126
- await scannerModule.stop();
127
- await rm(stateDir, { recursive: true, force: true });
128
- }
129
- }
130
-
131
- main().catch((error) => {
132
- console.error(error);
133
- process.exit(1);
134
- });