backtest-kit 7.4.0 → 7.6.0

package/build/index.cjs

@@ -1017,6 +1017,22 @@ 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_STATE_UTILS_METHOD_NAME_USE_JSON = "PersistStateUtils.useJson";
+const PERSIST_SESSION_UTILS_METHOD_NAME_USE_PERSIST_SESSION_ADAPTER = "PersistSessionUtils.usePersistSessionAdapter";
+const PERSIST_SESSION_UTILS_METHOD_NAME_READ_DATA = "PersistSessionUtils.readSessionData";
+const PERSIST_SESSION_UTILS_METHOD_NAME_WRITE_DATA = "PersistSessionUtils.writeSessionData";
+const PERSIST_SESSION_UTILS_METHOD_NAME_CLEAR = "PersistSessionUtils.clear";
+const PERSIST_SESSION_UTILS_METHOD_NAME_DISPOSE = "PersistSessionUtils.dispose";
+const PERSIST_SESSION_UTILS_METHOD_NAME_WAIT_FOR_INIT = "PersistSessionUtils.waitForInit";
+const PERSIST_SESSION_UTILS_METHOD_NAME_USE_DUMMY = "PersistSessionUtils.useDummy";
+const PERSIST_SESSION_UTILS_METHOD_NAME_USE_JSON = "PersistSessionUtils.useJson";
 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 +2994,271 @@ 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);
+        };
+        /**
+         * Switches to the default JSON persist adapter.
+         * All future persistence writes will use JSON storage.
+         */
+        this.useJson = () => {
+            LOGGER_SERVICE$7.log(PERSIST_STATE_UTILS_METHOD_NAME_USE_JSON);
+            this.usePersistStateAdapter(PersistBase);
+        };
+        /**
+         * 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();
+/**
+ * Utility class for managing session persistence.
+ *
+ * Features:
+ * - Memoized storage instances per (strategyName, exchangeName, frameName) key
+ * - Custom adapter support
+ * - Atomic read/write operations
+ *
+ * Storage layout: ./dump/session/<strategyName>/<exchangeName>/<frameName>.json
+ *
+ * Used by SessionPersistInstance for crash-safe session persistence.
+ */
+class PersistSessionUtils {
+    constructor() {
+        this.PersistSessionFactory = PersistBase;
+        this.getSessionStorage = functoolsKit.memoize(([strategyName, exchangeName, frameName]) => `${strategyName}:${exchangeName}:${frameName}`, (strategyName, exchangeName, frameName) => Reflect.construct(this.PersistSessionFactory, [
+            frameName,
+            `./dump/session/${strategyName}/${exchangeName}/`,
+        ]));
+        /**
+         * Initializes the storage for a given (strategyName, exchangeName, frameName) triple.
+         *
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @param initial - Whether this is the first initialization
+         */
+        this.waitForInit = async (strategyName, exchangeName, frameName, initial) => {
+            LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_WAIT_FOR_INIT, {
+                strategyName,
+                exchangeName,
+                frameName,
+                initial,
+            });
+            const key = `${strategyName}:${exchangeName}:${frameName}`;
+            const isInitial = initial && !this.getSessionStorage.has(key);
+            const sessionStorage = this.getSessionStorage(strategyName, exchangeName, frameName);
+            await sessionStorage.waitForInit(isInitial);
+        };
+        /**
+         * Reads a session entry from persistence storage.
+         *
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @returns Promise resolving to entry data or null if not found
+         */
+        this.readSessionData = async (strategyName, exchangeName, frameName) => {
+            LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_READ_DATA, {
+                strategyName,
+                exchangeName,
+                frameName,
+            });
+            const key = `${strategyName}:${exchangeName}:${frameName}`;
+            const isInitial = !this.getSessionStorage.has(key);
+            const sessionStorage = this.getSessionStorage(strategyName, exchangeName, frameName);
+            await sessionStorage.waitForInit(isInitial);
+            if (await sessionStorage.hasValue(frameName)) {
+                return await sessionStorage.readValue(frameName);
+            }
+            return null;
+        };
+        /**
+         * Writes a session entry to disk with atomic file writes.
+         *
+         * @param data - Entry data to persist
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         */
+        this.writeSessionData = async (data, strategyName, exchangeName, frameName) => {
+            LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_WRITE_DATA, {
+                strategyName,
+                exchangeName,
+                frameName,
+            });
+            const key = `${strategyName}:${exchangeName}:${frameName}`;
+            const isInitial = !this.getSessionStorage.has(key);
+            const sessionStorage = this.getSessionStorage(strategyName, exchangeName, frameName);
+            await sessionStorage.waitForInit(isInitial);
+            await sessionStorage.writeValue(frameName, 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_SESSION_UTILS_METHOD_NAME_USE_DUMMY);
+            this.usePersistSessionAdapter(PersistDummy);
+        };
+        /**
+         * Switches to the default JSON persist adapter.
+         * All future persistence writes will use JSON storage.
+         */
+        this.useJson = () => {
+            LOGGER_SERVICE$7.log(PERSIST_SESSION_UTILS_METHOD_NAME_USE_JSON);
+            this.usePersistSessionAdapter(PersistBase);
+        };
+        /**
+         * 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_SESSION_UTILS_METHOD_NAME_CLEAR);
+            this.getSessionStorage.clear();
+        };
+        /**
+         * Disposes of the session adapter and releases any resources.
+         * Call this when a session is removed to clean up its associated storage.
+         *
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         */
+        this.dispose = (strategyName, exchangeName, frameName) => {
+            LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_DISPOSE);
+            const key = `${strategyName}:${exchangeName}:${frameName}`;
+            this.getSessionStorage.clear(key);
+        };
+    }
+    /**
+     * Registers a custom persistence adapter.
+     *
+     * @param Ctor - Custom PersistBase constructor
+     */
+    usePersistSessionAdapter(Ctor) {
+        LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_USE_PERSIST_SESSION_ADAPTER);
+        this.PersistSessionFactory = Ctor;
+    }
+}
+/**
+ * Global singleton instance of PersistSessionUtils.
+ * Used by SessionPersistInstance for crash-safe session persistence.
+ */
+const PersistSessionAdapter = new PersistSessionUtils();
 
 var _a$2, _b$2;
 const BUSY_DELAY = 100;
