jcc_hyper_tool 0.1.4 → 0.1.6

package/dist/advisor/deepseekClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseekClient.d.ts","sourceRoot":"","sources":["../../src/advisor/deepseekClient.ts"],"names":[],"mappings":"AAIA,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD,wFAAwF;AACxF,eAAO,MAAM,iCAAiC,EAAG,MAAe,CAAC;AAEjE,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,2FAA2F;AAC3F,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,kBAAkB,GAAG,QAAQ,CAM7E;AAYD,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoF9B"}

package/dist/advisor/deepseekClient.js

@@ -0,0 +1,96 @@
+import { ConfigError } from "../core/errors.js";
+import { formatErrorChain } from "../core/hyperliquid/httpRequest.js";
+import { formatHttpResponseBodyForDisplay } from "../core/errorFormat.js";
+/** Default chat model when `DEEPSEEK_MODEL` is unset (DeepSeek OpenAI-compatible API). */
+export const DEFAULT_DEEPSEEK_MODEL = "deepseek-v4-pro";
+/** DeepSeek thinking mode defaults (see api-docs.deepseek.com/guides/thinking_mode). */
+export const DEFAULT_DEEPSEEK_REASONING_EFFORT = "high";
+/** Build an assistant message for the next API round (includes reasoning when present). */
+export function assistantChatTurnFromResult(res) {
+    const turn = { role: "assistant", content: res.content };
+    if (res.reasoningContent !== undefined) {
+        turn.reasoning_content = res.reasoningContent;
+    }
+    return turn;
+}
+function deepseekHttpError(status, statusText, bodyText) {
+    const body = formatHttpResponseBodyForDisplay(bodyText);
+    const label = statusText ? `${status} ${statusText}` : String(status);
+    return new ConfigError([`DeepSeek API HTTP ${label} POST /v1/chat/completions`, body ? `Response body:\n${body}` : ""]
+        .filter(Boolean)
+        .join("\n"));
+}
+export async function deepseekChat(params) {
+    const base = (params.baseUrl ?? "https://api.deepseek.com").replace(/\/+$/, "");
+    const model = params.model ?? (process.env.DEEPSEEK_MODEL?.trim() || DEFAULT_DEEPSEEK_MODEL);
+    const reasoningEffort = params.reasoningEffort ??
+        process.env.DEEPSEEK_REASONING_EFFORT?.trim() ??
+        DEFAULT_DEEPSEEK_REASONING_EFFORT;
+    const fetchImpl = params.fetchImpl ?? fetch;
+    const url = `${base}/v1/chat/completions`;
+    let res;
+    try {
+        res = await fetchImpl(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${params.apiKey}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+            },
+            body: JSON.stringify({
+                model,
+                messages: params.messages,
+                reasoning_effort: reasoningEffort,
+                thinking: { type: "enabled" },
+            }),
+        });
+    }
+    catch (e) {
+        throw new ConfigError([`DeepSeek API network error POST ${url}`, formatErrorChain(e)].join("\n"));
+    }
+    const text = await res.text();
+    if (!res.ok) {
+        throw deepseekHttpError(res.status, res.statusText, text);
+    }
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        throw new ConfigError([
+            "DeepSeek API returned non-JSON body.",
+            text ? `Response body:\n${formatHttpResponseBodyForDisplay(text)}` : "",
+        ]
+            .filter(Boolean)
+            .join("\n"));
+    }
+    const root = json;
+    const choices = root.choices;
+    if (!Array.isArray(choices) || choices.length === 0) {
+        throw new ConfigError([
+            "DeepSeek API: missing choices[0].",
+            `Response body:\n${formatHttpResponseBodyForDisplay(text)}`,
+        ].join("\n"));
+    }
+    const msg = choices[0];
+    const message = msg.message;
+    if (!message) {
+        throw new ConfigError([
+            "DeepSeek API: missing message.",
+            `Response body:\n${formatHttpResponseBodyForDisplay(text)}`,
+        ].join("\n"));
+    }
+    const content = message.content;
+    if (typeof content !== "string") {
+        throw new ConfigError([
+            "DeepSeek API: message.content must be a string.",
+            `Response body:\n${formatHttpResponseBodyForDisplay(text)}`,
+        ].join("\n"));
+    }
+    const reasoningRaw = message.reasoning_content ?? message.reasoningContent;
+    return {
+        content,
+        reasoningContent: typeof reasoningRaw === "string" ? reasoningRaw : undefined,
+    };
+}
+//# sourceMappingURL=deepseekClient.js.map

