jcc_hyper_tool 0.1.4 → 0.1.6

package/dist/core/state/schema.d.ts

@@ -11,6 +11,8 @@ declare const BracketIntentSchema: z.ZodObject<{
     entryLimitPx: z.ZodNumber;
     entrySz: z.ZodNumber;
     tif: z.ZodEnum<["Gtc", "Ioc", "Alo"]>;
+    /** Trading strategy: ambush (limit entry, wider SL/TP) or scalp (market entry, tight SL/TP). */
+    strategy: z.ZodOptional<z.ZodEnum<["scalp", "ambush"]>>;
     entryReduceOnly: z.ZodOptional<z.ZodBoolean>;
     tpTriggerPx: z.ZodNumber;
     slTriggerPx: z.ZodNumber;
@@ -48,9 +50,10 @@ declare const BracketIntentSchema: z.ZodObject<{
     slTriggerPx: number;
     tpslIsMarket: boolean;
     protectionReduceOnly: boolean;
-    phase: "cancelled" | "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "expired" | "error";
-    network?: string | undefined;
+    phase: "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "cancelled" | "expired" | "error";
     dex?: string | undefined;
+    network?: string | undefined;
+    strategy?: "scalp" | "ambush" | undefined;
     entryReduceOnly?: boolean | undefined;
     tpslLimitPx?: number | undefined;
     entryOid?: number | undefined;
@@ -76,9 +79,10 @@ declare const BracketIntentSchema: z.ZodObject<{
     tpTriggerPx: number;
     slTriggerPx: number;
     tpslIsMarket: boolean;
-    phase: "cancelled" | "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "expired" | "error";
-    network?: string | undefined;
+    phase: "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "cancelled" | "expired" | "error";
     dex?: string | undefined;
+    network?: string | undefined;
+    strategy?: "scalp" | "ambush" | undefined;
     entryReduceOnly?: boolean | undefined;
     tpslLimitPx?: number | undefined;
     protectionReduceOnly?: boolean | undefined;
@@ -117,6 +121,8 @@ declare const GridIntentSchema: z.ZodObject<{
     replenishGapPx: z.ZodOptional<z.ZodNumber>;
     /** Idempotency for grid replenishment (plan:/done: prefixes, see mergeGridReplenishDedupe). */
     replenishDedupeKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** User set this to true to regenerate legs from current lower/upper/grids/bias on next reconcile. */
+    regenerateGrid: z.ZodOptional<z.ZodBoolean>;
     legs: z.ZodArray<z.ZodObject<{
         index: z.ZodNumber;
         px: z.ZodNumber;
@@ -138,10 +144,10 @@ declare const GridIntentSchema: z.ZodObject<{
             fillPx: number;
         }>>;
     }, "strip", z.ZodTypeAny, {
+        isBuy: boolean;
         index: number;
         px: number;
-        isBuy: boolean;
-        legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+        legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
         oid?: number | undefined;
         lastSz?: number | undefined;
         lastOrigSz?: number | undefined;
@@ -150,10 +156,10 @@ declare const GridIntentSchema: z.ZodObject<{
             fillPx: number;
         } | undefined;
     }, {
+        isBuy: boolean;
         index: number;
         px: number;
-        isBuy: boolean;
-        legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+        legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
         oid?: number | undefined;
         lastSz?: number | undefined;
         lastOrigSz?: number | undefined;
@@ -164,7 +170,6 @@ declare const GridIntentSchema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     coin: string;
-    reduceOnly: boolean;
     kind: "grid";
     id: string;
     createdAtMs: number;
@@ -175,11 +180,12 @@ declare const GridIntentSchema: z.ZodObject<{
     grids: number;
     orderSz: number;
     bias: "symmetric" | "long" | "short";
+    reduceOnly: boolean;
     legs: {
+        isBuy: boolean;
         index: number;
         px: number;
-        isBuy: boolean;
-        legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+        legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
         oid?: number | undefined;
         lastSz?: number | undefined;
         lastOrigSz?: number | undefined;
@@ -188,14 +194,14 @@ declare const GridIntentSchema: z.ZodObject<{
             fillPx: number;
         } | undefined;
     }[];
-    network?: string | undefined;
     dex?: string | undefined;
+    network?: string | undefined;
     maxOrders?: number | undefined;
     replenishGapPx?: number | undefined;
     replenishDedupeKeys?: string[] | undefined;
+    regenerateGrid?: boolean | undefined;
 }, {
     coin: string;
-    reduceOnly: boolean;
     kind: "grid";
     id: string;
     createdAtMs: number;
@@ -206,11 +212,12 @@ declare const GridIntentSchema: z.ZodObject<{
     grids: number;
     orderSz: number;
     bias: "symmetric" | "long" | "short";
+    reduceOnly: boolean;
     legs: {
+        isBuy: boolean;
         index: number;
         px: number;
-        isBuy: boolean;
-        legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+        legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
         oid?: number | undefined;
         lastSz?: number | undefined;
         lastOrigSz?: number | undefined;
@@ -219,11 +226,12 @@ declare const GridIntentSchema: z.ZodObject<{
             fillPx: number;
         } | undefined;
     }[];
-    network?: string | undefined;
     dex?: string | undefined;
+    network?: string | undefined;
     maxOrders?: number | undefined;
     replenishGapPx?: number | undefined;
     replenishDedupeKeys?: string[] | undefined;
+    regenerateGrid?: boolean | undefined;
 }>;
 declare const SingleLimitIntentSchema: z.ZodObject<{
     kind: z.ZodLiteral<"single_limit">;
@@ -239,31 +247,31 @@ declare const SingleLimitIntentSchema: z.ZodObject<{
     reduceOnly: z.ZodBoolean;
     oid: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    coin: string;
     sz: number;
-    reduceOnly: boolean;
-    limitPx: number;
+    coin: string;
     kind: "single_limit";
     id: string;
     createdAtMs: number;
     updatedAtMs: number;
     entrySide: "buy" | "sell";
     tif: "Gtc" | "Ioc" | "Alo";
-    dex?: string | undefined;
+    reduceOnly: boolean;
+    limitPx: number;
     oid?: number | undefined;
+    dex?: string | undefined;
 }, {
-    coin: string;
     sz: number;
-    reduceOnly: boolean;
-    limitPx: number;
+    coin: string;
     kind: "single_limit";
     id: string;
     createdAtMs: number;
     updatedAtMs: number;
     entrySide: "buy" | "sell";
     tif: "Gtc" | "Ioc" | "Alo";
-    dex?: string | undefined;
+    reduceOnly: boolean;
+    limitPx: number;
     oid?: number | undefined;
+    dex?: string | undefined;
 }>;
 declare const StandaloneTpslIntentSchema: z.ZodObject<{
     kind: z.ZodLiteral<"standalone_tpsl">;
@@ -281,34 +289,34 @@ declare const StandaloneTpslIntentSchema: z.ZodObject<{
     reduceOnly: z.ZodBoolean;
     oid: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    coin: string;
     side: "buy" | "sell";
     sz: number;
-    reduceOnly: boolean;
-    triggerPx: number;
+    coin: string;
     kind: "standalone_tpsl";
     id: string;
     createdAtMs: number;
     updatedAtMs: number;
+    reduceOnly: boolean;
+    triggerPx: number;
     tpsl: "tp" | "sl";
     isMarket: boolean;
-    dex?: string | undefined;
     oid?: number | undefined;
+    dex?: string | undefined;
     limitPx?: number | undefined;
 }, {
-    coin: string;
     side: "buy" | "sell";
     sz: number;
-    reduceOnly: boolean;
-    triggerPx: number;
+    coin: string;
     kind: "standalone_tpsl";
     id: string;
     createdAtMs: number;
     updatedAtMs: number;
+    reduceOnly: boolean;
+    triggerPx: number;
     tpsl: "tp" | "sl";
     isMarket: boolean;
-    dex?: string | undefined;
     oid?: number | undefined;
+    dex?: string | undefined;
     limitPx?: number | undefined;
 }>;
 export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -323,6 +331,8 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     entryLimitPx: z.ZodNumber;
     entrySz: z.ZodNumber;
     tif: z.ZodEnum<["Gtc", "Ioc", "Alo"]>;
+    /** Trading strategy: ambush (limit entry, wider SL/TP) or scalp (market entry, tight SL/TP). */
+    strategy: z.ZodOptional<z.ZodEnum<["scalp", "ambush"]>>;
     entryReduceOnly: z.ZodOptional<z.ZodBoolean>;
     tpTriggerPx: z.ZodNumber;
     slTriggerPx: z.ZodNumber;
@@ -360,9 +370,10 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     slTriggerPx: number;
     tpslIsMarket: boolean;
     protectionReduceOnly: boolean;
-    phase: "cancelled" | "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "expired" | "error";
-    network?: string | undefined;
+    phase: "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "cancelled" | "expired" | "error";
     dex?: string | undefined;
+    network?: string | undefined;
+    strategy?: "scalp" | "ambush" | undefined;
     entryReduceOnly?: boolean | undefined;
     tpslLimitPx?: number | undefined;
     entryOid?: number | undefined;
@@ -388,9 +399,10 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     tpTriggerPx: number;
     slTriggerPx: number;
     tpslIsMarket: boolean;
-    phase: "cancelled" | "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "expired" | "error";
-    network?: string | undefined;
+    phase: "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "cancelled" | "expired" | "error";
     dex?: string | undefined;
+    network?: string | undefined;
+    strategy?: "scalp" | "ambush" | undefined;
     entryReduceOnly?: boolean | undefined;
     tpslLimitPx?: number | undefined;
     protectionReduceOnly?: boolean | undefined;
@@ -428,6 +440,8 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     replenishGapPx: z.ZodOptional<z.ZodNumber>;
     /** Idempotency for grid replenishment (plan:/done: prefixes, see mergeGridReplenishDedupe). */
     replenishDedupeKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** User set this to true to regenerate legs from current lower/upper/grids/bias on next reconcile. */
+    regenerateGrid: z.ZodOptional<z.ZodBoolean>;
     legs: z.ZodArray<z.ZodObject<{
         index: z.ZodNumber;
         px: z.ZodNumber;
@@ -449,10 +463,10 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
             fillPx: number;
         }>>;
     }, "strip", z.ZodTypeAny, {
+        isBuy: boolean;
         index: number;
         px: number;
-        isBuy: boolean;
-        legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+        legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
         oid?: number | undefined;
         lastSz?: number | undefined;
         lastOrigSz?: number | undefined;
@@ -461,10 +475,10 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
             fillPx: number;
         } | undefined;
     }, {
+        isBuy: boolean;
         index: number;
         px: number;
-        isBuy: boolean;
-        legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+        legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
         oid?: number | undefined;
         lastSz?: number | undefined;
         lastOrigSz?: number | undefined;
@@ -475,7 +489,6 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     coin: string;
-    reduceOnly: boolean;
     kind: "grid";
     id: string;
     createdAtMs: number;
@@ -486,11 +499,12 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     grids: number;
     orderSz: number;
     bias: "symmetric" | "long" | "short";
+    reduceOnly: boolean;
     legs: {
+        isBuy: boolean;
         index: number;
         px: number;
-        isBuy: boolean;
-        legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+        legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
         oid?: number | undefined;
         lastSz?: number | undefined;
         lastOrigSz?: number | undefined;
@@ -499,14 +513,14 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
             fillPx: number;
         } | undefined;
     }[];
-    network?: string | undefined;
     dex?: string | undefined;
+    network?: string | undefined;
     maxOrders?: number | undefined;
     replenishGapPx?: number | undefined;
     replenishDedupeKeys?: string[] | undefined;
+    regenerateGrid?: boolean | undefined;
 }, {
     coin: string;
-    reduceOnly: boolean;
     kind: "grid";
     id: string;
     createdAtMs: number;
@@ -517,11 +531,12 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     grids: number;
     orderSz: number;
     bias: "symmetric" | "long" | "short";
+    reduceOnly: boolean;
     legs: {
+        isBuy: boolean;
         index: number;
         px: number;
-        isBuy: boolean;
-        legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+        legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
         oid?: number | undefined;
         lastSz?: number | undefined;
         lastOrigSz?: number | undefined;
@@ -530,11 +545,12 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
             fillPx: number;
         } | undefined;
     }[];
-    network?: string | undefined;
     dex?: string | undefined;
+    network?: string | undefined;
     maxOrders?: number | undefined;
     replenishGapPx?: number | undefined;
     replenishDedupeKeys?: string[] | undefined;
+    regenerateGrid?: boolean | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"single_limit">;
     id: z.ZodString;
@@ -549,31 +565,31 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     reduceOnly: z.ZodBoolean;
     oid: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    coin: string;
     sz: number;
-    reduceOnly: boolean;
-    limitPx: number;
+    coin: string;
     kind: "single_limit";
     id: string;
     createdAtMs: number;
     updatedAtMs: number;
     entrySide: "buy" | "sell";
     tif: "Gtc" | "Ioc" | "Alo";
-    dex?: string | undefined;
+    reduceOnly: boolean;
+    limitPx: number;
     oid?: number | undefined;
+    dex?: string | undefined;
 }, {
-    coin: string;
     sz: number;
-    reduceOnly: boolean;
-    limitPx: number;
+    coin: string;
     kind: "single_limit";
     id: string;
     createdAtMs: number;
     updatedAtMs: number;
     entrySide: "buy" | "sell";
     tif: "Gtc" | "Ioc" | "Alo";
-    dex?: string | undefined;
+    reduceOnly: boolean;
+    limitPx: number;
     oid?: number | undefined;
+    dex?: string | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"standalone_tpsl">;
     id: z.ZodString;
@@ -590,34 +606,34 @@ export declare const IntentRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     reduceOnly: z.ZodBoolean;
     oid: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    coin: string;
     side: "buy" | "sell";
     sz: number;
-    reduceOnly: boolean;
-    triggerPx: number;
+    coin: string;
     kind: "standalone_tpsl";
     id: string;
     createdAtMs: number;
     updatedAtMs: number;
+    reduceOnly: boolean;
+    triggerPx: number;
     tpsl: "tp" | "sl";
     isMarket: boolean;
-    dex?: string | undefined;
     oid?: number | undefined;
+    dex?: string | undefined;
     limitPx?: number | undefined;
 }, {
-    coin: string;
     side: "buy" | "sell";
     sz: number;
-    reduceOnly: boolean;
-    triggerPx: number;
+    coin: string;
     kind: "standalone_tpsl";
     id: string;
     createdAtMs: number;
     updatedAtMs: number;
+    reduceOnly: boolean;
+    triggerPx: number;
     tpsl: "tp" | "sl";
     isMarket: boolean;
-    dex?: string | undefined;
     oid?: number | undefined;
+    dex?: string | undefined;
     limitPx?: number | undefined;
 }>]>;
 export type IntentRecord = z.infer<typeof IntentRecordSchema>;
@@ -625,6 +641,171 @@ export type BracketIntentRecord = z.infer<typeof BracketIntentSchema>;
 export type GridIntentRecord = z.infer<typeof GridIntentSchema>;
 export type SingleLimitIntentRecord = z.infer<typeof SingleLimitIntentSchema>;
 export type StandaloneTpslIntentRecord = z.infer<typeof StandaloneTpslIntentSchema>;
+/** Optional per-user trading preferences (advisor prompts, guards). Not touched by reconcile / cancel-open. */
+export declare const UserProfileSchema: z.ZodObject<{
+    risk: z.ZodDefault<z.ZodEnum<["conservative", "balanced", "aggressive"]>>;
+    defaultMaxSz: z.ZodOptional<z.ZodNumber>;
+    maxSzByCoin: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    /** Advisor / bracket minimum sz floor (profile guard; HL $10 notional still applies). */
+    defaultMinSz: z.ZodOptional<z.ZodNumber>;
+    minSzByCoin: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    requireTpsl: z.ZodDefault<z.ZodBoolean>;
+    priceDeviationPctMax: z.ZodDefault<z.ZodNumber>;
+    tradingStyleNotes: z.ZodOptional<z.ZodString>;
+    updatedAtMs: z.ZodOptional<z.ZodNumber>;
+    /** Optional isolated-margin auto top-up during `state reconcile` (default disabled). */
+    isolatedTopUp: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        safeDistancePct: z.ZodDefault<z.ZodNumber>;
+        safetyFactor: z.ZodDefault<z.ZodNumber>;
+        reserveUsd: z.ZodDefault<z.ZodNumber>;
+        minTopUpUsd: z.ZodDefault<z.ZodNumber>;
+        minPartialUsd: z.ZodDefault<z.ZodNumber>;
+        maxSingleTopUpUsd: z.ZodDefault<z.ZodNumber>;
+        maxDailyTopUpUsd: z.ZodDefault<z.ZodNumber>;
+        cooldownSec: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        safeDistancePct: number;
+        safetyFactor: number;
+        reserveUsd: number;
+        minTopUpUsd: number;
+        minPartialUsd: number;
+        maxSingleTopUpUsd: number;
+        maxDailyTopUpUsd: number;
+        cooldownSec: number;
+    }, {
+        enabled?: boolean | undefined;
+        safeDistancePct?: number | undefined;
+        safetyFactor?: number | undefined;
+        reserveUsd?: number | undefined;
+        minTopUpUsd?: number | undefined;
+        minPartialUsd?: number | undefined;
+        maxSingleTopUpUsd?: number | undefined;
+        maxDailyTopUpUsd?: number | undefined;
+        cooldownSec?: number | undefined;
+    }>>;
+    /** Min model confidence (0–1) required before `advise` execute / `--auto`. 0 = disabled. */
+    minConfidenceToExecute: z.ZodOptional<z.ZodNumber>;
+    /** Random limit-price offset fraction (e.g. 0.002 = up to ±0.2%). 0 = disabled. */
+    limitPriceJitterPct: z.ZodOptional<z.ZodNumber>;
+    /** Min seconds between same coin+action executions (open_with_bracket also keyed by side). 0 = disabled. */
+    executeCooldownSec: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Bracket entry shift toward model SL (0=off, 1=entry at SL, TP/SL translated equally).
+     * Limit-only: unfilled = no position.
+     */
+    bracketSlEntryShift: z.ZodOptional<z.ZodNumber>;
+    /** Relative limit deviation above which advise replaces a pending TTL ambush (default: priceDeviationPctMax). */
+    ambushReplaceDeviationPct: z.ZodOptional<z.ZodNumber>;
+    /** Min seconds after open before advise may close without TP/SL hit (0 = disabled). Applies to all bracket-linked positions. */
+    antiRushCloseMinSec: z.ZodOptional<z.ZodNumber>;
+    /** After entry fill, wait this long for reconcile to place TP/SL before allow close (default 360s ≈ one advise round). */
+    protectionGraceSec: z.ZodOptional<z.ZodNumber>;
+    /** Block close when |unrealized PnL| below this fraction of entry (e.g. 0.01 = 1%) unless tp_unreachable. */
+    minClosePnlPct: z.ZodOptional<z.ZodNumber>;
+    /** Min TP distance / SL distance from bracket entry (default by risk: conservative 2.5, balanced 2, aggressive 1.5). */
+    minRewardRiskRatio: z.ZodOptional<z.ZodNumber>;
+    /** Max SL distance from entry as fraction of entry px (default by risk: conservative 1.2%, balanced 2%, aggressive 3%). */
+    maxSlPctFromEntry: z.ZodOptional<z.ZodNumber>;
+    /** Block bracket when computed SL touch prob exceeds this (ATR barrier model). */
+    maxSlTouchProb: z.ZodOptional<z.ZodNumber>;
+    /** Block when SL touch prob × slSweepLiquidityMultiplier exceeds this (stop-hunt adjusted). */
+    maxSlSweepProb: z.ZodOptional<z.ZodNumber>;
+    /** Move SL away from structure by this × ATR₁h before execute (buy: down, sell: up). 0 = off. */
+    slAntiSweepAtrFactor: z.ZodOptional<z.ZodNumber>;
+    /** Multiplier on SL touch prob to approximate stop-hunt / AI sweep risk (default 2). */
+    slSweepLiquidityMultiplier: z.ZodOptional<z.ZodNumber>;
+    /** Default ambush TTL minutes when model omits expires_in_min (15–30 typical). */
+    defaultAmbushExpiresMin: z.ZodOptional<z.ZodNumber>;
+    /** Block cancel_all while unexpired TTL ambush entry is still pending (default true). */
+    forbidCancelAllWithActiveAmbush: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    risk: "conservative" | "balanced" | "aggressive";
+    requireTpsl: boolean;
+    priceDeviationPctMax: number;
+    forbidCancelAllWithActiveAmbush: boolean;
+    updatedAtMs?: number | undefined;
+    defaultMaxSz?: number | undefined;
+    maxSzByCoin?: Record<string, number> | undefined;
+    defaultMinSz?: number | undefined;
+    minSzByCoin?: Record<string, number> | undefined;
+    tradingStyleNotes?: string | undefined;
+    isolatedTopUp?: {
+        enabled: boolean;
+        safeDistancePct: number;
+        safetyFactor: number;
+        reserveUsd: number;
+        minTopUpUsd: number;
+        minPartialUsd: number;
+        maxSingleTopUpUsd: number;
+        maxDailyTopUpUsd: number;
+        cooldownSec: number;
+    } | undefined;
+    minConfidenceToExecute?: number | undefined;
+    limitPriceJitterPct?: number | undefined;
+    executeCooldownSec?: number | undefined;
+    bracketSlEntryShift?: number | undefined;
+    ambushReplaceDeviationPct?: number | undefined;
+    antiRushCloseMinSec?: number | undefined;
+    protectionGraceSec?: number | undefined;
+    minClosePnlPct?: number | undefined;
+    minRewardRiskRatio?: number | undefined;
+    maxSlPctFromEntry?: number | undefined;
+    maxSlTouchProb?: number | undefined;
+    maxSlSweepProb?: number | undefined;
+    slAntiSweepAtrFactor?: number | undefined;
+    slSweepLiquidityMultiplier?: number | undefined;
+    defaultAmbushExpiresMin?: number | undefined;
+}, {
+    updatedAtMs?: number | undefined;
+    risk?: "conservative" | "balanced" | "aggressive" | undefined;
+    defaultMaxSz?: number | undefined;
+    maxSzByCoin?: Record<string, number> | undefined;
+    defaultMinSz?: number | undefined;
+    minSzByCoin?: Record<string, number> | undefined;
+    requireTpsl?: boolean | undefined;
+    priceDeviationPctMax?: number | undefined;
+    tradingStyleNotes?: string | undefined;
+    isolatedTopUp?: {
+        enabled?: boolean | undefined;
+        safeDistancePct?: number | undefined;
+        safetyFactor?: number | undefined;
+        reserveUsd?: number | undefined;
+        minTopUpUsd?: number | undefined;
+        minPartialUsd?: number | undefined;
+        maxSingleTopUpUsd?: number | undefined;
+        maxDailyTopUpUsd?: number | undefined;
+        cooldownSec?: number | undefined;
+    } | undefined;
+    minConfidenceToExecute?: number | undefined;
+    limitPriceJitterPct?: number | undefined;
+    executeCooldownSec?: number | undefined;
+    bracketSlEntryShift?: number | undefined;
+    ambushReplaceDeviationPct?: number | undefined;
+    antiRushCloseMinSec?: number | undefined;
+    protectionGraceSec?: number | undefined;
+    minClosePnlPct?: number | undefined;
+    minRewardRiskRatio?: number | undefined;
+    maxSlPctFromEntry?: number | undefined;
+    maxSlTouchProb?: number | undefined;
+    maxSlSweepProb?: number | undefined;
+    slAntiSweepAtrFactor?: number | undefined;
+    slSweepLiquidityMultiplier?: number | undefined;
+    defaultAmbushExpiresMin?: number | undefined;
+    forbidCancelAllWithActiveAmbush?: boolean | undefined;
+}>;
+export type UserProfile = z.infer<typeof UserProfileSchema>;
+export declare const AdviseExecuteRecordSchema: z.ZodObject<{
+    action: z.ZodString;
+    atMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    action: string;
+    atMs: number;
+}, {
+    action: string;
+    atMs: number;
+}>;
 export declare const TradeStateFileSchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
     updatedAtMs: z.ZodNumber;
@@ -640,6 +821,8 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         entryLimitPx: z.ZodNumber;
         entrySz: z.ZodNumber;
         tif: z.ZodEnum<["Gtc", "Ioc", "Alo"]>;
+        /** Trading strategy: ambush (limit entry, wider SL/TP) or scalp (market entry, tight SL/TP). */
+        strategy: z.ZodOptional<z.ZodEnum<["scalp", "ambush"]>>;
         entryReduceOnly: z.ZodOptional<z.ZodBoolean>;
         tpTriggerPx: z.ZodNumber;
         slTriggerPx: z.ZodNumber;
@@ -677,9 +860,10 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         slTriggerPx: number;
         tpslIsMarket: boolean;
         protectionReduceOnly: boolean;
-        phase: "cancelled" | "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "expired" | "error";
-        network?: string | undefined;
+        phase: "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "cancelled" | "expired" | "error";
         dex?: string | undefined;
+        network?: string | undefined;
+        strategy?: "scalp" | "ambush" | undefined;
         entryReduceOnly?: boolean | undefined;
         tpslLimitPx?: number | undefined;
         entryOid?: number | undefined;
@@ -705,9 +889,10 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         tpTriggerPx: number;
         slTriggerPx: number;
         tpslIsMarket: boolean;
-        phase: "cancelled" | "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "expired" | "error";
-        network?: string | undefined;
+        phase: "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "cancelled" | "expired" | "error";
         dex?: string | undefined;
+        network?: string | undefined;
+        strategy?: "scalp" | "ambush" | undefined;
         entryReduceOnly?: boolean | undefined;
         tpslLimitPx?: number | undefined;
         protectionReduceOnly?: boolean | undefined;
@@ -745,6 +930,8 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         replenishGapPx: z.ZodOptional<z.ZodNumber>;
         /** Idempotency for grid replenishment (plan:/done: prefixes, see mergeGridReplenishDedupe). */
         replenishDedupeKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** User set this to true to regenerate legs from current lower/upper/grids/bias on next reconcile. */
+        regenerateGrid: z.ZodOptional<z.ZodBoolean>;
         legs: z.ZodArray<z.ZodObject<{
             index: z.ZodNumber;
             px: z.ZodNumber;
@@ -766,10 +953,10 @@ export declare const TradeStateFileSchema: z.ZodObject<{
                 fillPx: number;
             }>>;
         }, "strip", z.ZodTypeAny, {
+            isBuy: boolean;
             index: number;
             px: number;
-            isBuy: boolean;
-            legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+            legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
             oid?: number | undefined;
             lastSz?: number | undefined;
             lastOrigSz?: number | undefined;
@@ -778,10 +965,10 @@ export declare const TradeStateFileSchema: z.ZodObject<{
                 fillPx: number;
             } | undefined;
         }, {
+            isBuy: boolean;
             index: number;
             px: number;
-            isBuy: boolean;
-            legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+            legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
             oid?: number | undefined;
             lastSz?: number | undefined;
             lastOrigSz?: number | undefined;
@@ -792,7 +979,6 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         coin: string;
-        reduceOnly: boolean;
         kind: "grid";
         id: string;
         createdAtMs: number;
@@ -803,11 +989,12 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         grids: number;
         orderSz: number;
         bias: "symmetric" | "long" | "short";
+        reduceOnly: boolean;
         legs: {
+            isBuy: boolean;
             index: number;
             px: number;
-            isBuy: boolean;
-            legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+            legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
             oid?: number | undefined;
             lastSz?: number | undefined;
             lastOrigSz?: number | undefined;
@@ -816,14 +1003,14 @@ export declare const TradeStateFileSchema: z.ZodObject<{
                 fillPx: number;
             } | undefined;
         }[];
-        network?: string | undefined;
         dex?: string | undefined;
+        network?: string | undefined;
         maxOrders?: number | undefined;
         replenishGapPx?: number | undefined;
         replenishDedupeKeys?: string[] | undefined;
+        regenerateGrid?: boolean | undefined;
     }, {
         coin: string;
-        reduceOnly: boolean;
         kind: "grid";
         id: string;
         createdAtMs: number;
@@ -834,11 +1021,12 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         grids: number;
         orderSz: number;
         bias: "symmetric" | "long" | "short";
+        reduceOnly: boolean;
         legs: {
+            isBuy: boolean;
             index: number;
             px: number;
-            isBuy: boolean;
-            legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+            legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
             oid?: number | undefined;
             lastSz?: number | undefined;
             lastOrigSz?: number | undefined;
@@ -847,11 +1035,12 @@ export declare const TradeStateFileSchema: z.ZodObject<{
                 fillPx: number;
             } | undefined;
         }[];
-        network?: string | undefined;
         dex?: string | undefined;
+        network?: string | undefined;
         maxOrders?: number | undefined;
         replenishGapPx?: number | undefined;
         replenishDedupeKeys?: string[] | undefined;
+        regenerateGrid?: boolean | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"single_limit">;
         id: z.ZodString;
@@ -866,31 +1055,31 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         reduceOnly: z.ZodBoolean;
         oid: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        coin: string;
         sz: number;
-        reduceOnly: boolean;
-        limitPx: number;
+        coin: string;
         kind: "single_limit";
         id: string;
         createdAtMs: number;
         updatedAtMs: number;
         entrySide: "buy" | "sell";
         tif: "Gtc" | "Ioc" | "Alo";
-        dex?: string | undefined;
+        reduceOnly: boolean;
+        limitPx: number;
         oid?: number | undefined;
+        dex?: string | undefined;
     }, {
-        coin: string;
         sz: number;
-        reduceOnly: boolean;
-        limitPx: number;
+        coin: string;
         kind: "single_limit";
         id: string;
         createdAtMs: number;
         updatedAtMs: number;
         entrySide: "buy" | "sell";
         tif: "Gtc" | "Ioc" | "Alo";
-        dex?: string | undefined;
+        reduceOnly: boolean;
+        limitPx: number;
         oid?: number | undefined;
+        dex?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"standalone_tpsl">;
         id: z.ZodString;
@@ -907,34 +1096,34 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         reduceOnly: z.ZodBoolean;
         oid: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        coin: string;
         side: "buy" | "sell";
         sz: number;
-        reduceOnly: boolean;
-        triggerPx: number;
+        coin: string;
         kind: "standalone_tpsl";
         id: string;
         createdAtMs: number;
         updatedAtMs: number;
+        reduceOnly: boolean;
+        triggerPx: number;
         tpsl: "tp" | "sl";
         isMarket: boolean;
-        dex?: string | undefined;
         oid?: number | undefined;
+        dex?: string | undefined;
         limitPx?: number | undefined;
     }, {
-        coin: string;
         side: "buy" | "sell";
         sz: number;
-        reduceOnly: boolean;
-        triggerPx: number;
+        coin: string;
         kind: "standalone_tpsl";
         id: string;
         createdAtMs: number;
         updatedAtMs: number;
+        reduceOnly: boolean;
+        triggerPx: number;
         tpsl: "tp" | "sl";
         isMarket: boolean;
-        dex?: string | undefined;
         oid?: number | undefined;
+        dex?: string | undefined;
         limitPx?: number | undefined;
     }>]>>;
     events: z.ZodArray<z.ZodObject<{
@@ -956,6 +1145,170 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         message?: string | undefined;
         data?: Record<string, unknown> | undefined;
     }>, "many">;
+    userProfile: z.ZodOptional<z.ZodObject<{
+        risk: z.ZodDefault<z.ZodEnum<["conservative", "balanced", "aggressive"]>>;
+        defaultMaxSz: z.ZodOptional<z.ZodNumber>;
+        maxSzByCoin: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        /** Advisor / bracket minimum sz floor (profile guard; HL $10 notional still applies). */
+        defaultMinSz: z.ZodOptional<z.ZodNumber>;
+        minSzByCoin: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        requireTpsl: z.ZodDefault<z.ZodBoolean>;
+        priceDeviationPctMax: z.ZodDefault<z.ZodNumber>;
+        tradingStyleNotes: z.ZodOptional<z.ZodString>;
+        updatedAtMs: z.ZodOptional<z.ZodNumber>;
+        /** Optional isolated-margin auto top-up during `state reconcile` (default disabled). */
+        isolatedTopUp: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            safeDistancePct: z.ZodDefault<z.ZodNumber>;
+            safetyFactor: z.ZodDefault<z.ZodNumber>;
+            reserveUsd: z.ZodDefault<z.ZodNumber>;
+            minTopUpUsd: z.ZodDefault<z.ZodNumber>;
+            minPartialUsd: z.ZodDefault<z.ZodNumber>;
+            maxSingleTopUpUsd: z.ZodDefault<z.ZodNumber>;
+            maxDailyTopUpUsd: z.ZodDefault<z.ZodNumber>;
+            cooldownSec: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            safeDistancePct: number;
+            safetyFactor: number;
+            reserveUsd: number;
+            minTopUpUsd: number;
+            minPartialUsd: number;
+            maxSingleTopUpUsd: number;
+            maxDailyTopUpUsd: number;
+            cooldownSec: number;
+        }, {
+            enabled?: boolean | undefined;
+            safeDistancePct?: number | undefined;
+            safetyFactor?: number | undefined;
+            reserveUsd?: number | undefined;
+            minTopUpUsd?: number | undefined;
+            minPartialUsd?: number | undefined;
+            maxSingleTopUpUsd?: number | undefined;
+            maxDailyTopUpUsd?: number | undefined;
+            cooldownSec?: number | undefined;
+        }>>;
+        /** Min model confidence (0–1) required before `advise` execute / `--auto`. 0 = disabled. */
+        minConfidenceToExecute: z.ZodOptional<z.ZodNumber>;
+        /** Random limit-price offset fraction (e.g. 0.002 = up to ±0.2%). 0 = disabled. */
+        limitPriceJitterPct: z.ZodOptional<z.ZodNumber>;
+        /** Min seconds between same coin+action executions (open_with_bracket also keyed by side). 0 = disabled. */
+        executeCooldownSec: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Bracket entry shift toward model SL (0=off, 1=entry at SL, TP/SL translated equally).
+         * Limit-only: unfilled = no position.
+         */
+        bracketSlEntryShift: z.ZodOptional<z.ZodNumber>;
+        /** Relative limit deviation above which advise replaces a pending TTL ambush (default: priceDeviationPctMax). */
+        ambushReplaceDeviationPct: z.ZodOptional<z.ZodNumber>;
+        /** Min seconds after open before advise may close without TP/SL hit (0 = disabled). Applies to all bracket-linked positions. */
+        antiRushCloseMinSec: z.ZodOptional<z.ZodNumber>;
+        /** After entry fill, wait this long for reconcile to place TP/SL before allow close (default 360s ≈ one advise round). */
+        protectionGraceSec: z.ZodOptional<z.ZodNumber>;
+        /** Block close when |unrealized PnL| below this fraction of entry (e.g. 0.01 = 1%) unless tp_unreachable. */
+        minClosePnlPct: z.ZodOptional<z.ZodNumber>;
+        /** Min TP distance / SL distance from bracket entry (default by risk: conservative 2.5, balanced 2, aggressive 1.5). */
+        minRewardRiskRatio: z.ZodOptional<z.ZodNumber>;
+        /** Max SL distance from entry as fraction of entry px (default by risk: conservative 1.2%, balanced 2%, aggressive 3%). */
+        maxSlPctFromEntry: z.ZodOptional<z.ZodNumber>;
+        /** Block bracket when computed SL touch prob exceeds this (ATR barrier model). */
+        maxSlTouchProb: z.ZodOptional<z.ZodNumber>;
+        /** Block when SL touch prob × slSweepLiquidityMultiplier exceeds this (stop-hunt adjusted). */
+        maxSlSweepProb: z.ZodOptional<z.ZodNumber>;
+        /** Move SL away from structure by this × ATR₁h before execute (buy: down, sell: up). 0 = off. */
+        slAntiSweepAtrFactor: z.ZodOptional<z.ZodNumber>;
+        /** Multiplier on SL touch prob to approximate stop-hunt / AI sweep risk (default 2). */
+        slSweepLiquidityMultiplier: z.ZodOptional<z.ZodNumber>;
+        /** Default ambush TTL minutes when model omits expires_in_min (15–30 typical). */
+        defaultAmbushExpiresMin: z.ZodOptional<z.ZodNumber>;
+        /** Block cancel_all while unexpired TTL ambush entry is still pending (default true). */
+        forbidCancelAllWithActiveAmbush: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        risk: "conservative" | "balanced" | "aggressive";
+        requireTpsl: boolean;
+        priceDeviationPctMax: number;
+        forbidCancelAllWithActiveAmbush: boolean;
+        updatedAtMs?: number | undefined;
+        defaultMaxSz?: number | undefined;
+        maxSzByCoin?: Record<string, number> | undefined;
+        defaultMinSz?: number | undefined;
+        minSzByCoin?: Record<string, number> | undefined;
+        tradingStyleNotes?: string | undefined;
+        isolatedTopUp?: {
+            enabled: boolean;
+            safeDistancePct: number;
+            safetyFactor: number;
+            reserveUsd: number;
+            minTopUpUsd: number;
+            minPartialUsd: number;
+            maxSingleTopUpUsd: number;
+            maxDailyTopUpUsd: number;
+            cooldownSec: number;
+        } | undefined;
+        minConfidenceToExecute?: number | undefined;
+        limitPriceJitterPct?: number | undefined;
+        executeCooldownSec?: number | undefined;
+        bracketSlEntryShift?: number | undefined;
+        ambushReplaceDeviationPct?: number | undefined;
+        antiRushCloseMinSec?: number | undefined;
+        protectionGraceSec?: number | undefined;
+        minClosePnlPct?: number | undefined;
+        minRewardRiskRatio?: number | undefined;
+        maxSlPctFromEntry?: number | undefined;
+        maxSlTouchProb?: number | undefined;
+        maxSlSweepProb?: number | undefined;
+        slAntiSweepAtrFactor?: number | undefined;
+        slSweepLiquidityMultiplier?: number | undefined;
+        defaultAmbushExpiresMin?: number | undefined;
+    }, {
+        updatedAtMs?: number | undefined;
+        risk?: "conservative" | "balanced" | "aggressive" | undefined;
+        defaultMaxSz?: number | undefined;
+        maxSzByCoin?: Record<string, number> | undefined;
+        defaultMinSz?: number | undefined;
+        minSzByCoin?: Record<string, number> | undefined;
+        requireTpsl?: boolean | undefined;
+        priceDeviationPctMax?: number | undefined;
+        tradingStyleNotes?: string | undefined;
+        isolatedTopUp?: {
+            enabled?: boolean | undefined;
+            safeDistancePct?: number | undefined;
+            safetyFactor?: number | undefined;
+            reserveUsd?: number | undefined;
+            minTopUpUsd?: number | undefined;
+            minPartialUsd?: number | undefined;
+            maxSingleTopUpUsd?: number | undefined;
+            maxDailyTopUpUsd?: number | undefined;
+            cooldownSec?: number | undefined;
+        } | undefined;
+        minConfidenceToExecute?: number | undefined;
+        limitPriceJitterPct?: number | undefined;
+        executeCooldownSec?: number | undefined;
+        bracketSlEntryShift?: number | undefined;
+        ambushReplaceDeviationPct?: number | undefined;
+        antiRushCloseMinSec?: number | undefined;
+        protectionGraceSec?: number | undefined;
+        minClosePnlPct?: number | undefined;
+        minRewardRiskRatio?: number | undefined;
+        maxSlPctFromEntry?: number | undefined;
+        maxSlTouchProb?: number | undefined;
+        maxSlSweepProb?: number | undefined;
+        slAntiSweepAtrFactor?: number | undefined;
+        slSweepLiquidityMultiplier?: number | undefined;
+        defaultAmbushExpiresMin?: number | undefined;
+        forbidCancelAllWithActiveAmbush?: boolean | undefined;
+    }>>;
+    /** Last successful advise execute per `${coin}:${action}` (cooldown guard). */
+    adviseExecuteHistory: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        action: z.ZodString;
+        atMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        action: string;
+        atMs: number;
+    }, {
+        action: string;
+        atMs: number;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     updatedAtMs: number;
     version: 1;
@@ -973,9 +1326,10 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         slTriggerPx: number;
         tpslIsMarket: boolean;
         protectionReduceOnly: boolean;
-        phase: "cancelled" | "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "expired" | "error";
-        network?: string | undefined;
+        phase: "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "cancelled" | "expired" | "error";
         dex?: string | undefined;
+        network?: string | undefined;
+        strategy?: "scalp" | "ambush" | undefined;
         entryReduceOnly?: boolean | undefined;
         tpslLimitPx?: number | undefined;
         entryOid?: number | undefined;
@@ -990,7 +1344,6 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         dedupeKeys?: string[] | undefined;
     } | {
         coin: string;
-        reduceOnly: boolean;
         kind: "grid";
         id: string;
         createdAtMs: number;
@@ -1001,11 +1354,12 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         grids: number;
         orderSz: number;
         bias: "symmetric" | "long" | "short";
+        reduceOnly: boolean;
         legs: {
+            isBuy: boolean;
             index: number;
             px: number;
-            isBuy: boolean;
-            legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+            legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
             oid?: number | undefined;
             lastSz?: number | undefined;
             lastOrigSz?: number | undefined;
@@ -1014,38 +1368,39 @@ export declare const TradeStateFileSchema: z.ZodObject<{
                 fillPx: number;
             } | undefined;
         }[];
-        network?: string | undefined;
         dex?: string | undefined;
+        network?: string | undefined;
         maxOrders?: number | undefined;
         replenishGapPx?: number | undefined;
         replenishDedupeKeys?: string[] | undefined;
+        regenerateGrid?: boolean | undefined;
     } | {
-        coin: string;
         sz: number;
-        reduceOnly: boolean;
-        limitPx: number;
+        coin: string;
         kind: "single_limit";
         id: string;
         createdAtMs: number;
         updatedAtMs: number;
         entrySide: "buy" | "sell";
         tif: "Gtc" | "Ioc" | "Alo";
-        dex?: string | undefined;
+        reduceOnly: boolean;
+        limitPx: number;
         oid?: number | undefined;
+        dex?: string | undefined;
     } | {
-        coin: string;
         side: "buy" | "sell";
         sz: number;
-        reduceOnly: boolean;
-        triggerPx: number;
+        coin: string;
         kind: "standalone_tpsl";
         id: string;
         createdAtMs: number;
         updatedAtMs: number;
+        reduceOnly: boolean;
+        triggerPx: number;
         tpsl: "tp" | "sl";
         isMarket: boolean;
-        dex?: string | undefined;
         oid?: number | undefined;
+        dex?: string | undefined;
         limitPx?: number | undefined;
     }>;
     events: {
@@ -1055,6 +1410,48 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         message?: string | undefined;
         data?: Record<string, unknown> | undefined;
     }[];
