backtest-kit 7.5.0 → 7.7.0

package/build/index.cjs

@@ -1024,6 +1024,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";
@@ -3069,6 +3078,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
@@ -3106,6 +3123,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 = functoolsKit.memoize(([strategyName, exchangeName, frameName]) => `${strategyName}:${exchangeName}:${frameName}`, (strategyName, exchangeName, frameName) => Reflect.construct(this.PersistSessionFactory, [
+            frameName,
+            `./dump/session/${strategyName}/${exchangeName}/`,
+        ]));
+        /**
+         * Initializes the storage for a given (strategyName, exchangeName, frameName) triple.
+         *
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @param initial - Whether this is the first initialization
+         */
+        this.waitForInit = async (strategyName, exchangeName, frameName, initial) => {
+            LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_WAIT_FOR_INIT, {
+                strategyName,
+                exchangeName,
+                frameName,
+                initial,
+            });
+            const key = `${strategyName}:${exchangeName}:${frameName}`;
+            const isInitial = initial && !this.getSessionStorage.has(key);
+            const sessionStorage = this.getSessionStorage(strategyName, exchangeName, frameName);
+            await sessionStorage.waitForInit(isInitial);
+        };
+        /**
+         * Reads a session entry from persistence storage.
+         *
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         * @returns Promise resolving to entry data or null if not found
+         */
+        this.readSessionData = async (strategyName, exchangeName, frameName) => {
+            LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_READ_DATA, {
+                strategyName,
+                exchangeName,
+                frameName,
+            });
+            const key = `${strategyName}:${exchangeName}:${frameName}`;
+            const isInitial = !this.getSessionStorage.has(key);
+            const sessionStorage = this.getSessionStorage(strategyName, exchangeName, frameName);
+            await sessionStorage.waitForInit(isInitial);
+            if (await sessionStorage.hasValue(frameName)) {
+                return await sessionStorage.readValue(frameName);
+            }
+            return null;
+        };
+        /**
+         * Writes a session entry to disk with atomic file writes.
+         *
+         * @param data - Entry data to persist
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         */
+        this.writeSessionData = async (data, strategyName, exchangeName, frameName) => {
+            LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_WRITE_DATA, {
+                strategyName,
+                exchangeName,
+                frameName,
+            });
+            const key = `${strategyName}:${exchangeName}:${frameName}`;
+            const isInitial = !this.getSessionStorage.has(key);
+            const sessionStorage = this.getSessionStorage(strategyName, exchangeName, frameName);
+            await sessionStorage.waitForInit(isInitial);
+            await sessionStorage.writeValue(frameName, data);
+        };
+        /**
+         * Switches to a dummy persist adapter that discards all writes.
+         * All future persistence writes will be no-ops.
+         */
+        this.useDummy = () => {
+            LOGGER_SERVICE$7.log(PERSIST_SESSION_UTILS_METHOD_NAME_USE_DUMMY);
+            this.usePersistSessionAdapter(PersistDummy);
+        };
+        /**
+         * Switches to the default JSON persist adapter.
+         * All future persistence writes will use JSON storage.
+         */
+        this.useJson = () => {
+            LOGGER_SERVICE$7.log(PERSIST_SESSION_UTILS_METHOD_NAME_USE_JSON);
+            this.usePersistSessionAdapter(PersistBase);
+        };
+        /**
+         * Clears the memoized storage cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new storage instances are created with the updated base path.
+         */
+        this.clear = () => {
+            LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_CLEAR);
+            this.getSessionStorage.clear();
+        };
+        /**
+         * Disposes of the session adapter and releases any resources.
+         * Call this when a session is removed to clean up its associated storage.
+         *
+         * @param strategyName - Strategy identifier
+         * @param exchangeName - Exchange identifier
+         * @param frameName - Frame identifier
+         */
+        this.dispose = (strategyName, exchangeName, frameName) => {
+            LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_DISPOSE);
+            const key = `${strategyName}:${exchangeName}:${frameName}`;
+            this.getSessionStorage.clear(key);
+        };
+    }
+    /**
+     * Registers a custom persistence adapter.
+     *
+     * @param Ctor - Custom PersistBase constructor
+     */
+    usePersistSessionAdapter(Ctor) {
+        LOGGER_SERVICE$7.info(PERSIST_SESSION_UTILS_METHOD_NAME_USE_PERSIST_SESSION_ADAPTER);
+        this.PersistSessionFactory = Ctor;
+    }
+}
+/**
+ * Global singleton instance of PersistSessionUtils.
+ * Used by SessionPersistInstance for crash-safe session persistence.
+ */
+const PersistSessionAdapter = new PersistSessionUtils();
 
 var _a$2, _b$2;
 const BUSY_DELAY = 100;
