backtest-kit 6.12.0 → 6.14.0

package/build/index.cjs

@@ -147,6 +147,9 @@ const reportServices$1 = {
     highestProfitReportService: Symbol('highestProfitReportService'),
     maxDrawdownReportService: Symbol('maxDrawdownReportService'),
 };
+const helperServices$1 = {
+    notificationHelperService: Symbol('notificationHelperService'),
+};
 const validationServices$1 = {
     exchangeValidationService: Symbol('exchangeValidationService'),
     strategyValidationService: Symbol('strategyValidationService'),
@@ -172,6 +175,7 @@ const TYPES = {
     ...markdownServices$1,
     ...reportServices$1,
     ...validationServices$1,
+    ...helperServices$1,
 };
 
 /**
@@ -764,6 +768,11 @@ const highestProfitSubject = new functoolsKit.Subject();
  * Allows users to track drawdown levels and implement custom risk management logic based on drawdown thresholds.
  */
 const maxDrawdownSubject = new functoolsKit.Subject();
+/**
+ * Signal info emitter for user-defined informational notes on open positions.
+ * Emits when a strategy calls commitSignalInfo() to broadcast a custom annotation.
+ */
+const signalNotifySubject = new functoolsKit.Subject();
 
 var emitters = /*#__PURE__*/Object.freeze({
     __proto__: null,
@@ -788,6 +797,7 @@ var emitters = /*#__PURE__*/Object.freeze({
     signalBacktestEmitter: signalBacktestEmitter,
     signalEmitter: signalEmitter,
     signalLiveEmitter: signalLiveEmitter,
+    signalNotifySubject: signalNotifySubject,
     strategyCommitSubject: strategyCommitSubject,
     syncSubject: syncSubject,
     validationSubject: validationSubject,
@@ -1002,6 +1012,12 @@ const PERSIST_MEMORY_UTILS_METHOD_NAME_LIST_DATA = "PersistMemoryUtils.listMemor
 const PERSIST_MEMORY_UTILS_METHOD_NAME_HAS_DATA = "PersistMemoryUtils.hasMemoryData";
 const PERSIST_MEMORY_UTILS_METHOD_NAME_CLEAR = "PersistMemoryUtils.clear";
 const PERSIST_MEMORY_UTILS_METHOD_NAME_DISPOSE = "PersistMemoryUtils.dispose";
+const PERSIST_RECENT_UTILS_METHOD_NAME_USE_PERSIST_RECENT_ADAPTER = "PersistRecentUtils.usePersistRecentAdapter";
+const PERSIST_RECENT_UTILS_METHOD_NAME_READ_DATA = "PersistRecentUtils.readRecentData";
+const PERSIST_RECENT_UTILS_METHOD_NAME_WRITE_DATA = "PersistRecentUtils.writeRecentData";
+const PERSIST_RECENT_UTILS_METHOD_NAME_USE_JSON = "PersistRecentUtils.useJson";
+const PERSIST_RECENT_UTILS_METHOD_NAME_USE_DUMMY = "PersistRecentUtils.useDummy";
+const PERSIST_RECENT_UTILS_METHOD_NAME_CLEAR = "PersistRecentUtils.clear";
 const BASE_WAIT_FOR_INIT_FN_METHOD_NAME = "PersistBase.waitForInitFn";
 const BASE_UNLINK_RETRY_COUNT = 5;
 const BASE_UNLINK_RETRY_DELAY = 1000;
@@ -2848,6 +2864,115 @@ class PersistMemoryUtils {
  * ```
  */
 const PersistMemoryAdapter = new PersistMemoryUtils();
+/**
+ * Utility class for managing recent signal persistence.
+ *
+ * Features:
+ * - Memoized storage instances per (symbol, strategyName, exchangeName, frameName) context
+ * - Custom adapter support
+ * - Atomic read/write operations
+ * - Crash-safe recent signal state management
+ *
+ * Used by RecentPersistBacktestUtils/RecentPersistLiveUtils for recent signal persistence.
+ */
+class PersistRecentUtils {
+    constructor() {
+        this.PersistRecentFactory = PersistBase;
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => this.createKeyParts(symbol, strategyName, exchangeName, frameName, backtest).join(":"), (symbol, strategyName, exchangeName, frameName, backtest) => Reflect.construct(this.PersistRecentFactory, [
+            this.createKeyParts(symbol, strategyName, exchangeName, frameName, backtest).join("_"),
+            `./dump/data/recent/`,
+        ]));
+        /**
+         * Reads the latest persisted recent signal for a given context.
+         *
+         * Returns null if no recent signal exists.
+         *
+         * @param symbol - Trading pair symbol
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @returns Promise resolving to recent signal or null
+         */
+        this.readRecentData = async (symbol, strategyName, exchangeName, frameName, backtest) => {
+            LOGGER_SERVICE$7.info(PERSIST_RECENT_UTILS_METHOD_NAME_READ_DATA);
+            const key = this.createKeyParts(symbol, strategyName, exchangeName, frameName, backtest).join(":");
+            const isInitial = !this.getStorage.has(key);
+            const stateStorage = this.getStorage(symbol, strategyName, exchangeName, frameName, backtest);
+            await stateStorage.waitForInit(isInitial);
+            if (await stateStorage.hasValue(symbol)) {
+                return await stateStorage.readValue(symbol);
+            }
+            return null;
+        };
+        /**
+         * Writes the latest recent signal to disk with atomic file writes.
+         *
+         * Uses symbol as the entity ID within the per-context storage instance.
+         * Uses atomic writes to prevent corruption on crashes.
+         *
+         * @param signalRow - Recent signal data to persist
+         * @param symbol - Trading pair symbol
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @returns Promise that resolves when write is complete
+         */
+        this.writeRecentData = async (signalRow, symbol, strategyName, exchangeName, frameName, backtest) => {
+            LOGGER_SERVICE$7.info(PERSIST_RECENT_UTILS_METHOD_NAME_WRITE_DATA);
+            const key = this.createKeyParts(symbol, strategyName, exchangeName, frameName, backtest).join(":");
+            const isInitial = !this.getStorage.has(key);
+            const stateStorage = this.getStorage(symbol, strategyName, exchangeName, frameName, backtest);
+            await stateStorage.waitForInit(isInitial);
+            await stateStorage.writeValue(symbol, signalRow);
+        };
+    }
+    createKeyParts(symbol, strategyName, exchangeName, frameName, backtest) {
+        const parts = [symbol, strategyName, exchangeName];
+        if (frameName)
+            parts.push(frameName);
+        parts.push(backtest ? "backtest" : "live");
+        return parts;
+    }
+    /**
+     * Registers a custom persistence adapter.
+     *
+     * @param Ctor - Custom PersistBase constructor
+     */
+    usePersistRecentAdapter(Ctor) {
+        LOGGER_SERVICE$7.info(PERSIST_RECENT_UTILS_METHOD_NAME_USE_PERSIST_RECENT_ADAPTER);
+        this.PersistRecentFactory = Ctor;
+    }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        LOGGER_SERVICE$7.log(PERSIST_RECENT_UTILS_METHOD_NAME_CLEAR);
+        this.getStorage.clear();
+    }
+    /**
+     * Switches to the default JSON persist adapter.
+     * All future persistence writes will use JSON storage.
+     */
+    useJson() {
+        LOGGER_SERVICE$7.log(PERSIST_RECENT_UTILS_METHOD_NAME_USE_JSON);
+        this.usePersistRecentAdapter(PersistBase);
+    }
+    /**
+     * Switches to a dummy persist adapter that discards all writes.
+     * All future persistence writes will be no-ops.
+     */
+    useDummy() {
+        LOGGER_SERVICE$7.log(PERSIST_RECENT_UTILS_METHOD_NAME_USE_DUMMY);
+        this.usePersistRecentAdapter(PersistDummy);
+    }
+}
+/**
+ * Global singleton instance of PersistRecentUtils.
+ * Used by RecentPersistBacktestUtils/RecentPersistLiveUtils for recent signal persistence.
+ */
+const PersistRecentAdapter = new PersistRecentUtils();
 
 var _a$2, _b$2;
 const BUSY_DELAY = 100;
@@ -10175,7 +10300,7 @@ const GET_RISK_FN = (dto, backtest, exchangeName, frameName, self) => {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$t = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$v = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -10442,7 +10567,7 @@ class StrategyConnectionService {
          * @param backtest - Whether running in backtest mode
          * @returns Configured ClientStrategy instance
          */
-        this.getStrategy = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$t(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => {
+        this.getStrategy = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$v(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => {
             const { riskName = "", riskList = [], getSignal, interval = STRATEGY_DEFAULT_INTERVAL, callbacks, } = this.strategySchemaService.get(strategyName);
             return new ClientStrategy({
                 symbol,
@@ -11363,7 +11488,7 @@ class StrategyConnectionService {
                 }
                 return;
             }
-            const key = CREATE_KEY_FN$t(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$v(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             if (!this.getStrategy.has(key)) {
                 return;
             }
@@ -12532,7 +12657,7 @@ class ClientRisk {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$s = (riskName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$u = (riskName, exchangeName, frameName, backtest) => {
     const parts = [riskName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -12632,7 +12757,7 @@ class RiskConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientRisk instance
          */
-        this.getRisk = functoolsKit.memoize(([riskName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$s(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
+        this.getRisk = functoolsKit.memoize(([riskName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$u(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
             const schema = this.riskSchemaService.get(riskName);
             return new ClientRisk({
                 ...schema,
@@ -12701,7 +12826,7 @@ class RiskConnectionService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$s(payload.riskName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$u(payload.riskName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getRisk.clear(key);
             }
             else {
@@ -13745,7 +13870,7 @@ class ClientAction {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$r = (actionName, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$t = (actionName, strategyName, exchangeName, frameName, backtest) => {
     const parts = [actionName, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -13797,7 +13922,7 @@ class ActionConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientAction instance
          */
-        this.getAction = functoolsKit.memoize(([actionName, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$r(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
+        this.getAction = functoolsKit.memoize(([actionName, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$t(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
             const schema = this.actionSchemaService.get(actionName);
             return new ClientAction({
                 ...schema,
@@ -14008,7 +14133,7 @@ class ActionConnectionService {
                 await Promise.all(actions.map(async (action) => await action.dispose()));
                 return;
             }
-            const key = CREATE_KEY_FN$r(payload.actionName, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$t(payload.actionName, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             if (!this.getAction.has(key)) {
                 return;
             }
@@ -14019,14 +14144,14 @@ class ActionConnectionService {
     }
 }
 
-const METHOD_NAME_VALIDATE$2 = "exchangeCoreService validate";
+const METHOD_NAME_VALIDATE$3 = "exchangeCoreService validate";
 /**
  * Creates a unique key for memoizing validate calls.
  * Key format: "exchangeName"
  * @param exchangeName - Exchange name
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$q = (exchangeName) => {
+const CREATE_KEY_FN$s = (exchangeName) => {
     return exchangeName;
 };
 /**
@@ -14050,11 +14175,11 @@ class ExchangeCoreService {
          * @param exchangeName - Name of the exchange to validate
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = functoolsKit.memoize(([exchangeName]) => CREATE_KEY_FN$q(exchangeName), async (exchangeName) => {
-            this.loggerService.log(METHOD_NAME_VALIDATE$2, {
+        this.validate = functoolsKit.memoize(([exchangeName]) => CREATE_KEY_FN$s(exchangeName), async (exchangeName) => {
+            this.loggerService.log(METHOD_NAME_VALIDATE$3, {
                 exchangeName,
             });
-            this.exchangeValidationService.validate(exchangeName, METHOD_NAME_VALIDATE$2);
+            this.exchangeValidationService.validate(exchangeName, METHOD_NAME_VALIDATE$3);
         });
         /**
          * Fetches historical candles with execution context.
@@ -14295,14 +14420,14 @@ class ExchangeCoreService {
     }
 }
 
-const METHOD_NAME_VALIDATE$1 = "strategyCoreService validate";
+const METHOD_NAME_VALIDATE$2 = "strategyCoreService validate";
 /**
  * Creates a unique key for memoizing validate calls.
  * Key format: "strategyName:exchangeName:frameName"
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$p = (context) => {
+const CREATE_KEY_FN$r = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -14334,16 +14459,16 @@ class StrategyCoreService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$p(context), async (context) => {
-            this.loggerService.log(METHOD_NAME_VALIDATE$1, {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$r(context), async (context) => {
+            this.loggerService.log(METHOD_NAME_VALIDATE$2, {
                 context,
             });
             const { riskName, riskList } = this.strategySchemaService.get(context.strategyName);
-            this.strategyValidationService.validate(context.strategyName, METHOD_NAME_VALIDATE$1);
-            this.exchangeValidationService.validate(context.exchangeName, METHOD_NAME_VALIDATE$1);
-            context.frameName && this.frameValidationService.validate(context.frameName, METHOD_NAME_VALIDATE$1);
-            riskName && this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE$1);
-            riskList && riskList.forEach((riskName) => this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE$1));
+            this.strategyValidationService.validate(context.strategyName, METHOD_NAME_VALIDATE$2);
+            this.exchangeValidationService.validate(context.exchangeName, METHOD_NAME_VALIDATE$2);
+            context.frameName && this.frameValidationService.validate(context.frameName, METHOD_NAME_VALIDATE$2);
+            riskName && this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE$2);
+            riskList && riskList.forEach((riskName) => this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE$2));
         });
         /**
          * Retrieves the currently active pending signal for the symbol.
@@ -15672,7 +15797,7 @@ class SizingGlobalService {
  * @param context - Context with riskName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$o = (context) => {
+const CREATE_KEY_FN$q = (context) => {
     const parts = [context.riskName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -15698,7 +15823,7 @@ class RiskGlobalService {
          * @param payload - Payload with riskName, exchangeName and frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$o(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$q(context), async (context) => {
             this.loggerService.log("riskGlobalService validate", {
                 context,
             });
@@ -15769,14 +15894,14 @@ class RiskGlobalService {
     }
 }
 
-const METHOD_NAME_VALIDATE = "actionCoreService validate";
+const METHOD_NAME_VALIDATE$1 = "actionCoreService validate";
 /**
  * Creates a unique key for memoizing validate calls.
  * Key format: "strategyName:exchangeName:frameName"
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$n = (context) => {
+const CREATE_KEY_FN$p = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -15820,17 +15945,17 @@ class ActionCoreService {
          * @param context - Strategy execution context with strategyName, exchangeName and frameName
          * @returns Promise that resolves when all validations complete
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$n(context), async (context) => {
-            this.loggerService.log(METHOD_NAME_VALIDATE, {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$p(context), async (context) => {
+            this.loggerService.log(METHOD_NAME_VALIDATE$1, {
                 context,
             });
             const { riskName, riskList, actions } = this.strategySchemaService.get(context.strategyName);
-            this.strategyValidationService.validate(context.strategyName, METHOD_NAME_VALIDATE);
-            this.exchangeValidationService.validate(context.exchangeName, METHOD_NAME_VALIDATE);
-            context.frameName && this.frameValidationService.validate(context.frameName, METHOD_NAME_VALIDATE);
-            riskName && this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE);
-            riskList && riskList.forEach((riskName) => this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE));
-            actions && actions.forEach((actionName) => this.actionValidationService.validate(actionName, METHOD_NAME_VALIDATE));
+            this.strategyValidationService.validate(context.strategyName, METHOD_NAME_VALIDATE$1);
+            this.exchangeValidationService.validate(context.exchangeName, METHOD_NAME_VALIDATE$1);
+            context.frameName && this.frameValidationService.validate(context.frameName, METHOD_NAME_VALIDATE$1);
+            riskName && this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE$1);
+            riskList && riskList.forEach((riskName) => this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE$1));
+            actions && actions.forEach((actionName) => this.actionValidationService.validate(actionName, METHOD_NAME_VALIDATE$1));
         });
         /**
          * Initializes all ClientAction instances for the strategy.
@@ -20863,7 +20988,7 @@ const ReportWriter = new ReportWriterAdapter();
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$m = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$o = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -21109,7 +21234,7 @@ class BacktestMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$m(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$a(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$o(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$a(symbol, strategyName, exchangeName, frameName));
         /**
          * Processes tick events and accumulates closed signals.
          * Should be called from IStrategyCallbacks.onTick.
@@ -21266,7 +21391,7 @@ class BacktestMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$m(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$o(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -21328,7 +21453,7 @@ class BacktestMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$l = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$n = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -21823,7 +21948,7 @@ class LiveMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$l(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$9(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$n(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$9(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to live signal emitter to receive tick events.
          * Protected against multiple subscriptions.
@@ -22041,7 +22166,7 @@ class LiveMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$l(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$n(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -22061,7 +22186,7 @@ class LiveMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$k = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$m = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -22350,7 +22475,7 @@ class ScheduleMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$k(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$8(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$m(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$8(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to signal emitter to receive scheduled signal events.
          * Protected against multiple subscriptions.
@@ -22553,7 +22678,7 @@ class ScheduleMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$k(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$m(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -22573,7 +22698,7 @@ class ScheduleMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$j = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$l = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -22818,7 +22943,7 @@ class PerformanceMarkdownService {
          * Memoized function to get or create PerformanceStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$j(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new PerformanceStorage(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$l(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new PerformanceStorage(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to performance emitter to receive performance events.
          * Protected against multiple subscriptions.
@@ -22985,7 +23110,7 @@ class PerformanceMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$j(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$l(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -23464,7 +23589,7 @@ class WalkerMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$i = (exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$k = (exchangeName, frameName, backtest) => {
     const parts = [exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -23911,7 +24036,7 @@ class HeatMarkdownService {
          * Memoized function to get or create HeatmapStorage for exchange, frame and backtest mode.
          * Each exchangeName + frameName + backtest mode combination gets its own isolated heatmap storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([exchangeName, frameName, backtest]) => CREATE_KEY_FN$i(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
+        this.getStorage = functoolsKit.memoize(([exchangeName, frameName, backtest]) => CREATE_KEY_FN$k(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
         /**
          * Subscribes to signal emitter to receive tick events.
          * Protected against multiple subscriptions.
@@ -24129,7 +24254,7 @@ class HeatMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$i(payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$k(payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -25160,7 +25285,7 @@ class ClientPartial {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$h = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
+const CREATE_KEY_FN$j = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Creates a callback function for emitting profit events to partialProfitSubject.
  *
@@ -25282,7 +25407,7 @@ class PartialConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientPartial instance with logger and event emitters
          */
-        this.getPartial = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$h(signalId, backtest), (signalId, backtest) => {
+        this.getPartial = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$j(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -25372,7 +25497,7 @@ class PartialConnectionService {
             const partial = this.getPartial(data.id, backtest);
             await partial.waitForInit(symbol, data.strategyName, data.exchangeName, backtest);
             await partial.clear(symbol, data, priceClose, backtest);
-            const key = CREATE_KEY_FN$h(data.id, backtest);
+            const key = CREATE_KEY_FN$j(data.id, backtest);
             this.getPartial.clear(key);
         };
     }
@@ -25388,7 +25513,7 @@ class PartialConnectionService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$g = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$i = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -25611,7 +25736,7 @@ class PartialMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$g(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$6(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$i(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$6(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to partial profit/loss signal emitters to receive events.
          * Protected against multiple subscriptions.
@@ -25821,7 +25946,7 @@ class PartialMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$g(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$i(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -25837,7 +25962,7 @@ class PartialMarkdownService {
  * @param context - Context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$f = (context) => {
+const CREATE_KEY_FN$h = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -25911,7 +26036,7 @@ class PartialGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$f(context), (context, methodName) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$h(context), (context, methodName) => {
             this.loggerService.log("partialGlobalService validate", {
                 context,
                 methodName,
@@ -26366,7 +26491,7 @@ class ClientBreakeven {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$e = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
+const CREATE_KEY_FN$g = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Creates a callback function for emitting breakeven events to breakevenSubject.
  *
@@ -26452,7 +26577,7 @@ class BreakevenConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientBreakeven instance with logger and event emitter
          */
-        this.getBreakeven = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$e(signalId, backtest), (signalId, backtest) => {
+        this.getBreakeven = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$g(signalId, backtest), (signalId, backtest) => {
             return new ClientBreakeven({
                 signalId,
                 logger: this.loggerService,
@@ -26513,7 +26638,7 @@ class BreakevenConnectionService {
             const breakeven = this.getBreakeven(data.id, backtest);
             await breakeven.waitForInit(symbol, data.strategyName, data.exchangeName, backtest);
             await breakeven.clear(symbol, data, priceClose, backtest);
-            const key = CREATE_KEY_FN$e(data.id, backtest);
+            const key = CREATE_KEY_FN$g(data.id, backtest);
             this.getBreakeven.clear(key);
         };
     }
@@ -26529,7 +26654,7 @@ class BreakevenConnectionService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$d = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$f = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -26704,7 +26829,7 @@ class BreakevenMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$d(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$5(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$f(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$5(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to breakeven signal emitter to receive events.
          * Protected against multiple subscriptions.
@@ -26893,7 +27018,7 @@ class BreakevenMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$d(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$f(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -26909,7 +27034,7 @@ class BreakevenMarkdownService {
  * @param context - Context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$c = (context) => {
+const CREATE_KEY_FN$e = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -26983,7 +27108,7 @@ class BreakevenGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$c(context), (context, methodName) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$e(context), (context, methodName) => {
             this.loggerService.log("breakevenGlobalService validate", {
                 context,
                 methodName,
@@ -27204,7 +27329,7 @@ class ConfigValidationService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$b = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$d = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -27371,7 +27496,7 @@ class RiskMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$b(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$4(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$d(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$4(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to risk rejection emitter to receive rejection events.
          * Protected against multiple subscriptions.
@@ -27560,7 +27685,7 @@ class RiskMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$b(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$d(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -29942,7 +30067,7 @@ class HighestProfitReportService {
  * @returns Colon-separated key string for memoization
  * @internal
  */
-const CREATE_KEY_FN$a = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$c = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -30184,7 +30309,7 @@ class StrategyMarkdownService {
          *
          * @internal
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$a(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$3(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$c(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$3(symbol, strategyName, exchangeName, frameName));
         /**
          * Records a cancel-scheduled event when a scheduled signal is cancelled.
          *
@@ -30758,7 +30883,7 @@ class StrategyMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("strategyMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$a(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$c(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -30866,7 +30991,7 @@ class StrategyMarkdownService {
  * Creates a unique key for memoizing ReportStorage instances.
  * Key format: "symbol:strategyName:exchangeName[:frameName]:backtest|live"
  */
-const CREATE_KEY_FN$9 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$b = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -31059,7 +31184,7 @@ let ReportStorage$2 = class ReportStorage {
 class SyncMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$9(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$2(symbol, strategyName, exchangeName, frameName, backtest));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$b(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$2(symbol, strategyName, exchangeName, frameName, backtest));
         /**
          * Subscribes to `syncSubject` to start receiving `SignalSyncContract` events.
          * Protected against multiple subscriptions via `singleshot` — subsequent calls
@@ -31255,7 +31380,7 @@ class SyncMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("syncMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$9(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$b(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -31268,7 +31393,7 @@ class SyncMarkdownService {
 /**
  * Creates a unique memoization key for a symbol-strategy-exchange-frame-backtest combination.
  */
-const CREATE_KEY_FN$8 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$a = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -31444,7 +31569,7 @@ let ReportStorage$1 = class ReportStorage {
 class HighestProfitMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$8(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$1(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$a(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$1(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to `highestProfitSubject` to start receiving `HighestProfitContract`
          * events. Protected against multiple subscriptions via `singleshot` — subsequent
@@ -31610,7 +31735,7 @@ class HighestProfitMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("highestProfitMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$8(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$a(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -31632,7 +31757,7 @@ const LISTEN_TIMEOUT$1 = 120000;
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$7 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$9 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -31675,7 +31800,7 @@ class PriceMetaService {
          * Each subject holds the latest currentPrice emitted by the strategy iterator for that key.
          * Instances are cached until clear() is called.
          */
-        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$7(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
+        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$9(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
         /**
          * Returns the current market price for the given symbol and context.
          *
@@ -31704,10 +31829,10 @@ class PriceMetaService {
             if (source.data) {
                 return source.data;
             }
-            console.warn(`PriceMetaService: No currentPrice available for ${CREATE_KEY_FN$7(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}. Trying to fetch from strategy iterator as a fallback...`);
+            console.warn(`PriceMetaService: No currentPrice available for ${CREATE_KEY_FN$9(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}. Trying to fetch from strategy iterator as a fallback...`);
             const currentPrice = await functoolsKit.waitForNext(source, (data) => !!data, LISTEN_TIMEOUT$1);
             if (typeof currentPrice === "symbol") {
-                throw new Error(`PriceMetaService: Timeout while waiting for currentPrice for ${CREATE_KEY_FN$7(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
+                throw new Error(`PriceMetaService: Timeout while waiting for currentPrice for ${CREATE_KEY_FN$9(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
             }
             return currentPrice;
         };
@@ -31749,7 +31874,7 @@ class PriceMetaService {
                 this.getSource.clear();
                 return;
             }
-            const key = CREATE_KEY_FN$7(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$9(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             this.getSource.clear(key);
         };
     }
@@ -31767,7 +31892,7 @@ const LISTEN_TIMEOUT = 120000;
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$6 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$8 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -31810,7 +31935,7 @@ class TimeMetaService {
          * Each subject holds the latest createdAt timestamp emitted by the strategy iterator for that key.
          * Instances are cached until clear() is called.
          */
-        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$6(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
+        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$8(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
         /**
          * Returns the current candle timestamp (in milliseconds) for the given symbol and context.
          *
@@ -31838,10 +31963,10 @@ class TimeMetaService {
             if (source.data) {
                 return source.data;
             }
-            console.warn(`TimeMetaService: No timestamp available for ${CREATE_KEY_FN$6(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}. Trying to fetch from strategy iterator as a fallback...`);
+            console.warn(`TimeMetaService: No timestamp available for ${CREATE_KEY_FN$8(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}. Trying to fetch from strategy iterator as a fallback...`);
             const timestamp = await functoolsKit.waitForNext(source, (data) => !!data, LISTEN_TIMEOUT);
             if (typeof timestamp === "symbol") {
-                throw new Error(`TimeMetaService: Timeout while waiting for timestamp for ${CREATE_KEY_FN$6(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
+                throw new Error(`TimeMetaService: Timeout while waiting for timestamp for ${CREATE_KEY_FN$8(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
             }
             return timestamp;
         };
@@ -31883,7 +32008,7 @@ class TimeMetaService {
                 this.getSource.clear();
                 return;
             }
-            const key = CREATE_KEY_FN$6(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$8(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             this.getSource.clear(key);
         };
     }
@@ -31979,7 +32104,7 @@ class MaxDrawdownReportService {
 /**
  * Creates a unique memoization key for a symbol-strategy-exchange-frame-backtest combination.
  */
-const CREATE_KEY_FN$5 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$7 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -32103,7 +32228,7 @@ class ReportStorage {
 class MaxDrawdownMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$5(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$7(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to `maxDrawdownSubject` to start receiving `MaxDrawdownContract`
          * events. Protected against multiple subscriptions via `singleshot`.
@@ -32182,7 +32307,7 @@ class MaxDrawdownMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("maxDrawdownMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$5(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$7(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -32192,6 +32317,125 @@ class MaxDrawdownMarkdownService {
     }
 }
 
+const METHOD_NAME_COMMIT_SIGNAL_NOTIFY = "notificationHelperService.commitSignalNotify";
+const METHOD_NAME_VALIDATE = "notificationHelperService.validate";
+/**
+ * Creates a unique key for memoizing validate calls.
+ * Key format: "strategyName:exchangeName:frameName"
+ * @param context - Execution context with strategyName, exchangeName, frameName
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$6 = (context) => {
+    const parts = [context.strategyName, context.exchangeName];
+    if (context.frameName)
+        parts.push(context.frameName);
+    return parts.join(":");
+};
+/**
+ * Helper service for emitting signal info notifications.
+ *
+ * Handles validation (memoized per context) and emission of `signal.info` events
+ * via `signalNotifySubject`. Used internally by the framework action pipeline —
+ * end users interact with this via `commitSignalNotify()` in `onActivePing` callbacks.
+ */
+class NotificationHelperService {
+    constructor() {
+        this.loggerService = inject(TYPES.loggerService);
+        this.strategySchemaService = inject(TYPES.strategySchemaService);
+        this.riskValidationService = inject(TYPES.riskValidationService);
+        this.strategyValidationService = inject(TYPES.strategyValidationService);
+        this.exchangeValidationService = inject(TYPES.exchangeValidationService);
+        this.frameValidationService = inject(TYPES.frameValidationService);
+        this.actionValidationService = inject(TYPES.actionValidationService);
+        this.strategyCoreService = inject(TYPES.strategyCoreService);
+        this.timeMetaService = inject(TYPES.timeMetaService);
+        /**
+         * Validates strategy, exchange, frame, risk, and action schemas for the given context.
+         *
+         * Memoized per unique `"strategyName:exchangeName[:frameName]"` key — subsequent calls
+         * with the same context are no-ops, so validation runs at most once per context.
+         *
+         * @param context - Routing context: strategyName, exchangeName, frameName
+         * @throws {Error} If any registered schema fails validation
+         */
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$6(context), async (context) => {
+            this.loggerService.log(METHOD_NAME_VALIDATE, {
+                context,
+            });
+            this.strategyValidationService.validate(context.strategyName, METHOD_NAME_VALIDATE);
+            this.exchangeValidationService.validate(context.exchangeName, METHOD_NAME_VALIDATE);
+            const { riskName, riskList, actions } = this.strategySchemaService.get(context.strategyName);
+            context.frameName &&
+                this.frameValidationService.validate(context.frameName, METHOD_NAME_VALIDATE);
+            riskName &&
+                this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE);
+            riskList &&
+                riskList.forEach((riskName) => this.riskValidationService.validate(riskName, METHOD_NAME_VALIDATE));
+            actions &&
+                actions.forEach((actionName) => this.actionValidationService.validate(actionName, METHOD_NAME_VALIDATE));
+        });
+        /**
+         * Emits a `signal.info` notification for the currently active pending signal.
+         *
+         * Validates all schemas (via memoized `validate`), resolves the pending signal
+         * for the given symbol, then emits a `SignalInfoContract` via `signalNotifySubject`,
+         * which is routed to all registered `listenSignalNotify` callbacks and persisted
+         * by `NotificationAdapter`.
+         *
+         * @param payload - Optional notification fields (notificationId, notificationNote)
+         * @param symbol - Trading pair symbol (e.g. "BTCUSDT")
+         * @param currentPrice - Market price at the time of the call
+         * @param context - Routing context: strategyName, exchangeName, frameName
+         * @param backtest - true when called during a backtest run
+         *
+         * @throws {Error} If no active pending signal is found for the given symbol
+         *
+         * @example
+         * ```typescript
+         * // Inside onActivePing callback:
+         * await commitSignalNotify("BTCUSDT", {
+         *   notificationNote: "RSI crossed 70, consider closing",
+         *   notificationId: "msg-123",
+         * });
+         * ```
+         */
+        this.commitSignalNotify = async (payload, symbol, currentPrice, context, backtest) => {
+            this.loggerService.info(METHOD_NAME_COMMIT_SIGNAL_NOTIFY, {
+                symbol,
+                context,
+                backtest,
+                currentPrice,
+            });
+            this.validate(context);
+            const pendingSignal = await this.strategyCoreService.getPendingSignal(backtest, symbol, currentPrice, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: "",
+            });
+            if (!pendingSignal) {
+                throw new Error(`SignalUtils notify No pending signal found symbol=${symbol} `);
+            }
+            const timestamp = await this.timeMetaService.getTimestamp(symbol, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+            }, backtest);
+            await signalNotifySubject.next({
+                backtest,
+                symbol,
+                currentPrice,
+                data: pendingSignal,
+                exchangeName: context.exchangeName,
+                strategyName: context.strategyName,
+                frameName: context.frameName,
+                note: payload.notificationNote || pendingSignal.note,
+                notificationId: payload.notificationId,
+                timestamp,
+            });
+        };
+    }
+}
+
 {
     provide(TYPES.loggerService, () => new LoggerService());
 }
@@ -32280,6 +32524,9 @@ class MaxDrawdownMarkdownService {
     provide(TYPES.highestProfitReportService, () => new HighestProfitReportService());
     provide(TYPES.maxDrawdownReportService, () => new MaxDrawdownReportService());
 }
+{
+    provide(TYPES.notificationHelperService, () => new NotificationHelperService());
+}
 {
     provide(TYPES.exchangeValidationService, () => new ExchangeValidationService());
     provide(TYPES.strategyValidationService, () => new StrategyValidationService());
@@ -32380,6 +32627,9 @@ const reportServices = {
     highestProfitReportService: inject(TYPES.highestProfitReportService),
     maxDrawdownReportService: inject(TYPES.maxDrawdownReportService),
 };
+const helperServices = {
+    notificationHelperService: inject(TYPES.notificationHelperService),
+};
 const validationServices = {
     exchangeValidationService: inject(TYPES.exchangeValidationService),
     strategyValidationService: inject(TYPES.strategyValidationService),
@@ -32405,6 +32655,7 @@ const backtest = {
     ...markdownServices,
     ...reportServices,
     ...validationServices,
+    ...helperServices,
 };
 init();
 
@@ -35321,6 +35572,7 @@ const GET_POSITION_ENTRY_OVERLAP_METHOD_NAME = "strategy.getPositionEntryOverlap
 const GET_POSITION_PARTIAL_OVERLAP_METHOD_NAME = "strategy.getPositionPartialOverlap";
 const HAS_NO_PENDING_SIGNAL_METHOD_NAME = "strategy.hasNoPendingSignal";
 const HAS_NO_SCHEDULED_SIGNAL_METHOD_NAME = "strategy.hasNoScheduledSignal";
+const COMMIT_SIGNAL_NOTIFY_METHOD_NAME = "strategy.commitSignalNotify";
 /**
  * Cancels the scheduled signal without stopping the strategy.
  *
@@ -37285,6 +37537,50 @@ async function hasNoScheduledSignal(symbol) {
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     return await functoolsKit.not(backtest.strategyCoreService.hasScheduledSignal(isBacktest, symbol, { exchangeName, frameName, strategyName }));
 }
+/**
+ * Emits a `signal.info` notification for the currently active pending signal.
+ *
+ * Broadcasts a user-defined informational note without affecting position state.
+ * Useful for annotating strategy decisions, triggering external alerts, or logging
+ * mid-position events (e.g. RSI crossing a threshold, volume spike detected).
+ *
+ * Automatically reads backtest/live mode from execution context.
+ * Automatically reads strategyName, exchangeName, frameName from method context.
+ * Automatically fetches current price via getAveragePrice.
+ *
+ * @param symbol - Trading pair symbol (e.g. "BTCUSDT")
+ * @param payload - Optional notification fields
+ * @param payload.notificationNote - Human-readable note. Falls back to signal.note if omitted.
+ * @param payload.notificationId - Optional correlation ID for external systems (e.g. Telegram message ID).
+ *
+ * @throws {Error} If called outside an execution context
+ * @throws {Error} If called outside a method context
+ * @throws {Error} If no active pending signal exists for the given symbol
+ *
+ * @example
+ * ```typescript
+ * import { commitSignalNotify } from "backtest-kit";
+ *
+ * // Inside onActivePing callback:
+ * await commitSignalNotify("BTCUSDT", {
+ *   notificationNote: "RSI crossed 70, consider closing",
+ *   notificationId: "msg-123",
+ * });
+ * ```
+ */
+async function commitSignalNotify(symbol, payload = {}) {
+    backtest.loggerService.info(COMMIT_SIGNAL_NOTIFY_METHOD_NAME, { symbol, payload });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("commitSignalNotify requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("commitSignalNotify requires a method context");
+    }
+    const currentPrice = await getAveragePrice(symbol);
+    const { backtest: isBacktest } = backtest.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    await backtest.notificationHelperService.commitSignalNotify(payload, symbol, currentPrice, { strategyName, exchangeName, frameName }, isBacktest);
+}
 
 const STOP_STRATEGY_METHOD_NAME = "control.stopStrategy";
 /**
@@ -37368,6 +37664,8 @@ const LISTEN_HIGHEST_PROFIT_METHOD_NAME = "event.listenHighestProfit";
 const LISTEN_HIGHEST_PROFIT_ONCE_METHOD_NAME = "event.listenHighestProfitOnce";
 const LISTEN_MAX_DRAWDOWN_METHOD_NAME = "event.listenMaxDrawdown";
 const LISTEN_MAX_DRAWDOWN_ONCE_METHOD_NAME = "event.listenMaxDrawdownOnce";
+const LISTEN_SIGNAL_NOTIFY_METHOD_NAME = "event.listenSignalNotify";
+const LISTEN_SIGNAL_NOTIFY_ONCE_METHOD_NAME = "event.listenSignalNotifyOnce";
 /**
  * Subscribes to all signal events with queued async processing.
  *
@@ -38759,6 +39057,46 @@ function listenMaxDrawdownOnce(filterFn, fn) {
     };
     return disposeFn = listenMaxDrawdown(wrappedFn);
 }
+/**
+ * Subscribes to signal info events with queued async processing.
+ * Emits when a strategy calls commitSignalInfo() to broadcast a user-defined note for an open position.
+ * Events are processed sequentially in order received, even if callback is async.
+ * Uses queued wrapper to prevent concurrent execution of the callback.
+ * @param fn - Callback function to handle signal info events
+ * @return Unsubscribe function to stop listening to events
+ */
+function listenSignalNotify(fn) {
+    backtest.loggerService.log(LISTEN_SIGNAL_NOTIFY_METHOD_NAME);
+    const wrappedFn = async (event) => {
+        if (await backtest.strategyCoreService.hasPendingSignal(event.backtest, event.symbol, {
+            strategyName: event.strategyName,
+            exchangeName: event.exchangeName,
+            frameName: event.frameName,
+        })) {
+            await fn(event);
+        }
+    };
+    return signalNotifySubject.subscribe(functoolsKit.queued(wrappedFn));
+}
+/**
+ * Subscribes to filtered signal info events with one-time execution.
+ * Listens for events matching the filter predicate, then executes callback once
+ * and automatically unsubscribes.
+ * @param filterFn - Predicate to filter which events trigger the callback
+ * @param fn - Callback function to handle the filtered event (called only once)
+ * @return Unsubscribe function to cancel the listener before it fires
+ */
+function listenSignalNotifyOnce(filterFn, fn) {
+    backtest.loggerService.log(LISTEN_SIGNAL_NOTIFY_ONCE_METHOD_NAME);
+    let disposeFn;
+    const wrappedFn = async (event) => {
+        if (filterFn(event)) {
+            await fn(event);
+            disposeFn && disposeFn();
+        }
+    };
+    return disposeFn = listenSignalNotify(wrappedFn);
+}
 
 const BACKTEST_METHOD_NAME_RUN = "BacktestUtils.run";
 const BACKTEST_METHOD_NAME_BACKGROUND = "BacktestUtils.background";
@@ -38815,6 +39153,7 @@ const BACKTEST_METHOD_NAME_TRAILING_STOP_COST = "BacktestUtils.commitTrailingSto
 const BACKTEST_METHOD_NAME_TRAILING_PROFIT_COST = "BacktestUtils.commitTrailingTakeCost";
 const BACKTEST_METHOD_NAME_ACTIVATE_SCHEDULED = "Backtest.commitActivateScheduled";
 const BACKTEST_METHOD_NAME_AVERAGE_BUY = "Backtest.commitAverageBuy";
+const BACKTEST_METHOD_NAME_SIGNAL_NOTIFY = "Backtest.commitSignalNotify";
 const BACKTEST_METHOD_NAME_GET_DATA = "BacktestUtils.getData";
 const BACKTEST_METHOD_NAME_HAS_NO_PENDING_SIGNAL = "BacktestUtils.hasNoPendingSignal";
 const BACKTEST_METHOD_NAME_HAS_NO_SCHEDULED_SIGNAL = "BacktestUtils.hasNoScheduledSignal";
@@ -41170,6 +41509,33 @@ class BacktestUtils {
             });
             return await backtest.strategyCoreService.averageBuy(true, symbol, currentPrice, context, cost);
         };
+        /**
+         * Emits a `signal.info` notification for the currently active pending signal.
+         *
+         * @param symbol - Trading pair symbol
+         * @param currentPrice - Market price at the time of the call
+         * @param context - Execution context with strategyName, exchangeName, frameName
+         * @param payload - Optional notification fields (notificationNote, notificationId)
+         *
+         * @throws {Error} If no active pending signal exists for the given symbol
+         *
+         * @example
+         * ```typescript
+         * await Backtest.commitSignalNotify("BTCUSDT", 42000, {
+         *   strategyName: "my-strategy",
+         *   exchangeName: "binance",
+         *   frameName: "1h"
+         * }, { notificationNote: "RSI crossed 70" });
+         * ```
+         */
+        this.commitSignalNotify = async (symbol, currentPrice, context, payload = {}) => {
+            backtest.loggerService.info(BACKTEST_METHOD_NAME_SIGNAL_NOTIFY, {
+                symbol,
+                currentPrice,
+                context,
+            });
+            await backtest.notificationHelperService.commitSignalNotify(payload, symbol, currentPrice, context, true);
+        };
         /**
          * Gets statistical data from all closed signals for a symbol-strategy pair.
          *
@@ -41383,6 +41749,7 @@ const LIVE_METHOD_NAME_TRAILING_STOP_COST = "LiveUtils.commitTrailingStopCost";
 const LIVE_METHOD_NAME_TRAILING_PROFIT_COST = "LiveUtils.commitTrailingTakeCost";
 const LIVE_METHOD_NAME_ACTIVATE_SCHEDULED = "Live.commitActivateScheduled";
 const LIVE_METHOD_NAME_AVERAGE_BUY = "Live.commitAverageBuy";
+const LIVE_METHOD_NAME_SIGNAL_NOTIFY = "Live.commitSignalNotify";
 const LIVE_METHOD_NAME_HAS_NO_PENDING_SIGNAL = "LiveUtils.hasNoPendingSignal";
 const LIVE_METHOD_NAME_HAS_NO_SCHEDULED_SIGNAL = "LiveUtils.hasNoScheduledSignal";
 /**
@@ -44079,6 +44446,36 @@ class LiveUtils {
                 frameName: "",
             }, cost);
         };
+        /**
+         * Emits a `signal.info` notification for the currently active pending signal.
+         *
+         * @param symbol - Trading pair symbol
+         * @param currentPrice - Market price at the time of the call
+         * @param context - Execution context with strategyName and exchangeName
+         * @param payload - Optional notification fields (notificationNote, notificationId)
+         *
+         * @throws {Error} If no active pending signal exists for the given symbol
+         *
+         * @example
+         * ```typescript
+         * await Live.commitSignalNotify("BTCUSDT", 42000, {
+         *   strategyName: "my-strategy",
+         *   exchangeName: "binance",
+         * }, { notificationNote: "RSI crossed 70" });
+         * ```
+         */
+        this.commitSignalNotify = async (symbol, currentPrice, context, payload = {}) => {
+            backtest.loggerService.info(LIVE_METHOD_NAME_SIGNAL_NOTIFY, {
+                symbol,
+                currentPrice,
+                context,
+            });
+            await backtest.notificationHelperService.commitSignalNotify(payload, symbol, currentPrice, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: "",
+            }, false);
+        };
         /**
          * Gets statistical data from all live trading events for a symbol-strategy pair.
          *
@@ -45248,6 +45645,503 @@ async function listRiskSchema() {
     return await backtest.riskValidationService.list();
 }
 
+const RECENT_PERSIST_BACKTEST_METHOD_NAME_HANDLE_ACTIVE_PING = "RecentPersistBacktestUtils.handleActivePing";
+const RECENT_PERSIST_BACKTEST_METHOD_NAME_GET_LATEST_SIGNAL = "RecentPersistBacktestUtils.getLatestSignal";
+const RECENT_PERSIST_LIVE_METHOD_NAME_HANDLE_ACTIVE_PING = "RecentPersistLiveUtils.handleActivePing";
+const RECENT_PERSIST_LIVE_METHOD_NAME_GET_LATEST_SIGNAL = "RecentPersistLiveUtils.getLatestSignal";
+const RECENT_MEMORY_BACKTEST_METHOD_NAME_HANDLE_ACTIVE_PING = "RecentMemoryBacktestUtils.handleActivePing";
+const RECENT_MEMORY_BACKTEST_METHOD_NAME_GET_LATEST_SIGNAL = "RecentMemoryBacktestUtils.getLatestSignal";
+const RECENT_MEMORY_LIVE_METHOD_NAME_HANDLE_ACTIVE_PING = "RecentMemoryLiveUtils.handleActivePing";
+const RECENT_MEMORY_LIVE_METHOD_NAME_GET_LATEST_SIGNAL = "RecentMemoryLiveUtils.getLatestSignal";
+const RECENT_BACKTEST_ADAPTER_METHOD_NAME_HANDLE_ACTIVE_PING = "RecentBacktestAdapter.handleActivePing";
+const RECENT_BACKTEST_ADAPTER_METHOD_NAME_GET_LATEST_SIGNAL = "RecentBacktestAdapter.getLatestSignal";
+const RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER = "RecentBacktestAdapter.useRecentAdapter";
+const RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST = "RecentBacktestAdapter.usePersist";
+const RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY = "RecentBacktestAdapter.useMemory";
+const RECENT_BACKTEST_ADAPTER_METHOD_NAME_CLEAR = "RecentBacktestAdapter.clear";
+const RECENT_LIVE_ADAPTER_METHOD_NAME_HANDLE_ACTIVE_PING = "RecentLiveAdapter.handleActivePing";
+const RECENT_LIVE_ADAPTER_METHOD_NAME_GET_LATEST_SIGNAL = "RecentLiveAdapter.getLatestSignal";
+const RECENT_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER = "RecentLiveAdapter.useRecentAdapter";
+const RECENT_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST = "RecentLiveAdapter.usePersist";
+const RECENT_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY = "RecentLiveAdapter.useMemory";
+const RECENT_LIVE_ADAPTER_METHOD_NAME_CLEAR = "RecentLiveAdapter.clear";
+const RECENT_ADAPTER_METHOD_NAME_ENABLE = "RecentAdapter.enable";
+const RECENT_ADAPTER_METHOD_NAME_DISABLE = "RecentAdapter.disable";
+const RECENT_ADAPTER_METHOD_NAME_GET_LATEST_SIGNAL = "RecentAdapter.getLatestSignal";
+/**
+ * Builds a composite storage key from context parts.
+ * Includes backtest flag as the last segment to prevent live/backtest collisions.
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Strategy identifier
+ * @param exchangeName - Exchange identifier
+ * @param frameName - Frame identifier
+ * @param backtest - Flag indicating if the context is backtest or live
+ * @returns Composite key string
+ */
+const CREATE_KEY_FN$5 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+    const parts = [symbol, strategyName, exchangeName];
+    if (frameName)
+        parts.push(frameName);
+    parts.push(backtest ? "backtest" : "live");
+    return parts.join(":");
+};
+/**
+ * Persistent storage adapter for backtest recent signals.
+ *
+ * Features:
+ * - Persists the latest active signal per context to disk using PersistRecentAdapter
+ * - Handles active ping events only
+ *
+ * Use this adapter for backtest recent signal persistence across sessions.
+ */
+class RecentPersistBacktestUtils {
+    constructor() {
+        /**
+         * Handles active ping event.
+         * Persists the latest signal to disk via PersistRecentAdapter.
+         * @param event - Active ping contract with signal data and backtest flag
+         */
+        this.handleActivePing = async (event) => {
+            backtest.loggerService.info(RECENT_PERSIST_BACKTEST_METHOD_NAME_HANDLE_ACTIVE_PING, {
+                signalId: event.data.id,
+            });
+            await PersistRecentAdapter.writeRecentData(event.data, event.symbol, event.strategyName, event.exchangeName, event.data.frameName, event.backtest);
+        };
+        /**
+         * Retrieves the latest persisted signal for the given context.
+         * @param symbol - Trading pair symbol
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         * @returns The latest signal or null if not found
+         */
+        this.getLatestSignal = async (symbol, strategyName, exchangeName, frameName, backtest$1) => {
+            backtest.loggerService.info(RECENT_PERSIST_BACKTEST_METHOD_NAME_GET_LATEST_SIGNAL, {
+                symbol,
+                strategyName,
+                exchangeName,
+                frameName,
+                backtest: backtest$1,
+            });
+            return await PersistRecentAdapter.readRecentData(symbol, strategyName, exchangeName, frameName, backtest$1);
+        };
+    }
+}
+/**
+ * In-memory storage adapter for backtest recent signals.
+ *
+ * Features:
+ * - Stores the latest active signal per context key in memory only
+ * - Fast read/write operations
+ * - Data is lost when application restarts
+ *
+ * Use this adapter for testing or when persistence is not required.
+ */
+class RecentMemoryBacktestUtils {
+    constructor() {
+        /** Map of composite context keys to the latest signal */
+        this._signals = new Map();
+        /**
+         * Handles active ping event.
+         * Stores the latest signal in memory under the composite context key.
+         * @param event - Active ping contract with signal data and backtest flag
+         */
+        this.handleActivePing = async (event) => {
+            backtest.loggerService.info(RECENT_MEMORY_BACKTEST_METHOD_NAME_HANDLE_ACTIVE_PING, {
+                signalId: event.data.id,
+            });
+            const key = CREATE_KEY_FN$5(event.symbol, event.strategyName, event.exchangeName, event.data.frameName, event.backtest);
+            this._signals.set(key, event.data);
+        };
+        /**
+         * Retrieves the latest in-memory signal for the given context.
+         * @param symbol - Trading pair symbol
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         * @returns The latest signal or null if not found
+         */
+        this.getLatestSignal = async (symbol, strategyName, exchangeName, frameName, backtest$1) => {
+            const key = CREATE_KEY_FN$5(symbol, strategyName, exchangeName, frameName, backtest$1);
+            backtest.loggerService.info(RECENT_MEMORY_BACKTEST_METHOD_NAME_GET_LATEST_SIGNAL, { key });
+            return this._signals.get(key) ?? null;
+        };
+    }
+}
+/**
+ * Persistent storage adapter for live recent signals.
+ *
+ * Features:
+ * - Persists the latest active signal per context to disk using PersistRecentAdapter
+ * - Handles active ping events only
+ *
+ * Use this adapter (default) for live recent signal persistence across sessions.
+ */
+class RecentPersistLiveUtils {
+    constructor() {
+        /**
+         * Handles active ping event.
+         * Persists the latest signal to disk via PersistRecentAdapter.
+         * @param event - Active ping contract with signal data and backtest flag
+         */
+        this.handleActivePing = async (event) => {
+            backtest.loggerService.info(RECENT_PERSIST_LIVE_METHOD_NAME_HANDLE_ACTIVE_PING, {
+                signalId: event.data.id,
+            });
+            await PersistRecentAdapter.writeRecentData(event.data, event.symbol, event.strategyName, event.exchangeName, event.data.frameName, event.backtest);
+        };
+        /**
+         * Retrieves the latest persisted signal for the given context.
+         * @param symbol - Trading pair symbol
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         * @returns The latest signal or null if not found
+         */
+        this.getLatestSignal = async (symbol, strategyName, exchangeName, frameName, backtest$1) => {
+            backtest.loggerService.info(RECENT_PERSIST_LIVE_METHOD_NAME_GET_LATEST_SIGNAL, {
+                symbol,
+                strategyName,
+                exchangeName,
+                frameName,
+                backtest: backtest$1,
+            });
+            return await PersistRecentAdapter.readRecentData(symbol, strategyName, exchangeName, frameName, backtest$1);
+        };
+    }
+}
+/**
+ * In-memory storage adapter for live recent signals.
+ *
+ * Features:
+ * - Stores the latest active signal per context key in memory only
+ * - Fast read/write operations
+ * - Data is lost when application restarts
+ *
+ * Use this adapter for testing or when persistence is not required.
+ */
+class RecentMemoryLiveUtils {
+    constructor() {
+        /** Map of composite context keys to the latest signal */
+        this._signals = new Map();
+        /**
+         * Handles active ping event.
+         * Stores the latest signal in memory under the composite context key.
+         * @param event - Active ping contract with signal data and backtest flag
+         */
+        this.handleActivePing = async (event) => {
+            backtest.loggerService.info(RECENT_MEMORY_LIVE_METHOD_NAME_HANDLE_ACTIVE_PING, {
+                signalId: event.data.id,
+            });
+            const key = CREATE_KEY_FN$5(event.symbol, event.strategyName, event.exchangeName, event.data.frameName, event.backtest);
+            this._signals.set(key, event.data);
+        };
+        /**
+         * Retrieves the latest in-memory signal for the given context.
+         * @param symbol - Trading pair symbol
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         * @returns The latest signal or null if not found
+         */
+        this.getLatestSignal = async (symbol, strategyName, exchangeName, frameName, backtest$1) => {
+            const key = CREATE_KEY_FN$5(symbol, strategyName, exchangeName, frameName, backtest$1);
+            backtest.loggerService.info(RECENT_MEMORY_LIVE_METHOD_NAME_GET_LATEST_SIGNAL, { key });
+            return this._signals.get(key) ?? null;
+        };
+    }
+}
+/**
+ * Backtest recent signal adapter with pluggable storage backend.
+ *
+ * Features:
+ * - Adapter pattern for swappable storage implementations
+ * - Default adapter: RecentMemoryBacktestUtils (in-memory storage)
+ * - Alternative adapter: RecentPersistBacktestUtils
+ * - Convenience methods: usePersist(), useMemory()
+ */
+class RecentBacktestAdapter {
+    constructor() {
+        /** Internal storage utils instance */
+        this._recentBacktestUtils = new RecentMemoryBacktestUtils();
+        /**
+         * Handles active ping event.
+         * Proxies call to the underlying storage adapter.
+         * @param event - Active ping contract with signal data
+         */
+        this.handleActivePing = async (event) => {
+            backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_HANDLE_ACTIVE_PING, {
+                signalId: event.data.id,
+            });
+            return await this._recentBacktestUtils.handleActivePing(event);
+        };
+        /**
+         * Retrieves the latest signal for the given context.
+         * Proxies call to the underlying storage adapter.
+         * @param symbol - Trading pair symbol
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         * @returns The latest signal or null if not found
+         */
+        this.getLatestSignal = async (symbol, strategyName, exchangeName, frameName, backtest$1) => {
+            backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_GET_LATEST_SIGNAL, {
+                symbol,
+                strategyName,
+                exchangeName,
+                frameName,
+                backtest: backtest$1,
+            });
+            return await this._recentBacktestUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1);
+        };
+        /**
+         * Sets the storage adapter constructor.
+         * All future storage operations will use this adapter.
+         * @param Ctor - Constructor for recent adapter
+         */
+        this.useRecentAdapter = (Ctor) => {
+            backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER);
+            this._recentBacktestUtils = Reflect.construct(Ctor, []);
+        };
+        /**
+         * Switches to persistent storage adapter.
+         * Signals will be persisted to disk.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this._recentBacktestUtils = new RecentPersistBacktestUtils();
+        };
+        /**
+         * Switches to in-memory storage adapter (default).
+         * Signals will be stored in memory only.
+         */
+        this.useMemory = () => {
+            backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY);
+            this._recentBacktestUtils = new RecentMemoryBacktestUtils();
+        };
+        /**
+         * Clears the cached utils instance by resetting to the default in-memory adapter.
+         */
+        this.clear = () => {
+            backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
+            this._recentBacktestUtils = new RecentMemoryBacktestUtils();
+        };
+    }
+}
+/**
+ * Live recent signal adapter with pluggable storage backend.
+ *
+ * Features:
+ * - Adapter pattern for swappable storage implementations
+ * - Default adapter: RecentPersistLiveUtils (persistent storage)
+ * - Alternative adapter: RecentMemoryLiveUtils
+ * - Convenience methods: usePersist(), useMemory()
+ */
+class RecentLiveAdapter {
+    constructor() {
+        /** Internal storage utils instance */
+        this._recentLiveUtils = new RecentPersistLiveUtils();
+        /**
+         * Handles active ping event.
+         * Proxies call to the underlying storage adapter.
+         * @param event - Active ping contract with signal data
+         */
+        this.handleActivePing = async (event) => {
+            backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_HANDLE_ACTIVE_PING, {
+                signalId: event.data.id,
+            });
+            return await this._recentLiveUtils.handleActivePing(event);
+        };
+        /**
+         * Retrieves the latest signal for the given context.
+         * Proxies call to the underlying storage adapter.
+         * @param symbol - Trading pair symbol
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         * @returns The latest signal or null if not found
+         */
+        this.getLatestSignal = async (symbol, strategyName, exchangeName, frameName, backtest$1) => {
+            backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_GET_LATEST_SIGNAL, {
+                symbol,
+                strategyName,
+                exchangeName,
+                frameName,
+                backtest: backtest$1,
+            });
+            return await this._recentLiveUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1);
+        };
+        /**
+         * Sets the storage adapter constructor.
+         * All future storage operations will use this adapter.
+         * @param Ctor - Constructor for recent adapter
+         */
+        this.useRecentAdapter = (Ctor) => {
+            backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER);
+            this._recentLiveUtils = Reflect.construct(Ctor, []);
+        };
+        /**
+         * Switches to persistent storage adapter (default).
+         * Signals will be persisted to disk.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this._recentLiveUtils = new RecentPersistLiveUtils();
+        };
+        /**
+         * Switches to in-memory storage adapter.
+         * Signals will be stored in memory only.
+         */
+        this.useMemory = () => {
+            backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY);
+            this._recentLiveUtils = new RecentMemoryLiveUtils();
+        };
+        /**
+         * Clears the cached utils instance by resetting to the default persistent adapter.
+         */
+        this.clear = () => {
+            backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_CLEAR);
+            this._recentLiveUtils = new RecentPersistLiveUtils();
+        };
+    }
+}
+/**
+ * Main recent signal adapter that manages both backtest and live recent signal storage.
+ *
+ * Features:
+ * - Subscribes to activePingSubject for automatic storage updates
+ * - Provides unified access to the latest signal for any context
+ * - Singleshot enable pattern prevents duplicate subscriptions
+ * - Cleanup function for proper unsubscription
+ */
+class RecentAdapter {
+    constructor() {
+        /**
+         * Enables recent signal storage by subscribing to activePingSubject.
+         * Uses singleshot to ensure one-time subscription.
+         *
+         * @returns Cleanup function that unsubscribes from all emitters
+         */
+        this.enable = functoolsKit.singleshot(() => {
+            backtest.loggerService.info(RECENT_ADAPTER_METHOD_NAME_ENABLE);
+            let unBacktest;
+            let unLive;
+            {
+                const unBacktestPingActive = activePingSubject
+                    .filter(({ backtest }) => backtest)
+                    .connect((event) => RecentBacktest.handleActivePing(event));
+                unBacktest = functoolsKit.compose(() => unBacktestPingActive());
+            }
+            {
+                const unLivePingActive = activePingSubject
+                    .filter(({ backtest }) => !backtest)
+                    .connect((event) => RecentLive.handleActivePing(event));
+                unLive = functoolsKit.compose(() => unLivePingActive());
+            }
+            const unEnable = () => this.enable.clear();
+            return functoolsKit.compose(() => unBacktest(), () => unLive(), () => unEnable());
+        });
+        /**
+         * Disables recent signal storage by unsubscribing from all emitters.
+         * Safe to call multiple times.
+         */
+        this.disable = () => {
+            backtest.loggerService.info(RECENT_ADAPTER_METHOD_NAME_DISABLE);
+            if (this.enable.hasValue()) {
+                const lastSubscription = this.enable();
+                lastSubscription();
+            }
+        };
+        /**
+         * Retrieves the latest active signal for the given symbol and context.
+         * Searches backtest storage first, then live storage.
+         *
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName, exchangeName, and frameName
+         * @param backtest - Flag indicating if the context is backtest or live
+         * @returns The latest signal or null if not found
+         * @throws Error if RecentAdapter is not enabled
+         */
+        this.getLatestSignal = async (symbol, context) => {
+            backtest.loggerService.info(RECENT_ADAPTER_METHOD_NAME_GET_LATEST_SIGNAL, {
+                symbol,
+                context,
+            });
+            if (!this.enable.hasValue()) {
+                throw new Error("RecentAdapter is not enabled. Call enable() first.");
+            }
+            let result = null;
+            if (result = await RecentBacktest.getLatestSignal(symbol, context.strategyName, context.exchangeName, context.frameName, true)) {
+                return result;
+            }
+            if (result = await RecentLive.getLatestSignal(symbol, context.strategyName, context.exchangeName, context.frameName, false)) {
+                return result;
+            }
+            return null;
+        };
+    }
+}
+/**
+ * Global singleton instance of RecentAdapter.
+ * Provides unified recent signal management for backtest and live trading.
+ */
+const Recent = new RecentAdapter();
+/**
+ * Global singleton instance of RecentLiveAdapter.
+ * Provides live trading recent signal storage with pluggable backends.
+ */
+const RecentLive = new RecentLiveAdapter();
+/**
+ * Global singleton instance of RecentBacktestAdapter.
+ * Provides backtest recent signal storage with pluggable backends.
+ */
+const RecentBacktest = new RecentBacktestAdapter();
+
+const GET_LATEST_SIGNAL_METHOD_NAME = "signal.getLatestSignal";
+/**
+ * Returns the latest signal (pending or closed) for the current strategy context.
+ *
+ * Does not distinguish between active and closed signals — returns whichever
+ * was recorded last. Useful for cooldown logic: e.g. skip opening a new position
+ * for 4 hours after a stop-loss by checking the timestamp of the latest signal
+ * regardless of its outcome.
+ *
+ * Searches backtest storage first, then live storage.
+ * Returns null if no signal exists at all.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to the latest signal or null
+ *
+ * @example
+ * ```typescript
+ * import { getLatestSignal } from "backtest-kit";
+ *
+ * const latest = await getLatestSignal("BTCUSDT");
+ * if (latest && Date.now() - latest.closedAt < 4 * 60 * 60 * 1000) {
+ *   return; // cooldown after SL — skip new signal for 4 hours
+ * }
+ * ```
+ */
+async function getLatestSignal(symbol) {
+    backtest.loggerService.info(GET_LATEST_SIGNAL_METHOD_NAME, { symbol });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("getLatestSignal requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("getLatestSignal requires a method context");
+    }
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    return await Recent.getLatestSignal(symbol, { exchangeName, frameName, strategyName });
+}
+
 const DEFAULT_BM25_K1 = 1.5;
 const DEFAULT_BM25_B = 0.75;
 const DEFAULT_BM25_SCORE = 0.5;
@@ -47776,6 +48670,87 @@ class MarkdownUtils {
                 backtest.maxDrawdownMarkdownService.unsubscribe();
             }
         };
+        /**
+         * Clears markdown report data selectively.
+         *
+         * Clears accumulated data for specified markdown services without unsubscribing.
+         * Use this method to reset report data for specific services while keeping them active.
+         *
+         * Each cleared service will:
+         * - Clear accumulated data for all reports
+         * - Start fresh with new data for future events
+         * - Not affect event subscriptions or report generation status
+         *
+         * @param config - Service configuration object specifying which services to clear. Defaults to clearing all services.
+         * @param config.backtest - Clear backtest result report data
+         * @param config.breakeven - Clear breakeven event tracking data
+         * @param config.partial - Clear partial profit/loss event tracking data
+         * @param config.heat - Clear portfolio heatmap analysis data
+         * @param config.walker - Clear walker strategy comparison report data
+         * @param config.performance - Clear performance bottleneck analysis data
+         * @param config.risk - Clear risk rejection tracking data
+         * @param config.schedule - Clear scheduled signal tracking data
+         * @param config.live - Clear live trading event report data
+         * @param config.strategy - Clear strategy report data
+         * @param config.sync - Clear sync report data
+         * @param config.highest_profit - Clear highest profit report data
+         * @param config.max_drawdown - Clear max drawdown report data
+         */
+        this.clear = ({ backtest: bt = false, breakeven = false, heat = false, live = false, partial = false, performance = false, risk = false, strategy = false, schedule = false, walker = false, sync = false, highest_profit = false, max_drawdown = false, } = WILDCARD_TARGET) => {
+            LOGGER_SERVICE$1.debug(MARKDOWN_METHOD_NAME_CLEAR, {
+                backtest: bt,
+                breakeven,
+                heat,
+                live,
+                partial,
+                performance,
+                risk,
+                strategy,
+                schedule,
+                walker,
+                sync,
+                highest_profit,
+            });
+            if (bt) {
+                backtest.backtestMarkdownService.clear();
+            }
+            if (breakeven) {
+                backtest.breakevenMarkdownService.clear();
+            }
+            if (heat) {
+                backtest.heatMarkdownService.clear();
+            }
+            if (live) {
+                backtest.liveMarkdownService.clear();
+            }
+            if (partial) {
+                backtest.partialMarkdownService.clear();
+            }
+            if (performance) {
+                backtest.performanceMarkdownService.clear();
+            }
+            if (risk) {
+                backtest.riskMarkdownService.clear();
+            }
+            if (strategy) {
+                backtest.strategyMarkdownService.clear();
+            }
+            if (schedule) {
+                backtest.scheduleMarkdownService.clear();
+            }
+            if (walker) {
+                backtest.walkerMarkdownService.clear();
+            }
+            if (sync) {
+                backtest.syncMarkdownService.clear();
+            }
+            if (highest_profit) {
+                backtest.highestProfitMarkdownService.clear();
+            }
+            if (max_drawdown) {
+                backtest.maxDrawdownMarkdownService.clear();
+            }
+        };
     }
 }
 /**
@@ -47818,15 +48793,6 @@ class MarkdownAdapter extends MarkdownUtils {
         LOGGER_SERVICE$1.debug(MARKDOWN_METHOD_NAME_USE_JSONL);
         MarkdownWriter.useJsonl();
     }
-    /**
-     * Clears the memoized storage cache.
-     * Call this when process.cwd() changes between strategy iterations
-     * so new storage instances are created with the updated base path.
-     */
-    clear() {
-        LOGGER_SERVICE$1.log(MARKDOWN_METHOD_NAME_CLEAR);
-        MarkdownWriter.clear();
-    }
     /**
      * Switches to a dummy markdown adapter that discards all writes.
      * All future markdown writes will be no-ops.
@@ -48498,6 +49464,68 @@ class LogAdapter {
  */
 const Log = new LogAdapter();
 
+const METHOD_NAME_CREATE_SNAPSHOT = "SessionUtils.createSnapshot";
+/** List of all global subjects whose listeners should be snapshotted for session isolation */
+const SUBJECT_ISOLATION_LIST = [
+    activePingSubject,
+    backtestScheduleOpenSubject,
+    breakevenSubject,
+    doneBacktestSubject,
+    doneLiveSubject,
+    errorEmitter,
+    exitEmitter,
+    highestProfitSubject,
+    maxDrawdownSubject,
+    partialLossSubject,
+    partialProfitSubject,
+    performanceEmitter,
+    progressBacktestEmitter,
+    riskSubject,
+    schedulePingSubject,
+    shutdownEmitter,
+    signalBacktestEmitter,
+    signalEmitter,
+    signalLiveEmitter,
+    strategyCommitSubject,
+    syncSubject,
+    validationSubject,
+    signalNotifySubject,
+];
+/**
+ * Creates a snapshot function for a given subject by clearing its internal
+ * events map and returning a restore function that can put the original listeners back.
+ * @param subject The subject to snapshot
+ * @returns A function that restores the subject's original listeners when called
+ */
+const CREATE_SUBJECT_SNAPSHOT_FN = (subject) => {
+    const emitter = subject["_emitter"];
+    const events = emitter["_events"];
+    emitter["_events"] = {};
+    return () => {
+        emitter["_events"] = events;
+    };
+};
+/**
+ * Manages isolation of global event-bus state between backtest sessions.
+ * Allows temporarily detaching all subject subscriptions so that one session
+ * does not interfere with another, then restoring them afterwards.
+ */
+class SessionUtils {
+    constructor() {
+        /**
+         * Snapshots the current listener state of every global subject by replacing
+         * their internal `_events` map with an empty object.
+         * @returns A restore function that, when called, puts all original listeners back.
+         */
+        this.createSnapshot = () => {
+            backtest.loggerService.log(METHOD_NAME_CREATE_SNAPSHOT);
+            const snapshotList = SUBJECT_ISOLATION_LIST.map(CREATE_SUBJECT_SNAPSHOT_FN);
+            return functoolsKit.compose(...snapshotList);
+        };
+    }
+}
+const Session = new SessionUtils();
+
 const SCHEDULE_METHOD_NAME_GET_DATA = "ScheduleUtils.getData";
 const SCHEDULE_METHOD_NAME_GET_REPORT = "ScheduleUtils.getReport";
 const SCHEDULE_METHOD_NAME_DUMP = "ScheduleUtils.dump";
@@ -53307,7 +54335,44 @@ const CREATE_VALIDATION_ERROR_NOTIFICATION_FN = (error) => ({
     message: functoolsKit.getErrorMessage(error),
     backtest: false,
 });
+/**
+ * Creates a notification model for signal info events.
+ * @param data - The signal info contract data
+ * @returns NotificationModel for signal info event
+ */
+const CREATE_SIGNAL_INFO_NOTIFICATION_FN = (data) => ({
+    type: "signal.info",
+    id: CREATE_KEY_FN$2(),
+    timestamp: data.timestamp,
+    backtest: data.backtest,
+    symbol: data.symbol,
+    strategyName: data.strategyName,
+    exchangeName: data.exchangeName,
+    signalId: data.data.id,
+    currentPrice: data.currentPrice,
+    position: data.data.position,
+    priceOpen: data.data.priceOpen,
+    priceTakeProfit: data.data.priceTakeProfit,
+    priceStopLoss: data.data.priceStopLoss,
+    originalPriceTakeProfit: data.data.originalPriceTakeProfit,
+    originalPriceStopLoss: data.data.originalPriceStopLoss,
+    originalPriceOpen: data.data.originalPriceOpen,
+    totalEntries: data.data.totalEntries,
+    totalPartials: data.data.totalPartials,
+    pnl: data.data.pnl,
+    pnlPercentage: data.data.pnl.pnlPercentage,
+    pnlPriceOpen: data.data.pnl.priceOpen,
+    pnlPriceClose: data.data.pnl.priceClose,
+    pnlCost: data.data.pnl.pnlCost,
+    pnlEntries: data.data.pnl.pnlEntries,
+    note: data.note,
+    notificationId: data.notificationId,
+    scheduledAt: data.data.scheduledAt,
+    pendingAt: data.data.pendingAt,
+    createdAt: data.timestamp,
+});
 const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_SIGNAL = "NotificationMemoryBacktestUtils.handleSignal";
+const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_SIGNAL_NOTIFY = "NotificationMemoryBacktestUtils.handleSignalNotify";
 const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_PARTIAL_PROFIT = "NotificationMemoryBacktestUtils.handlePartialProfit";
 const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_PARTIAL_LOSS = "NotificationMemoryBacktestUtils.handlePartialLoss";
 const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_BREAKEVEN = "NotificationMemoryBacktestUtils.handleBreakeven";
@@ -53320,6 +54385,7 @@ const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_VALIDATION_ERROR = "Notifi
 const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_GET_DATA = "NotificationMemoryBacktestUtils.getData";
 const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_DISPOSE = "NotificationMemoryBacktestUtils.dispose";
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_SIGNAL = "NotificationMemoryLiveUtils.handleSignal";
+const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_SIGNAL_NOTIFY = "NotificationMemoryLiveUtils.handleSignalNotify";
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_PARTIAL_PROFIT = "NotificationMemoryLiveUtils.handlePartialProfit";
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_PARTIAL_LOSS = "NotificationMemoryLiveUtils.handlePartialLoss";
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_BREAKEVEN = "NotificationMemoryLiveUtils.handleBreakeven";
@@ -53348,6 +54414,7 @@ const NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_CLEAR = "NotificationLiveAdapter.cle
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_WAIT_FOR_INIT = "NotificationPersistBacktestUtils.waitForInit";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_UPDATE_NOTIFICATIONS = "NotificationPersistBacktestUtils._updateNotifications";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_SIGNAL = "NotificationPersistBacktestUtils.handleSignal";
+const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_SIGNAL_NOTIFY = "NotificationPersistBacktestUtils.handleSignalNotify";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_PARTIAL_PROFIT = "NotificationPersistBacktestUtils.handlePartialProfit";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_PARTIAL_LOSS = "NotificationPersistBacktestUtils.handlePartialLoss";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_BREAKEVEN = "NotificationPersistBacktestUtils.handleBreakeven";
@@ -53362,6 +54429,7 @@ const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_DISPOSE = "NotificationPersistBa
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_WAIT_FOR_INIT = "NotificationPersistLiveUtils.waitForInit";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_UPDATE_NOTIFICATIONS = "NotificationPersistLiveUtils._updateNotifications";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_SIGNAL = "NotificationPersistLiveUtils.handleSignal";
+const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_SIGNAL_NOTIFY = "NotificationPersistLiveUtils.handleSignalNotify";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_PARTIAL_PROFIT = "NotificationPersistLiveUtils.handlePartialProfit";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_PARTIAL_LOSS = "NotificationPersistLiveUtils.handlePartialLoss";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_BREAKEVEN = "NotificationPersistLiveUtils.handleBreakeven";
@@ -53404,6 +54472,12 @@ class NotificationMemoryBacktestUtils {
                 this._addNotification(notification);
             }
         };
+        this.handleSignalNotify = async (data) => {
+            backtest.loggerService.info(NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_SIGNAL_NOTIFY, {
+                signalId: data.data.id,
+            });
+            this._addNotification(CREATE_SIGNAL_INFO_NOTIFICATION_FN(data));
+        };
         /**
          * Handles partial profit availability event.
          * @param data - The partial profit contract data
@@ -53548,6 +54622,8 @@ class NotificationDummyBacktestUtils {
          */
         this.handleSignal = async () => {
         };
+        this.handleSignalNotify = async () => {
+        };
         /**
          * No-op handler for partial profit event.
          */
@@ -53655,6 +54731,14 @@ class NotificationPersistBacktestUtils {
                 await this._updateNotifications();
             }
         };
+        this.handleSignalNotify = async (data) => {
+            backtest.loggerService.info(NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_SIGNAL_NOTIFY, {
+                signalId: data.data.id,
+            });
+            await this.waitForInit();
+            this._addNotification(CREATE_SIGNAL_INFO_NOTIFICATION_FN(data));
+            await this._updateNotifications();
+        };
         /**
          * Handles partial profit availability event.
          * @param data - The partial profit contract data
@@ -53856,6 +54940,12 @@ class NotificationMemoryLiveUtils {
                 this._addNotification(notification);
             }
         };
+        this.handleSignalNotify = async (data) => {
+            backtest.loggerService.info(NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_SIGNAL_NOTIFY, {
+                signalId: data.data.id,
+            });
+            this._addNotification(CREATE_SIGNAL_INFO_NOTIFICATION_FN(data));
+        };
         /**
          * Handles partial profit availability event.
          * @param data - The partial profit contract data
@@ -54000,6 +55090,8 @@ class NotificationDummyLiveUtils {
          */
         this.handleSignal = async () => {
         };
+        this.handleSignalNotify = async () => {
+        };
         /**
          * No-op handler for partial profit event.
          */
@@ -54108,6 +55200,14 @@ class NotificationPersistLiveUtils {
                 await this._updateNotifications();
             }
         };
+        this.handleSignalNotify = async (data) => {
+            backtest.loggerService.info(NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_SIGNAL_NOTIFY, {
+                signalId: data.data.id,
+            });
+            await this.waitForInit();
+            this._addNotification(CREATE_SIGNAL_INFO_NOTIFICATION_FN(data));
+            await this._updateNotifications();
+        };
         /**
          * Handles partial profit availability event.
          * @param data - The partial profit contract data
@@ -54301,6 +55401,9 @@ class NotificationBacktestAdapter {
         this.handleSignal = async (data) => {
             return await this._notificationBacktestUtils.handleSignal(data);
         };
+        this.handleSignalNotify = async (data) => {
+            return await this._notificationBacktestUtils.handleSignalNotify(data);
+        };
         /**
          * Handles partial profit availability event.
          * Proxies call to the underlying notification adapter.
@@ -54456,6 +55559,9 @@ class NotificationLiveAdapter {
         this.handleSignal = async (data) => {
             return await this._notificationLiveUtils.handleSignal(data);
         };
+        this.handleSignalNotify = async (data) => {
+            return await this._notificationLiveUtils.handleSignalNotify(data);
+        };
         /**
          * Handles partial profit availability event.
          * Proxies call to the underlying notification adapter.
@@ -54634,7 +55740,10 @@ class NotificationAdapter {
                 const unBacktestError = errorEmitter.subscribe((error) => NotificationBacktest.handleError(error));
                 const unBacktestExit = exitEmitter.subscribe((error) => NotificationBacktest.handleCriticalError(error));
                 const unBacktestValidation = validationSubject.subscribe((error) => NotificationBacktest.handleValidationError(error));
-                unBacktest = functoolsKit.compose(() => unBacktestSignal(), () => unBacktestPartialProfit(), () => unBacktestPartialLoss(), () => unBacktestBreakeven(), () => unBacktestStrategyCommit(), () => unBacktestSync(), () => unBacktestRisk(), () => unBacktestError(), () => unBacktestExit(), () => unBacktestValidation());
+                const unBacktestSignalNotify = signalNotifySubject
+                    .filter(({ backtest }) => backtest)
+                    .connect((data) => NotificationBacktest.handleSignalNotify(data));
+                unBacktest = functoolsKit.compose(() => unBacktestSignal(), () => unBacktestPartialProfit(), () => unBacktestPartialLoss(), () => unBacktestBreakeven(), () => unBacktestStrategyCommit(), () => unBacktestSync(), () => unBacktestRisk(), () => unBacktestError(), () => unBacktestExit(), () => unBacktestValidation(), () => unBacktestSignalNotify());
             }
             {
                 const unLiveSignal = signalLiveEmitter.subscribe((data) => NotificationLive.handleSignal(data));
@@ -54659,7 +55768,10 @@ class NotificationAdapter {
                 const unLiveError = errorEmitter.subscribe((error) => NotificationLive.handleError(error));
                 const unLiveExit = exitEmitter.subscribe((error) => NotificationLive.handleCriticalError(error));
                 const unLiveValidation = validationSubject.subscribe((error) => NotificationLive.handleValidationError(error));
-                unLive = functoolsKit.compose(() => unLiveSignal(), () => unLivePartialProfit(), () => unLivePartialLoss(), () => unLiveBreakeven(), () => unLiveStrategyCommit(), () => unLiveSync(), () => unLiveRisk(), () => unLiveError(), () => unLiveExit(), () => unLiveValidation());
+                const unLiveSignalNotify = signalNotifySubject
+                    .filter(({ backtest }) => !backtest)
+                    .connect((data) => NotificationLive.handleSignalNotify(data));
+                unLive = functoolsKit.compose(() => unLiveSignal(), () => unLivePartialProfit(), () => unLivePartialLoss(), () => unLiveBreakeven(), () => unLiveStrategyCommit(), () => unLiveSync(), () => unLiveRisk(), () => unLiveError(), () => unLiveExit(), () => unLiveValidation(), () => unLiveSignalNotify());
             }
             return () => {
                 unLive();
@@ -54735,12 +55847,15 @@ const CACHE_METHOD_NAME_RUN = "CacheFnInstance.run";
 const CACHE_METHOD_NAME_FN = "CacheUtils.fn";
 const CACHE_METHOD_NAME_FN_CLEAR = "CacheUtils.fn.clear";
 const CACHE_METHOD_NAME_FN_GC = "CacheUtils.fn.gc";
+const CACHE_METHOD_NAME_FN_HAS_VALUE = "CacheUtils.fn.hasValue";
 const CACHE_METHOD_NAME_FILE = "CacheUtils.file";
 const CACHE_METHOD_NAME_FILE_CLEAR = "CacheUtils.file.clear";
+const CACHE_METHOD_NAME_FILE_HAS_VALUE = "CacheUtils.file.hasValue";
 const CACHE_METHOD_NAME_DISPOSE = "CacheUtils.dispose";
 const CACHE_METHOD_NAME_CLEAR = "CacheUtils.clear";
 const CACHE_METHOD_NAME_RESET_COUNTER = "CacheUtils.resetCounter";
 const CACHE_FILE_INSTANCE_METHOD_NAME_RUN = "CacheFileInstance.run";
+const CACHE_FILE_INSTANCE_METHOD_NAME_HAS_VALUE = "CacheFileInstance.hasValue";
 const MS_PER_MINUTE$1 = 60000;
 const INTERVAL_MINUTES$1 = {
     "1m": 1,
@@ -54894,11 +56009,17 @@ class CacheFnInstance {
                     return cached;
                 }
             }
+            const value = this.fn(...args);
             const newCache = {
                 when: currentWhen,
-                value: this.fn(...args),
+                value,
             };
             this._cacheMap.set(key, newCache);
+            if (value && value instanceof Promise) {
+                value.catch(() => {
+                    this._cacheMap.delete(key);
+                });
+            }
             return newCache;
         };
         /**
@@ -54930,6 +56051,36 @@ class CacheFnInstance {
                 }
             }
         };
+        /**
+         * Check whether a valid (non-expired) cache entry exists for the current context and arguments.
+         *
+         * Returns `true` if a cached value exists and its interval is still current.
+         * Returns `false` if there is no entry or the cached entry has expired.
+         *
+         * Requires active execution context and method context.
+         *
+         * @param args - Arguments to look up in the cache
+         * @returns `true` if a fresh cached value exists, `false` otherwise
+         */
+        this.hasValue = (...args) => {
+            if (!MethodContextService.hasContext()) {
+                throw new Error("CacheFnInstance hasValue requires method context");
+            }
+            if (!ExecutionContextService.hasContext()) {
+                throw new Error("CacheFnInstance hasValue requires execution context");
+            }
+            const contextKey = CREATE_KEY_FN$1(backtest.methodContextService.context.strategyName, backtest.methodContextService.context.exchangeName, backtest.methodContextService.context.frameName, backtest.executionContextService.context.backtest);
+            const argKey = String(this.key(args));
+            const key = `${contextKey}:${argKey}`;
+            const cached = this._cacheMap.get(key);
+            if (!cached) {
+                return false;
+            }
+            const currentWhen = backtest.executionContextService.context.when;
+            const currentAligned = align$1(currentWhen.getTime(), this.interval);
+            const cachedAligned = align$1(cached.when.getTime(), this.interval);
+            return currentAligned === cachedAligned;
+        };
         /**
          * Garbage collect expired cache entries.
          *
@@ -55054,6 +56205,33 @@ class CacheFileInstance {
             await PersistMeasureAdapter.writeMeasureData({ id: entityKey, data: result, removed: false }, bucket, entityKey);
             return result;
         };
+        /**
+         * Check whether a cached value exists on disk for the given arguments and current interval.
+         *
+         * Returns `true` if a persisted record exists for the current aligned timestamp.
+         * Returns `false` if no record is found.
+         *
+         * Requires active execution context and method context.
+         *
+         * @param args - Arguments forwarded to the key generator
+         * @returns `true` if a cached record exists, `false` otherwise
+         */
+        this.hasValue = async (...args) => {
+            backtest.loggerService.debug(CACHE_FILE_INSTANCE_METHOD_NAME_HAS_VALUE, { args });
+            if (!MethodContextService.hasContext()) {
+                throw new Error("CacheFileInstance hasValue requires method context");
+            }
+            if (!ExecutionContextService.hasContext()) {
+                throw new Error("CacheFileInstance hasValue requires execution context");
+            }
+            const [symbol, ...rest] = args;
+            const { when } = backtest.executionContextService.context;
+            const alignedTs = align$1(when.getTime(), this.interval);
+            const bucket = `${this.name}_${this.interval}_${this.index}`;
+            const entityKey = this.key([symbol, alignedTs, ...rest]);
+            const cached = await PersistMeasureAdapter.readMeasureData(bucket, entityKey);
+            return cached !== null;
+        };
         /**
          * Soft-delete all persisted records for this instance's bucket.
          * After this call the next `run()` will recompute and re-cache the value.
@@ -55140,23 +56318,30 @@ class CacheUtils {
             wrappedFn.clear = () => {
                 backtest.loggerService.info(CACHE_METHOD_NAME_FN_CLEAR);
                 if (!MethodContextService.hasContext()) {
-                    backtest.loggerService.warn(`${CACHE_METHOD_NAME_FN_CLEAR} called without method context, skipping`);
-                    return;
+                    throw new Error(`${CACHE_METHOD_NAME_FN_CLEAR} requires method context`);
                 }
                 if (!ExecutionContextService.hasContext()) {
-                    backtest.loggerService.warn(`${CACHE_METHOD_NAME_FN_CLEAR} called without execution context, skipping`);
-                    return;
+                    throw new Error(`${CACHE_METHOD_NAME_FN_CLEAR} requires execution context`);
                 }
                 this._getFnInstance.get(run)?.clear();
             };
             wrappedFn.gc = () => {
                 backtest.loggerService.info(CACHE_METHOD_NAME_FN_GC);
                 if (!ExecutionContextService.hasContext()) {
-                    backtest.loggerService.warn(`${CACHE_METHOD_NAME_FN_GC} called without execution context, skipping`);
-                    return;
+                    throw new Error(`${CACHE_METHOD_NAME_FN_GC} requires execution context`);
                 }
                 return this._getFnInstance.get(run)?.gc();
             };
+            wrappedFn.hasValue = (...args) => {
+                backtest.loggerService.info(CACHE_METHOD_NAME_FN_HAS_VALUE);
+                if (!MethodContextService.hasContext()) {
+                    throw new Error(`${CACHE_METHOD_NAME_FN_HAS_VALUE} requires method context`);
+                }
+                if (!ExecutionContextService.hasContext()) {
+                    throw new Error(`${CACHE_METHOD_NAME_FN_HAS_VALUE} requires execution context`);
+                }
+                return this._getFnInstance.get(run)?.hasValue(...args) ?? false;
+            };
             return wrappedFn;
         };
         /**
@@ -55208,8 +56393,25 @@ class CacheUtils {
             };
             wrappedFn.clear = async () => {
                 backtest.loggerService.info(CACHE_METHOD_NAME_FILE_CLEAR);
+                if (!MethodContextService.hasContext()) {
+                    throw new Error(`${CACHE_METHOD_NAME_FILE_CLEAR} requires method context`);
+                }
+                if (!ExecutionContextService.hasContext()) {
+                    throw new Error(`${CACHE_METHOD_NAME_FILE_CLEAR} requires execution context`);
+                }
                 await this._getFileInstance.get(run)?.clear();
             };
+            wrappedFn.hasValue = async (...args) => {
+                backtest.loggerService.info(CACHE_METHOD_NAME_FILE_HAS_VALUE);
+                if (!MethodContextService.hasContext()) {
+                    throw new Error(`${CACHE_METHOD_NAME_FILE_HAS_VALUE} requires method context`);
+                }
+                if (!ExecutionContextService.hasContext()) {
+                    throw new Error(`${CACHE_METHOD_NAME_FILE_HAS_VALUE} requires execution context`);
+                }
+                const instance = this._getFileInstance(run, context.interval, context.name, context.key);
+                return await instance.hasValue(...args);
+            };
             return wrappedFn;
         };
         /**
@@ -55278,11 +56480,14 @@ const Cache = new CacheUtils();
 
 const INTERVAL_METHOD_NAME_RUN = "IntervalFnInstance.run";
 const INTERVAL_FILE_INSTANCE_METHOD_NAME_RUN = "IntervalFileInstance.run";
+const INTERVAL_FILE_INSTANCE_METHOD_NAME_HAS_VALUE = "IntervalFileInstance.hasValue";
 const INTERVAL_METHOD_NAME_FN = "IntervalUtils.fn";
 const INTERVAL_METHOD_NAME_FN_CLEAR = "IntervalUtils.fn.clear";
 const INTERVAL_METHOD_NAME_FN_GC = "IntervalUtils.fn.gc";
+const INTERVAL_METHOD_NAME_FN_HAS_VALUE = "IntervalUtils.fn.hasValue";
 const INTERVAL_METHOD_NAME_FILE = "IntervalUtils.file";
 const INTERVAL_METHOD_NAME_FILE_CLEAR = "IntervalUtils.file.clear";
+const INTERVAL_METHOD_NAME_FILE_HAS_VALUE = "IntervalUtils.file.hasValue";
 const INTERVAL_METHOD_NAME_DISPOSE = "IntervalUtils.dispose";
 const INTERVAL_METHOD_NAME_CLEAR = "IntervalUtils.clear";
 const INTERVAL_METHOD_NAME_RESET_COUNTER = "IntervalUtils.resetCounter";
@@ -55395,7 +56600,7 @@ class IntervalFnInstance {
          *   within the same interval or when `fn` itself returned `null`
          * @throws Error if method context, execution context, or interval is missing
          */
-        this.run = async (...args) => {
+        this.run = (...args) => {
             backtest.loggerService.debug(INTERVAL_METHOD_NAME_RUN, { args });
             const step = INTERVAL_MINUTES[this.interval];
             {
@@ -55417,10 +56622,15 @@ class IntervalFnInstance {
             if (this._stateMap.get(stateKey) === currentAligned) {
                 return null;
             }
-            const result = await this.fn.apply(null, args);
+            const result = this.fn.apply(null, args);
             if (result !== null) {
                 this._stateMap.set(stateKey, currentAligned);
             }
+            if (result && result instanceof Promise) {
+                result.catch(() => {
+                    this._stateMap.delete(stateKey);
+                });
+            }
             return result;
         };
         /**
@@ -55440,6 +56650,31 @@ class IntervalFnInstance {
                 }
             }
         };
+        /**
+         * Check whether the function has already fired for the current interval and context.
+         *
+         * Returns `true` if the function fired (non-null result) within the current interval boundary.
+         * Returns `false` if there is no recorded firing for this interval.
+         *
+         * Requires active method context and execution context.
+         *
+         * @param args - Arguments to look up in the state map
+         * @returns `true` if the function has already fired this interval, `false` otherwise
+         */
+        this.hasValue = (...args) => {
+            if (!MethodContextService.hasContext()) {
+                throw new Error("IntervalFnInstance hasValue requires method context");
+            }
+            if (!ExecutionContextService.hasContext()) {
+                throw new Error("IntervalFnInstance hasValue requires execution context");
+            }
+            const contextKey = CREATE_KEY_FN(backtest.methodContextService.context.strategyName, backtest.methodContextService.context.exchangeName, backtest.methodContextService.context.frameName, backtest.executionContextService.context.backtest);
+            const currentWhen = backtest.executionContextService.context.when;
+            const currentAligned = align(currentWhen.getTime(), this.interval);
+            const argKey = this.key(args);
+            const stateKey = `${contextKey}:${argKey}`;
+            return this._stateMap.get(stateKey) === currentAligned;
+        };
         /**
          * Garbage collect expired state entries.
          *
@@ -55561,6 +56796,33 @@ class IntervalFileInstance {
             }
             return result;
         };
+        /**
+         * Check whether the function has already fired for the current interval on disk.
+         *
+         * Returns `true` if a persisted record exists for the current aligned timestamp.
+         * Returns `false` if no record is found.
+         *
+         * Requires active execution context and method context.
+         *
+         * @param args - Arguments forwarded to the key generator
+         * @returns `true` if a fired record exists, `false` otherwise
+         */
+        this.hasValue = async (...args) => {
+            backtest.loggerService.debug(INTERVAL_FILE_INSTANCE_METHOD_NAME_HAS_VALUE, { args });
+            if (!MethodContextService.hasContext()) {
+                throw new Error("IntervalFileInstance hasValue requires method context");
+            }
+            if (!ExecutionContextService.hasContext()) {
+                throw new Error("IntervalFileInstance hasValue requires execution context");
+            }
+            const [symbol, ...rest] = args;
+            const { when } = backtest.executionContextService.context;
+            const alignedMs = align(when.getTime(), this.interval);
+            const bucket = `${this.name}_${this.interval}_${this.index}`;
+            const entityKey = this.key([symbol, alignedMs, ...rest]);
+            const cached = await PersistIntervalAdapter.readIntervalData(bucket, entityKey);
+            return cached !== null;
+        };
         /**
          * Soft-delete all persisted records for this instance's bucket.
          * After this call the function will fire again on the next `run()`.
@@ -55641,23 +56903,30 @@ class IntervalUtils {
             wrappedFn.clear = () => {
                 backtest.loggerService.info(INTERVAL_METHOD_NAME_FN_CLEAR);
                 if (!MethodContextService.hasContext()) {
-                    backtest.loggerService.warn(`${INTERVAL_METHOD_NAME_FN_CLEAR} called without method context, skipping`);
-                    return;
+                    throw new Error(`${INTERVAL_METHOD_NAME_FN_CLEAR} requires method context`);
                 }
                 if (!ExecutionContextService.hasContext()) {
-                    backtest.loggerService.warn(`${INTERVAL_METHOD_NAME_FN_CLEAR} called without execution context, skipping`);
-                    return;
+                    throw new Error(`${INTERVAL_METHOD_NAME_FN_CLEAR} requires execution context`);
                 }
                 this._getInstance.get(run)?.clear();
             };
             wrappedFn.gc = () => {
                 backtest.loggerService.info(INTERVAL_METHOD_NAME_FN_GC);
                 if (!ExecutionContextService.hasContext()) {
-                    backtest.loggerService.warn(`${INTERVAL_METHOD_NAME_FN_GC} called without execution context, skipping`);
-                    return;
+                    throw new Error(`${INTERVAL_METHOD_NAME_FN_GC} requires execution context`);
                 }
                 return this._getInstance.get(run)?.gc();
             };
+            wrappedFn.hasValue = (...args) => {
+                backtest.loggerService.info(INTERVAL_METHOD_NAME_FN_HAS_VALUE);
+                if (!MethodContextService.hasContext()) {
+                    throw new Error(`${INTERVAL_METHOD_NAME_FN_HAS_VALUE} requires method context`);
+                }
+                if (!ExecutionContextService.hasContext()) {
+                    throw new Error(`${INTERVAL_METHOD_NAME_FN_HAS_VALUE} requires execution context`);
+                }
+                return this._getInstance.get(run)?.hasValue(...args) ?? false;
+            };
             return wrappedFn;
         };
         /**
@@ -55700,8 +56969,25 @@ class IntervalUtils {
             };
             wrappedFn.clear = async () => {
                 backtest.loggerService.info(INTERVAL_METHOD_NAME_FILE_CLEAR);
+                if (!MethodContextService.hasContext()) {
+                    throw new Error(`${INTERVAL_METHOD_NAME_FILE_CLEAR} requires method context`);
+                }
+                if (!ExecutionContextService.hasContext()) {
+                    throw new Error(`${INTERVAL_METHOD_NAME_FILE_CLEAR} requires execution context`);
+                }
                 await this._getFileInstance.get(run)?.clear();
             };
+            wrappedFn.hasValue = async (...args) => {
+                backtest.loggerService.info(INTERVAL_METHOD_NAME_FILE_HAS_VALUE);
+                if (!MethodContextService.hasContext()) {
+                    throw new Error(`${INTERVAL_METHOD_NAME_FILE_HAS_VALUE} requires method context`);
+                }
+                if (!ExecutionContextService.hasContext()) {
+                    throw new Error(`${INTERVAL_METHOD_NAME_FILE_HAS_VALUE} requires execution context`);
+                }
+                const instance = this._getFileInstance(run, context.interval, context.name, context.key);
+                return await instance.hasValue(...args);
+            };
             return wrappedFn;
         };
         /**
@@ -56911,18 +58197,23 @@ exports.PersistMeasureAdapter = PersistMeasureAdapter;
 exports.PersistMemoryAdapter = PersistMemoryAdapter;
 exports.PersistNotificationAdapter = PersistNotificationAdapter;
 exports.PersistPartialAdapter = PersistPartialAdapter;
+exports.PersistRecentAdapter = PersistRecentAdapter;
 exports.PersistRiskAdapter = PersistRiskAdapter;
 exports.PersistScheduleAdapter = PersistScheduleAdapter;
 exports.PersistSignalAdapter = PersistSignalAdapter;
 exports.PersistStorageAdapter = PersistStorageAdapter;
 exports.Position = Position;
 exports.PositionSize = PositionSize;
+exports.Recent = Recent;
+exports.RecentBacktest = RecentBacktest;
+exports.RecentLive = RecentLive;
 exports.Reflect = Reflect$1;
 exports.Report = Report;
 exports.ReportBase = ReportBase;
 exports.ReportWriter = ReportWriter;
 exports.Risk = Risk;
 exports.Schedule = Schedule;
+exports.Session = Session;
 exports.Storage = Storage;
 exports.StorageBacktest = StorageBacktest;
 exports.StorageLive = StorageLive;
@@ -56947,6 +58238,7 @@ exports.commitPartialLoss = commitPartialLoss;
 exports.commitPartialLossCost = commitPartialLossCost;
 exports.commitPartialProfit = commitPartialProfit;
 exports.commitPartialProfitCost = commitPartialProfitCost;
+exports.commitSignalNotify = commitSignalNotify;
 exports.commitTrailingStop = commitTrailingStop;
 exports.commitTrailingStopCost = commitTrailingStopCost;
 exports.commitTrailingTake = commitTrailingTake;
@@ -56976,6 +58268,7 @@ exports.getDefaultConfig = getDefaultConfig;
 exports.getEffectivePriceOpen = getEffectivePriceOpen;
 exports.getExchangeSchema = getExchangeSchema;
 exports.getFrameSchema = getFrameSchema;
+exports.getLatestSignal = getLatestSignal;
 exports.getMaxDrawdownDistancePnlCost = getMaxDrawdownDistancePnlCost;
 exports.getMaxDrawdownDistancePnlPercentage = getMaxDrawdownDistancePnlPercentage;
 exports.getMode = getMode;
@@ -57064,6 +58357,8 @@ exports.listenSignalBacktest = listenSignalBacktest;
 exports.listenSignalBacktestOnce = listenSignalBacktestOnce;
 exports.listenSignalLive = listenSignalLive;
 exports.listenSignalLiveOnce = listenSignalLiveOnce;
+exports.listenSignalNotify = listenSignalNotify;
+exports.listenSignalNotifyOnce = listenSignalNotifyOnce;
 exports.listenSignalOnce = listenSignalOnce;
 exports.listenStrategyCommit = listenStrategyCommit;
 exports.listenStrategyCommitOnce = listenStrategyCommitOnce;