backtest-kit 9.0.0 → 9.0.2

package/types.d.ts

@@ -9593,15 +9593,23 @@ interface IStateInstance {
     waitForInit(initial: boolean): Promise<void>;
     /**
      * Read the current state value.
+     * Returns `initialValue` when the stored `when` is greater than the requested `when`
+     * (look-ahead bias protection).
+     * @param when - Logical timestamp at which the read is happening
      * @returns Current state value
      */
-    getState<Value extends object = object>(): Promise<Value>;
+    getState<Value extends object = object>(when: Date): Promise<Value>;
     /**
      * Update the state value.
+     * A write with a smaller `when` overwrites an existing record —
+     * that lets a restarted backtest reset live-written state without breaking live.
+     * The dispatch updater receives the look-ahead-guarded current value
+     * (or `initialValue` when the stored `when` is in the future).
      * @param dispatch - New value or updater function receiving current value
+     * @param when - Logical timestamp this value belongs to
      * @returns Updated state value
      */
-    setState<Value extends object = object>(dispatch: Value | Dispatch<Value>): Promise<Value>;
+    setState<Value extends object = object>(dispatch: Value | Dispatch<Value>, when: Date): Promise<Value>;
     /**
      * Releases any resources held by this instance.
      */
@@ -9650,12 +9658,14 @@ declare class StateBacktestAdapter implements TStateAdapter {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.initialValue - Default value when no persisted state exists
+     * @param dto.when - Logical timestamp at which the read is happening (look-ahead guard)
      * @returns Current state value
      */
     getState: <Value extends object = object>(dto: {
         signalId: string;
         bucketName: BucketName;
         initialValue: object;
+        when: Date;
     }) => Promise<Value>;
     /**
      * Update the state value for a signal.
@@ -9663,12 +9673,14 @@ declare class StateBacktestAdapter implements TStateAdapter {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.initialValue - Default value when no persisted state exists
+     * @param dto.when - Logical timestamp this value belongs to
      * @returns Updated state value
      */
     setState: <Value extends object = object>(dispatch: Value | Dispatch<Value>, dto: {
         signalId: string;
         bucketName: BucketName;
         initialValue: object;
+        when: Date;
     }) => Promise<Value>;
     /**
      * Switches to in-memory adapter (default).
@@ -9727,12 +9739,14 @@ declare class StateLiveAdapter implements TStateAdapter {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.initialValue - Default value when no persisted state exists
+     * @param dto.when - Logical timestamp at which the read is happening (look-ahead guard)
      * @returns Current state value
      */
     getState: <Value extends object = object>(dto: {
         signalId: string;
         bucketName: BucketName;
         initialValue: object;
+        when: Date;
     }) => Promise<Value>;
     /**
      * Update the state value for a signal.
@@ -9740,12 +9754,14 @@ declare class StateLiveAdapter implements TStateAdapter {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.initialValue - Default value when no persisted state exists
+     * @param dto.when - Logical timestamp this value belongs to
      * @returns Updated state value
      */
     setState: <Value extends object = object>(dispatch: Value | Dispatch<Value>, dto: {
         signalId: string;
         bucketName: BucketName;
         initialValue: object;
+        when: Date;
     }) => Promise<Value>;
     /**
      * Switches to in-memory adapter.
@@ -9804,6 +9820,7 @@ declare class StateAdapter {
      * @param dto.bucketName - Bucket name
      * @param dto.initialValue - Default value when no persisted state exists
      * @param dto.backtest - Flag indicating if the context is backtest or live
+     * @param dto.when - Logical timestamp at which the read is happening (look-ahead guard)
      * @returns Current state value
      * @throws Error if adapter is not enabled
      */
@@ -9812,6 +9829,7 @@ declare class StateAdapter {
         bucketName: BucketName;
         initialValue: object;
         backtest: boolean;
+        when: Date;
     }) => Promise<Value>;
     /**
      * Update the state value for a signal.
@@ -9821,6 +9839,7 @@ declare class StateAdapter {
      * @param dto.bucketName - Bucket name
      * @param dto.initialValue - Default value when no persisted state exists
      * @param dto.backtest - Flag indicating if the context is backtest or live
+     * @param dto.when - Logical timestamp this value belongs to
      * @returns Updated state value
      * @throws Error if adapter is not enabled
      */
@@ -9829,6 +9848,7 @@ declare class StateAdapter {
         bucketName: BucketName;
         initialValue: object;
         backtest: boolean;
+        when: Date;
     }) => Promise<Value>;
 }
 /**
@@ -12827,6 +12847,7 @@ type MeasureData = {
 type IntervalData = {
     id: string;
     data: unknown;
+    when: Date;
     removed: boolean;
 };
 /**
@@ -14532,7 +14553,7 @@ interface IPersistMeasureInstance {
      * @param key - Cache key within the bucket
      * @returns Promise that resolves when write is complete
      */
-    writeMeasureData(data: MeasureData, key: string): Promise<void>;
+    writeMeasureData(data: MeasureData, key: string, when: Date): Promise<void>;
     /**
      * Soft-delete an entry by setting its `removed` flag.
      * File stays on disk, but subsequent reads return null.
@@ -14662,7 +14683,7 @@ declare class PersistMeasureUtils {
      * @param key - Cache key within the bucket
      * @returns Promise that resolves when write is complete
      */
-    writeMeasureData: (data: MeasureData, bucket: string, key: string) => Promise<void>;
+    writeMeasureData: (data: MeasureData, bucket: string, key: string, when: Date) => Promise<void>;
     /**
      * Soft-deletes a measure entry in the given bucket by setting `removed: true`.
      * Lazily initializes the bucket instance on first access.
@@ -14732,7 +14753,7 @@ interface IPersistIntervalInstance {
      * @param key - Marker key within the bucket
      * @returns Promise that resolves when write is complete
      */