@@ -10443,7 +10724,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$x = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -10743,7 +11024,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$x(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 +11986,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$x(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             if (!this.getStrategy.has(key)) {
                 return;
             }
@@ -12879,7 +13160,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$w = (riskName, exchangeName, frameName, backtest) => {
     const parts = [riskName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -12979,7 +13260,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$w(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
             const schema = this.riskSchemaService.get(riskName);
             return new ClientRisk({
                 ...schema,
@@ -13048,7 +13329,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$w(payload.riskName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getRisk.clear(key);
             }
             else {
@@ -14167,7 +14448,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$v = (actionName, strategyName, exchangeName, frameName, backtest) => {
     const parts = [actionName, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -14219,7 +14500,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$v(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
             const schema = this.actionSchemaService.get(actionName);
             return new ClientAction({
                 ...schema,
@@ -14445,7 +14726,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$v(payload.actionName, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             if (!this.getAction.has(key)) {
                 return;
             }
@@ -14463,7 +14744,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$u = (exchangeName) => {
     return exchangeName;
 };
 /**
@@ -14487,7 +14768,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$u(exchangeName), async (exchangeName) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$3, {
                 exchangeName,
             });
@@ -14739,7 +15020,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$t = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -14771,7 +15052,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$t(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$2, {
                 context,
             });
@@ -16141,7 +16422,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$s = (context) => {
     const parts = [context.riskName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -16167,7 +16448,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$s(context), async (context) => {
             this.loggerService.log("riskGlobalService validate", {
                 context,
             });
@@ -16245,7 +16526,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$r = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -16289,7 +16570,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$r(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$1, {
                 context,
             });
@@ -21359,7 +21640,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$q = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -21605,7 +21886,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$q(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 +22043,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$q(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -21824,7 +22105,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$p = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -22319,7 +22600,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$p(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 +22818,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$p(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -22557,7 +22838,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$o = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -22846,7 +23127,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$o(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 +23330,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$o(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -23069,7 +23350,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$n = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -23314,7 +23595,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$n(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 +23762,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$n(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -23960,7 +24241,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$m = (exchangeName, frameName, backtest) => {
     const parts = [exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -24407,7 +24688,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$m(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 +24906,7 @@ class HeatMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$k(payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$m(payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -25656,7 +25937,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$l = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Creates a callback function for emitting profit events to partialProfitSubject.
  *
@@ -25778,7 +26059,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$l(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -25868,7 +26149,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$l(data.id, backtest);
             this.getPartial.clear(key);
         };
     }
@@ -25884,7 +26165,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$k = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -26107,7 +26388,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$k(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 +26598,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$k(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -26333,7 +26614,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$j = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -26407,7 +26688,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$j(context), (context, methodName) => {
             this.loggerService.log("partialGlobalService validate", {
                 context,
                 methodName,
@@ -26862,7 +27143,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$i = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Creates a callback function for emitting breakeven events to breakevenSubject.
  *
@@ -26948,7 +27229,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$i(signalId, backtest), (signalId, backtest) => {
             return new ClientBreakeven({
                 signalId,
                 logger: this.loggerService,
@@ -27009,7 +27290,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$i(data.id, backtest);
             this.getBreakeven.clear(key);
         };
     }
@@ -27025,7 +27306,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$h = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -27200,7 +27481,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$h(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 +27670,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$h(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -27405,7 +27686,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$g = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -27479,7 +27760,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$g(context), (context, methodName) => {
             this.loggerService.log("breakevenGlobalService validate", {
                 context,
                 methodName,
@@ -27700,7 +27981,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$f = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -27867,7 +28148,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$f(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 +28337,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$f(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -30636,7 +30917,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$e = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -30878,7 +31159,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$e(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 +31733,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$e(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -31560,7 +31841,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$d = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -31753,7 +32034,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$d(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 +32232,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$d(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -31964,7 +32245,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$c = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -32142,7 +32423,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$c(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 +32589,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$c(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -32330,7 +32611,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$b = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -32373,7 +32654,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$b(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
         /**
          * Returns the current market price for the given symbol and context.
          *
@@ -32402,10 +32683,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$b(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$b(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
             }
             return currentPrice;
         };
@@ -32447,7 +32728,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$b(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             this.getSource.clear(key);
         };
     }
@@ -32465,7 +32746,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$a = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -32508,7 +32789,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$a(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
         /**
          * Returns the current candle timestamp (in milliseconds) for the given symbol and context.
          *
@@ -32536,10 +32817,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$a(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$a(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
             }
             return timestamp;
         };
@@ -32581,7 +32862,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$a(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             this.getSource.clear(key);
         };
     }
@@ -32687,7 +32968,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$9 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -32813,7 +33094,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$9(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 +33173,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$9(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -32910,7 +33191,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$8 = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -32943,7 +33224,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$8(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE, {
                 context,
             });
@@ -46487,7 +46768,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$7 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -46577,7 +46858,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$7(event.symbol, event.strategyName, event.exchangeName, event.data.frameName, event.backtest);
             this._signals.set(key, event.data);
         };
         /**
@@ -46590,7 +46871,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$7(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 +46977,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$7(event.symbol, event.strategyName, event.exchangeName, event.data.frameName, event.backtest);
             this._signals.set(key, event.data);
         };
         /**
@@ -46709,7 +46990,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$7(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 +47341,554 @@ const RecentLive = new RecentLiveAdapter();
  */
 const RecentBacktest = new RecentBacktestAdapter();
 
+const CREATE_KEY_FN$6 = (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$6(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$6(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$6(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$6(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$6(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$6(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$6(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$6(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$6(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 +47964,777 @@ 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_KEY_FN$5 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+    const parts = [symbol, strategyName, exchangeName];
+    if (frameName)
+        parts.push(frameName);
+    parts.push(backtest ? "backtest" : "live");
+    return parts.join(":");
+};
+const SESSION_LOCAL_INSTANCE_METHOD_NAME_GET = "SessionLocalInstance.getData";
+const SESSION_LOCAL_INSTANCE_METHOD_NAME_SET = "SessionLocalInstance.setData";
+const SESSION_PERSIST_INSTANCE_METHOD_NAME_WAIT_FOR_INIT = "SessionPersistInstance.waitForInit";
+const SESSION_PERSIST_INSTANCE_METHOD_NAME_GET = "SessionPersistInstance.getData";
+const SESSION_PERSIST_INSTANCE_METHOD_NAME_SET = "SessionPersistInstance.setData";
+const SESSION_BACKTEST_ADAPTER_METHOD_NAME_DISPOSE = "SessionBacktestAdapter.dispose";
+const SESSION_BACKTEST_ADAPTER_METHOD_NAME_GET = "SessionBacktestAdapter.getData";
+const SESSION_BACKTEST_ADAPTER_METHOD_NAME_SET = "SessionBacktestAdapter.setData";
+const SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_LOCAL = "SessionBacktestAdapter.useLocal";
+const SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST = "SessionBacktestAdapter.usePersist";
+const SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY = "SessionBacktestAdapter.useDummy";
+const SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_SESSION_ADAPTER = "SessionBacktestAdapter.useSessionAdapter";
+const SESSION_BACKTEST_ADAPTER_METHOD_NAME_CLEAR = "SessionBacktestAdapter.clear";
+const SESSION_LIVE_ADAPTER_METHOD_NAME_DISPOSE = "SessionLiveAdapter.dispose";
+const SESSION_LIVE_ADAPTER_METHOD_NAME_GET = "SessionLiveAdapter.getData";
+const SESSION_LIVE_ADAPTER_METHOD_NAME_SET = "SessionLiveAdapter.setData";
+const SESSION_LIVE_ADAPTER_METHOD_NAME_USE_LOCAL = "SessionLiveAdapter.useLocal";
+const SESSION_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST = "SessionLiveAdapter.usePersist";
+const SESSION_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY = "SessionLiveAdapter.useDummy";
+const SESSION_LIVE_ADAPTER_METHOD_NAME_USE_SESSION_ADAPTER = "SessionLiveAdapter.useSessionAdapter";
+const SESSION_LIVE_ADAPTER_METHOD_NAME_CLEAR = "SessionLiveAdapter.clear";
+const SESSION_ADAPTER_METHOD_NAME_GET = "SessionAdapter.getData";
+const SESSION_ADAPTER_METHOD_NAME_SET = "SessionAdapter.setData";
+/**
+ * In-process session instance backed by a plain object reference.
+ * All data lives in process memory only — no disk persistence.
+ *
+ * Features:
+ * - Mutable in-memory session data
+ * - Scoped per (symbol, strategyName, exchangeName, frameName) tuple
+ *
+ * Use for backtesting and unit tests where persistence between runs is not needed.
+ */
+class SessionLocalInstance {
+    constructor(symbol, strategyName, exchangeName, frameName, backtest$1) {
+        this.symbol = symbol;
+        this.strategyName = strategyName;
+        this.exchangeName = exchangeName;
+        this.frameName = frameName;
+        this.backtest = backtest$1;
+        this._data = null;
+        /**
+         * Initializes _data to null — local session needs no async setup.
+         * @returns Promise that resolves immediately
+         */
+        this.waitForInit = functoolsKit.singleshot(async (_initial) => {
+            this._data = null;
+        });
+        /**
+         * Read the current in-memory session value.
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async () => {
+            backtest.loggerService.debug(SESSION_LOCAL_INSTANCE_METHOD_NAME_GET, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+            });
+            return this._data;
+        };
+        /**
+         * Update the in-memory session value.
+         * @param value - New value or null to clear
+         */
+        this.setData = async (value) => {
+            backtest.loggerService.debug(SESSION_LOCAL_INSTANCE_METHOD_NAME_SET, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+            });
+            this._data = value;
+        };
+    }
+    /** Releases resources held by this instance. */
+    async dispose() {
+        backtest.loggerService.debug(SESSION_BACKTEST_ADAPTER_METHOD_NAME_DISPOSE, {
+            strategyName: this.strategyName,
+            exchangeName: this.exchangeName,
+            frameName: this.frameName,
+        });
+    }
+}
+/**
+ * No-op session instance that discards all writes.
+ * Used for disabling session storage in tests or dry-run scenarios.
+ *
+ * Useful when replaying historical candles without needing to accumulate
+ * cross-candle session state — getData always returns null.
+ */
+class SessionDummyInstance {
+    constructor(symbol, strategyName, exchangeName, frameName, backtest) {
+        this.symbol = symbol;
+        this.strategyName = strategyName;
+        this.exchangeName = exchangeName;
+        this.frameName = frameName;
+        this.backtest = backtest;
+        /**
+         * No-op initialization.
+         * @returns Promise that resolves immediately
+         */
+        this.waitForInit = functoolsKit.singleshot(async (_initial) => {
+        });
+        /**
+         * No-op read — always returns null.
+         * @returns null
+         */
+        this.getData = async () => {
+            return null;
+        };
+        /**
+         * No-op write — discards the value.
+         */
+        this.setData = async (_value) => {
+        };
+    }
+    /** No-op. */
+    async dispose() {
+    }
+}
+/**
+ * File-system backed session instance.
+ * Data is persisted atomically to disk via PersistSessionAdapter.
+ * Session is restored from disk on waitForInit.
+ *
+ * Features:
+ * - Crash-safe atomic file writes
+ * - Scoped per (symbol, strategyName, exchangeName, frameName) tuple
+ *
+ * Use in live trading to survive process restarts mid-session.
+ */
+class SessionPersistInstance {
+    constructor(symbol, strategyName, exchangeName, frameName, backtest$1) {
+        this.symbol = symbol;
+        this.strategyName = strategyName;
+        this.exchangeName = exchangeName;
+        this.frameName = frameName;
+        this.backtest = backtest$1;
+        this._data = null;
+        /**
+         * Initialize persistence storage and restore session from disk.
+         * @param initial - Whether this is the first initialization
+         */
+        this.waitForInit = functoolsKit.singleshot(async (initial) => {
+            backtest.loggerService.debug(SESSION_PERSIST_INSTANCE_METHOD_NAME_WAIT_FOR_INIT, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+                initial,
+            });
+            await PersistSessionAdapter.waitForInit(this.strategyName, this.exchangeName, this.frameName, initial);
+            const data = await PersistSessionAdapter.readSessionData(this.strategyName, this.exchangeName, this.frameName);
+            if (data) {
+                this._data = data.data;
+                return;
+            }
+            this._data = null;
+        });
+        /**
+         * Read the current persisted session value.
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async () => {
+            backtest.loggerService.debug(SESSION_PERSIST_INSTANCE_METHOD_NAME_GET, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+            });
+            return this._data;
+        };
+        /**
+         * Update session value and persist to disk atomically.
+         * @param value - New value or null to clear
+         */
+        this.setData = async (value) => {
+            backtest.loggerService.debug(SESSION_PERSIST_INSTANCE_METHOD_NAME_SET, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+            });
+            this._data = value;
+            const id = CREATE_KEY_FN$5(this.symbol, this.strategyName, this.exchangeName, this.frameName, this.backtest);
+            await PersistSessionAdapter.writeSessionData({ id, data: value }, this.strategyName, this.exchangeName, this.frameName);
+        };
+    }
+    /** Releases resources held by this instance. */
+    async dispose() {
+        backtest.loggerService.debug(SESSION_LIVE_ADAPTER_METHOD_NAME_DISPOSE, {
+            strategyName: this.strategyName,
+            exchangeName: this.exchangeName,
+            frameName: this.frameName,
+        });
+        await PersistSessionAdapter.dispose(this.strategyName, this.exchangeName, this.frameName);
+    }
+}
+/**
+ * Backtest session adapter with pluggable storage backend.
+ *
+ * Features:
+ * - Adapter pattern for swappable session instance implementations
+ * - Default backend: SessionLocalInstance (in-memory, no disk persistence)
+ * - Alternative backends: SessionPersistInstance, SessionDummyInstance
+ * - Convenience methods: useLocal(), usePersist(), useDummy(), useSessionAdapter()
+ * - Memoized instances per (symbol, strategyName, exchangeName, frameName) tuple
+ */
+class SessionBacktestAdapter {
+    constructor() {
+        this.SessionFactory = SessionLocalInstance;
+        this.getInstance = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$5(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => Reflect.construct(this.SessionFactory, [symbol, strategyName, exchangeName, frameName, backtest]));
+        /**
+         * Read the current session value for a backtest run.
+         * @param symbol - Trading pair symbol
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async (symbol, context) => {
+            backtest.loggerService.debug(SESSION_BACKTEST_ADAPTER_METHOD_NAME_GET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+            });
+            const key = CREATE_KEY_FN$5(symbol, context.strategyName, context.exchangeName, context.frameName, true);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(symbol, context.strategyName, context.exchangeName, context.frameName, true);
+            await instance.waitForInit(isInitial);
+            return await instance.getData();
+        };
+        /**
+         * Update the session value for a backtest run.
+         * @param symbol - Trading pair symbol
+         * @param value - New value or null to clear
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         */
+        this.setData = async (symbol, value, context) => {
+            backtest.loggerService.debug(SESSION_BACKTEST_ADAPTER_METHOD_NAME_SET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+            });
+            const key = CREATE_KEY_FN$5(symbol, context.strategyName, context.exchangeName, context.frameName, true);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(symbol, context.strategyName, context.exchangeName, context.frameName, true);
+            await instance.waitForInit(isInitial);
+            return await instance.setData(value);
+        };
+        /**
+         * Switches to in-memory adapter (default).
+         * All data lives in process memory only.
+         */
+        this.useLocal = () => {
+            backtest.loggerService.info(SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_LOCAL);
+            this.SessionFactory = SessionLocalInstance;
+        };
+        /**
+         * Switches to file-system backed adapter.
+         * Data is persisted to disk via PersistSessionAdapter.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this.SessionFactory = SessionPersistInstance;
+        };
+        /**
+         * Switches to dummy adapter that discards all writes.
+         */
+        this.useDummy = () => {
+            backtest.loggerService.info(SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY);
+            this.SessionFactory = SessionDummyInstance;
+        };
+        /**
+         * Switches to a custom session adapter implementation.
+         * @param Ctor - Constructor for the custom session instance
+         */
+        this.useSessionAdapter = (Ctor) => {
+            backtest.loggerService.info(SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_SESSION_ADAPTER);
+            this.SessionFactory = 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(SESSION_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
+    }
+}
+/**
+ * Live trading session adapter with pluggable storage backend.
+ *
+ * Features:
+ * - Adapter pattern for swappable session instance implementations
+ * - Default backend: SessionPersistInstance (file-system backed, survives restarts)
+ * - Alternative backends: SessionLocalInstance, SessionDummyInstance
+ * - Convenience methods: useLocal(), usePersist(), useDummy(), useSessionAdapter()
+ * - Memoized instances per (symbol, strategyName, exchangeName, frameName) tuple
+ */
+class SessionLiveAdapter {
+    constructor() {
+        this.SessionFactory = SessionPersistInstance;
+        this.getInstance = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$5(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => Reflect.construct(this.SessionFactory, [symbol, strategyName, exchangeName, frameName, backtest]));
+        /**
+         * Read the current session value for a live run.
+         * @param symbol - Trading pair symbol
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async (symbol, context) => {
+            backtest.loggerService.debug(SESSION_LIVE_ADAPTER_METHOD_NAME_GET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+            });
+            const key = CREATE_KEY_FN$5(symbol, context.strategyName, context.exchangeName, context.frameName, false);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(symbol, context.strategyName, context.exchangeName, context.frameName, false);
+            await instance.waitForInit(isInitial);
+            return await instance.getData();
+        };
+        /**
+         * Update the session value for a live run.
+         * @param symbol - Trading pair symbol
+         * @param value - New value or null to clear
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         */
+        this.setData = async (symbol, value, context) => {
+            backtest.loggerService.debug(SESSION_LIVE_ADAPTER_METHOD_NAME_SET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+            });
+            const key = CREATE_KEY_FN$5(symbol, context.strategyName, context.exchangeName, context.frameName, false);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(symbol, context.strategyName, context.exchangeName, context.frameName, false);
+            await instance.waitForInit(isInitial);
+            return await instance.setData(value);
+        };
+        /**
+         * Switches to in-memory adapter.
+         * All data lives in process memory only.
+         */
+        this.useLocal = () => {
+            backtest.loggerService.info(SESSION_LIVE_ADAPTER_METHOD_NAME_USE_LOCAL);
+            this.SessionFactory = SessionLocalInstance;
+        };
+        /**
+         * Switches to file-system backed adapter (default).
+         * Data is persisted to disk via PersistSessionAdapter.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(SESSION_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this.SessionFactory = SessionPersistInstance;
+        };
+        /**
+         * Switches to dummy adapter that discards all writes.
+         */
+        this.useDummy = () => {
+            backtest.loggerService.info(SESSION_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY);
+            this.SessionFactory = SessionDummyInstance;
+        };
+        /**
+         * Switches to a custom session adapter implementation.
+         * @param Ctor - Constructor for the custom session instance
+         */
+        this.useSessionAdapter = (Ctor) => {
+            backtest.loggerService.info(SESSION_LIVE_ADAPTER_METHOD_NAME_USE_SESSION_ADAPTER);
+            this.SessionFactory = 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(SESSION_LIVE_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
+    }
+}
+/**
+ * Main session adapter that manages both backtest and live session storage.
+ *
+ * Features:
+ * - Routes all operations to SessionBacktest or SessionLive based on the backtest flag
+ */
+class SessionAdapter {
+    constructor() {
+        /**
+         * Read the current session value for a signal.
+         * Routes to SessionBacktest or SessionLive based on backtest.
+         * @param symbol - Trading pair symbol
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async (symbol, context, backtest$1) => {
+            backtest.loggerService.debug(SESSION_ADAPTER_METHOD_NAME_GET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+                backtest: backtest$1,
+            });
+            if (backtest$1) {
+                return await SessionBacktest.getData(symbol, context);
+            }
+            return await SessionLive.getData(symbol, context);
+        };
+        /**
+         * Update the session value for a signal.
+         * Routes to SessionBacktest or SessionLive based on backtest.
+         * @param symbol - Trading pair symbol
+         * @param value - New value or null to clear
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         */
+        this.setData = async (symbol, value, context, backtest$1) => {
+            backtest.loggerService.debug(SESSION_ADAPTER_METHOD_NAME_SET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+                backtest: backtest$1,
+            });
+            if (backtest$1) {
+                return await SessionBacktest.setData(symbol, value, context);
+            }
+            return await SessionLive.setData(symbol, value, context);
+        };
+    }
+}
+/**
+ * Global singleton instance of SessionAdapter.
+ * Provides unified session management for backtest and live trading.
+ */
+const Session = new SessionAdapter();
+/**
+ * Global singleton instance of SessionLiveAdapter.
+ * Provides live trading session storage with pluggable backends.
+ */
+const SessionLive = new SessionLiveAdapter();
+/**
+ * Global singleton instance of SessionBacktestAdapter.
+ * Provides backtest session storage with pluggable backends.
+ */
+const SessionBacktest = new SessionBacktestAdapter();
+
+const GET_SESSION_METHOD_NAME = "session.getSession";
+const SET_SESSION_METHOD_NAME = "session.setSession";
+/**
+ * Reads the session value scoped to the current (symbol, strategy, exchange, frame) context.
+ *
+ * Session data persists across candles within a single run and can survive process
+ * restarts in live mode — useful for caching LLM inference results, intermediate
+ * indicator state, or any cross-candle accumulator that is not tied to a specific signal.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to current session value, or null if not set
+ *
+ * @example
+ * ```typescript
+ * import { getSession } from "backtest-kit";
+ *
+ * const session = await getSession<{ lastLlmSignal: string }>("BTCUSDT");
+ * if (session?.lastLlmSignal === "buy") {
+ *   // reuse cached LLM result instead of calling the model again
+ * }
+ * ```
+ */
+async function getSessionData(symbol) {
+    backtest.loggerService.info(GET_SESSION_METHOD_NAME, { symbol });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("getSession requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("getSession requires a method context");
+    }
+    const { backtest: isBacktest } = backtest.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    return await Session.getData(symbol, { exchangeName, frameName, strategyName }, isBacktest);
+}
+/**
+ * Writes a session value scoped to the current (symbol, strategy, exchange, frame) context.
+ *
+ * Session data persists across candles within a single run and can survive process
+ * restarts in live mode — useful for caching LLM inference results, intermediate
+ * indicator state, or any cross-candle accumulator that is not tied to a specific signal.
+ *
+ * Pass null to clear the session.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * @param symbol - Trading pair symbol
+ * @param value - New value or null to clear
+ * @returns Promise that resolves when the session has been written
+ *
+ * @example
+ * ```typescript
+ * import { setSession } from "backtest-kit";
+ *
+ * await setSession("BTCUSDT", { lastLlmSignal: "buy" });
+ * ```
+ */
+async function setSessionData(symbol, value) {
+    backtest.loggerService.info(SET_SESSION_METHOD_NAME, { symbol });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("setSession requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("setSession requires a method context");
+    }
+    const { backtest: isBacktest } = backtest.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    await Session.setData(symbol, value, { exchangeName, frameName, strategyName }, isBacktest);
+}
+
+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 +48821,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 +48842,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 +48895,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 +48966,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 +49015,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 +49089,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 +49149,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 +49530,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 +49546,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 +49570,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 +49592,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 +49615,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 +49640,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 +49673,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 +49704,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 +49762,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 +49814,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 +49864,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 +49914,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 +50028,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 +50165,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 +50194,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { messages },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48254,6 +50216,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: record,
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48276,6 +50239,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { rows },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48297,6 +50261,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { content },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48318,6 +50283,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { content },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48340,6 +50306,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: json,
             description,
+            backtest: this.backtest,
         });
     }
     /** Releases resources held by this instance. */
@@ -48361,9 +50328,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 +50520,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 +50566,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 +50617,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 +50632,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 +50647,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 +50662,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 +50677,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 +50693,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 +50759,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 +50792,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 +50850,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 +50886,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 +50911,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 +50969,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 +51027,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 +51087,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}`);
 }
 
 /**
@@ -50458,7 +52489,7 @@ class LogAdapter {
  */
 const Log = new LogAdapter();
 
-const METHOD_NAME_CREATE_SNAPSHOT = "SessionUtils.createSnapshot";
+const METHOD_NAME_CREATE_SNAPSHOT = "SystemUtils.createSnapshot";
 /** List of all global subjects whose listeners should be snapshotted for session isolation */
 const SUBJECT_ISOLATION_LIST = [
     activePingSubject,
@@ -50505,7 +52536,7 @@ const CREATE_SUBJECT_SNAPSHOT_FN = (subject) => {
  * Allows temporarily detaching all subject subscriptions so that one session
  * does not interfere with another, then restoring them afterwards.
  */
-class SessionUtils {
+class SystemUtils {
     constructor() {
         /**
          * Snapshots the current listener state of every global subject by replacing
@@ -50519,7 +52550,7 @@ class SessionUtils {
         };
     }
 }
-const Session = new SessionUtils();
+const System = new SystemUtils();
 
 const SCHEDULE_METHOD_NAME_GET_DATA = "ScheduleUtils.getData";
 const SCHEDULE_METHOD_NAME_GET_REPORT = "ScheduleUtils.getReport";
@@ -59565,6 +61596,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;
@@ -59583,7 +61618,9 @@ exports.PersistPartialAdapter = PersistPartialAdapter;
 exports.PersistRecentAdapter = PersistRecentAdapter;
 exports.PersistRiskAdapter = PersistRiskAdapter;
 exports.PersistScheduleAdapter = PersistScheduleAdapter;
+exports.PersistSessionAdapter = PersistSessionAdapter;
 exports.PersistSignalAdapter = PersistSignalAdapter;
+exports.PersistStateAdapter = PersistStateAdapter;
 exports.PersistStorageAdapter = PersistStorageAdapter;
 exports.Position = Position;
 exports.PositionSize = PositionSize;
@@ -59597,11 +61634,19 @@ exports.ReportWriter = ReportWriter;
 exports.Risk = Risk;
 exports.Schedule = Schedule;
 exports.Session = Session;
+exports.SessionBacktest = SessionBacktest;
+exports.SessionLive = SessionLive;
+exports.State = State;
+exports.StateBacktest = StateBacktest;
+exports.StateBacktestAdapter = StateBacktestAdapter;
+exports.StateLive = StateLive;
+exports.StateLiveAdapter = StateLiveAdapter;
 exports.Storage = Storage;
 exports.StorageBacktest = StorageBacktest;
 exports.StorageLive = StorageLive;
 exports.Strategy = Strategy;
 exports.Sync = Sync;
+exports.System = System;
 exports.Walker = Walker;
 exports.addActionSchema = addActionSchema;
 exports.addExchangeSchema = addExchangeSchema;
@@ -59626,6 +61671,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 +61738,8 @@ exports.getPositionWaitingMinutes = getPositionWaitingMinutes;
 exports.getRawCandles = getRawCandles;
 exports.getRiskSchema = getRiskSchema;
 exports.getScheduledSignal = getScheduledSignal;
+exports.getSessionData = getSessionData;
+exports.getSignalState = getSignalState;
 exports.getSizingSchema = getSizingSchema;
 exports.getStrategySchema = getStrategySchema;
 exports.getSymbol = getSymbol;
@@ -59777,6 +61825,8 @@ exports.set = set;
 exports.setColumns = setColumns;
 exports.setConfig = setConfig;
 exports.setLogger = setLogger;
+exports.setSessionData = setSessionData;
+exports.setSignalState = setSignalState;
 exports.shutdown = shutdown;
 exports.slPercentShiftToPrice = slPercentShiftToPrice;
 exports.slPriceToPercentShift = slPriceToPercentShift;