@tradejs/types 1.0.5 → 1.0.8

package/dist/index.d.ts

@@ -74,6 +74,7 @@ interface KlineRequest {
     end: number;
     silent?: boolean;
     cacheOnly?: boolean;
+    warmOnly?: boolean;
 }
 type DerivativesInterval = '15m' | '1h';
 type DerivativesRow = {
@@ -87,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;
@@ -111,6 +148,7 @@ type Order = {
     price: number;
     timestamp: number;
     direction: Direction;
+    orderId?: string;
     signal?: Signal;
 };
 type Position = {
@@ -119,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 {
@@ -134,8 +176,36 @@ interface ConnectorPluginDefinition {
 }
 type GetPosition = (symbol: string) => Promise<Position | null>;
 type GetPositions = () => Promise<Position[]>;
-type PlaceOrder = (order: Order, tp?: Tp[], slPrice?: Sl) => Promise<boolean>;
+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: {
+    symbol: string;
+    direction: Direction;
+    qty?: number;
+    takeProfits: Tp[];
+}) => Promise<boolean>;
+type SetStopLoss = (params: {
+    symbol: string;
+    direction: Direction;
+    stopLossPrice: Sl;
+}) => Promise<boolean>;
 type Kline = (options: KlineRequest) => Promise<KlineChartData>;
 type GetTickers = () => Promise<Ticker[]>;
 interface Connector {
@@ -144,7 +214,11 @@ interface Connector {
     setState: (state: object) => Promise<void>;
     getPosition: GetPosition;
     getPositions: GetPositions;
+    getOpenPositionPnl?: GetOpenPositionPnl;
+    getClosedPnl?: GetClosedPnl;
     placeOrder: PlaceOrder;
+    setTakeProfits: SetTakeProfits;
+    setStopLoss: SetStopLoss;
     closePosition: ClosePosition;
     getTickers: GetTickers;
 }
@@ -255,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;
@@ -284,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;
@@ -298,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';
@@ -335,7 +461,9 @@ interface Test extends BacktestRunConfig {
     symbol: string;
     options: TestingOptions;
     ml?: boolean;
+    ai?: boolean;
     chunkId?: string;
+    timeoutMs?: number;
 }
 type TestSuite = Test[];
 interface TestStat extends Metrics {
@@ -354,6 +482,9 @@ interface MinimalStat {
 interface TestingBoxResult {
     orderLogId: string;
     stat: MinimalStat;
+    inlineOrderLog?: OrderLogData;
+    inlinePositionLog?: PositionLogData;
+    inlineReplaySignalEvaluations?: RuntimeSignalEvaluationRecord[];
 }
 type TestingBox = (test: Test) => Promise<TestingBoxResult | null>;
 interface TestWorkerResult extends TestingBoxResult {
@@ -400,6 +531,7 @@ interface TestConnector extends Connector {
 interface TestConnectorContext {
     userName?: string;
     mlEnabled?: boolean;
+    aiEnabled?: boolean;
 }
 type TestConnectorCreator = (connector: Connector, context?: TestConnectorContext) => TestConnector;
 type ChartColor = string;
@@ -446,197 +578,6 @@ interface UIFilters extends Filters {
 }
 type OnChangeFilters = (filters: Partial<UIFilters>) => void;
 
-interface AIChatMessage {
-    from: 'user' | 'ai';
-    text: string;
-    command?: string;
-}
-type AIChatHistory = AIChatMessage[];
-
-interface AiPayload {
-    signal: {
-        symbol: Signal['symbol'];
-        signalId: Signal['signalId'];
-        interval: Signal['interval'];
-        direction: Signal['direction'];
-        timestamp: Signal['timestamp'];
-        strategy: Signal['strategy'];
-        prices: {
-            currentPrice: Signal['prices']['currentPrice'];
-            takeProfitPrice: Signal['prices']['takeProfitPrice'];
-            stopLossPrice: Signal['prices']['stopLossPrice'];
-        };
-    };
-    figures: Record<string, unknown>;
-    indicators: unknown;
-    additionalIndicators: unknown;
-}
-interface StrategyAiAdapter {
-    buildPayload?: (params: {
-        signal: Signal;
-        basePayload: AiPayload;
-    }) => AiPayload;
-    buildSystemPromptAddon?: (params: {
-        signal: Signal;
-    }) => string;
-    buildHumanPromptAddon?: (params: {
-        signal: Signal;
-        payload: AiPayload;
-    }) => string;
-    mapEntryRuntimeFromConfig?: (config: StrategyConfig) => StrategyRuntimeAiOptions | undefined;
-}
-interface StrategyMlAdapter {
-    normalizeSignal?: (signal: Signal) => Signal;
-    normalizeStrategyConfig?: (strategyConfig?: Record<string, any>) => Record<string, any> | undefined;
-    mapEntryRuntimeFromConfig?: (config: StrategyConfig) => StrategyRuntimeMlOptions | undefined;
-}
-interface StrategyHookGateResult {
-    allow?: boolean;
-    reason?: string;
-}
-type EntryDecision = Extract<StrategyDecision, {
-    kind: 'entry';
-}>;
-type ExitDecision = Extract<StrategyDecision, {
-    kind: 'exit';
-}>;
-interface StrategyHookCtx {
-    connector: Connector;
-    strategyName: string;
-    userName: string;
-    symbol: string;
-    strategyConfig: StrategyConfig;
-    env: string;
-    isConfigFromBacktest: boolean;
-}
-interface StrategyHookMarketContext {
-    candle?: KlineChartItem;
-    btcCandle?: KlineChartItem;
-    data?: KlineChartItem[];
-    btcData?: KlineChartItem[];
-}
-interface StrategyHookEntryContext {
-    context: StrategyEntrySignalContext;
-    orderPlan: StrategyEntryOrderPlan;
-    signal?: Signal;
-    runtime: {
-        raw?: StrategyEntryRuntimeOptions;
-        resolved: StrategyEntryRuntimeOptions;
-    };
-}
-type StrategyHookMlSkippedReason = 'BACKTEST' | 'DISABLED' | 'NO_RUNTIME' | 'NO_STRATEGY_CONFIG' | 'NO_THRESHOLD' | 'NO_RESULT';
-interface StrategyHookMlContext {
-    config?: StrategyRuntimeMlOptions;
-    attempted: boolean;
-    applied: boolean;
-    result?: Signal['ml'];
-    skippedReason?: StrategyHookMlSkippedReason;
-}
-type StrategyHookAiSkippedReason = 'BACKTEST' | 'DISABLED' | 'NO_RUNTIME' | 'NO_QUALITY';
-interface StrategyHookAiContext {
-    config?: StrategyRuntimeAiOptions;
-    attempted: boolean;
-    applied: boolean;
-    quality?: number;
-    skippedReason?: StrategyHookAiSkippedReason;
-}
-type StrategyHookStage = 'onInit' | 'afterCoreDecision' | 'onSkip' | 'beforeClosePosition' | 'afterEnrichMl' | 'afterEnrichAi' | 'beforeEntryGate' | 'beforePlaceOrder' | 'afterPlaceOrder' | 'runtime.beforePlaceOrder' | 'enrichSignalWithMl' | 'enrichSignalWithAi' | 'closePosition' | 'placeOrder';
-interface StrategyHookErrorPayload {
-    stage: StrategyHookStage;
-    cause: unknown;
-}
-interface StrategyHookErrorContext {
-    ctx: StrategyHookCtx;
-    market?: StrategyHookMarketContext;
-    decision?: StrategyDecision;
-    entry?: StrategyHookEntryContext;
-    error: StrategyHookErrorPayload;
-}
-interface StrategyHookInitContext {
-    ctx: StrategyHookCtx;
-    market: Required<Pick<StrategyHookMarketContext, 'data' | 'btcData'>>;
-}
-interface StrategyHookAfterDecisionContext {
-    ctx: StrategyHookCtx;
-    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
-    decision: StrategyDecision;
-}
-interface StrategyHookSkipContext extends StrategyHookAfterDecisionContext {
-    decision: Extract<StrategyDecision, {
-        kind: 'skip';
-    }>;
-}
-interface StrategyHookBeforeCloseContext extends StrategyHookAfterDecisionContext {
-    decision: ExitDecision;
-}
-interface StrategyHookEnrichContext {
-    ctx: StrategyHookCtx;
-    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
-    decision: EntryDecision;
-    entry: StrategyHookEntryContext;
-    ml: StrategyHookMlContext;
-}
-interface StrategyHookAfterAiContext extends StrategyHookEnrichContext {
-    ai: StrategyHookAiContext;
-}
-interface StrategyHookPolicyContext {
-    aiQuality?: number;
-    makeOrdersEnabled: boolean;
-    minAiQuality: number;
-}
-interface StrategyHookBeforeEntryGateContext {
-    ctx: StrategyHookCtx;
-    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
-    decision: EntryDecision;
-    entry: StrategyHookEntryContext;
-    policy: StrategyHookPolicyContext;
-    ml?: StrategyHookMlContext;
-    ai?: StrategyHookAiContext;
-}
-interface StrategyHookBeforePlaceOrderContext {
-    ctx: StrategyHookCtx;
-    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
-    decision: EntryDecision;
-    entry: StrategyHookEntryContext;
-    policy: StrategyHookPolicyContext;
-    ml?: StrategyHookMlContext;
-    ai?: StrategyHookAiContext;
-}
-interface StrategyHookOrderContext {
-    result: Signal | string;
-}
-interface StrategyHookAfterPlaceOrderContext {
-    ctx: StrategyHookCtx;
-    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
-    decision: EntryDecision;
-    entry: StrategyHookEntryContext;
-    policy: StrategyHookPolicyContext;
-    ml?: StrategyHookMlContext;
-    ai?: StrategyHookAiContext;
-    order: StrategyHookOrderContext;
-}
-interface StrategyManifest {
-    name: string;
-    entryRuntimeDefaults?: {
-        ai?: StrategyRuntimeAiOptions;
-        ml?: Pick<StrategyRuntimeMlOptions, 'enabled'>;
-    };
-    hooks?: {
-        onInit?: (params: StrategyHookInitContext) => Promise<void> | void;
-        afterCoreDecision?: (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;
-        afterEnrichAi?: (params: StrategyHookAfterAiContext) => Promise<void> | void;
-        beforeEntryGate?: (params: StrategyHookBeforeEntryGateContext) => Promise<StrategyHookGateResult | void> | StrategyHookGateResult | void;
-        beforePlaceOrder?: (params: StrategyHookBeforePlaceOrderContext) => Promise<void> | void;
-        afterPlaceOrder?: (params: StrategyHookAfterPlaceOrderContext) => Promise<void> | void;
-        onRuntimeError?: (params: StrategyHookErrorContext) => Promise<void> | void;
-    };
-    aiAdapter?: StrategyAiAdapter;
-    mlAdapter?: StrategyMlAdapter;
-}
-
 interface StrategySignalMetaParams {
     symbol: string;
     interval: Interval;
@@ -701,6 +642,21 @@ interface StrategyAPIEntryParams {
     orderPlan: StrategyEntryOrderPlan;
     runtime?: StrategyEntryRuntimeOptions;
 }
+interface StrategyAPIExitParams {
+    code?: string;
+    direction: Direction;
+    price?: number;
+    timestamp?: number;
+}
+interface StrategyProtectPlan {
+    direction: Direction;
+    stopLossPrice?: number | null;
+    takeProfits?: Tp[];
+}
+interface StrategyAPIProtectParams {
+    code?: string;
+    protectPlan: StrategyProtectPlan;
+}
 interface StrategyAPIMarketDataParams {
     preloadStart?: number;
     backtestPriceMode?: BacktestPriceMode;
@@ -811,6 +767,12 @@ interface StrategyAPI {
     entry: (params: StrategyAPIEntryParams) => Promise<Extract<StrategyDecision, {
         kind: 'entry';
     }>>;
+    exit: (params: StrategyAPIExitParams) => Promise<Extract<StrategyDecision, {
+        kind: 'exit';
+    }>>;
+    protect: (params: StrategyAPIProtectParams) => Extract<StrategyDecision, {
+        kind: 'protect';
+    }>;
     getMarketData: (params?: StrategyAPIMarketDataParams) => Promise<StrategyMarketSnapshot>;
     nextIndicators: (candle: KlineChartData[number], btcCandle: KlineChartData[number]) => unknown;
     getCurrentPosition: () => ReturnType<Connector['getPosition']>;
@@ -834,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,6 +832,10 @@ type StrategyDecision = {
     kind: 'exit';
     code: string;
     closePlan: StrategyClosePlan;
+} | {
+    kind: 'protect';
+    code: string;
+    protectPlan: StrategyProtectPlan;
 };
 interface CreateStrategyCoreParams<TConfig extends StrategyConfig, TIndicatorsState extends StrategyIndicatorsState = StrategyIndicatorsState> {
     userName: string;
@@ -876,7 +845,7 @@ interface CreateStrategyCoreParams<TConfig extends StrategyConfig, TIndicatorsSt
     connector: Connector;
     data: KlineChartData;
     btcData: KlineChartData;
-    loadPineScript: (fileNameOrPath: string, fallback?: string) => string;
+    loadPineScriptFile: (fileNameOrPath: string, fallback?: string) => string;
     strategyApi: StrategyAPI;
     indicatorsState: TIndicatorsState;
 }
@@ -922,4 +891,221 @@ interface IndicatorPluginDefinition {
     indicatorEntries: IndicatorPluginEntry[];
 }
 
-export type { AIChatHistory, AIChatMessage, AiPayload, 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, StrategyAPIMarketDataParams, 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, 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 };
+interface AiPayload {
+    signal: {
+        symbol: Signal['symbol'];
+        signalId: Signal['signalId'];
+        interval: Signal['interval'];
+        direction: Signal['direction'];
+        timestamp: Signal['timestamp'];
+        strategy: Signal['strategy'];
+        prices: {
+            currentPrice: Signal['prices']['currentPrice'];
+            takeProfitPrice: Signal['prices']['takeProfitPrice'];
+            stopLossPrice: Signal['prices']['stopLossPrice'];
+        };
+    };
+    figures: Record<string, unknown>;
+    indicators: unknown;
+    additionalIndicators: unknown;
+}
+interface StrategyAiAdapter {
+    buildPayload?: (params: {
+        signal: Signal;
+        basePayload: AiPayload;
+    }) => AiPayload;
+    postProcessAnalysis?: (params: {
+        signal: Signal;
+        payload: AiPayload;
+        analysis: Partial<SignalAnalysis>;
+    }) => Partial<SignalAnalysis>;
+    buildSystemPromptAddon?: (params: {
+        signal: Signal;
+    }) => string;
+    buildHumanPromptAddon?: (params: {
+        signal: Signal;
+        payload: AiPayload;
+    }) => string;
+    mapEntryRuntimeFromConfig?: (config: StrategyConfig) => StrategyRuntimeAiOptions | undefined;
+}
+interface StrategyMlAdapter {
+    normalizeSignal?: (signal: Signal) => Signal;
+    normalizeStrategyConfig?: (strategyConfig?: Record<string, any>) => Record<string, any> | undefined;
+    mapEntryRuntimeFromConfig?: (config: StrategyConfig) => StrategyRuntimeMlOptions | undefined;
+}
+interface StrategyHookGateResult {
+    allow?: boolean;
+    reason?: string;
+}
+type EntryDecision = Extract<StrategyDecision, {
+    kind: 'entry';
+}>;
+type ExitDecision = Extract<StrategyDecision, {
+    kind: 'exit';
+}>;
+interface StrategyHookCtx {
+    connector: Connector;
+    strategyName: string;
+    userName: string;
+    symbol: string;
+    strategyConfig: StrategyConfig;
+    env: string;
+    isConfigFromBacktest: boolean;
+}
+interface StrategyHookMarketContext {
+    candle?: KlineChartItem;
+    btcCandle?: KlineChartItem;
+    data?: KlineChartItem[];
+    btcData?: KlineChartItem[];
+}
+interface StrategyHookEntryContext {
+    context: StrategyEntrySignalContext;
+    orderPlan: StrategyEntryOrderPlan;
+    signal?: Signal;
+    runtime: {
+        raw?: StrategyEntryRuntimeOptions;
+        resolved: StrategyEntryRuntimeOptions;
+    };
+}
+type StrategyHookMlSkippedReason = 'BACKTEST' | 'DISABLED' | 'NO_RUNTIME' | 'NO_STRATEGY_CONFIG' | 'NO_THRESHOLD' | 'NO_RESULT';
+interface StrategyHookMlContext {
+    config?: StrategyRuntimeMlOptions;
+    attempted: boolean;
+    applied: boolean;
+    result?: Signal['ml'];
+    skippedReason?: StrategyHookMlSkippedReason;
+}
+type StrategyHookAiSkippedReason = 'BACKTEST' | 'DISABLED' | 'NO_RUNTIME' | 'NO_QUALITY';
+interface StrategyHookAiContext {
+    config?: StrategyRuntimeAiOptions;
+    attempted: boolean;
+    applied: boolean;
+    quality?: number;
+    skippedReason?: StrategyHookAiSkippedReason;
+}
+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;
+}
+interface StrategyHookErrorContext {
+    ctx: StrategyHookCtx;
+    market?: StrategyHookMarketContext;
+    decision?: StrategyDecision;
+    entry?: StrategyHookEntryContext;
+    error: StrategyHookErrorPayload;
+}
+interface StrategyHookInitContext {
+    ctx: StrategyHookCtx;
+    market: Required<Pick<StrategyHookMarketContext, 'data' | 'btcData'>>;
+}
+interface StrategyHookBarContext {
+    ctx: StrategyHookCtx;
+    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
+}
+interface StrategyHookAfterDecisionContext extends StrategyHookBarContext {
+    decision: StrategyDecision;
+}
+interface StrategyHookSkipContext extends StrategyHookAfterDecisionContext {
+    decision: Extract<StrategyDecision, {
+        kind: 'skip';
+    }>;
+}
+interface StrategyHookBeforeCloseContext extends StrategyHookAfterDecisionContext {
+    decision: ExitDecision;
+}
+interface StrategyHookEnrichContext {
+    ctx: StrategyHookCtx;
+    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
+    decision: EntryDecision;
+    entry: StrategyHookEntryContext;
+    ml: StrategyHookMlContext;
+}
+interface StrategyHookAfterAiContext extends StrategyHookEnrichContext {
+    ai: StrategyHookAiContext;
+}
+interface StrategyHookPolicyContext {
+    aiQuality?: number;
+    makeOrdersEnabled: boolean;
+    minAiQuality: number;
+}
+interface StrategyHookBeforeEntryGateContext {
+    ctx: StrategyHookCtx;
+    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
+    decision: EntryDecision;
+    entry: StrategyHookEntryContext;
+    policy: StrategyHookPolicyContext;
+    ml?: StrategyHookMlContext;
+    ai?: StrategyHookAiContext;
+}
+interface StrategyHookBeforePlaceOrderContext {
+    ctx: StrategyHookCtx;
+    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
+    decision: EntryDecision;
+    entry: StrategyHookEntryContext;
+    policy: StrategyHookPolicyContext;
+    ml?: StrategyHookMlContext;
+    ai?: StrategyHookAiContext;
+}
+interface StrategyHookOrderContext {
+    result: Signal | string;
+}
+interface StrategyHookAfterPlaceOrderContext {
+    ctx: StrategyHookCtx;
+    market: Required<Pick<StrategyHookMarketContext, 'candle' | 'btcCandle'>>;
+    decision: EntryDecision;
+    entry: StrategyHookEntryContext;
+    policy: StrategyHookPolicyContext;
+    ml?: StrategyHookMlContext;
+    ai?: StrategyHookAiContext;
+    order: StrategyHookOrderContext;
+}
+interface StrategyManifest {
+    name: string;
+    entryRuntimeDefaults?: {
+        ai?: StrategyRuntimeAiOptions;
+        ml?: Pick<StrategyRuntimeMlOptions, 'enabled'>;
+    };
+    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;
+        afterEnrichAi?: (params: StrategyHookAfterAiContext) => Promise<void> | void;
+        beforeEntryGate?: (params: StrategyHookBeforeEntryGateContext) => Promise<StrategyHookGateResult | void> | StrategyHookGateResult | void;
+        beforePlaceOrder?: (params: StrategyHookBeforePlaceOrderContext) => Promise<void> | void;
+        afterPlaceOrder?: (params: StrategyHookAfterPlaceOrderContext) => Promise<void> | void;
+        onRuntimeError?: (params: StrategyHookErrorContext) => Promise<void> | void;
+    };
+    aiAdapter?: StrategyAiAdapter;
+    mlAdapter?: StrategyMlAdapter;
+}
+
+interface AIChatMessage {
+    from: 'user' | 'ai';
+    text: string;
+    command?: string;
+}
+type AIChatHistory = AIChatMessage[];
+interface AiPromptPair {
+    systemPrompt: string;
+    humanPrompt: string;
+}
+interface AiDatasetRow {
+    signalId: string;
+    strategyName: string;
+    symbol: string;
+    direction: Direction;
+    timestamp: number;
+    profit: number;
+    payload: AiPayload;
+    testId?: string;
+    testSuiteId?: string;
+    testName?: string;
+    connectorName?: string;
+}
+
+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 };