-    writeIntervalData(data: IntervalData, key: string): Promise<void>;
+    writeIntervalData(data: IntervalData, key: string, when: Date): Promise<void>;
     /**
      * Soft-delete a marker. After this call the function will fire again
      * on the next IntervalFileInstance.run call for the same key.
@@ -14859,7 +14880,7 @@ declare class PersistIntervalUtils {
      * @param key - Marker key within the bucket
      * @returns Promise that resolves when write is complete
      */
-    writeIntervalData: (data: IntervalData, bucket: string, key: string) => Promise<void>;
+    writeIntervalData: (data: IntervalData, bucket: string, key: string, when: Date) => Promise<void>;
     /**
      * Soft-deletes a marker in the given bucket by setting `removed: true`.
      * Lazily initializes the bucket instance on first access.
@@ -14905,6 +14926,7 @@ type MemoryData = {
     data: object;
     removed: boolean;
     index: string;
+    when: number;
 };
 /**
  * Per-context memory entry persistence instance interface.
@@ -14942,11 +14964,12 @@ interface IPersistMemoryInstance {
     /**
      * Write a memory entry.
      *
-     * @param data - Entry data to persist
+     * @param data - Entry data to persist (already carries `data.when`)
      * @param memoryId - Memory entry identifier
+     * @param when - Logical timestamp this entry belongs to (duplicates `data.when` for API consistency)
      * @returns Promise that resolves when write is complete
      */
-    writeMemoryData(data: MemoryData, memoryId: string): Promise<void>;
+    writeMemoryData(data: MemoryData, memoryId: string, when: Date): Promise<void>;
     /**
      * Soft-delete a memory entry. File stays on disk; subsequent reads return null.
      *
@@ -15027,7 +15050,7 @@ declare class PersistMemoryInstance implements IPersistMemoryInstance {
      * @param memoryId - Memory entry identifier
      * @returns Promise that resolves when write is complete
      */
-    writeMemoryData(data: MemoryData, memoryId: string): Promise<void>;
+    writeMemoryData(data: MemoryData, memoryId: string, _when: Date): Promise<void>;
     /**
      * Soft-deletes a memory entry by writing `removed: true` flag.
      *
@@ -15120,13 +15143,14 @@ declare class PersistMemoryUtils {
      * Writes a memory entry for the given context.
      * Lazily initializes the instance on first access.
      *
-     * @param data - Entry data to persist
+     * @param data - Entry data to persist (already carries `data.when`)
      * @param signalId - Signal identifier
      * @param bucketName - Bucket name
      * @param memoryId - Memory entry identifier
+     * @param when - Logical timestamp this entry belongs to (duplicates `data.when` for API consistency)
      * @returns Promise that resolves when write is complete
      */
-    writeMemoryData: (data: MemoryData, signalId: string, bucketName: string, memoryId: string) => Promise<void>;
+    writeMemoryData: (data: MemoryData, signalId: string, bucketName: string, memoryId: string, when: Date) => Promise<void>;
     /**
      * Soft-deletes a memory entry for the given context.
      * Lazily initializes the instance on first access.
@@ -15219,10 +15243,11 @@ interface IPersistRecentInstance {
     /**
      * Write the latest recent signal for this context.
      *
-     * @param signalRow - Recent signal data to persist
+     * @param signalRow - Recent signal data to persist (already carries `signalRow.timestamp`)
+     * @param when - Logical timestamp this signal belongs to (duplicates `signalRow.timestamp` for API consistency)
      * @returns Promise that resolves when write is complete
      */
-    writeRecentData(signalRow: IPublicSignalRow): Promise<void>;
+    writeRecentData(signalRow: IPublicSignalRow, when: Date): Promise<void>;
 }
 /**
  * Default file-based implementation of IPersistRecentInstance.
@@ -15277,7 +15302,7 @@ declare class PersistRecentInstance implements IPersistRecentInstance {
      * @param signalRow - Recent signal data to persist
      * @returns Promise that resolves when write is complete
      */
-    writeRecentData(signalRow: IPublicSignalRow): Promise<void>;
+    writeRecentData(signalRow: IPublicSignalRow, _when: Date): Promise<void>;
 }
 /**
  * Constructor type for IPersistRecentInstance.
@@ -15340,15 +15365,16 @@ declare class PersistRecentUtils {
      * Writes the latest recent signal for the given context.
      * Lazily initializes the instance on first access.
      *
-     * @param signalRow - Recent signal data to persist
+     * @param signalRow - Recent signal data to persist (already carries `signalRow.timestamp`)
      * @param symbol - Trading pair symbol
      * @param strategyName - Strategy identifier
      * @param exchangeName - Exchange identifier
      * @param frameName - Frame identifier (may be empty)
      * @param backtest - True for backtest mode, false for live mode
+     * @param when - Logical timestamp this signal belongs to (duplicates `signalRow.timestamp` for API consistency)
      * @returns Promise that resolves when write is complete
      */
-    writeRecentData: (signalRow: IPublicSignalRow, symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean) => Promise<void>;
+    writeRecentData: (signalRow: IPublicSignalRow, symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean, when: Date) => Promise<void>;
     /**
      * Clears the memoized instance cache.
      * Call when process.cwd() changes between strategy iterations.
@@ -15375,6 +15401,7 @@ declare const PersistRecentAdapter: PersistRecentUtils;
 type StateData = {
     id: string;
     data: object;
+    when: number;
 };
 /**
  * Per-context state persistence instance interface.
@@ -15401,10 +15428,11 @@ interface IPersistStateInstance {
     /**
      * Write state for this context.
      *
-     * @param data - State data to persist
+     * @param data - State data to persist (already carries `data.when`)
+     * @param when - Logical timestamp this value belongs to (duplicates `data.when` for API consistency)
      * @returns Promise that resolves when write is complete
      */
-    writeStateData(data: StateData): Promise<void>;
+    writeStateData(data: StateData, when: Date): Promise<void>;
     /**
      * Release any resources held by this instance.
      * Default implementations may treat this as a no-op.
@@ -15458,7 +15486,7 @@ declare class PersistStateInstance implements IPersistStateInstance {
      * @param data - State data to persist
      * @returns Promise that resolves when write is complete
      */
