backtest-kit 6.9.0 → 6.11.0

package/types.d.ts

@@ -1900,6 +1900,8 @@ interface SignalCommitBase {
     totalPartials: number;
     /** Original entry price at signal creation (unchanged by DCA averaging). */
     originalPriceOpen: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
 }
 /**
  * Cancel scheduled signal event.
@@ -2577,14 +2579,18 @@ interface IStrategySchema {
     strategyName: StrategyName;
     /** Optional developer note for documentation */
     note?: string;
-    /** Minimum interval between getSignal calls (throttling) */
-    interval: SignalInterval;
+    /**
+     * Minimum interval between getSignal calls (throttling)
+     *
+     * Default: 1m
+     */
+    interval?: SignalInterval;
     /**
      * Signal generation function (returns null if no signal, validated DTO if signal).
      * If priceOpen is provided - becomes scheduled signal waiting for price to reach entry point.
      * If priceOpen is omitted - opens immediately at current price.
      */
-    getSignal: (symbol: string, when: Date) => Promise<ISignalDto | null>;
+    getSignal: (symbol: string, when: Date, currentPrice: number) => Promise<ISignalDto | null>;
     /** Optional lifecycle event callbacks (onOpen, onClose) */
     callbacks?: Partial<IStrategyCallbacks>;
     /** Optional risk profile identifier for risk management */