package/dist/advisor/deepseekClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseekClient.js","sourceRoot":"","sources":["../../src/advisor/deepseekClient.ts"],"names":[],"mappings":"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"}

package/dist/advisor/executionPolicy.d.ts

@@ -0,0 +1,92 @@
+import type { JsonValue } from "../core/hyperliquid/types.js";
+import type { TradeStateFile, UserProfile } from "../core/state/schema.js";
+import type { AdvisorAction } from "./actionSchema.js";
+import type { AdvisorGuardInputs } from "./guards.js";
+import { type BracketTouchProbabilities } from "./touchProbability.js";
+export type AdvisorExecutionPolicy = {
+    minConfidence: number;
+    limitJitterPct: number;
+    executeCooldownSec: number;
+    /** 0=off, 1=place entry at model SL (TP/SL shift by same delta). */
+    bracketSlEntryShift: number;
+    ambushReplaceDeviationPct: number;
+    antiRushCloseMinSec: number;
+    defaultAmbushExpiresMin: number;
+};
+export type AdvisorExecutionPolicyCli = {
+    minConfidence?: number;
+    limitJitterPct?: number;
+    executeCooldownSec?: number;
+    slEntryShift?: number;
+    ambushReplaceDeviationPct?: number;
+    antiRushCloseMinSec?: number;
+    defaultAmbushExpiresMin?: number;
+    auto?: boolean;
+};
+export type AdviseExecuteRecord = {
+    action: string;
+    atMs: number;
+};
+/** Shared size cap for bracket open and partial close. */
+export declare function resolveAdvisorSzCap(inputs: AdvisorGuardInputs): number;
+/** Profile minimum sz for bracket open (`minSzByCoin` overrides `defaultMinSz`). */
+export declare function resolveAdvisorMinSz(inputs: AdvisorGuardInputs): number | undefined;
+export declare function resolveAdvisorExecutionPolicy(profile: UserProfile | undefined, cli: AdvisorExecutionPolicyCli): AdvisorExecutionPolicy;
+export declare function assertAdvisorConfidenceGate(action: AdvisorAction, minConfidence: number): void;
+export declare function adviseExecuteCooldownKey(coin: string, action: AdvisorAction): string | null;
+export declare function assertAdviseExecuteCooldown(params: {
+    history: Record<string, AdviseExecuteRecord> | undefined;
+    coin: string;
+    action: AdvisorAction;
+    cooldownSec: number;
+    nowMs: number;
+}): void;
+export declare function recordAdviseExecuteCooldown(params: {
+    statePath: string;
+    coin: string;
+    action: AdvisorAction;
+    nowMs: number;
+}): Promise<void>;
+/**
+ * Round advisor limit/trigger prices for exchange submission.
+ * When `szDecimals` is set, uses Hyperliquid per-asset rules (5 sig figs, 6 - szDecimals decimals).
+ */
+export declare function roundAdvisorLimitPx(px: number, szDecimals?: number): number;
+export declare function jitterLimitPrice(px: number, jitterPct: number, rng?: () => number, szDecimals?: number): number;
+export declare function applyLimitJitterWithinBand(px: number, mid: number | null, jitterPct: number, maxDevPct: number, rng?: () => number, szDecimals?: number): {
+    px: number;
+    applied: boolean;
+};
+/**
+ * Shift bracket entry toward the model stop: delta = factor × (sl_px − limit_px).
+ * factor=1 → entry at SL; TP/SL and optional protection_limit_px move by the same delta.
+ */
+export declare function applyBracketSlEntryShift(action: AdvisorAction, factor: number, szDecimals?: number): {
+    action: AdvisorAction;
+    notes: string[];
+};
+export declare function prepareAdvisorActionForExecution(action: AdvisorAction, options: {
+    slEntryShift: number;
+    limitJitterPct: number;
+    mid: number | null;
+    maxDevPct: number;
+    szDecimals?: number;
+    rng?: () => number;
+    kline1h?: JsonValue;
+    profile?: UserProfile;
+}): {
+    action: AdvisorAction;
+    notes: string[];
+    touchProbs?: BracketTouchProbabilities;
+};
+export declare function applyAdvisorExecutionJitter(action: AdvisorAction, mid: number | null, jitterPct: number, maxDevPct: number, rng?: () => number, szDecimals?: number): {
+    action: AdvisorAction;
+    notes: string[];
+};
+export declare function resolveCloseSz(positionSignedSz: number | undefined, szCap: number): {
+    sz: number;
+    capped: boolean;
+    positionAbs: number;
+};
+export declare function readAdviseExecuteHistory(state: TradeStateFile | undefined): Record<string, AdviseExecuteRecord> | undefined;
+//# sourceMappingURL=executionPolicy.d.ts.map