+    userProfile?: {
+        risk: "conservative" | "balanced" | "aggressive";
+        requireTpsl: boolean;
+        priceDeviationPctMax: number;
+        forbidCancelAllWithActiveAmbush: boolean;
+        updatedAtMs?: number | undefined;
+        defaultMaxSz?: number | undefined;
+        maxSzByCoin?: Record<string, number> | undefined;
+        defaultMinSz?: number | undefined;
+        minSzByCoin?: Record<string, number> | undefined;
+        tradingStyleNotes?: string | undefined;
+        isolatedTopUp?: {
+            enabled: boolean;
+            safeDistancePct: number;
+            safetyFactor: number;
+            reserveUsd: number;
+            minTopUpUsd: number;
+            minPartialUsd: number;
+            maxSingleTopUpUsd: number;
+            maxDailyTopUpUsd: number;
+            cooldownSec: number;
+        } | undefined;
+        minConfidenceToExecute?: number | undefined;
+        limitPriceJitterPct?: number | undefined;
+        executeCooldownSec?: number | undefined;
+        bracketSlEntryShift?: number | undefined;
+        ambushReplaceDeviationPct?: number | undefined;
+        antiRushCloseMinSec?: number | undefined;
+        protectionGraceSec?: number | undefined;
+        minClosePnlPct?: number | undefined;
+        minRewardRiskRatio?: number | undefined;
+        maxSlPctFromEntry?: number | undefined;
+        maxSlTouchProb?: number | undefined;
+        maxSlSweepProb?: number | undefined;
+        slAntiSweepAtrFactor?: number | undefined;
+        slSweepLiquidityMultiplier?: number | undefined;
+        defaultAmbushExpiresMin?: number | undefined;
+    } | undefined;
+    adviseExecuteHistory?: Record<string, {
+        action: string;
+        atMs: number;
+    }> | undefined;
 }, {
     updatedAtMs: number;
     version: 1;
@@ -1071,9 +1468,10 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         tpTriggerPx: number;
         slTriggerPx: number;
         tpslIsMarket: boolean;
-        phase: "cancelled" | "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "expired" | "error";
-        network?: string | undefined;
+        phase: "planned" | "entry_pending" | "entry_partial" | "entry_filled" | "protection_active" | "tp_filled" | "sl_filled" | "closed" | "cancelled" | "expired" | "error";
         dex?: string | undefined;
+        network?: string | undefined;
+        strategy?: "scalp" | "ambush" | undefined;
         entryReduceOnly?: boolean | undefined;
         tpslLimitPx?: number | undefined;
         protectionReduceOnly?: boolean | undefined;
@@ -1089,7 +1487,6 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         dedupeKeys?: string[] | undefined;
     } | {
         coin: string;
-        reduceOnly: boolean;
         kind: "grid";
         id: string;
         createdAtMs: number;
@@ -1100,11 +1497,12 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         grids: number;
         orderSz: number;
         bias: "symmetric" | "long" | "short";
+        reduceOnly: boolean;
         legs: {
+            isBuy: boolean;
             index: number;
             px: number;
-            isBuy: boolean;
-            legPhase: "pending" | "open" | "partial" | "filled" | "cancelled";
+            legPhase: "partial" | "cancelled" | "pending" | "open" | "filled";
             oid?: number | undefined;
             lastSz?: number | undefined;
             lastOrigSz?: number | undefined;
@@ -1113,38 +1511,39 @@ export declare const TradeStateFileSchema: z.ZodObject<{
                 fillPx: number;
             } | undefined;
         }[];
-        network?: string | undefined;
         dex?: string | undefined;
+        network?: string | undefined;
         maxOrders?: number | undefined;
         replenishGapPx?: number | undefined;
         replenishDedupeKeys?: string[] | undefined;
+        regenerateGrid?: boolean | undefined;
     } | {
-        coin: string;
         sz: number;
-        reduceOnly: boolean;
-        limitPx: number;
+        coin: string;
         kind: "single_limit";
         id: string;
         createdAtMs: number;
         updatedAtMs: number;
         entrySide: "buy" | "sell";
         tif: "Gtc" | "Ioc" | "Alo";
-        dex?: string | undefined;
+        reduceOnly: boolean;
+        limitPx: number;
         oid?: number | undefined;
+        dex?: string | undefined;
     } | {
-        coin: string;
         side: "buy" | "sell";
         sz: number;
-        reduceOnly: boolean;
-        triggerPx: number;
+        coin: string;
         kind: "standalone_tpsl";
         id: string;
         createdAtMs: number;
         updatedAtMs: number;
+        reduceOnly: boolean;
+        triggerPx: number;
         tpsl: "tp" | "sl";
         isMarket: boolean;
-        dex?: string | undefined;
         oid?: number | undefined;
+        dex?: string | undefined;
         limitPx?: number | undefined;
     }>;
     events: {
@@ -1154,6 +1553,48 @@ export declare const TradeStateFileSchema: z.ZodObject<{
         message?: string | undefined;
         data?: Record<string, unknown> | undefined;
     }[];
+    userProfile?: {
+        updatedAtMs?: number | undefined;
+        risk?: "conservative" | "balanced" | "aggressive" | undefined;
+        defaultMaxSz?: number | undefined;
+        maxSzByCoin?: Record<string, number> | undefined;
+        defaultMinSz?: number | undefined;
+        minSzByCoin?: Record<string, number> | undefined;
+        requireTpsl?: boolean | undefined;
+        priceDeviationPctMax?: number | undefined;
+        tradingStyleNotes?: string | undefined;
+        isolatedTopUp?: {
+            enabled?: boolean | undefined;
+            safeDistancePct?: number | undefined;
+            safetyFactor?: number | undefined;
+            reserveUsd?: number | undefined;
+            minTopUpUsd?: number | undefined;
+            minPartialUsd?: number | undefined;
+            maxSingleTopUpUsd?: number | undefined;
+            maxDailyTopUpUsd?: number | undefined;
+            cooldownSec?: number | undefined;
+        } | undefined;
+        minConfidenceToExecute?: number | undefined;
+        limitPriceJitterPct?: number | undefined;
+        executeCooldownSec?: number | undefined;
+        bracketSlEntryShift?: number | undefined;
+        ambushReplaceDeviationPct?: number | undefined;
+        antiRushCloseMinSec?: number | undefined;
+        protectionGraceSec?: number | undefined;
+        minClosePnlPct?: number | undefined;
+        minRewardRiskRatio?: number | undefined;
+        maxSlPctFromEntry?: number | undefined;
+        maxSlTouchProb?: number | undefined;
+        maxSlSweepProb?: number | undefined;
+        slAntiSweepAtrFactor?: number | undefined;
+        slSweepLiquidityMultiplier?: number | undefined;
+        defaultAmbushExpiresMin?: number | undefined;
+        forbidCancelAllWithActiveAmbush?: boolean | undefined;
+    } | undefined;
+    adviseExecuteHistory?: Record<string, {
+        action: string;
+        atMs: number;
+    }> | undefined;
 }>;
 export type TradeStateFile = z.infer<typeof TradeStateFileSchema>;
 export declare function createEmptyTradeState(nowMs: number): TradeStateFile;