-    writeStateData(data: StateData): Promise<void>;
+    writeStateData(data: StateData, _when: Date): Promise<void>;
     /**
      * No-op for the default file-based implementation.
      * Resource cleanup (memo cache invalidation) is handled by PersistStateUtils.dispose().
@@ -15522,12 +15550,13 @@ declare class PersistStateUtils {
      * Writes state for the given context.
      * Lazily initializes the instance on first access.
      *
-     * @param data - State data to persist
+     * @param data - State data to persist (already carries `data.when`)
      * @param signalId - Signal identifier
      * @param bucketName - Bucket name
+     * @param when - Logical timestamp this value belongs to (duplicates `data.when` for API consistency)
      * @returns Promise that resolves when write is complete
      */
-    writeStateData: (data: StateData, signalId: string, bucketName: string) => Promise<void>;
+    writeStateData: (data: StateData, signalId: string, bucketName: string, when: Date) => Promise<void>;
     /**
      * Switches to PersistStateDummyInstance (all operations are no-ops).
      */
@@ -15562,6 +15591,7 @@ declare const PersistStateAdapter: PersistStateUtils;
 type SessionData = {
     id: string;
     data: object | null;
+    when: number;
 };
 /**
  * Per-context session persistence instance interface.
@@ -15588,10 +15618,11 @@ interface IPersistSessionInstance {
     /**
      * Write session data for this context.
      *
-     * @param data - Session data to persist
+     * @param data - Session data to persist (already carries `data.when`)
+     * @param when - Logical timestamp this value belongs to (duplicates `data.when` for API consistency)
      * @returns Promise that resolves when write is complete
      */
-    writeSessionData(data: SessionData): Promise<void>;
+    writeSessionData(data: SessionData, when: Date): Promise<void>;
     /**
      * Release any resources held by this instance.
      * Default implementations may treat this as a no-op.
@@ -15647,7 +15678,7 @@ declare class PersistSessionInstance implements IPersistSessionInstance {
      * @param data - Session data to persist
      * @returns Promise that resolves when write is complete
      */
-    writeSessionData(data: SessionData): Promise<void>;
+    writeSessionData(data: SessionData, _when: Date): Promise<void>;
     /**
      * No-op for the default file-based implementation.
      * Resource cleanup (memo cache invalidation) is handled by PersistSessionUtils.dispose().
@@ -15714,13 +15745,14 @@ declare class PersistSessionUtils {
      * Writes session data for the given context.
      * Lazily initializes the instance on first access.
      *
-     * @param data - Session data to persist
+     * @param data - Session data to persist (already carries `data.when`)
      * @param strategyName - Strategy identifier
      * @param exchangeName - Exchange identifier
      * @param frameName - Frame identifier
+     * @param when - Logical timestamp this value belongs to (duplicates `data.when` for API consistency)
      * @returns Promise that resolves when write is complete
      */
-    writeSessionData: (data: SessionData, strategyName: string, exchangeName: string, frameName: string) => Promise<void>;
+    writeSessionData: (data: SessionData, strategyName: string, exchangeName: string, frameName: string, when: Date) => Promise<void>;
     /**
      * Switches to PersistSessionDummyInstance (all operations are no-ops).
      */
@@ -16628,13 +16660,19 @@ interface ISessionInstance {
     /**
      * Write a new session value.
      * @param value - New value or null to clear
+     * @param when - Logical timestamp this value belongs to.
+     *               A write with a smaller `when` overwrites an existing record —
+     *               that lets a restarted backtest reset live-written state.
      */
-    setData<Value extends object = object>(value: Value | null): Promise<void>;
+    setData<Value extends object = object>(value: Value | null, when: Date): Promise<void>;
     /**
      * Read the current session value.
-     * @returns Current session value, or null if not set
+     * Returns null when the stored `when` is greater than the requested `when`
+     * (look-ahead bias protection).
+     * @param when - Logical timestamp at which the read is happening
+     * @returns Current session value, or null if not set / look-ahead
      */
-    getData<Value extends object = object>(): Promise<Value | null>;
+    getData<Value extends object = object>(when: Date): Promise<Value | null>;
     /**
      * Releases any resources held by this instance.
      */
@@ -16671,13 +16709,14 @@ declare class SessionBacktestAdapter implements TSessionAdapter {
      * @param context.strategyName - Strategy identifier
      * @param context.exchangeName - Exchange identifier
      * @param context.frameName - Frame identifier
-     * @returns Current session value, or null if not set
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
+     * @returns Current session value, or null if not set / look-ahead
      */
     getData: <Value extends object = object>(symbol: string, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }) => Promise<Value | null>;
+    }, when: Date) => Promise<Value | null>;
     /**
      * Update the session value for a backtest run.
      * @param symbol - Trading pair symbol
@@ -16685,12 +16724,13 @@ declare class SessionBacktestAdapter implements TSessionAdapter {
      * @param context.strategyName - Strategy identifier
      * @param context.exchangeName - Exchange identifier
      * @param context.frameName - Frame identifier
+     * @param when - Logical timestamp this value belongs to
      */
     setData: <Value extends object = object>(symbol: string, value: Value | null, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }) => Promise<void>;
+    }, when: Date) => Promise<void>;
     /**
      * Switches to in-memory adapter (default).
      * All data lives in process memory only.
@@ -16736,13 +16776,14 @@ declare class SessionLiveAdapter implements TSessionAdapter {
      * @param context.strategyName - Strategy identifier
      * @param context.exchangeName - Exchange identifier
      * @param context.frameName - Frame identifier
-     * @returns Current session value, or null if not set
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
+     * @returns Current session value, or null if not set / look-ahead
      */
     getData: <Value extends object = object>(symbol: string, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }) => Promise<Value | null>;
