@senpi/runtime 1.0.95-dev.feat-dsl-backend-int.20260416023008 → 1.0.95-dev.runtime-phase-2.20260416194608

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 (285) hide show
  1. package/README.md +72 -0
  2. package/dist/actions/action-runtime-module.d.ts +55 -0
  3. package/dist/actions/action-runtime-module.d.ts.map +1 -0
  4. package/dist/actions/action-runtime-module.js +444 -0
  5. package/dist/actions/action-runtime-module.js.map +1 -0
  6. package/dist/actions/close-position/close-position.action.d.ts +1 -0
  7. package/dist/actions/close-position/close-position.action.d.ts.map +1 -1
  8. package/dist/actions/close-position/close-position.action.js +55 -20
  9. package/dist/actions/close-position/close-position.action.js.map +1 -1
  10. package/dist/actions/decision-engine.d.ts.map +1 -1
  11. package/dist/actions/decision-engine.js +5 -0
  12. package/dist/actions/decision-engine.js.map +1 -1
  13. package/dist/actions/llm-decision/shared.d.ts +1 -1
  14. package/dist/actions/llm-decision/shared.d.ts.map +1 -1
  15. package/dist/actions/llm-decision/shared.js +1 -1
  16. package/dist/actions/llm-decision/shared.js.map +1 -1
  17. package/dist/actions/notifications/formatter.d.ts +39 -0
  18. package/dist/actions/notifications/formatter.d.ts.map +1 -0
  19. package/dist/actions/notifications/formatter.js +68 -0
  20. package/dist/actions/notifications/formatter.js.map +1 -0
  21. package/dist/actions/notifications/index.d.ts +37 -0
  22. package/dist/actions/notifications/index.d.ts.map +1 -0
  23. package/dist/actions/notifications/index.js +89 -0
  24. package/dist/actions/notifications/index.js.map +1 -0
  25. package/dist/actions/open-position/open-position.action.d.ts +1 -0
  26. package/dist/actions/open-position/open-position.action.d.ts.map +1 -1
  27. package/dist/actions/open-position/open-position.action.js +132 -27
  28. package/dist/actions/open-position/open-position.action.js.map +1 -1
  29. package/dist/actions/open-position/resolve-margin.d.ts +22 -0
  30. package/dist/actions/open-position/resolve-margin.d.ts.map +1 -0
  31. package/dist/actions/open-position/resolve-margin.js +30 -0
  32. package/dist/actions/open-position/resolve-margin.js.map +1 -0
  33. package/dist/actions/position-tracker/position-tracker.action.d.ts.map +1 -1
  34. package/dist/actions/position-tracker/position-tracker.action.js +4 -1
  35. package/dist/actions/position-tracker/position-tracker.action.js.map +1 -1
  36. package/dist/actions/store/action-store.d.ts +45 -0
  37. package/dist/actions/store/action-store.d.ts.map +1 -0
  38. package/dist/actions/store/action-store.js +127 -0
  39. package/dist/actions/store/action-store.js.map +1 -0
  40. package/dist/actions/store/index.d.ts +11 -0
  41. package/dist/actions/store/index.d.ts.map +1 -0
  42. package/dist/actions/store/index.js +9 -0
  43. package/dist/actions/store/index.js.map +1 -0
  44. package/dist/actions/store/paths.d.ts +15 -0
  45. package/dist/actions/store/paths.d.ts.map +1 -0
  46. package/dist/actions/store/paths.js +29 -0
  47. package/dist/actions/store/paths.js.map +1 -0
  48. package/dist/actions/store/types.d.ts +114 -0
  49. package/dist/actions/store/types.d.ts.map +1 -0
  50. package/dist/actions/store/types.js +48 -0
  51. package/dist/actions/store/types.js.map +1 -0
  52. package/dist/actions/tracking-helpers.d.ts +13 -0
  53. package/dist/actions/tracking-helpers.d.ts.map +1 -0
  54. package/dist/actions/tracking-helpers.js +47 -0
  55. package/dist/actions/tracking-helpers.js.map +1 -0
  56. package/dist/actions/types.d.ts +8 -0
  57. package/dist/actions/types.d.ts.map +1 -1
  58. package/dist/cli/guide-commands.d.ts.map +1 -1
  59. package/dist/cli/guide-commands.js +105 -3
  60. package/dist/cli/guide-commands.js.map +1 -1
  61. package/dist/cli/senpi-commands.d.ts.map +1 -1
  62. package/dist/cli/senpi-commands.js +428 -1
  63. package/dist/cli/senpi-commands.js.map +1 -1
  64. package/dist/constants/order-types.d.ts +7 -0
  65. package/dist/constants/order-types.d.ts.map +1 -0
  66. package/dist/constants/order-types.js +6 -0
  67. package/dist/constants/order-types.js.map +1 -0
  68. package/dist/context/interpolate.d.ts +6 -2
  69. package/dist/context/interpolate.d.ts.map +1 -1
  70. package/dist/context/interpolate.js +6 -2
  71. package/dist/context/interpolate.js.map +1 -1
  72. package/dist/context/types.d.ts +8 -1
  73. package/dist/context/types.d.ts.map +1 -1
  74. package/dist/context/types.js +8 -1
  75. package/dist/context/types.js.map +1 -1
  76. package/dist/dsl/config/exit-block.d.ts +7 -0
  77. package/dist/dsl/config/exit-block.d.ts.map +1 -1
  78. package/dist/dsl/config/parse-plugin-config.d.ts.map +1 -1
  79. package/dist/dsl/config/parse-plugin-config.js +27 -1
  80. package/dist/dsl/config/parse-plugin-config.js.map +1 -1
  81. package/dist/dsl/config/unknown-keys.d.ts.map +1 -1
  82. package/dist/dsl/config/unknown-keys.js +3 -1
  83. package/dist/dsl/config/unknown-keys.js.map +1 -1
  84. package/dist/dsl/monitor/create-monitor.d.ts +4 -0
  85. package/dist/dsl/monitor/create-monitor.d.ts.map +1 -1
  86. package/dist/dsl/monitor/create-monitor.js +8 -5
  87. package/dist/dsl/monitor/create-monitor.js.map +1 -1
  88. package/dist/dsl/monitor/process-one-position.d.ts +4 -0
  89. package/dist/dsl/monitor/process-one-position.d.ts.map +1 -1
  90. package/dist/dsl/monitor/process-one-position.js +8 -2
  91. package/dist/dsl/monitor/process-one-position.js.map +1 -1
  92. package/dist/dsl/plugin/index.d.ts.map +1 -1
  93. package/dist/dsl/plugin/index.js +3 -1
  94. package/dist/dsl/plugin/index.js.map +1 -1
  95. package/dist/health/index.d.ts +5 -2
  96. package/dist/health/index.d.ts.map +1 -1
  97. package/dist/health/index.js +106 -6
  98. package/dist/health/index.js.map +1 -1
  99. package/dist/health/types.d.ts +102 -0
  100. package/dist/health/types.d.ts.map +1 -1
  101. package/dist/health/types.js +7 -1
  102. package/dist/health/types.js.map +1 -1
  103. package/dist/index.d.ts +2 -2
  104. package/dist/index.d.ts.map +1 -1
  105. package/dist/index.js +98 -1
  106. package/dist/index.js.map +1 -1
  107. package/dist/risk/guardrail.types.d.ts +53 -0
  108. package/dist/risk/guardrail.types.d.ts.map +1 -0
  109. package/dist/risk/guardrail.types.js +5 -0
  110. package/dist/risk/guardrail.types.js.map +1 -0
  111. package/dist/risk/index.d.ts +2 -4
  112. package/dist/risk/index.d.ts.map +1 -1
  113. package/dist/risk/index.js +2 -6
  114. package/dist/risk/index.js.map +1 -1
  115. package/dist/risk/risk-audit-log.d.ts +25 -0
  116. package/dist/risk/risk-audit-log.d.ts.map +1 -0
  117. package/dist/risk/risk-audit-log.js +30 -0
  118. package/dist/risk/risk-audit-log.js.map +1 -0
  119. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.d.ts +162 -0
  120. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.d.ts.map +1 -0
  121. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.js +285 -0
  122. package/dist/runtime/__tests__/helpers/runtime-gateway-harness.js.map +1 -0
  123. package/dist/runtime/create-actions.d.ts +6 -2
  124. package/dist/runtime/create-actions.d.ts.map +1 -1
  125. package/dist/runtime/create-actions.js +18 -7
  126. package/dist/runtime/create-actions.js.map +1 -1
  127. package/dist/runtime/create-scanner-module.d.ts +5 -0
  128. package/dist/runtime/create-scanner-module.d.ts.map +1 -1
  129. package/dist/runtime/create-scanner-module.js +12 -1
  130. package/dist/runtime/create-scanner-module.js.map +1 -1
  131. package/dist/runtime/load-runtime-config.d.ts +1 -1
  132. package/dist/runtime/load-runtime-config.d.ts.map +1 -1
  133. package/dist/runtime/load-runtime-config.js +37 -1
  134. package/dist/runtime/load-runtime-config.js.map +1 -1
  135. package/dist/runtime/map-strategies.d.ts +1 -1
  136. package/dist/runtime/map-strategies.d.ts.map +1 -1
  137. package/dist/runtime/map-strategies.js +38 -1
  138. package/dist/runtime/map-strategies.js.map +1 -1
  139. package/dist/runtime/risk-guard.d.ts +23 -2
  140. package/dist/runtime/risk-guard.d.ts.map +1 -1
  141. package/dist/runtime/risk-guard.js +441 -5
  142. package/dist/runtime/risk-guard.js.map +1 -1
  143. package/dist/runtime/run.d.ts +7 -0
  144. package/dist/runtime/run.d.ts.map +1 -1
  145. package/dist/runtime/run.js +3 -0
  146. package/dist/runtime/run.js.map +1 -1
  147. package/dist/runtime/runtime-schema.d.ts +1169 -24
  148. package/dist/runtime/runtime-schema.d.ts.map +1 -1
  149. package/dist/runtime/runtime-schema.js +105 -2
  150. package/dist/runtime/runtime-schema.js.map +1 -1
  151. package/dist/runtime/runtime.d.ts +26 -0
  152. package/dist/runtime/runtime.d.ts.map +1 -1
  153. package/dist/runtime/runtime.js +192 -6
  154. package/dist/runtime/runtime.js.map +1 -1
  155. package/dist/runtime/scanner-composition.d.ts +10 -0
  156. package/dist/runtime/scanner-composition.d.ts.map +1 -1
  157. package/dist/runtime/scanner-composition.js +10 -0
  158. package/dist/runtime/scanner-composition.js.map +1 -1
  159. package/dist/runtime/scanner-registry.d.ts +39 -1
  160. package/dist/runtime/scanner-registry.d.ts.map +1 -1
  161. package/dist/runtime/scanner-registry.js +105 -2
  162. package/dist/runtime/scanner-registry.js.map +1 -1
  163. package/dist/runtime/state-layout.d.ts +2 -0
  164. package/dist/runtime/state-layout.d.ts.map +1 -1
  165. package/dist/runtime/state-layout.js +1 -0
  166. package/dist/runtime/state-layout.js.map +1 -1
  167. package/dist/runtime/validate-action-prompts.d.ts +30 -0
  168. package/dist/runtime/validate-action-prompts.d.ts.map +1 -0
  169. package/dist/runtime/validate-action-prompts.js +110 -0
  170. package/dist/runtime/validate-action-prompts.js.map +1 -0
  171. package/dist/scanners/__tests__/test-helpers.d.ts +10 -0
  172. package/dist/scanners/__tests__/test-helpers.d.ts.map +1 -1
  173. package/dist/scanners/__tests__/test-helpers.js +52 -0
  174. package/dist/scanners/__tests__/test-helpers.js.map +1 -1
  175. package/dist/scanners/engine/engine.d.ts +37 -0
  176. package/dist/scanners/engine/engine.d.ts.map +1 -1
  177. package/dist/scanners/engine/engine.js +132 -14
  178. package/dist/scanners/engine/engine.js.map +1 -1
  179. package/dist/scanners/engine/result-builder.d.ts +16 -0
  180. package/dist/scanners/engine/result-builder.d.ts.map +1 -1
  181. package/dist/scanners/engine/result-builder.js +22 -0
  182. package/dist/scanners/engine/result-builder.js.map +1 -1
  183. package/dist/scanners/engine/strategy-registry.d.ts +2 -0
  184. package/dist/scanners/engine/strategy-registry.d.ts.map +1 -1
  185. package/dist/scanners/engine/strategy-registry.js +5 -1
  186. package/dist/scanners/engine/strategy-registry.js.map +1 -1
  187. package/dist/scanners/external-scanner-receiver.d.ts +118 -0
  188. package/dist/scanners/external-scanner-receiver.d.ts.map +1 -0
  189. package/dist/scanners/external-scanner-receiver.js +266 -0
  190. package/dist/scanners/external-scanner-receiver.js.map +1 -0
  191. package/dist/scanners/implementations/external-scanner.d.ts +17 -0
  192. package/dist/scanners/implementations/external-scanner.d.ts.map +1 -0
  193. package/dist/scanners/implementations/external-scanner.js +51 -0
  194. package/dist/scanners/implementations/external-scanner.js.map +1 -0
  195. package/dist/scanners/implementations/index.d.ts +1 -0
  196. package/dist/scanners/implementations/index.d.ts.map +1 -1
  197. package/dist/scanners/implementations/index.js +1 -0
  198. package/dist/scanners/implementations/index.js.map +1 -1
  199. package/dist/scanners/implementations/position-tracker.d.ts.map +1 -1
  200. package/dist/scanners/implementations/position-tracker.js +3 -1
  201. package/dist/scanners/implementations/position-tracker.js.map +1 -1
  202. package/dist/scanners/index.d.ts +4 -1
  203. package/dist/scanners/index.d.ts.map +1 -1
  204. package/dist/scanners/index.js +2 -0
  205. package/dist/scanners/index.js.map +1 -1
  206. package/dist/scanners/protocol/scanner.d.ts +3 -1
  207. package/dist/scanners/protocol/scanner.d.ts.map +1 -1
  208. package/dist/scanners/providers/client.d.ts.map +1 -1
  209. package/dist/scanners/providers/client.js +0 -8
  210. package/dist/scanners/providers/client.js.map +1 -1
  211. package/dist/scanners/runtime-module.d.ts +10 -0
  212. package/dist/scanners/runtime-module.d.ts.map +1 -1
  213. package/dist/scanners/runtime-module.js +19 -3
  214. package/dist/scanners/runtime-module.js.map +1 -1
  215. package/dist/scanners/scanner-definition.d.ts +12 -1
  216. package/dist/scanners/scanner-definition.d.ts.map +1 -1
  217. package/dist/scanners/types.d.ts +3 -0
  218. package/dist/scanners/types.d.ts.map +1 -1
  219. package/dist/scanners/types.js.map +1 -1
  220. package/dist/scripts/run-dsl-standalone-live.js +1 -1
  221. package/dist/scripts/run-dsl-standalone-live.js.map +1 -1
  222. package/dist/scripts/run-dsl-standalone-mock.js +1 -1
  223. package/dist/scripts/run-dsl-standalone-mock.js.map +1 -1
  224. package/dist/senpi/client.d.ts +27 -2
  225. package/dist/senpi/client.d.ts.map +1 -1
  226. package/dist/senpi/client.js +74 -1
  227. package/dist/senpi/client.js.map +1 -1
  228. package/dist/senpi/index.d.ts +1 -1
  229. package/dist/senpi/index.d.ts.map +1 -1
  230. package/dist/senpi/types.d.ts +68 -0
  231. package/dist/senpi/types.d.ts.map +1 -1
  232. package/dist/strategy/strategy-state.d.ts +4 -1
  233. package/dist/strategy/strategy-state.d.ts.map +1 -1
  234. package/dist/strategy/strategy-state.js +7 -2
  235. package/dist/strategy/strategy-state.js.map +1 -1
  236. package/dist/tracking/constants.d.ts +24 -0
  237. package/dist/tracking/constants.d.ts.map +1 -0
  238. package/dist/tracking/constants.js +46 -0
  239. package/dist/tracking/constants.js.map +1 -0
  240. package/dist/tracking/index.d.ts +12 -0
  241. package/dist/tracking/index.d.ts.map +1 -0
  242. package/dist/tracking/index.js +8 -0
  243. package/dist/tracking/index.js.map +1 -0
  244. package/dist/tracking/tracker.d.ts +22 -0
  245. package/dist/tracking/tracker.d.ts.map +1 -0
  246. package/dist/tracking/tracker.js +44 -0
  247. package/dist/tracking/tracker.js.map +1 -0
  248. package/dist/tracking/tracking-handler.d.ts +12 -0
  249. package/dist/tracking/tracking-handler.d.ts.map +1 -0
  250. package/dist/tracking/tracking-handler.js +148 -0
  251. package/dist/tracking/tracking-handler.js.map +1 -0
  252. package/dist/tracking/transport.d.ts +35 -0
  253. package/dist/tracking/transport.d.ts.map +1 -0
  254. package/dist/tracking/transport.js +117 -0
  255. package/dist/tracking/transport.js.map +1 -0
  256. package/dist/tracking/types.d.ts +21 -0
  257. package/dist/tracking/types.d.ts.map +1 -0
  258. package/dist/tracking/types.js +6 -0
  259. package/dist/tracking/types.js.map +1 -0
  260. package/dist/types/action.d.ts +13 -2
  261. package/dist/types/action.d.ts.map +1 -1
  262. package/dist/types/dsl/index.d.ts +3 -0
  263. package/dist/types/dsl/index.d.ts.map +1 -1
  264. package/dist/types/strategy.d.ts +9 -3
  265. package/dist/types/strategy.d.ts.map +1 -1
  266. package/dist/utils/logger.d.ts +1 -0
  267. package/dist/utils/logger.d.ts.map +1 -1
  268. package/dist/utils/logger.js +19 -1
  269. package/dist/utils/logger.js.map +1 -1
  270. package/dist/utils/resolve-order-type.d.ts +5 -0
  271. package/dist/utils/resolve-order-type.d.ts.map +1 -0
  272. package/dist/utils/resolve-order-type.js +29 -0
  273. package/dist/utils/resolve-order-type.js.map +1 -0
  274. package/examples/strategies/dsl-showcase.yaml +7 -2
  275. package/examples/strategies/dsl.yaml +5 -1
  276. package/examples/strategies/fox-minimal-loosened.yaml +18 -3
  277. package/examples/strategies/fox-minimal.yaml +25 -3
  278. package/examples/strategies/minimal.yaml +4 -2
  279. package/examples/strategies/momentum/how-it-works.md +47 -0
  280. package/examples/strategies/momentum/momentum-guarded.yaml +161 -0
  281. package/examples/strategies/risk-showcase.yaml +93 -0
  282. package/examples/strategies/viper.yaml +11 -3
  283. package/examples/strategies/wolf.yaml +11 -3
  284. package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +12 -4
  285. package/package.json +4 -4