@@ -3630,6 +3636,46 @@ interface IStrategy {
      * @returns Promise resolving to PnL cost or null
      */
     getPositionMaxDrawdownPnlCost: (symbol: string) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the highest profit peak.
+     *
+     * Computed as: max(0, peakPnlPercentage - currentPnlPercentage).
+     *
+     * @param symbol - Trading pair symbol
+     * @param currentPrice - Current market price
+     * @returns Promise resolving to drawdown distance in PnL% (≥ 0) or null
+     */
+    getPositionHighestProfitDistancePnlPercentage: (symbol: string, currentPrice: number) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL cost between the current price and the highest profit peak.
+     *
+     * Computed as: max(0, peakPnlCost - currentPnlCost).
+     *
+     * @param symbol - Trading pair symbol
+     * @param currentPrice - Current market price
+     * @returns Promise resolving to drawdown distance in PnL cost (≥ 0) or null
+     */
+    getPositionHighestProfitDistancePnlCost: (symbol: string, currentPrice: number) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the worst drawdown trough.
+     *
+     * Computed as: max(0, currentPnlPercentage - fallPnlPercentage).
+     *
+     * @param symbol - Trading pair symbol
+     * @param currentPrice - Current market price
+     * @returns Promise resolving to recovery distance in PnL% (≥ 0) or null
+     */
+    getPositionHighestMaxDrawdownPnlPercentage: (symbol: string, currentPrice: number) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL cost between the current price and the worst drawdown trough.
+     *
+     * Computed as: max(0, currentPnlCost - fallPnlCost).
+     *
+     * @param symbol - Trading pair symbol
+     * @param currentPrice - Current market price
+     * @returns Promise resolving to recovery distance in PnL cost (≥ 0) or null
+     */
+    getPositionHighestMaxDrawdownPnlCost: (symbol: string, currentPrice: number) => Promise<number | null>;
     /**
      * Disposes the strategy instance and cleans up resources.
      *
@@ -5590,6 +5636,78 @@ declare function getPositionMaxDrawdownPnlPercentage(symbol: string): Promise<nu
  * ```
  */
 declare function getPositionMaxDrawdownPnlCost(symbol: string): Promise<number>;
+/**
+ * Returns the distance in PnL percentage between the current price and the highest profit peak.
+ *
+ * Computed as: max(0, peakPnlPercentage - currentPnlPercentage).
+ * Returns null if no pending signal exists.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to drawdown distance in PnL% (≥ 0) or null
+ *
+ * @example
+ * ```typescript
+ * import { getPositionHighestProfitDistancePnlPercentage } from "backtest-kit";
+ *
+ * const dist = await getPositionHighestProfitDistancePnlPercentage("BTCUSDT");
+ * // e.g. 1.5 (gave back 1.5% from peak)
+ * ```
+ */
+declare function getPositionHighestProfitDistancePnlPercentage(symbol: string): Promise<number>;
+/**
+ * Returns the distance in PnL cost between the current price and the highest profit peak.
+ *
+ * Computed as: max(0, peakPnlCost - currentPnlCost).
+ * Returns null if no pending signal exists.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to drawdown distance in PnL cost (≥ 0) or null
+ *
+ * @example
+ * ```typescript
+ * import { getPositionHighestProfitDistancePnlCost } from "backtest-kit";
+ *
+ * const dist = await getPositionHighestProfitDistancePnlCost("BTCUSDT");
+ * // e.g. 3.2 (gave back $3.2 from peak)
+ * ```
+ */
+declare function getPositionHighestProfitDistancePnlCost(symbol: string): Promise<number>;
+/**
+ * Returns the distance in PnL percentage between the current price and the worst drawdown trough.
+ *
+ * Computed as: max(0, currentPnlPercentage - fallPnlPercentage).
+ * Returns null if no pending signal exists.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to recovery distance in PnL% (≥ 0) or null
+ *
+ * @example
+ * ```typescript
+ * import { getPositionHighestMaxDrawdownPnlPercentage } from "backtest-kit";
+ *
+ * const dist = await getPositionHighestMaxDrawdownPnlPercentage("BTCUSDT");
+ * // e.g. 2.1 (recovered 2.1% from trough)
+ * ```
+ */
+declare function getPositionHighestMaxDrawdownPnlPercentage(symbol: string): Promise<number>;
+/**
+ * Returns the distance in PnL cost between the current price and the worst drawdown trough.
+ *
+ * Computed as: max(0, currentPnlCost - fallPnlCost).
+ * Returns null if no pending signal exists.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to recovery distance in PnL cost (≥ 0) or null
+ *
+ * @example
+ * ```typescript
+ * import { getPositionHighestMaxDrawdownPnlCost } from "backtest-kit";
+ *
+ * const dist = await getPositionHighestMaxDrawdownPnlCost("BTCUSDT");
+ * // e.g. 4.8 (recovered $4.8 from trough)
+ * ```
+ */
+declare function getPositionHighestMaxDrawdownPnlCost(symbol: string): Promise<number>;
 /**
  * Checks whether the current price falls within the tolerance zone of any existing DCA entry level.
  * Use this to prevent duplicate DCA entries at the same price area.
@@ -9061,7 +9179,7 @@ interface IRunContext extends IMethodContext, IExecutionContext {
  *
  * @template T - Return type of the function.
  */
-type Function$1<T extends unknown = any> = () => T | Promise<T>;
+type Function$2<T extends unknown = any> = () => T | Promise<T>;
 /**
  * Runs a function inside a mock method and execution context.
  *
@@ -9089,7 +9207,7 @@ type Function$1<T extends unknown = any> = () => T | Promise<T>;
  * );
  * ```
  */
-declare function runInMockContext<T extends unknown = any>(run: Function$1<T>, { exchangeName, frameName, strategyName, symbol, backtest: isBacktest, when, }: Partial<IRunContext>): Promise<T>;
+declare function runInMockContext<T extends unknown = any>(run: Function$2<T>, { exchangeName, frameName, strategyName, symbol, backtest: isBacktest, when, }: Partial<IRunContext>): Promise<T>;
 
 /**
  * Portfolio heatmap statistics for a single symbol.
@@ -9353,6 +9471,8 @@ interface PartialProfitAvailableNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Signal creation timestamp in milliseconds (when signal was first created/scheduled) */
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
@@ -9415,6 +9535,8 @@ interface PartialLossAvailableNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Signal creation timestamp in milliseconds (when signal was first created/scheduled) */
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
@@ -9475,6 +9597,8 @@ interface BreakevenAvailableNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Signal creation timestamp in milliseconds (when signal was first created/scheduled) */
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
@@ -9537,6 +9661,8 @@ interface PartialProfitCommitNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Signal creation timestamp in milliseconds (when signal was first created/scheduled) */
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
@@ -9599,6 +9725,8 @@ interface PartialLossCommitNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Signal creation timestamp in milliseconds (when signal was first created/scheduled) */
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
@@ -9659,6 +9787,8 @@ interface BreakevenCommitNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Signal creation timestamp in milliseconds (when signal was first created/scheduled) */
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
@@ -9723,6 +9853,8 @@ interface AverageBuyCommitNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Signal creation timestamp in milliseconds (when signal was first created/scheduled) */
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
@@ -9789,6 +9921,8 @@ interface ActivateScheduledCommitNotification {
     pendingAt: number;
     /** Current market price when activation was executed */
     currentPrice: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Unix timestamp in milliseconds when the notification was created */
     createdAt: number;
 }
@@ -9847,6 +9981,8 @@ interface TrailingStopCommitNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Signal creation timestamp in milliseconds (when signal was first created/scheduled) */
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
@@ -9909,6 +10045,8 @@ interface TrailingTakeCommitNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Signal creation timestamp in milliseconds (when signal was first created/scheduled) */
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
@@ -9975,6 +10113,8 @@ interface SignalSyncOpenNotification {
     scheduledAt: number;
     /** Position activation timestamp in milliseconds */
     pendingAt: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Unix timestamp in milliseconds when the notification was created */
     createdAt: number;
 }
@@ -10037,6 +10177,8 @@ interface SignalSyncCloseNotification {
     pendingAt: number;
     /** Why the signal was closed (take_profit | stop_loss | time_expired | closed) */
     closeReason: string;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Unix timestamp in milliseconds when the notification was created */
     createdAt: number;
 }
@@ -10141,6 +10283,8 @@ interface SignalScheduledNotification {
     scheduledAt: number;
     /** Current market price when signal was scheduled */
     currentPrice: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Unix timestamp in milliseconds when the tick result was created (from candle timestamp in backtest or execution context when in live) */
     createdAt: number;
 }
@@ -10193,6 +10337,8 @@ interface SignalCancelledNotification {
     scheduledAt: number;
     /** Pending timestamp in milliseconds (when position became pending/active at priceOpen) */
     pendingAt: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Unix timestamp in milliseconds when the tick result was created (from candle timestamp in backtest or execution context when in live) */
     createdAt: number;
 }
@@ -10285,6 +10431,8 @@ interface CancelScheduledCommitNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Unix timestamp in milliseconds when the notification was created */
     createdAt: number;
 }
@@ -10329,6 +10477,8 @@ interface ClosePendingCommitNotification {
     pnlCost: number;
     /** Total invested capital in USD */
     pnlEntries: number;
+    /** Optional human-readable description of signal reason */
+    note?: string;
     /** Unix timestamp in milliseconds when the notification was created */
     createdAt: number;
 }
