@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,208 +0,0 @@
1
- /**
2
- * Live MCP example — connects to the real Senpi MCP server and runs all
3
- * four built-in scanners against live market data.
4
- *
5
- * Requires two environment variables:
6
- *
7
- * export SENPI_API_KEY="your-api-key"
8
- * export SENPI_MCP_URL="https://mcp.prod.senpi.ai/mcp"
9
- * node examples/scanners-live-mcp.mjs
10
- */
11
-
12
- import { mkdtemp, rm } from "node:fs/promises";
13
- import { tmpdir } from "node:os";
14
- import { join } from "node:path";
15
- import { Client } from "@modelcontextprotocol/sdk/client/index.js";
16
- import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
17
- import {
18
- createScannerRuntimeModule,
19
- createSenpiScannerProviders,
20
- prescreenerScanner,
21
- oiTrackerScanner,
22
- momentumScanner,
23
- emergingMoversScanner,
24
- } from "../dist/scanners/index.js";
25
-
26
- // ─── Env guard ──────────────────────────────────────────────────────────────
27
-
28
- const SENPI_API_KEY = process.env.SENPI_API_KEY;
29
- const SENPI_MCP_URL = process.env.SENPI_MCP_URL;
30
-
31
- if (!SENPI_API_KEY || !SENPI_MCP_URL) {
32
- console.error(
33
- "Missing required env vars. Set SENPI_API_KEY and SENPI_MCP_URL before running.",
34
- );
35
- process.exit(1);
36
- }
37
-
38
- // ─── MCP → SenpiToolClient bridge ──────────────────────────────────────────
39
-
40
- /**
41
- * Wraps the MCP SDK `Client` so it satisfies the `SenpiToolClient` interface
42
- * expected by `createSenpiScannerProviders`.
43
- *
44
- * The MCP `callTool` returns `{ content: [{ type: "text", text: "…" }] }`.
45
- * This bridge parses the JSON from the first text content item back into
46
- * a plain object.
47
- */
48
- function createSenpiToolClient(mcpClient) {
49
- return {
50
- async callTool(name, args) {
51
- const result = await mcpClient.callTool({ name, arguments: args });
52
-
53
- if (result.isError) {
54
- const errorText =
55
- Array.isArray(result.content) &&
56
- result.content.length > 0 &&
57
- result.content[0].type === "text"
58
- ? result.content[0].text
59
- : JSON.stringify(result.content);
60
- throw new Error(`MCP tool "${name}" returned error: ${errorText}`);
61
- }
62
-
63
- // Prefer structuredContent when available.
64
- if (result.structuredContent !== undefined) {
65
- return result.structuredContent;
66
- }
67
-
68
- // Fall back to parsing the first text content item.
69
- if (Array.isArray(result.content) && result.content.length > 0) {
70
- const first = result.content[0];
71
- if (first.type === "text") {
72
- try {
73
- return JSON.parse(first.text);
74
- } catch {
75
- return first.text;
76
- }
77
- }
78
- }
79
-
80
- return result.content;
81
- },
82
- };
83
- }
84
-
85
- // ─── Main ───────────────────────────────────────────────────────────────────
86
-
87
- async function main() {
88
- // 1. Connect to the Senpi MCP server.
89
- console.log("Connecting to", SENPI_MCP_URL, "...");
90
- const transport = new StreamableHTTPClientTransport(new URL(SENPI_MCP_URL), {
91
- requestInit: {
92
- headers: { Authorization: `Bearer ${SENPI_API_KEY}` },
93
- },
94
- });
95
- const mcpClient = new Client({ name: "scanners-live-mcp", version: "0.0.1" });
96
- await mcpClient.connect(transport);
97
- console.log("Connected.\n");
98
-
99
- // 2. Wire up scanner providers backed by the real MCP client.
100
- const providers = createSenpiScannerProviders({
101
- client: createSenpiToolClient(mcpClient),
102
- logLevel: "info",
103
- maxCandleAssets: 5,
104
- candleIntervals: ["1h"],
105
- cacheTtlMs: { instruments: 0, smData: 0, candles: 0 },
106
- timeouts: {
107
- marketListInstruments: 30_000,
108
- marketGetAssetData: 30_000,
109
- leaderboardGetMarkets: 30_000,
110
- },
111
- retries: 2,
112
- });
113
-
114
- // 3. Create the runtime module.
115
- const stateDir = await mkdtemp(join(tmpdir(), "scanners-live-mcp-"));
116
- const mod = createScannerRuntimeModule({
117
- stateDir,
118
- scanners: [prescreenerScanner, oiTrackerScanner, momentumScanner, emergingMoversScanner],
119
- strategies: [
120
- {
121
- id: "live-demo",
122
- name: "Live Demo",
123
- scannerOverrides: {
124
- momentum: {
125
- config: {
126
- timeframe: "1h",
127
- minMovePct: 0.5,
128
- maxCandidates: 5,
129
- minDayVolume: 1_000_000,
130
- minSignalScore: 0.1,
131
- requirePrescreened: true,
132
- },
133
- },
134
- "emerging-movers": {
135
- config: {
136
- topN: 10,
137
- minRankJump: 1,
138
- minTopTradersGain: 0.05,
139
- minScansBeforeSignals: 2,
140
- historyLimit: 30,
141
- },
142
- },
143
- },
144
- },
145
- ],
146
- providers,
147
- });
148
-
149
- try {
150
- // 4. Run scanners in order.
151
- console.log("── prescreener ──");
152
- const prescreener = await mod.runOnce("live-demo", "prescreener");
153
- console.log(" status:", prescreener.status);
154
- console.log(" scanned:", prescreener.scannedCount);
155
- console.log(" summary:", prescreener.summary);
156
- console.log();
157
-
158
- console.log("── oi-tracker ──");
159
- const oiTracker = await mod.runOnce("live-demo", "oi-tracker");
160
- console.log(" status:", oiTracker.status);
161
- console.log(" scanned:", oiTracker.scannedCount);
162
- console.log(" summary:", oiTracker.summary);
163
- console.log();
164
-
165
- console.log("── momentum ──");
166
- const momentum = await mod.runOnce("live-demo", "momentum");
167
- console.log(" status:", momentum.status);
168
- console.log(" scanned:", momentum.scannedCount);
169
- console.log(" signals:", momentum.signals.length);
170
- for (const sig of momentum.signals) {
171
- console.log(` ${sig.direction} ${sig.asset} score=${sig.score.toFixed(2)} change=${sig.meta.changePct}%`);
172
- }
173
- console.log();
174
-
175
- console.log("── emerging-movers (run 1 — warmup) ──");
176
- const em1 = await mod.runOnce("live-demo", "emerging-movers");
177
- console.log(" status:", em1.status);
178
- console.log(" scanned:", em1.scannedCount);
179
- console.log();
180
-
181
- console.log("── emerging-movers (run 2 — can signal) ──");
182
- const em2 = await mod.runOnce("live-demo", "emerging-movers");
183
- console.log(" status:", em2.status);
184
- console.log(" scanned:", em2.scannedCount);
185
- console.log(" signals:", em2.signals.length);
186
- for (const sig of em2.signals) {
187
- console.log(` ${sig.direction} ${sig.asset} score=${sig.score.toFixed(2)} jump=${sig.meta.jump}`);
188
- }
189
- console.log();
190
-
191
- // 5. Query persisted signals across all scanners.
192
- const allSignals = await mod.querySignals({ strategyId: "live-demo" });
193
- console.log("── querySignals ──");
194
- console.log(" total persisted:", allSignals.length);
195
- for (const sig of allSignals) {
196
- console.log(` [${sig.scannerId}] ${sig.direction} ${sig.asset} score=${sig.score.toFixed(2)}`);
197
- }
198
- } finally {
199
- await mod.stop();
200
- await transport.close();
201
- await rm(stateDir, { recursive: true, force: true });
202
- }
203
- }
204
-
205
- main().catch((error) => {
206
- console.error(error);
207
- process.exit(1);
208
- });
@@ -1,165 +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/scanners/index.js";
9
-
10
- function createInstruments() {
11
- return [
12
- {
13
- name: "BTC",
14
- isDelisted: false,
15
- maxLeverage: 10,
16
- context: {
17
- markPx: 104,
18
- prevDayPx: 100,
19
- midPx: 104,
20
- dayNtlVlm: 70_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: 102.5,
31
- prevDayPx: 100,
32
- midPx: 102.5,
33
- dayNtlVlm: 50_000_000,
34
- openInterest: 1_200_000_000,
35
- funding: 0.001,
36
- },
37
- },
38
- ];
39
- }
40
-
41
- function createCandles() {
42
- return {
43
- BTC: {
44
- candles: {
45
- "1h": [
46
- {
47
- timestamp: 1,
48
- open: 100,
49
- high: 102,
50
- low: 99,
51
- close: 100,
52
- volume: 1200,
53
- },
54
- {
55
- timestamp: 2,
56
- open: 100,
57
- high: 105,
58
- low: 100,
59
- close: 104,
60
- volume: 1400,
61
- },
62
- ],
63
- },
64
- },
65
- ETH: {
66
- candles: {
67
- "1h": [
68
- {
69
- timestamp: 1,
70
- open: 100,
71
- high: 101,
72
- low: 99,
73
- close: 100,
74
- volume: 900,
75
- },
76
- {
77
- timestamp: 2,
78
- open: 100,
79
- high: 103,
80
- low: 100,
81
- close: 102.5,
82
- volume: 1100,
83
- },
84
- ],
85
- },
86
- },
87
- };
88
- }
89
-
90
- async function main() {
91
- const stateDir = await mkdtemp(join(tmpdir(), "scanners-example-multi-"));
92
-
93
- const module = createScannerRuntimeModule({
94
- stateDir,
95
- scanners: [prescreenerScanner, momentumScanner],
96
- strategies: [
97
- {
98
- id: "alpha",
99
- name: "Alpha",
100
- scannerOverrides: {
101
- momentum: {
102
- config: {
103
- timeframe: "1h",
104
- minMovePct: 3.5,
105
- maxCandidates: 10,
106
- minDayVolume: 1_000_000,
107
- minSignalScore: 0.2,
108
- requirePrescreened: true,
109
- },
110
- },
111
- },
112
- },
113
- {
114
- id: "beta",
115
- name: "Beta",
116
- scannerOverrides: {
117
- momentum: {
118
- config: {
119
- timeframe: "1h",
120
- minMovePct: 1.5,
121
- maxCandidates: 10,
122
- minDayVolume: 1_000_000,
123
- minSignalScore: 0.2,
124
- requirePrescreened: true,
125
- },
126
- },
127
- },
128
- },
129
- ],
130
- providers: {
131
- getInstruments: async () => createInstruments(),
132
- getCandles: async () => createCandles(),
133
- },
134
- });
135
-
136
- try {
137
- await module.runOnce("alpha", "prescreener");
138
- await module.runOnce("beta", "prescreener");
139
-
140
- const alphaMomentum = await module.runOnce("alpha", "momentum");
141
- const betaMomentum = await module.runOnce("beta", "momentum");
142
-
143
- const alphaSignals = await module.querySignals({
144
- strategyId: "alpha",
145
- scannerId: "momentum",
146
- });
147
- const betaSignals = await module.querySignals({
148
- strategyId: "beta",
149
- scannerId: "momentum",
150
- });
151
-
152
- console.log("multi-strategy: alpha momentum signals =", alphaMomentum.signals.length);
153
- console.log("multi-strategy: beta momentum signals =", betaMomentum.signals.length);
154
- console.log("multi-strategy: alpha queried signals =", alphaSignals.length);
155
- console.log("multi-strategy: beta queried signals =", betaSignals.length);
156
- } finally {
157
- await module.stop();
158
- await rm(stateDir, { recursive: true, force: true });
159
- }
160
- }
161
-
162
- main().catch((error) => {
163
- console.error(error);
164
- process.exit(1);
165
- });
@@ -1,225 +0,0 @@
1
- /**
2
- * Position-tracker E2E example — connects to the real Senpi MCP server,
3
- * fetches clearing house state for a strategy wallet, and runs the
4
- * position-tracker scanner to detect open positions and deltas.
5
- *
6
- * Runs 3 iterations to showcase the full lifecycle:
7
- * 1. First run — all current positions appear as POSITION_OPENED deltas.
8
- * 2. Second run — no deltas (positions unchanged between scans).
9
- * 3. Third run — same as second (steady-state heartbeat).
10
- *
11
- * Requires environment variables:
12
- *
13
- * export SENPI_API_KEY="your-api-key"
14
- * export SENPI_MCP_URL="https://mcp.prod.senpi.ai/mcp"
15
- *
16
- * Optionally set STRATEGY_ADDRESS to override the default wallet:
17
- *
18
- * export STRATEGY_ADDRESS="0x..."
19
- *
20
- * Usage:
21
- *
22
- * npm run build
23
- * node examples/scanners-position-tracker-e2e.mjs
24
- */
25
-
26
- import { mkdtemp, rm } from "node:fs/promises";
27
- import { tmpdir } from "node:os";
28
- import { join } from "node:path";
29
- import { Client } from "@modelcontextprotocol/sdk/client/index.js";
30
- import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
31
- import {
32
- createScannerRuntimeModule,
33
- createSenpiScannerProviders,
34
- positionTrackerScanner,
35
- } from "../dist/scanners/index.js";
36
-
37
- // ─── Env guard ──────────────────────────────────────────────────────────────
38
-
39
- const SENPI_API_KEY = process.env.SENPI_API_KEY;
40
- const SENPI_MCP_URL = process.env.SENPI_MCP_URL;
41
- const STRATEGY_ADDRESS =
42
- process.env.STRATEGY_ADDRESS;
43
-
44
- if (!SENPI_API_KEY || !SENPI_MCP_URL || !STRATEGY_ADDRESS) {
45
- console.error(
46
- "Missing required env vars. Set SENPI_API_KEY, SENPI_MCP_URL, and STRATEGY_ADDRESS before running.\n" +
47
- " export SENPI_API_KEY='your-api-key'\n" +
48
- " export SENPI_MCP_URL='https://mcp.prod.senpi.ai/mcp'\n" +
49
- " export STRATEGY_ADDRESS='0x...'",
50
- );
51
- process.exit(1);
52
- }
53
-
54
- // ─── MCP → SenpiToolClient bridge ──────────────────────────────────────────
55
-
56
- function createSenpiToolClient(mcpClient) {
57
- return {
58
- async callTool(name, args) {
59
- const result = await mcpClient.callTool({ name, arguments: args });
60
-
61
- if (result.isError) {
62
- const errorText =
63
- Array.isArray(result.content) &&
64
- result.content.length > 0 &&
65
- result.content[0].type === "text"
66
- ? result.content[0].text
67
- : JSON.stringify(result.content);
68
- throw new Error(`MCP tool "${name}" returned error: ${errorText}`);
69
- }
70
-
71
- if (result.structuredContent !== undefined) {
72
- return result.structuredContent;
73
- }
74
-
75
- if (Array.isArray(result.content) && result.content.length > 0) {
76
- const first = result.content[0];
77
- if (first.type === "text") {
78
- try {
79
- return JSON.parse(first.text);
80
- } catch {
81
- return first.text;
82
- }
83
- }
84
- }
85
-
86
- return result.content;
87
- },
88
- };
89
- }
90
-
91
- // ─── Helpers ────────────────────────────────────────────────────────────────
92
-
93
- function printPositionSnapshot(snapshot, indent = " ") {
94
- console.log(
95
- `${indent}${snapshot.direction} ${snapshot.asset} on ${snapshot.dex}`,
96
- );
97
- console.log(
98
- `${indent} size: ${snapshot.size} entry: $${snapshot.entryPrice} leverage: ${snapshot.leverage}x (${snapshot.leverageType})`,
99
- );
100
- console.log(
101
- `${indent} margin: $${snapshot.margin.toFixed(2)} liqPrice: ${snapshot.liquidationPrice != null ? "$" + snapshot.liquidationPrice.toFixed(2) : "n/a"}`,
102
- );
103
- console.log(
104
- `${indent} uPnL: $${snapshot.unrealizedPnl.toFixed(4)} ROE: ${snapshot.roe.toFixed(2)}%`,
105
- );
106
- }
107
-
108
- function printDelta(signal) {
109
- const meta = signal.meta || {};
110
- console.log(
111
- ` [${signal.signalType}] ${meta.positionKey} sizeDelta=${meta.sizeDelta}`,
112
- );
113
- if (meta.current) {
114
- printPositionSnapshot(meta.current);
115
- }
116
- }
117
-
118
- // ─── Main ───────────────────────────────────────────────────────────────────
119
-
120
- async function main() {
121
- // 1. Connect to MCP.
122
- console.log("Connecting to", SENPI_MCP_URL, "...");
123
- const transport = new StreamableHTTPClientTransport(new URL(SENPI_MCP_URL), {
124
- requestInit: {
125
- headers: { Authorization: `Bearer ${SENPI_API_KEY}` },
126
- },
127
- });
128
- const mcpClient = new Client({
129
- name: "position-tracker-e2e",
130
- version: "0.0.1",
131
- });
132
- await mcpClient.connect(transport);
133
- console.log("Connected.\n");
134
-
135
- // 2. Create providers backed by the real MCP client.
136
- const providers = createSenpiScannerProviders({
137
- client: createSenpiToolClient(mcpClient),
138
- logLevel: "warn",
139
- cacheTtlMs: { instruments: 0, smData: 0, candles: 0 },
140
- retries: 2,
141
- });
142
-
143
- // 3. Create the scanner runtime module with position-tracker only.
144
- const stateDir = await mkdtemp(join(tmpdir(), "position-tracker-e2e-"));
145
- const mod = createScannerRuntimeModule({
146
- stateDir,
147
- scanners: [positionTrackerScanner],
148
- strategies: [{ id: STRATEGY_ADDRESS, name: "E2E Position Tracker" }],
149
- providers,
150
- });
151
-
152
- try {
153
- console.log(`Strategy address: ${STRATEGY_ADDRESS}\n`);
154
-
155
- // ── Run 1: first scan — all positions appear as POSITION_OPENED ─────
156
- console.log("── Run 1 (initial scan) ──");
157
- const run1 = await mod.runOnce(STRATEGY_ADDRESS, "position-tracker");
158
- console.log(" status:", run1.status);
159
- console.log(" positionCount:", run1.summary?.positionCount ?? 0);
160
- console.log(" deltaCount:", run1.summary?.deltaCount ?? 0);
161
- console.log(" signals:", run1.signals.length);
162
- if (run1.signals.length > 0) {
163
- console.log("\n Deltas:");
164
- for (const sig of run1.signals) {
165
- printDelta(sig);
166
- }
167
- }
168
- console.log();
169
-
170
- // ── Run 2: second scan — should be steady state (no deltas) ─────────
171
- console.log("── Run 2 (steady state) ──");
172
- const run2 = await mod.runOnce(STRATEGY_ADDRESS, "position-tracker");
173
- console.log(" status:", run2.status);
174
- console.log(" positionCount:", run2.summary?.positionCount ?? 0);
175
- console.log(" deltaCount:", run2.summary?.deltaCount ?? 0);
176
- console.log(" signals:", run2.signals.length);
177
- if (run2.signals.length > 0) {
178
- console.log("\n Unexpected deltas:");
179
- for (const sig of run2.signals) {
180
- printDelta(sig);
181
- }
182
- } else {
183
- console.log(" (no deltas — positions unchanged, as expected)");
184
- }
185
- console.log();
186
-
187
- // ── Run 3: third scan — still steady state ──────────────────────────
188
- console.log("── Run 3 (steady state) ──");
189
- const run3 = await mod.runOnce(STRATEGY_ADDRESS, "position-tracker");
190
- console.log(" status:", run3.status);
191
- console.log(" positionCount:", run3.summary?.positionCount ?? 0);
192
- console.log(" deltaCount:", run3.summary?.deltaCount ?? 0);
193
- console.log(" signals:", run3.signals.length);
194
- if (run3.signals.length > 0) {
195
- console.log("\n Unexpected deltas:");
196
- for (const sig of run3.signals) {
197
- printDelta(sig);
198
- }
199
- } else {
200
- console.log(" (no deltas — positions unchanged, as expected)");
201
- }
202
- console.log();
203
-
204
- // ── Query all persisted signals ─────────────────────────────────────
205
- const allSignals = await mod.querySignals({
206
- strategyId: STRATEGY_ADDRESS,
207
- });
208
- console.log("── Persisted signals ──");
209
- console.log(" total:", allSignals.length);
210
- for (const sig of allSignals) {
211
- console.log(
212
- ` [${sig.scannerId}] ${sig.signalType} ${sig.asset} (${sig.direction})`,
213
- );
214
- }
215
- } finally {
216
- await mod.stop();
217
- await transport.close();
218
- await rm(stateDir, { recursive: true, force: true });
219
- }
220
- }
221
-
222
- main().catch((error) => {
223
- console.error(error);
224
- process.exit(1);
225
- });
@@ -1,96 +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
- buildCompositionFromScanners,
7
- oiTrackerScanner,
8
- } from "../dist/scanners/index.js";
9
-
10
- function createInstruments() {
11
- return [
12
- {
13
- name: "BTC",
14
- isDelisted: false,
15
- maxLeverage: 10,
16
- context: {
17
- markPx: 100,
18
- prevDayPx: 99,
19
- midPx: 100,
20
- dayNtlVlm: 60_000_000,
21
- openInterest: 2_200_000_000,
22
- funding: 0.001,
23
- },
24
- },
25
- ];
26
- }
27
-
28
- function sleep(ms) {
29
- return new Promise((resolve) => setTimeout(resolve, ms));
30
- }
31
-
32
- async function main() {
33
- const stateDir = await mkdtemp(join(tmpdir(), "scanners-example-scheduled-"));
34
- const events = {
35
- start: 0,
36
- complete: 0,
37
- skip: 0,
38
- error: 0,
39
- };
40
-
41
- const module = createScannerRuntimeModule({
42
- stateDir,
43
- ...buildCompositionFromScanners([oiTrackerScanner]),
44
- strategies: [
45
- {
46
- id: "alpha",
47
- name: "Alpha",
48
- scannerOverrides: {
49
- "oi-tracker": {
50
- intervalSeconds: 1,
51
- config: {
52
- minDayVolume: 1_000_000,
53
- maxHistory: 5,
54
- },
55
- },
56
- },
57
- },
58
- ],
59
- providers: {
60
- getInstruments: async () => createInstruments(),
61
- },
62
- });
63
-
64
- module.on("scanner:run:start", () => {
65
- events.start += 1;
66
- });
67
- module.on("scanner:run:complete", () => {
68
- events.complete += 1;
69
- });
70
- module.on("scanner:run:skip", () => {
71
- events.skip += 1;
72
- });
73
- module.on("scanner:run:error", () => {
74
- events.error += 1;
75
- });
76
-
77
- try {
78
- await module.start();
79
- await sleep(2200);
80
- await module.stop();
81
- await sleep(100);
82
-
83
- console.log("scheduled-events: start =", events.start);
84
- console.log("scheduled-events: complete =", events.complete);
85
- console.log("scheduled-events: skip =", events.skip);
86
- console.log("scheduled-events: error =", events.error);
87
- } finally {
88
- await module.stop();
89
- await rm(stateDir, { recursive: true, force: true });
90
- }
91
- }
92
-
93
- main().catch((error) => {
94
- console.error(error);
95
- process.exit(1);
96
- });