@tradejs/types 1.0.6 → 1.0.8

package/dist/index.d.mts

@@ -88,6 +88,42 @@ type DerivativesRow = {
     liqTotal?: number | null;
     source?: string | null;
 };
+type DerivativesPressure = 'neutral' | 'crowded_long' | 'crowded_short' | 'long_flush' | 'short_flush';
+type DerivativesContextRiskFlag = 'missing_derivatives' | 'stale_derivatives' | 'crowded_long' | 'crowded_short' | 'oi_falling' | 'oi_not_confirming' | 'long_liquidation_spike' | 'short_liquidation_spike';
+interface DerivativesIntervalContext {
+    interval: DerivativesInterval;
+    asOfTs: number | null;
+    stale: boolean;
+    points: number;
+    openInterest: number | null;
+    oiChangePct1h: number | null;
+    oiChangePct4h: number | null;
+    oiChangePct24h: number | null;
+    fundingRate: number | null;
+    fundingZScore: number | null;
+    liqLong: number | null;
+    liqShort: number | null;
+    liqTotal: number | null;
+    liqImbalance: number | null;
+    liqSpikeRatio: number | null;
+}
+interface DerivativesSymbolContext {
+    source: 'coinalyze';
+    symbol: string;
+    timestamp: number;
+    intervals: Partial<Record<DerivativesInterval, DerivativesIntervalContext>>;
+    summary: {
+        pressure: DerivativesPressure;
+        directionAligned: boolean | null;
+        riskFlags: DerivativesContextRiskFlag[];
+    };
+}
+interface DerivativesContext extends DerivativesSymbolContext {
+    targetSymbol?: string;
+    primaryReferenceSymbol?: string;
+    referenceSymbols?: string[];
+    referenceContexts?: Record<string, DerivativesSymbolContext>;
+}
 type SpreadRow = {
     symbol: string;
     interval: DerivativesInterval;
@@ -112,6 +148,7 @@ type Order = {
     price: number;
     timestamp: number;
     direction: Direction;
+    orderId?: string;
     signal?: Signal;
 };
 type Position = {
@@ -120,6 +157,10 @@ type Position = {
     price: number;
     direction: Direction;
 };
+interface PositionPnlSnapshot extends Position {
+    currentPrice: number;
+    unrealizedPnl: number;
+}
 type OrderType = 'OPEN_LONG' | 'OPEN_SHORT' | 'CLOSE_LONG' | 'CLOSE_SHORT' | 'TAKE_PROFIT_LONG' | 'TAKE_PROFIT_SHORT' | 'STOP_LOSS_LONG' | 'STOP_LOSS_SHORT';
 type ConnectorCreator = (config: ConnectorConfig) => Promise<Connector>;
 interface ConnectorConfig {
@@ -135,6 +176,23 @@ interface ConnectorPluginDefinition {
 }
 type GetPosition = (symbol: string) => Promise<Position | null>;
 type GetPositions = () => Promise<Position[]>;
+type GetOpenPositionPnl = () => Promise<PositionPnlSnapshot[]>;
+interface ClosedPnlRecord {
+    symbol: string;
+    qty: number;
+    entryPrice: number | null;
+    exitPrice: number | null;
+    closedPnl: number;
+    closedAt: number;
+    orderId?: string;
+}
+interface GetClosedPnlParams {
+    startTime: number;
+    endTime: number;
+    symbol?: string;
+    limit?: number;
+}
+type GetClosedPnl = (params: GetClosedPnlParams) => Promise<ClosedPnlRecord[]>;
 type PlaceOrder = (order: Order) => Promise<boolean>;
 type ClosePosition = (order: Omit<Order, 'qty'>) => Promise<boolean>;
 type SetTakeProfits = (params: {
@@ -156,6 +214,8 @@ interface Connector {
     setState: (state: object) => Promise<void>;
     getPosition: GetPosition;
     getPositions: GetPositions;
+    getOpenPositionPnl?: GetOpenPositionPnl;
+    getClosedPnl?: GetClosedPnl;
     placeOrder: PlaceOrder;
     setTakeProfits: SetTakeProfits;
     setStopLoss: SetStopLoss;
@@ -269,14 +329,16 @@ interface TrendLineOptions {
 }
 interface Signal {
     signalId: string;
+    orderId?: string;
     symbol: string;
     interval: Interval;
     strategy: string;
     direction: Direction;
     timestamp: number;
-    orderStatus?: 'completed' | 'failed' | 'skipped' | 'canceled';
+    orderStatus?: SignalOrderStatus;
     orderSkipReason?: string;
     isConfigFromBacktest?: boolean;
+    aiAnalysis?: Partial<SignalAnalysis>;
     ml?: {
         probability: number;
         threshold: number;
@@ -298,6 +360,24 @@ interface Signal {
     indicators: Record<string, any>;
     additionalIndicators?: Record<string, any>;
 }
+type RuntimeSignalEvaluationStatus = 'signal' | 'skip' | 'error';
+interface RuntimeSignalEvaluationRecord {
+    evaluationId: string;
+    userName: string;
+    strategy: string;
+    symbol: string;
+    interval: Interval;
+    timestamp: number;
+    evaluatedAt: number;
+    status: RuntimeSignalEvaluationStatus;
+    reason?: string;
+    signalId?: string;
+    direction?: Direction;
+    orderStatus?: SignalOrderStatus;
+    orderSkipReason?: string;
+    aiAnalysis?: Partial<SignalAnalysis> | null;
+    ml?: Signal['ml'];
+}
 interface SignalAnalysis {
     direction: Direction | null;
     quality: 1 | 2 | 3 | 4 | 5 | number;
@@ -312,8 +392,40 @@ interface SignalAnalysis {
     riskLevels?: string;
     qualityReason?: string;
     triggerInvalidation?: string;
+    gateAnalysis?: Partial<SignalAnalysis>;
+    gateContradictsLlm?: boolean;
+    gateDecision?: 'approved' | 'rejected';
+    llmDecision?: 'approved' | 'rejected';
     comment: string;
 }
+interface RuntimeAiAnalysisSnapshot {
+    strategy?: string;
+    symbol: string;
+    direction: Direction;
+    timestamp: number;
+    toleranceMs?: number;
+    analysis: Partial<SignalAnalysis>;
+}
+type SignalOrderStatus = 'completed' | 'failed' | 'skipped' | 'canceled';
+type RuntimeTradeStatus = 'active' | 'closed';
+interface RuntimeTradeRecord {
+    orderId: string;
+    signalId?: string;
+    strategy: string;
+    symbol: string;
+    direction: Direction;
+    qty: number;
+    entryPrice: number;
+    entryTimestamp: number;
+    status: RuntimeTradeStatus;
+    currentPrice?: number | null;
+    currentPnl?: number | null;
+    closedPnl?: number | null;
+    exitPrice?: number | null;
+    exitTimestamp?: number | null;
+    aiAnalysis?: Partial<SignalAnalysis> | null;
+    lastSyncedAt?: number;
+}
 
 type Strategy = (candle: KlineChartItem, btcCandle: KlineChartItem) => Promise<string | Signal>;
 type BacktestPriceMode = 'mid' | 'close' | 'open' | 'rand';
@@ -372,6 +484,7 @@ interface TestingBoxResult {
     stat: MinimalStat;
     inlineOrderLog?: OrderLogData;
     inlinePositionLog?: PositionLogData;
+    inlineReplaySignalEvaluations?: RuntimeSignalEvaluationRecord[];
 }
 type TestingBox = (test: Test) => Promise<TestingBoxResult | null>;
 interface TestWorkerResult extends TestingBoxResult {
@@ -683,9 +796,12 @@ interface StrategyRuntimeMlOptions {
     strategyConfig?: StrategyConfig;
     mlThreshold?: number;
 }
+type StrategyAiMode = 'gate' | 'llm';
 interface StrategyRuntimeAiOptions {
     enabled?: boolean;
+    mode?: StrategyAiMode;
     minQuality?: number;
+    replayAnalyses?: RuntimeAiAnalysisSnapshot[];
 }
 interface StrategyEntryRuntimeOptions {
     ml?: StrategyRuntimeMlOptions;
@@ -867,7 +983,7 @@ interface StrategyHookAiContext {
     quality?: number;
     skippedReason?: StrategyHookAiSkippedReason;
 }
-type StrategyHookStage = 'onInit' | 'afterCoreDecision' | 'onSkip' | 'beforeClosePosition' | 'afterEnrichMl' | 'afterEnrichAi' | 'beforeEntryGate' | 'beforePlaceOrder' | 'afterPlaceOrder' | 'runtime.beforePlaceOrder' | 'enrichSignalWithMl' | 'enrichSignalWithAi' | 'setTakeProfits' | 'setStopLoss' | 'protectPosition' | 'closePosition' | 'placeOrder';
+type StrategyHookStage = 'onInit' | 'onBar' | 'afterCoreDecision' | 'afterBarDecision' | 'onSkip' | 'beforeClosePosition' | 'afterEnrichMl' | 'afterEnrichAi' | 'beforeEntryGate' | 'beforePlaceOrder' | 'afterPlaceOrder' | 'runtime.beforePlaceOrder' | 'enrichSignalWithMl' | 'enrichSignalWithAi' | 'setTakeProfits' | 'setStopLoss' | 'protectPosition' | 'closePosition' | 'placeOrder';
 interface StrategyHookErrorPayload {
     stage: StrategyHookStage;
     cause: unknown;
@@ -883,9 +999,11 @@ interface StrategyHookInitContext {
     ctx: StrategyHookCtx;
     market: Required<Pick<StrategyHookMarketContext, 'data' | 'btcData'>>;
 }
-interface StrategyHookAfterDecisionContext {
+interface StrategyHookBarContext {
     ctx: StrategyHookCtx;
     market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
+}
+interface StrategyHookAfterDecisionContext extends StrategyHookBarContext {
     decision: StrategyDecision;
 }
 interface StrategyHookSkipContext extends StrategyHookAfterDecisionContext {
@@ -950,7 +1068,9 @@ interface StrategyManifest {
     };
     hooks?: {
         onInit?: (params: StrategyHookInitContext) => Promise<void> | void;
+        onBar?: (params: StrategyHookBarContext) => Promise<StrategyDecision | void> | StrategyDecision | void;
         afterCoreDecision?: (params: StrategyHookAfterDecisionContext) => Promise<void> | void;
+        afterBarDecision?: (params: StrategyHookAfterDecisionContext) => Promise<void> | void;
         onSkip?: (params: StrategyHookSkipContext) => Promise<void> | void;
         beforeClosePosition?: (params: StrategyHookBeforeCloseContext) => Promise<StrategyHookGateResult | void> | StrategyHookGateResult | void;
         afterEnrichMl?: (params: StrategyHookEnrichContext) => Promise<void> | void;
@@ -988,4 +1108,4 @@ interface AiDatasetRow {
     connectorName?: string;
 }
 
-export type { AIChatHistory, AIChatMessage, AiDatasetRow, AiPayload, AiPromptPair, BacktestPriceMode, BacktestRunConfig, BaseIndicatorsHistorySnapshot, Bot, BotConfig, BotResults, BotStatus, BuildStrategySignalDraft, BuildStrategySignalParams, Candle, ChartColor, CompletedTest, Connector, ConnectorConfig, ConnectorCreator, ConnectorPluginDefinition, ConnectorRegistryEntry, CreateStrategyCore, CreateStrategyCoreParams, DerivativesInterval, DerivativesRow, Direction, EOMPoint, Figure, Filters, GetTickers, Indicator, IndicatorPluginComputeParams, IndicatorPluginDefinition, IndicatorPluginEntry, IndicatorPluginFigureRenderer, IndicatorPluginRenderer, IndicatorSnapshot, Indicators, IndicatorsHistorySnapshot, Interval, Item, Items, Kline, KlineChartData, KlineChartItem, KlineRequest, MetricThreshold, Metrics, MinimalStat, MlCandleIndicatorsSnapshot, MonthlyEquityStats, OnChangeCompare, OnChangeFilters, Order, OrderLog, OrderLogData, OrderType, Position, PositionLog, PositionLogData, Provider, Signal, SignalAnalysis, SimpleOrderLogData, Sl, SpreadRow, Strategy, StrategyAPI, StrategyAPIEntryParams, StrategyAPIExitParams, StrategyAPIMarketDataParams, StrategyAPIProtectParams, StrategyAdditionalIndicatorsMap, StrategyAiAdapter, StrategyClosePlan, StrategyConfig, StrategyConfigGrid, StrategyCoreRunner, StrategyCreator, StrategyCreatorParams, StrategyDecision, StrategyDirectionalTpSlParams, StrategyDirectionalTpSlResult, StrategyEntryBaseParams, StrategyEntryModelFigures, StrategyEntryOrderPlan, StrategyEntryRuntimeBaseParams, StrategyEntryRuntimeBuilderParams, StrategyEntryRuntimeOptions, StrategyEntrySignalContext, StrategyEntrySignalDecisionBuilderParams, StrategyEntryTakeProfitsParams, StrategyFigureLine, StrategyFigurePoint, StrategyFigurePoints, StrategyFigureZone, StrategyHookAfterAiContext, StrategyHookAfterDecisionContext, StrategyHookAfterPlaceOrderContext, StrategyHookAiContext, StrategyHookAiSkippedReason, StrategyHookBeforeCloseContext, StrategyHookBeforeEntryGateContext, StrategyHookBeforePlaceOrderContext, StrategyHookCtx, StrategyHookEnrichContext, StrategyHookEntryContext, StrategyHookErrorContext, StrategyHookErrorPayload, StrategyHookGateResult, StrategyHookInitContext, StrategyHookMarketContext, StrategyHookMlContext, StrategyHookMlSkippedReason, StrategyHookOrderContext, StrategyHookPolicyContext, StrategyHookSkipContext, StrategyHookStage, StrategyIndicatorsMap, StrategyIndicatorsState, StrategyLastTradeController, StrategyLastTradeControllerParams, StrategyManifest, StrategyMarketSnapshot, StrategyMlAdapter, StrategyPluginDefinition, StrategyProtectPlan, StrategyRegistryEntry, StrategyResultConfig, StrategyResultEntry, StrategyResults, StrategyRuntimeAiOptions, StrategyRuntimeMlOptions, StrategySignalMetaParams, StrategySignalPriceParams, Test, TestCompare, TestCompareList, TestConnector, TestConnectorContext, TestConnectorCreator, TestResult, TestStat, TestSuite, TestThresholds, TestThresholdsKey, TestWorkerResult, TestingBox, TestingBoxResult, TestingOptions, ThresholdLevel, Ticker, Tp, Trend, TrendLine, TrendLineMode, TrendLineOptions, UIFilters };
+export type { AIChatHistory, AIChatMessage, AiDatasetRow, AiPayload, AiPromptPair, BacktestPriceMode, BacktestRunConfig, BaseIndicatorsHistorySnapshot, Bot, BotConfig, BotResults, BotStatus, BuildStrategySignalDraft, BuildStrategySignalParams, Candle, ChartColor, ClosedPnlRecord, CompletedTest, Connector, ConnectorConfig, ConnectorCreator, ConnectorPluginDefinition, ConnectorRegistryEntry, CreateStrategyCore, CreateStrategyCoreParams, DerivativesContext, DerivativesContextRiskFlag, DerivativesInterval, DerivativesIntervalContext, DerivativesPressure, DerivativesRow, DerivativesSymbolContext, Direction, EOMPoint, Figure, Filters, GetClosedPnlParams, GetTickers, Indicator, IndicatorPluginComputeParams, IndicatorPluginDefinition, IndicatorPluginEntry, IndicatorPluginFigureRenderer, IndicatorPluginRenderer, IndicatorSnapshot, Indicators, IndicatorsHistorySnapshot, Interval, Item, Items, Kline, KlineChartData, KlineChartItem, KlineRequest, MetricThreshold, Metrics, MinimalStat, MlCandleIndicatorsSnapshot, MonthlyEquityStats, OnChangeCompare, OnChangeFilters, Order, OrderLog, OrderLogData, OrderType, Position, PositionLog, PositionLogData, PositionPnlSnapshot, Provider, RuntimeAiAnalysisSnapshot, RuntimeSignalEvaluationRecord, RuntimeSignalEvaluationStatus, RuntimeTradeRecord, RuntimeTradeStatus, Signal, SignalAnalysis, SignalOrderStatus, SimpleOrderLogData, Sl, SpreadRow, Strategy, StrategyAPI, StrategyAPIEntryParams, StrategyAPIExitParams, StrategyAPIMarketDataParams, StrategyAPIProtectParams, StrategyAdditionalIndicatorsMap, StrategyAiAdapter, StrategyAiMode, StrategyClosePlan, StrategyConfig, StrategyConfigGrid, StrategyCoreRunner, StrategyCreator, StrategyCreatorParams, StrategyDecision, StrategyDirectionalTpSlParams, StrategyDirectionalTpSlResult, StrategyEntryBaseParams, StrategyEntryModelFigures, StrategyEntryOrderPlan, StrategyEntryRuntimeBaseParams, StrategyEntryRuntimeBuilderParams, StrategyEntryRuntimeOptions, StrategyEntrySignalContext, StrategyEntrySignalDecisionBuilderParams, StrategyEntryTakeProfitsParams, StrategyFigureLine, StrategyFigurePoint, StrategyFigurePoints, StrategyFigureZone, StrategyHookAfterAiContext, StrategyHookAfterDecisionContext, StrategyHookAfterPlaceOrderContext, StrategyHookAiContext, StrategyHookAiSkippedReason, StrategyHookBarContext, StrategyHookBeforeCloseContext, StrategyHookBeforeEntryGateContext, StrategyHookBeforePlaceOrderContext, StrategyHookCtx, StrategyHookEnrichContext, StrategyHookEntryContext, StrategyHookErrorContext, StrategyHookErrorPayload, StrategyHookGateResult, StrategyHookInitContext, StrategyHookMarketContext, StrategyHookMlContext, StrategyHookMlSkippedReason, StrategyHookOrderContext, StrategyHookPolicyContext, StrategyHookSkipContext, StrategyHookStage, StrategyIndicatorsMap, StrategyIndicatorsState, StrategyLastTradeController, StrategyLastTradeControllerParams, StrategyManifest, StrategyMarketSnapshot, StrategyMlAdapter, StrategyPluginDefinition, StrategyProtectPlan, StrategyRegistryEntry, StrategyResultConfig, StrategyResultEntry, StrategyResults, StrategyRuntimeAiOptions, StrategyRuntimeMlOptions, StrategySignalMetaParams, StrategySignalPriceParams, Test, TestCompare, TestCompareList, TestConnector, TestConnectorContext, TestConnectorCreator, TestResult, TestStat, TestSuite, TestThresholds, TestThresholdsKey, TestWorkerResult, TestingBox, TestingBoxResult, TestingOptions, ThresholdLevel, Ticker, Tp, Trend, TrendLine, TrendLineMode, TrendLineOptions, UIFilters };

package/dist/index.d.ts

@@ -88,6 +88,42 @@ type DerivativesRow = {
     liqTotal?: number | null;
     source?: string | null;
 };
+type DerivativesPressure = 'neutral' | 'crowded_long' | 'crowded_short' | 'long_flush' | 'short_flush';
+type DerivativesContextRiskFlag = 'missing_derivatives' | 'stale_derivatives' | 'crowded_long' | 'crowded_short' | 'oi_falling' | 'oi_not_confirming' | 'long_liquidation_spike' | 'short_liquidation_spike';
+interface DerivativesIntervalContext {
+    interval: DerivativesInterval;
+    asOfTs: number | null;
+    stale: boolean;
+    points: number;
+    openInterest: number | null;
+    oiChangePct1h: number | null;
+    oiChangePct4h: number | null;
+    oiChangePct24h: number | null;
+    fundingRate: number | null;
+    fundingZScore: number | null;
+    liqLong: number | null;
+    liqShort: number | null;
+    liqTotal: number | null;
+    liqImbalance: number | null;
+    liqSpikeRatio: number | null;
+}
+interface DerivativesSymbolContext {
+    source: 'coinalyze';
+    symbol: string;
+    timestamp: number;
+    intervals: Partial<Record<DerivativesInterval, DerivativesIntervalContext>>;
+    summary: {
+        pressure: DerivativesPressure;
+        directionAligned: boolean | null;
+        riskFlags: DerivativesContextRiskFlag[];
+    };
+}
+interface DerivativesContext extends DerivativesSymbolContext {
+    targetSymbol?: string;
+    primaryReferenceSymbol?: string;
+    referenceSymbols?: string[];
+    referenceContexts?: Record<string, DerivativesSymbolContext>;
+}
 type SpreadRow = {
     symbol: string;
     interval: DerivativesInterval;
@@ -112,6 +148,7 @@ type Order = {
     price: number;
     timestamp: number;
     direction: Direction;
+    orderId?: string;
     signal?: Signal;
 };
 type Position = {
@@ -120,6 +157,10 @@ type Position = {
     price: number;
     direction: Direction;
 };
+interface PositionPnlSnapshot extends Position {
+    currentPrice: number;
+    unrealizedPnl: number;
+}
 type OrderType = 'OPEN_LONG' | 'OPEN_SHORT' | 'CLOSE_LONG' | 'CLOSE_SHORT' | 'TAKE_PROFIT_LONG' | 'TAKE_PROFIT_SHORT' | 'STOP_LOSS_LONG' | 'STOP_LOSS_SHORT';
 type ConnectorCreator = (config: ConnectorConfig) => Promise<Connector>;
 interface ConnectorConfig {
@@ -135,6 +176,23 @@ interface ConnectorPluginDefinition {
 }
 type GetPosition = (symbol: string) => Promise<Position | null>;
 type GetPositions = () => Promise<Position[]>;
+type GetOpenPositionPnl = () => Promise<PositionPnlSnapshot[]>;
+interface ClosedPnlRecord {
+    symbol: string;
+    qty: number;
+    entryPrice: number | null;
+    exitPrice: number | null;
+    closedPnl: number;
+    closedAt: number;
+    orderId?: string;
+}
+interface GetClosedPnlParams {
+    startTime: number;
+    endTime: number;
+    symbol?: string;
+    limit?: number;
+}
+type GetClosedPnl = (params: GetClosedPnlParams) => Promise<ClosedPnlRecord[]>;
 type PlaceOrder = (order: Order) => Promise<boolean>;
 type ClosePosition = (order: Omit<Order, 'qty'>) => Promise<boolean>;
 type SetTakeProfits = (params: {
@@ -156,6 +214,8 @@ interface Connector {
     setState: (state: object) => Promise<void>;
     getPosition: GetPosition;
     getPositions: GetPositions;
+    getOpenPositionPnl?: GetOpenPositionPnl;
+    getClosedPnl?: GetClosedPnl;
     placeOrder: PlaceOrder;
     setTakeProfits: SetTakeProfits;
     setStopLoss: SetStopLoss;
@@ -269,14 +329,16 @@ interface TrendLineOptions {
 }
 interface Signal {
     signalId: string;
+    orderId?: string;
     symbol: string;
     interval: Interval;
     strategy: string;
     direction: Direction;
     timestamp: number;
-    orderStatus?: 'completed' | 'failed' | 'skipped' | 'canceled';
+    orderStatus?: SignalOrderStatus;
     orderSkipReason?: string;
     isConfigFromBacktest?: boolean;
+    aiAnalysis?: Partial<SignalAnalysis>;
     ml?: {
         probability: number;
         threshold: number;
@@ -298,6 +360,24 @@ interface Signal {
     indicators: Record<string, any>;
     additionalIndicators?: Record<string, any>;
 }
+type RuntimeSignalEvaluationStatus = 'signal' | 'skip' | 'error';
+interface RuntimeSignalEvaluationRecord {
+    evaluationId: string;
+    userName: string;
+    strategy: string;
+    symbol: string;
+    interval: Interval;
+    timestamp: number;
+    evaluatedAt: number;
+    status: RuntimeSignalEvaluationStatus;
+    reason?: string;
+    signalId?: string;
+    direction?: Direction;
+    orderStatus?: SignalOrderStatus;
+    orderSkipReason?: string;
+    aiAnalysis?: Partial<SignalAnalysis> | null;
+    ml?: Signal['ml'];
+}
 interface SignalAnalysis {
     direction: Direction | null;
     quality: 1 | 2 | 3 | 4 | 5 | number;
@@ -312,8 +392,40 @@ interface SignalAnalysis {
     riskLevels?: string;
     qualityReason?: string;
     triggerInvalidation?: string;
+    gateAnalysis?: Partial<SignalAnalysis>;
+    gateContradictsLlm?: boolean;
+    gateDecision?: 'approved' | 'rejected';
+    llmDecision?: 'approved' | 'rejected';
     comment: string;
 }
+interface RuntimeAiAnalysisSnapshot {
+    strategy?: string;
+    symbol: string;
+    direction: Direction;
+    timestamp: number;
+    toleranceMs?: number;
+    analysis: Partial<SignalAnalysis>;
+}
+type SignalOrderStatus = 'completed' | 'failed' | 'skipped' | 'canceled';
+type RuntimeTradeStatus = 'active' | 'closed';
+interface RuntimeTradeRecord {
+    orderId: string;
+    signalId?: string;
+    strategy: string;
+    symbol: string;
+    direction: Direction;
+    qty: number;
+    entryPrice: number;
+    entryTimestamp: number;
+    status: RuntimeTradeStatus;
+    currentPrice?: number | null;
+    currentPnl?: number | null;
+    closedPnl?: number | null;
+    exitPrice?: number | null;
+    exitTimestamp?: number | null;
+    aiAnalysis?: Partial<SignalAnalysis> | null;
+    lastSyncedAt?: number;
+}
 
 type Strategy = (candle: KlineChartItem, btcCandle: KlineChartItem) => Promise<string | Signal>;
 type BacktestPriceMode = 'mid' | 'close' | 'open' | 'rand';
@@ -372,6 +484,7 @@ interface TestingBoxResult {
     stat: MinimalStat;
     inlineOrderLog?: OrderLogData;
     inlinePositionLog?: PositionLogData;
+    inlineReplaySignalEvaluations?: RuntimeSignalEvaluationRecord[];
 }
 type TestingBox = (test: Test) => Promise<TestingBoxResult | null>;
 interface TestWorkerResult extends TestingBoxResult {
@@ -683,9 +796,12 @@ interface StrategyRuntimeMlOptions {
     strategyConfig?: StrategyConfig;
     mlThreshold?: number;
 }
+type StrategyAiMode = 'gate' | 'llm';
 interface StrategyRuntimeAiOptions {
     enabled?: boolean;
+    mode?: StrategyAiMode;
     minQuality?: number;
+    replayAnalyses?: RuntimeAiAnalysisSnapshot[];
 }
 interface StrategyEntryRuntimeOptions {
     ml?: StrategyRuntimeMlOptions;
@@ -867,7 +983,7 @@ interface StrategyHookAiContext {
     quality?: number;
     skippedReason?: StrategyHookAiSkippedReason;
 }
-type StrategyHookStage = 'onInit' | 'afterCoreDecision' | 'onSkip' | 'beforeClosePosition' | 'afterEnrichMl' | 'afterEnrichAi' | 'beforeEntryGate' | 'beforePlaceOrder' | 'afterPlaceOrder' | 'runtime.beforePlaceOrder' | 'enrichSignalWithMl' | 'enrichSignalWithAi' | 'setTakeProfits' | 'setStopLoss' | 'protectPosition' | 'closePosition' | 'placeOrder';
+type StrategyHookStage = 'onInit' | 'onBar' | 'afterCoreDecision' | 'afterBarDecision' | 'onSkip' | 'beforeClosePosition' | 'afterEnrichMl' | 'afterEnrichAi' | 'beforeEntryGate' | 'beforePlaceOrder' | 'afterPlaceOrder' | 'runtime.beforePlaceOrder' | 'enrichSignalWithMl' | 'enrichSignalWithAi' | 'setTakeProfits' | 'setStopLoss' | 'protectPosition' | 'closePosition' | 'placeOrder';
 interface StrategyHookErrorPayload {
     stage: StrategyHookStage;
     cause: unknown;
@@ -883,9 +999,11 @@ interface StrategyHookInitContext {
     ctx: StrategyHookCtx;
     market: Required<Pick<StrategyHookMarketContext, 'data' | 'btcData'>>;
 }
-interface StrategyHookAfterDecisionContext {
+interface StrategyHookBarContext {
     ctx: StrategyHookCtx;
     market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
+}
+interface StrategyHookAfterDecisionContext extends StrategyHookBarContext {
     decision: StrategyDecision;
 }
 interface StrategyHookSkipContext extends StrategyHookAfterDecisionContext {
@@ -950,7 +1068,9 @@ interface StrategyManifest {
     };
     hooks?: {
         onInit?: (params: StrategyHookInitContext) => Promise<void> | void;
+        onBar?: (params: StrategyHookBarContext) => Promise<StrategyDecision | void> | StrategyDecision | void;
         afterCoreDecision?: (params: StrategyHookAfterDecisionContext) => Promise<void> | void;
+        afterBarDecision?: (params: StrategyHookAfterDecisionContext) => Promise<void> | void;
         onSkip?: (params: StrategyHookSkipContext) => Promise<void> | void;
         beforeClosePosition?: (params: StrategyHookBeforeCloseContext) => Promise<StrategyHookGateResult | void> | StrategyHookGateResult | void;
         afterEnrichMl?: (params: StrategyHookEnrichContext) => Promise<void> | void;
@@ -988,4 +1108,4 @@ interface AiDatasetRow {
     connectorName?: string;
 }
 
-export type { AIChatHistory, AIChatMessage, AiDatasetRow, AiPayload, AiPromptPair, BacktestPriceMode, BacktestRunConfig, BaseIndicatorsHistorySnapshot, Bot, BotConfig, BotResults, BotStatus, BuildStrategySignalDraft, BuildStrategySignalParams, Candle, ChartColor, CompletedTest, Connector, ConnectorConfig, ConnectorCreator, ConnectorPluginDefinition, ConnectorRegistryEntry, CreateStrategyCore, CreateStrategyCoreParams, DerivativesInterval, DerivativesRow, Direction, EOMPoint, Figure, Filters, GetTickers, Indicator, IndicatorPluginComputeParams, IndicatorPluginDefinition, IndicatorPluginEntry, IndicatorPluginFigureRenderer, IndicatorPluginRenderer, IndicatorSnapshot, Indicators, IndicatorsHistorySnapshot, Interval, Item, Items, Kline, KlineChartData, KlineChartItem, KlineRequest, MetricThreshold, Metrics, MinimalStat, MlCandleIndicatorsSnapshot, MonthlyEquityStats, OnChangeCompare, OnChangeFilters, Order, OrderLog, OrderLogData, OrderType, Position, PositionLog, PositionLogData, Provider, Signal, SignalAnalysis, SimpleOrderLogData, Sl, SpreadRow, Strategy, StrategyAPI, StrategyAPIEntryParams, StrategyAPIExitParams, StrategyAPIMarketDataParams, StrategyAPIProtectParams, StrategyAdditionalIndicatorsMap, StrategyAiAdapter, StrategyClosePlan, StrategyConfig, StrategyConfigGrid, StrategyCoreRunner, StrategyCreator, StrategyCreatorParams, StrategyDecision, StrategyDirectionalTpSlParams, StrategyDirectionalTpSlResult, StrategyEntryBaseParams, StrategyEntryModelFigures, StrategyEntryOrderPlan, StrategyEntryRuntimeBaseParams, StrategyEntryRuntimeBuilderParams, StrategyEntryRuntimeOptions, StrategyEntrySignalContext, StrategyEntrySignalDecisionBuilderParams, StrategyEntryTakeProfitsParams, StrategyFigureLine, StrategyFigurePoint, StrategyFigurePoints, StrategyFigureZone, StrategyHookAfterAiContext, StrategyHookAfterDecisionContext, StrategyHookAfterPlaceOrderContext, StrategyHookAiContext, StrategyHookAiSkippedReason, StrategyHookBeforeCloseContext, StrategyHookBeforeEntryGateContext, StrategyHookBeforePlaceOrderContext, StrategyHookCtx, StrategyHookEnrichContext, StrategyHookEntryContext, StrategyHookErrorContext, StrategyHookErrorPayload, StrategyHookGateResult, StrategyHookInitContext, StrategyHookMarketContext, StrategyHookMlContext, StrategyHookMlSkippedReason, StrategyHookOrderContext, StrategyHookPolicyContext, StrategyHookSkipContext, StrategyHookStage, StrategyIndicatorsMap, StrategyIndicatorsState, StrategyLastTradeController, StrategyLastTradeControllerParams, StrategyManifest, StrategyMarketSnapshot, StrategyMlAdapter, StrategyPluginDefinition, StrategyProtectPlan, StrategyRegistryEntry, StrategyResultConfig, StrategyResultEntry, StrategyResults, StrategyRuntimeAiOptions, StrategyRuntimeMlOptions, StrategySignalMetaParams, StrategySignalPriceParams, Test, TestCompare, TestCompareList, TestConnector, TestConnectorContext, TestConnectorCreator, TestResult, TestStat, TestSuite, TestThresholds, TestThresholdsKey, TestWorkerResult, TestingBox, TestingBoxResult, TestingOptions, ThresholdLevel, Ticker, Tp, Trend, TrendLine, TrendLineMode, TrendLineOptions, UIFilters };
+export type { AIChatHistory, AIChatMessage, AiDatasetRow, AiPayload, AiPromptPair, BacktestPriceMode, BacktestRunConfig, BaseIndicatorsHistorySnapshot, Bot, BotConfig, BotResults, BotStatus, BuildStrategySignalDraft, BuildStrategySignalParams, Candle, ChartColor, ClosedPnlRecord, CompletedTest, Connector, ConnectorConfig, ConnectorCreator, ConnectorPluginDefinition, ConnectorRegistryEntry, CreateStrategyCore, CreateStrategyCoreParams, DerivativesContext, DerivativesContextRiskFlag, DerivativesInterval, DerivativesIntervalContext, DerivativesPressure, DerivativesRow, DerivativesSymbolContext, Direction, EOMPoint, Figure, Filters, GetClosedPnlParams, GetTickers, Indicator, IndicatorPluginComputeParams, IndicatorPluginDefinition, IndicatorPluginEntry, IndicatorPluginFigureRenderer, IndicatorPluginRenderer, IndicatorSnapshot, Indicators, IndicatorsHistorySnapshot, Interval, Item, Items, Kline, KlineChartData, KlineChartItem, KlineRequest, MetricThreshold, Metrics, MinimalStat, MlCandleIndicatorsSnapshot, MonthlyEquityStats, OnChangeCompare, OnChangeFilters, Order, OrderLog, OrderLogData, OrderType, Position, PositionLog, PositionLogData, PositionPnlSnapshot, Provider, RuntimeAiAnalysisSnapshot, RuntimeSignalEvaluationRecord, RuntimeSignalEvaluationStatus, RuntimeTradeRecord, RuntimeTradeStatus, Signal, SignalAnalysis, SignalOrderStatus, SimpleOrderLogData, Sl, SpreadRow, Strategy, StrategyAPI, StrategyAPIEntryParams, StrategyAPIExitParams, StrategyAPIMarketDataParams, StrategyAPIProtectParams, StrategyAdditionalIndicatorsMap, StrategyAiAdapter, StrategyAiMode, StrategyClosePlan, StrategyConfig, StrategyConfigGrid, StrategyCoreRunner, StrategyCreator, StrategyCreatorParams, StrategyDecision, StrategyDirectionalTpSlParams, StrategyDirectionalTpSlResult, StrategyEntryBaseParams, StrategyEntryModelFigures, StrategyEntryOrderPlan, StrategyEntryRuntimeBaseParams, StrategyEntryRuntimeBuilderParams, StrategyEntryRuntimeOptions, StrategyEntrySignalContext, StrategyEntrySignalDecisionBuilderParams, StrategyEntryTakeProfitsParams, StrategyFigureLine, StrategyFigurePoint, StrategyFigurePoints, StrategyFigureZone, StrategyHookAfterAiContext, StrategyHookAfterDecisionContext, StrategyHookAfterPlaceOrderContext, StrategyHookAiContext, StrategyHookAiSkippedReason, StrategyHookBarContext, StrategyHookBeforeCloseContext, StrategyHookBeforeEntryGateContext, StrategyHookBeforePlaceOrderContext, StrategyHookCtx, StrategyHookEnrichContext, StrategyHookEntryContext, StrategyHookErrorContext, StrategyHookErrorPayload, StrategyHookGateResult, StrategyHookInitContext, StrategyHookMarketContext, StrategyHookMlContext, StrategyHookMlSkippedReason, StrategyHookOrderContext, StrategyHookPolicyContext, StrategyHookSkipContext, StrategyHookStage, StrategyIndicatorsMap, StrategyIndicatorsState, StrategyLastTradeController, StrategyLastTradeControllerParams, StrategyManifest, StrategyMarketSnapshot, StrategyMlAdapter, StrategyPluginDefinition, StrategyProtectPlan, StrategyRegistryEntry, StrategyResultConfig, StrategyResultEntry, StrategyResults, StrategyRuntimeAiOptions, StrategyRuntimeMlOptions, StrategySignalMetaParams, StrategySignalPriceParams, Test, TestCompare, TestCompareList, TestConnector, TestConnectorContext, TestConnectorCreator, TestResult, TestStat, TestSuite, TestThresholds, TestThresholdsKey, TestWorkerResult, TestingBox, TestingBoxResult, TestingOptions, ThresholdLevel, Ticker, Tp, Trend, TrendLine, TrendLineMode, TrendLineOptions, UIFilters };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/types",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Shared TypeScript contracts for the TradeJS open-source framework.",
   "keywords": [
     "tradejs",