+    }, when: Date) => Promise<Value | null>;
     /**
      * Update the session value for a live run.
      * @param symbol - Trading pair symbol
@@ -16750,12 +16791,13 @@ declare class SessionLiveAdapter implements TSessionAdapter {
      * @param context.strategyName - Strategy identifier
      * @param context.exchangeName - Exchange identifier
      * @param context.frameName - Frame identifier
+     * @param when - Logical timestamp this value belongs to
      */
     setData: <Value extends object = object>(symbol: string, value: Value | null, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }) => Promise<void>;
+    }, when: Date) => Promise<void>;
     /**
      * Switches to in-memory adapter.
      * All data lives in process memory only.
@@ -16797,13 +16839,14 @@ declare class SessionAdapter {
      * @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
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
+     * @returns Current session value, or null if not set / look-ahead
      */
     getData: <Value extends object = object>(symbol: string, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }, backtest: boolean) => Promise<Value | null>;
+    }, backtest: boolean, when: Date) => Promise<Value | null>;
     /**
      * Update the session value for a signal.
      * Routes to SessionBacktest or SessionLive based on backtest.
@@ -16813,12 +16856,13 @@ declare class SessionAdapter {
      * @param context.exchangeName - Exchange identifier
      * @param context.frameName - Frame identifier
      * @param backtest - Flag indicating if the context is backtest or live
+     * @param when - Logical timestamp this value belongs to
      */
     setData: <Value extends object = object>(symbol: string, value: Value | null, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }, backtest: boolean) => Promise<void>;
+    }, backtest: boolean, when: Date) => Promise<void>;
 }
 /**
  * Global singleton instance of SessionAdapter.
@@ -23707,23 +23751,28 @@ interface IRecentUtils {
     handleActivePing(event: ActivePingContract): Promise<void>;
     /**
      * Retrieves the latest active signal for the given context.
+     * Returns null if the stored signal's `timestamp` is greater than the requested `when`
+     * (look-ahead bias protection).
      * @param symbol - Trading pair symbol
      * @param strategyName - Strategy identifier
      * @param exchangeName - Exchange identifier
      * @param frameName - Frame identifier
      * @param backtest - Flag indicating if the context is backtest or live
-     * @returns The latest signal or null if not found
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
+     * @returns The latest signal or null if not found / shadowed by look-ahead
      */
-    getLatestSignal(symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean): Promise<IPublicSignalRow | null>;
+    getLatestSignal(symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean, when: Date): Promise<IPublicSignalRow | null>;
     /**
      * Returns the number of minutes elapsed since the latest signal's timestamp.
+     * `timestamp` doubles as the look-ahead cutoff — a signal whose `timestamp`
+     * exceeds the requested one is treated as not yet visible.
+     * @param timestamp - Current timestamp in milliseconds (also serves as look-ahead cutoff)
      * @param symbol - Trading pair symbol
      * @param strategyName - Strategy identifier
      * @param exchangeName - Exchange identifier
      * @param frameName - Frame identifier
      * @param backtest - Flag indicating if the context is backtest or live
-     * @param currentTimestamp - Current timestamp in milliseconds
-     * @returns Minutes since the latest signal, or null if no signal found
+     * @returns Minutes since the latest signal, or null if no signal found / shadowed by look-ahead
      */
     getMinutesSinceLatestSignalCreated(timestamp: number, symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean): Promise<number | null>;
 }
@@ -23757,19 +23806,22 @@ declare class RecentBacktestAdapter implements IRecentUtils {
      * @param exchangeName - Exchange identifier
      * @param frameName - Frame identifier
      * @param backtest - Flag indicating if the context is backtest or live
-     * @returns The latest signal or null if not found
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
+     * @returns The latest signal or null if not found / shadowed by look-ahead
      */
-    getLatestSignal: (symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean) => Promise<IPublicSignalRow | null>;
+    getLatestSignal: (symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean, when: Date) => Promise<IPublicSignalRow | null>;
     /**
      * Returns the number of whole minutes elapsed since the latest signal's creation timestamp.
-     * Proxies call to the underlying storage adapter.
-     * @param timestamp - Current timestamp in milliseconds
+     * Proxies call to the underlying storage adapter. `timestamp` doubles as the
+     * look-ahead cutoff — a signal whose `timestamp` exceeds the requested one is
+     * treated as not yet visible.
+     * @param timestamp - Current timestamp in milliseconds (also serves as look-ahead cutoff)
      * @param symbol - Trading pair symbol
      * @param strategyName - Strategy identifier
      * @param exchangeName - Exchange identifier
      * @param frameName - Frame identifier
      * @param backtest - Flag indicating if the context is backtest or live
-     * @returns Whole minutes since the latest signal was created, or null if no signal found
+     * @returns Whole minutes since the latest signal was created, or null if no signal found / shadowed by look-ahead
      */
     getMinutesSinceLatestSignalCreated: (timestamp: number, symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean) => Promise<number | null>;
     /**
@@ -23819,19 +23871,22 @@ declare class RecentLiveAdapter implements IRecentUtils {
      * @param exchangeName - Exchange identifier
      * @param frameName - Frame identifier
      * @param backtest - Flag indicating if the context is backtest or live
-     * @returns The latest signal or null if not found
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
+     * @returns The latest signal or null if not found / shadowed by look-ahead
      */
-    getLatestSignal: (symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean) => Promise<IPublicSignalRow | null>;
+    getLatestSignal: (symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean, when: Date) => Promise<IPublicSignalRow | null>;
     /**
      * Returns the number of whole minutes elapsed since the latest signal's creation timestamp.
-     * Proxies call to the underlying storage adapter.
-     * @param timestamp - Current timestamp in milliseconds
+     * Proxies call to the underlying storage adapter. `timestamp` doubles as the
+     * look-ahead cutoff — a signal whose `timestamp` exceeds the requested one is
+     * treated as not yet visible.
+     * @param timestamp - Current timestamp in milliseconds (also serves as look-ahead cutoff)
      * @param symbol - Trading pair symbol
      * @param strategyName - Strategy identifier
      * @param exchangeName - Exchange identifier
      * @param frameName - Frame identifier
      * @param backtest - Flag indicating if the context is backtest or live
-     * @returns Whole minutes since the latest signal was created, or null if no signal found
+     * @returns Whole minutes since the latest signal was created, or null if no signal found / shadowed by look-ahead
      */
     getMinutesSinceLatestSignalCreated: (timestamp: number, symbol: string, strategyName: StrategyName, exchangeName: ExchangeName, frameName: FrameName, backtest: boolean) => Promise<number | null>;
     /**
@@ -23880,32 +23935,37 @@ declare class RecentAdapter {
     /**
      * Retrieves the latest active signal for the given symbol and context.
      * Searches backtest storage first, then live storage.
+     * Returns null if the stored signal's `timestamp` is greater than the requested `when`
+     * (look-ahead bias protection).
      *
      * @param symbol - Trading pair symbol
      * @param context - Execution context with strategyName, exchangeName, and frameName
-     * @param backtest - Flag indicating if the context is backtest or live
-     * @returns The latest signal or null if not found
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
+     * @returns The latest signal or null if not found / shadowed by look-ahead
      * @throws Error if RecentAdapter is not enabled
      */
     getLatestSignal: (symbol: string, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }) => Promise<IPublicSignalRow | null>;
