backtest-kit 7.5.0 → 7.6.0

package/build/index.mjs

@@ -1004,6 +1004,15 @@ 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";
@@ -3049,6 +3058,14 @@ class PersistStateUtils {
             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
@@ -3086,6 +3103,142 @@ class 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;
@@ -10551,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$w = (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);
@@ -10851,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$w(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,
@@ -11813,7 +11966,7 @@ class StrategyConnectionService {
                 }
                 return;
             }
-            const key = CREATE_KEY_FN$w(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;
             }
@@ -12987,7 +13140,7 @@ class ClientRisk {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$v = (riskName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$w = (riskName, exchangeName, frameName, backtest) => {
     const parts = [riskName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -13087,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$v(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,
@@ -13156,7 +13309,7 @@ class RiskConnectionService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$v(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 {
@@ -14275,7 +14428,7 @@ class ClientAction {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$u = (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);
@@ -14327,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$u(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,
@@ -14553,7 +14706,7 @@ class ActionConnectionService {
                 await Promise.all(actions.map(async (action) => await action.dispose()));
                 return;
             }
-            const key = CREATE_KEY_FN$u(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;
             }
@@ -14571,7 +14724,7 @@ const METHOD_NAME_VALIDATE$3 = "exchangeCoreService validate";
  * @param exchangeName - Exchange name
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$t = (exchangeName) => {
+const CREATE_KEY_FN$u = (exchangeName) => {
     return exchangeName;
 };
 /**
@@ -14595,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$t(exchangeName), async (exchangeName) => {
+        this.validate = memoize(([exchangeName]) => CREATE_KEY_FN$u(exchangeName), async (exchangeName) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$3, {
                 exchangeName,
             });
@@ -14847,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$s = (context) => {
+const CREATE_KEY_FN$t = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -14879,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$s(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$t(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$2, {
                 context,
             });
@@ -16249,7 +16402,7 @@ class SizingGlobalService {
  * @param context - Context with riskName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$r = (context) => {
+const CREATE_KEY_FN$s = (context) => {
     const parts = [context.riskName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -16275,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$r(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$s(context), async (context) => {
             this.loggerService.log("riskGlobalService validate", {
                 context,
             });
@@ -16353,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$q = (context) => {
+const CREATE_KEY_FN$r = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -16397,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$q(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$r(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$1, {
                 context,
             });
@@ -21467,7 +21620,7 @@ const ReportWriter = new ReportWriterAdapter();
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$p = (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);
@@ -21713,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$p(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.
@@ -21870,7 +22023,7 @@ class BacktestMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$p(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 {
@@ -21932,7 +22085,7 @@ class BacktestMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$o = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$p = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -22427,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$o(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.
@@ -22645,7 +22798,7 @@ class LiveMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$o(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$p(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -22665,7 +22818,7 @@ class LiveMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$n = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$o = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -22954,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$n(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.
@@ -23157,7 +23310,7 @@ class ScheduleMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$n(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$o(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -23177,7 +23330,7 @@ class ScheduleMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$m = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$n = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -23422,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$m(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.
@@ -23589,7 +23742,7 @@ class PerformanceMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$m(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$n(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -24068,7 +24221,7 @@ class WalkerMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$l = (exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$m = (exchangeName, frameName, backtest) => {
     const parts = [exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -24515,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$l(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.
@@ -24733,7 +24886,7 @@ class HeatMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$l(payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$m(payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -25764,7 +25917,7 @@ class ClientPartial {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$k = (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.
  *
@@ -25886,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$k(signalId, backtest), (signalId, backtest) => {
+        this.getPartial = memoize(([signalId, backtest]) => CREATE_KEY_FN$l(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -25976,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$k(data.id, backtest);
+            const key = CREATE_KEY_FN$l(data.id, backtest);
             this.getPartial.clear(key);
         };
     }
@@ -25992,7 +26145,7 @@ class PartialConnectionService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$j = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$k = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -26215,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$j(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.
@@ -26425,7 +26578,7 @@ class PartialMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$j(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 {
@@ -26441,7 +26594,7 @@ class PartialMarkdownService {
  * @param context - Context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$i = (context) => {
+const CREATE_KEY_FN$j = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -26515,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$i(context), (context, methodName) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$j(context), (context, methodName) => {
             this.loggerService.log("partialGlobalService validate", {
                 context,
                 methodName,
@@ -26970,7 +27123,7 @@ class ClientBreakeven {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$h = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
+const CREATE_KEY_FN$i = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Creates a callback function for emitting breakeven events to breakevenSubject.
  *
@@ -27056,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$h(signalId, backtest), (signalId, backtest) => {
+        this.getBreakeven = memoize(([signalId, backtest]) => CREATE_KEY_FN$i(signalId, backtest), (signalId, backtest) => {
             return new ClientBreakeven({
                 signalId,
                 logger: this.loggerService,
@@ -27117,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$h(data.id, backtest);
+            const key = CREATE_KEY_FN$i(data.id, backtest);
             this.getBreakeven.clear(key);
         };
     }
@@ -27133,7 +27286,7 @@ class BreakevenConnectionService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$g = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$h = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -27308,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$g(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.
@@ -27497,7 +27650,7 @@ class BreakevenMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$g(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 {
@@ -27513,7 +27666,7 @@ class BreakevenMarkdownService {
  * @param context - Context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$f = (context) => {
+const CREATE_KEY_FN$g = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -27587,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$f(context), (context, methodName) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$g(context), (context, methodName) => {
             this.loggerService.log("breakevenGlobalService validate", {
                 context,
                 methodName,
@@ -27808,7 +27961,7 @@ class ConfigValidationService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$e = (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);
@@ -27975,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$e(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.
@@ -28164,7 +28317,7 @@ class RiskMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$e(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 {
@@ -30744,7 +30897,7 @@ class HighestProfitReportService {
  * @returns Colon-separated key string for memoization
  * @internal
  */
-const CREATE_KEY_FN$d = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$e = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -30986,7 +31139,7 @@ class StrategyMarkdownService {
          *
          * @internal
          */
-        this.getStorage = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$d(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$3(symbol, strategyName, exchangeName, frameName));
+        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.
          *
@@ -31560,7 +31713,7 @@ class StrategyMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("strategyMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$d(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$e(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -31668,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$c = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$d = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -31861,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$c(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
@@ -32059,7 +32212,7 @@ class SyncMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("syncMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$c(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$d(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -32072,7 +32225,7 @@ class SyncMarkdownService {
 /**
  * Creates a unique memoization key for a symbol-strategy-exchange-frame-backtest combination.
  */
-const CREATE_KEY_FN$b = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$c = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -32250,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$b(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
@@ -32416,7 +32569,7 @@ class HighestProfitMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("highestProfitMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$b(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$c(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -32438,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$a = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$b = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -32481,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$a(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.
          *
@@ -32510,10 +32663,10 @@ class PriceMetaService {
             if (source.data) {
                 return source.data;
             }
-            console.warn(`PriceMetaService: No currentPrice available for ${CREATE_KEY_FN$a(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}. Trying to fetch from strategy iterator as a fallback...`);
+            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$a(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;
         };
@@ -32555,7 +32708,7 @@ class PriceMetaService {
                 this.getSource.clear();
                 return;
             }
-            const key = CREATE_KEY_FN$a(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$b(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             this.getSource.clear(key);
         };
     }
@@ -32573,7 +32726,7 @@ const LISTEN_TIMEOUT = 120000;
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$9 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$a = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -32616,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$9(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.
          *
@@ -32644,10 +32797,10 @@ class TimeMetaService {
             if (source.data) {
                 return source.data;
             }
-            console.warn(`TimeMetaService: No timestamp available for ${CREATE_KEY_FN$9(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}. Trying to fetch from strategy iterator as a fallback...`);
+            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$9(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;
         };
@@ -32689,7 +32842,7 @@ class TimeMetaService {
                 this.getSource.clear();
                 return;
             }
-            const key = CREATE_KEY_FN$9(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$a(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             this.getSource.clear(key);
         };
     }
@@ -32795,7 +32948,7 @@ class MaxDrawdownReportService {
 /**
  * Creates a unique memoization key for a symbol-strategy-exchange-frame-backtest combination.
  */
-const CREATE_KEY_FN$8 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$9 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -32921,7 +33074,7 @@ class ReportStorage {
 class MaxDrawdownMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$8(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage(symbol, strategyName, exchangeName, frameName));
+        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`.
@@ -33000,7 +33153,7 @@ class MaxDrawdownMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("maxDrawdownMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$8(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$9(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -33018,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$7 = (context) => {
+const CREATE_KEY_FN$8 = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -33051,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$7(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$8(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE, {
                 context,
             });
@@ -46595,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$6 = (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);
@@ -46685,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$6(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);
         };
         /**
@@ -46698,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$6(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;
         };
@@ -46804,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$6(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);
         };
         /**
@@ -46817,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$6(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;
         };
@@ -47168,7 +47321,7 @@ const RecentLive = new RecentLiveAdapter();
  */
 const RecentBacktest = new RecentBacktestAdapter();
 
-const CREATE_KEY_FN$5 = (signalId, bucketName) => `${signalId}_${bucketName}`;
+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";
@@ -47346,7 +47499,7 @@ class StatePersistInstance {
             else {
                 this._value = dispatch;
             }
-            const id = CREATE_KEY_FN$5(this.signalId, this.bucketName);
+            const id = CREATE_KEY_FN$6(this.signalId, this.bucketName);
             await PersistStateAdapter.writeStateData({ id, data: this._value }, this.signalId, this.bucketName);
             return this._value;
         });
@@ -47391,14 +47544,14 @@ class StatePersistInstance {
 class StateBacktestAdapter {
     constructor() {
         this.StateFactory = StateLocalInstance;
-        this.getInstance = memoize(([signalId, bucketName]) => CREATE_KEY_FN$5(signalId, bucketName), (signalId, bucketName, initialValue) => Reflect.construct(this.StateFactory, [initialValue, signalId, bucketName]));
+        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$5(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);
@@ -47419,7 +47572,7 @@ class StateBacktestAdapter {
                 signalId: dto.signalId,
                 bucketName: dto.bucketName,
             });
-            const key = CREATE_KEY_FN$5(dto.signalId, 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);
@@ -47438,7 +47591,7 @@ class StateBacktestAdapter {
                 signalId: dto.signalId,
                 bucketName: dto.bucketName,
             });
-            const key = CREATE_KEY_FN$5(dto.signalId, 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);
@@ -47506,14 +47659,14 @@ class StateBacktestAdapter {
 class StateLiveAdapter {
     constructor() {
         this.StateFactory = StatePersistInstance;
-        this.getInstance = memoize(([signalId, bucketName]) => CREATE_KEY_FN$5(signalId, bucketName), (signalId, bucketName, initialValue) => Reflect.construct(this.StateFactory, [initialValue, signalId, bucketName]));
+        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$5(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);
@@ -47534,7 +47687,7 @@ class StateLiveAdapter {
                 signalId: dto.signalId,
                 bucketName: dto.bucketName,
             });
-            const key = CREATE_KEY_FN$5(dto.signalId, 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);
@@ -47553,7 +47706,7 @@ class StateLiveAdapter {
                 signalId: dto.signalId,
                 bucketName: dto.bucketName,
             });
-            const key = CREATE_KEY_FN$5(dto.signalId, 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);
@@ -47924,6 +48077,540 @@ async function setSignalState(dispatch, dto) {
     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()) {
@@ -51782,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,
@@ -51829,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
@@ -51843,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";
@@ -60868,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, MemoryBacktest, MemoryBacktestAdapter, MemoryLive, MemoryLiveAdapter, MethodContextService, Notification, NotificationBacktest, NotificationLive, Partial, Performance, PersistBase, PersistBreakevenAdapter, PersistCandleAdapter, PersistIntervalAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistMemoryAdapter, PersistNotificationAdapter, PersistPartialAdapter, PersistRecentAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PersistStateAdapter, PersistStorageAdapter, Position, PositionSize, Recent, RecentBacktest, RecentLive, Reflect$1 as Reflect, Report, ReportBase, ReportWriter, Risk, Schedule, Session, State, StateBacktest, StateBacktestAdapter, StateLive, StateLiveAdapter, 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, 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, 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, setSignalState, 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 };