@@ -10571,7 +10724,7 @@ const GET_RISK_FN = (dto, backtest, exchangeName, frameName, self) => {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$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);
@@ -10871,7 +11024,7 @@ class StrategyConnectionService {
          * @param backtest - Whether running in backtest mode
          * @returns Configured ClientStrategy instance
          */
-        this.getStrategy = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$w(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => {
+        this.getStrategy = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$x(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => {
             const { riskName = "", riskList = [], getSignal, interval = STRATEGY_DEFAULT_INTERVAL, callbacks, } = this.strategySchemaService.get(strategyName);
             return new ClientStrategy({
                 symbol,
@@ -11833,7 +11986,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;
             }
@@ -13007,7 +13160,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);
@@ -13107,7 +13260,7 @@ class RiskConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientRisk instance
          */
-        this.getRisk = functoolsKit.memoize(([riskName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$v(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
+        this.getRisk = functoolsKit.memoize(([riskName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$w(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
             const schema = this.riskSchemaService.get(riskName);
             return new ClientRisk({
                 ...schema,
@@ -13176,7 +13329,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 {
@@ -14295,7 +14448,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);
@@ -14347,7 +14500,7 @@ class ActionConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientAction instance
          */
-        this.getAction = functoolsKit.memoize(([actionName, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$u(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
+        this.getAction = functoolsKit.memoize(([actionName, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$v(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
             const schema = this.actionSchemaService.get(actionName);
             return new ClientAction({
                 ...schema,
@@ -14573,7 +14726,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;
             }
@@ -14591,7 +14744,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;
 };
 /**
@@ -14615,7 +14768,7 @@ class ExchangeCoreService {
          * @param exchangeName - Name of the exchange to validate
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = functoolsKit.memoize(([exchangeName]) => CREATE_KEY_FN$t(exchangeName), async (exchangeName) => {
+        this.validate = functoolsKit.memoize(([exchangeName]) => CREATE_KEY_FN$u(exchangeName), async (exchangeName) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$3, {
                 exchangeName,
             });
@@ -14867,7 +15020,7 @@ const METHOD_NAME_VALIDATE$2 = "strategyCoreService validate";
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$s = (context) => {
+const CREATE_KEY_FN$t = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -14899,7 +15052,7 @@ class StrategyCoreService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$s(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$t(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$2, {
                 context,
             });
@@ -16269,7 +16422,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);
@@ -16295,7 +16448,7 @@ class RiskGlobalService {
          * @param payload - Payload with riskName, exchangeName and frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$r(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$s(context), async (context) => {
             this.loggerService.log("riskGlobalService validate", {
                 context,
             });
@@ -16373,7 +16526,7 @@ const METHOD_NAME_VALIDATE$1 = "actionCoreService validate";
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$q = (context) => {
+const CREATE_KEY_FN$r = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -16417,7 +16570,7 @@ class ActionCoreService {
          * @param context - Strategy execution context with strategyName, exchangeName and frameName
          * @returns Promise that resolves when all validations complete
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$q(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$r(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$1, {
                 context,
             });
@@ -21487,7 +21640,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);
@@ -21733,7 +21886,7 @@ class BacktestMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$p(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$a(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$q(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$a(symbol, strategyName, exchangeName, frameName));
         /**
          * Processes tick events and accumulates closed signals.
          * Should be called from IStrategyCallbacks.onTick.
@@ -21890,7 +22043,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 {
@@ -21952,7 +22105,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);
@@ -22447,7 +22600,7 @@ class LiveMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$o(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$9(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$p(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$9(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to live signal emitter to receive tick events.
          * Protected against multiple subscriptions.
@@ -22665,7 +22818,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 {
@@ -22685,7 +22838,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);
@@ -22974,7 +23127,7 @@ class ScheduleMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$n(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$8(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$o(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$8(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to signal emitter to receive scheduled signal events.
          * Protected against multiple subscriptions.
@@ -23177,7 +23330,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 {
@@ -23197,7 +23350,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);
@@ -23442,7 +23595,7 @@ class PerformanceMarkdownService {
          * Memoized function to get or create PerformanceStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$m(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new PerformanceStorage(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$n(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new PerformanceStorage(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to performance emitter to receive performance events.
          * Protected against multiple subscriptions.
@@ -23609,7 +23762,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 {
@@ -24088,7 +24241,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);
@@ -24535,7 +24688,7 @@ class HeatMarkdownService {
          * Memoized function to get or create HeatmapStorage for exchange, frame and backtest mode.
          * Each exchangeName + frameName + backtest mode combination gets its own isolated heatmap storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([exchangeName, frameName, backtest]) => CREATE_KEY_FN$l(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
+        this.getStorage = functoolsKit.memoize(([exchangeName, frameName, backtest]) => CREATE_KEY_FN$m(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
         /**
          * Subscribes to signal emitter to receive tick events.
          * Protected against multiple subscriptions.
@@ -24753,7 +24906,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 {
@@ -25784,7 +25937,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.
  *
@@ -25906,7 +26059,7 @@ class PartialConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientPartial instance with logger and event emitters
          */
-        this.getPartial = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$k(signalId, backtest), (signalId, backtest) => {
+        this.getPartial = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$l(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -25996,7 +26149,7 @@ class PartialConnectionService {
             const partial = this.getPartial(data.id, backtest);
             await partial.waitForInit(symbol, data.strategyName, data.exchangeName, backtest);
             await partial.clear(symbol, data, priceClose, backtest);
-            const key = CREATE_KEY_FN$k(data.id, backtest);
+            const key = CREATE_KEY_FN$l(data.id, backtest);
             this.getPartial.clear(key);
         };
     }
@@ -26012,7 +26165,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);
@@ -26235,7 +26388,7 @@ class PartialMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$j(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$6(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$k(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$6(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to partial profit/loss signal emitters to receive events.
          * Protected against multiple subscriptions.
@@ -26445,7 +26598,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 {
@@ -26461,7 +26614,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);
@@ -26535,7 +26688,7 @@ class PartialGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$i(context), (context, methodName) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$j(context), (context, methodName) => {
             this.loggerService.log("partialGlobalService validate", {
                 context,
                 methodName,
@@ -26990,7 +27143,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.
  *
@@ -27076,7 +27229,7 @@ class BreakevenConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientBreakeven instance with logger and event emitter
          */
-        this.getBreakeven = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$h(signalId, backtest), (signalId, backtest) => {
+        this.getBreakeven = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$i(signalId, backtest), (signalId, backtest) => {
             return new ClientBreakeven({
                 signalId,
                 logger: this.loggerService,
@@ -27137,7 +27290,7 @@ class BreakevenConnectionService {
             const breakeven = this.getBreakeven(data.id, backtest);
             await breakeven.waitForInit(symbol, data.strategyName, data.exchangeName, backtest);
             await breakeven.clear(symbol, data, priceClose, backtest);
-            const key = CREATE_KEY_FN$h(data.id, backtest);
+            const key = CREATE_KEY_FN$i(data.id, backtest);
             this.getBreakeven.clear(key);
         };
     }
@@ -27153,7 +27306,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);
@@ -27328,7 +27481,7 @@ class BreakevenMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$g(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$5(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$h(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$5(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to breakeven signal emitter to receive events.
          * Protected against multiple subscriptions.
@@ -27517,7 +27670,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 {
@@ -27533,7 +27686,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);
@@ -27607,7 +27760,7 @@ class BreakevenGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$f(context), (context, methodName) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$g(context), (context, methodName) => {
             this.loggerService.log("breakevenGlobalService validate", {
                 context,
                 methodName,
@@ -27828,7 +27981,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);
@@ -27995,7 +28148,7 @@ class RiskMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$e(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$4(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$f(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$4(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to risk rejection emitter to receive rejection events.
          * Protected against multiple subscriptions.
@@ -28184,7 +28337,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 {
@@ -30764,7 +30917,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);
@@ -31006,7 +31159,7 @@ class StrategyMarkdownService {
          *
          * @internal
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$d(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$3(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$e(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$3(symbol, strategyName, exchangeName, frameName));
         /**
          * Records a cancel-scheduled event when a scheduled signal is cancelled.
          *
@@ -31580,7 +31733,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 {
@@ -31688,7 +31841,7 @@ class StrategyMarkdownService {
  * Creates a unique key for memoizing ReportStorage instances.
  * Key format: "symbol:strategyName:exchangeName[:frameName]:backtest|live"
  */
-const CREATE_KEY_FN$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);
@@ -31881,7 +32034,7 @@ let ReportStorage$2 = class ReportStorage {
 class SyncMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$c(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$2(symbol, strategyName, exchangeName, frameName, backtest));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$d(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$2(symbol, strategyName, exchangeName, frameName, backtest));
         /**
          * Subscribes to `syncSubject` to start receiving `SignalSyncContract` events.
          * Protected against multiple subscriptions via `singleshot` — subsequent calls
@@ -32079,7 +32232,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 {
@@ -32092,7 +32245,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);
@@ -32270,7 +32423,7 @@ let ReportStorage$1 = class ReportStorage {
 class HighestProfitMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$b(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$1(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$c(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$1(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to `highestProfitSubject` to start receiving `HighestProfitContract`
          * events. Protected against multiple subscriptions via `singleshot` — subsequent
@@ -32436,7 +32589,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 {
@@ -32458,7 +32611,7 @@ const LISTEN_TIMEOUT$1 = 120000;
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$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);
@@ -32501,7 +32654,7 @@ class PriceMetaService {
          * Each subject holds the latest currentPrice emitted by the strategy iterator for that key.
          * Instances are cached until clear() is called.
          */
-        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$a(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
+        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$b(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
         /**
          * Returns the current market price for the given symbol and context.
          *
@@ -32530,10 +32683,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 functoolsKit.waitForNext(source, (data) => !!data, LISTEN_TIMEOUT$1);
             if (typeof currentPrice === "symbol") {
-                throw new Error(`PriceMetaService: Timeout while waiting for currentPrice for ${CREATE_KEY_FN$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;
         };
@@ -32575,7 +32728,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);
         };
     }
@@ -32593,7 +32746,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);
@@ -32636,7 +32789,7 @@ class TimeMetaService {
          * Each subject holds the latest createdAt timestamp emitted by the strategy iterator for that key.
          * Instances are cached until clear() is called.
          */
-        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$9(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
+        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$a(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
         /**
          * Returns the current candle timestamp (in milliseconds) for the given symbol and context.
          *
@@ -32664,10 +32817,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 functoolsKit.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;
         };
@@ -32709,7 +32862,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);
         };
     }
@@ -32815,7 +32968,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);
@@ -32941,7 +33094,7 @@ class ReportStorage {
 class MaxDrawdownMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$8(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$9(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to `maxDrawdownSubject` to start receiving `MaxDrawdownContract`
          * events. Protected against multiple subscriptions via `singleshot`.
@@ -33020,7 +33173,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 {
@@ -33038,7 +33191,7 @@ const METHOD_NAME_VALIDATE = "notificationHelperService.validate";
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$7 = (context) => {
+const CREATE_KEY_FN$8 = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -33071,7 +33224,7 @@ class NotificationHelperService {
          * @param context - Routing context: strategyName, exchangeName, frameName
          * @throws {Error} If any registered schema fails validation
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$7(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$8(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE, {
                 context,
             });
@@ -46615,7 +46768,7 @@ const RECENT_ADAPTER_METHOD_NAME_GET_MINUTES_SINCE_LATEST_SIGNAL = "RecentAdapte
  * @param backtest - Flag indicating if the context is backtest or live
  * @returns Composite key string
  */
-const CREATE_KEY_FN$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);
@@ -46705,7 +46858,7 @@ class RecentMemoryBacktestUtils {
             backtest.loggerService.info(RECENT_MEMORY_BACKTEST_METHOD_NAME_HANDLE_ACTIVE_PING, {
                 signalId: event.data.id,
             });
-            const key = CREATE_KEY_FN$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);
         };
         /**
@@ -46718,7 +46871,7 @@ class RecentMemoryBacktestUtils {
          * @returns The latest signal or null if not found
          */
         this.getLatestSignal = async (symbol, strategyName, exchangeName, frameName, backtest$1) => {
-            const key = CREATE_KEY_FN$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;
         };
@@ -46824,7 +46977,7 @@ class RecentMemoryLiveUtils {
             backtest.loggerService.info(RECENT_MEMORY_LIVE_METHOD_NAME_HANDLE_ACTIVE_PING, {
                 signalId: event.data.id,
             });
-            const key = CREATE_KEY_FN$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);
         };
         /**
@@ -46837,7 +46990,7 @@ class RecentMemoryLiveUtils {
          * @returns The latest signal or null if not found
          */
         this.getLatestSignal = async (symbol, strategyName, exchangeName, frameName, backtest$1) => {
-            const key = CREATE_KEY_FN$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;
         };
@@ -47188,7 +47341,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";
@@ -47366,7 +47519,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;
         });
@@ -47411,14 +47564,14 @@ class StatePersistInstance {
 class StateBacktestAdapter {
     constructor() {
         this.StateFactory = StateLocalInstance;
-        this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$5(signalId, bucketName), (signalId, bucketName, initialValue) => Reflect.construct(this.StateFactory, [initialValue, signalId, bucketName]));
+        this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$6(signalId, bucketName), (signalId, bucketName, initialValue) => Reflect.construct(this.StateFactory, [initialValue, signalId, bucketName]));
         /**
          * Disposes all memoized instances for the given signalId.
          * Called by StateAdapter when a signal is cancelled or closed.
          * @param signalId - Signal identifier to dispose
          */
         this.disposeSignal = (signalId) => {
-            const prefix = CREATE_KEY_FN$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);
@@ -47439,7 +47592,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);
@@ -47458,7 +47611,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);
@@ -47526,14 +47679,14 @@ class StateBacktestAdapter {
 class StateLiveAdapter {
     constructor() {
         this.StateFactory = StatePersistInstance;
-        this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$5(signalId, bucketName), (signalId, bucketName, initialValue) => Reflect.construct(this.StateFactory, [initialValue, signalId, bucketName]));
+        this.getInstance = functoolsKit.memoize(([signalId, bucketName]) => CREATE_KEY_FN$6(signalId, bucketName), (signalId, bucketName, initialValue) => Reflect.construct(this.StateFactory, [initialValue, signalId, bucketName]));
         /**
          * Disposes all memoized instances for the given signalId.
          * Called by StateAdapter when a signal is cancelled or closed.
          * @param signalId - Signal identifier to dispose
          */
         this.disposeSignal = (signalId) => {
-            const prefix = CREATE_KEY_FN$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);
@@ -47554,7 +47707,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);
@@ -47573,7 +47726,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);
@@ -47825,6 +47978,7 @@ async function getMinutesSinceLatestSignalCreated(symbol) {
  * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
  * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
  *
+ * @param symbol - Trading pair symbol
  * @param dto.bucketName - State bucket name
  * @param dto.initialValue - Default value when no persisted state exists
  * @returns Promise resolving to current state value, or initialValue if no signal
@@ -47844,16 +47998,16 @@ async function getMinutesSinceLatestSignalCreated(symbol) {
  * }
  * ```
  */
-async function getSignalState(dto) {
+async function getSignalState(symbol, dto) {
     const { bucketName, initialValue } = dto;
-    backtest.loggerService.info(GET_SIGNAL_STATE_METHOD_NAME, { bucketName });
+    backtest.loggerService.info(GET_SIGNAL_STATE_METHOD_NAME, { symbol, bucketName });
     if (!ExecutionContextService.hasContext()) {
         throw new Error("getSignalState requires an execution context");
     }
     if (!MethodContextService.hasContext()) {
         throw new Error("getSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -47889,6 +48043,7 @@ async function getSignalState(dto) {
  * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
  * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
  *
+ * @param symbol - Trading pair symbol
  * @param dto.bucketName - State bucket name
  * @param dto.initialValue - Default value when no persisted state exists
  * @param dto.dispatch - New value or updater function receiving current value
@@ -47912,7 +48067,7 @@ async function getSignalState(dto) {
  * );
  * ```
  */
-async function setSignalState(dispatch, dto) {
+async function setSignalState(symbol, dispatch, dto) {
     const { bucketName, initialValue } = dto;
     backtest.loggerService.info(SET_SIGNAL_STATE_METHOD_NAME, { bucketName });
     if (!ExecutionContextService.hasContext()) {
@@ -47921,7 +48076,7 @@ async function setSignalState(dispatch, dto) {
     if (!MethodContextService.hasContext()) {
         throw new Error("setSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -47944,15 +48099,549 @@ 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 = functoolsKit.singleshot(async (_initial) => {
+            this._data = null;
+        });
+        /**
+         * Read the current in-memory session value.
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async () => {
+            backtest.loggerService.debug(SESSION_LOCAL_INSTANCE_METHOD_NAME_GET, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+            });
+            return this._data;
+        };
+        /**
+         * Update the in-memory session value.
+         * @param value - New value or null to clear
+         */
+        this.setData = async (value) => {
+            backtest.loggerService.debug(SESSION_LOCAL_INSTANCE_METHOD_NAME_SET, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+            });
+            this._data = value;
+        };
+    }
+    /** Releases resources held by this instance. */
+    async dispose() {
+        backtest.loggerService.debug(SESSION_BACKTEST_ADAPTER_METHOD_NAME_DISPOSE, {
+            strategyName: this.strategyName,
+            exchangeName: this.exchangeName,
+            frameName: this.frameName,
+        });
+    }
+}
+/**
+ * No-op session instance that discards all writes.
+ * Used for disabling session storage in tests or dry-run scenarios.
+ *
+ * Useful when replaying historical candles without needing to accumulate
+ * cross-candle session state — getData always returns null.
+ */
+class SessionDummyInstance {
+    constructor(symbol, strategyName, exchangeName, frameName, backtest) {
+        this.symbol = symbol;
+        this.strategyName = strategyName;
+        this.exchangeName = exchangeName;
+        this.frameName = frameName;
+        this.backtest = backtest;
+        /**
+         * No-op initialization.
+         * @returns Promise that resolves immediately
+         */
+        this.waitForInit = functoolsKit.singleshot(async (_initial) => {
+        });
+        /**
+         * No-op read — always returns null.
+         * @returns null
+         */
+        this.getData = async () => {
+            return null;
+        };
+        /**
+         * No-op write — discards the value.
+         */
+        this.setData = async (_value) => {
+        };
+    }
+    /** No-op. */
+    async dispose() {
+    }
+}
+/**
+ * File-system backed session instance.
+ * Data is persisted atomically to disk via PersistSessionAdapter.
+ * Session is restored from disk on waitForInit.
+ *
+ * Features:
+ * - Crash-safe atomic file writes
+ * - Scoped per (symbol, strategyName, exchangeName, frameName) tuple
+ *
+ * Use in live trading to survive process restarts mid-session.
+ */
+class SessionPersistInstance {
+    constructor(symbol, strategyName, exchangeName, frameName, backtest$1) {
+        this.symbol = symbol;
+        this.strategyName = strategyName;
+        this.exchangeName = exchangeName;
+        this.frameName = frameName;
+        this.backtest = backtest$1;
+        this._data = null;
+        /**
+         * Initialize persistence storage and restore session from disk.
+         * @param initial - Whether this is the first initialization
+         */
+        this.waitForInit = functoolsKit.singleshot(async (initial) => {
+            backtest.loggerService.debug(SESSION_PERSIST_INSTANCE_METHOD_NAME_WAIT_FOR_INIT, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+                initial,
+            });
+            await PersistSessionAdapter.waitForInit(this.strategyName, this.exchangeName, this.frameName, initial);
+            const data = await PersistSessionAdapter.readSessionData(this.strategyName, this.exchangeName, this.frameName);
+            if (data) {
+                this._data = data.data;
+                return;
+            }
+            this._data = null;
+        });
+        /**
+         * Read the current persisted session value.
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async () => {
+            backtest.loggerService.debug(SESSION_PERSIST_INSTANCE_METHOD_NAME_GET, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+            });
+            return this._data;
+        };
+        /**
+         * Update session value and persist to disk atomically.
+         * @param value - New value or null to clear
+         */
+        this.setData = async (value) => {
+            backtest.loggerService.debug(SESSION_PERSIST_INSTANCE_METHOD_NAME_SET, {
+                strategyName: this.strategyName,
+                exchangeName: this.exchangeName,
+                frameName: this.frameName,
+            });
+            this._data = value;
+            const id = CREATE_KEY_FN$5(this.symbol, this.strategyName, this.exchangeName, this.frameName, this.backtest);
+            await PersistSessionAdapter.writeSessionData({ id, data: value }, this.strategyName, this.exchangeName, this.frameName);
+        };
+    }
+    /** Releases resources held by this instance. */
+    async dispose() {
+        backtest.loggerService.debug(SESSION_LIVE_ADAPTER_METHOD_NAME_DISPOSE, {
+            strategyName: this.strategyName,
+            exchangeName: this.exchangeName,
+            frameName: this.frameName,
+        });
+        await PersistSessionAdapter.dispose(this.strategyName, this.exchangeName, this.frameName);
+    }
+}
+/**
+ * Backtest session adapter with pluggable storage backend.
+ *
+ * Features:
+ * - Adapter pattern for swappable session instance implementations
+ * - Default backend: SessionLocalInstance (in-memory, no disk persistence)
+ * - Alternative backends: SessionPersistInstance, SessionDummyInstance
+ * - Convenience methods: useLocal(), usePersist(), useDummy(), useSessionAdapter()
+ * - Memoized instances per (symbol, strategyName, exchangeName, frameName) tuple
+ */
+class SessionBacktestAdapter {
+    constructor() {
+        this.SessionFactory = SessionLocalInstance;
+        this.getInstance = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$5(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => Reflect.construct(this.SessionFactory, [symbol, strategyName, exchangeName, frameName, backtest]));
+        /**
+         * Read the current session value for a backtest run.
+         * @param symbol - Trading pair symbol
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async (symbol, context) => {
+            backtest.loggerService.debug(SESSION_BACKTEST_ADAPTER_METHOD_NAME_GET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+            });
+            const key = CREATE_KEY_FN$5(symbol, context.strategyName, context.exchangeName, context.frameName, true);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(symbol, context.strategyName, context.exchangeName, context.frameName, true);
+            await instance.waitForInit(isInitial);
+            return await instance.getData();
+        };
+        /**
+         * Update the session value for a backtest run.
+         * @param symbol - Trading pair symbol
+         * @param value - New value or null to clear
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         */
+        this.setData = async (symbol, value, context) => {
+            backtest.loggerService.debug(SESSION_BACKTEST_ADAPTER_METHOD_NAME_SET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+            });
+            const key = CREATE_KEY_FN$5(symbol, context.strategyName, context.exchangeName, context.frameName, true);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(symbol, context.strategyName, context.exchangeName, context.frameName, true);
+            await instance.waitForInit(isInitial);
+            return await instance.setData(value);
+        };
+        /**
+         * Switches to in-memory adapter (default).
+         * All data lives in process memory only.
+         */
+        this.useLocal = () => {
+            backtest.loggerService.info(SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_LOCAL);
+            this.SessionFactory = SessionLocalInstance;
+        };
+        /**
+         * Switches to file-system backed adapter.
+         * Data is persisted to disk via PersistSessionAdapter.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this.SessionFactory = SessionPersistInstance;
+        };
+        /**
+         * Switches to dummy adapter that discards all writes.
+         */
+        this.useDummy = () => {
+            backtest.loggerService.info(SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY);
+            this.SessionFactory = SessionDummyInstance;
+        };
+        /**
+         * Switches to a custom session adapter implementation.
+         * @param Ctor - Constructor for the custom session instance
+         */
+        this.useSessionAdapter = (Ctor) => {
+            backtest.loggerService.info(SESSION_BACKTEST_ADAPTER_METHOD_NAME_USE_SESSION_ADAPTER);
+            this.SessionFactory = Ctor;
+        };
+        /**
+         * Clears the memoized instance cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new instances are created with the updated base path.
+         */
+        this.clear = () => {
+            backtest.loggerService.info(SESSION_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
+    }
+}
+/**
+ * Live trading session adapter with pluggable storage backend.
+ *
+ * Features:
+ * - Adapter pattern for swappable session instance implementations
+ * - Default backend: SessionPersistInstance (file-system backed, survives restarts)
+ * - Alternative backends: SessionLocalInstance, SessionDummyInstance
+ * - Convenience methods: useLocal(), usePersist(), useDummy(), useSessionAdapter()
+ * - Memoized instances per (symbol, strategyName, exchangeName, frameName) tuple
+ */
+class SessionLiveAdapter {
+    constructor() {
+        this.SessionFactory = SessionPersistInstance;
+        this.getInstance = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$5(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => Reflect.construct(this.SessionFactory, [symbol, strategyName, exchangeName, frameName, backtest]));
+        /**
+         * Read the current session value for a live run.
+         * @param symbol - Trading pair symbol
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async (symbol, context) => {
+            backtest.loggerService.debug(SESSION_LIVE_ADAPTER_METHOD_NAME_GET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+            });
+            const key = CREATE_KEY_FN$5(symbol, context.strategyName, context.exchangeName, context.frameName, false);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(symbol, context.strategyName, context.exchangeName, context.frameName, false);
+            await instance.waitForInit(isInitial);
+            return await instance.getData();
+        };
+        /**
+         * Update the session value for a live run.
+         * @param symbol - Trading pair symbol
+         * @param value - New value or null to clear
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         */
+        this.setData = async (symbol, value, context) => {
+            backtest.loggerService.debug(SESSION_LIVE_ADAPTER_METHOD_NAME_SET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+            });
+            const key = CREATE_KEY_FN$5(symbol, context.strategyName, context.exchangeName, context.frameName, false);
+            const isInitial = !this.getInstance.has(key);
+            const instance = this.getInstance(symbol, context.strategyName, context.exchangeName, context.frameName, false);
+            await instance.waitForInit(isInitial);
+            return await instance.setData(value);
+        };
+        /**
+         * Switches to in-memory adapter.
+         * All data lives in process memory only.
+         */
+        this.useLocal = () => {
+            backtest.loggerService.info(SESSION_LIVE_ADAPTER_METHOD_NAME_USE_LOCAL);
+            this.SessionFactory = SessionLocalInstance;
+        };
+        /**
+         * Switches to file-system backed adapter (default).
+         * Data is persisted to disk via PersistSessionAdapter.
+         */
+        this.usePersist = () => {
+            backtest.loggerService.info(SESSION_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
+            this.SessionFactory = SessionPersistInstance;
+        };
+        /**
+         * Switches to dummy adapter that discards all writes.
+         */
+        this.useDummy = () => {
+            backtest.loggerService.info(SESSION_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY);
+            this.SessionFactory = SessionDummyInstance;
+        };
+        /**
+         * Switches to a custom session adapter implementation.
+         * @param Ctor - Constructor for the custom session instance
+         */
+        this.useSessionAdapter = (Ctor) => {
+            backtest.loggerService.info(SESSION_LIVE_ADAPTER_METHOD_NAME_USE_SESSION_ADAPTER);
+            this.SessionFactory = Ctor;
+        };
+        /**
+         * Clears the memoized instance cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new instances are created with the updated base path.
+         */
+        this.clear = () => {
+            backtest.loggerService.info(SESSION_LIVE_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
+    }
+}
+/**
+ * Main session adapter that manages both backtest and live session storage.
+ *
+ * Features:
+ * - Routes all operations to SessionBacktest or SessionLive based on the backtest flag
+ */
+class SessionAdapter {
+    constructor() {
+        /**
+         * Read the current session value for a signal.
+         * Routes to SessionBacktest or SessionLive based on backtest.
+         * @param symbol - Trading pair symbol
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         * @returns Current session value, or null if not set
+         */
+        this.getData = async (symbol, context, backtest$1) => {
+            backtest.loggerService.debug(SESSION_ADAPTER_METHOD_NAME_GET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+                backtest: backtest$1,
+            });
+            if (backtest$1) {
+                return await SessionBacktest.getData(symbol, context);
+            }
+            return await SessionLive.getData(symbol, context);
+        };
+        /**
+         * Update the session value for a signal.
+         * Routes to SessionBacktest or SessionLive based on backtest.
+         * @param symbol - Trading pair symbol
+         * @param value - New value or null to clear
+         * @param context.strategyName - Strategy identifier
+         * @param context.exchangeName - Exchange identifier
+         * @param context.frameName - Frame identifier
+         * @param backtest - Flag indicating if the context is backtest or live
+         */
+        this.setData = async (symbol, value, context, backtest$1) => {
+            backtest.loggerService.debug(SESSION_ADAPTER_METHOD_NAME_SET, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: context.frameName,
+                backtest: backtest$1,
+            });
+            if (backtest$1) {
+                return await SessionBacktest.setData(symbol, value, context);
+            }
+            return await SessionLive.setData(symbol, value, context);
+        };
+    }
+}
+/**
+ * Global singleton instance of SessionAdapter.
+ * Provides unified session management for backtest and live trading.
+ */
+const Session = new SessionAdapter();
+/**
+ * Global singleton instance of SessionLiveAdapter.
+ * Provides live trading session storage with pluggable backends.
+ */
+const SessionLive = new SessionLiveAdapter();
+/**
+ * Global singleton instance of SessionBacktestAdapter.
+ * Provides backtest session storage with pluggable backends.
+ */
+const SessionBacktest = new SessionBacktestAdapter();
+
+const GET_SESSION_METHOD_NAME = "session.getSession";
+const SET_SESSION_METHOD_NAME = "session.setSession";
+/**
+ * Reads the session value scoped to the current (symbol, strategy, exchange, frame) context.
+ *
+ * Session data persists across candles within a single run and can survive process
+ * restarts in live mode — useful for caching LLM inference results, intermediate
+ * indicator state, or any cross-candle accumulator that is not tied to a specific signal.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to current session value, or null if not set
+ *
+ * @example
+ * ```typescript
+ * import { getSession } from "backtest-kit";
+ *
+ * const session = await getSession<{ lastLlmSignal: string }>("BTCUSDT");
+ * if (session?.lastLlmSignal === "buy") {
+ *   // reuse cached LLM result instead of calling the model again
+ * }
+ * ```
+ */
+async function getSessionData(symbol) {
+    backtest.loggerService.info(GET_SESSION_METHOD_NAME, { symbol });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("getSession requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("getSession requires a method context");
+    }
+    const { backtest: isBacktest } = backtest.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    return await Session.getData(symbol, { exchangeName, frameName, strategyName }, isBacktest);
+}
+/**
+ * Writes a session value scoped to the current (symbol, strategy, exchange, frame) context.
+ *
+ * Session data persists across candles within a single run and can survive process
+ * restarts in live mode — useful for caching LLM inference results, intermediate
+ * indicator state, or any cross-candle accumulator that is not tied to a specific signal.
+ *
+ * Pass null to clear the session.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * @param symbol - Trading pair symbol
+ * @param value - New value or null to clear
+ * @returns Promise that resolves when the session has been written
+ *
+ * @example
+ * ```typescript
+ * import { setSession } from "backtest-kit";
+ *
+ * await setSession("BTCUSDT", { lastLlmSignal: "buy" });
+ * ```
+ */
+async function setSessionData(symbol, value) {
+    backtest.loggerService.info(SET_SESSION_METHOD_NAME, { symbol });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("setSession requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("setSession requires a method context");
+    }
+    const { backtest: isBacktest } = backtest.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
+    await Session.setData(symbol, value, { exchangeName, frameName, strategyName }, isBacktest);
+}
+
 const CREATE_SIGNAL_STATE_METHOD_NAME = "state.createSignalState";
-const CREATE_SET_STATE_FN = (params) => async (dispatch) => {
+const CREATE_SET_STATE_FN = (params) => async (symbol, dispatch) => {
     if (!ExecutionContextService.hasContext()) {
         throw new Error("createSignalState requires an execution context");
     }
     if (!MethodContextService.hasContext()) {
         throw new Error("createSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -47974,14 +48663,14 @@ const CREATE_SET_STATE_FN = (params) => async (dispatch) => {
     }
     throw new Error(`createSignalState requires a pending or scheduled signal for symbol=${symbol} bucketName=${params.bucketName}`);
 };
-const CREATE_GET_STATE_FN = (params) => async () => {
+const CREATE_GET_STATE_FN = (params) => async (symbol) => {
     if (!ExecutionContextService.hasContext()) {
         throw new Error("createSignalState requires an execution context");
     }
     if (!MethodContextService.hasContext()) {
         throw new Error("createSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -51802,7 +52491,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,
@@ -51849,7 +52538,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
@@ -51863,7 +52552,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";
@@ -60931,6 +61620,7 @@ exports.PersistPartialAdapter = PersistPartialAdapter;
 exports.PersistRecentAdapter = PersistRecentAdapter;
 exports.PersistRiskAdapter = PersistRiskAdapter;
 exports.PersistScheduleAdapter = PersistScheduleAdapter;
+exports.PersistSessionAdapter = PersistSessionAdapter;
 exports.PersistSignalAdapter = PersistSignalAdapter;
 exports.PersistStateAdapter = PersistStateAdapter;
 exports.PersistStorageAdapter = PersistStorageAdapter;
@@ -60946,6 +61636,8 @@ exports.ReportWriter = ReportWriter;
 exports.Risk = Risk;
 exports.Schedule = Schedule;
 exports.Session = Session;
+exports.SessionBacktest = SessionBacktest;
+exports.SessionLive = SessionLive;
 exports.State = State;
 exports.StateBacktest = StateBacktest;
 exports.StateBacktestAdapter = StateBacktestAdapter;
@@ -60956,6 +61648,7 @@ exports.StorageBacktest = StorageBacktest;
 exports.StorageLive = StorageLive;
 exports.Strategy = Strategy;
 exports.Sync = Sync;
+exports.System = System;
 exports.Walker = Walker;
 exports.addActionSchema = addActionSchema;
 exports.addExchangeSchema = addExchangeSchema;
@@ -61047,6 +61740,7 @@ exports.getPositionWaitingMinutes = getPositionWaitingMinutes;
 exports.getRawCandles = getRawCandles;
 exports.getRiskSchema = getRiskSchema;
 exports.getScheduledSignal = getScheduledSignal;
+exports.getSessionData = getSessionData;
 exports.getSignalState = getSignalState;
 exports.getSizingSchema = getSizingSchema;
 exports.getStrategySchema = getStrategySchema;
@@ -61133,6 +61827,7 @@ exports.set = set;
 exports.setColumns = setColumns;
 exports.setConfig = setConfig;
 exports.setLogger = setLogger;
+exports.setSessionData = setSessionData;
 exports.setSignalState = setSignalState;
 exports.shutdown = shutdown;
 exports.slPercentShiftToPrice = slPercentShiftToPrice;