+    }, when: Date) => Promise<IPublicSignalRow | null>;
     /**
      * Returns the number of whole minutes elapsed since the latest signal's creation timestamp.
      * Searches backtest storage first, then live storage.
-     * @param timestamp - Current timestamp in milliseconds
+     * `when` doubles as the look-ahead cutoff — a signal whose `timestamp` exceeds
+     * `when.getTime()` is treated as not yet visible — and as the "now" against
+     * which elapsed minutes are computed.
      * @param symbol - Trading pair symbol
      * @param context - Execution context with strategyName, exchangeName, and frameName
-     * @returns Whole minutes since the latest signal was created, or null if no signal found
+     * @param when - Logical timestamp at which the read is happening (look-ahead cutoff + "now")
+     * @returns Whole minutes since the latest signal was created, or null if no signal found / shadowed by look-ahead
      * @throws Error if RecentAdapter is not enabled
      */
     getMinutesSinceLatestSignalCreated: (symbol: string, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }) => Promise<number | null>;
+    }, when: Date) => Promise<number | null>;
 }
 /**
  * Global singleton instance of RecentAdapter.
@@ -24400,38 +24460,46 @@ interface IMemoryInstance {
      * @param memoryId - Unique entry identifier
      * @param value - Value to store
      * @param description - Optional BM25 index string; defaults to JSON.stringify(value)
+     * @param when - Logical timestamp this entry belongs to (look-ahead guard)
      */
-    writeMemory<T extends object = object>(memoryId: string, value: T, description: string): Promise<void>;
+    writeMemory<T extends object = object>(memoryId: string, value: T, description: string, when: Date): Promise<void>;
     /**
      * Search memory using BM25 full-text scoring.
+     * Filters out entries whose `when` is greater than the requested `when`.
      * @param query - Search query string
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
      * @returns Array of matching entries with scores
      */
