backtest-kit 7.4.0 → 7.6.0

package/build/index.mjs

@@ -997,6 +997,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";
@@ -2958,6 +2974,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 = 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 = 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;
@@ -10423,7 +10704,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);
@@ -10723,7 +11004,7 @@ class StrategyConnectionService {
          * @param backtest - Whether running in backtest mode
          * @returns Configured ClientStrategy instance
          */
-        this.getStrategy = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$v(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => {
+        this.getStrategy = 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,
@@ -11685,7 +11966,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;
             }
@@ -12859,7 +13140,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);
@@ -12959,7 +13240,7 @@ class RiskConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientRisk instance
          */
-        this.getRisk = memoize(([riskName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$u(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
+        this.getRisk = 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,
@@ -13028,7 +13309,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 {
@@ -14147,7 +14428,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);
@@ -14199,7 +14480,7 @@ class ActionConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientAction instance
          */
-        this.getAction = memoize(([actionName, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$t(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
+        this.getAction = 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,
@@ -14425,7 +14706,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;
             }
@@ -14443,7 +14724,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;
 };
 /**
@@ -14467,7 +14748,7 @@ class ExchangeCoreService {
          * @param exchangeName - Name of the exchange to validate
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = memoize(([exchangeName]) => CREATE_KEY_FN$s(exchangeName), async (exchangeName) => {
+        this.validate = memoize(([exchangeName]) => CREATE_KEY_FN$u(exchangeName), async (exchangeName) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$3, {
                 exchangeName,
             });
@@ -14719,7 +15000,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);
@@ -14751,7 +15032,7 @@ class StrategyCoreService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$r(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$t(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$2, {
                 context,
             });
@@ -16121,7 +16402,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);
@@ -16147,7 +16428,7 @@ class RiskGlobalService {
          * @param payload - Payload with riskName, exchangeName and frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$q(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$s(context), async (context) => {
             this.loggerService.log("riskGlobalService validate", {
                 context,
             });
@@ -16225,7 +16506,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);
@@ -16269,7 +16550,7 @@ class ActionCoreService {
          * @param context - Strategy execution context with strategyName, exchangeName and frameName
          * @returns Promise that resolves when all validations complete
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$p(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$r(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$1, {
                 context,
             });
@@ -21339,7 +21620,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);
@@ -21585,7 +21866,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 = 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 = 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.
@@ -21742,7 +22023,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 {
@@ -21804,7 +22085,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);
@@ -22299,7 +22580,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 = 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 = 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.
@@ -22517,7 +22798,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 {
@@ -22537,7 +22818,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);
@@ -22826,7 +23107,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 = 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 = 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.
@@ -23029,7 +23310,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 {
@@ -23049,7 +23330,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);
@@ -23294,7 +23575,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 = 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 = 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.
@@ -23461,7 +23742,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 {
@@ -23940,7 +24221,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);
@@ -24387,7 +24668,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 = memoize(([exchangeName, frameName, backtest]) => CREATE_KEY_FN$k(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
+        this.getStorage = 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.
@@ -24605,7 +24886,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 {
@@ -25636,7 +25917,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.
  *
@@ -25758,7 +26039,7 @@ class PartialConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientPartial instance with logger and event emitters
          */
-        this.getPartial = memoize(([signalId, backtest]) => CREATE_KEY_FN$j(signalId, backtest), (signalId, backtest) => {
+        this.getPartial = memoize(([signalId, backtest]) => CREATE_KEY_FN$l(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -25848,7 +26129,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);
         };
     }
@@ -25864,7 +26145,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);
@@ -26087,7 +26368,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 = 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 = 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.
@@ -26297,7 +26578,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 {
@@ -26313,7 +26594,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);
@@ -26387,7 +26668,7 @@ class PartialGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$h(context), (context, methodName) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$j(context), (context, methodName) => {
             this.loggerService.log("partialGlobalService validate", {
                 context,
                 methodName,
@@ -26842,7 +27123,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.
  *
@@ -26928,7 +27209,7 @@ class BreakevenConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientBreakeven instance with logger and event emitter
          */
-        this.getBreakeven = memoize(([signalId, backtest]) => CREATE_KEY_FN$g(signalId, backtest), (signalId, backtest) => {
+        this.getBreakeven = memoize(([signalId, backtest]) => CREATE_KEY_FN$i(signalId, backtest), (signalId, backtest) => {
             return new ClientBreakeven({
                 signalId,
                 logger: this.loggerService,
@@ -26989,7 +27270,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);
         };
     }
@@ -27005,7 +27286,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);
@@ -27180,7 +27461,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 = 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 = 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.
@@ -27369,7 +27650,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 {
@@ -27385,7 +27666,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);
@@ -27459,7 +27740,7 @@ class BreakevenGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$e(context), (context, methodName) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$g(context), (context, methodName) => {
             this.loggerService.log("breakevenGlobalService validate", {
                 context,
                 methodName,
@@ -27680,7 +27961,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);
@@ -27847,7 +28128,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 = 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 = 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.
@@ -28036,7 +28317,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 {
@@ -30616,7 +30897,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);
@@ -30858,7 +31139,7 @@ class StrategyMarkdownService {
          *
          * @internal
          */
-        this.getStorage = 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 = 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.
          *
@@ -31432,7 +31713,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 {
@@ -31540,7 +31821,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);
@@ -31733,7 +32014,7 @@ let ReportStorage$2 = class ReportStorage {
 class SyncMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = 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 = 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
@@ -31931,7 +32212,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 {
@@ -31944,7 +32225,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);
@@ -32122,7 +32403,7 @@ let ReportStorage$1 = class ReportStorage {
 class HighestProfitMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = 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 = 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
@@ -32288,7 +32569,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 {
@@ -32310,7 +32591,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);
@@ -32353,7 +32634,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 = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$9(symbol, strategyName, exchangeName, frameName, backtest), () => new BehaviorSubject());
+        this.getSource = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$b(symbol, strategyName, exchangeName, frameName, backtest), () => new BehaviorSubject());
         /**
          * Returns the current market price for the given symbol and context.
          *
@@ -32382,10 +32663,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 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;
         };
@@ -32427,7 +32708,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);
         };
     }
@@ -32445,7 +32726,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);
@@ -32488,7 +32769,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 = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$8(symbol, strategyName, exchangeName, frameName, backtest), () => new BehaviorSubject());
+        this.getSource = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$a(symbol, strategyName, exchangeName, frameName, backtest), () => new BehaviorSubject());
         /**
          * Returns the current candle timestamp (in milliseconds) for the given symbol and context.
          *
@@ -32516,10 +32797,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 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;
         };
@@ -32561,7 +32842,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);
         };
     }
@@ -32667,7 +32948,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);
@@ -32793,7 +33074,7 @@ class ReportStorage {
 class MaxDrawdownMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = 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 = 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`.
@@ -32872,7 +33153,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 {
@@ -32890,7 +33171,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);
@@ -32923,7 +33204,7 @@ class NotificationHelperService {
          * @param context - Routing context: strategyName, exchangeName, frameName
          * @throws {Error} If any registered schema fails validation
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$6(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$8(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE, {
                 context,
             });
@@ -46467,7 +46748,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);
@@ -46557,7 +46838,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);
         };
         /**
@@ -46570,7 +46851,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;
         };
@@ -46676,7 +46957,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);
         };
         /**
@@ -46689,7 +46970,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;
         };
@@ -47040,6 +47321,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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 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";
 /**
@@ -47115,6 +47944,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 = 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 = 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 = 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 = 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 = 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;
@@ -47201,7 +48801,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,
@@ -47222,18 +48822,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.
@@ -47258,7 +48875,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, {
@@ -47329,7 +48946,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,
         });
@@ -47378,7 +48995,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, {
@@ -47452,7 +49069,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,
         });
@@ -47512,48 +49129,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 = 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 = 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 = 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 compose(() => unCancel(), () => unClose());
+                .connect(({ signal }) => {
+                MemoryBacktest.disposeSignal(signal.id);
+                MemoryLive.disposeSignal(signal.id);
+            });
+            return 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);
@@ -47564,11 +49510,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()) {
@@ -47578,18 +49526,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) => {
@@ -47600,17 +49550,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) => {
@@ -47620,18 +49572,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()) {
@@ -47641,18 +49595,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
          */
@@ -47664,56 +49620,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";
@@ -47723,23 +49653,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) {
@@ -47757,33 +49684,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
@@ -47807,30 +49742,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
@@ -47854,29 +49794,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
@@ -47899,29 +49844,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
@@ -47945,16 +49894,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}`;
@@ -48049,11 +50008,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() {
@@ -48185,9 +50145,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.
@@ -48213,6 +50174,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { messages },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48234,6 +50196,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: record,
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48256,6 +50219,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { rows },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48277,6 +50241,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { content },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48298,6 +50263,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: { content },
             description,
+            backtest: this.backtest,
         });
     }
     /**
@@ -48320,6 +50286,7 @@ class DumpMemoryInstance {
             signalId: this.signalId,
             value: json,
             description,
+            backtest: this.backtest,
         });
     }
     /** Releases resources held by this instance. */
@@ -48341,9 +50308,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 join("./dump/agent", this.signalId, this.bucketName, `${dumpId}.md`);
@@ -48532,9 +50500,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() {
@@ -48577,7 +50546,7 @@ class DumpDummyInstance {
 class DumpAdapter {
     constructor() {
         this.DumpFactory = DumpMarkdownInstance;
-        this.getInstance = memoize(([signalId, bucketName]) => CREATE_KEY_FN$3(signalId, bucketName), (signalId, bucketName) => Reflect.construct(this.DumpFactory, [signalId, bucketName]));
+        this.getInstance = 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,
@@ -48628,7 +50597,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);
         };
         /**
@@ -48643,7 +50612,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);
         };
         /**
@@ -48658,7 +50627,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);
         };
         /**
@@ -48673,7 +50642,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);
         };
         /**
@@ -48688,7 +50657,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);
         };
         /**
@@ -48704,7 +50673,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);
         };
         /**
@@ -48770,16 +50739,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
@@ -48804,31 +50772,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
@@ -48852,23 +50830,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.
  *
@@ -48877,8 +50866,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
@@ -48903,31 +50891,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
@@ -48951,31 +50949,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
@@ -48999,29 +51007,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
  *
@@ -49047,17 +51067,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}`);
 }
 
 /**
@@ -50438,7 +52469,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,
@@ -50485,7 +52516,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
@@ -50499,7 +52530,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";
@@ -59524,4 +61555,4 @@ const validateSignal = (signal, currentPrice) => {
     return !errors.length;
 };
 
-export { ActionBase, Backtest, Breakeven, Broker, BrokerBase, Cache, Constant, Dump, Exchange, ExecutionContextService, Heat, HighestProfit, Interval, Live, Log, Markdown, MarkdownFileBase, MarkdownFolderBase, MarkdownWriter, MaxDrawdown, Memory, MethodContextService, Notification, NotificationBacktest, NotificationLive, Partial, Performance, PersistBase, PersistBreakevenAdapter, PersistCandleAdapter, PersistIntervalAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistMemoryAdapter, PersistNotificationAdapter, PersistPartialAdapter, PersistRecentAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PersistStorageAdapter, Position, PositionSize, Recent, RecentBacktest, RecentLive, Reflect$1 as Reflect, Report, ReportBase, ReportWriter, Risk, Schedule, Session, Storage, StorageBacktest, StorageLive, Strategy, Sync, Walker, addActionSchema, addExchangeSchema, addFrameSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, alignToInterval, checkCandles, commitActivateScheduled, commitAverageBuy, commitBreakeven, commitCancelScheduled, commitClosePending, commitPartialLoss, commitPartialLossCost, commitPartialProfit, commitPartialProfitCost, commitSignalNotify, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, dumpAgentAnswer, dumpError, dumpJson, dumpRecord, dumpTable, dumpText, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getLatestSignal, getMaxDrawdownDistancePnlCost, getMaxDrawdownDistancePnlPercentage, getMinutesSinceLatestSignalCreated, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionActiveMinutes, getPositionCountdownMinutes, getPositionDrawdownMinutes, getPositionEffectivePrice, getPositionEntries, getPositionEntryOverlap, getPositionEstimateMinutes, getPositionHighestMaxDrawdownPnlCost, getPositionHighestMaxDrawdownPnlPercentage, getPositionHighestPnlCost, getPositionHighestPnlPercentage, getPositionHighestProfitBreakeven, getPositionHighestProfitDistancePnlCost, getPositionHighestProfitDistancePnlPercentage, getPositionHighestProfitMinutes, getPositionHighestProfitPrice, getPositionHighestProfitTimestamp, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionMaxDrawdownMinutes, getPositionMaxDrawdownPnlCost, getPositionMaxDrawdownPnlPercentage, getPositionMaxDrawdownPrice, getPositionMaxDrawdownTimestamp, getPositionPartialOverlap, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getPositionWaitingMinutes, getRawCandles, getRiskSchema, getScheduledSignal, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasNoPendingSignal, hasNoScheduledSignal, hasTradeContext, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listMemory, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenHighestProfit, listenHighestProfitOnce, listenIdlePing, listenIdlePingOnce, listenMaxDrawdown, listenMaxDrawdownOnce, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalNotify, listenSignalNotifyOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, readMemory, removeMemory, roundTicks, runInMockContext, searchMemory, set, setColumns, setConfig, setLogger, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, validateCommonSignal, validatePendingSignal, validateScheduledSignal, validateSignal, waitForCandle, warmCandles, writeMemory };
+export { ActionBase, Backtest, Breakeven, Broker, BrokerBase, Cache, Constant, Dump, Exchange, ExecutionContextService, Heat, HighestProfit, Interval, Live, Log, Markdown, MarkdownFileBase, MarkdownFolderBase, MarkdownWriter, MaxDrawdown, Memory, MemoryBacktest, MemoryBacktestAdapter, MemoryLive, MemoryLiveAdapter, MethodContextService, Notification, NotificationBacktest, NotificationLive, Partial, Performance, PersistBase, PersistBreakevenAdapter, PersistCandleAdapter, PersistIntervalAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistMemoryAdapter, PersistNotificationAdapter, PersistPartialAdapter, PersistRecentAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSessionAdapter, PersistSignalAdapter, PersistStateAdapter, PersistStorageAdapter, Position, PositionSize, Recent, RecentBacktest, RecentLive, Reflect$1 as Reflect, Report, ReportBase, ReportWriter, Risk, Schedule, Session, SessionBacktest, SessionLive, State, StateBacktest, StateBacktestAdapter, StateLive, StateLiveAdapter, Storage, StorageBacktest, StorageLive, Strategy, Sync, System, Walker, addActionSchema, addExchangeSchema, addFrameSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, alignToInterval, checkCandles, commitActivateScheduled, commitAverageBuy, commitBreakeven, commitCancelScheduled, commitClosePending, commitPartialLoss, commitPartialLossCost, commitPartialProfit, commitPartialProfitCost, commitSignalNotify, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, createSignalState, dumpAgentAnswer, dumpError, dumpJson, dumpRecord, dumpTable, dumpText, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getLatestSignal, getMaxDrawdownDistancePnlCost, getMaxDrawdownDistancePnlPercentage, getMinutesSinceLatestSignalCreated, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionActiveMinutes, getPositionCountdownMinutes, getPositionDrawdownMinutes, getPositionEffectivePrice, getPositionEntries, getPositionEntryOverlap, getPositionEstimateMinutes, getPositionHighestMaxDrawdownPnlCost, getPositionHighestMaxDrawdownPnlPercentage, getPositionHighestPnlCost, getPositionHighestPnlPercentage, getPositionHighestProfitBreakeven, getPositionHighestProfitDistancePnlCost, getPositionHighestProfitDistancePnlPercentage, getPositionHighestProfitMinutes, getPositionHighestProfitPrice, getPositionHighestProfitTimestamp, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionMaxDrawdownMinutes, getPositionMaxDrawdownPnlCost, getPositionMaxDrawdownPnlPercentage, getPositionMaxDrawdownPrice, getPositionMaxDrawdownTimestamp, getPositionPartialOverlap, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getPositionWaitingMinutes, getRawCandles, getRiskSchema, getScheduledSignal, getSessionData, getSignalState, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasNoPendingSignal, hasNoScheduledSignal, hasTradeContext, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listMemory, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenHighestProfit, listenHighestProfitOnce, listenIdlePing, listenIdlePingOnce, listenMaxDrawdown, listenMaxDrawdownOnce, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalNotify, listenSignalNotifyOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, readMemory, removeMemory, roundTicks, runInMockContext, searchMemory, set, setColumns, setConfig, setLogger, setSessionData, setSignalState, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, validateCommonSignal, validatePendingSignal, validateScheduledSignal, validateSignal, waitForCandle, warmCandles, writeMemory };