@senpi-ai/runtime 1.0.96 → 1.0.98
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.
- package/README.md +113 -2
- package/dist/actions/action-runtime-module.d.ts +55 -0
- package/dist/actions/action-runtime-module.d.ts.map +1 -0
- package/dist/actions/action-runtime-module.js +491 -0
- package/dist/actions/action-runtime-module.js.map +1 -0
- package/dist/actions/close-position/close-position.action.d.ts +1 -0
- package/dist/actions/close-position/close-position.action.d.ts.map +1 -1
- package/dist/actions/close-position/close-position.action.js +93 -25
- package/dist/actions/close-position/close-position.action.js.map +1 -1
- package/dist/actions/decision-engine.d.ts.map +1 -1
- package/dist/actions/decision-engine.js +5 -0
- package/dist/actions/decision-engine.js.map +1 -1
- package/dist/actions/decision-meta.d.ts +9 -0
- package/dist/actions/decision-meta.d.ts.map +1 -0
- package/dist/actions/decision-meta.js +18 -0
- package/dist/actions/decision-meta.js.map +1 -0
- package/dist/actions/llm-decision/openclaw-llm-decision.d.ts.map +1 -1
- package/dist/actions/llm-decision/openclaw-llm-decision.js +6 -0
- package/dist/actions/llm-decision/openclaw-llm-decision.js.map +1 -1
- package/dist/actions/llm-decision/shared.d.ts +1 -1
- package/dist/actions/llm-decision/shared.d.ts.map +1 -1
- package/dist/actions/llm-decision/shared.js +1 -1
- package/dist/actions/llm-decision/shared.js.map +1 -1
- package/dist/actions/notifications/formatter.d.ts +39 -0
- package/dist/actions/notifications/formatter.d.ts.map +1 -0
- package/dist/actions/notifications/formatter.js +68 -0
- package/dist/actions/notifications/formatter.js.map +1 -0
- package/dist/actions/notifications/index.d.ts +37 -0
- package/dist/actions/notifications/index.d.ts.map +1 -0
- package/dist/actions/notifications/index.js +89 -0
- package/dist/actions/notifications/index.js.map +1 -0
- package/dist/actions/open-position/open-position.action.d.ts +1 -0
- package/dist/actions/open-position/open-position.action.d.ts.map +1 -1
- package/dist/actions/open-position/open-position.action.js +197 -34
- package/dist/actions/open-position/open-position.action.js.map +1 -1
- package/dist/actions/open-position/resolve-margin.d.ts +30 -0
- package/dist/actions/open-position/resolve-margin.d.ts.map +1 -0
- package/dist/actions/open-position/resolve-margin.js +41 -0
- package/dist/actions/open-position/resolve-margin.js.map +1 -0
- package/dist/actions/position-tracker/position-tracker.action.d.ts.map +1 -1
- package/dist/actions/position-tracker/position-tracker.action.js +4 -1
- package/dist/actions/position-tracker/position-tracker.action.js.map +1 -1
- package/dist/actions/store/action-store.d.ts +45 -0
- package/dist/actions/store/action-store.d.ts.map +1 -0
- package/dist/actions/store/action-store.js +127 -0
- package/dist/actions/store/action-store.js.map +1 -0
- package/dist/actions/store/index.d.ts +11 -0
- package/dist/actions/store/index.d.ts.map +1 -0
- package/dist/actions/store/index.js +9 -0
- package/dist/actions/store/index.js.map +1 -0
- package/dist/actions/store/paths.d.ts +15 -0
- package/dist/actions/store/paths.d.ts.map +1 -0
- package/dist/actions/store/paths.js +29 -0
- package/dist/actions/store/paths.js.map +1 -0
- package/dist/actions/store/types.d.ts +126 -0
- package/dist/actions/store/types.d.ts.map +1 -0
- package/dist/actions/store/types.js +48 -0
- package/dist/actions/store/types.js.map +1 -0
- package/dist/actions/tracking-helpers.d.ts +13 -0
- package/dist/actions/tracking-helpers.d.ts.map +1 -0
- package/dist/actions/tracking-helpers.js +47 -0
- package/dist/actions/tracking-helpers.js.map +1 -0
- package/dist/actions/types.d.ts +8 -0
- package/dist/actions/types.d.ts.map +1 -1
- package/dist/cli/guide-commands.d.ts.map +1 -1
- package/dist/cli/guide-commands.js +106 -4
- package/dist/cli/guide-commands.js.map +1 -1
- package/dist/cli/senpi-commands.d.ts.map +1 -1
- package/dist/cli/senpi-commands.js +447 -1
- package/dist/cli/senpi-commands.js.map +1 -1
- package/dist/constants/dsl/index.d.ts +12 -0
- package/dist/constants/dsl/index.d.ts.map +1 -1
- package/dist/constants/dsl/index.js +12 -0
- package/dist/constants/dsl/index.js.map +1 -1
- package/dist/constants/order-types.d.ts +7 -0
- package/dist/constants/order-types.d.ts.map +1 -0
- package/dist/constants/order-types.js +6 -0
- package/dist/constants/order-types.js.map +1 -0
- package/dist/context/interpolate.d.ts +6 -2
- package/dist/context/interpolate.d.ts.map +1 -1
- package/dist/context/interpolate.js +6 -2
- package/dist/context/interpolate.js.map +1 -1
- package/dist/context/types.d.ts +8 -1
- package/dist/context/types.d.ts.map +1 -1
- package/dist/context/types.js +8 -1
- package/dist/context/types.js.map +1 -1
- package/dist/dsl/config/exit-block.d.ts +7 -0
- package/dist/dsl/config/exit-block.d.ts.map +1 -1
- package/dist/dsl/config/parse-plugin-config.d.ts.map +1 -1
- package/dist/dsl/config/parse-plugin-config.js +27 -1
- package/dist/dsl/config/parse-plugin-config.js.map +1 -1
- package/dist/dsl/config/unknown-keys.d.ts.map +1 -1
- package/dist/dsl/config/unknown-keys.js +3 -1
- package/dist/dsl/config/unknown-keys.js.map +1 -1
- package/dist/dsl/engine-client/event-mapping.d.ts +21 -1
- package/dist/dsl/engine-client/event-mapping.d.ts.map +1 -1
- package/dist/dsl/engine-client/event-mapping.js +10 -0
- package/dist/dsl/engine-client/event-mapping.js.map +1 -1
- package/dist/dsl/engine-client/index.d.ts +1 -1
- package/dist/dsl/engine-client/index.d.ts.map +1 -1
- package/dist/dsl/events/build-closed-event.d.ts +15 -0
- package/dist/dsl/events/build-closed-event.d.ts.map +1 -0
- package/dist/dsl/events/build-closed-event.js +31 -0
- package/dist/dsl/events/build-closed-event.js.map +1 -0
- package/dist/dsl/events/handlers.d.ts +2 -1
- package/dist/dsl/events/handlers.d.ts.map +1 -1
- package/dist/dsl/events/handlers.js +15 -10
- package/dist/dsl/events/handlers.js.map +1 -1
- package/dist/dsl/events/initial-state.d.ts +2 -2
- package/dist/dsl/events/initial-state.d.ts.map +1 -1
- package/dist/dsl/events/initial-state.js +4 -1
- package/dist/dsl/events/initial-state.js.map +1 -1
- package/dist/dsl/index.js +1 -1
- package/dist/dsl/index.js.map +1 -1
- package/dist/dsl/monitor/create-monitor.d.ts +4 -0
- package/dist/dsl/monitor/create-monitor.d.ts.map +1 -1
- package/dist/dsl/monitor/create-monitor.js +8 -5
- package/dist/dsl/monitor/create-monitor.js.map +1 -1
- package/dist/dsl/monitor/process-one-position.d.ts +4 -0
- package/dist/dsl/monitor/process-one-position.d.ts.map +1 -1
- package/dist/dsl/monitor/process-one-position.js +129 -40
- package/dist/dsl/monitor/process-one-position.js.map +1 -1
- package/dist/dsl/notifications/close-resolver.d.ts +92 -0
- package/dist/dsl/notifications/close-resolver.d.ts.map +1 -0
- package/dist/dsl/notifications/close-resolver.js +309 -0
- package/dist/dsl/notifications/close-resolver.js.map +1 -0
- package/dist/dsl/notifications/format-utils.d.ts +24 -0
- package/dist/dsl/notifications/format-utils.d.ts.map +1 -0
- package/dist/dsl/notifications/format-utils.js +102 -0
- package/dist/dsl/notifications/format-utils.js.map +1 -0
- package/dist/dsl/notifications/formatter.d.ts +23 -4
- package/dist/dsl/notifications/formatter.d.ts.map +1 -1
- package/dist/dsl/notifications/formatter.js +109 -34
- package/dist/dsl/notifications/formatter.js.map +1 -1
- package/dist/dsl/notifications/index.d.ts +7 -0
- package/dist/dsl/notifications/index.d.ts.map +1 -1
- package/dist/dsl/notifications/index.js +22 -10
- package/dist/dsl/notifications/index.js.map +1 -1
- package/dist/dsl/notifications/types.d.ts +27 -0
- package/dist/dsl/notifications/types.d.ts.map +1 -0
- package/dist/dsl/notifications/types.js +5 -0
- package/dist/dsl/notifications/types.js.map +1 -0
- package/dist/dsl/plugin/index.d.ts +1 -1
- package/dist/dsl/plugin/index.d.ts.map +1 -1
- package/dist/dsl/plugin/index.js +29 -1
- package/dist/dsl/plugin/index.js.map +1 -1
- package/dist/health/index.d.ts +5 -2
- package/dist/health/index.d.ts.map +1 -1
- package/dist/health/index.js +106 -6
- package/dist/health/index.js.map +1 -1
- package/dist/health/types.d.ts +102 -0
- package/dist/health/types.d.ts.map +1 -1
- package/dist/health/types.js +7 -1
- package/dist/health/types.js.map +1 -1
- package/dist/index.d.ts +10 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +459 -8
- package/dist/index.js.map +1 -1
- package/dist/risk/guardrail.types.d.ts +58 -0
- package/dist/risk/guardrail.types.d.ts.map +1 -0
- package/dist/risk/guardrail.types.js +5 -0
- package/dist/risk/guardrail.types.js.map +1 -0
- package/dist/risk/index.d.ts +2 -4
- package/dist/risk/index.d.ts.map +1 -1
- package/dist/risk/index.js +2 -6
- package/dist/risk/index.js.map +1 -1
- package/dist/risk/risk-audit-log.d.ts +25 -0
- package/dist/risk/risk-audit-log.d.ts.map +1 -0
- package/dist/risk/risk-audit-log.js +30 -0
- package/dist/risk/risk-audit-log.js.map +1 -0
- package/dist/runtime/__tests__/helpers/runtime-gateway-harness.d.ts +162 -0
- package/dist/runtime/__tests__/helpers/runtime-gateway-harness.d.ts.map +1 -0
- package/dist/runtime/__tests__/helpers/runtime-gateway-harness.js +285 -0
- package/dist/runtime/__tests__/helpers/runtime-gateway-harness.js.map +1 -0
- package/dist/runtime/audit-query.types.d.ts +113 -0
- package/dist/runtime/audit-query.types.d.ts.map +1 -0
- package/dist/runtime/audit-query.types.js +35 -0
- package/dist/runtime/audit-query.types.js.map +1 -0
- package/dist/runtime/auto-update/coordinator.d.ts +12 -8
- package/dist/runtime/auto-update/coordinator.d.ts.map +1 -1
- package/dist/runtime/auto-update/coordinator.js +18 -17
- package/dist/runtime/auto-update/coordinator.js.map +1 -1
- package/dist/runtime/auto-update/gateway-restart.d.ts +9 -2
- package/dist/runtime/auto-update/gateway-restart.d.ts.map +1 -1
- package/dist/runtime/auto-update/gateway-restart.js +23 -13
- package/dist/runtime/auto-update/gateway-restart.js.map +1 -1
- package/dist/runtime/create-actions.d.ts +6 -2
- package/dist/runtime/create-actions.d.ts.map +1 -1
- package/dist/runtime/create-actions.js +30 -8
- package/dist/runtime/create-actions.js.map +1 -1
- package/dist/runtime/create-scanner-module.d.ts +5 -0
- package/dist/runtime/create-scanner-module.d.ts.map +1 -1
- package/dist/runtime/create-scanner-module.js +12 -1
- package/dist/runtime/create-scanner-module.js.map +1 -1
- package/dist/runtime/load-runtime-config.d.ts +1 -1
- package/dist/runtime/load-runtime-config.d.ts.map +1 -1
- package/dist/runtime/load-runtime-config.js +37 -1
- package/dist/runtime/load-runtime-config.js.map +1 -1
- package/dist/runtime/map-exit-config.d.ts +2 -1
- package/dist/runtime/map-exit-config.d.ts.map +1 -1
- package/dist/runtime/map-exit-config.js +11 -1
- package/dist/runtime/map-exit-config.js.map +1 -1
- package/dist/runtime/map-strategies.d.ts +1 -1
- package/dist/runtime/map-strategies.d.ts.map +1 -1
- package/dist/runtime/map-strategies.js +38 -1
- package/dist/runtime/map-strategies.js.map +1 -1
- package/dist/runtime/notifications.d.ts.map +1 -1
- package/dist/runtime/notifications.js +53 -7
- package/dist/runtime/notifications.js.map +1 -1
- package/dist/runtime/risk-guard.d.ts +26 -2
- package/dist/runtime/risk-guard.d.ts.map +1 -1
- package/dist/runtime/risk-guard.js +539 -5
- package/dist/runtime/risk-guard.js.map +1 -1
- package/dist/runtime/run.d.ts +96 -2
- package/dist/runtime/run.d.ts.map +1 -1
- package/dist/runtime/run.js +21 -0
- package/dist/runtime/run.js.map +1 -1
- package/dist/runtime/runtime-schema.d.ts +1169 -24
- package/dist/runtime/runtime-schema.d.ts.map +1 -1
- package/dist/runtime/runtime-schema.js +105 -2
- package/dist/runtime/runtime-schema.js.map +1 -1
- package/dist/runtime/runtime.d.ts +85 -2
- package/dist/runtime/runtime.d.ts.map +1 -1
- package/dist/runtime/runtime.js +374 -10
- package/dist/runtime/runtime.js.map +1 -1
- package/dist/runtime/scanner-composition.d.ts +10 -0
- package/dist/runtime/scanner-composition.d.ts.map +1 -1
- package/dist/runtime/scanner-composition.js +10 -0
- package/dist/runtime/scanner-composition.js.map +1 -1
- package/dist/runtime/scanner-registry.d.ts +39 -1
- package/dist/runtime/scanner-registry.d.ts.map +1 -1
- package/dist/runtime/scanner-registry.js +105 -2
- package/dist/runtime/scanner-registry.js.map +1 -1
- package/dist/runtime/state-layout.d.ts +2 -0
- package/dist/runtime/state-layout.d.ts.map +1 -1
- package/dist/runtime/state-layout.js +1 -0
- package/dist/runtime/state-layout.js.map +1 -1
- package/dist/runtime/validate-action-prompts.d.ts +30 -0
- package/dist/runtime/validate-action-prompts.d.ts.map +1 -0
- package/dist/runtime/validate-action-prompts.js +110 -0
- package/dist/runtime/validate-action-prompts.js.map +1 -0
- package/dist/runtime-api/config.d.ts +47 -0
- package/dist/runtime-api/config.d.ts.map +1 -0
- package/dist/runtime-api/config.js +74 -0
- package/dist/runtime-api/config.js.map +1 -0
- package/dist/runtime-api/handlers/audit.d.ts +78 -0
- package/dist/runtime-api/handlers/audit.d.ts.map +1 -0
- package/dist/runtime-api/handlers/audit.js +65 -0
- package/dist/runtime-api/handlers/audit.js.map +1 -0
- package/dist/runtime-api/handlers/group-by-scanner.d.ts +43 -0
- package/dist/runtime-api/handlers/group-by-scanner.d.ts.map +1 -0
- package/dist/runtime-api/handlers/group-by-scanner.js +43 -0
- package/dist/runtime-api/handlers/group-by-scanner.js.map +1 -0
- package/dist/runtime-api/handlers/ingest-signals.d.ts +54 -0
- package/dist/runtime-api/handlers/ingest-signals.d.ts.map +1 -0
- package/dist/runtime-api/handlers/ingest-signals.js +124 -0
- package/dist/runtime-api/handlers/ingest-signals.js.map +1 -0
- package/dist/runtime-api/handlers/runtime-lookup.d.ts +36 -0
- package/dist/runtime-api/handlers/runtime-lookup.d.ts.map +1 -0
- package/dist/runtime-api/handlers/runtime-lookup.js +31 -0
- package/dist/runtime-api/handlers/runtime-lookup.js.map +1 -0
- package/dist/runtime-api/handlers/types.d.ts +85 -0
- package/dist/runtime-api/handlers/types.d.ts.map +1 -0
- package/dist/runtime-api/handlers/types.js +8 -0
- package/dist/runtime-api/handlers/types.js.map +1 -0
- package/dist/runtime-api/lifecycle.d.ts +98 -0
- package/dist/runtime-api/lifecycle.d.ts.map +1 -0
- package/dist/runtime-api/lifecycle.js +137 -0
- package/dist/runtime-api/lifecycle.js.map +1 -0
- package/dist/runtime-api/readiness.d.ts +37 -0
- package/dist/runtime-api/readiness.d.ts.map +1 -0
- package/dist/runtime-api/readiness.js +35 -0
- package/dist/runtime-api/readiness.js.map +1 -0
- package/dist/runtime-api/routes/audit.d.ts +40 -0
- package/dist/runtime-api/routes/audit.d.ts.map +1 -0
- package/dist/runtime-api/routes/audit.js +90 -0
- package/dist/runtime-api/routes/audit.js.map +1 -0
- package/dist/runtime-api/routes/audit.schema.d.ts +75 -0
- package/dist/runtime-api/routes/audit.schema.d.ts.map +1 -0
- package/dist/runtime-api/routes/audit.schema.js +78 -0
- package/dist/runtime-api/routes/audit.schema.js.map +1 -0
- package/dist/runtime-api/routes/health.d.ts +53 -0
- package/dist/runtime-api/routes/health.d.ts.map +1 -0
- package/dist/runtime-api/routes/health.js +48 -0
- package/dist/runtime-api/routes/health.js.map +1 -0
- package/dist/runtime-api/routes/signals.d.ts +50 -0
- package/dist/runtime-api/routes/signals.d.ts.map +1 -0
- package/dist/runtime-api/routes/signals.js +90 -0
- package/dist/runtime-api/routes/signals.js.map +1 -0
- package/dist/runtime-api/routes/signals.schema.d.ts +94 -0
- package/dist/runtime-api/routes/signals.schema.d.ts.map +1 -0
- package/dist/runtime-api/routes/signals.schema.js +58 -0
- package/dist/runtime-api/routes/signals.schema.js.map +1 -0
- package/dist/runtime-api/routes/state.d.ts +51 -0
- package/dist/runtime-api/routes/state.d.ts.map +1 -0
- package/dist/runtime-api/routes/state.js +94 -0
- package/dist/runtime-api/routes/state.js.map +1 -0
- package/dist/runtime-api/server.d.ts +79 -0
- package/dist/runtime-api/server.d.ts.map +1 -0
- package/dist/runtime-api/server.js +114 -0
- package/dist/runtime-api/server.js.map +1 -0
- package/dist/scanners/__tests__/test-helpers.d.ts +10 -0
- package/dist/scanners/__tests__/test-helpers.d.ts.map +1 -1
- package/dist/scanners/__tests__/test-helpers.js +52 -0
- package/dist/scanners/__tests__/test-helpers.js.map +1 -1
- package/dist/scanners/engine/engine.d.ts +37 -0
- package/dist/scanners/engine/engine.d.ts.map +1 -1
- package/dist/scanners/engine/engine.js +132 -14
- package/dist/scanners/engine/engine.js.map +1 -1
- package/dist/scanners/engine/result-builder.d.ts +16 -0
- package/dist/scanners/engine/result-builder.d.ts.map +1 -1
- package/dist/scanners/engine/result-builder.js +22 -0
- package/dist/scanners/engine/result-builder.js.map +1 -1
- package/dist/scanners/engine/strategy-registry.d.ts +2 -0
- package/dist/scanners/engine/strategy-registry.d.ts.map +1 -1
- package/dist/scanners/engine/strategy-registry.js +5 -1
- package/dist/scanners/engine/strategy-registry.js.map +1 -1
- package/dist/scanners/external/liquidation-watchdog/README.md +107 -0
- package/dist/scanners/external/liquidation-watchdog/liquidation-watchdog.yaml +48 -0
- package/dist/scanners/external/liquidation-watchdog/producer.mjs +336 -0
- package/dist/scanners/external/momentum/README.md +148 -0
- package/dist/scanners/external/momentum/momentum.yaml +116 -0
- package/dist/scanners/external/momentum/producer.mjs +251 -0
- package/dist/scanners/external/shared/ingest.mjs +112 -0
- package/dist/scanners/external-scanner-receiver.d.ts +118 -0
- package/dist/scanners/external-scanner-receiver.d.ts.map +1 -0
- package/dist/scanners/external-scanner-receiver.js +266 -0
- package/dist/scanners/external-scanner-receiver.js.map +1 -0
- package/dist/scanners/implementations/external-scanner.d.ts +17 -0
- package/dist/scanners/implementations/external-scanner.d.ts.map +1 -0
- package/dist/scanners/implementations/external-scanner.js +51 -0
- package/dist/scanners/implementations/external-scanner.js.map +1 -0
- package/dist/scanners/implementations/index.d.ts +1 -0
- package/dist/scanners/implementations/index.d.ts.map +1 -1
- package/dist/scanners/implementations/index.js +1 -0
- package/dist/scanners/implementations/index.js.map +1 -1
- package/dist/scanners/implementations/position-tracker.d.ts.map +1 -1
- package/dist/scanners/implementations/position-tracker.js +3 -1
- package/dist/scanners/implementations/position-tracker.js.map +1 -1
- package/dist/scanners/index.d.ts +4 -1
- package/dist/scanners/index.d.ts.map +1 -1
- package/dist/scanners/index.js +2 -0
- package/dist/scanners/index.js.map +1 -1
- package/dist/scanners/protocol/scanner.d.ts +3 -1
- package/dist/scanners/protocol/scanner.d.ts.map +1 -1
- package/dist/scanners/providers/client.d.ts.map +1 -1
- package/dist/scanners/providers/client.js +0 -8
- package/dist/scanners/providers/client.js.map +1 -1
- package/dist/scanners/runtime-module.d.ts +10 -0
- package/dist/scanners/runtime-module.d.ts.map +1 -1
- package/dist/scanners/runtime-module.js +19 -3
- package/dist/scanners/runtime-module.js.map +1 -1
- package/dist/scanners/scanner-definition.d.ts +12 -1
- package/dist/scanners/scanner-definition.d.ts.map +1 -1
- package/dist/scanners/schema-utils.d.ts +22 -2
- package/dist/scanners/schema-utils.d.ts.map +1 -1
- package/dist/scanners/schema-utils.js +14 -2
- package/dist/scanners/schema-utils.js.map +1 -1
- package/dist/scanners/types.d.ts +3 -0
- package/dist/scanners/types.d.ts.map +1 -1
- package/dist/scanners/types.js.map +1 -1
- package/dist/scripts/run-dsl-standalone-live.js +2 -2
- package/dist/scripts/run-dsl-standalone-live.js.map +1 -1
- package/dist/scripts/run-dsl-standalone-mock.js +2 -2
- package/dist/scripts/run-dsl-standalone-mock.js.map +1 -1
- package/dist/senpi/client.d.ts +123 -4
- package/dist/senpi/client.d.ts.map +1 -1
- package/dist/senpi/client.js +304 -15
- package/dist/senpi/client.js.map +1 -1
- package/dist/senpi/index.d.ts +1 -1
- package/dist/senpi/index.d.ts.map +1 -1
- package/dist/senpi/types.d.ts +70 -0
- package/dist/senpi/types.d.ts.map +1 -1
- package/dist/state/state-manager.d.ts +3 -0
- package/dist/state/state-manager.d.ts.map +1 -1
- package/dist/state/state-manager.js +9 -0
- package/dist/state/state-manager.js.map +1 -1
- package/dist/strategy/strategy-state.d.ts +4 -1
- package/dist/strategy/strategy-state.d.ts.map +1 -1
- package/dist/strategy/strategy-state.js +7 -2
- package/dist/strategy/strategy-state.js.map +1 -1
- package/dist/tracking/constants.d.ts +24 -0
- package/dist/tracking/constants.d.ts.map +1 -0
- package/dist/tracking/constants.js +50 -0
- package/dist/tracking/constants.js.map +1 -0
- package/dist/tracking/index.d.ts +13 -0
- package/dist/tracking/index.d.ts.map +1 -0
- package/dist/tracking/index.js +9 -0
- package/dist/tracking/index.js.map +1 -0
- package/dist/tracking/plugin-event-tracker.d.ts +13 -0
- package/dist/tracking/plugin-event-tracker.d.ts.map +1 -0
- package/dist/tracking/plugin-event-tracker.js +27 -0
- package/dist/tracking/plugin-event-tracker.js.map +1 -0
- package/dist/tracking/tracker.d.ts +30 -0
- package/dist/tracking/tracker.d.ts.map +1 -0
- package/dist/tracking/tracker.js +66 -0
- package/dist/tracking/tracker.js.map +1 -0
- package/dist/tracking/tracking-handler.d.ts +12 -0
- package/dist/tracking/tracking-handler.d.ts.map +1 -0
- package/dist/tracking/tracking-handler.js +148 -0
- package/dist/tracking/tracking-handler.js.map +1 -0
- package/dist/tracking/transport.d.ts +35 -0
- package/dist/tracking/transport.d.ts.map +1 -0
- package/dist/tracking/transport.js +133 -0
- package/dist/tracking/transport.js.map +1 -0
- package/dist/tracking/types.d.ts +21 -0
- package/dist/tracking/types.d.ts.map +1 -0
- package/dist/tracking/types.js +6 -0
- package/dist/tracking/types.js.map +1 -0
- package/dist/types/action.d.ts +13 -2
- package/dist/types/action.d.ts.map +1 -1
- package/dist/types/dsl/index.d.ts +72 -3
- package/dist/types/dsl/index.d.ts.map +1 -1
- package/dist/types/strategy.d.ts +11 -3
- package/dist/types/strategy.d.ts.map +1 -1
- package/dist/utils/logger.d.ts +6 -1
- package/dist/utils/logger.d.ts.map +1 -1
- package/dist/utils/logger.js +35 -2
- package/dist/utils/logger.js.map +1 -1
- package/dist/utils/resolve-order-type.d.ts +5 -0
- package/dist/utils/resolve-order-type.d.ts.map +1 -0
- package/dist/utils/resolve-order-type.js +29 -0
- package/dist/utils/resolve-order-type.js.map +1 -0
- package/examples/strategies/dsl-showcase.yaml +7 -2
- package/examples/strategies/dsl.yaml +5 -1
- package/examples/strategies/fox-minimal-loosened.yaml +18 -3
- package/examples/strategies/fox-minimal.yaml +25 -3
- package/examples/strategies/minimal.yaml +4 -2
- package/examples/strategies/momentum/how-it-works.md +48 -0
- package/examples/strategies/momentum/momentum-guarded.yaml +161 -0
- package/examples/strategies/risk-showcase.yaml +93 -0
- package/examples/strategies/viper.yaml +11 -3
- package/examples/strategies/wolf.yaml +11 -3
- package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml +12 -4
- package/openclaw.plugin.json +35 -1
- package/package.json +12 -7
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `createApi()` — Fastify server factory for the runtime HTTP API.
|
|
3
|
+
*
|
|
4
|
+
* Wires the Fastify instance with:
|
|
5
|
+
* - `POST /signals` — ingest signals for one or more wallets.
|
|
6
|
+
* - `GET /audit` — MCP audit-query proxy scoped to one wallet.
|
|
7
|
+
* - `GET /health` — three-state readiness + per-runtime queue depth.
|
|
8
|
+
*
|
|
9
|
+
* Returns the Fastify instance, the mutable readiness flag, and the boot
|
|
10
|
+
* timestamp. The lifecycle layer (S5) calls `fastify.listen()` and flips
|
|
11
|
+
* `readiness.setOk()` / `readiness.setDraining()` around start/stop.
|
|
12
|
+
*
|
|
13
|
+
* This module owns only wiring — no business logic. All route logic
|
|
14
|
+
* delegates to the shared handlers in `handlers/`.
|
|
15
|
+
*/
|
|
16
|
+
import { type FastifyInstance } from "fastify";
|
|
17
|
+
import { createReadiness } from "./readiness.js";
|
|
18
|
+
import type { RuntimeHandle } from "../runtime/run.js";
|
|
19
|
+
import type { Logger } from "../utils/logger.js";
|
|
20
|
+
import type { ApiConfig } from "./config.js";
|
|
21
|
+
/**
|
|
22
|
+
* Dependencies passed to {@link createApi}.
|
|
23
|
+
*/
|
|
24
|
+
export interface CreateApiDeps {
|
|
25
|
+
/** Live runtime handles maintained by the plugin, keyed by lowercased address. */
|
|
26
|
+
runtimeHandles: Map<string, RuntimeHandle>;
|
|
27
|
+
/** Validated `api` config block (host, port, maxItemsPerSignalsRequest). */
|
|
28
|
+
apiConfig: ApiConfig;
|
|
29
|
+
/** Logger instance — forwarded to shared handlers for structured error logging. */
|
|
30
|
+
logger: Logger;
|
|
31
|
+
/**
|
|
32
|
+
* Plugin version string read from `openclaw.plugin.json` at boot.
|
|
33
|
+
* Exposed in `GET /health` so callers can correlate requests with deployments.
|
|
34
|
+
*/
|
|
35
|
+
version: string;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Artifacts returned by {@link createApi}.
|
|
39
|
+
*
|
|
40
|
+
* Ownership:
|
|
41
|
+
* - `fastify` — call `.listen()` and `.close()` in the lifecycle layer (S5).
|
|
42
|
+
* - `readiness` — call `setOk()` after `.listen()` resolves; `setDraining()`
|
|
43
|
+
* before `.close()` during graceful shutdown.
|
|
44
|
+
* - `bootedAt` — Unix epoch ms recorded when `createApi()` was called;
|
|
45
|
+
* used by `GET /health` to compute `uptime_ms`.
|
|
46
|
+
*/
|
|
47
|
+
export interface ApiArtifacts {
|
|
48
|
+
fastify: FastifyInstance;
|
|
49
|
+
readiness: ReturnType<typeof createReadiness>;
|
|
50
|
+
bootedAt: number;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Create and configure the Fastify HTTP server.
|
|
54
|
+
*
|
|
55
|
+
* Does NOT start listening. Call `artifacts.fastify.listen(...)` from the
|
|
56
|
+
* lifecycle layer (S5) after `createApi()` returns.
|
|
57
|
+
*
|
|
58
|
+
* Error handler behaviour:
|
|
59
|
+
* - `400` (schema validation), `413` (body too large), `415` (wrong
|
|
60
|
+
* content-type) are passed through as `INVALID_REQUEST` with the original
|
|
61
|
+
* Fastify message so callers can read the validation detail.
|
|
62
|
+
* - All other errors are logged and returned as `500 / UNAVAILABLE`.
|
|
63
|
+
*
|
|
64
|
+
* Request timeout strategy (resolved in S5):
|
|
65
|
+
* A single server-wide `requestTimeout: 30_000` covers all routes.
|
|
66
|
+
* The plan called for per-route values (10s for `/signals` + `/health`,
|
|
67
|
+
* 30s for `/audit`), but Fastify v5 does not expose a declarative per-route
|
|
68
|
+
* `requestTimeout` and wiring an `onRequest` hook with manual `setTimeout`
|
|
69
|
+
* calls adds meaningful complexity for a localhost-only server where requests
|
|
70
|
+
* that genuinely hang are almost always MCP-side. The 30s ceiling is driven
|
|
71
|
+
* entirely by `/audit` (MCP round-trip); `/signals` and `/health` both
|
|
72
|
+
* complete in well under 1s in practice. If per-route enforcement becomes
|
|
73
|
+
* necessary, add an `onRequest` hook in this file.
|
|
74
|
+
*
|
|
75
|
+
* @param deps Dependencies injected by the plugin entry point.
|
|
76
|
+
* @returns `{ fastify, readiness, bootedAt }`.
|
|
77
|
+
*/
|
|
78
|
+
export declare function createApi(deps: CreateApiDeps): ApiArtifacts;
|
|
79
|
+
//# sourceMappingURL=server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/runtime-api/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAKxD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,4EAA4E;IAC5E,SAAS,EAAE,SAAS,CAAC;IACrB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CA0E3D"}
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `createApi()` — Fastify server factory for the runtime HTTP API.
|
|
3
|
+
*
|
|
4
|
+
* Wires the Fastify instance with:
|
|
5
|
+
* - `POST /signals` — ingest signals for one or more wallets.
|
|
6
|
+
* - `GET /audit` — MCP audit-query proxy scoped to one wallet.
|
|
7
|
+
* - `GET /health` — three-state readiness + per-runtime queue depth.
|
|
8
|
+
*
|
|
9
|
+
* Returns the Fastify instance, the mutable readiness flag, and the boot
|
|
10
|
+
* timestamp. The lifecycle layer (S5) calls `fastify.listen()` and flips
|
|
11
|
+
* `readiness.setOk()` / `readiness.setDraining()` around start/stop.
|
|
12
|
+
*
|
|
13
|
+
* This module owns only wiring — no business logic. All route logic
|
|
14
|
+
* delegates to the shared handlers in `handlers/`.
|
|
15
|
+
*/
|
|
16
|
+
import Fastify from "fastify";
|
|
17
|
+
import { registerSignalsRoute } from "./routes/signals.js";
|
|
18
|
+
import { registerAuditRoute } from "./routes/audit.js";
|
|
19
|
+
import { registerHealthRoute } from "./routes/health.js";
|
|
20
|
+
import { registerStateRoute } from "./routes/state.js";
|
|
21
|
+
import { createReadiness } from "./readiness.js";
|
|
22
|
+
/**
|
|
23
|
+
* Create and configure the Fastify HTTP server.
|
|
24
|
+
*
|
|
25
|
+
* Does NOT start listening. Call `artifacts.fastify.listen(...)` from the
|
|
26
|
+
* lifecycle layer (S5) after `createApi()` returns.
|
|
27
|
+
*
|
|
28
|
+
* Error handler behaviour:
|
|
29
|
+
* - `400` (schema validation), `413` (body too large), `415` (wrong
|
|
30
|
+
* content-type) are passed through as `INVALID_REQUEST` with the original
|
|
31
|
+
* Fastify message so callers can read the validation detail.
|
|
32
|
+
* - All other errors are logged and returned as `500 / UNAVAILABLE`.
|
|
33
|
+
*
|
|
34
|
+
* Request timeout strategy (resolved in S5):
|
|
35
|
+
* A single server-wide `requestTimeout: 30_000` covers all routes.
|
|
36
|
+
* The plan called for per-route values (10s for `/signals` + `/health`,
|
|
37
|
+
* 30s for `/audit`), but Fastify v5 does not expose a declarative per-route
|
|
38
|
+
* `requestTimeout` and wiring an `onRequest` hook with manual `setTimeout`
|
|
39
|
+
* calls adds meaningful complexity for a localhost-only server where requests
|
|
40
|
+
* that genuinely hang are almost always MCP-side. The 30s ceiling is driven
|
|
41
|
+
* entirely by `/audit` (MCP round-trip); `/signals` and `/health` both
|
|
42
|
+
* complete in well under 1s in practice. If per-route enforcement becomes
|
|
43
|
+
* necessary, add an `onRequest` hook in this file.
|
|
44
|
+
*
|
|
45
|
+
* @param deps Dependencies injected by the plugin entry point.
|
|
46
|
+
* @returns `{ fastify, readiness, bootedAt }`.
|
|
47
|
+
*/
|
|
48
|
+
export function createApi(deps) {
|
|
49
|
+
const bootedAt = Date.now();
|
|
50
|
+
const readiness = createReadiness();
|
|
51
|
+
const fastify = Fastify({
|
|
52
|
+
logger: { level: "info" },
|
|
53
|
+
bodyLimit: 256 * 1024, // 256 KB — generous for signal batches, hard cap on abuse.
|
|
54
|
+
disableRequestLogging: false,
|
|
55
|
+
/**
|
|
56
|
+
* 30s request ceiling — driven by `/audit` (MCP round-trip).
|
|
57
|
+
* `/signals` and `/health` complete far faster; we accept the unified
|
|
58
|
+
* ceiling to avoid per-route hook complexity on a localhost-only server.
|
|
59
|
+
* Documented in docs/runtime-docs/runtime-api.md.
|
|
60
|
+
*/
|
|
61
|
+
requestTimeout: 30_000,
|
|
62
|
+
});
|
|
63
|
+
// Custom error handler — normalises Fastify validation / payload errors into
|
|
64
|
+
// the senpi-stack envelope `{ success: false, error: { code, message } }`.
|
|
65
|
+
fastify.setErrorHandler((error, _req, reply) => {
|
|
66
|
+
// Fastify v5 types setErrorHandler with `unknown`; cast once for the handler.
|
|
67
|
+
const err = error;
|
|
68
|
+
const statusCode = err.statusCode;
|
|
69
|
+
if (statusCode === 400 ||
|
|
70
|
+
statusCode === 413 ||
|
|
71
|
+
statusCode === 415) {
|
|
72
|
+
return reply.status(statusCode).send({
|
|
73
|
+
success: false,
|
|
74
|
+
error: {
|
|
75
|
+
code: "INVALID_REQUEST",
|
|
76
|
+
message: err.message,
|
|
77
|
+
},
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
deps.logger.error("[senpi-core][runtime-api] Unhandled error", {
|
|
81
|
+
err,
|
|
82
|
+
});
|
|
83
|
+
return reply.status(500).send({
|
|
84
|
+
success: false,
|
|
85
|
+
error: {
|
|
86
|
+
code: "UNAVAILABLE",
|
|
87
|
+
message: err.message,
|
|
88
|
+
},
|
|
89
|
+
});
|
|
90
|
+
});
|
|
91
|
+
registerSignalsRoute(fastify, {
|
|
92
|
+
runtimeHandles: deps.runtimeHandles,
|
|
93
|
+
logger: deps.logger,
|
|
94
|
+
maxItems: deps.apiConfig.maxItemsPerSignalsRequest,
|
|
95
|
+
transport: "http",
|
|
96
|
+
});
|
|
97
|
+
registerAuditRoute(fastify, {
|
|
98
|
+
runtimeHandles: deps.runtimeHandles,
|
|
99
|
+
logger: deps.logger,
|
|
100
|
+
});
|
|
101
|
+
registerHealthRoute(fastify, {
|
|
102
|
+
runtimeHandles: deps.runtimeHandles,
|
|
103
|
+
apiConfig: { host: deps.apiConfig.host, port: deps.apiConfig.port },
|
|
104
|
+
readiness,
|
|
105
|
+
version: deps.version,
|
|
106
|
+
bootedAt,
|
|
107
|
+
});
|
|
108
|
+
registerStateRoute(fastify, {
|
|
109
|
+
runtimeHandles: deps.runtimeHandles,
|
|
110
|
+
logger: deps.logger,
|
|
111
|
+
});
|
|
112
|
+
return { fastify, readiness, bootedAt };
|
|
113
|
+
}
|
|
114
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/runtime-api/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,OAAiC,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAsCjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,SAAS,CAAC,IAAmB;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAG,OAAO,CAAC;QACtB,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;QACzB,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,2DAA2D;QAClF,qBAAqB,EAAE,KAAK;QAC5B;;;;;WAKG;QACH,cAAc,EAAE,MAAM;KACvB,CAAC,CAAC;IAEH,6EAA6E;IAC7E,2EAA2E;IAC3E,OAAO,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QAC7C,8EAA8E;QAC9E,MAAM,GAAG,GAAG,KAAwC,CAAC;QACrD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QAClC,IACE,UAAU,KAAK,GAAG;YAClB,UAAU,KAAK,GAAG;YAClB,UAAU,KAAK,GAAG,EAClB,CAAC;YACD,OAAO,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;gBACnC,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE;YAC7D,GAAG;SACJ,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YAC5B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,oBAAoB,CAAC,OAAO,EAAE;QAC5B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,yBAAyB;QAClD,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;IAEH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,mBAAmB,CAAC,OAAO,EAAE;QAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;QACnE,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ;KACT,CAAC,CAAC;IAEH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC"}
|
|
@@ -1,4 +1,14 @@
|
|
|
1
|
+
import { type ScannerOutputs } from "../scanner-definition.js";
|
|
2
|
+
import type { Scanner } from "../protocol/scanner.js";
|
|
3
|
+
import type { Signal } from "../types.js";
|
|
1
4
|
export declare function createTempDir(prefix: string): Promise<string>;
|
|
2
5
|
export declare function removeDir(path: string): Promise<void>;
|
|
3
6
|
export declare function listFilesRecursive(root: string): Promise<string[]>;
|
|
7
|
+
export interface BuildPushDrivenTestScannerOptions {
|
|
8
|
+
id?: string;
|
|
9
|
+
outputs?: ScannerOutputs;
|
|
10
|
+
scan?: Scanner<Record<string, never>, Record<string, never>>["scan"];
|
|
11
|
+
}
|
|
12
|
+
export declare function makeTestSignal(scannerId: string, score?: number, asset?: string): Signal;
|
|
13
|
+
export declare function buildPushDrivenTestScanner(options?: BuildPushDrivenTestScannerOptions): Scanner<Record<string, never>, Record<string, never>>;
|
|
4
14
|
//# sourceMappingURL=test-helpers.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../../src/scanners/__tests__/test-helpers.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../../src/scanners/__tests__/test-helpers.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcxE;AAED,MAAM,WAAW,iCAAiC;IAChD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CACtE;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,KAAK,SAAM,EACX,KAAK,SAAQ,GACZ,MAAM,CAYR;AAED,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAoCvD"}
|
|
@@ -1,6 +1,10 @@
|
|
|
1
|
+
import { Type } from "@sinclair/typebox";
|
|
1
2
|
import { mkdtemp, readdir, rm } from "node:fs/promises";
|
|
2
3
|
import { tmpdir } from "node:os";
|
|
3
4
|
import { join } from "node:path";
|
|
5
|
+
import { defineSharedArtifact } from "../artifacts.js";
|
|
6
|
+
import { createScanner } from "../create-scanner.js";
|
|
7
|
+
import { PersistencePolicy, RetentionPolicy, } from "../scanner-definition.js";
|
|
4
8
|
export async function createTempDir(prefix) {
|
|
5
9
|
return mkdtemp(join(tmpdir(), prefix));
|
|
6
10
|
}
|
|
@@ -20,4 +24,52 @@ export async function listFilesRecursive(root) {
|
|
|
20
24
|
}
|
|
21
25
|
return out;
|
|
22
26
|
}
|
|
27
|
+
export function makeTestSignal(scannerId, score = 0.5, asset = "BTC") {
|
|
28
|
+
return {
|
|
29
|
+
address: "alpha",
|
|
30
|
+
scannerId,
|
|
31
|
+
signalType: "TEST_SIGNAL",
|
|
32
|
+
asset,
|
|
33
|
+
direction: "LONG",
|
|
34
|
+
score,
|
|
35
|
+
timestamp: Date.now(),
|
|
36
|
+
factors: { thresholdHit: true },
|
|
37
|
+
meta: {},
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
export function buildPushDrivenTestScanner(options = {}) {
|
|
41
|
+
const id = options.id ?? "push-driven";
|
|
42
|
+
const outputs = options.outputs ?? { signals: true, context: false };
|
|
43
|
+
return createScanner({
|
|
44
|
+
id,
|
|
45
|
+
signalType: "TEST_SIGNAL",
|
|
46
|
+
description: "Push-driven test scanner",
|
|
47
|
+
outputs,
|
|
48
|
+
scheduleMode: "external",
|
|
49
|
+
intervalSeconds: 0,
|
|
50
|
+
retention: RetentionPolicy.LAST_ONLY,
|
|
51
|
+
persistence: outputs.signals
|
|
52
|
+
? PersistencePolicy.ALWAYS
|
|
53
|
+
: PersistencePolicy.NEVER,
|
|
54
|
+
inputs: [],
|
|
55
|
+
artifacts: outputs.context
|
|
56
|
+
? {
|
|
57
|
+
produces: [
|
|
58
|
+
defineSharedArtifact(id, {
|
|
59
|
+
description: `Retained test context for '${id}'.`,
|
|
60
|
+
}),
|
|
61
|
+
],
|
|
62
|
+
}
|
|
63
|
+
: undefined,
|
|
64
|
+
configSchema: Type.Object({}),
|
|
65
|
+
defaultConfig: {},
|
|
66
|
+
scan: options.scan ??
|
|
67
|
+
(async (ctx) => ({
|
|
68
|
+
timestamp: ctx.now(),
|
|
69
|
+
scannedCount: outputs.signals ? 1 : 0,
|
|
70
|
+
signals: outputs.signals ? [makeTestSignal(id)] : [],
|
|
71
|
+
summary: { mode: "push-driven-test" },
|
|
72
|
+
})),
|
|
73
|
+
});
|
|
74
|
+
}
|
|
23
75
|
//# sourceMappingURL=test-helpers.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../../src/scanners/__tests__/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../../src/scanners/__tests__/test-helpers.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import type { Scanner } from "../protocol/scanner.js";
|
|
2
|
+
import type { ScannerScheduleMode } from "../scanner-definition.js";
|
|
2
3
|
import type { ScanResult, ScannerId, StrategyRegistration } from "../types.js";
|
|
4
|
+
import { type ExternalScannerIngestRequest, type ExternalScannerIngestResult } from "../external-scanner-receiver.js";
|
|
3
5
|
import { type ScannerEngineDependencies } from "./data-providers.js";
|
|
4
6
|
import { StrategyRegistry } from "./strategy-registry.js";
|
|
5
7
|
import type { ScannerComposition } from "../../runtime/scanner-composition.js";
|
|
@@ -11,6 +13,7 @@ export interface ScannerRegistrationSummary {
|
|
|
11
13
|
intervalSeconds: number;
|
|
12
14
|
}
|
|
13
15
|
export interface ScannerRegistrationStateSummary extends ScannerRegistrationSummary {
|
|
16
|
+
scheduleMode: ScannerScheduleMode;
|
|
14
17
|
initialized: boolean;
|
|
15
18
|
inFlight: boolean;
|
|
16
19
|
nextRunAt: number | null;
|
|
@@ -48,6 +51,21 @@ export declare class ScannerEngine {
|
|
|
48
51
|
* Flow: overlap-guard -> runtime/config -> beforeScan -> scan -> normalize -> persist.
|
|
49
52
|
*/
|
|
50
53
|
runOnce(address: string, scannerId: ScannerId): Promise<ScanResult>;
|
|
54
|
+
/**
|
|
55
|
+
* Accepts one externally supplied signal/context payload for a push-driven
|
|
56
|
+
* scanner.
|
|
57
|
+
*
|
|
58
|
+
* This path intentionally reuses the engine's runtime bootstrap, result
|
|
59
|
+
* normalization, persistence, retained-context storage, and lifecycle
|
|
60
|
+
* callbacks so external ingests look like ordinary scanner attempts to the
|
|
61
|
+
* rest of the runtime.
|
|
62
|
+
*
|
|
63
|
+
* The in-flight marker is set before the first awaited store read. That
|
|
64
|
+
* preserves the same single-run-per-scanner invariant as interval scans even
|
|
65
|
+
* when two gateway ingests arrive in the same event-loop turn.
|
|
66
|
+
*/
|
|
67
|
+
ingestExternalScannerData(address: string, request: ExternalScannerIngestRequest): Promise<ExternalScannerIngestResult>;
|
|
68
|
+
commitRunResult(address: string, scannerId: ScannerId, result: ScanResult): Promise<ScanResult>;
|
|
51
69
|
/** Executes one scanner plus its dependency chain immediately in topological order. */
|
|
52
70
|
runChain(address: string, scannerId: ScannerId): Promise<ScanResult[]>;
|
|
53
71
|
/** Reads one scanner's retained context payload, or null when it is unavailable. */
|
|
@@ -76,11 +94,30 @@ export declare class ScannerEngine {
|
|
|
76
94
|
* says the result should be written to disk.
|
|
77
95
|
*/
|
|
78
96
|
private persistIfNeeded;
|
|
97
|
+
/**
|
|
98
|
+
* Commits retained context for external ingests through the same shared
|
|
99
|
+
* artifact store used by built-in scanners.
|
|
100
|
+
*
|
|
101
|
+
* Built-in scanners write context from inside `scan()` via
|
|
102
|
+
* `ctx.saveSharedArtifact(...)`. External scanners do not execute scanner
|
|
103
|
+
* logic, so the engine must preserve that boundary explicitly here.
|
|
104
|
+
*/
|
|
105
|
+
private persistExternalContextIfNeeded;
|
|
79
106
|
/**
|
|
80
107
|
* Returns the registered strategy/scanner runtime entry or throws when the
|
|
81
108
|
* requested pair is unknown to the engine.
|
|
82
109
|
*/
|
|
83
110
|
private requireRegistration;
|
|
111
|
+
/**
|
|
112
|
+
* Resolves the target registration for an external ingest and enforces the
|
|
113
|
+
* routing invariants that make the ingest path safe.
|
|
114
|
+
*
|
|
115
|
+
* Route validation happens here instead of in the runtime/plugin layers so
|
|
116
|
+
* every caller shares the same rules for unknown scanners, disabled targets,
|
|
117
|
+
* and non-external registrations. Payload-shape compatibility with
|
|
118
|
+
* signal-only versus context-producing scanners stays in the ingest validator.
|
|
119
|
+
*/
|
|
120
|
+
private requireExternalIngestRegistration;
|
|
84
121
|
private defaultStateFor;
|
|
85
122
|
private ensureValidState;
|
|
86
123
|
private emitRunStart;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/engine.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
import { SkipScan } from "../protocol/hooks.js";
|
|
2
2
|
import { ScanStatus as ScanStatusEnum } from "../types.js";
|
|
3
|
+
import { ExternalScannerIngestError, prepareExternalScannerIngest, } from "../external-scanner-receiver.js";
|
|
3
4
|
import { assertValidConfig, assertValidState } from "./config-validator.js";
|
|
4
5
|
import { createSharedArtifactAccessor, } from "./data-providers.js";
|
|
5
6
|
import { resolveScanInputs } from "./input-resolver.js";
|
|
6
|
-
import { buildResult, buildRunResult, formatError, shouldPersist, } from "./result-builder.js";
|
|
7
|
+
import { buildExternalIngestResult, buildResult, buildRunResult, formatError, shouldPersist, } from "./result-builder.js";
|
|
7
8
|
import { StrategyRegistry, } from "./strategy-registry.js";
|
|
8
9
|
/** Runtime engine for scanner registration, scheduling, and one-off execution. */
|
|
9
10
|
export class ScannerEngine {
|
|
@@ -26,7 +27,7 @@ export class ScannerEngine {
|
|
|
26
27
|
this.registry.registerStrategy(strategy);
|
|
27
28
|
const entry = this.registry.registerScanner(strategy.id, scanner);
|
|
28
29
|
assertValidConfig(scanner.definition, entry.initialConfig, strategy.id, scanner.definition.id);
|
|
29
|
-
if (this.started && entry.enabled) {
|
|
30
|
+
if (this.started && entry.enabled && entry.scheduleMode === "interval") {
|
|
30
31
|
this.schedule(entry);
|
|
31
32
|
}
|
|
32
33
|
}
|
|
@@ -62,18 +63,20 @@ export class ScannerEngine {
|
|
|
62
63
|
this.started = true;
|
|
63
64
|
const entries = this.registry.list();
|
|
64
65
|
const toSchedule = entries.filter((e) => e.enabled);
|
|
66
|
+
const intervalScheduled = toSchedule.filter((entry) => entry.scheduleMode === "interval");
|
|
65
67
|
const summary = {
|
|
66
68
|
total: entries.length,
|
|
67
69
|
enabled: toSchedule.length,
|
|
68
|
-
scanners:
|
|
70
|
+
scanners: intervalScheduled.map((e) => ({
|
|
69
71
|
address: e.address,
|
|
70
72
|
scannerId: e.scanner.definition.id,
|
|
73
|
+
scheduleMode: e.scheduleMode,
|
|
71
74
|
intervalSeconds: e.intervalSeconds,
|
|
72
75
|
})),
|
|
73
76
|
};
|
|
74
77
|
this.deps.logger?.info?.("Scanner engine start: scheduling scanners", summary);
|
|
75
78
|
await this.bootstrapContextDependencies();
|
|
76
|
-
for (const entry of
|
|
79
|
+
for (const entry of intervalScheduled) {
|
|
77
80
|
this.schedule(entry);
|
|
78
81
|
}
|
|
79
82
|
this.deps.logger?.info?.("Scanner engine start() complete");
|
|
@@ -101,6 +104,7 @@ export class ScannerEngine {
|
|
|
101
104
|
return this.registry.list(address).map((entry) => ({
|
|
102
105
|
address: entry.address,
|
|
103
106
|
scannerId: entry.scanner.definition.id,
|
|
107
|
+
scheduleMode: entry.scheduleMode,
|
|
104
108
|
enabled: entry.enabled,
|
|
105
109
|
intervalSeconds: entry.intervalSeconds,
|
|
106
110
|
initialized: entry.initialized,
|
|
@@ -140,7 +144,7 @@ export class ScannerEngine {
|
|
|
140
144
|
async runOnce(address, scannerId) {
|
|
141
145
|
const entry = this.requireRegistration(address, scannerId);
|
|
142
146
|
const attemptTimestamp = this.now();
|
|
143
|
-
this.deps.logger?.
|
|
147
|
+
this.deps.logger?.debug?.("Scan initiated", {
|
|
144
148
|
address,
|
|
145
149
|
scannerId,
|
|
146
150
|
timestamp: attemptTimestamp,
|
|
@@ -161,9 +165,7 @@ export class ScannerEngine {
|
|
|
161
165
|
const context = await this.buildPreparedContext(entry, runtime, attemptTimestamp);
|
|
162
166
|
const output = await entry.scanner.scan(context);
|
|
163
167
|
const result = buildRunResult(entry, context, output, this.now, this.deps.logger);
|
|
164
|
-
|
|
165
|
-
this.emitRunResult(result);
|
|
166
|
-
return result;
|
|
168
|
+
return this.commitRunResult(entry.address, entry.scanner.definition.id, result);
|
|
167
169
|
}
|
|
168
170
|
catch (error) {
|
|
169
171
|
const result = this.buildFailureResult(entry, error);
|
|
@@ -174,14 +176,83 @@ export class ScannerEngine {
|
|
|
174
176
|
error,
|
|
175
177
|
});
|
|
176
178
|
}
|
|
177
|
-
|
|
178
|
-
this.emitRunResult(result);
|
|
179
|
-
return result;
|
|
179
|
+
return this.commitRunResult(entry.address, entry.scanner.definition.id, result);
|
|
180
180
|
}
|
|
181
181
|
finally {
|
|
182
182
|
this.registry.setLastScanTime(address, scannerId, null);
|
|
183
183
|
}
|
|
184
184
|
}
|
|
185
|
+
/**
|
|
186
|
+
* Accepts one externally supplied signal/context payload for a push-driven
|
|
187
|
+
* scanner.
|
|
188
|
+
*
|
|
189
|
+
* This path intentionally reuses the engine's runtime bootstrap, result
|
|
190
|
+
* normalization, persistence, retained-context storage, and lifecycle
|
|
191
|
+
* callbacks so external ingests look like ordinary scanner attempts to the
|
|
192
|
+
* rest of the runtime.
|
|
193
|
+
*
|
|
194
|
+
* The in-flight marker is set before the first awaited store read. That
|
|
195
|
+
* preserves the same single-run-per-scanner invariant as interval scans even
|
|
196
|
+
* when two gateway ingests arrive in the same event-loop turn.
|
|
197
|
+
*/
|
|
198
|
+
async ingestExternalScannerData(address, request) {
|
|
199
|
+
const entry = this.requireExternalIngestRegistration(address, request.scanner);
|
|
200
|
+
if (entry.lastScanTime !== null) {
|
|
201
|
+
throw new ExternalScannerIngestError("UNAVAILABLE", `External scanner '${request.scanner}' is already processing an ingest for strategy '${address}'.`);
|
|
202
|
+
}
|
|
203
|
+
const attemptTimestamp = this.now();
|
|
204
|
+
this.registry.setLastScanTime(address, request.scanner, attemptTimestamp);
|
|
205
|
+
let emittedRunStart = false;
|
|
206
|
+
try {
|
|
207
|
+
const runtimeConfig = (await this.getConfig(address, request.scanner));
|
|
208
|
+
const prepared = prepareExternalScannerIngest({
|
|
209
|
+
address,
|
|
210
|
+
request,
|
|
211
|
+
config: runtimeConfig,
|
|
212
|
+
outputs: entry.scanner.definition.outputs,
|
|
213
|
+
defaultSignalType: entry.scanner.definition.signalType,
|
|
214
|
+
now: () => attemptTimestamp,
|
|
215
|
+
});
|
|
216
|
+
this.emitRunStart({
|
|
217
|
+
address,
|
|
218
|
+
scannerId: request.scanner,
|
|
219
|
+
timestamp: attemptTimestamp,
|
|
220
|
+
});
|
|
221
|
+
emittedRunStart = true;
|
|
222
|
+
await this.ensureInitializedRuntime(entry);
|
|
223
|
+
await this.persistExternalContextIfNeeded(entry, prepared);
|
|
224
|
+
const result = buildExternalIngestResult(entry, prepared, () => attemptTimestamp, this.deps.logger);
|
|
225
|
+
await this.commitRunResult(address, request.scanner, result);
|
|
226
|
+
return {
|
|
227
|
+
accepted: true,
|
|
228
|
+
address,
|
|
229
|
+
scanner: request.scanner,
|
|
230
|
+
timestamp: result.timestamp,
|
|
231
|
+
signalCount: result.signals.length,
|
|
232
|
+
contextUpdated: prepared.contextUpdated,
|
|
233
|
+
};
|
|
234
|
+
}
|
|
235
|
+
catch (error) {
|
|
236
|
+
if (!emittedRunStart) {
|
|
237
|
+
throw error;
|
|
238
|
+
}
|
|
239
|
+
const failure = this.buildFailureResult(entry, error);
|
|
240
|
+
this.emitRunResult(failure);
|
|
241
|
+
if (error instanceof ExternalScannerIngestError) {
|
|
242
|
+
throw error;
|
|
243
|
+
}
|
|
244
|
+
throw new ExternalScannerIngestError("UNAVAILABLE", failure.reason ?? "External scanner ingest failed.");
|
|
245
|
+
}
|
|
246
|
+
finally {
|
|
247
|
+
this.registry.setLastScanTime(address, request.scanner, null);
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
async commitRunResult(address, scannerId, result) {
|
|
251
|
+
const entry = this.requireRegistration(address, scannerId);
|
|
252
|
+
await this.persistIfNeeded(entry, result);
|
|
253
|
+
this.emitRunResult(result);
|
|
254
|
+
return result;
|
|
255
|
+
}
|
|
185
256
|
/** Executes one scanner plus its dependency chain immediately in topological order. */
|
|
186
257
|
async runChain(address, scannerId) {
|
|
187
258
|
const chain = this.composition.getRunChain(scannerId);
|
|
@@ -287,7 +358,7 @@ export class ScannerEngine {
|
|
|
287
358
|
}
|
|
288
359
|
schedule(entry) {
|
|
289
360
|
const scannerId = entry.scanner.definition.id;
|
|
290
|
-
if (entry.timer || !entry.enabled) {
|
|
361
|
+
if (entry.timer || !entry.enabled || entry.scheduleMode !== "interval") {
|
|
291
362
|
return;
|
|
292
363
|
}
|
|
293
364
|
const intervalMs = Math.max(entry.intervalSeconds, 1) * 1000;
|
|
@@ -301,7 +372,7 @@ export class ScannerEngine {
|
|
|
301
372
|
this.registry.setNextRunAt(entry.address, scannerId, this.now() + intervalMs);
|
|
302
373
|
const timer = setInterval(() => {
|
|
303
374
|
this.registry.setNextRunAt(entry.address, scannerId, this.now() + intervalMs);
|
|
304
|
-
this.deps.logger?.
|
|
375
|
+
this.deps.logger?.debug?.("Scheduled timer fired, invoking runOnce", {
|
|
305
376
|
address: entry.address,
|
|
306
377
|
scannerId,
|
|
307
378
|
});
|
|
@@ -368,6 +439,26 @@ export class ScannerEngine {
|
|
|
368
439
|
}
|
|
369
440
|
await this.deps.stores.signalStore.write(result, entry.scanner.definition);
|
|
370
441
|
}
|
|
442
|
+
/**
|
|
443
|
+
* Commits retained context for external ingests through the same shared
|
|
444
|
+
* artifact store used by built-in scanners.
|
|
445
|
+
*
|
|
446
|
+
* Built-in scanners write context from inside `scan()` via
|
|
447
|
+
* `ctx.saveSharedArtifact(...)`. External scanners do not execute scanner
|
|
448
|
+
* logic, so the engine must preserve that boundary explicitly here.
|
|
449
|
+
*/
|
|
450
|
+
async persistExternalContextIfNeeded(entry, prepared) {
|
|
451
|
+
if (!prepared.contextUpdated || prepared.retainedContext === null) {
|
|
452
|
+
return;
|
|
453
|
+
}
|
|
454
|
+
const producedContract = entry.scanner.definition.artifacts?.produces?.[0];
|
|
455
|
+
if (!producedContract) {
|
|
456
|
+
throw new Error(`External scanner '${entry.scanner.definition.id}' declared context output but is missing a produced context contract.`);
|
|
457
|
+
}
|
|
458
|
+
await this.deps.stores.sharedArtifactStore.saveByScanner(entry.address, entry.scanner.definition.id, prepared.retainedContext, {
|
|
459
|
+
contract: producedContract,
|
|
460
|
+
});
|
|
461
|
+
}
|
|
371
462
|
/**
|
|
372
463
|
* Returns the registered strategy/scanner runtime entry or throws when the
|
|
373
464
|
* requested pair is unknown to the engine.
|
|
@@ -379,6 +470,31 @@ export class ScannerEngine {
|
|
|
379
470
|
}
|
|
380
471
|
return entry;
|
|
381
472
|
}
|
|
473
|
+
/**
|
|
474
|
+
* Resolves the target registration for an external ingest and enforces the
|
|
475
|
+
* routing invariants that make the ingest path safe.
|
|
476
|
+
*
|
|
477
|
+
* Route validation happens here instead of in the runtime/plugin layers so
|
|
478
|
+
* every caller shares the same rules for unknown scanners, disabled targets,
|
|
479
|
+
* and non-external registrations. Payload-shape compatibility with
|
|
480
|
+
* signal-only versus context-producing scanners stays in the ingest validator.
|
|
481
|
+
*/
|
|
482
|
+
requireExternalIngestRegistration(address, scannerId) {
|
|
483
|
+
let entry;
|
|
484
|
+
try {
|
|
485
|
+
entry = this.requireRegistration(address, scannerId);
|
|
486
|
+
}
|
|
487
|
+
catch {
|
|
488
|
+
throw new ExternalScannerIngestError("NOT_FOUND", `Scanner '${scannerId}' is not registered for strategy '${address}'.`);
|
|
489
|
+
}
|
|
490
|
+
if (entry.scheduleMode !== "external") {
|
|
491
|
+
throw new ExternalScannerIngestError("INVALID_REQUEST", `Scanner '${scannerId}' is not an external_scanner for strategy '${address}'.`);
|
|
492
|
+
}
|
|
493
|
+
if (!entry.enabled) {
|
|
494
|
+
throw new ExternalScannerIngestError("INVALID_REQUEST", `External scanner '${scannerId}' is disabled for strategy '${address}'.`);
|
|
495
|
+
}
|
|
496
|
+
return entry;
|
|
497
|
+
}
|
|
382
498
|
defaultStateFor(entry) {
|
|
383
499
|
const definition = entry.scanner.definition;
|
|
384
500
|
if (definition.defaultState === undefined) {
|
|
@@ -439,7 +555,9 @@ export class ScannerEngine {
|
|
|
439
555
|
});
|
|
440
556
|
for (const scannerId of sourceIds) {
|
|
441
557
|
for (const entry of this.registry.list().filter((candidate) => {
|
|
442
|
-
return candidate.scanner.definition.id === scannerId &&
|
|
558
|
+
return (candidate.scanner.definition.id === scannerId &&
|
|
559
|
+
candidate.enabled &&
|
|
560
|
+
candidate.scheduleMode === "interval");
|
|
443
561
|
})) {
|
|
444
562
|
const producedContract = entry.scanner.definition.artifacts?.produces?.[0];
|
|
445
563
|
if (!producedContract) {
|