-    searchMemory<T extends object = object>(query: string, settings?: SearchSettings): Promise<Array<{
+    searchMemory<T extends object = object>(query: string, when: Date, settings?: SearchSettings): Promise<Array<{
         memoryId: string;
         score: number;
         content: T;
     }>>;
     /**
      * List all entries in memory.
+     * Filters out entries whose `when` is greater than the requested `when`.
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
      * @returns Array of all stored entries
      */
-    listMemory<T extends object = object>(): Promise<Array<{
+    listMemory<T extends object = object>(when: Date): Promise<Array<{
         memoryId: string;
         content: T;
     }>>;
     /**
      * Remove an entry from memory.
      * @param memoryId - Unique entry identifier
+     * @param when - Logical timestamp (kept for API consistency; removal is by UUID)
      */
-    removeMemory(memoryId: string): Promise<void>;
+    removeMemory(memoryId: string, when: Date): Promise<void>;
     /**
      * Read a single entry from memory.
+     * Behaves as not-found if the stored `when` is greater than the requested `when`.
      * @param memoryId - Unique entry identifier
+     * @param when - Logical timestamp at which the read is happening (look-ahead guard)
      * @returns Entry value
-     * @throws Error if entry not found
+     * @throws Error if entry not found (or shadowed by look-ahead)
      */
-    readMemory<T extends object = object>(memoryId: string): Promise<T>;
+    readMemory<T extends object = object>(memoryId: string, when: Date): Promise<T>;
     /**
      * Releases any resources held by this instance.
      */
@@ -24480,6 +24548,7 @@ declare class MemoryBacktestAdapter implements TMemoryInstance {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.description - BM25 index string; defaults to JSON.stringify(value)
+     * @param dto.when - Logical timestamp this entry belongs to (look-ahead guard)
      */
     writeMemory: <T extends object = object>(dto: {
         memoryId: string;
@@ -24487,18 +24556,21 @@ declare class MemoryBacktestAdapter implements TMemoryInstance {
         signalId: string;
         bucketName: string;
         description: string;
+        when: Date;
     }) => Promise<void>;
     /**
      * Search memory using BM25 full-text scoring.
      * @param dto.query - Search query string
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
+     * @param dto.when - Logical timestamp at which the search is happening (look-ahead guard)
      * @returns Matching entries sorted by relevance score
      */
     searchMemory: <T extends object = object>(dto: {
         query: string;
         signalId: string;
         bucketName: string;
+        when: Date;
         settings?: SearchSettings;
     }) => Promise<{
         memoryId: string;
@@ -24509,11 +24581,13 @@ declare class MemoryBacktestAdapter implements TMemoryInstance {
      * List all entries in memory.
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
+     * @param dto.when - Logical timestamp at which the list is happening (look-ahead guard)
      * @returns Array of all stored entries
      */
     listMemory: <T extends object = object>(dto: {
         signalId: string;
         bucketName: string;
+        when: Date;
     }) => Promise<{
         memoryId: string;
         content: T;
@@ -24523,17 +24597,20 @@ declare class MemoryBacktestAdapter implements TMemoryInstance {
      * @param dto.memoryId - Unique entry identifier
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
+     * @param dto.when - Logical timestamp (kept for API consistency; removal is by UUID)
      */
     removeMemory: (dto: {
         memoryId: string;
         signalId: string;
         bucketName: string;
+        when: Date;
     }) => Promise<void>;
     /**
      * Read a single entry from memory.
      * @param dto.memoryId - Unique entry identifier
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
+     * @param dto.when - Logical timestamp at which the read is happening (look-ahead guard)
      * @returns Entry value
      * @throws Error if entry not found
      */
@@ -24541,6 +24618,7 @@ declare class MemoryBacktestAdapter implements TMemoryInstance {
         memoryId: string;
         signalId: string;
         bucketName: string;
+        when: Date;
     }) => Promise<T>;
     /**
      * Switches to in-memory BM25 adapter (default).
@@ -24596,6 +24674,7 @@ declare class MemoryLiveAdapter implements TMemoryInstance {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.description - BM25 index string; defaults to JSON.stringify(value)
+     * @param dto.when - Logical timestamp this entry belongs to (look-ahead guard)
      */
     writeMemory: <T extends object = object>(dto: {
         memoryId: string;
@@ -24603,18 +24682,21 @@ declare class MemoryLiveAdapter implements TMemoryInstance {
         signalId: string;
         bucketName: string;
         description: string;
+        when: Date;
     }) => Promise<void>;
     /**
      * Search memory using BM25 full-text scoring.
      * @param dto.query - Search query string
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
+     * @param dto.when - Logical timestamp at which the search is happening (look-ahead guard)
      * @returns Matching entries sorted by relevance score
      */
     searchMemory: <T extends object = object>(dto: {
         query: string;
         signalId: string;
         bucketName: string;
+        when: Date;
         settings?: SearchSettings;
     }) => Promise<{
         memoryId: string;
@@ -24625,11 +24707,13 @@ declare class MemoryLiveAdapter implements TMemoryInstance {
      * List all entries in memory.
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
+     * @param dto.when - Logical timestamp at which the list is happening (look-ahead guard)
      * @returns Array of all stored entries
      */
     listMemory: <T extends object = object>(dto: {
         signalId: string;
         bucketName: string;
+        when: Date;
     }) => Promise<{
         memoryId: string;
         content: T;
@@ -24639,17 +24723,20 @@ declare class MemoryLiveAdapter implements TMemoryInstance {
      * @param dto.memoryId - Unique entry identifier
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
+     * @param dto.when - Logical timestamp (kept for API consistency; removal is by UUID)
      */
     removeMemory: (dto: {
         memoryId: string;
         signalId: string;
         bucketName: string;
+        when: Date;
     }) => Promise<void>;
     /**
      * Read a single entry from memory.
      * @param dto.memoryId - Unique entry identifier
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
+     * @param dto.when - Logical timestamp at which the read is happening (look-ahead guard)
      * @returns Entry value
      * @throws Error if entry not found
      */
@@ -24657,6 +24744,7 @@ declare class MemoryLiveAdapter implements TMemoryInstance {
         memoryId: string;
         signalId: string;
         bucketName: string;
+        when: Date;
     }) => Promise<T>;
     /**
      * Switches to in-memory BM25 adapter.
@@ -24717,6 +24805,7 @@ declare class MemoryAdapter {
      * @param dto.bucketName - Bucket name
      * @param dto.description - BM25 index string; defaults to JSON.stringify(value)
      * @param dto.backtest - Flag indicating if the context is backtest or live
+     * @param dto.when - Logical timestamp this entry belongs to (look-ahead guard)
      */
     writeMemory: <T extends object = object>(dto: {
         memoryId: string;
@@ -24725,6 +24814,7 @@ declare class MemoryAdapter {
         bucketName: string;
         description: string;
         backtest: boolean;
+        when: Date;
     }) => Promise<void>;
     /**
      * Search memory using BM25 full-text scoring.
@@ -24733,6 +24823,7 @@ declare class MemoryAdapter {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.backtest - Flag indicating if the context is backtest or live
+     * @param dto.when - Logical timestamp at which the search is happening (look-ahead guard)
      * @returns Matching entries sorted by relevance score
      */
     searchMemory: <T extends object = object>(dto: {
@@ -24741,6 +24832,7 @@ declare class MemoryAdapter {
         bucketName: string;
         settings?: SearchSettings;
         backtest: boolean;
+        when: Date;
     }) => Promise<{
         memoryId: string;
         score: number;
@@ -24752,12 +24844,14 @@ declare class MemoryAdapter {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.backtest - Flag indicating if the context is backtest or live
+     * @param dto.when - Logical timestamp at which the list is happening (look-ahead guard)
      * @returns Array of all stored entries
      */
     listMemory: <T extends object = object>(dto: {
         signalId: string;
         bucketName: string;
         backtest: boolean;
+        when: Date;
     }) => Promise<{
         memoryId: string;
         content: T;
@@ -24769,12 +24863,14 @@ declare class MemoryAdapter {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.backtest - Flag indicating if the context is backtest or live
+     * @param dto.when - Logical timestamp (kept for API consistency; removal is by UUID)
      */
     removeMemory: (dto: {
         memoryId: string;
         signalId: string;
         bucketName: string;
         backtest: boolean;
+        when: Date;
     }) => Promise<void>;
     /**
      * Read a single entry from memory.
@@ -24783,6 +24879,7 @@ declare class MemoryAdapter {
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
      * @param dto.backtest - Flag indicating if the context is backtest or live
+     * @param dto.when - Logical timestamp at which the read is happening (look-ahead guard)
      * @returns Entry value
      * @throws Error if entry not found
      */
@@ -24791,6 +24888,7 @@ declare class MemoryAdapter {
         signalId: string;
         bucketName: string;
         backtest: boolean;
+        when: Date;
     }) => Promise<T>;
 }
 /**
@@ -28052,6 +28150,15 @@ declare namespace emitters {
  */
 declare const alignToInterval: (date: Date, interval: CandleInterval) => Date;
 
+/**
+ * Returns the step in milliseconds for a given candle interval.
+ * For example, for "15m" interval, it returns 900000 (15 * 60 * 1000).
+ *
+ * @param interval - Candle interval (e.g., "1m", "15m", "1h")
+ * @returns Step in milliseconds corresponding to the interval
+ */
+declare const intervalStepMs: (interval: CandleInterval) => number;
+
 /**
  * Waits for the next candle interval to start and returns the timestamp of the new candle.
  * @param {CandleInterval} interval - The candle interval (e.g., "1m", "1h") to wait for.
@@ -35727,4 +35834,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, type CommitPayload, 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 IPersistBreakevenInstance, type IPersistCandleInstance, type IPersistIntervalInstance, type IPersistLogInstance, type IPersistMeasureInstance, type IPersistMemoryInstance, type IPersistNotificationInstance, type IPersistPartialInstance, type IPersistRecentInstance, type IPersistRiskInstance, type IPersistScheduleInstance, type IPersistSessionInstance, type IPersistSignalInstance, type IPersistStateInstance, type IPersistStorageInstance, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IPublicAction, type IPublicCandleData, type IPublicSignalRow, type IRecentUtils, type IReportDumpOptions, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskSignalRow, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IScheduledSignalCancelRow, type IScheduledSignalRow, type ISessionInstance, 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 IStateInstance, 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 IdlePingContract, 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, MemoryBacktest, MemoryBacktestAdapter, type MemoryData, MemoryLive, MemoryLiveAdapter, 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, PersistBreakevenInstance, PersistCandleAdapter, PersistCandleInstance, PersistIntervalAdapter, PersistIntervalInstance, PersistLogAdapter, PersistLogInstance, PersistMeasureAdapter, PersistMeasureInstance, PersistMemoryAdapter, PersistMemoryInstance, PersistNotificationAdapter, PersistNotificationInstance, PersistPartialAdapter, PersistPartialInstance, PersistRecentAdapter, PersistRecentInstance, PersistRiskAdapter, PersistRiskInstance, PersistScheduleAdapter, PersistScheduleInstance, PersistSessionAdapter, PersistSessionInstance, PersistSignalAdapter, PersistSignalInstance, PersistStateAdapter, PersistStateInstance, PersistStorageAdapter, PersistStorageInstance, Position, PositionSize, type ProgressBacktestContract, type ProgressWalkerContract, Recent, RecentBacktest, type RecentData, RecentLive, Reflect, 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, Session, SessionBacktest, type SessionData, SessionLive, type SignalCancelledNotification, type SignalCloseContract, type SignalClosedNotification, type SignalData, type SignalInfoContract, type SignalInfoNotification, type SignalInterval, type SignalOpenContract, type SignalOpenedNotification, type SignalScheduledNotification, type SignalSyncCloseNotification, type SignalSyncContract, type SignalSyncOpenNotification, State, StateBacktest, StateBacktestAdapter, type StateData, StateLive, StateLiveAdapter, Storage, StorageBacktest, type StorageData, StorageLive, Strategy, type StrategyActionType, type StrategyCancelReason, type StrategyCloseReason, type StrategyCommitContract, type StrategyEvent, type StrategyStatisticsModel, Sync, type SyncEvent, type SyncStatisticsModel, System, type TBrokerCtor, type TDumpInstanceCtor, type TLogCtor, type TMarkdownBase, type TMemoryInstanceCtor, type TNotificationUtilsCtor, type TPersistBase, type TPersistBaseCtor, type TPersistBreakevenInstanceCtor, type TPersistCandleInstanceCtor, type TPersistIntervalInstanceCtor, type TPersistLogInstanceCtor, type TPersistMeasureInstanceCtor, type TPersistMemoryInstanceCtor, type TPersistNotificationInstanceCtor, type TPersistPartialInstanceCtor, type TPersistRecentInstanceCtor, type TPersistRiskInstanceCtor, type TPersistScheduleInstanceCtor, type TPersistSessionInstanceCtor, type TPersistSignalInstanceCtor, type TPersistStateInstanceCtor, type TPersistStorageInstanceCtor, type TRecentUtilsCtor, type TReportBase, type TSessionInstanceCtor, type TStateInstanceCtor, 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, commitSignalNotify, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, createSignalState, dumpAgentAnswer, dumpError, dumpJson, dumpRecord, dumpTable, dumpText, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getClosePrice, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getLatestSignal, getMaxDrawdownDistancePnlCost, getMaxDrawdownDistancePnlPercentage, getMinutesSinceLatestSignalCreated, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionActiveMinutes, getPositionCountdownMinutes, getPositionDrawdownMinutes, getPositionEffectivePrice, getPositionEntries, getPositionEntryOverlap, getPositionEstimateMinutes, getPositionHighestMaxDrawdownPnlCost, getPositionHighestMaxDrawdownPnlPercentage, getPositionHighestPnlCost, getPositionHighestPnlPercentage, getPositionHighestProfitBreakeven, getPositionHighestProfitDistancePnlCost, getPositionHighestProfitDistancePnlPercentage, getPositionHighestProfitMinutes, getPositionHighestProfitPrice, getPositionHighestProfitTimestamp, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionMaxDrawdownMinutes, getPositionMaxDrawdownPnlCost, getPositionMaxDrawdownPnlPercentage, getPositionMaxDrawdownPrice, getPositionMaxDrawdownTimestamp, getPositionPartialOverlap, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getPositionWaitingMinutes, getRawCandles, getRiskSchema, getScheduledSignal, getSessionData, getSignalState, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasNoPendingSignal, hasNoScheduledSignal, hasTradeContext, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listMemory, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenHighestProfit, listenHighestProfitOnce, listenIdlePing, listenIdlePingOnce, listenMaxDrawdown, listenMaxDrawdownOnce, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalNotify, listenSignalNotifyOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, readMemory, removeMemory, roundTicks, runInMockContext, searchMemory, set, setColumns, setConfig, setLogger, setSessionData, setSignalState, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, validateCommonSignal, validatePendingSignal, validateScheduledSignal, validateSignal, waitForCandle, warmCandles, writeMemory };
+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, type CommitPayload, 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 IPersistBreakevenInstance, type IPersistCandleInstance, type IPersistIntervalInstance, type IPersistLogInstance, type IPersistMeasureInstance, type IPersistMemoryInstance, type IPersistNotificationInstance, type IPersistPartialInstance, type IPersistRecentInstance, type IPersistRiskInstance, type IPersistScheduleInstance, type IPersistSessionInstance, type IPersistSignalInstance, type IPersistStateInstance, type IPersistStorageInstance, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IPublicAction, type IPublicCandleData, type IPublicSignalRow, type IRecentUtils, type IReportDumpOptions, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskSignalRow, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IScheduledSignalCancelRow, type IScheduledSignalRow, type ISessionInstance, 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 IStateInstance, 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 IdlePingContract, 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, MemoryBacktest, MemoryBacktestAdapter, type MemoryData, MemoryLive, MemoryLiveAdapter, 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, PersistBreakevenInstance, PersistCandleAdapter, PersistCandleInstance, PersistIntervalAdapter, PersistIntervalInstance, PersistLogAdapter, PersistLogInstance, PersistMeasureAdapter, PersistMeasureInstance, PersistMemoryAdapter, PersistMemoryInstance, PersistNotificationAdapter, PersistNotificationInstance, PersistPartialAdapter, PersistPartialInstance, PersistRecentAdapter, PersistRecentInstance, PersistRiskAdapter, PersistRiskInstance, PersistScheduleAdapter, PersistScheduleInstance, PersistSessionAdapter, PersistSessionInstance, PersistSignalAdapter, PersistSignalInstance, PersistStateAdapter, PersistStateInstance, PersistStorageAdapter, PersistStorageInstance, Position, PositionSize, type ProgressBacktestContract, type ProgressWalkerContract, Recent, RecentBacktest, type RecentData, RecentLive, Reflect, 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, Session, SessionBacktest, type SessionData, SessionLive, type SignalCancelledNotification, type SignalCloseContract, type SignalClosedNotification, type SignalData, type SignalInfoContract, type SignalInfoNotification, type SignalInterval, type SignalOpenContract, type SignalOpenedNotification, type SignalScheduledNotification, type SignalSyncCloseNotification, type SignalSyncContract, type SignalSyncOpenNotification, State, StateBacktest, StateBacktestAdapter, type StateData, StateLive, StateLiveAdapter, Storage, StorageBacktest, type StorageData, StorageLive, Strategy, type StrategyActionType, type StrategyCancelReason, type StrategyCloseReason, type StrategyCommitContract, type StrategyEvent, type StrategyStatisticsModel, Sync, type SyncEvent, type SyncStatisticsModel, System, type TBrokerCtor, type TDumpInstanceCtor, type TLogCtor, type TMarkdownBase, type TMemoryInstanceCtor, type TNotificationUtilsCtor, type TPersistBase, type TPersistBaseCtor, type TPersistBreakevenInstanceCtor, type TPersistCandleInstanceCtor, type TPersistIntervalInstanceCtor, type TPersistLogInstanceCtor, type TPersistMeasureInstanceCtor, type TPersistMemoryInstanceCtor, type TPersistNotificationInstanceCtor, type TPersistPartialInstanceCtor, type TPersistRecentInstanceCtor, type TPersistRiskInstanceCtor, type TPersistScheduleInstanceCtor, type TPersistSessionInstanceCtor, type TPersistSignalInstanceCtor, type TPersistStateInstanceCtor, type TPersistStorageInstanceCtor, type TRecentUtilsCtor, type TReportBase, type TSessionInstanceCtor, type TStateInstanceCtor, 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, commitSignalNotify, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, createSignalState, dumpAgentAnswer, dumpError, dumpJson, dumpRecord, dumpTable, dumpText, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getClosePrice, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getLatestSignal, getMaxDrawdownDistancePnlCost, getMaxDrawdownDistancePnlPercentage, getMinutesSinceLatestSignalCreated, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionActiveMinutes, getPositionCountdownMinutes, getPositionDrawdownMinutes, getPositionEffectivePrice, getPositionEntries, getPositionEntryOverlap, getPositionEstimateMinutes, getPositionHighestMaxDrawdownPnlCost, getPositionHighestMaxDrawdownPnlPercentage, getPositionHighestPnlCost, getPositionHighestPnlPercentage, getPositionHighestProfitBreakeven, getPositionHighestProfitDistancePnlCost, getPositionHighestProfitDistancePnlPercentage, getPositionHighestProfitMinutes, getPositionHighestProfitPrice, getPositionHighestProfitTimestamp, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionMaxDrawdownMinutes, getPositionMaxDrawdownPnlCost, getPositionMaxDrawdownPnlPercentage, getPositionMaxDrawdownPrice, getPositionMaxDrawdownTimestamp, getPositionPartialOverlap, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getPositionWaitingMinutes, getRawCandles, getRiskSchema, getScheduledSignal, getSessionData, getSignalState, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasNoPendingSignal, hasNoScheduledSignal, hasTradeContext, intervalStepMs, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listMemory, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenHighestProfit, listenHighestProfitOnce, listenIdlePing, listenIdlePingOnce, listenMaxDrawdown, listenMaxDrawdownOnce, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalNotify, listenSignalNotifyOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, readMemory, removeMemory, roundTicks, runInMockContext, searchMemory, set, setColumns, setConfig, setLogger, setSessionData, setSignalState, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, validateCommonSignal, validatePendingSignal, validateScheduledSignal, validateSignal, waitForCandle, warmCandles, writeMemory };