ISessionInstance

Interface for session instance implementations. Defines the contract for local, persist, and dummy backends.

Intended use: per-(symbol, strategy, exchange, frame) mutable session data shared across strategy callbacks within a single run — e.g. caching LLM inference results, intermediate indicator state, or cross-candle accumulators.

Example shape:

{ lastLlmSignal: "buy" | "sell" | null; confirmedAt: number }
Copy

Methods

waitForInit

waitForInit: (initial: boolean) => Promise<void>
Copy

Initialize the session instance.

setData

setData: <Value extends object = object>(value: Value, when: Date) => Promise<void>
Copy

Write a new session value.

getData

getData: <Value extends object = object>(when: Date) => Promise<Value>
Copy

Read the current session value. Returns null when the stored when is greater than the requested when (look-ahead bias protection).

dispose

dispose: () => Promise<void>
Copy

Releases any resources held by this instance.