@@ -13899,6 +14049,66 @@ declare class BacktestUtils {
         exchangeName: ExchangeName;
         frameName: FrameName;
     }) => Promise<number>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the highest profit peak.
+     *
+     * Computed as: max(0, peakPnlPercentage - currentPnlPercentage).
+     * Returns null if no pending signal exists.
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, and frameName
+     * @returns drawdown distance in PnL% (≥ 0) or null if no active position
+     */
+    getPositionHighestProfitDistancePnlPercentage: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number>;
+    /**
+     * Returns the distance in PnL cost between the current price and the highest profit peak.
+     *
+     * Computed as: max(0, peakPnlCost - currentPnlCost).
+     * Returns null if no pending signal exists.
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, and frameName
+     * @returns drawdown distance in PnL cost (≥ 0) or null if no active position
+     */
+    getPositionHighestProfitDistancePnlCost: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the worst drawdown trough.
+     *
+     * Computed as: max(0, currentPnlPercentage - fallPnlPercentage).
+     * Returns null if no pending signal exists.
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, and frameName
+     * @returns recovery distance in PnL% (≥ 0) or null if no active position
+     */
+    getPositionHighestMaxDrawdownPnlPercentage: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number>;
+    /**
+     * Returns the distance in PnL cost between the current price and the worst drawdown trough.
+     *
+     * Computed as: max(0, currentPnlCost - fallPnlCost).
+     * Returns null if no pending signal exists.
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, and frameName
+     * @returns recovery distance in PnL cost (≥ 0) or null if no active position
+     */
+    getPositionHighestMaxDrawdownPnlCost: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number>;
     /**
      * Checks whether the current price falls within the tolerance zone of any existing DCA entry level.
      * Use this to prevent duplicate DCA entries at the same price area.
@@ -15257,6 +15467,62 @@ declare class LiveUtils {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
     }) => Promise<number>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the highest profit peak.
+     *
+     * Computed as: max(0, peakPnlPercentage - currentPnlPercentage).
+     * Returns null if no pending signal exists.
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName and exchangeName
+     * @returns drawdown distance in PnL% (≥ 0) or null if no active position
+     */
+    getPositionHighestProfitDistancePnlPercentage: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+    }) => Promise<number>;
+    /**
+     * Returns the distance in PnL cost between the current price and the highest profit peak.
+     *
+     * Computed as: max(0, peakPnlCost - currentPnlCost).
+     * Returns null if no pending signal exists.
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName and exchangeName
+     * @returns drawdown distance in PnL cost (≥ 0) or null if no active position
+     */
+    getPositionHighestProfitDistancePnlCost: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+    }) => Promise<number>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the worst drawdown trough.
+     *
+     * Computed as: max(0, currentPnlPercentage - fallPnlPercentage).
+     * Returns null if no pending signal exists.
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName and exchangeName
+     * @returns recovery distance in PnL% (≥ 0) or null if no active position
+     */
+    getPositionHighestMaxDrawdownPnlPercentage: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+    }) => Promise<number>;
+    /**
+     * Returns the distance in PnL cost between the current price and the worst drawdown trough.
+     *
+     * Computed as: max(0, currentPnlCost - fallPnlCost).
+     * Returns null if no pending signal exists.
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName and exchangeName
+     * @returns recovery distance in PnL cost (≥ 0) or null if no active position
+     */
+    getPositionHighestMaxDrawdownPnlCost: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+    }) => Promise<number>;
     /**
      * Checks whether the current price falls within the tolerance zone of any existing DCA entry level.
      * Use this to prevent duplicate DCA entries at the same price area.
@@ -19989,7 +20255,7 @@ declare const Exchange: ExchangeUtils;
  * Generic function type that accepts any arguments and returns any value.
  * Used as a constraint for cached functions.
  */
-type Function = (...args: any[]) => any;
+type Function$1 = (...args: any[]) => any;
 /**
  * Async function type for file-cached functions.
  * First argument is always `symbol: string`, followed by optional spread args.
@@ -20000,7 +20266,7 @@ type CacheFileFunction = (symbol: string, ...args: any[]) => Promise<any>;
  * For example, for a function type `(symbol: string, arg1: number, arg2: string) => Promise<void>`,
  * this type will infer the rest of the arguments as `[arg1: number, arg2: string]`.
  */
-type DropFirst<T extends (...args: any) => any> = T extends (first: any, ...rest: infer R) => any ? R : never;
+type DropFirst$1<T extends (...args: any) => any> = T extends (first: any, ...rest: infer R) => any ? R : never;
 /**
  * Extracts the `key` generator argument tuple from a `CacheFileFunction`.
  * The first two arguments are always `symbol: string` and `alignMs: number` (aligned timestamp),
@@ -20012,7 +20278,7 @@ type DropFirst<T extends (...args: any) => any> = T extends (first: any, ...rest
 type CacheFileKeyArgs<T extends CacheFileFunction> = [
     symbol: string,
     alignMs: number,
-    ...rest: DropFirst<T>
+    ...rest: DropFirst$1<T>
 ];
 /**
  * Utility class for function caching with timeframe-based invalidation.
@@ -20073,7 +20339,7 @@ declare class CacheUtils {
      * const result3 = cachedCalculate("BTCUSDT", 14); // Cached (same key, same interval)
      * ```
      */