package/dist/advisor/executionPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionPolicy.d.ts","sourceRoot":"","sources":["../../src/advisor/executionPolicy.ts"],"names":[],"mappings":"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"}

package/dist/advisor/executionPolicy.js

@@ -0,0 +1,273 @@
+import { ConfigError } from "../core/errors.js";
+import { roundHyperliquidPerpPrice } from "../core/hyperliquid/rounding.js";
+import { mergeUserProfileDefaults } from "../core/state/profileStore.js";
+import { updateTradeStateFileAtomic } from "../core/state/store.js";
+import { isAdvisorBracketOpenAction } from "./actionSchema.js";
+import { applyAntiSweepSlOffset, computeAtr, computeBracketTouchProbabilities, formatTouchProbNote, parseCandlesFromSnapshot, resolveSlAntiSweepAtrFactor, } from "./touchProbability.js";
+const AUTO_DEFAULT_MIN_CONFIDENCE = 0.55;
+/** Shared size cap for bracket open and partial close. */
+export function resolveAdvisorSzCap(inputs) {
+    const maxSz = inputs.maxSz;
+    if (!Number.isFinite(maxSz) || maxSz <= 0) {
+        throw new ConfigError("advise: --max-sz must be a positive finite number.");
+    }
+    const p = mergeUserProfileDefaults(inputs.profile);
+    const by = p.maxSzByCoin?.[inputs.coin];
+    const coinCap = typeof by === "number" && Number.isFinite(by) ? by : p.defaultMaxSz;
+    return coinCap !== undefined ? Math.min(maxSz, coinCap) : maxSz;
+}
+/** Profile minimum sz for bracket open (`minSzByCoin` overrides `defaultMinSz`). */
+export function resolveAdvisorMinSz(inputs) {
+    const p = mergeUserProfileDefaults(inputs.profile);
+    const by = p.minSzByCoin?.[inputs.coin];
+    if (typeof by === "number" && Number.isFinite(by) && by > 0) {
+        return by;
+    }
+    if (p.defaultMinSz !== undefined && Number.isFinite(p.defaultMinSz) && p.defaultMinSz > 0) {
+        return p.defaultMinSz;
+    }
+    return undefined;
+}
+export function resolveAdvisorExecutionPolicy(profile, cli) {
+    const p = mergeUserProfileDefaults(profile);
+    let minConfidence = cli.minConfidence ?? p.minConfidenceToExecute ?? 0;
+    if (cli.auto &&
+        cli.minConfidence === undefined &&
+        p.minConfidenceToExecute === undefined) {
+        minConfidence = AUTO_DEFAULT_MIN_CONFIDENCE;
+    }
+    return {
+        minConfidence,
+        limitJitterPct: cli.limitJitterPct ?? p.limitPriceJitterPct ?? 0,
+        executeCooldownSec: cli.executeCooldownSec ?? p.executeCooldownSec ?? 0,
+        bracketSlEntryShift: cli.slEntryShift ?? p.bracketSlEntryShift ?? 0,
+        ambushReplaceDeviationPct: cli.ambushReplaceDeviationPct ??
+            p.ambushReplaceDeviationPct ??
+            p.priceDeviationPctMax,
+        antiRushCloseMinSec: cli.antiRushCloseMinSec ?? p.antiRushCloseMinSec ?? 0,
+        defaultAmbushExpiresMin: cli.defaultAmbushExpiresMin ?? p.defaultAmbushExpiresMin ?? 20,
+    };
+}
+export function assertAdvisorConfidenceGate(action, minConfidence) {
+    if (minConfidence <= 0 || action.action === "cancel_all") {
+        return;
+    }
+    if (action.confidence < minConfidence) {
+        throw new ConfigError(`advise: confidence ${(action.confidence * 100).toFixed(0)}% below min ${(minConfidence * 100).toFixed(0)}%.`);
+    }
+}
+export function adviseExecuteCooldownKey(coin, action) {
+    if (action.action === "wait") {
+        return null;
+    }
+    if (action.action === "open_with_bracket") {
+        return `${coin}:${action.action}:${action.side}`;
+    }
+    if (action.action === "place_limit_ambush") {
+        return `${coin}:${action.action}:${action.side}`;
+    }
+    return `${coin}:${action.action}`;
+}
+export function assertAdviseExecuteCooldown(params) {
+    const { history, coin, action, cooldownSec, nowMs } = params;
+    if (cooldownSec <= 0) {
+        return;
+    }
+    const key = adviseExecuteCooldownKey(coin, action);
+    if (!key) {
+        return;
+    }
+    const prev = history?.[key];
+    if (!prev) {
+        return;
+    }
+    const elapsedSec = (nowMs - prev.atMs) / 1000;
+    if (elapsedSec < cooldownSec) {
+        const remain = Math.ceil(cooldownSec - elapsedSec);
+        const sideHint = action.action === "open_with_bracket" || action.action === "place_limit_ambush"
+            ? ` (${action.side})`
+            : "";
+        throw new ConfigError(`advise: execute cooldown: ${action.action}${sideHint} on ${coin} ran ${Math.floor(elapsedSec)}s ago; wait ${remain}s more.`);
+    }
+}
+export async function recordAdviseExecuteCooldown(params) {
+    const key = adviseExecuteCooldownKey(params.coin, params.action);
+    if (!key) {
+        return;
+    }
+    await updateTradeStateFileAtomic(params.statePath, (cur) => {
+        const history = {
+            ...(cur.adviseExecuteHistory ?? {}),
+            [key]: { action: params.action.action, atMs: params.nowMs },
+        };
+        return {
+            ...cur,
+            updatedAtMs: params.nowMs,
+            adviseExecuteHistory: history,
+        };
+    }, params.nowMs);
+}
+/**
+ * Round advisor limit/trigger prices for exchange submission.
+ * When `szDecimals` is set, uses Hyperliquid per-asset rules (5 sig figs, 6 - szDecimals decimals).
+ */
+export function roundAdvisorLimitPx(px, szDecimals) {
+    if (!Number.isFinite(px) || px <= 0) {
+        return px;
+    }
+    if (szDecimals !== undefined) {
+        return roundHyperliquidPerpPrice(px, szDecimals);
+    }
+    if (px >= 10_000) {
+        return Math.round(px * 10) / 10;
+    }
+    if (px >= 1_000) {
+        return Math.round(px * 100) / 100;
+    }
+    if (px >= 10) {
+        return Math.round(px * 1_000) / 1_000;
+    }
+    return Math.round(px * 1_000_000) / 1_000_000;
+}
+export function jitterLimitPrice(px, jitterPct, rng = Math.random, szDecimals) {
+    if (!Number.isFinite(jitterPct) || jitterPct <= 0) {
+        return px;
+    }
+    const sign = rng() < 0.5 ? -1 : 1;
+    const magnitude = jitterPct * (0.5 + rng() * 0.5);
+    return roundAdvisorLimitPx(px * (1 + sign * magnitude), szDecimals);
+}
+export function applyLimitJitterWithinBand(px, mid, jitterPct, maxDevPct, rng = Math.random, szDecimals) {
+    if (!Number.isFinite(jitterPct) || jitterPct <= 0) {
+        return { px, applied: false };
+    }
+    if (mid === null || mid <= 0) {
+        const jittered = jitterLimitPrice(px, jitterPct, rng, szDecimals);
+        return { px: jittered, applied: jittered !== px };
+    }
+    for (let attempt = 0; attempt < 6; attempt++) {
+        const candidate = jitterLimitPrice(px, jitterPct, rng, szDecimals);
+        const dev = Math.abs(candidate - mid) / mid;
+        if (dev <= maxDevPct) {
+            return { px: candidate, applied: candidate !== px };
+        }
+    }
+    return { px, applied: false };
+}
+/**
+ * Shift bracket entry toward the model stop: delta = factor × (sl_px − limit_px).
+ * factor=1 → entry at SL; TP/SL and optional protection_limit_px move by the same delta.
+ */
+export function applyBracketSlEntryShift(action, factor, szDecimals) {
+    if (!Number.isFinite(factor) || factor <= 0 || !isAdvisorBracketOpenAction(action)) {
+        return { action, notes: [] };
+    }
+    const f = Math.min(1, Math.max(0, factor));
+    if (!Number.isFinite(action.tp_px) || !Number.isFinite(action.sl_px)) {
+        return { action, notes: [] };
+    }
+    const fullDelta = action.sl_px - action.limit_px;
+    if (fullDelta === 0) {
+        return { action, notes: [] };
+    }
+    const delta = fullDelta * f;
+    const newLimit = roundAdvisorLimitPx(action.limit_px + delta, szDecimals);
+    const newTp = roundAdvisorLimitPx(action.tp_px + delta, szDecimals);
+    const newSl = roundAdvisorLimitPx(action.sl_px + delta, szDecimals);
+    let protection_limit_px = action.protection_limit_px;
+    if (protection_limit_px !== undefined) {
+        protection_limit_px = roundAdvisorLimitPx(protection_limit_px + delta, szDecimals);
+    }
+    if (action.side === "buy") {
+        if (!(newSl < newLimit && newLimit < newTp)) {
+            throw new ConfigError(`advise: sl-entry-shift produced invalid buy bracket (sl ${newSl}, entry ${newLimit}, tp ${newTp}).`);
+        }
+    }
+    else if (!(newTp < newLimit && newLimit < newSl)) {
+        throw new ConfigError(`advise: sl-entry-shift produced invalid sell bracket (tp ${newTp}, entry ${newLimit}, sl ${newSl}).`);
+    }
+    const notes = [
+        `sl-entry-shift ×${f}: limit ${action.limit_px}→${newLimit}, tp ${action.tp_px}→${newTp}, sl ${action.sl_px}→${newSl}`,
+    ];
+    return {
+        action: {
+            ...action,
+            limit_px: newLimit,
+            tp_px: newTp,
+            sl_px: newSl,
+            protection_limit_px,
+        },
+        notes,
+    };
+}
+export function prepareAdvisorActionForExecution(action, options) {
+    const notes = [];
+    let working = action;
+    if (isAdvisorBracketOpenAction(working) && options.kline1h !== undefined) {
+        const atr1h = computeAtr(parseCandlesFromSnapshot(options.kline1h));
+        const antiSweep = applyAntiSweepSlOffset(working, atr1h, resolveSlAntiSweepAtrFactor(options.profile), options.szDecimals);
+        notes.push(...antiSweep.notes);
+        working = antiSweep.action;
+    }
+    const shifted = applyBracketSlEntryShift(working, options.slEntryShift, options.szDecimals);
+    notes.push(...shifted.notes);
+    const jittered = applyAdvisorExecutionJitter(shifted.action, options.mid, options.limitJitterPct, options.maxDevPct, options.rng, options.szDecimals);
+    notes.push(...jittered.notes);
+    let touchProbs;
+    if (isAdvisorBracketOpenAction(jittered.action) && options.kline1h !== undefined) {
+        touchProbs = computeBracketTouchProbabilities({
+            action: jittered.action,
+            spot: options.mid,
+            kline1h: options.kline1h,
+            analysis: jittered.action.analysis,
+            profile: options.profile,
+        });
+        notes.push(formatTouchProbNote(touchProbs));
+    }
+    return { action: jittered.action, notes, touchProbs };
+}
+export function applyAdvisorExecutionJitter(action, mid, jitterPct, maxDevPct, rng = Math.random, szDecimals) {
+    if (jitterPct <= 0 || action.action === "wait" || action.action === "cancel_all") {
+        return { action, notes: [] };
+    }
+    const notes = [];
+    if (isAdvisorBracketOpenAction(action)) {
+        const lim = applyLimitJitterWithinBand(action.limit_px, mid, jitterPct, maxDevPct, rng, szDecimals);
+        if (lim.applied) {
+            notes.push(`limit_px ${action.limit_px} → ${lim.px}`);
+        }
+        let protection_limit_px = action.protection_limit_px;
+        if (protection_limit_px !== undefined) {
+            const prot = applyLimitJitterWithinBand(protection_limit_px, mid, jitterPct, maxDevPct, rng, szDecimals);
+            protection_limit_px = prot.px;
+            if (prot.applied) {
+                notes.push(`protection_limit_px ${action.protection_limit_px} → ${prot.px}`);
+            }
+        }
+        return {
+            action: { ...action, limit_px: lim.px, protection_limit_px },
+            notes,
+        };
+    }
+    if (action.action === "close_position" && action.method === "limit" && action.limit_px !== undefined) {
+        const lim = applyLimitJitterWithinBand(action.limit_px, mid, jitterPct, maxDevPct, rng, szDecimals);
+        if (lim.applied) {
+            notes.push(`close limit_px ${action.limit_px} → ${lim.px}`);
+        }
+        return { action: { ...action, limit_px: lim.px }, notes };
+    }
+    return { action, notes };
+}
+export function resolveCloseSz(positionSignedSz, szCap) {
+    const pos = positionSignedSz;
+    if (pos === undefined || !Number.isFinite(pos) || pos === 0) {
+        throw new ConfigError("close_position: no open position for this coin.");
+    }
+    const positionAbs = Math.abs(pos);
+    const sz = Math.min(positionAbs, szCap);
+    return { sz, capped: positionAbs > szCap, positionAbs };
+}
+export function readAdviseExecuteHistory(state) {
+    return state?.adviseExecuteHistory;
+}
+//# sourceMappingURL=executionPolicy.js.map