@@ -1,7 +1,9 @@
1
1
  /**
2
2
  * Resolve recipe `strategy` to a single StrategyConfig.
3
- * Address = wallet (env-resolved). Coerces budget and numeric fields from strings.
3
+ * Address = wallet (env-resolved). Coerces numeric fields from strings.
4
4
  */
5
+ import { createLogger } from "../utils/logger.js";
6
+ const logger = createLogger("[senpi-core][strategy-config]");
5
7
  const VALID_TRADING_RISKS = ['conservative', 'moderate', 'aggressive'];
6
8
  function coerceNumber(v) {
7
9
  if (typeof v === "number" && Number.isFinite(v))
@@ -36,6 +38,19 @@ export function resolveStrategyConfig(recipeConfig) {
36
38
  if (typeof entry.margin_per_slot === "number" || (typeof entry.margin_per_slot === "string" && entry.margin_per_slot !== "")) {
37
39
  strategyConfig.marginPerSlot = coerceNumber(entry.margin_per_slot);
38
40
  }
41
+ if (typeof entry.margin_pct === "number") {
42
+ strategyConfig.marginPct = entry.margin_pct;
43
+ }
44
+ if (strategyConfig.marginPct != null && strategyConfig.marginPerSlot != null) {
45
+ logger.warn("Both margin_pct and margin_per_slot are set. margin_pct will take priority; margin_per_slot will be ignored.");
46
+ }
47
+ if (strategyConfig.marginPct != null && strategyConfig.slots > 1) {
48
+ const totalPct = strategyConfig.marginPct * strategyConfig.slots;
49
+ if (totalPct > 100) {
50
+ logger.warn(`margin_pct (${strategyConfig.marginPct}%) × slots (${strategyConfig.slots}) = ${totalPct}% which exceeds 100%. ` +
51
+ "Later slots may fail to open due to insufficient withdrawable balance.");
52
+ }
53
+ }
39
54
  if (typeof entry.default_leverage === "number") {
40
55
  strategyConfig.defaultLeverage = entry.default_leverage;
41
56
  }
@@ -54,6 +69,28 @@ export function resolveStrategyConfig(recipeConfig) {
54
69
  if (typeof entry.enabled === "boolean") {
55
70
  strategyConfig.enabled = entry.enabled;
56
71
  }
72
+ const riskBlock = recipeConfig.risk;
73
+ if (riskBlock?.guard_rails) {
74
+ const gr = riskBlock.guard_rails;
75
+ const budgetUsd = strategyConfig.budget ?? 0;
76
+ strategyConfig.guardRails = {
77
+ dailyLossLimit: typeof gr.daily_loss_limit_pct === "number"
78
+ ? (gr.daily_loss_limit_pct / 100) * budgetUsd
79
+ : undefined,
80
+ dailyLossLimitPct: gr.daily_loss_limit_pct,
81
+ bypassMaxEntriesPerDayOnProfit: gr.bypass_max_entries_per_day_on_profit ?? false,
82
+ drawdownHaltPct: gr.drawdown_halt_pct,
83
+ drawdownResetOnDayRollover: gr.drawdown_reset_on_day_rollover ?? false,
84
+ perAssetCooldownMinutes: gr.per_asset_cooldown_minutes,
85
+ ...(typeof gr.max_entries_per_day === "number" ? { maxEntriesPerDay: gr.max_entries_per_day } : {}),
86
+ ...(typeof gr.max_consecutive_losses === "number" ? { maxConsecutiveLosses: gr.max_consecutive_losses } : {}),
87
+ ...(typeof gr.cooldown_minutes === "number" ? { cooldownMinutes: gr.cooldown_minutes } : {}),
88
+ };
89
+ if (typeof strategyConfig.guardRails.dailyLossLimit === "number") {
90
+ strategyConfig.dailyLossLimit = strategyConfig.guardRails.dailyLossLimit;
91
+ }
92
+ strategyConfig.dataRetentionHours = Math.min(168, Math.max(1, riskBlock.data_retention_hours ?? 48));
93
+ }
57
94
  return strategyConfig;
58
95
  }
59
96
  /** @deprecated Use resolveStrategyConfig instead. */
@@ -1 +1 @@
1
- {"version":3,"file":"map-strategies.js","sourceRoot":"","sources":["../../src/runtime/map-strategies.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"map-strategies.js","sourceRoot":"","sources":["../../src/runtime/map-strategies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,YAAY,CAAC,+BAA+B,CAAC,CAAC;AAE7D,MAAM,mBAAmB,GAAkB,CAAC,cAAc,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAEtF,SAAS,YAAY,CAAC,CAAU;IAC9B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAA2B;IAC/D,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,MAAM,WAAW,GAAgB,mBAAmB,CAAC,QAAQ,CAAC,OAAsB,CAAC;QACnF,CAAC,CAAE,OAAuB;QAC1B,CAAC,CAAC,UAAU,CAAC;IACf,MAAM,cAAc,GAAmB;QACrC,OAAO;QACP,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;QAClC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QACrC,WAAW;KACZ,CAAC;IACF,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,IAAI,KAAK,CAAC,eAAe,KAAK,EAAE,CAAC,EAAE,CAAC;QAC7H,cAAc,CAAC,aAAa,GAAG,YAAY,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACzC,cAAc,CAAC,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC;IAC9C,CAAC;IACD,IAAI,cAAc,CAAC,SAAS,IAAI,IAAI,IAAI,cAAc,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;QAC7E,MAAM,CAAC,IAAI,CACT,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IACD,IAAI,cAAc,CAAC,SAAS,IAAI,IAAI,IAAI,cAAc,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC;QACjE,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CACT,eAAe,cAAc,CAAC,SAAS,eAAe,cAAc,CAAC,KAAK,OAAO,QAAQ,wBAAwB;gBACjH,wEAAwE,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QAC/C,cAAc,CAAC,eAAe,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,oBAAoB,IAAI,IAAI,IAAI,OAAO,KAAK,CAAC,oBAAoB,KAAK,QAAQ,EAAE,CAAC;QACzF,MAAM,EAAE,GAAG,KAAK,CAAC,oBAA+C,CAAC;QACjE,MAAM,WAAW,GAAyC,EAAE,CAAC;QAC7D,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;YACtC,IAAI,OAAO,EAAE,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAChC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAW,CAAC;YACvC,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,cAAc,CAAC,mBAAmB,GAAG,WAAW,CAAC;QACnD,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACvC,cAAc,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACzC,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC;IACpC,IAAI,SAAS,EAAE,WAAW,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,SAAS,CAAC,WAAsC,CAAC;QAC5D,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,IAAI,CAAC,CAAC;QAE7C,cAAc,CAAC,UAAU,GAAG;YAC1B,cAAc,EACZ,OAAO,EAAE,CAAC,oBAAoB,KAAK,QAAQ;gBACzC,CAAC,CAAC,CAAC,EAAE,CAAC,oBAAoB,GAAG,GAAG,CAAC,GAAG,SAAS;gBAC7C,CAAC,CAAC,SAAS;YACf,iBAAiB,EAAE,EAAE,CAAC,oBAA0C;YAChE,8BAA8B,EAAG,EAAE,CAAC,oCAAgD,IAAI,KAAK;YAC7F,eAAe,EAAE,EAAE,CAAC,iBAAuC;YAC3D,0BAA0B,EAAG,EAAE,CAAC,8BAA0C,IAAI,KAAK;YACnF,uBAAuB,EAAE,EAAE,CAAC,0BAAgD;YAC5E,GAAG,CAAC,OAAO,EAAE,CAAC,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnG,GAAG,CAAC,OAAO,EAAE,CAAC,sBAAsB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,EAAE,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7G,GAAG,CAAC,OAAO,EAAE,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7F,CAAC;QACF,IAAI,OAAQ,cAAc,CAAC,UAA0C,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;YAClG,cAAc,CAAC,cAAc,GAAI,cAAc,CAAC,UAA0C,CAAC,cAAc,CAAC;QAC5G,CAAC;QACD,cAAc,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,CAAC;IACvG,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,qBAAqB,CAAC,YAA2B;IAC/D,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACnD,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC"}
@@ -1,6 +1,27 @@
1
1
  /**
2
- * RiskGuard: gate check and record entry (stub - gate always OPEN, record no-op).
2
+ * RiskGuard: real-time stateless gate evaluation via MCP API calls.
3
+ *
4
+ * Gates 1–2 use `strategy_get_pnl_and_account_value_history` (today_snapshot); gates 3–5 use
5
+ * `discovery_get_trader_history` and/or `discovery_get_trader_state` with verdicts computed locally.
6
+ * Every checkGate call logs the decision to the audit log (write-only).
7
+ * If any risk API call fails, the gate is CLOSED (fail-closed).
8
+ *
9
+ * Supports two modes:
10
+ * - Default (short-circuit): returns on first non-OPEN gate.
11
+ * - evaluateAll: evaluates every configured gate, returns per-gate details.
3
12
  */
4
13
  import type { RiskGuard as IRiskGuard } from "../types/action.js";
5
- export declare function createRiskGuard(): IRiskGuard;
14
+ import type { NotificationService } from "../types/notification.js";
15
+ import type { StrategyConfig } from "../types/strategy.js";
16
+ import type { SenpiClient } from "../senpi/client.js";
17
+ import type { RiskAuditLog } from "../risk/risk-audit-log.js";
18
+ export declare function createRiskGuardStub(): IRiskGuard;
19
+ export interface RiskGuardConfig {
20
+ senpi: SenpiClient;
21
+ notifications: NotificationService;
22
+ strategies: Map<string, StrategyConfig>;
23
+ strategyNames?: Record<string, string>;
24
+ auditLog?: RiskAuditLog;
25
+ }
26
+ export declare function createRiskGuard(config: RiskGuardConfig): IRiskGuard;
6
27
  //# sourceMappingURL=risk-guard.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"risk-guard.d.ts","sourceRoot":"","sources":["../../src/runtime/risk-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAmB,SAAS,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEnF,wBAAgB,eAAe,IAAI,UAAU,CAS5C"}
1
+ {"version":3,"file":"risk-guard.d.ts","sourceRoot":"","sources":["../../src/runtime/risk-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAuD,SAAS,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACvH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,wBAAgB,mBAAmB,IAAI,UAAU,CAchD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,aAAa,EAAE,mBAAmB,CAAC;IACnC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AA0CD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU,CAobnE"}
@@ -1,13 +1,449 @@
1
1
  /**
2
- * RiskGuard: gate check and record entry (stub - gate always OPEN, record no-op).
2
+ * RiskGuard: real-time stateless gate evaluation via MCP API calls.
3
+ *
4
+ * Gates 1–2 use `strategy_get_pnl_and_account_value_history` (today_snapshot); gates 3–5 use
5
+ * `discovery_get_trader_history` and/or `discovery_get_trader_state` with verdicts computed locally.
6
+ * Every checkGate call logs the decision to the audit log (write-only).
7
+ * If any risk API call fails, the gate is CLOSED (fail-closed).
8
+ *
9
+ * Supports two modes:
10
+ * - Default (short-circuit): returns on first non-OPEN gate.
11
+ * - evaluateAll: evaluates every configured gate, returns per-gate details.
3
12
  */
4
- export function createRiskGuard() {
13
+ import { RISK_GATE_NAMES } from "../health/types.js";
14
+ import { isRecord } from "../utils/response.js";
15
+ import { createLogger } from "../utils/logger.js";
16
+ const logger = createLogger("[runtime][risk-guard]");
17
+ export function createRiskGuardStub() {
5
18
  return {
6
- checkGate(_address, _guardRails) {
19
+ async checkGate(_address, opts) {
20
+ if (opts?.evaluateAll) {
21
+ return { gate: "OPEN", gates: [] };
22
+ }
7
23
  return { gate: "OPEN" };
8
24
  },
9
- recordEntry(_address, _guardRails) {
10
- // no-op
25
+ async getGateForStrategies(addresses) {
26
+ const out = {};
27
+ for (const addr of addresses)
28
+ out[addr] = { gate: "OPEN" };
29
+ return out;
30
+ },
31
+ };
32
+ }
33
+ function extractVerdict(raw) {
34
+ if (!isRecord(raw))
35
+ return null;
36
+ const envelope = raw;
37
+ if (envelope.success === false)
38
+ return null;
39
+ const data = isRecord(envelope.data) ? envelope.data : envelope;
40
+ return data;
41
+ }
42
+ function makeEval(gateId, source, overrides) {
43
+ return {
44
+ gateId,
45
+ gateName: RISK_GATE_NAMES[gateId],
46
+ status: "OPEN",
47
+ evaluationOk: true,
48
+ fallbackApplied: false,
49
+ failureKind: "none",
50
+ source,
51
+ ...overrides,
52
+ };
53
+ }
54
+ function deriveEffective(gates) {
55
+ let gate = "OPEN";
56
+ let reason;
57
+ for (const g of gates) {
58
+ if (g.status === "CLOSED") {
59
+ return { gate: "CLOSED", reason: g.reason };
60
+ }
61
+ if (g.status === "COOLDOWN" && gate === "OPEN") {
62
+ gate = "COOLDOWN";
63
+ reason = g.reason;
64
+ }
65
+ }
66
+ return { gate, reason };
67
+ }
68
+ export function createRiskGuard(config) {
69
+ const prevGateState = new Map();
70
+ function strategyKey(address) {
71
+ return config.strategyNames?.[address] ?? `${address.slice(0, 6)}...${address.slice(-4)}`;
72
+ }
73
+ async function logAndNotify(address, result, source, candidateAsset, evaluations) {
74
+ const sk = strategyKey(address);
75
+ const curr = `${result.gate}:${result.reason ?? ""}`;
76
+ const stateKey = candidateAsset ? `${address}:${candidateAsset}` : address;
77
+ const prev = prevGateState.get(stateKey);
78
+ if (result.gate !== "OPEN") {
79
+ logger.info("RiskGuard checkGate: gate not OPEN", {
80
+ address: sk,
81
+ gate: result.gate,
82
+ reason: result.reason,
83
+ candidateAsset,
84
+ });
85
+ }
86
+ if (prev !== curr) {
87
+ prevGateState.set(stateKey, curr);
88
+ /*
89
+ Commenting out the notifications for now to avoid spamming the user.
90
+ We need to make sure same notificaions are not sent multiple times.
91
+ Will address in a future PR.
92
+ */
93
+ // if (result.gate === "CLOSED") {
94
+ // config.notifications.notify(`GATE CLOSED [${sk}]: ${result.reason ?? "unknown"}`).catch(() => {});
95
+ // } else if (result.gate === "COOLDOWN") {
96
+ // config.notifications.notify(`GATE COOLDOWN [${sk}]: ${result.reason ?? "unknown"}`).catch(() => {});
97
+ // } else if (prev && (prev.startsWith("CLOSED") || prev.startsWith("COOLDOWN"))) {
98
+ // config.notifications.notify(`GATE OPEN [${sk}]: previous gate cleared`).catch(() => {});
99
+ // }
100
+ }
101
+ if (config.auditLog) {
102
+ await config.auditLog.append({
103
+ ts: new Date().toISOString(),
104
+ event: "gate_check",
105
+ address,
106
+ source,
107
+ meta: {
108
+ gate: result.gate,
109
+ reason: result.reason ?? null,
110
+ candidateAsset: candidateAsset ?? null,
111
+ },
112
+ evaluations: evaluations?.map((e) => ({
113
+ guardrail: e.gateId,
114
+ result: e.status === "OPEN" || e.status === "N_A" ? "pass" : e.status,
115
+ reason: e.reason,
116
+ evaluationOk: e.evaluationOk,
117
+ fallbackApplied: e.fallbackApplied,
118
+ failureKind: e.failureKind,
119
+ })),
120
+ }).catch(() => { });
121
+ }
122
+ }
123
+ // ── Per-gate evaluation helpers ──────────────────────────────────
124
+ async function evalDailyLossHalt(guardRails, snap, source, snapFailed) {
125
+ if (snapFailed || !snap) {
126
+ return makeEval("daily_loss_halt", source, {
127
+ status: "CLOSED",
128
+ reason: "Risk snapshot unavailable — fail-closed",
129
+ evaluationOk: false,
130
+ fallbackApplied: true,
131
+ failureKind: snapFailed ? "transport" : "empty_data",
132
+ });
133
+ }
134
+ const delta = snap.pnl.delta_since_open;
135
+ const avAtOpen = snap.account_value.at_day_open;
136
+ const usdBreached = (guardRails.dailyLossLimit ?? 0) > 0
137
+ && delta <= -guardRails.dailyLossLimit;
138
+ const pctAsUsd = avAtOpen > 0 && (guardRails.dailyLossLimitPct ?? 0) > 0
139
+ ? avAtOpen * (guardRails.dailyLossLimitPct / 100)
140
+ : null;
141
+ const pctBreached = pctAsUsd !== null && delta <= -pctAsUsd;
142
+ const metrics = {
143
+ pnlDelta: delta,
144
+ dailyLossLimitUsd: guardRails.dailyLossLimit ?? null,
145
+ dailyLossLimitPct: guardRails.dailyLossLimitPct ?? null,
146
+ accountValueAtOpen: avAtOpen,
147
+ };
148
+ if (usdBreached || pctBreached) {
149
+ return makeEval("daily_loss_halt", source, {
150
+ status: "CLOSED",
151
+ reason: `Daily loss halt: PnL delta $${delta.toFixed(2)} breached limit`,
152
+ metrics,
153
+ });
154
+ }
155
+ return makeEval("daily_loss_halt", source, { metrics });
156
+ }
157
+ async function evalDrawdownHalt(guardRails, snap, source, snapFailed) {
158
+ if (snapFailed || !snap) {
159
+ return makeEval("drawdown_halt", source, {
160
+ status: "CLOSED",
161
+ reason: "Risk snapshot unavailable — fail-closed",
162
+ evaluationOk: false,
163
+ fallbackApplied: true,
164
+ failureKind: snapFailed ? "transport" : "empty_data",
165
+ });
166
+ }
167
+ const ddPct = snap.drawdown.from_peak_pct;
168
+ const metrics = {
169
+ drawdownFromPeakPct: ddPct,
170
+ drawdownHaltPct: guardRails.drawdownHaltPct ?? null,
171
+ };
172
+ if ((guardRails.drawdownHaltPct ?? 0) > 0 && ddPct >= guardRails.drawdownHaltPct) {
173
+ return makeEval("drawdown_halt", source, {
174
+ status: "CLOSED",
175
+ reason: `Drawdown halt: ${ddPct.toFixed(1)}% drop from PnL peak exceeded limit`,
176
+ metrics,
177
+ });
178
+ }
179
+ return makeEval("drawdown_halt", source, { metrics });
180
+ }
181
+ async function evalConsecutiveLoss(address, guardRails, source) {
182
+ const n = guardRails.maxConsecutiveLosses;
183
+ const cooldownMinutes = guardRails.cooldownMinutes;
184
+ try {
185
+ const cooldownMs = cooldownMinutes * 60 * 1000;
186
+ const trades = await config.senpi.getTraderHistory(address, {
187
+ limit: n,
188
+ sort_by: "CLOSED_TIME",
189
+ sort_direction: "DESC",
190
+ });
191
+ const consecutiveLosses = trades.length >= n && trades.every((t) => t.realizedPnl < 0) ? n : 0;
192
+ if (consecutiveLosses >= n) {
193
+ const lastLossTime = trades[0].closedTime;
194
+ const cooldownExpiresAt = lastLossTime + cooldownMs;
195
+ if (Date.now() < cooldownExpiresAt) {
196
+ return makeEval("consecutive_loss", source, {
197
+ status: "COOLDOWN",
198
+ reason: `Consecutive losses: ${n} losses in a row, cooldown until ${new Date(cooldownExpiresAt).toISOString()}`,
199
+ metrics: { consecutiveLosses: n, maxConsecutiveLosses: n, cooldownMinutes, cooldownExpiresAt },
200
+ });
201
+ }
202
+ }
203
+ return makeEval("consecutive_loss", source, {
204
+ metrics: { consecutiveLosses, maxConsecutiveLosses: n, cooldownMinutes, cooldownExpiresAt: null },
205
+ });
206
+ }
207
+ catch (err) {
208
+ logger.warn("consecutive loss cooldown check failed — fail-closed", { address, err });
209
+ return makeEval("consecutive_loss", source, {
210
+ status: "CLOSED",
211
+ reason: "Consecutive loss cooldown check unavailable — fail-closed",
212
+ evaluationOk: false,
213
+ fallbackApplied: true,
214
+ failureKind: "transport",
215
+ });
216
+ }
217
+ }
218
+ async function evalPerAssetCooldown(address, guardRails, candidateAsset, source) {
219
+ if (!candidateAsset) {
220
+ return makeEval("per_asset_cooldown", source, {
221
+ status: "N_A",
222
+ reason: "no candidate asset",
223
+ });
224
+ }
225
+ try {
226
+ const cooldownMs = guardRails.perAssetCooldownMinutes * 60 * 1000;
227
+ const cutoffTime = Date.now() - cooldownMs;
228
+ const PAGE_SIZE = 50;
229
+ let offset = 0;
230
+ let foundCloseTime = null;
231
+ while (true) {
232
+ const trades = await config.senpi.getTraderHistory(address, {
233
+ limit: PAGE_SIZE,
234
+ offset,
235
+ sort_by: "CLOSED_TIME",
236
+ sort_direction: "DESC",
237
+ });
238
+ if (trades.length === 0)
239
+ break;
240
+ for (const t of trades) {
241
+ if (t.closedTime < cutoffTime)
242
+ break;
243
+ if (t.coin === candidateAsset) {
244
+ foundCloseTime = t.closedTime;
245
+ break;
246
+ }
247
+ }
248
+ if (foundCloseTime !== null)
249
+ break;
250
+ if (trades[trades.length - 1].closedTime < cutoffTime)
251
+ break;
252
+ if (trades.length < PAGE_SIZE)
253
+ break;
254
+ offset += PAGE_SIZE;
255
+ }
256
+ if (foundCloseTime !== null) {
257
+ const cooldownExpiresAt = foundCloseTime + cooldownMs;
258
+ if (Date.now() < cooldownExpiresAt) {
259
+ return makeEval("per_asset_cooldown", source, {
260
+ status: "COOLDOWN",
261
+ reason: `Asset cooldown: ${candidateAsset} closed at ${new Date(foundCloseTime).toISOString()}, cooldown until ${new Date(cooldownExpiresAt).toISOString()}`,
262
+ metrics: { candidateAsset, lastCloseTime: foundCloseTime, cooldownExpiresAt, perAssetCooldownMinutes: guardRails.perAssetCooldownMinutes },
263
+ });
264
+ }
265
+ }
266
+ return makeEval("per_asset_cooldown", source, {
267
+ metrics: { candidateAsset, lastCloseTime: foundCloseTime, cooldownExpiresAt: null, perAssetCooldownMinutes: guardRails.perAssetCooldownMinutes },
268
+ });
269
+ }
270
+ catch (err) {
271
+ logger.warn("asset cooldown check failed — fail-closed", { address, asset: candidateAsset, err });
272
+ return makeEval("per_asset_cooldown", source, {
273
+ status: "COOLDOWN",
274
+ reason: `Asset cooldown check unavailable for ${candidateAsset} — fail-closed`,
275
+ evaluationOk: false,
276
+ fallbackApplied: true,
277
+ failureKind: "transport",
278
+ });
279
+ }
280
+ }
281
+ async function evalMaxEntriesDay(address, guardRails, source) {
282
+ const maxEntriesPerDay = guardRails.maxEntriesPerDay;
283
+ try {
284
+ const now = new Date();
285
+ const dayStartMs = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
286
+ const dayStartSeconds = Math.floor(dayStartMs / 1000);
287
+ const traderState = await config.senpi.getTraderState(address, { includePositionAge: true, latest: true });
288
+ if (!traderState) {
289
+ return makeEval("max_entries_day", source, {
290
+ status: "CLOSED",
291
+ reason: "Max entries check unavailable — fail-closed",
292
+ evaluationOk: false,
293
+ fallbackApplied: true,
294
+ failureKind: "empty_data",
295
+ });
296
+ }
297
+ const openEntriesToday = traderState.openPositions.filter((p) => p.startTime != null && p.startTime >= dayStartSeconds).length;
298
+ const PAGE_SIZE = 50;
299
+ let offset = 0;
300
+ let closedEntriesToday = 0;
301
+ while (true) {
302
+ const trades = await config.senpi.getTraderHistory(address, {
303
+ limit: PAGE_SIZE,
304
+ offset,
305
+ sort_by: "CLOSED_TIME",
306
+ sort_direction: "DESC",
307
+ });
308
+ if (trades.length === 0)
309
+ break;
310
+ let allClosedBeforeMidnight = true;
311
+ for (const t of trades) {
312
+ if (t.closedTime < dayStartMs)
313
+ break;
314
+ allClosedBeforeMidnight = false;
315
+ if (t.openTime >= dayStartMs)
316
+ closedEntriesToday += 1;
317
+ }
318
+ if (allClosedBeforeMidnight)
319
+ break;
320
+ if (trades.length < PAGE_SIZE)
321
+ break;
322
+ offset += PAGE_SIZE;
323
+ }
324
+ const entriesToday = openEntriesToday + closedEntriesToday;
325
+ const metrics = { entriesToday, maxEntriesPerDay, openEntriesToday, closedEntriesToday };
326
+ if (entriesToday >= maxEntriesPerDay) {
327
+ return makeEval("max_entries_day", source, {
328
+ status: "CLOSED",
329
+ reason: `Max entries: ${entriesToday}/${maxEntriesPerDay} entries today`,
330
+ metrics,
331
+ });
332
+ }
333
+ return makeEval("max_entries_day", source, { metrics });
334
+ }
335
+ catch (err) {
336
+ logger.warn("max entries check failed — fail-closed", { address, err });
337
+ return makeEval("max_entries_day", source, {
338
+ status: "CLOSED",
339
+ reason: "Max entries check unavailable — fail-closed",
340
+ evaluationOk: false,
341
+ fallbackApplied: true,
342
+ failureKind: "transport",
343
+ });
344
+ }
345
+ }
346
+ // ── Main checkGate ───────────────────────────────────────────────
347
+ async function checkGate(address, opts) {
348
+ const guardRails = config.strategies.get(address)?.guardRails;
349
+ if (!guardRails) {
350
+ if (opts?.evaluateAll)
351
+ return { gate: "OPEN", gates: [] };
352
+ return { gate: "OPEN" };
353
+ }
354
+ const source = opts?.source ?? "runtime";
355
+ const candidateAsset = opts?.candidateAsset;
356
+ const evaluateAll = opts?.evaluateAll === true;
357
+ const gates = [];
358
+ // Gates 1a + 1b share one API call
359
+ const hasLossLimit = (guardRails.dailyLossLimit != null && guardRails.dailyLossLimit > 0)
360
+ || (guardRails.dailyLossLimitPct != null && guardRails.dailyLossLimitPct > 0);
361
+ const hasDrawdown = guardRails.drawdownHaltPct != null && guardRails.drawdownHaltPct > 0;
362
+ let snap = null;
363
+ let snapFailed = false;
364
+ if (hasLossLimit || hasDrawdown) {
365
+ try {
366
+ const raw = await config.senpi.getPnlHistoryWithSnapshot(address, {
367
+ drawdownResetOnDayRollover: guardRails.drawdownResetOnDayRollover,
368
+ });
369
+ const envelope = extractVerdict(raw);
370
+ snap = (isRecord(envelope) ? envelope.today_snapshot : null);
371
+ if (!snap)
372
+ snapFailed = true;
373
+ }
374
+ catch (err) {
375
+ logger.warn("getPnlHistoryWithSnapshot failed — fail-closed", { address, err });
376
+ snapFailed = true;
377
+ }
378
+ }
379
+ if (hasLossLimit) {
380
+ const ev = await evalDailyLossHalt(guardRails, snap, source, snapFailed);
381
+ gates.push(ev);
382
+ if (!evaluateAll && ev.status !== "OPEN" && ev.status !== "N_A") {
383
+ const result = { gate: ev.status, reason: ev.reason };
384
+ await logAndNotify(address, result, source, candidateAsset, gates);
385
+ return result;
386
+ }
387
+ }
388
+ if (hasDrawdown) {
389
+ const ev = await evalDrawdownHalt(guardRails, snap, source, snapFailed);
390
+ gates.push(ev);
391
+ if (!evaluateAll && ev.status !== "OPEN" && ev.status !== "N_A") {
392
+ const result = { gate: ev.status, reason: ev.reason };
393
+ await logAndNotify(address, result, source, candidateAsset, gates);
394
+ return result;
395
+ }
396
+ }
397
+ const hasConsecLoss = (guardRails.maxConsecutiveLosses ?? 0) > 0 && (guardRails.cooldownMinutes ?? 0) > 0;
398
+ if (hasConsecLoss) {
399
+ const ev = await evalConsecutiveLoss(address, guardRails, source);
400
+ gates.push(ev);
401
+ if (!evaluateAll && ev.status !== "OPEN" && ev.status !== "N_A") {
402
+ const result = { gate: ev.status, reason: ev.reason };
403
+ await logAndNotify(address, result, source, candidateAsset, gates);
404
+ return result;
405
+ }
406
+ }
407
+ const hasAssetCooldown = guardRails.perAssetCooldownMinutes != null && guardRails.perAssetCooldownMinutes >= 5;
408
+ if (hasAssetCooldown) {
409
+ const ev = await evalPerAssetCooldown(address, guardRails, candidateAsset, source);
410
+ gates.push(ev);
411
+ if (!evaluateAll && ev.status !== "OPEN" && ev.status !== "N_A") {
412
+ const result = { gate: ev.status, reason: ev.reason };
413
+ await logAndNotify(address, result, source, candidateAsset, gates);
414
+ return result;
415
+ }
416
+ }
417
+ const hasMaxEntries = (guardRails.maxEntriesPerDay ?? 0) > 0;
418
+ if (hasMaxEntries) {
419
+ const ev = await evalMaxEntriesDay(address, guardRails, source);
420
+ gates.push(ev);
421
+ if (!evaluateAll && ev.status !== "OPEN" && ev.status !== "N_A") {
422
+ const result = { gate: ev.status, reason: ev.reason };
423
+ await logAndNotify(address, result, source, candidateAsset, gates);
424
+ return result;
425
+ }
426
+ }
427
+ if (evaluateAll) {
428
+ const effective = deriveEffective(gates);
429
+ const full = { ...effective, gates };
430
+ await logAndNotify(address, effective, source, candidateAsset, gates);
431
+ return full;
432
+ }
433
+ const result = { gate: "OPEN" };
434
+ await logAndNotify(address, result, source, candidateAsset, gates);
435
+ return result;
436
+ }
437
+ return {
438
+ async checkGate(address, opts) {
439
+ return checkGate(address, opts);
440
+ },
441
+ async getGateForStrategies(addresses) {
442
+ const out = {};
443
+ for (const addr of addresses) {
444
+ out[addr] = await checkGate(addr);
445
+ }
446
+ return out;
11
447
  },
12
448
  };
13
449
  }
@@ -1 +1 @@
1
- {"version":3,"file":"risk-guard.js","sourceRoot":"","sources":["../../src/runtime/risk-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,SAAS,CAAC,QAAgB,EAAE,WAAqC;YAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,WAAW,CAAC,QAAgB,EAAE,WAAqC;YACjE,QAAQ;QACV,CAAC;KACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"risk-guard.js","sourceRoot":"","sources":["../../src/runtime/risk-guard.ts"],"names":[],"mappings":"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"}
@@ -4,6 +4,7 @@
4
4
  import type { McpTransport } from "../senpi/types.js";
5
5
  import type { RuntimeHealthStatus, RuntimeSystemState } from "../health/index.js";
6
6
  import type { ScannerDataProviders } from "../scanners/engine/data-providers.js";
7
+ import type { ExternalScannerIngestRequest, ExternalScannerIngestResult } from "../scanners/external-scanner-receiver.js";
7
8
  import type { DslPlugin } from "../dsl/plugin/index.js";
8
9
  export interface RunOptions {
9
10
  fromPath?: boolean;
@@ -17,6 +18,12 @@ export interface RuntimeHandle {
17
18
  dsl: DslPlugin | null;
18
19
  /** Wallet address from the recipe's strategy block. */
19
20
  wallet: string;
21
+ /**
22
+ * Accept one external scanner ingest request for the handle's bound runtime.
23
+ * The request may update signals, retained context, or both depending on the
24
+ * target scanner's declared outputs.
25
+ */
26
+ ingestExternalScannerData(request: ExternalScannerIngestRequest): Promise<ExternalScannerIngestResult>;
20
27
  getHealthStatus(): Promise<RuntimeHealthStatus | null>;
21
28
  getSystemState(): Promise<RuntimeSystemState | null>;
22
29
  /** Cancel exchange SLs and archive DSL state for all strategies before deleting a runtime. */
@@ -1 +1 @@
1
- {"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKxD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IAEf,eAAe,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACvD,cAAc,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACrD,8FAA8F;IAC9F,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,wBAAsB,GAAG,CACvB,mBAAmB,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,aAAa,CAAC,CAmCxB"}
1
+ {"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EACV,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKxD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,yBAAyB,CACvB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAExC,eAAe,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACvD,cAAc,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACrD,8FAA8F;IAC9F,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,wBAAsB,GAAG,CACvB,mBAAmB,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,aAAa,CAAC,CAwCxB"}
@@ -32,6 +32,9 @@ export async function run(recipePathOrContent, options) {
32
32
  },
33
33
  dsl: runtime.dsl,
34
34
  wallet: config.strategy?.wallet ?? "",
35
+ ingestExternalScannerData(request) {
36
+ return runtime.ingestExternalScannerData(request);
37
+ },
35
38
  async getHealthStatus() {
36
39
  return runtime.getHealthStatus();
37
40
  },
@@ -1 +1 @@
1
- {"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAsBvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,mBAA2B,EAC3B,OAAoB;IAEpB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,GACZ,CAAC,OAAO,OAAO,EAAE,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACpE,CAAC,CAAC,OAAO,CAAC,QAAQ;QAClB,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAC/B,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE;QAClC,QAAQ;QACR,YAAY;QACZ,MAAM;QACN,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;KAC5C,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QACD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE;QACrC,KAAK,CAAC,eAAe;YACnB,OAAO,OAAO,CAAC,eAAe,EAAE,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,cAAc;YAClB,OAAO,OAAO,CAAC,cAAc,EAAE,CAAC;QAClC,CAAC;QACD,6BAA6B;YAC3B,OAAO,OAAO,CAAC,6BAA6B,EAAE,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA8BvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,mBAA2B,EAC3B,OAAoB;IAEpB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,GACZ,CAAC,OAAO,OAAO,EAAE,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACpE,CAAC,CAAC,OAAO,CAAC,QAAQ;QAClB,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAC/B,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE;QAClC,QAAQ;QACR,YAAY;QACZ,MAAM;QACN,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;KAC5C,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QACD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE;QACrC,yBAAyB,CACvB,OAAqC;YAErC,OAAO,OAAO,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,eAAe;YACnB,OAAO,OAAO,CAAC,eAAe,EAAE,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,cAAc;YAClB,OAAO,OAAO,CAAC,cAAc,EAAE,CAAC;QAClC,CAAC;QACD,6BAA6B;YAC3B,OAAO,OAAO,CAAC,6BAA6B,EAAE,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}