backtest-kit 7.3.0 → 7.5.0

package/build/index.cjs

@@ -1017,6 +1017,13 @@ 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_STATE_UTILS_METHOD_NAME_USE_PERSIST_STATE_ADAPTER = "PersistStateUtils.usePersistStateAdapter";
+const PERSIST_STATE_UTILS_METHOD_NAME_READ_DATA = "PersistStateUtils.readStateData";
+const PERSIST_STATE_UTILS_METHOD_NAME_WRITE_DATA = "PersistStateUtils.writeStateData";
+const PERSIST_STATE_UTILS_METHOD_NAME_CLEAR = "PersistStateUtils.clear";
+const PERSIST_STATE_UTILS_METHOD_NAME_DISPOSE = "PersistStateUtils.dispose";
+const PERSIST_STATE_UTILS_METHOD_NAME_WAIT_FOR_INIT = "PersistStateUtils.waitForInit";
+const PERSIST_STATE_UTILS_METHOD_NAME_USE_DUMMY = "PersistStateUtils.useDummy";
 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";
@@ -2978,6 +2985,127 @@ class PersistRecentUtils {
  * Used by RecentPersistBacktestUtils/RecentPersistLiveUtils for recent signal persistence.
  */
 const PersistRecentAdapter = new PersistRecentUtils();
+/**
+ * Utility class for managing state persistence.
+ *
+ * Features:
+ * - Memoized storage instances per (signalId, bucketName) pair
+ * - Custom adapter support
+ * - Atomic read/write operations
+ *
+ * Storage layout: ./dump/state/<signalId>/<bucketName>.json
+ *
+ * Used by StatePersistInstance for crash-safe state persistence.
+ */
+class PersistStateUtils {
+    constructor() {
+        this.PersistStateFactory = PersistBase;
+        this.getStateStorage = functoolsKit.memoize(([signalId, bucketName]) => `${signalId}:${bucketName}`, (signalId, bucketName) => Reflect.construct(this.PersistStateFactory, [
+            bucketName,
+            `./dump/state/${signalId}/`,
+        ]));
+        /**
+         * Initializes the storage for a given (signalId, bucketName) pair.
+         *
+         * @param signalId - Signal identifier
+         * @param bucketName - Bucket name
+         * @param initial - Whether this is the first initialization
+         */
+        this.waitForInit = async (signalId, bucketName, initial) => {
+            LOGGER_SERVICE$7.info(PERSIST_STATE_UTILS_METHOD_NAME_WAIT_FOR_INIT, {
+                signalId,
+                bucketName,
+                initial,
+            });
+            const key = `${signalId}:${bucketName}`;
+            const isInitial = initial && !this.getStateStorage.has(key);
+            const stateStorage = this.getStateStorage(signalId, bucketName);
+            await stateStorage.waitForInit(isInitial);
+        };
+        /**
+         * Reads a state entry from persistence storage.
+         *
+         * @param signalId - Signal identifier
+         * @param bucketName - Bucket name
+         * @returns Promise resolving to entry data or null if not found
+         */
+        this.readStateData = async (signalId, bucketName) => {
+            LOGGER_SERVICE$7.info(PERSIST_STATE_UTILS_METHOD_NAME_READ_DATA, {
+                signalId,
+                bucketName,
+            });
+            const key = `${signalId}:${bucketName}`;
+            const isInitial = !this.getStateStorage.has(key);
+            const stateStorage = this.getStateStorage(signalId, bucketName);
+            await stateStorage.waitForInit(isInitial);
+            if (await stateStorage.hasValue(bucketName)) {
+                return await stateStorage.readValue(bucketName);
+            }
+            return null;
+        };
+        /**
+         * Writes a state entry to disk with atomic file writes.
+         *
+         * @param data - Entry data to persist
+         * @param signalId - Signal identifier
+         * @param bucketName - Bucket name
+         */
+        this.writeStateData = async (data, signalId, bucketName) => {
+            LOGGER_SERVICE$7.info(PERSIST_STATE_UTILS_METHOD_NAME_WRITE_DATA, {
+                signalId,
+                bucketName,
+            });
+            const key = `${signalId}:${bucketName}`;
+            const isInitial = !this.getStateStorage.has(key);
+            const stateStorage = this.getStateStorage(signalId, bucketName);
+            await stateStorage.waitForInit(isInitial);
+            await stateStorage.writeValue(bucketName, data);
+        };
+        /**
+         * Switches to a dummy persist adapter that discards all writes.
+         * All future persistence writes will be no-ops.
+         */
+        this.useDummy = () => {
+            LOGGER_SERVICE$7.log(PERSIST_STATE_UTILS_METHOD_NAME_USE_DUMMY);
+            this.usePersistStateAdapter(PersistDummy);
+        };
+        /**
+         * 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.
+         */
+        this.clear = () => {
+            LOGGER_SERVICE$7.info(PERSIST_STATE_UTILS_METHOD_NAME_CLEAR);
+            this.getStateStorage.clear();
+        };
+        /**
+         * Disposes of the state adapter and releases any resources.
+         * Call this when a signal is removed to clean up its associated storage.
+         *
+         * @param signalId - Signal identifier
+         * @param bucketName - Bucket name
+         */
+        this.dispose = (signalId, bucketName) => {
+            LOGGER_SERVICE$7.info(PERSIST_STATE_UTILS_METHOD_NAME_DISPOSE);
+            const key = `${signalId}:${bucketName}`;
+            this.getStateStorage.clear(key);
+        };
+    }
+    /**
+     * Registers a custom persistence adapter.
+     *
+     * @param Ctor - Custom PersistBase constructor
+     */
+    usePersistStateAdapter(Ctor) {
+        LOGGER_SERVICE$7.info(PERSIST_STATE_UTILS_METHOD_NAME_USE_PERSIST_STATE_ADAPTER);
+        this.PersistStateFactory = Ctor;
+    }
+}
+/**
+ * Global singleton instance of PersistStateUtils.
+ * Used by StatePersistInstance for crash-safe state persistence.
+ */
+const PersistStateAdapter = new PersistStateUtils();
 
 var _a$2, _b$2;
 const BUSY_DELAY = 100;
@@ -10443,7 +10571,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$v = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$w = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -10743,7 +10871,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$v(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => {
+        this.getStrategy = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$w(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,
@@ -11705,7 +11833,7 @@ class StrategyConnectionService {
                 }
                 return;
             }
-            const key = CREATE_KEY_FN$v(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$w(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             if (!this.getStrategy.has(key)) {
                 return;
             }
@@ -12879,7 +13007,7 @@ class ClientRisk {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$u = (riskName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$v = (riskName, exchangeName, frameName, backtest) => {
     const parts = [riskName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -12979,7 +13107,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$u(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
+        this.getRisk = functoolsKit.memoize(([riskName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$v(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
             const schema = this.riskSchemaService.get(riskName);
             return new ClientRisk({
                 ...schema,
@@ -13048,7 +13176,7 @@ class RiskConnectionService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$u(payload.riskName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$v(payload.riskName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getRisk.clear(key);
             }
             else {
@@ -14167,7 +14295,7 @@ class ClientAction {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$t = (actionName, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$u = (actionName, strategyName, exchangeName, frameName, backtest) => {
     const parts = [actionName, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -14219,7 +14347,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$t(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
+        this.getAction = functoolsKit.memoize(([actionName, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$u(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
             const schema = this.actionSchemaService.get(actionName);
             return new ClientAction({
                 ...schema,
@@ -14445,7 +14573,7 @@ class ActionConnectionService {
                 await Promise.all(actions.map(async (action) => await action.dispose()));
                 return;
             }
-            const key = CREATE_KEY_FN$t(payload.actionName, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$u(payload.actionName, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             if (!this.getAction.has(key)) {
                 return;
             }
@@ -14463,7 +14591,7 @@ const METHOD_NAME_VALIDATE$3 = "exchangeCoreService validate";
  * @param exchangeName - Exchange name
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$s = (exchangeName) => {
+const CREATE_KEY_FN$t = (exchangeName) => {
     return exchangeName;
 };
 /**
@@ -14487,7 +14615,7 @@ 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$s(exchangeName), async (exchangeName) => {
+        this.validate = functoolsKit.memoize(([exchangeName]) => CREATE_KEY_FN$t(exchangeName), async (exchangeName) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$3, {
                 exchangeName,
             });
@@ -14739,7 +14867,7 @@ const METHOD_NAME_VALIDATE$2 = "strategyCoreService validate";
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$r = (context) => {
+const CREATE_KEY_FN$s = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -14771,7 +14899,7 @@ 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$r(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$s(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$2, {
                 context,
             });
@@ -16141,7 +16269,7 @@ class SizingGlobalService {
  * @param context - Context with riskName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$q = (context) => {
+const CREATE_KEY_FN$r = (context) => {
     const parts = [context.riskName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -16167,7 +16295,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$q(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$r(context), async (context) => {
             this.loggerService.log("riskGlobalService validate", {
                 context,
             });
@@ -16245,7 +16373,7 @@ const METHOD_NAME_VALIDATE$1 = "actionCoreService validate";
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$p = (context) => {
+const CREATE_KEY_FN$q = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -16289,7 +16417,7 @@ 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$p(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$q(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$1, {
                 context,
             });
@@ -21359,7 +21487,7 @@ const ReportWriter = new ReportWriterAdapter();
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$o = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$p = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -21605,7 +21733,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$o(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$p(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.
@@ -21762,7 +21890,7 @@ class BacktestMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$o(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$p(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -21824,7 +21952,7 @@ class BacktestMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$n = (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);
@@ -22319,7 +22447,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$n(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$o(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.
@@ -22537,7 +22665,7 @@ class LiveMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$n(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 {
@@ -22557,7 +22685,7 @@ class LiveMarkdownService {
  * @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$n = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -22846,7 +22974,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$m(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$n(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.
@@ -23049,7 +23177,7 @@ class ScheduleMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$m(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 {
@@ -23069,7 +23197,7 @@ class ScheduleMarkdownService {
  * @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$m = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -23314,7 +23442,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$l(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$m(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.
@@ -23481,7 +23609,7 @@ class PerformanceMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$l(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 {
@@ -23960,7 +24088,7 @@ class WalkerMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$k = (exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$l = (exchangeName, frameName, backtest) => {
     const parts = [exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -24407,7 +24535,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$k(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
+        this.getStorage = functoolsKit.memoize(([exchangeName, frameName, backtest]) => CREATE_KEY_FN$l(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
         /**
          * Subscribes to signal emitter to receive tick events.
          * Protected against multiple subscriptions.
@@ -24625,7 +24753,7 @@ class HeatMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$k(payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$l(payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -25656,7 +25784,7 @@ class ClientPartial {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$j = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
+const CREATE_KEY_FN$k = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Creates a callback function for emitting profit events to partialProfitSubject.
  *
@@ -25778,7 +25906,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$j(signalId, backtest), (signalId, backtest) => {
+        this.getPartial = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$k(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -25868,7 +25996,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$j(data.id, backtest);
+            const key = CREATE_KEY_FN$k(data.id, backtest);
             this.getPartial.clear(key);
         };
     }
@@ -25884,7 +26012,7 @@ class PartialConnectionService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$i = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$j = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -26107,7 +26235,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$i(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$j(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.
@@ -26317,7 +26445,7 @@ class PartialMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$i(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$j(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -26333,7 +26461,7 @@ class PartialMarkdownService {
  * @param context - Context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$h = (context) => {
+const CREATE_KEY_FN$i = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -26407,7 +26535,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$h(context), (context, methodName) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$i(context), (context, methodName) => {
             this.loggerService.log("partialGlobalService validate", {
                 context,
                 methodName,
@@ -26862,7 +26990,7 @@ class ClientBreakeven {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$g = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
+const CREATE_KEY_FN$h = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Creates a callback function for emitting breakeven events to breakevenSubject.
  *
@@ -26948,7 +27076,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$g(signalId, backtest), (signalId, backtest) => {
+        this.getBreakeven = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$h(signalId, backtest), (signalId, backtest) => {
             return new ClientBreakeven({
                 signalId,
                 logger: this.loggerService,
@@ -27009,7 +27137,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$g(data.id, backtest);
+            const key = CREATE_KEY_FN$h(data.id, backtest);
             this.getBreakeven.clear(key);
         };
     }
@@ -27025,7 +27153,7 @@ class BreakevenConnectionService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$f = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$g = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -27200,7 +27328,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$f(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$g(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.
@@ -27389,7 +27517,7 @@ class BreakevenMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$f(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$g(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -27405,7 +27533,7 @@ class BreakevenMarkdownService {
  * @param context - Context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$e = (context) => {
+const CREATE_KEY_FN$f = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -27479,7 +27607,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$e(context), (context, methodName) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$f(context), (context, methodName) => {
             this.loggerService.log("breakevenGlobalService validate", {
                 context,
                 methodName,
@@ -27700,7 +27828,7 @@ class ConfigValidationService {
  * @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$e = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -27867,7 +27995,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$d(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$e(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.
@@ -28056,7 +28184,7 @@ class RiskMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$d(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$e(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -30636,7 +30764,7 @@ class HighestProfitReportService {
  * @returns Colon-separated key string for memoization
  * @internal
  */
-const CREATE_KEY_FN$c = (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);
@@ -30878,7 +31006,7 @@ class StrategyMarkdownService {
          *
          * @internal
          */
-        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));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$d(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.
          *
@@ -31452,7 +31580,7 @@ class StrategyMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("strategyMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$c(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 {
@@ -31560,7 +31688,7 @@ class StrategyMarkdownService {
  * Creates a unique key for memoizing ReportStorage instances.
  * Key format: "symbol:strategyName:exchangeName[:frameName]:backtest|live"
  */
-const CREATE_KEY_FN$b = (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);
@@ -31753,7 +31881,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$b(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$c(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
@@ -31951,7 +32079,7 @@ class SyncMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("syncMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$b(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 {
@@ -31964,7 +32092,7 @@ class SyncMarkdownService {
 /**
  * Creates a unique memoization key for a symbol-strategy-exchange-frame-backtest combination.
  */
-const CREATE_KEY_FN$a = (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);
@@ -32142,7 +32270,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$a(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$b(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
@@ -32308,7 +32436,7 @@ class HighestProfitMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("highestProfitMarkdownService 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$b(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -32330,7 +32458,7 @@ const LISTEN_TIMEOUT$1 = 120000;
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$9 = (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);
@@ -32373,7 +32501,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$9(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
+        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$a(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
         /**
          * Returns the current market price for the given symbol and context.
          *
@@ -32402,10 +32530,10 @@ class PriceMetaService {
             if (source.data) {
                 return source.data;
             }
-            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...`);
+            console.warn(`PriceMetaService: No currentPrice available for ${CREATE_KEY_FN$a(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$9(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
+                throw new Error(`PriceMetaService: Timeout while waiting for currentPrice for ${CREATE_KEY_FN$a(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
             }
             return currentPrice;
         };
@@ -32447,7 +32575,7 @@ class PriceMetaService {
                 this.getSource.clear();
                 return;
             }
-            const key = CREATE_KEY_FN$9(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.getSource.clear(key);
         };
     }
@@ -32465,7 +32593,7 @@ const LISTEN_TIMEOUT = 120000;
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$8 = (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);
@@ -32508,7 +32636,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$8(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 candle timestamp (in milliseconds) for the given symbol and context.
          *
@@ -32536,10 +32664,10 @@ class TimeMetaService {
             if (source.data) {
                 return source.data;
             }
-            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...`);
+            console.warn(`TimeMetaService: No timestamp available for ${CREATE_KEY_FN$9(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$8(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
+                throw new Error(`TimeMetaService: Timeout while waiting for timestamp for ${CREATE_KEY_FN$9(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
             }
             return timestamp;
         };
@@ -32581,7 +32709,7 @@ class TimeMetaService {
                 this.getSource.clear();
                 return;
             }
-            const key = CREATE_KEY_FN$8(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);
         };
     }
@@ -32687,7 +32815,7 @@ class MaxDrawdownReportService {
 /**
  * Creates a unique memoization key for a symbol-strategy-exchange-frame-backtest combination.
  */
-const CREATE_KEY_FN$7 = (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);
@@ -32813,7 +32941,7 @@ class ReportStorage {
 class MaxDrawdownMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        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));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$8(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`.
@@ -32892,7 +33020,7 @@ class MaxDrawdownMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("maxDrawdownMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$7(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.getStorage.clear(key);
             }
             else {
@@ -32910,7 +33038,7 @@ const METHOD_NAME_VALIDATE = "notificationHelperService.validate";
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$6 = (context) => {
+const CREATE_KEY_FN$7 = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -32943,7 +33071,7 @@ class NotificationHelperService {
          * @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.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$7(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE, {
                 context,
             });
@@ -46487,7 +46615,7 @@ const RECENT_ADAPTER_METHOD_NAME_GET_MINUTES_SINCE_LATEST_SIGNAL = "RecentAdapte
  * @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 CREATE_KEY_FN$6 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -46577,7 +46705,7 @@ class RecentMemoryBacktestUtils {
             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);
+            const key = CREATE_KEY_FN$6(event.symbol, event.strategyName, event.exchangeName, event.data.frameName, event.backtest);
             this._signals.set(key, event.data);
         };
         /**
@@ -46590,7 +46718,7 @@ class RecentMemoryBacktestUtils {
          * @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);
+            const key = CREATE_KEY_FN$6(symbol, strategyName, exchangeName, frameName, backtest$1);
             backtest.loggerService.info(RECENT_MEMORY_BACKTEST_METHOD_NAME_GET_LATEST_SIGNAL, { key });
             return this._signals.get(key) ?? null;
         };
@@ -46696,7 +46824,7 @@ class RecentMemoryLiveUtils {
             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);
+            const key = CREATE_KEY_FN$6(event.symbol, event.strategyName, event.exchangeName, event.data.frameName, event.backtest);
             this._signals.set(key, event.data);
         };
         /**
@@ -46709,7 +46837,7 @@ class RecentMemoryLiveUtils {
          * @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);
+            const key = CREATE_KEY_FN$6(symbol, strategyName, exchangeName, frameName, backtest$1);
             backtest.loggerService.info(RECENT_MEMORY_LIVE_METHOD_NAME_GET_LATEST_SIGNAL, { key });
             return this._signals.get(key) ?? null;
         };
@@ -47060,6 +47188,554 @@ const RecentLive = new RecentLiveAdapter();
  */
 const RecentBacktest = new RecentBacktestAdapter();
 
+const CREATE_KEY_FN$5 = (signalId, bucketName) => `${signalId}_${bucketName}`;
+const STATE_LOCAL_INSTANCE_METHOD_NAME_GET = "StateLocalInstance.getState";
+const STATE_LOCAL_INSTANCE_METHOD_NAME_SET = "StateLocalInstance.setState";
+const STATE_PERSIST_INSTANCE_METHOD_NAME_WAIT_FOR_INIT = "StatePersistInstance.waitForInit";
+const STATE_PERSIST_INSTANCE_METHOD_NAME_GET = "StatePersistInstance.getState";
+const STATE_PERSIST_INSTANCE_METHOD_NAME_SET = "StatePersistInstance.setState";
+const STATE_BACKTEST_ADAPTER_METHOD_NAME_DISPOSE = "StateBacktestAdapter.dispose";
+const STATE_BACKTEST_ADAPTER_METHOD_NAME_GET = "StateBacktestAdapter.getState";
+const STATE_BACKTEST_ADAPTER_METHOD_NAME_SET = "StateBacktestAdapter.setState";
+const STATE_BACKTEST_ADAPTER_METHOD_NAME_USE_LOCAL = "StateBacktestAdapter.useLocal";
+const STATE_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST = "StateBacktestAdapter.usePersist";
+const STATE_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY = "StateBacktestAdapter.useDummy";
+const STATE_BACKTEST_ADAPTER_METHOD_NAME_USE_STATE_ADAPTER = "StateBacktestAdapter.useStateAdapter";
+const STATE_BACKTEST_ADAPTER_METHOD_NAME_CLEAR = "StateBacktestAdapter.clear";
+const STATE_LIVE_ADAPTER_METHOD_NAME_DISPOSE = "StateLiveAdapter.dispose";
+const STATE_LIVE_ADAPTER_METHOD_NAME_GET = "StateLiveAdapter.getState";
+const STATE_LIVE_ADAPTER_METHOD_NAME_SET = "StateLiveAdapter.setState";
+const STATE_LIVE_ADAPTER_METHOD_NAME_USE_LOCAL = "StateLiveAdapter.useLocal";
+const STATE_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST = "StateLiveAdapter.usePersist";
+const STATE_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY = "StateLiveAdapter.useDummy";
+const STATE_LIVE_ADAPTER_METHOD_NAME_USE_STATE_ADAPTER = "StateLiveAdapter.useStateAdapter";
+const STATE_LIVE_ADAPTER_METHOD_NAME_CLEAR = "StateLiveAdapter.clear";
+const STATE_ADAPTER_METHOD_NAME_ENABLE = "StateAdapter.enable";
+const STATE_ADAPTER_METHOD_NAME_DISABLE = "StateAdapter.disable";
+const STATE_ADAPTER_METHOD_NAME_GET = "StateAdapter.getState";
+const STATE_ADAPTER_METHOD_NAME_SET = "StateAdapter.setState";
+/**
+ * In-process state instance backed by a plain object reference.
+ * All data lives in process memory only - no disk persistence.
+ *
+ * Features:
+ * - Mutable in-memory state with functional dispatch support
+ * - Scoped per (signalId, bucketName) pair
+ *
+ * Use for backtesting and unit tests where persistence between runs is not needed.
+ * Tracks per-trade metrics such as peakPercent and minutesOpen to implement
+ * the capitulation rule: exit when peak < threshold after N minutes open.
+ */
+class StateLocalInstance {
+    constructor(initialValue, signalId, bucketName) {
+        this.initialValue = initialValue;
+        this.signalId = signalId;
+        this.bucketName = bucketName;
+        /**
+         * Initializes _value from initialValue - local state needs no async setup.
+         * @returns Promise that resolves immediately
+         */
+        this.waitForInit = functoolsKit.singleshot(async (_initial) => {
+            this._value = this.initialValue;
+        });
+        /**
+         * Update the in-memory state value.
+         * @param dispatch - New value or updater function receiving current value
+         * @returns Updated state value
+         */
+        this.setState = functoolsKit.queued(async (dispatch) => {
+            backtest.loggerService.debug(STATE_LOCAL_INSTANCE_METHOD_NAME_SET, {
+                signalId: this.signalId,
+                bucketName: this.bucketName,
+            });
+            if (typeof dispatch === "function") {
+                this._value = await dispatch(this._value);
+            }
+            else {
+                this._value = dispatch;
+            }
+            return this._value;
+        });
+    }
+    /**
+     * Read the current in-memory state value.
+     * @returns Current state value
+     */
+    async getState() {
+        backtest.loggerService.debug(STATE_LOCAL_INSTANCE_METHOD_NAME_GET, {
+            signalId: this.signalId,
+            bucketName: this.bucketName,
+        });
+        return this._value;
+    }
+    /** Releases resources held by this instance. */
+    async dispose() {
+        backtest.loggerService.debug(STATE_BACKTEST_ADAPTER_METHOD_NAME_DISPOSE, {
+            signalId: this.signalId,
+            bucketName: this.bucketName,
+        });
+    }
+}
+/**
+ * No-op state instance that discards all writes.
+ * Used for disabling state in tests or dry-run scenarios.
+ *
+ * Useful when replaying historical candles without needing to accumulate
+ * peakPercent/minutesOpen — the capitulation rule is simply never triggered.
+ */
+class StateDummyInstance {
+    constructor(initialValue, signalId, bucketName) {
+        this.initialValue = initialValue;
+        this.signalId = signalId;
+        this.bucketName = bucketName;
+        /**
+         * No-op initialization.
+         * @returns Promise that resolves immediately
+         */
+        this.waitForInit = functoolsKit.singleshot(async (_initial) => {
+        });
+    }
+    /**
+     * No-op read - always returns initialValue.
+     * @returns initialValue
+     */
+    async getState() {
+        return this.initialValue;
+    }
+    /**
+     * No-op write - discards the value and returns initialValue.
+     * @returns initialValue
+     */
+    async setState(_dispatch) {
+        return this.initialValue;
+    }
+    /** No-op. */
+    async dispose() {
+    }
+}
+/**
+ * File-system backed state instance.
+ * Data is persisted atomically to disk via PersistStateAdapter.
+ * State is restored from disk on waitForInit.
+ *
+ * Features:
+ * - Crash-safe atomic file writes
+ * - Functional dispatch support
+ * - Scoped per (signalId, bucketName) pair
+ *
+ * Use in live trading to survive process restarts mid-trade.
+ * Preserves peakPercent and minutesOpen so the capitulation rule
+ * (exit if peak < threshold after N minutes) continues correctly after a crash.
+ */
+class StatePersistInstance {
+    constructor(initialValue, signalId, bucketName) {
+        this.initialValue = initialValue;
+        this.signalId = signalId;
+        this.bucketName = bucketName;
+        /**
+         * Initialize persistence storage and restore state from disk.
+         * @param initial - Whether this is the first initialization
+         */
+        this.waitForInit = functoolsKit.singleshot(async (initial) => {
+            backtest.loggerService.debug(STATE_PERSIST_INSTANCE_METHOD_NAME_WAIT_FOR_INIT, {
+                signalId: this.signalId,
+                bucketName: this.bucketName,
+                initial,
+            });
+            await PersistStateAdapter.waitForInit(this.signalId, this.bucketName, initial);
+            const data = await PersistStateAdapter.readStateData(this.signalId, this.bucketName);
+            if (data) {
+                this._value = data.data;
+                return;
+            }
+            this._value = this.initialValue;
+        });
+        /**
+         * Update state and persist to disk atomically.
+         * @param dispatch - New value or updater function receiving current value
+         * @returns Updated state value
+         */
+        this.setState = functoolsKit.queued(async (dispatch) => {
+            backtest.loggerService.debug(STATE_PERSIST_INSTANCE_METHOD_NAME_SET, {
+                signalId: this.signalId,
+                bucketName: this.bucketName,
+            });
+            if (typeof dispatch === "function") {
+                this._value = await dispatch(this._value);
+            }
+            else {
+                this._value = dispatch;
+            }
+            const id = CREATE_KEY_FN$5(this.signalId, this.bucketName);
+            await PersistStateAdapter.writeStateData({ id, data: this._value }, this.signalId, this.bucketName);
+            return this._value;
+        });
+    }
+    /**
+     * Read the current persisted state value.
+     * @returns Current state value
+     */
+    async getState() {
+        backtest.loggerService.debug(STATE_PERSIST_INSTANCE_METHOD_NAME_GET, {
+            signalId: this.signalId,
+            bucketName: this.bucketName,
+        });
+        return this._value;
+    }
+    /** Releases resources held by this instance. */
+    async dispose() {
+        backtest.loggerService.debug(STATE_LIVE_ADAPTER_METHOD_NAME_DISPOSE, {
+            signalId: this.signalId,
+            bucketName: this.bucketName,
+        });
+        await PersistStateAdapter.dispose(this.signalId, this.bucketName);
+    }
+}
+/**
+ * Backtest state adapter with pluggable storage backend.
+ *
+ * Features:
+ * - Adapter pattern for swappable state instance implementations
+ * - Default backend: StateLocalInstance (in-memory, no disk persistence)
+ * - Alternative backends: StatePersistInstance, StateDummyInstance
+ * - Convenience methods: useLocal(), usePersist(), useDummy(), useStateAdapter()
+ * - Memoized instances per (signalId, bucketName) pair; cleared via disposeSignal() from StateAdapter
+ *
+ * Primary use case — LLM-driven capitulation rule:
+ * Profitable trades endure -0.5–2.5% drawdown and still reach peak 2–3%+.
+ * SL trades never go positive (Feb25) or show peak < 0.15% (Feb08, Feb13).
+ * Rule: if position open >= N minutes and peakPercent < threshold (e.g. 0.3%),
+ * the LLM thesis was not confirmed by market — exit immediately.
+ * State tracks `{ peakPercent, minutesOpen }` per signal across onActivePing ticks.
+ */
+class StateBacktestAdapter {
+    constructor() {
+        this.StateFactory = StateLocalInstance;
+        this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$5(signalId, bucketName), (signalId, bucketName, initialValue) => Reflect.construct(this.StateFactory, [initialValue, signalId, bucketName]));
+        /**
+         * Disposes all memoized instances for the given signalId.
+         * Called by StateAdapter when a signal is cancelled or closed.
+         * @param signalId - Signal identifier to dispose
+         */
+        this.disposeSignal = (signalId) => {
+            const prefix = CREATE_KEY_FN$5(signalId, "");
+            for (const key of this.getInstance.keys()) {
+                if (key.startsWith(prefix)) {
+                    const instance = this.getInstance.get(key);
+                    instance && instance.dispose();
+                    this.getInstance.clear(key);
+                }
+            }
+        };
+        /**
+         * Read the current state value for a signal.
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @param dto.initialValue - Default value when no persisted state exists
+         * @returns Current state value
+         */
+        this.getState = async (dto) => {
+            backtest.loggerService.debug(STATE_BACKTEST_ADAPTER_METHOD_NAME_GET, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+            });
+            const key = CREATE_KEY_FN$5(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName, dto.initialValue);
+            await instance.waitForInit(isInitial);
+            return await instance.getState();
+        };
+        /**
+         * Update the state value for a signal.
+         * @param dispatch - New value or updater function receiving current value
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @param dto.initialValue - Default value when no persisted state exists
+         * @returns Updated state value
+         */
+        this.setState = async (dispatch, dto) => {
+            backtest.loggerService.debug(STATE_BACKTEST_ADAPTER_METHOD_NAME_SET, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+            });
+            const key = CREATE_KEY_FN$5(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName, dto.initialValue);
+            await instance.waitForInit(isInitial);
+            return await instance.setState(dispatch);
+        };
+        /**
+         * Switches to in-memory adapter (default).
+         * All data lives in process memory only.
+         */
+        this.useLocal = () => {
+            backtest.loggerService.info(STATE_BACKTEST_ADAPTER_METHOD_NAME_USE_LOCAL);
+            this.StateFactory = StateLocalInstance;
+        };
+        /**
+         * Switches to file-system backed adapter.
+         * Data is persisted to disk via PersistStateAdapter.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(STATE_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this.StateFactory = StatePersistInstance;
+        };
+        /**
+         * Switches to dummy adapter that discards all writes.
+         */
+        this.useDummy = () => {
+            backtest.loggerService.info(STATE_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY);
+            this.StateFactory = StateDummyInstance;
+        };
+        /**
+         * Switches to a custom state adapter implementation.
+         * @param Ctor - Constructor for the custom state instance
+         */
+        this.useStateAdapter = (Ctor) => {
+            backtest.loggerService.info(STATE_BACKTEST_ADAPTER_METHOD_NAME_USE_STATE_ADAPTER);
+            this.StateFactory = Ctor;
+        };
+        /**
+         * Clears the memoized instance cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new instances are created with the updated base path.
+         */
+        this.clear = () => {
+            backtest.loggerService.info(STATE_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
+    }
+}
+/**
+ * Live trading state adapter with pluggable storage backend.
+ *
+ * Features:
+ * - Adapter pattern for swappable state instance implementations
+ * - Default backend: StatePersistInstance (file-system backed, survives restarts)
+ * - Alternative backends: StateLocalInstance, StateDummyInstance
+ * - Convenience methods: useLocal(), usePersist(), useDummy(), useStateAdapter()
+ * - Memoized instances per (signalId, bucketName) pair; cleared via disposeSignal() from StateAdapter
+ *
+ * Primary use case — LLM-driven capitulation rule:
+ * Profitable trades endure -0.5–2.5% drawdown and still reach peak 2–3%+.
+ * SL trades never go positive (Feb25) or show peak < 0.15% (Feb08, Feb13).
+ * Rule: if position open >= N minutes and peakPercent < threshold (e.g. 0.3%),
+ * the LLM thesis was not confirmed by market — exit immediately.
+ * State persists `{ peakPercent, minutesOpen }` per signal across process restarts.
+ */
+class StateLiveAdapter {
+    constructor() {
+        this.StateFactory = StatePersistInstance;
+        this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$5(signalId, bucketName), (signalId, bucketName, initialValue) => Reflect.construct(this.StateFactory, [initialValue, signalId, bucketName]));
+        /**
+         * Disposes all memoized instances for the given signalId.
+         * Called by StateAdapter when a signal is cancelled or closed.
+         * @param signalId - Signal identifier to dispose
+         */
+        this.disposeSignal = (signalId) => {
+            const prefix = CREATE_KEY_FN$5(signalId, "");
+            for (const key of this.getInstance.keys()) {
+                if (key.startsWith(prefix)) {
+                    const instance = this.getInstance.get(key);
+                    instance && instance.dispose();
+                    this.getInstance.clear(key);
+                }
+            }
+        };
+        /**
+         * Read the current state value for a signal.
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @param dto.initialValue - Default value when no persisted state exists
+         * @returns Current state value
+         */
+        this.getState = async (dto) => {
+            backtest.loggerService.debug(STATE_LIVE_ADAPTER_METHOD_NAME_GET, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+            });
+            const key = CREATE_KEY_FN$5(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName, dto.initialValue);
+            await instance.waitForInit(isInitial);
+            return await instance.getState();
+        };
+        /**
+         * Update the state value for a signal.
+         * @param dispatch - New value or updater function receiving current value
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @param dto.initialValue - Default value when no persisted state exists
+         * @returns Updated state value
+         */
+        this.setState = async (dispatch, dto) => {
+            backtest.loggerService.debug(STATE_LIVE_ADAPTER_METHOD_NAME_SET, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+            });
+            const key = CREATE_KEY_FN$5(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName, dto.initialValue);
+            await instance.waitForInit(isInitial);
+            return await instance.setState(dispatch);
+        };
+        /**
+         * Switches to in-memory adapter.
+         * All data lives in process memory only.
+         */
+        this.useLocal = () => {
+            backtest.loggerService.info(STATE_LIVE_ADAPTER_METHOD_NAME_USE_LOCAL);
+            this.StateFactory = StateLocalInstance;
+        };
+        /**
+         * Switches to file-system backed adapter (default).
+         * Data is persisted to disk via PersistStateAdapter.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(STATE_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this.StateFactory = StatePersistInstance;
+        };
+        /**
+         * Switches to dummy adapter that discards all writes.
+         */
+        this.useDummy = () => {
+            backtest.loggerService.info(STATE_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY);
+            this.StateFactory = StateDummyInstance;
+        };
+        /**
+         * Switches to a custom state adapter implementation.
+         * @param Ctor - Constructor for the custom state instance
+         */
+        this.useStateAdapter = (Ctor) => {
+            backtest.loggerService.info(STATE_LIVE_ADAPTER_METHOD_NAME_USE_STATE_ADAPTER);
+            this.StateFactory = Ctor;
+        };
+        /**
+         * Clears the memoized instance cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new instances are created with the updated base path.
+         */
+        this.clear = () => {
+            backtest.loggerService.info(STATE_LIVE_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
+    }
+}
+/**
+ * Main state adapter that manages both backtest and live state storage.
+ *
+ * Features:
+ * - Subscribes to signal lifecycle events (cancelled/closed) to dispose stale instances
+ * - Routes all operations to StateBacktest or StateLive based on dto.backtest
+ * - Singleshot enable pattern prevents duplicate subscriptions
+ * - Cleanup function for proper unsubscription
+ */
+class StateAdapter {
+    constructor() {
+        /**
+         * Enables state storage by subscribing to signal lifecycle events.
+         * Clears memoized instances in StateBacktest and StateLive when a signal
+         * is cancelled or closed, preventing stale instances from accumulating.
+         * Uses singleshot to ensure one-time subscription.
+         *
+         * @returns Cleanup function that unsubscribes from all emitters
+         */
+        this.enable = functoolsKit.singleshot(() => {
+            backtest.loggerService.info(STATE_ADAPTER_METHOD_NAME_ENABLE);
+            const unCancel = signalEmitter
+                .filter(({ action }) => action === "cancelled")
+                .connect(({ signal }) => {
+                StateBacktest.disposeSignal(signal.id);
+                StateLive.disposeSignal(signal.id);
+            });
+            const unClose = signalEmitter
+                .filter(({ action }) => action === "closed")
+                .connect(({ signal }) => {
+                StateBacktest.disposeSignal(signal.id);
+                StateLive.disposeSignal(signal.id);
+            });
+            return functoolsKit.compose(() => unCancel(), () => unClose(), () => this.enable.clear());
+        });
+        /**
+         * Disables state storage by unsubscribing from signal lifecycle events.
+         * Safe to call multiple times.
+         */
+        this.disable = () => {
+            backtest.loggerService.info(STATE_ADAPTER_METHOD_NAME_DISABLE);
+            if (this.enable.hasValue()) {
+                const lastSubscription = this.enable();
+                lastSubscription();
+            }
+        };
+        /**
+         * Read the current state value for a signal.
+         * Routes to StateBacktest or StateLive based on dto.backtest.
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @param dto.initialValue - Default value when no persisted state exists
+         * @param dto.backtest - Flag indicating if the context is backtest or live
+         * @returns Current state value
+         * @throws Error if adapter is not enabled
+         */
+        this.getState = async (dto) => {
+            if (!this.enable.hasValue()) {
+                throw new Error("StateAdapter is not enabled. Call enable() first.");
+            }
+            backtest.loggerService.debug(STATE_ADAPTER_METHOD_NAME_GET, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                backtest: dto.backtest,
+            });
+            if (dto.backtest) {
+                return await StateBacktest.getState(dto);
+            }
+            return await StateLive.getState(dto);
+        };
+        /**
+         * Update the state value for a signal.
+         * Routes to StateBacktest or StateLive based on dto.backtest.
+         * @param dispatch - New value or updater function receiving current value
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @param dto.initialValue - Default value when no persisted state exists
+         * @param dto.backtest - Flag indicating if the context is backtest or live
+         * @returns Updated state value
+         * @throws Error if adapter is not enabled
+         */
+        this.setState = async (dispatch, dto) => {
+            if (!this.enable.hasValue()) {
+                throw new Error("StateAdapter is not enabled. Call enable() first.");
+            }
+            backtest.loggerService.debug(STATE_ADAPTER_METHOD_NAME_SET, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                backtest: dto.backtest,
+            });
+            if (dto.backtest) {
+                return await StateBacktest.setState(dispatch, dto);
+            }
+            return await StateLive.setState(dispatch, dto);
+        };
+    }
+}
+/**
+ * Global singleton instance of StateAdapter.
+ * Provides unified state management for backtest and live trading.
+ */
+const State = new StateAdapter();
+/**
+ * Global singleton instance of StateLiveAdapter.
+ * Provides live trading state storage with pluggable backends.
+ */
+const StateLive = new StateLiveAdapter();
+/**
+ * Global singleton instance of StateBacktestAdapter.
+ * Provides backtest state storage with pluggable backends.
+ */
+const StateBacktest = new StateBacktestAdapter();
+
+const GET_SIGNAL_STATE_METHOD_NAME = "signal.getSignalState";
+const SET_SIGNAL_STATE_METHOD_NAME = "signal.setSignalState";
 const GET_LATEST_SIGNAL_METHOD_NAME = "signal.getLatestSignal";
 const GET_MINUTES_SINCE_LATEST_SIGNAL_CREATED_METHOD_NAME = "signal.getMinutesSinceLatestSignalCreated";
 /**
@@ -47135,6 +47811,243 @@ async function getMinutesSinceLatestSignalCreated(symbol) {
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     return await Recent.getMinutesSinceLatestSignalCreated(symbol, { exchangeName, frameName, strategyName });
 }
+/**
+ * Reads the state value scoped to the current active signal.
+ *
+ * Resolves the active pending signal automatically from execution context.
+ * If no pending signal exists, logs a warning and returns the initialValue.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * Intended for LLM-driven capitulation strategies that accumulate per-trade
+ * metrics (e.g. peakPercent, minutesOpen) across onActivePing ticks.
+ * Profitable trades endure -0.5–2.5% drawdown and reach peak 2–3%+.
+ * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
+ * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
+ *
+ * @param dto.bucketName - State bucket name
+ * @param dto.initialValue - Default value when no persisted state exists
+ * @returns Promise resolving to current state value, or initialValue if no signal
+ *
+ * @deprecated Better use `createSignalState().getState` with codestyle native syntax
+ *
+ * @example
+ * ```typescript
+ * import { getSignalState } from "backtest-kit";
+ *
+ * const { peakPercent, minutesOpen } = await getSignalState({
+ *   bucketName: "trade",
+ *   initialValue: { peakPercent: 0, minutesOpen: 0 },
+ * });
+ * if (minutesOpen >= 15 && peakPercent < 0.3) {
+ *   await commitMarketClose(symbol); // capitulate — LLM thesis not confirmed
+ * }
+ * ```
+ */
+async function getSignalState(dto) {
+    const { bucketName, initialValue } = dto;
+    backtest.loggerService.info(GET_SIGNAL_STATE_METHOD_NAME, { bucketName });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("getSignalState requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("getSignalState requires a method context");
+    }
+    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await State.getState({
+            signalId: signal.id,
+            bucketName,
+            initialValue,
+            backtest: isBacktest,
+        });
+    }
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await State.getState({
+            signalId: signal.id,
+            bucketName,
+            initialValue,
+            backtest: isBacktest,
+        });
+    }
+    throw new Error(`getSignalState requires a pending or scheduled signal for symbol=${symbol} bucketName=${bucketName}`);
+}
+/**
+ * Updates the state value scoped to the current active signal.
+ *
+ * Resolves the active pending signal automatically from execution context.
+ * If no pending signal exists, logs a warning and returns without writing.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * Intended for LLM-driven capitulation strategies that accumulate per-trade
+ * metrics (e.g. peakPercent, minutesOpen) across onActivePing ticks.
+ * Profitable trades endure -0.5–2.5% drawdown and reach peak 2–3%+.
+ * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
+ * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
+ *
+ * @param dto.bucketName - State bucket name
+ * @param dto.initialValue - Default value when no persisted state exists
+ * @param dto.dispatch - New value or updater function receiving current value
+ * @returns Promise resolving to updated state value, or initialValue if no signal
+ *
+ * @deprecated Better use `createSignalState().setState` with codestyle native syntax
+ *
+ * @example
+ * ```typescript
+ * import { setSignalState } from "backtest-kit";
+ *
+ * await setSignalState(
+ *   dispatch: (s) => ({
+ *     peakPercent: Math.max(s.peakPercent, currentUnrealisedPercent),
+ *     minutesOpen: s.minutesOpen + 1,
+ *   }),
+ *   {
+ *     bucketName: "trade",
+ *     initialValue: { peakPercent: 0, minutesOpen: 0 },
+ *   }
+ * );
+ * ```
+ */
+async function setSignalState(dispatch, dto) {
+    const { bucketName, initialValue } = dto;
+    backtest.loggerService.info(SET_SIGNAL_STATE_METHOD_NAME, { bucketName });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("setSignalState requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("setSignalState requires a method context");
+    }
+    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await State.setState(dispatch, {
+            signalId: signal.id,
+            bucketName,
+            initialValue,
+            backtest: isBacktest,
+        });
+    }
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await State.setState(dispatch, {
+            signalId: signal.id,
+            bucketName,
+            initialValue,
+            backtest: isBacktest,
+        });
+    }
+    throw new Error(`setSignalState requires a pending or scheduled signal for symbol=${symbol} bucketName=${bucketName}`);
+}
+
+const CREATE_SIGNAL_STATE_METHOD_NAME = "state.createSignalState";
+const CREATE_SET_STATE_FN = (params) => async (dispatch) => {
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("createSignalState requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("createSignalState requires a method context");
+    }
+    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await State.setState(dispatch, {
+            backtest: isBacktest,
+            bucketName: params.bucketName,
+            initialValue: params.initialValue,
+            signalId: signal.id,
+        });
+    }
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await State.setState(dispatch, {
+            backtest: isBacktest,
+            bucketName: params.bucketName,
+            initialValue: params.initialValue,
+            signalId: signal.id,
+        });
+    }
+    throw new Error(`createSignalState requires a pending or scheduled signal for symbol=${symbol} bucketName=${params.bucketName}`);
+};
+const CREATE_GET_STATE_FN = (params) => async () => {
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("createSignalState requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("createSignalState requires a method context");
+    }
+    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await State.getState({
+            backtest: isBacktest,
+            bucketName: params.bucketName,
+            initialValue: params.initialValue,
+            signalId: signal.id,
+        });
+    }
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await State.getState({
+            backtest: isBacktest,
+            bucketName: params.bucketName,
+            initialValue: params.initialValue,
+            signalId: signal.id,
+        });
+    }
+    throw new Error(`createSignalState requires a pending or scheduled signal for symbol=${symbol} bucketName=${params.bucketName}`);
+};
+/**
+ * Creates a bound [getState, setState] tuple scoped to a bucket and initial value.
+ *
+ * Both returned functions resolve the active pending or scheduled signal and the
+ * backtest/live flag automatically from execution context — no signalId argument required.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * Intended for LLM-driven capitulation strategies that accumulate per-trade
+ * metrics (e.g. peakPercent, minutesOpen) across onActivePing ticks.
+ * Profitable trades endure -0.5–2.5% drawdown and reach peak 2–3%+.
+ * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
+ * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
+ *
+ * @param params.bucketName - Logical namespace for grouping state buckets within a signal
+ * @param params.initialValue - Default value when no persisted state exists
+ * @returns Tuple [getState, setState] bound to the bucket and initial value
+ *
+ * @example
+ * ```typescript
+ * import { createSignalState } from "backtest-kit";
+ *
+ * const [getTradeState, setTradeState] = createSignalState({
+ *   bucketName: "trade",
+ *   initialValue: { peakPercent: 0, minutesOpen: 0 },
+ * });
+ *
+ * // in onActivePing:
+ * await setTradeState((s) => ({
+ *   peakPercent: Math.max(s.peakPercent, currentUnrealisedPercent),
+ *   minutesOpen: s.minutesOpen + 1,
+ * }));
+ * const { peakPercent, minutesOpen } = await getTradeState();
+ * if (minutesOpen >= 15 && peakPercent < 0.3) await commitMarketClose(symbol);
+ * ```
+ */
+function createSignalState(params) {
+    backtest.loggerService.info(CREATE_SIGNAL_STATE_METHOD_NAME, {
+        bucketName: params.bucketName,
+    });
+    return [
+        CREATE_GET_STATE_FN(params),
+        CREATE_SET_STATE_FN(params),
+    ];
+}
 
 const DEFAULT_BM25_K1 = 1.5;
 const DEFAULT_BM25_B = 0.75;
@@ -47221,7 +48134,7 @@ const createSearchIndex = () => {
     return { upsert, remove, list, search, read };
 };
 
-const CREATE_KEY_FN$4 = (signalId, bucketName) => `${signalId}-${bucketName}`;
+const CREATE_KEY_FN$4 = (signalId, bucketName) => `${signalId}_${bucketName}`;
 const LIST_MEMORY_FN = ({ id, content }) => ({
     memoryId: id,
     content: content,
@@ -47242,18 +48155,35 @@ const MEMORY_PERSIST_INSTANCE_METHOD_NAME_READ = "MemoryPersistInstance.readMemo
 const MEMORY_PERSIST_INSTANCE_METHOD_NAME_SEARCH = "MemoryPersistInstance.searchMemory";
 const MEMORY_PERSIST_INSTANCE_METHOD_NAME_LIST = "MemoryPersistInstance.listMemory";
 const MEMORY_PERSIST_INSTANCE_METHOD_NAME_REMOVE = "MemoryPersistInstance.removeMemory";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_DISPOSE = "MemoryBacktestAdapter.dispose";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_WRITE = "MemoryBacktestAdapter.writeMemory";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_SEARCH = "MemoryBacktestAdapter.searchMemory";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_LIST = "MemoryBacktestAdapter.listMemory";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_REMOVE = "MemoryBacktestAdapter.removeMemory";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_READ = "MemoryBacktestAdapter.readMemory";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_USE_LOCAL = "MemoryBacktestAdapter.useLocal";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST = "MemoryBacktestAdapter.usePersist";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY = "MemoryBacktestAdapter.useDummy";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER = "MemoryBacktestAdapter.useMemoryAdapter";
+const MEMORY_BACKTEST_ADAPTER_METHOD_NAME_CLEAR = "MemoryBacktestAdapter.clear";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_DISPOSE = "MemoryLiveAdapter.dispose";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_WRITE = "MemoryLiveAdapter.writeMemory";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_SEARCH = "MemoryLiveAdapter.searchMemory";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_LIST = "MemoryLiveAdapter.listMemory";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_REMOVE = "MemoryLiveAdapter.removeMemory";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_READ = "MemoryLiveAdapter.readMemory";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_USE_LOCAL = "MemoryLiveAdapter.useLocal";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST = "MemoryLiveAdapter.usePersist";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY = "MemoryLiveAdapter.useDummy";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER = "MemoryLiveAdapter.useMemoryAdapter";
+const MEMORY_LIVE_ADAPTER_METHOD_NAME_CLEAR = "MemoryLiveAdapter.clear";
 const MEMORY_ADAPTER_METHOD_NAME_ENABLE = "MemoryAdapter.enable";
 const MEMORY_ADAPTER_METHOD_NAME_DISABLE = "MemoryAdapter.disable";
-const MEMORY_ADAPTER_METHOD_NAME_DISPOSE = "MemoryAdapter.dispose";
 const MEMORY_ADAPTER_METHOD_NAME_WRITE = "MemoryAdapter.writeMemory";
 const MEMORY_ADAPTER_METHOD_NAME_SEARCH = "MemoryAdapter.searchMemory";
 const MEMORY_ADAPTER_METHOD_NAME_LIST = "MemoryAdapter.listMemory";
 const MEMORY_ADAPTER_METHOD_NAME_REMOVE = "MemoryAdapter.removeMemory";
 const MEMORY_ADAPTER_METHOD_NAME_READ = "MemoryAdapter.readMemory";
-const MEMORY_ADAPTER_METHOD_NAME_USE_LOCAL = "MemoryAdapter.useLocal";
-const MEMORY_ADAPTER_METHOD_NAME_USE_PERSIST = "MemoryAdapter.usePersist";
-const MEMORY_ADAPTER_METHOD_NAME_USE_DUMMY = "MemoryAdapter.useDummy";
-const MEMORY_ADAPTER_METHOD_NAME_CLEAR = "MemoryAdapter.clear";
 /**
  * In-memory BM25 search index backed instance.
  * All data lives in the process memory only - no disk persistence.
@@ -47278,7 +48208,7 @@ class MemoryLocalInstance {
      * Write a value into the BM25 index.
      * @param memoryId - Unique entry identifier
      * @param value - Value to store and index
-     * @param index - Optional BM25 index string; defaults to JSON.stringify(value)
+     * @param description - BM25 index string
      */
     async writeMemory(memoryId, value, description) {
         backtest.loggerService.debug(MEMORY_LOCAL_INSTANCE_METHOD_NAME_WRITE, {
@@ -47349,7 +48279,7 @@ class MemoryLocalInstance {
     }
     /** Releases resources held by this instance. */
     dispose() {
-        backtest.loggerService.debug(MEMORY_ADAPTER_METHOD_NAME_DISPOSE, {
+        backtest.loggerService.debug(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_DISPOSE, {
             signalId: this.signalId,
             bucketName: this.bucketName,
         });
@@ -47398,7 +48328,7 @@ class MemoryPersistInstance {
      * Write a value to disk and update the BM25 index.
      * @param memoryId - Unique entry identifier
      * @param value - Value to persist and index
-     * @param index - Optional BM25 index string; defaults to JSON.stringify(value)
+     * @param index - BM25 index string; defaults to JSON.stringify(value)
      */
     async writeMemory(memoryId, value, index = JSON.stringify(value)) {
         backtest.loggerService.debug(MEMORY_PERSIST_INSTANCE_METHOD_NAME_WRITE, {
@@ -47472,7 +48402,7 @@ class MemoryPersistInstance {
     }
     /** Releases resources held by this instance. */
     dispose() {
-        backtest.loggerService.debug(MEMORY_ADAPTER_METHOD_NAME_DISPOSE, {
+        backtest.loggerService.debug(MEMORY_LIVE_ADAPTER_METHOD_NAME_DISPOSE, {
             signalId: this.signalId,
             bucketName: this.bucketName,
         });
@@ -47532,48 +48462,377 @@ class MemoryDummyInstance {
     }
 }
 /**
- * Facade for memory instances scoped per (signalId, bucketName).
- * Manages lazy initialization and instance lifecycle.
+ * Backtest memory adapter with pluggable storage backend.
  *
  * Features:
- * - Memoized instances per (signalId, bucketName) pair
- * - Swappable backend via useLocal(), usePersist(), useDummy()
- * - Default backend: MemoryPersistInstance (in-memory BM25 + persist storage)
+ * - Adapter pattern for swappable memory instance implementations
+ * - Default backend: MemoryLocalInstance (in-memory BM25, no disk persistence)
+ * - Alternative backends: MemoryPersistInstance, MemoryDummyInstance
+ * - Convenience methods: useLocal(), usePersist(), useDummy(), useMemoryAdapter()
+ * - Memoized instances per (signalId, bucketName) pair; cleared via disposeSignal() from MemoryAdapter
+ *
+ * Use this adapter for backtest memory storage.
  */
-class MemoryAdapter {
+class MemoryBacktestAdapter {
+    constructor() {
+        this.MemoryFactory = MemoryLocalInstance;
+        this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$4(signalId, bucketName), (signalId, bucketName) => Reflect.construct(this.MemoryFactory, [signalId, bucketName]));
+        /**
+         * Disposes all memoized instances for the given signalId.
+         * Called by MemoryAdapter when a signal is cancelled or closed.
+         * @param signalId - Signal identifier to dispose
+         */
+        this.disposeSignal = (signalId) => {
+            const prefix = CREATE_KEY_FN$4(signalId, "");
+            for (const key of this.getInstance.keys()) {
+                if (key.startsWith(prefix)) {
+                    const instance = this.getInstance.get(key);
+                    instance && instance.dispose();
+                    this.getInstance.clear(key);
+                }
+            }
+        };
+        /**
+         * Write a value to memory.
+         * @param dto.memoryId - Unique entry identifier
+         * @param dto.value - Value to store
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @param dto.description - BM25 index string; defaults to JSON.stringify(value)
+         */
+        this.writeMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_WRITE, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                memoryId: dto.memoryId,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.writeMemory(dto.memoryId, dto.value, dto.description);
+        };
+        /**
+         * Search memory using BM25 full-text scoring.
+         * @param dto.query - Search query string
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @returns Matching entries sorted by relevance score
+         */
+        this.searchMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_SEARCH, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                query: dto.query,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.searchMemory(dto.query, dto.settings);
+        };
+        /**
+         * List all entries in memory.
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @returns Array of all stored entries
+         */
+        this.listMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_LIST, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.listMemory();
+        };
+        /**
+         * Remove an entry from memory.
+         * @param dto.memoryId - Unique entry identifier
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         */
+        this.removeMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_REMOVE, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                memoryId: dto.memoryId,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.removeMemory(dto.memoryId);
+        };
+        /**
+         * Read a single entry from memory.
+         * @param dto.memoryId - Unique entry identifier
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @returns Entry value
+         * @throws Error if entry not found
+         */
+        this.readMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_READ, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                memoryId: dto.memoryId,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.readMemory(dto.memoryId);
+        };
+        /**
+         * Switches to in-memory BM25 adapter (default).
+         * All data lives in process memory only.
+         */
+        this.useLocal = () => {
+            backtest.loggerService.info(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_USE_LOCAL);
+            this.MemoryFactory = MemoryLocalInstance;
+        };
+        /**
+         * Switches to file-system backed adapter.
+         * Data is persisted to ./dump/memory/<signalId>/<bucketName>/.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this.MemoryFactory = MemoryPersistInstance;
+        };
+        /**
+         * Switches to dummy adapter that discards all writes.
+         */
+        this.useDummy = () => {
+            backtest.loggerService.info(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY);
+            this.MemoryFactory = MemoryDummyInstance;
+        };
+        /**
+         * Switches to a custom memory adapter implementation.
+         * @param Ctor - Constructor for the custom memory instance
+         */
+        this.useMemoryAdapter = (Ctor) => {
+            backtest.loggerService.info(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER);
+            this.MemoryFactory = Ctor;
+        };
+        /**
+         * Clears the memoized instance cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new instances are created with the updated base path.
+         */
+        this.clear = () => {
+            backtest.loggerService.info(MEMORY_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
+    }
+}
+/**
+ * Live trading memory adapter with pluggable storage backend.
+ *
+ * Features:
+ * - Adapter pattern for swappable memory instance implementations
+ * - Default backend: MemoryPersistInstance (file-system backed, survives restarts)
+ * - Alternative backends: MemoryLocalInstance, MemoryDummyInstance
+ * - Convenience methods: useLocal(), usePersist(), useDummy(), useMemoryAdapter()
+ * - Memoized instances per (signalId, bucketName) pair; cleared via disposeSignal() from MemoryAdapter
+ *
+ * Use this adapter for live trading memory storage.
+ */
+class MemoryLiveAdapter {
     constructor() {
         this.MemoryFactory = MemoryPersistInstance;
         this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$4(signalId, bucketName), (signalId, bucketName) => Reflect.construct(this.MemoryFactory, [signalId, bucketName]));
         /**
-         * Activates the adapter by subscribing to signal lifecycle events.
-         * Clears memoized instances for a signalId when it is cancelled or closed,
-         * preventing stale instances from accumulating in memory.
-         * Idempotent — subsequent calls return the same subscription handle.
-         * Must be called before any memory method is used.
+         * Disposes all memoized instances for the given signalId.
+         * Called by MemoryAdapter when a signal is cancelled or closed.
+         * @param signalId - Signal identifier to dispose
+         */
+        this.disposeSignal = (signalId) => {
+            const prefix = CREATE_KEY_FN$4(signalId, "");
+            for (const key of this.getInstance.keys()) {
+                if (key.startsWith(prefix)) {
+                    const instance = this.getInstance.get(key);
+                    instance && instance.dispose();
+                    this.getInstance.clear(key);
+                }
+            }
+        };
+        /**
+         * Write a value to memory.
+         * @param dto.memoryId - Unique entry identifier
+         * @param dto.value - Value to store
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @param dto.description - BM25 index string; defaults to JSON.stringify(value)
+         */
+        this.writeMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_LIVE_ADAPTER_METHOD_NAME_WRITE, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                memoryId: dto.memoryId,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.writeMemory(dto.memoryId, dto.value, dto.description);
+        };
+        /**
+         * Search memory using BM25 full-text scoring.
+         * @param dto.query - Search query string
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @returns Matching entries sorted by relevance score
+         */
+        this.searchMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_LIVE_ADAPTER_METHOD_NAME_SEARCH, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                query: dto.query,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.searchMemory(dto.query, dto.settings);
+        };
+        /**
+         * List all entries in memory.
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @returns Array of all stored entries
+         */
+        this.listMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_LIVE_ADAPTER_METHOD_NAME_LIST, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.listMemory();
+        };
+        /**
+         * Remove an entry from memory.
+         * @param dto.memoryId - Unique entry identifier
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         */
+        this.removeMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_LIVE_ADAPTER_METHOD_NAME_REMOVE, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                memoryId: dto.memoryId,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.removeMemory(dto.memoryId);
+        };
+        /**
+         * Read a single entry from memory.
+         * @param dto.memoryId - Unique entry identifier
+         * @param dto.signalId - Signal identifier
+         * @param dto.bucketName - Bucket name
+         * @returns Entry value
+         * @throws Error if entry not found
+         */
+        this.readMemory = async (dto) => {
+            backtest.loggerService.debug(MEMORY_LIVE_ADAPTER_METHOD_NAME_READ, {
+                signalId: dto.signalId,
+                bucketName: dto.bucketName,
+                memoryId: dto.memoryId,
+            });
+            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(dto.signalId, dto.bucketName);
+            await instance.waitForInit(isInitial);
+            return await instance.readMemory(dto.memoryId);
+        };
+        /**
+         * Switches to in-memory BM25 adapter.
+         * All data lives in process memory only.
+         */
+        this.useLocal = () => {
+            backtest.loggerService.info(MEMORY_LIVE_ADAPTER_METHOD_NAME_USE_LOCAL);
+            this.MemoryFactory = MemoryLocalInstance;
+        };
+        /**
+         * Switches to file-system backed adapter (default).
+         * Data is persisted to ./dump/memory/<signalId>/<bucketName>/.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(MEMORY_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this.MemoryFactory = MemoryPersistInstance;
+        };
+        /**
+         * Switches to dummy adapter that discards all writes.
+         */
+        this.useDummy = () => {
+            backtest.loggerService.info(MEMORY_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY);
+            this.MemoryFactory = MemoryDummyInstance;
+        };
+        /**
+         * Switches to a custom memory adapter implementation.
+         * @param Ctor - Constructor for the custom memory instance
+         */
+        this.useMemoryAdapter = (Ctor) => {
+            backtest.loggerService.info(MEMORY_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER);
+            this.MemoryFactory = Ctor;
+        };
+        /**
+         * Clears the memoized instance cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new instances are created with the updated base path.
+         */
+        this.clear = () => {
+            backtest.loggerService.info(MEMORY_LIVE_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
+    }
+}
+/**
+ * Main memory adapter that manages both backtest and live memory storage.
+ *
+ * Features:
+ * - Subscribes to signal lifecycle events (cancelled/closed) to dispose stale instances
+ * - Routes all operations to MemoryBacktest or MemoryLive based on dto.backtest
+ * - Singleshot enable pattern prevents duplicate subscriptions
+ * - Cleanup function for proper unsubscription
+ */
+class MemoryAdapter {
+    constructor() {
+        /**
+         * Enables memory storage by subscribing to signal lifecycle events.
+         * Clears memoized instances in MemoryBacktest and MemoryLive when a signal
+         * is cancelled or closed, preventing stale instances from accumulating.
+         * Uses singleshot to ensure one-time subscription.
+         *
+         * @returns Cleanup function that unsubscribes from all emitters
          */
         this.enable = functoolsKit.singleshot(() => {
             backtest.loggerService.info(MEMORY_ADAPTER_METHOD_NAME_ENABLE);
-            const handleDispose = (signalId) => {
-                const prefix = CREATE_KEY_FN$4(signalId, "");
-                for (const key of this.getInstance.keys()) {
-                    if (key.startsWith(prefix)) {
-                        const instance = this.getInstance.get(key);
-                        instance && instance.dispose();
-                        this.getInstance.clear(key);
-                    }
-                }
-            };
             const unCancel = signalEmitter
                 .filter(({ action }) => action === "cancelled")
-                .connect(({ signal }) => handleDispose(signal.id));
+                .connect(({ signal }) => {
+                MemoryBacktest.disposeSignal(signal.id);
+                MemoryLive.disposeSignal(signal.id);
+            });
             const unClose = signalEmitter
                 .filter(({ action }) => action === "closed")
-                .connect(({ signal }) => handleDispose(signal.id));
-            return functoolsKit.compose(() => unCancel(), () => unClose());
+                .connect(({ signal }) => {
+                MemoryBacktest.disposeSignal(signal.id);
+                MemoryLive.disposeSignal(signal.id);
+            });
+            return functoolsKit.compose(() => unCancel(), () => unClose(), () => this.enable.clear());
         });
         /**
-         * Deactivates the adapter by unsubscribing from signal lifecycle events.
-         * No-op if enable() was never called.
+         * Disables memory storage by unsubscribing from signal lifecycle events.
+         * Safe to call multiple times.
          */
         this.disable = () => {
             backtest.loggerService.info(MEMORY_ADAPTER_METHOD_NAME_DISABLE);
@@ -47584,11 +48843,13 @@ class MemoryAdapter {
         };
         /**
          * Write a value to memory.
+         * Routes to MemoryBacktest or MemoryLive based on dto.backtest.
          * @param dto.memoryId - Unique entry identifier
          * @param dto.value - Value to store
          * @param dto.signalId - Signal identifier
          * @param dto.bucketName - Bucket name
-         * @param dto.description - Optional BM25 index string; defaults to JSON.stringify(value)
+         * @param dto.description - BM25 index string; defaults to JSON.stringify(value)
+         * @param dto.backtest - Flag indicating if the context is backtest or live
          */
         this.writeMemory = async (dto) => {
             if (!this.enable.hasValue()) {
@@ -47598,18 +48859,20 @@ class MemoryAdapter {
                 signalId: dto.signalId,
                 bucketName: dto.bucketName,
                 memoryId: dto.memoryId,
+                backtest: dto.backtest,
             });
-            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
-            const isInitial = !this.getInstance.has(key);
-            const instance = this.getInstance(dto.signalId, dto.bucketName);
-            await instance.waitForInit(isInitial);
-            return await instance.writeMemory(dto.memoryId, dto.value, dto.description);
+            if (dto.backtest) {
+                return await MemoryBacktest.writeMemory(dto);
+            }
+            return await MemoryLive.writeMemory(dto);
         };
         /**
          * Search memory using BM25 full-text scoring.
+         * Routes to MemoryBacktest or MemoryLive based on dto.backtest.
          * @param dto.query - Search query string
          * @param dto.signalId - Signal identifier
          * @param dto.bucketName - Bucket name
+         * @param dto.backtest - Flag indicating if the context is backtest or live
          * @returns Matching entries sorted by relevance score
          */
         this.searchMemory = async (dto) => {
@@ -47620,17 +48883,19 @@ class MemoryAdapter {
                 signalId: dto.signalId,
                 bucketName: dto.bucketName,
                 query: dto.query,
+                backtest: dto.backtest,
             });
-            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
-            const isInitial = !this.getInstance.has(key);
-            const instance = this.getInstance(dto.signalId, dto.bucketName);
-            await instance.waitForInit(isInitial);
-            return await instance.searchMemory(dto.query, dto.settings);
+            if (dto.backtest) {
+                return await MemoryBacktest.searchMemory(dto);
+            }
+            return await MemoryLive.searchMemory(dto);
         };
         /**
          * List all entries in memory.
+         * Routes to MemoryBacktest or MemoryLive based on dto.backtest.
          * @param dto.signalId - Signal identifier
          * @param dto.bucketName - Bucket name
+         * @param dto.backtest - Flag indicating if the context is backtest or live
          * @returns Array of all stored entries
          */
         this.listMemory = async (dto) => {
@@ -47640,18 +48905,20 @@ class MemoryAdapter {
             backtest.loggerService.debug(MEMORY_ADAPTER_METHOD_NAME_LIST, {
                 signalId: dto.signalId,
                 bucketName: dto.bucketName,
+                backtest: dto.backtest,
             });
-            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
-            const isInitial = !this.getInstance.has(key);
-            const instance = this.getInstance(dto.signalId, dto.bucketName);
-            await instance.waitForInit(isInitial);
-            return await instance.listMemory();
+            if (dto.backtest) {
+                return await MemoryBacktest.listMemory(dto);
+            }
+            return await MemoryLive.listMemory(dto);
         };
         /**
          * Remove an entry from memory.
+         * Routes to MemoryBacktest or MemoryLive based on dto.backtest.
          * @param dto.memoryId - Unique entry identifier
          * @param dto.signalId - Signal identifier
          * @param dto.bucketName - Bucket name
+         * @param dto.backtest - Flag indicating if the context is backtest or live
          */
         this.removeMemory = async (dto) => {
             if (!this.enable.hasValue()) {
@@ -47661,18 +48928,20 @@ class MemoryAdapter {
                 signalId: dto.signalId,
                 bucketName: dto.bucketName,
                 memoryId: dto.memoryId,
+                backtest: dto.backtest,
             });
-            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
-            const isInitial = !this.getInstance.has(key);
-            const instance = this.getInstance(dto.signalId, dto.bucketName);
-            await instance.waitForInit(isInitial);
-            return await instance.removeMemory(dto.memoryId);
+            if (dto.backtest) {
+                return await MemoryBacktest.removeMemory(dto);
+            }
+            return await MemoryLive.removeMemory(dto);
         };
         /**
          * Read a single entry from memory.
+         * Routes to MemoryBacktest or MemoryLive based on dto.backtest.
          * @param dto.memoryId - Unique entry identifier
          * @param dto.signalId - Signal identifier
          * @param dto.bucketName - Bucket name
+         * @param dto.backtest - Flag indicating if the context is backtest or live
          * @returns Entry value
          * @throws Error if entry not found
          */
@@ -47684,56 +48953,30 @@ class MemoryAdapter {
                 signalId: dto.signalId,
                 bucketName: dto.bucketName,
                 memoryId: dto.memoryId,
+                backtest: dto.backtest,
             });
-            const key = CREATE_KEY_FN$4(dto.signalId, dto.bucketName);
-            const isInitial = !this.getInstance.has(key);
-            const instance = this.getInstance(dto.signalId, dto.bucketName);
-            await instance.waitForInit(isInitial);
-            return await instance.readMemory(dto.memoryId);
-        };
-        /**
-         * Switches to in-memory BM25 adapter (default).
-         * All data lives in process memory only.
-         */
-        this.useLocal = () => {
-            backtest.loggerService.info(MEMORY_ADAPTER_METHOD_NAME_USE_LOCAL);
-            this.MemoryFactory = MemoryLocalInstance;
-        };
-        /**
-         * Switches to file-system backed adapter.
-         * Data is persisted to ./dump/memory/<signalId>/<bucketName>/.
-         */
-        this.usePersist = () => {
-            backtest.loggerService.info(MEMORY_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this.MemoryFactory = MemoryPersistInstance;
-        };
-        /**
-         * Switches to dummy adapter that discards all writes.
-         */
-        this.useDummy = () => {
-            backtest.loggerService.info(MEMORY_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this.MemoryFactory = MemoryDummyInstance;
-        };
-        /**
-         * Clears the memoized instance cache.
-         * Call this when process.cwd() changes between strategy iterations
-         * so new instances are created with the updated base path.
-         */
-        this.clear = () => {
-            backtest.loggerService.info(MEMORY_ADAPTER_METHOD_NAME_CLEAR);
-            this.getInstance.clear();
-        };
-        /**
-         * Releases resources held by this adapter.
-         * Delegates to disable() to unsubscribe from signal lifecycle events.
-         */
-        this.dispose = () => {
-            backtest.loggerService.info(MEMORY_ADAPTER_METHOD_NAME_DISPOSE);
-            this.disable();
+            if (dto.backtest) {
+                return await MemoryBacktest.readMemory(dto);
+            }
+            return await MemoryLive.readMemory(dto);
         };
     }
 }
+/**
+ * Global singleton instance of MemoryAdapter.
+ * Provides unified memory management for backtest and live trading.
+ */
 const Memory = new MemoryAdapter();
+/**
+ * Global singleton instance of MemoryLiveAdapter.
+ * Provides live trading memory storage with pluggable backends.
+ */
+const MemoryLive = new MemoryLiveAdapter();
+/**
+ * Global singleton instance of MemoryBacktestAdapter.
+ * Provides backtest memory storage with pluggable backends.
+ */
+const MemoryBacktest = new MemoryBacktestAdapter();
 
 const WRITE_MEMORY_METHOD_NAME = "memory.writeMemory";
 const READ_MEMORY_METHOD_NAME = "memory.readMemory";
@@ -47743,23 +48986,20 @@ const REMOVE_MEMORY_METHOD_NAME = "memory.removeMemory";
 /**
  * Writes a value to memory scoped to the current signal.
  *
- * Reads symbol from execution context and signalId from the active pending signal.
- * If no pending signal exists, logs a warning and returns without writing.
- *
+ * Resolves the active pending or scheduled signal automatically from execution context.
  * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Memory bucket name
  * @param dto.memoryId - Unique memory entry identifier
  * @param dto.value - Value to store
+ * @param dto.description - BM25 index string for contextual search
  * @returns Promise that resolves when write is complete
  *
- * @deprecated Better use Memory.writeMemory with manual signalId argument
- *
  * @example
  * ```typescript
  * import { writeMemory } from "backtest-kit";
  *
- * await writeMemory({ bucketName: "my-strategy", memoryId: "context", value: { trend: "up", confidence: 0.9 } });
+ * await writeMemory({ bucketName: "my-strategy", memoryId: "context", value: { trend: "up", confidence: 0.9 }, description: "Signal context at entry" });
  * ```
  */
 async function writeMemory(dto) {
@@ -47777,33 +49017,41 @@ async function writeMemory(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit writeMemory no pending signal for symbol=${symbol} memoryId=${memoryId}`);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Memory.writeMemory({
+            memoryId,
+            value,
+            signalId: signal.id,
+            bucketName,
+            description,
+            backtest: isBacktest,
+        });
         return;
     }
-    await Memory.writeMemory({
-        memoryId,
-        value,
-        signalId: signal.id,
-        bucketName,
-        description,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Memory.writeMemory({
+            memoryId,
+            value,
+            signalId: signal.id,
+            bucketName,
+            description,
+            backtest: isBacktest,
+        });
+        return;
+    }
+    throw new Error(`writeMemory requires a pending or scheduled signal for symbol=${symbol} memoryId=${memoryId}`);
 }
 /**
  * Reads a value from memory scoped to the current signal.
  *
- * Reads symbol from execution context and signalId from the active pending signal.
- * If no pending signal exists, logs a warning and returns null.
- *
+ * Resolves the active pending or scheduled signal automatically from execution context.
  * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Memory bucket name
  * @param dto.memoryId - Unique memory entry identifier
- * @returns Promise resolving to stored value or null if no signal
- * @throws Error if entry not found within an active signal
- *
- * @deprecated Better use Memory.readMemory with manual signalId argument
+ * @returns Promise resolving to stored value
+ * @throws Error if no pending or scheduled signal exists, or if entry not found
  *
  * @example
  * ```typescript
@@ -47827,30 +49075,35 @@ async function readMemory(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit readMemory no pending signal for symbol=${symbol} memoryId=${memoryId}`);
-        return null;
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await Memory.readMemory({
+            memoryId,
+            signalId: signal.id,
+            bucketName,
+            backtest: isBacktest,
+        });
     }
-    return await Memory.readMemory({
-        memoryId,
-        signalId: signal.id,
-        bucketName,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await Memory.readMemory({
+            memoryId,
+            signalId: signal.id,
+            bucketName,
+            backtest: isBacktest,
+        });
+    }
+    throw new Error(`readMemory requires a pending or scheduled signal for symbol=${symbol} memoryId=${memoryId}`);
 }
 /**
  * Searches memory entries for the current signal using BM25 full-text scoring.
  *
- * Reads symbol from execution context and signalId from the active pending signal.
- * If no pending signal exists, logs a warning and returns an empty array.
- *
+ * Resolves the active pending or scheduled signal automatically from execution context.
  * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Memory bucket name
  * @param dto.query - Search query string
- * @returns Promise resolving to matching entries sorted by relevance, or empty array if no signal
- *
- * @deprecated Better use Memory.searchMemory with manual signalId argument
+ * @returns Promise resolving to matching entries sorted by relevance
+ * @throws Error if no pending or scheduled signal exists
  *
  * @example
  * ```typescript
@@ -47874,29 +49127,34 @@ async function searchMemory(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit searchMemory no pending signal for symbol=${symbol} query=${query}`);
-        return [];
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await Memory.searchMemory({
+            query,
+            signalId: signal.id,
+            bucketName,
+            backtest: isBacktest,
+        });
     }
-    return await Memory.searchMemory({
-        query,
-        signalId: signal.id,
-        bucketName,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await Memory.searchMemory({
+            query,
+            signalId: signal.id,
+            bucketName,
+            backtest: isBacktest,
+        });
+    }
+    throw new Error(`searchMemory requires a pending or scheduled signal for symbol=${symbol} query=${query}`);
 }
 /**
  * Lists all memory entries for the current signal.
  *
- * Reads symbol from execution context and signalId from the active pending signal.
- * If no pending signal exists, logs a warning and returns an empty array.
- *
+ * Resolves the active pending or scheduled signal automatically from execution context.
  * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Memory bucket name
- * @returns Promise resolving to all stored entries, or empty array if no signal
- *
- * @deprecated Better use Memory.listMemory with manual signalId argument
+ * @returns Promise resolving to all stored entries
+ * @throws Error if no pending or scheduled signal exists
  *
  * @example
  * ```typescript
@@ -47919,29 +49177,33 @@ async function listMemory(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit listMemory no pending signal for symbol=${symbol}`);
-        return [];
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await Memory.listMemory({
+            signalId: signal.id,
+            bucketName,
+            backtest: isBacktest,
+        });
     }
-    return await Memory.listMemory({
-        signalId: signal.id,
-        bucketName,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        return await Memory.listMemory({
+            signalId: signal.id,
+            bucketName,
+            backtest: isBacktest,
+        });
+    }
+    throw new Error(`listMemory requires a pending or scheduled signal for symbol=${symbol} bucketName=${bucketName}`);
 }
 /**
  * Removes a memory entry for the current signal.
  *
- * Reads symbol from execution context and signalId from the active pending signal.
- * If no pending signal exists, logs a warning and returns without removing.
- *
+ * Resolves the active pending or scheduled signal automatically from execution context.
  * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Memory bucket name
  * @param dto.memoryId - Unique memory entry identifier
  * @returns Promise that resolves when removal is complete
- *
- * @deprecated Better use Memory.removeMemory with manual signalId argument
+ * @throws Error if no pending or scheduled signal exists
  *
  * @example
  * ```typescript
@@ -47965,16 +49227,26 @@ async function removeMemory(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit removeMemory no pending signal for symbol=${symbol} memoryId=${memoryId}`);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Memory.removeMemory({
+            memoryId,
+            signalId: signal.id,
+            bucketName,
+            backtest: isBacktest,
+        });
         return;
     }
-    await Memory.removeMemory({
-        memoryId,
-        signalId: signal.id,
-        bucketName,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Memory.removeMemory({
+            memoryId,
+            signalId: signal.id,
+            bucketName,
+            backtest: isBacktest,
+        });
+        return;
+    }
+    throw new Error(`removeMemory requires a pending or scheduled signal for symbol=${symbol} memoryId=${memoryId}`);
 }
 
 const CREATE_KEY_FN$3 = (signalId, bucketName) => `${signalId}-${bucketName}`;
@@ -48069,11 +49341,12 @@ const RENDER_TABLE_FN = (rows) => {
  * Scoped to (signalId, bucketName) via constructor.
  */
 class DumpBothInstance {
-    constructor(signalId, bucketName) {
+    constructor(signalId, bucketName, backtest) {
         this.signalId = signalId;
         this.bucketName = bucketName;
-        this._memory = new DumpMemoryInstance(signalId, bucketName);
-        this._markdown = new DumpMarkdownInstance(signalId, bucketName);
+        this.backtest = backtest;
+        this._memory = new DumpMemoryInstance(signalId, bucketName, backtest);
+        this._markdown = new DumpMarkdownInstance(signalId, bucketName, backtest);
     }
     /** Releases resources held by both backends. */
     dispose() {
@@ -48205,9 +49478,10 @@ class DumpBothInstance {
  * Useful for downstream LLM retrieval via Memory.searchMemory.
  */
 class DumpMemoryInstance {
-    constructor(signalId, bucketName) {
+    constructor(signalId, bucketName, backtest) {
         this.signalId = signalId;
         this.bucketName = bucketName;
+        this.backtest = backtest;
     }
     /**
      * Stores the full agent message history in Memory as a `{ messages }` object.
@@ -48233,6 +49507,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { messages },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48254,6 +49529,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: record,
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48276,6 +49552,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { rows },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48297,6 +49574,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { content },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48318,6 +49596,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { content },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48340,6 +49619,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: json,
             description,
+            backtest: this.backtest,
         });
     }
     /** Releases resources held by this instance. */
@@ -48361,9 +49641,10 @@ class DumpMemoryInstance {
  * If the file already exists, the call is skipped (idempotent).
  */
 class DumpMarkdownInstance {
-    constructor(signalId, bucketName) {
+    constructor(signalId, bucketName, backtest) {
         this.signalId = signalId;
         this.bucketName = bucketName;
+        this.backtest = backtest;
     }
     getFilePath(dumpId) {
         return path.join("./dump/agent", this.signalId, this.bucketName, `${dumpId}.md`);
@@ -48552,9 +49833,10 @@ class DumpMarkdownInstance {
  * Used for disabling dumps in tests or dry-run scenarios.
  */
 class DumpDummyInstance {
-    constructor(signalId, bucketName) {
+    constructor(signalId, bucketName, backtest) {
         this.signalId = signalId;
         this.bucketName = bucketName;
+        this.backtest = backtest;
     }
     /** No-op. */
     async dumpAgentAnswer() {
@@ -48597,7 +49879,7 @@ class DumpDummyInstance {
 class DumpAdapter {
     constructor() {
         this.DumpFactory = DumpMarkdownInstance;
-        this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$3(signalId, bucketName), (signalId, bucketName) => Reflect.construct(this.DumpFactory, [signalId, bucketName]));
+        this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$3(signalId, bucketName), (signalId, bucketName, backtest) => Reflect.construct(this.DumpFactory, [signalId, bucketName, backtest]));
         /**
          * Activates the adapter by subscribing to signal lifecycle events.
          * Clears memoized instances for a signalId when it is cancelled or closed,
@@ -48648,7 +49930,7 @@ class DumpAdapter {
                 bucketName: context.bucketName,
                 dumpId: context.dumpId,
             });
-            const instance = this.getInstance(context.signalId, context.bucketName);
+            const instance = this.getInstance(context.signalId, context.bucketName, context.backtest);
             return await instance.dumpAgentAnswer(messages, context.dumpId, context.description);
         };
         /**
@@ -48663,7 +49945,7 @@ class DumpAdapter {
                 bucketName: context.bucketName,
                 dumpId: context.dumpId,
             });
-            const instance = this.getInstance(context.signalId, context.bucketName);
+            const instance = this.getInstance(context.signalId, context.bucketName, context.backtest);
             return await instance.dumpRecord(record, context.dumpId, context.description);
         };
         /**
@@ -48678,7 +49960,7 @@ class DumpAdapter {
                 bucketName: context.bucketName,
                 dumpId: context.dumpId,
             });
-            const instance = this.getInstance(context.signalId, context.bucketName);
+            const instance = this.getInstance(context.signalId, context.bucketName, context.backtest);
             return await instance.dumpTable(rows, context.dumpId, context.description);
         };
         /**
@@ -48693,7 +49975,7 @@ class DumpAdapter {
                 bucketName: context.bucketName,
                 dumpId: context.dumpId,
             });
-            const instance = this.getInstance(context.signalId, context.bucketName);
+            const instance = this.getInstance(context.signalId, context.bucketName, context.backtest);
             return await instance.dumpText(content, context.dumpId, context.description);
         };
         /**
@@ -48708,7 +49990,7 @@ class DumpAdapter {
                 bucketName: context.bucketName,
                 dumpId: context.dumpId,
             });
-            const instance = this.getInstance(context.signalId, context.bucketName);
+            const instance = this.getInstance(context.signalId, context.bucketName, context.backtest);
             return await instance.dumpError(content, context.dumpId, context.description);
         };
         /**
@@ -48724,7 +50006,7 @@ class DumpAdapter {
                 bucketName: context.bucketName,
                 dumpId: context.dumpId,
             });
-            const instance = this.getInstance(context.signalId, context.bucketName);
+            const instance = this.getInstance(context.signalId, context.bucketName, context.backtest);
             return await instance.dumpJson(json, context.dumpId, context.description);
         };
         /**
@@ -48790,16 +50072,15 @@ const DUMP_JSON_METHOD_NAME = "dump.dumpJson";
 /**
  * Dumps the full agent message history scoped to the current signal.
  *
- * Reads signalId from the active pending signal via execution and method context.
- * If no pending signal exists, logs a warning and returns without writing.
+ * Resolves the active pending or scheduled signal automatically from execution context.
+ * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Bucket name grouping dumps by strategy or agent name
  * @param dto.dumpId - Unique identifier for this agent invocation
  * @param dto.messages - Full chat history (system, user, assistant, tool)
  * @param dto.description - Human-readable label describing the agent invocation context; included in the BM25 index for Memory search
  * @returns Promise that resolves when the dump is complete
- *
- * @deprecated Better use Dump.dumpAgentAnswer with manual signalId argument
+ * @throws Error if no pending or scheduled signal exists
  *
  * @example
  * ```typescript
@@ -48824,31 +50105,41 @@ async function dumpAgentAnswer(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit dumpAgentAnswer no pending signal for symbol=${symbol} dumpId=${dumpId}`);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpAgentAnswer(messages, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
         return;
     }
-    await Dump.dumpAgentAnswer(messages, {
-        dumpId,
-        bucketName,
-        signalId: signal.id,
-        description,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpAgentAnswer(messages, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
+        return;
+    }
+    throw new Error(`dumpAgentAnswer requires a pending or scheduled signal for symbol=${symbol} dumpId=${dumpId}`);
 }
 /**
  * Dumps a flat key-value record scoped to the current signal.
  *
- * Reads signalId from the active pending signal via execution and method context.
- * If no pending signal exists, logs a warning and returns without writing.
+ * Resolves the active pending or scheduled signal automatically from execution context.
+ * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Bucket name grouping dumps by strategy or agent name
  * @param dto.dumpId - Unique identifier for this dump entry
  * @param dto.record - Arbitrary flat object to persist
  * @param dto.description - Human-readable label describing the record contents; included in the BM25 index for Memory search
  * @returns Promise that resolves when the dump is complete
- *
- * @deprecated Better use Dump.dumpRecord with manual signalId argument
+ * @throws Error if no pending or scheduled signal exists
  *
  * @example
  * ```typescript
@@ -48872,23 +50163,34 @@ async function dumpRecord(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit dumpRecord no pending signal for symbol=${symbol} dumpId=${dumpId}`);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpRecord(record, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
         return;
     }
-    await Dump.dumpRecord(record, {
-        dumpId,
-        bucketName,
-        signalId: signal.id,
-        description,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpRecord(record, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
+        return;
+    }
+    throw new Error(`dumpRecord requires a pending or scheduled signal for symbol=${symbol} dumpId=${dumpId}`);
 }
 /**
  * Dumps an array of objects as a table scoped to the current signal.
  *
- * Reads signalId from the active pending signal via execution and method context.
- * If no pending signal exists, logs a warning and returns without writing.
+ * Resolves the active pending or scheduled signal automatically from execution context.
+ * Automatically detects backtest/live mode from execution context.
  *
  * Column headers are derived from the union of all keys across all rows.
  *
@@ -48897,8 +50199,7 @@ async function dumpRecord(dto) {
  * @param dto.rows - Array of arbitrary objects to render as a table
  * @param dto.description - Human-readable label describing the table contents; included in the BM25 index for Memory search
  * @returns Promise that resolves when the dump is complete
- *
- * @deprecated Better use Dump.dumpTable with manual signalId argument
+ * @throws Error if no pending or scheduled signal exists
  *
  * @example
  * ```typescript
@@ -48923,31 +50224,41 @@ async function dumpTable(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit dumpTable no pending signal for symbol=${symbol} dumpId=${dumpId}`);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpTable(rows, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
         return;
     }
-    await Dump.dumpTable(rows, {
-        dumpId,
-        bucketName,
-        signalId: signal.id,
-        description,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpTable(rows, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
+        return;
+    }
+    throw new Error(`dumpTable requires a pending or scheduled signal for symbol=${symbol} dumpId=${dumpId}`);
 }
 /**
  * Dumps raw text content scoped to the current signal.
  *
- * Reads signalId from the active pending signal via execution and method context.
- * If no pending signal exists, logs a warning and returns without writing.
+ * Resolves the active pending or scheduled signal automatically from execution context.
+ * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Bucket name grouping dumps by strategy or agent name
  * @param dto.dumpId - Unique identifier for this dump entry
  * @param dto.content - Arbitrary text content to persist
  * @param dto.description - Human-readable label describing the content; included in the BM25 index for Memory search
  * @returns Promise that resolves when the dump is complete
- *
- * @deprecated Better use Dump.dumpText with manual signalId argument
+ * @throws Error if no pending or scheduled signal exists
  *
  * @example
  * ```typescript
@@ -48971,31 +50282,41 @@ async function dumpText(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit dumpText no pending signal for symbol=${symbol} dumpId=${dumpId}`);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpText(content, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
         return;
     }
-    await Dump.dumpText(content, {
-        dumpId,
-        bucketName,
-        signalId: signal.id,
-        description,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpText(content, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
+        return;
+    }
+    throw new Error(`dumpText requires a pending or scheduled signal for symbol=${symbol} dumpId=${dumpId}`);
 }
 /**
  * Dumps an error description scoped to the current signal.
  *
- * Reads signalId from the active pending signal via execution and method context.
- * If no pending signal exists, logs a warning and returns without writing.
+ * Resolves the active pending or scheduled signal automatically from execution context.
+ * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Bucket name grouping dumps by strategy or agent name
  * @param dto.dumpId - Unique identifier for this dump entry
  * @param dto.content - Error message or description to persist
  * @param dto.description - Human-readable label describing the error context; included in the BM25 index for Memory search
  * @returns Promise that resolves when the dump is complete
- *
- * @deprecated Better use Dump.dumpError with manual signalId argument
+ * @throws Error if no pending or scheduled signal exists
  *
  * @example
  * ```typescript
@@ -49019,29 +50340,41 @@ async function dumpError(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit dumpError no pending signal for symbol=${symbol} dumpId=${dumpId}`);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpError(content, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
         return;
     }
-    await Dump.dumpError(content, {
-        dumpId,
-        bucketName,
-        signalId: signal.id,
-        description,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpError(content, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
+        return;
+    }
+    throw new Error(`dumpError requires a pending or scheduled signal for symbol=${symbol} dumpId=${dumpId}`);
 }
 /**
  * Dumps an arbitrary nested object as a fenced JSON block scoped to the current signal.
  *
- * Reads signalId from the active pending signal via execution and method context.
- * If no pending signal exists, logs a warning and returns without writing.
+ * Resolves the active pending or scheduled signal automatically from execution context.
+ * Automatically detects backtest/live mode from execution context.
  *
  * @param dto.bucketName - Bucket name grouping dumps by strategy or agent name
  * @param dto.dumpId - Unique identifier for this dump entry
  * @param dto.json - Arbitrary nested object to serialize with JSON.stringify
  * @param dto.description - Human-readable label describing the object contents; included in the BM25 index for Memory search
  * @returns Promise that resolves when the dump is complete
+ * @throws Error if no pending or scheduled signal exists
  *
  * @deprecated Prefer dumpRecord — flat key-value structure maps naturally to markdown tables and SQL storage
  *
@@ -49067,17 +50400,28 @@ async function dumpJson(dto) {
     const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
-    const signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
-    if (!signal) {
-        console.warn(`backtest-kit dumpJson no pending signal for symbol=${symbol} dumpId=${dumpId}`);
+    let signal;
+    if (signal = await backtest.strategyCoreService.getPendingSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpJson(json, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
         return;
     }
-    await Dump.dumpJson(json, {
-        dumpId,
-        bucketName,
-        signalId: signal.id,
-        description,
-    });
+    if (signal = await backtest.strategyCoreService.getScheduledSignal(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName })) {
+        await Dump.dumpJson(json, {
+            dumpId,
+            bucketName,
+            signalId: signal.id,
+            description,
+            backtest: isBacktest,
+        });
+        return;
+    }
+    throw new Error(`dumpJson requires a pending or scheduled signal for symbol=${symbol} dumpId=${dumpId}`);
 }
 
 /**
@@ -59565,6 +60909,10 @@ exports.MarkdownFolderBase = MarkdownFolderBase;
 exports.MarkdownWriter = MarkdownWriter;
 exports.MaxDrawdown = MaxDrawdown;
 exports.Memory = Memory;
+exports.MemoryBacktest = MemoryBacktest;
+exports.MemoryBacktestAdapter = MemoryBacktestAdapter;
+exports.MemoryLive = MemoryLive;
+exports.MemoryLiveAdapter = MemoryLiveAdapter;
 exports.MethodContextService = MethodContextService;
 exports.Notification = Notification;
 exports.NotificationBacktest = NotificationBacktest;
@@ -59584,6 +60932,7 @@ exports.PersistRecentAdapter = PersistRecentAdapter;
 exports.PersistRiskAdapter = PersistRiskAdapter;
 exports.PersistScheduleAdapter = PersistScheduleAdapter;
 exports.PersistSignalAdapter = PersistSignalAdapter;
+exports.PersistStateAdapter = PersistStateAdapter;
 exports.PersistStorageAdapter = PersistStorageAdapter;
 exports.Position = Position;
 exports.PositionSize = PositionSize;
@@ -59597,6 +60946,11 @@ exports.ReportWriter = ReportWriter;
 exports.Risk = Risk;
 exports.Schedule = Schedule;
 exports.Session = Session;
+exports.State = State;
+exports.StateBacktest = StateBacktest;
+exports.StateBacktestAdapter = StateBacktestAdapter;
+exports.StateLive = StateLive;
+exports.StateLiveAdapter = StateLiveAdapter;
 exports.Storage = Storage;
 exports.StorageBacktest = StorageBacktest;
 exports.StorageLive = StorageLive;
@@ -59626,6 +60980,7 @@ exports.commitTrailingStop = commitTrailingStop;
 exports.commitTrailingStopCost = commitTrailingStopCost;
 exports.commitTrailingTake = commitTrailingTake;
 exports.commitTrailingTakeCost = commitTrailingTakeCost;
+exports.createSignalState = createSignalState;
 exports.dumpAgentAnswer = dumpAgentAnswer;
 exports.dumpError = dumpError;
 exports.dumpJson = dumpJson;
@@ -59692,6 +61047,7 @@ exports.getPositionWaitingMinutes = getPositionWaitingMinutes;
 exports.getRawCandles = getRawCandles;
 exports.getRiskSchema = getRiskSchema;
 exports.getScheduledSignal = getScheduledSignal;
+exports.getSignalState = getSignalState;
 exports.getSizingSchema = getSizingSchema;
 exports.getStrategySchema = getStrategySchema;
 exports.getSymbol = getSymbol;
@@ -59777,6 +61133,7 @@ exports.set = set;
 exports.setColumns = setColumns;
 exports.setConfig = setConfig;
 exports.setLogger = setLogger;
+exports.setSignalState = setSignalState;
 exports.shutdown = shutdown;
 exports.slPercentShiftToPrice = slPercentShiftToPrice;
 exports.slPriceToPercentShift = slPriceToPercentShift;