@tradejs/types 1.0.4 → 1.0.6

package/README.md

@@ -1,6 +1,6 @@
 # @tradejs/types
 
-Shared TradeJS contracts and TypeScript types.
+Shared contracts and TypeScript types for the TradeJS open-source framework.
 
 - Homepage: https://tradejs.dev
 - Documentation: https://docs.tradejs.dev

package/dist/index.d.mts

@@ -74,6 +74,7 @@ interface KlineRequest {
     end: number;
     silent?: boolean;
     cacheOnly?: boolean;
+    warmOnly?: boolean;
 }
 type DerivativesInterval = '15m' | '1h';
 type DerivativesRow = {
@@ -134,8 +135,19 @@ interface ConnectorPluginDefinition {
 }
 type GetPosition = (symbol: string) => Promise<Position | null>;
 type GetPositions = () => Promise<Position[]>;
-type PlaceOrder = (order: Order, tp?: Tp[], slPrice?: Sl) => Promise<boolean>;
+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 {
@@ -145,6 +157,8 @@ interface Connector {
     getPosition: GetPosition;
     getPositions: GetPositions;
     placeOrder: PlaceOrder;
+    setTakeProfits: SetTakeProfits;
+    setStopLoss: SetStopLoss;
     closePosition: ClosePosition;
     getTickers: GetTickers;
 }
@@ -335,7 +349,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 +370,8 @@ interface MinimalStat {
 interface TestingBoxResult {
     orderLogId: string;
     stat: MinimalStat;
+    inlineOrderLog?: OrderLogData;
+    inlinePositionLog?: PositionLogData;
 }
 type TestingBox = (test: Test) => Promise<TestingBoxResult | null>;
 interface TestWorkerResult extends TestingBoxResult {
@@ -400,6 +418,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 +465,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 +529,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 +654,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']>;
@@ -867,6 +716,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 +729,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 +775,217 @@ 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' | 'afterCoreDecision' | '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 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 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, 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 };

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 = {
@@ -134,8 +135,19 @@ interface ConnectorPluginDefinition {
 }
 type GetPosition = (symbol: string) => Promise<Position | null>;
 type GetPositions = () => Promise<Position[]>;
-type PlaceOrder = (order: Order, tp?: Tp[], slPrice?: Sl) => Promise<boolean>;
+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 {
@@ -145,6 +157,8 @@ interface Connector {
     getPosition: GetPosition;
     getPositions: GetPositions;
     placeOrder: PlaceOrder;
+    setTakeProfits: SetTakeProfits;
+    setStopLoss: SetStopLoss;
     closePosition: ClosePosition;
     getTickers: GetTickers;
 }
@@ -335,7 +349,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 +370,8 @@ interface MinimalStat {
 interface TestingBoxResult {
     orderLogId: string;
     stat: MinimalStat;
+    inlineOrderLog?: OrderLogData;
+    inlinePositionLog?: PositionLogData;
 }
 type TestingBox = (test: Test) => Promise<TestingBoxResult | null>;
 interface TestWorkerResult extends TestingBoxResult {
@@ -400,6 +418,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 +465,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 +529,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 +654,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']>;
@@ -867,6 +716,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 +729,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 +775,217 @@ 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' | 'afterCoreDecision' | '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 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 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, 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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tradejs/types",
-  "version": "1.0.4",
-  "description": "Shared TypeScript contracts for the TradeJS ecosystem.",
+  "version": "1.0.6",
+  "description": "Shared TypeScript contracts for the TradeJS open-source framework.",
   "keywords": [
     "tradejs",
     "trading",
@@ -10,6 +10,14 @@
     "types",
     "contracts"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tradejs-dev/tradejs.git",
+    "directory": "packages/types"
+  },
+  "bugs": {
+    "url": "https://github.com/tradejs-dev/tradejs/issues"
+  },
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",