-    fn: <T extends Function, K = symbol>(run: T, context: {
+    fn: <T extends Function$1, K = symbol>(run: T, context: {
         interval: CandleInterval;
         key?: (args: Parameters<T>) => K;
     }) => T & {
@@ -20143,13 +20409,19 @@ declare class CacheUtils {
      * Cache.dispose(calculateIndicator);
      * ```
      */
-    dispose: <T extends Function>(run: T) => void;
+    dispose: <T extends Function$1>(run: T) => void;
     /**
      * Clears all memoized CacheFnInstance and CacheFileInstance objects.
      * Call this when process.cwd() changes between strategy iterations
      * so new instances are created with the updated base path.
      */
     clear: () => void;
+    /**
+     * Resets the CacheFileInstance index counter to zero.
+     * This is useful when process.cwd() changes between strategy iterations to ensure
+     * that new CacheFileInstance objects start with index 0 and do not collide with old instances.
+     */
+    resetCounter: () => void;
 }
 /**
  * Singleton instance of CacheUtils for convenient function caching.
@@ -20168,18 +20440,34 @@ declare class CacheUtils {
 declare const Cache: CacheUtils;
 
 /**
- * Signal function type for in-memory once-per-interval firing.
- * Called at most once per interval boundary per symbol.
- * Must return a non-null `ISignalIntervalDto` to start the interval countdown,
- * or `null` to defer firing until the next call.
+ * Generic function type that accepts any arguments and returns any value.
+ * Used as a constraint for interval functions.
  */
-type TIntervalFn = (symbol: string, when: Date) => Promise<ISignalIntervalDto | null>;
+type Function = (...args: any[]) => any;
 /**
- * Signal function type for persistent file-based once-per-interval firing.
+ * Async function type for file-interval functions.
  * First argument is always `symbol: string`, followed by optional spread args.
- * Fired state survives process restarts via `PersistIntervalAdapter`.
  */
-type TIntervalFileFn = (symbol: string, ...args: any[]) => Promise<ISignalIntervalDto | null>;
+type IntervalFileFunction = (symbol: string, ...args: any[]) => Promise<any>;
+/**
+ * Utility type to drop the first argument from a function type.
+ * For example, for `(symbol: string, arg1: number, arg2: string) => Promise<void>`,
+ * this will infer `[arg1: number, arg2: string]`.
+ */
+type DropFirst<T extends (...args: any) => any> = T extends (first: any, ...rest: infer R) => any ? R : never;
+/**
+ * Extracts the `key` generator argument tuple from an `IntervalFileFunction`.
+ * The first two arguments are always `symbol: string` and `alignMs: number` (aligned timestamp),
+ * followed by the rest of the original function's arguments.
+ *
+ * For example, for `(symbol: string, arg1: number) => Promise<void>`,
+ * this will produce `[symbol: string, alignMs: number, arg1: number]`.
+ */
+type IntervalFileKeyArgs<T extends IntervalFileFunction> = [
+    symbol: string,
+    alignMs: number,
+    ...rest: DropFirst<T>
+];
 /**
  * Utility class for wrapping signal functions with once-per-interval firing.
  * Provides two modes: in-memory (`fn`) and persistent file-based (`file`).
@@ -20190,8 +20478,8 @@ type TIntervalFileFn = (symbol: string, ...args: any[]) => Promise<ISignalInterv
  * import { Interval } from "./classes/Interval";
  *
  * const fireOncePerHour = Interval.fn(mySignalFn, { interval: "1h" });
- * await fireOncePerHour("BTCUSDT", when); // fn called — returns its result
- * await fireOncePerHour("BTCUSDT", when); // returns null (same interval)
+ * await fireOncePerHour("BTCUSDT"); // fn called — returns its result
+ * await fireOncePerHour("BTCUSDT"); // returns null (same interval)
  * ```
  */
 declare class IntervalUtils {
@@ -20216,20 +20504,31 @@ declare class IntervalUtils {
      *
      * @param run - Signal function to wrap
      * @param context.interval - Candle interval that controls the firing boundary
-     * @returns Wrapped function with the same signature as `TIntervalFn`, plus a `clear()` method
+     * @param context.key - Optional key generator for argument-based state separation
+     * @returns Wrapped function with the same signature as `F`, plus a `clear()` method
      *
      * @example
      * ```typescript
+     * // Without extra args
      * const fireOnce = Interval.fn(mySignalFn, { interval: "15m" });
+     * await fireOnce("BTCUSDT"); // → T or null  (fn called)
+     * await fireOnce("BTCUSDT"); // → null       (same interval, skipped)
      *
-     * await fireOnce("BTCUSDT", when); // → signal or null  (fn called)
-     * await fireOnce("BTCUSDT", when); // → null            (same interval, skipped)
+     * // With extra args and key
+     * const fireOnce = Interval.fn(mySignalFn, {
+     *   interval: "15m",
+     *   key: ([symbol, period]) => `${symbol}_${period}`,
+     * });
+     * await fireOnce("BTCUSDT", 14); // → T or null
+     * await fireOnce("BTCUSDT", 28); // → T or null (separate state)
      * ```
      */
-    fn: (run: TIntervalFn, context: {
+    fn: <F extends Function>(run: F, context: {
         interval: CandleInterval;
-    }) => TIntervalFn & {
+        key?: (args: Parameters<F>) => string;
+    }) => F & {
         clear(): void;
+        gc(): number | undefined;
     };
     /**
      * Wrap an async signal function with persistent file-based once-per-interval firing.
@@ -20241,24 +20540,30 @@ declare class IntervalUtils {
      * The `run` function reference is used as the memoization key for the underlying
      * `IntervalFileInstance`, so each unique function reference gets its own isolated instance.
      *
-     * @template T - Async function type to wrap
+     * @template F - Concrete async function type
      * @param run - Async signal function to wrap with persistent once-per-interval firing
      * @param context.interval - Candle interval that controls the firing boundary
      * @param context.name - Human-readable bucket name; becomes the directory prefix
-     * @returns Wrapped function with the same signature as `T`, plus an async `clear()` method
-     *   that deletes persisted records from disk and disposes the memoized instance
+     * @param context.key - Optional entity key generator. Receives `[symbol, alignMs, ...rest]`.
+     *                      Default: `([symbol, alignMs]) => \`${symbol}_${alignMs}\``
+     * @returns Wrapped function with the same signature as `F`, plus an async `clear()` method
      *
      * @example
      * ```typescript
      * const fetchSignal = async (symbol: string, period: number) => { ... };
-     * const fireOnce = Interval.file(fetchSignal, { interval: "1h", name: "fetchSignal" });
-     * await fireOnce.clear(); // delete disk records so the function fires again next call
+     * const fireOnce = Interval.file(fetchSignal, {
+     *   interval: "1h",
+     *   name: "fetchSignal",
+     *   key: ([symbol, alignMs, period]) => `${symbol}_${alignMs}_${period}`,
+     * });
+     * await fireOnce("BTCUSDT", 14);
      * ```
      */
-    file: <T extends TIntervalFileFn>(run: T, context: {
+    file: <F extends IntervalFileFunction>(run: F, context: {
         interval: CandleInterval;
         name: string;
-    }) => T & {
+        key?: (args: IntervalFileKeyArgs<F>) => string;
+    }) => F & {
         clear(): Promise<void>;
     };
     /**
@@ -20276,14 +20581,19 @@ declare class IntervalUtils {
      * Interval.dispose(mySignalFn);
      * ```
      */
-    dispose: (run: TIntervalFn) => void;
+    dispose: (run: Function) => void;
     /**
-     * Clears all memoized `IntervalFnInstance` and `IntervalFileInstance` objects and
-     * resets the `IntervalFileInstance` index counter.
+     * Clears all memoized `IntervalFnInstance` and `IntervalFileInstance` objects.
      * Call this when `process.cwd()` changes between strategy iterations
      * so new instances are created with the updated base path.
      */
     clear: () => void;
+    /**
+     * Resets the IntervalFileInstance index counter to zero.
+     * This is useful when process.cwd() changes between strategy iterations to ensure
+     * that new IntervalFileInstance objects start with index 0 and do not collide with old instances.
+     */
+    resetCounter: () => void;
 }
 /**
  * Singleton instance of `IntervalUtils` for convenient once-per-interval signal firing.
@@ -25064,6 +25374,74 @@ declare class StrategyConnectionService implements TStrategy$1 {
         exchangeName: ExchangeName;
         frameName: FrameName;
     }) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the highest profit peak.
+     *
+     * Resolves current price via priceMetaService and delegates to
+     * ClientStrategy.getPositionHighestProfitDistancePnlPercentage().
+     * Returns null if no pending signal exists.
+     *
+     * @param backtest - Whether running in backtest mode
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, frameName
+     * @returns Promise resolving to drawdown distance in PnL% (≥ 0) or null
+     */
+    getPositionHighestProfitDistancePnlPercentage: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL cost between the current price and the highest profit peak.
+     *
+     * Resolves current price via priceMetaService and delegates to
+     * ClientStrategy.getPositionHighestProfitDistancePnlCost().
+     * Returns null if no pending signal exists.
+     *
+     * @param backtest - Whether running in backtest mode
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, frameName
+     * @returns Promise resolving to drawdown distance in PnL cost (≥ 0) or null
+     */
+    getPositionHighestProfitDistancePnlCost: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the worst drawdown trough.
+     *
+     * Resolves current price via priceMetaService and delegates to
+     * ClientStrategy.getPositionHighestMaxDrawdownPnlPercentage().
+     * Returns null if no pending signal exists.
+     *
+     * @param backtest - Whether running in backtest mode
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, frameName
+     * @returns Promise resolving to recovery distance in PnL% (≥ 0) or null
+     */
+    getPositionHighestMaxDrawdownPnlPercentage: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL cost between the current price and the worst drawdown trough.
+     *
+     * Resolves current price via priceMetaService and delegates to
+     * ClientStrategy.getPositionHighestMaxDrawdownPnlCost().
+     * Returns null if no pending signal exists.
+     *
+     * @param backtest - Whether running in backtest mode
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, frameName
+     * @returns Promise resolving to recovery distance in PnL cost (≥ 0) or null
+     */
+    getPositionHighestMaxDrawdownPnlCost: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number | null>;
     /**
      * Disposes the ClientStrategy instance for the given context.
      *
@@ -27235,6 +27613,70 @@ declare class StrategyCoreService implements TStrategy {
         exchangeName: ExchangeName;
         frameName: FrameName;
     }) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the highest profit peak.
+     *
+     * Delegates to StrategyConnectionService.getPositionHighestProfitDistancePnlPercentage().
+     * Returns null if no pending signal exists.
+     *
+     * @param backtest - Whether running in backtest mode
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, frameName
+     * @returns Promise resolving to drawdown distance in PnL% (≥ 0) or null
+     */
+    getPositionHighestProfitDistancePnlPercentage: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL cost between the current price and the highest profit peak.
+     *
+     * Delegates to StrategyConnectionService.getPositionHighestProfitDistancePnlCost().
+     * Returns null if no pending signal exists.
+     *
+     * @param backtest - Whether running in backtest mode
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, frameName
+     * @returns Promise resolving to drawdown distance in PnL cost (≥ 0) or null
+     */
+    getPositionHighestProfitDistancePnlCost: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL percentage between the current price and the worst drawdown trough.
+     *
+     * Delegates to StrategyConnectionService.getPositionHighestMaxDrawdownPnlPercentage().
+     * Returns null if no pending signal exists.
+     *
+     * @param backtest - Whether running in backtest mode
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, frameName
+     * @returns Promise resolving to recovery distance in PnL% (≥ 0) or null
+     */
+    getPositionHighestMaxDrawdownPnlPercentage: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number | null>;
+    /**
+     * Returns the distance in PnL cost between the current price and the worst drawdown trough.
+     *
+     * Delegates to StrategyConnectionService.getPositionHighestMaxDrawdownPnlCost().
+     * Returns null if no pending signal exists.
+     *
+     * @param backtest - Whether running in backtest mode
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, frameName
+     * @returns Promise resolving to recovery distance in PnL cost (≥ 0) or null
+     */
+    getPositionHighestMaxDrawdownPnlCost: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<number | null>;
 }
 
 /**
@@ -30086,4 +30528,4 @@ declare const getTotalClosed: (signal: Signal) => {
     remainingCostBasis: number;
 };
 
-export { ActionBase, type ActivateScheduledCommit, type ActivateScheduledCommitNotification, type ActivePingContract, type AverageBuyCommit, type AverageBuyCommitNotification, Backtest, type BacktestStatisticsModel, Breakeven, type BreakevenAvailableNotification, type BreakevenCommit, type BreakevenCommitNotification, type BreakevenContract, type BreakevenData, type BreakevenEvent, type BreakevenStatisticsModel, Broker, type BrokerAverageBuyPayload, BrokerBase, type BrokerBreakevenPayload, type BrokerPartialLossPayload, type BrokerPartialProfitPayload, type BrokerSignalClosePayload, type BrokerSignalOpenPayload, type BrokerTrailingStopPayload, type BrokerTrailingTakePayload, Cache, type CancelScheduledCommit, type CancelScheduledCommitNotification, type CandleData, type CandleInterval, type ClosePendingCommit, type ClosePendingCommitNotification, type ColumnConfig, type ColumnModel, Constant, type CriticalErrorNotification, type DoneContract, Dump, type EntityId, Exchange, ExecutionContextService, type FrameInterval, type GlobalConfig, Heat, type HeatmapStatisticsModel, HighestProfit, type HighestProfitContract, type HighestProfitEvent, type HighestProfitStatisticsModel, type IActionSchema, type IActivateScheduledCommitRow, type IAggregatedTradeData, type IBidData, type IBreakevenCommitRow, type IBroker, type ICandleData, type ICommitRow, type IDumpContext, type IDumpInstance, type IExchangeSchema, type IFrameSchema, type IHeatmapRow, type ILog, type ILogEntry, type ILogger, type IMarkdownDumpOptions, type IMemoryInstance, type INotificationUtils, type IOrderBookData, type IPartialLossCommitRow, type IPartialProfitCommitRow, type IPersistBase, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IPublicAction, type IPublicCandleData, type IPublicSignalRow, type IReportDumpOptions, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskSignalRow, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IScheduledSignalCancelRow, type IScheduledSignalRow, type ISignalDto, type ISignalRow, type ISizingCalculateParams, type ISizingCalculateParamsATR, type ISizingCalculateParamsFixedPercentage, type ISizingCalculateParamsKelly, type ISizingParams, type ISizingParamsATR, type ISizingParamsFixedPercentage, type ISizingParamsKelly, type ISizingSchema, type ISizingSchemaATR, type ISizingSchemaFixedPercentage, type ISizingSchemaKelly, type IStorageSignalRow, type IStorageUtils, type IStrategyPnL, type IStrategyResult, type IStrategySchema, type IStrategyTickResult, type IStrategyTickResultActive, type IStrategyTickResultCancelled, type IStrategyTickResultClosed, type IStrategyTickResultIdle, type IStrategyTickResultOpened, type IStrategyTickResultScheduled, type IStrategyTickResultWaiting, type ITrailingStopCommitRow, type ITrailingTakeCommitRow, type IWalkerResults, type IWalkerSchema, type IWalkerStrategyResult, type InfoErrorNotification, Interval, type IntervalData, Live, type LiveStatisticsModel, Log, type LogData, Markdown, MarkdownFileBase, MarkdownFolderBase, type MarkdownName, MarkdownWriter, MaxDrawdown, type MaxDrawdownContract, type MaxDrawdownEvent, type MaxDrawdownStatisticsModel, type MeasureData, Memory, type MemoryData, type MessageModel, type MessageRole, type MessageToolCall, MethodContextService, type MetricStats, Notification, NotificationBacktest, type NotificationData, NotificationLive, type NotificationModel, Partial$1 as Partial, type PartialData, type PartialEvent, type PartialLossAvailableNotification, type PartialLossCommit, type PartialLossCommitNotification, type PartialLossContract, type PartialProfitAvailableNotification, type PartialProfitCommit, type PartialProfitCommitNotification, type PartialProfitContract, type PartialStatisticsModel, Performance, type PerformanceContract, type PerformanceMetricType, type PerformanceStatisticsModel, PersistBase, PersistBreakevenAdapter, PersistCandleAdapter, PersistIntervalAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistMemoryAdapter, PersistNotificationAdapter, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PersistStorageAdapter, Position, PositionSize, type ProgressBacktestContract, type ProgressWalkerContract, Report, ReportBase, type ReportName, ReportWriter, Risk, type RiskContract, type RiskData, type RiskEvent, type RiskRejectionNotification, type RiskStatisticsModel, Schedule, type ScheduleData, type SchedulePingContract, type ScheduleStatisticsModel, type ScheduledEvent, type SignalCancelledNotification, type SignalCloseContract, type SignalClosedNotification, type SignalData, type SignalInterval, type SignalOpenContract, type SignalOpenedNotification, type SignalScheduledNotification, type SignalSyncCloseNotification, type SignalSyncContract, type SignalSyncOpenNotification, Storage, StorageBacktest, type StorageData, StorageLive, Strategy, type StrategyActionType, type StrategyCancelReason, type StrategyCloseReason, type StrategyCommitContract, type StrategyEvent, type StrategyStatisticsModel, Sync, type SyncEvent, type SyncStatisticsModel, type TBrokerCtor, type TDumpInstanceCtor, type TLogCtor, type TMarkdownBase, type TMemoryInstanceCtor, type TNotificationUtilsCtor, type TPersistBase, type TPersistBaseCtor, type TReportBase, type TStorageUtilsCtor, type TickEvent, type TrailingStopCommit, type TrailingStopCommitNotification, type TrailingTakeCommit, type TrailingTakeCommitNotification, type ValidationErrorNotification, Walker, type WalkerCompleteContract, type WalkerContract, type WalkerMetric, type SignalData$1 as WalkerSignalData, type WalkerStatisticsModel, addActionSchema, addExchangeSchema, addFrameSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, alignToInterval, checkCandles, commitActivateScheduled, commitAverageBuy, commitBreakeven, commitCancelScheduled, commitClosePending, commitPartialLoss, commitPartialLossCost, commitPartialProfit, commitPartialProfitCost, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, dumpAgentAnswer, dumpError, dumpJson, dumpRecord, dumpTable, dumpText, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionCountdownMinutes, getPositionDrawdownMinutes, getPositionEffectivePrice, getPositionEntries, getPositionEntryOverlap, getPositionEstimateMinutes, getPositionHighestPnlCost, getPositionHighestPnlPercentage, getPositionHighestProfitBreakeven, getPositionHighestProfitMinutes, getPositionHighestProfitPrice, getPositionHighestProfitTimestamp, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionMaxDrawdownMinutes, getPositionMaxDrawdownPnlCost, getPositionMaxDrawdownPnlPercentage, getPositionMaxDrawdownPrice, getPositionMaxDrawdownTimestamp, getPositionPartialOverlap, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getRawCandles, getRiskSchema, getScheduledSignal, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasNoPendingSignal, hasNoScheduledSignal, hasTradeContext, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listMemory, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenHighestProfit, listenHighestProfitOnce, listenMaxDrawdown, listenMaxDrawdownOnce, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, readMemory, removeMemory, roundTicks, runInMockContext, searchMemory, set, setColumns, setConfig, setLogger, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, validateCommonSignal, validatePendingSignal, validateScheduledSignal, validateSignal, waitForCandle, warmCandles, writeMemory };
+export { ActionBase, type ActivateScheduledCommit, type ActivateScheduledCommitNotification, type ActivePingContract, type AverageBuyCommit, type AverageBuyCommitNotification, Backtest, type BacktestStatisticsModel, Breakeven, type BreakevenAvailableNotification, type BreakevenCommit, type BreakevenCommitNotification, type BreakevenContract, type BreakevenData, type BreakevenEvent, type BreakevenStatisticsModel, Broker, type BrokerAverageBuyPayload, BrokerBase, type BrokerBreakevenPayload, type BrokerPartialLossPayload, type BrokerPartialProfitPayload, type BrokerSignalClosePayload, type BrokerSignalOpenPayload, type BrokerTrailingStopPayload, type BrokerTrailingTakePayload, Cache, type CancelScheduledCommit, type CancelScheduledCommitNotification, type CandleData, type CandleInterval, type ClosePendingCommit, type ClosePendingCommitNotification, type ColumnConfig, type ColumnModel, Constant, type CriticalErrorNotification, type DoneContract, Dump, type EntityId, Exchange, ExecutionContextService, type FrameInterval, type GlobalConfig, Heat, type HeatmapStatisticsModel, HighestProfit, type HighestProfitContract, type HighestProfitEvent, type HighestProfitStatisticsModel, type IActionSchema, type IActivateScheduledCommitRow, type IAggregatedTradeData, type IBidData, type IBreakevenCommitRow, type IBroker, type ICandleData, type ICommitRow, type IDumpContext, type IDumpInstance, type IExchangeSchema, type IFrameSchema, type IHeatmapRow, type ILog, type ILogEntry, type ILogger, type IMarkdownDumpOptions, type IMemoryInstance, type INotificationUtils, type IOrderBookData, type IPartialLossCommitRow, type IPartialProfitCommitRow, type IPersistBase, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IPublicAction, type IPublicCandleData, type IPublicSignalRow, type IReportDumpOptions, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskSignalRow, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IScheduledSignalCancelRow, type IScheduledSignalRow, type ISignalDto, type ISignalIntervalDto, type ISignalRow, type ISizingCalculateParams, type ISizingCalculateParamsATR, type ISizingCalculateParamsFixedPercentage, type ISizingCalculateParamsKelly, type ISizingParams, type ISizingParamsATR, type ISizingParamsFixedPercentage, type ISizingParamsKelly, type ISizingSchema, type ISizingSchemaATR, type ISizingSchemaFixedPercentage, type ISizingSchemaKelly, type IStorageSignalRow, type IStorageUtils, type IStrategyPnL, type IStrategyResult, type IStrategySchema, type IStrategyTickResult, type IStrategyTickResultActive, type IStrategyTickResultCancelled, type IStrategyTickResultClosed, type IStrategyTickResultIdle, type IStrategyTickResultOpened, type IStrategyTickResultScheduled, type IStrategyTickResultWaiting, type ITrailingStopCommitRow, type ITrailingTakeCommitRow, type IWalkerResults, type IWalkerSchema, type IWalkerStrategyResult, type InfoErrorNotification, Interval, type IntervalData, Live, type LiveStatisticsModel, Log, type LogData, Markdown, MarkdownFileBase, MarkdownFolderBase, type MarkdownName, MarkdownWriter, MaxDrawdown, type MaxDrawdownContract, type MaxDrawdownEvent, type MaxDrawdownStatisticsModel, type MeasureData, Memory, type MemoryData, type MessageModel, type MessageRole, type MessageToolCall, MethodContextService, type MetricStats, Notification, NotificationBacktest, type NotificationData, NotificationLive, type NotificationModel, Partial$1 as Partial, type PartialData, type PartialEvent, type PartialLossAvailableNotification, type PartialLossCommit, type PartialLossCommitNotification, type PartialLossContract, type PartialProfitAvailableNotification, type PartialProfitCommit, type PartialProfitCommitNotification, type PartialProfitContract, type PartialStatisticsModel, Performance, type PerformanceContract, type PerformanceMetricType, type PerformanceStatisticsModel, PersistBase, PersistBreakevenAdapter, PersistCandleAdapter, PersistIntervalAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistMemoryAdapter, PersistNotificationAdapter, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PersistStorageAdapter, Position, PositionSize, type ProgressBacktestContract, type ProgressWalkerContract, Report, ReportBase, type ReportName, ReportWriter, Risk, type RiskContract, type RiskData, type RiskEvent, type RiskRejectionNotification, type RiskStatisticsModel, Schedule, type ScheduleData, type SchedulePingContract, type ScheduleStatisticsModel, type ScheduledEvent, type SignalCancelledNotification, type SignalCloseContract, type SignalClosedNotification, type SignalData, type SignalInterval, type SignalOpenContract, type SignalOpenedNotification, type SignalScheduledNotification, type SignalSyncCloseNotification, type SignalSyncContract, type SignalSyncOpenNotification, Storage, StorageBacktest, type StorageData, StorageLive, Strategy, type StrategyActionType, type StrategyCancelReason, type StrategyCloseReason, type StrategyCommitContract, type StrategyEvent, type StrategyStatisticsModel, Sync, type SyncEvent, type SyncStatisticsModel, type TBrokerCtor, type TDumpInstanceCtor, type TLogCtor, type TMarkdownBase, type TMemoryInstanceCtor, type TNotificationUtilsCtor, type TPersistBase, type TPersistBaseCtor, type TReportBase, type TStorageUtilsCtor, type TickEvent, type TrailingStopCommit, type TrailingStopCommitNotification, type TrailingTakeCommit, type TrailingTakeCommitNotification, type ValidationErrorNotification, Walker, type WalkerCompleteContract, type WalkerContract, type WalkerMetric, type SignalData$1 as WalkerSignalData, type WalkerStatisticsModel, addActionSchema, addExchangeSchema, addFrameSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, alignToInterval, checkCandles, commitActivateScheduled, commitAverageBuy, commitBreakeven, commitCancelScheduled, commitClosePending, commitPartialLoss, commitPartialLossCost, commitPartialProfit, commitPartialProfitCost, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, dumpAgentAnswer, dumpError, dumpJson, dumpRecord, dumpTable, dumpText, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionCountdownMinutes, getPositionDrawdownMinutes, getPositionEffectivePrice, getPositionEntries, getPositionEntryOverlap, getPositionEstimateMinutes, getPositionHighestMaxDrawdownPnlCost, getPositionHighestMaxDrawdownPnlPercentage, getPositionHighestPnlCost, getPositionHighestPnlPercentage, getPositionHighestProfitBreakeven, getPositionHighestProfitDistancePnlCost, getPositionHighestProfitDistancePnlPercentage, getPositionHighestProfitMinutes, getPositionHighestProfitPrice, getPositionHighestProfitTimestamp, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionMaxDrawdownMinutes, getPositionMaxDrawdownPnlCost, getPositionMaxDrawdownPnlPercentage, getPositionMaxDrawdownPrice, getPositionMaxDrawdownTimestamp, getPositionPartialOverlap, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getRawCandles, getRiskSchema, getScheduledSignal, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasNoPendingSignal, hasNoScheduledSignal, hasTradeContext, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listMemory, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenHighestProfit, listenHighestProfitOnce, listenMaxDrawdown, listenMaxDrawdownOnce, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, readMemory, removeMemory, roundTicks, runInMockContext, searchMemory, set, setColumns, setConfig, setLogger, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, validateCommonSignal, validatePendingSignal, validateScheduledSignal, validateSignal, waitForCandle, warmCandles, writeMemory };