package/dist/advisor/executionPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionPolicy.js","sourceRoot":"","sources":["../../src/advisor/executionPolicy.ts"],"names":[],"mappings":"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"}

package/dist/advisor/guards.d.ts

@@ -0,0 +1,31 @@
+import type { UserProfile } from "../core/state/schema.js";
+import type { JsonValue } from "../core/hyperliquid/types.js";
+import type { AdvisorAction } from "./actionSchema.js";
+export type AdvisorGuardInputs = {
+    coin: string;
+    maxSz: number;
+    /** CLI override; falls back to profile */
+    requireTpsl?: boolean;
+    mid: number | null;
+    /** Signed position for `coin` (positive = long). */
+    positionSignedSz: number | undefined;
+    profile: UserProfile | undefined;
+    /** Per-asset size decimals from HL meta (enables min $10 notional check). */
+    szDecimals?: number;
+    /** When true, skip limit_px vs mid deviation (e.g. sl-entry-shift places entry at former SL). */
+    skipEntryMidDeviation?: boolean;
+    /** When true, skip SL touch/sweep probability guard (first pass before anti-sweep / shift). */
+    skipTouchProb?: boolean;
+    /** 1h candles for ATR-based touch probability (from market snapshot). */
+    kline1h?: JsonValue;
+    /** Trade state for ambush / anti-rush guards (optional when --no-state). */
+    tradeState?: import("../core/state/schema.js").TradeStateFile;
+    nowMs?: number;
+    /** Exchange-reported entry px for `coin` (from clearinghouse snapshot). */
+    positionEntryPx?: number;
+};
+/**
+ * Hard execution guards (do not rely on the model). Throws `ConfigError` when blocked.
+ */
+export declare function assertAdvisorActionPassesGuards(action: AdvisorAction, inputs: AdvisorGuardInputs): void;
+//# sourceMappingURL=guards.d.ts.map

package/dist/advisor/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/advisor/guards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgBvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,+FAA+F;IAC/F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,yBAAyB,EAAE,cAAc,CAAC;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AA8HF;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,kBAAkB,GACzB,IAAI,CA2HN"}