jcc_hyper_tool 0.1.4 → 0.1.5

package/dist/advisor/contextBuilder.d.ts

@@ -0,0 +1,34 @@
+import type { HyperliquidInfoClient } from "../core/hyperliquid/client.js";
+import type { JsonValue } from "../core/hyperliquid/types.js";
+export type AdvisorPositionRow = {
+    signed_sz: number;
+    entry_px?: number;
+    leverage?: number;
+    unrealized_pnl?: number;
+};
+export type AdvisorMarketSnapshot = {
+    coin: string;
+    network: string;
+    now_ms: number;
+    mid: number | null;
+    positions: Record<string, AdvisorPositionRow>;
+    kline_5m: JsonValue;
+    kline_1h: JsonValue;
+    kline_1d: JsonValue;
+    user_note?: string;
+};
+export declare function readMidFromAllMids(mids: JsonValue, coin: string): number | null;
+/** Best-effort per-coin row from `clearinghouseState` (wire shapes vary). */
+export declare function extractPositionDetail(chState: JsonValue, coin: string): AdvisorPositionRow | undefined;
+export declare function buildAdvisorMarketSnapshot(params: {
+    info: HyperliquidInfoClient;
+    coin: string;
+    network: string;
+    userAddress: `0x${string}`;
+    userNote?: string;
+    nowMs: number;
+    kline5mBars: number;
+    kline1hBars: number;
+    kline1dBars: number;
+}): Promise<AdvisorMarketSnapshot>;
+//# sourceMappingURL=contextBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextBuilder.d.ts","sourceRoot":"","sources":["../../src/advisor/contextBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAM3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAO9D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC9C,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AASF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa/E;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,MAAM,GACX,kBAAkB,GAAG,SAAS,CAuDhC;AAED,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAkDjC"}

package/dist/advisor/contextBuilder.js

@@ -0,0 +1,134 @@
+import { assertPerpKlineCoinInMeta, resolvePerpKlineCoinArg, } from "../core/hyperliquid/klineCoin.js";
+import { inferHlDexFromPrefixedPerpCoin } from "../core/hyperliquid/prefixedPerpCoin.js";
+import { signedPositionSizeForCoin } from "../core/state/snapshot.js";
+const MINUTE_MS = 60_000;
+const HOUR_MS = 60 * MINUTE_MS;
+const DAY_MS = 24 * HOUR_MS;
+function trimCandles(raw, maxBars) {
+    if (!Array.isArray(raw)) {
+        return raw;
+    }
+    return raw.length <= maxBars ? raw : raw.slice(-maxBars);
+}
+export function readMidFromAllMids(mids, coin) {
+    if (typeof mids !== "object" || mids === null) {
+        return null;
+    }
+    const v = mids[coin];
+    if (typeof v === "string") {
+        const n = Number(v);
+        return Number.isFinite(n) ? n : null;
+    }
+    if (typeof v === "number" && Number.isFinite(v)) {
+        return v;
+    }
+    return null;
+}
+/** Best-effort per-coin row from `clearinghouseState` (wire shapes vary). */
+export function extractPositionDetail(chState, coin) {
+    const signed = signedPositionSizeForCoin(chState, coin);
+    if (signed === undefined || signed === 0 || !Number.isFinite(signed)) {
+        return undefined;
+    }
+    if (typeof chState !== "object" || chState === null) {
+        return { signed_sz: signed };
+    }
+    const assetPositions = chState.assetPositions;
+    if (!Array.isArray(assetPositions)) {
+        return { signed_sz: signed };
+    }
+    for (const ap of assetPositions) {
+        if (typeof ap !== "object" || ap === null) {
+            continue;
+        }
+        const position = ap.position;
+        if (typeof position !== "object" || position === null) {
+            continue;
+        }
+        const p = position;
+        if (p.coin !== coin) {
+            continue;
+        }
+        const row = { signed_sz: signed };
+        const entryPx = p.entryPx;
+        if (typeof entryPx === "string") {
+            const n = Number(entryPx);
+            if (Number.isFinite(n)) {
+                row.entry_px = n;
+            }
+        }
+        else if (typeof entryPx === "number" && Number.isFinite(entryPx)) {
+            row.entry_px = entryPx;
+        }
+        const lev = ap.leverage;
+        if (typeof lev === "number" && Number.isFinite(lev)) {
+            row.leverage = lev;
+        }
+        else if (typeof lev === "object" && lev !== null) {
+            const v = lev.value;
+            if (typeof v === "number" && Number.isFinite(v)) {
+                row.leverage = v;
+            }
+        }
+        const uPnl = ap.unrealizedPnl;
+        if (typeof uPnl === "string") {
+            const n = Number(uPnl);
+            if (Number.isFinite(n)) {
+                row.unrealized_pnl = n;
+            }
+        }
+        else if (typeof uPnl === "number" && Number.isFinite(uPnl)) {
+            row.unrealized_pnl = uPnl;
+        }
+        return row;
+    }
+    return { signed_sz: signed };
+}
+export async function buildAdvisorMarketSnapshot(params) {
+    const resolvedCoin = resolvePerpKlineCoinArg(params.coin);
+    const dexForMeta = inferHlDexFromPrefixedPerpCoin(resolvedCoin);
+    if (dexForMeta) {
+        const meta = await params.info.meta(dexForMeta);
+        assertPerpKlineCoinInMeta(meta, resolvedCoin);
+    }
+    const endTime = params.nowMs;
+    const s5 = endTime - params.kline5mBars * 5 * MINUTE_MS;
+    const s1h = endTime - params.kline1hBars * HOUR_MS;
+    const s1d = endTime - params.kline1dBars * DAY_MS;
+    const [raw5m, raw1h, raw1d, ch, mids] = await Promise.all([
+        params.info.candleSnapshot({
+            coin: resolvedCoin,
+            interval: "5m",
+            startTime: s5,
+            endTime,
+        }),
+        params.info.candleSnapshot({
+            coin: resolvedCoin,
+            interval: "1h",
+            startTime: s1h,
+            endTime,
+        }),
+        params.info.candleSnapshot({
+            coin: resolvedCoin,
+            interval: "1d",
+            startTime: s1d,
+            endTime,
+        }),
+        params.info.clearinghouseState(params.userAddress),
+        params.info.allMids(dexForMeta),
+    ]);
+    const pos = extractPositionDetail(ch, resolvedCoin);
+    const positions = pos ? { [resolvedCoin]: pos } : {};
+    return {
+        coin: resolvedCoin,
+        network: params.network,
+        now_ms: params.nowMs,
+        mid: readMidFromAllMids(mids, resolvedCoin),
+        positions,
+        kline_5m: trimCandles(raw5m, params.kline5mBars),
+        kline_1h: trimCandles(raw1h, params.kline1hBars),
+        kline_1d: trimCandles(raw1d, params.kline1dBars),
+        user_note: params.userNote,
+    };
+}
+//# sourceMappingURL=contextBuilder.js.map

package/dist/advisor/contextBuilder.js.map

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

package/dist/advisor/deepseekClient.d.ts

@@ -0,0 +1,26 @@
+/** Default chat model when `DEEPSEEK_MODEL` is unset (DeepSeek OpenAI-compatible API). */
+export declare const DEFAULT_DEEPSEEK_MODEL = "deepseek-v4-pro";
+/** DeepSeek thinking mode defaults (see api-docs.deepseek.com/guides/thinking_mode). */
+export declare const DEFAULT_DEEPSEEK_REASONING_EFFORT: "high";
+export type DeepseekReasoningEffort = "high" | "max";
+export type ChatTurn = {
+    role: "system" | "user" | "assistant";
+    content: string;
+    /** DeepSeek thinking-mode CoT; only on assistant turns, echoed back on subsequent requests. */
+    reasoning_content?: string;
+};
+export type DeepseekChatResult = {
+    content: string;
+    reasoningContent?: string;
+};
+/** Build an assistant message for the next API round (includes reasoning when present). */
+export declare function assistantChatTurnFromResult(res: DeepseekChatResult): ChatTurn;
+export declare function deepseekChat(params: {
+    apiKey: string;
+    baseUrl?: string;
+    model?: string;
+    messages: ChatTurn[];
+    reasoningEffort?: DeepseekReasoningEffort;
+    fetchImpl?: typeof fetch;
+}): Promise<DeepseekChatResult>;
+//# sourceMappingURL=deepseekClient.d.ts.map

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/guards.d.ts

@@ -0,0 +1,17 @@
+import type { UserProfile } from "../core/state/schema.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;
+};
+/**
+ * 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;AAG3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,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;CAClC,CAAC;AAsBF;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,kBAAkB,GACzB,IAAI,CA0DN"}

package/dist/advisor/guards.js

@@ -0,0 +1,71 @@
+import { ConfigError } from "../core/errors.js";
+import { mergeUserProfileDefaults } from "../core/state/profileStore.js";
+function effectiveRequireTpsl(inputs) {
+    if (inputs.requireTpsl !== undefined) {
+        return inputs.requireTpsl;
+    }
+    return mergeUserProfileDefaults(inputs.profile).requireTpsl;
+}
+function effectiveDeviationMax(inputs) {
+    return mergeUserProfileDefaults(inputs.profile).priceDeviationPctMax;
+}
+function perCoinMaxSz(inputs) {
+    const p = mergeUserProfileDefaults(inputs.profile);
+    const by = p.maxSzByCoin?.[inputs.coin];
+    if (typeof by === "number" && Number.isFinite(by)) {
+        return by;
+    }
+    return p.defaultMaxSz;
+}
+/**
+ * Hard execution guards (do not rely on the model). Throws `ConfigError` when blocked.
+ */
+export function assertAdvisorActionPassesGuards(action, inputs) {
+    const maxSz = inputs.maxSz;
+    if (!Number.isFinite(maxSz) || maxSz <= 0) {
+        throw new ConfigError("advise: --max-sz must be a positive finite number.");
+    }
+    const coinCap = perCoinMaxSz(inputs);
+    const szCap = coinCap !== undefined ? Math.min(maxSz, coinCap) : maxSz;
+    if (action.action === "open_with_bracket") {
+        if (effectiveRequireTpsl(inputs)) {
+            if (!Number.isFinite(action.tp_px) || !Number.isFinite(action.sl_px)) {
+                throw new ConfigError("advise: bracket action blocked (--require-tpsl): missing tp/sl.");
+            }
+        }
+        if (action.sz > szCap) {
+            throw new ConfigError(`advise: bracket sz ${action.sz} exceeds cap ${szCap} ( --max-sz / profile ).`);
+        }
+        if (inputs.mid !== null && inputs.mid > 0) {
+            const dev = Math.abs(action.limit_px - inputs.mid) / inputs.mid;
+            if (dev > effectiveDeviationMax(inputs)) {
+                throw new ConfigError(`advise: limit_px ${action.limit_px} deviates ${(dev * 100).toFixed(2)}% from mid ${inputs.mid}; max ${(effectiveDeviationMax(inputs) * 100).toFixed(2)}%.`);
+            }
+        }
+    }
+    if (action.action === "close_position") {
+        const pos = inputs.positionSignedSz;
+        if (pos === undefined || !Number.isFinite(pos) || pos === 0) {
+            throw new ConfigError("advise: close_position blocked: no open position for this coin.");
+        }
+        const absz = Math.abs(pos);
+        if (absz > szCap) {
+            throw new ConfigError(`advise: close_position blocked: position size ${absz} exceeds cap ${szCap}.`);
+        }
+        if (action.method === "limit") {
+            if (action.limit_px === undefined || !Number.isFinite(action.limit_px)) {
+                throw new ConfigError("advise: close_position limit method requires limit_px.");
+            }
+            if (inputs.mid !== null && inputs.mid > 0) {
+                const dev = Math.abs(action.limit_px - inputs.mid) / inputs.mid;
+                if (dev > effectiveDeviationMax(inputs)) {
+                    throw new ConfigError(`advise: close limit_px deviates too far from mid (${(dev * 100).toFixed(2)}% > ${(effectiveDeviationMax(inputs) * 100).toFixed(2)}%).`);
+                }
+            }
+        }
+        if (action.method === "market" && inputs.mid === null) {
+            throw new ConfigError("advise: close_position market needs a valid mid price.");
+        }
+    }
+}
+//# sourceMappingURL=guards.js.map

package/dist/advisor/guards.js.map

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

package/dist/advisor/promptTemplate.d.ts

@@ -0,0 +1,5 @@
+import type { UserProfile } from "../core/state/schema.js";
+import type { AdvisorMarketSnapshot } from "./contextBuilder.js";
+export declare function buildAdvisorSystemPrompt(profile: UserProfile | undefined): string;
+export declare function formatFirstUserPayload(snapshot: AdvisorMarketSnapshot): string;
+//# sourceMappingURL=promptTemplate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promptTemplate.d.ts","sourceRoot":"","sources":["../../src/advisor/promptTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CA+DjF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAgB9E"}

package/dist/advisor/promptTemplate.js

@@ -0,0 +1,78 @@
+import { mergeUserProfileDefaults } from "../core/state/profileStore.js";
+export function buildAdvisorSystemPrompt(profile) {
+    const p = mergeUserProfileDefaults(profile);
+    const perCoin = p.maxSzByCoin && Object.keys(p.maxSzByCoin).length > 0
+        ? `- per-coin max size: ${JSON.stringify(p.maxSzByCoin)}`
+        : "";
+    return `你是一位专注于 Hyperliquid 永续合约的风控型量化交易顾问，具备专业的技术分析能力。请只回复一个 JSON 对象（不要 markdown 围栏，不要额外文字）。JSON 必须符合用户消息中的约定，且 reason 等文本字段请使用中文。
+
+用户风险偏好：
+- 风格：${p.risk}
+- 当 requireTpsl 为 true（当前：${p.requireTpsl}）时，bracket 交易必须包含 TP 和 SL
+- 限价单价格应在当前 mid 的 ±${(p.priceDeviationPctMax * 100).toFixed(2)}% 以内，除非选择等待
+${p.defaultMaxSz !== undefined ? `- 建议最大仓位上限参考：${p.defaultMaxSz}` : ""}
+${perCoin}
+${p.tradingStyleNotes ? `- 备注：${p.tradingStyleNotes}` : ""}
+
+## 分析框架（决策前必须先完成以下三维分析，结果写入 analysis 字段）
+
+### 1. 常规技术指标（analysis.indicators）
+综合多周期 K 线数据，分析以下指标并给出文字摘要：
+- 趋势：EMA/MA 排列方向，日线/1h/5m 多周期共振程度
+- 动能：MACD 柱高度变化、DIF/DEA 穿越、背离
+- 超买超卖：RSI 数值及是否进入极端区间
+- 波动率：布林带开合程度，价格所处带位
+- 量价关系（如有成交量数据）
+综合判断当前趋势状态：强势上涨 / 强势下跌 / 弱势盘整 / 即将变盘
+
+### 2. 波浪理论（analysis.elliott_wave）
+对当前价格走势进行波浪标注：
+- 判断当前所处浪级（推动浪 i~v 或调整浪 A/B/C）
+- 说明前一完整浪形的起止价格，以及当前浪的起点位置
+- 预测下一浪的方向与典型目标位（参考黄金比例 0.618 / 1.0 / 1.618 扩展）
+- 若判断不确定，说明多空两个情景下的浪形路径
+
+### 3. 缠论（analysis.chan_theory）
+从缠论角度分析结构：
+- 识别近期的笔（BI）和线段（Duan）方向
+- 判断当前中枢位置（震荡区间上下界）
+- 识别趋势类型：上涨/下跌/盘整
+- 指出当前是否出现买卖点：一买/二买/三买 或 一卖/二卖/三卖，以及对应的信号依据
+
+### 4. 价格目标与时间预估（analysis.price_targets）
+基于以上三维分析，列出关键价格目标，每项包含：
+- level: 价格数值
+- label: 目标含义，如"目标位1"、"强阻力"、"关键支撑"、"止损参考"
+- time_est: 预计到达时间，如"2-4小时"、"1-3天"、"本周内"
+- probability: 到达概率 0~1（可选）
+
+### 5. 时间维度（analysis.time_horizon）
+基于分析给出本次策略的建议持仓时长，如"4-8小时"、"1-2天"
+
+---
+
+## 决策规则
+
+在完成以上分析后，给出具体的操作动作。允许的 "action" 字符串值：
+- "wait"：包含 reason（中文）、confidence
+- "open_with_bracket"：side buy|sell，limit_px，sz，tp_px，sl_px，is_market boolean；若 is_market 为 false，需设置 protection_limit_px（TP/SL 触发后的跟随限价）；reason（中文）、confidence，risk_flags 可选数组
+- "close_position"：method "market"|"limit"；若为 limit，需设置 limit_px；reason（中文）、confidence
+- "cancel_all"：撤销本地 state 中所有挂单 — 仅需 reason（中文）
+
+仓位大小单位为币种单位。置信度低时请保守操作；不确定时优先选择 "wait"。
+tp_px / sl_px 应与 price_targets 中的目标位保持一致，策略须具备时间维度的应对预案。`;
+}
+export function formatFirstUserPayload(snapshot) {
+    return JSON.stringify({
+        coin: snapshot.coin,
+        network: snapshot.network,
+        now_ms: snapshot.now_ms,
+        mid: snapshot.mid,
+        positions: snapshot.positions,
+        kline_5m: snapshot.kline_5m,
+        kline_1h: snapshot.kline_1h,
+        kline_1d: snapshot.kline_1d,
+        user_note: snapshot.user_note,
+    }, null, 2);
+}
+//# sourceMappingURL=promptTemplate.js.map

package/dist/advisor/promptTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptTemplate.js","sourceRoot":"","sources":["../../src/advisor/promptTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAIzE,MAAM,UAAU,wBAAwB,CAAC,OAAgC;IACvE,MAAM,CAAC,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,OAAO,GACX,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;QACpD,CAAC,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE;QACzD,CAAC,CAAC,EAAE,CAAC;IACT,OAAO;;;OAGF,CAAC,CAAC,IAAI;4BACe,CAAC,CAAC,WAAW;qBACpB,CAAC,CAAC,CAAC,oBAAoB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;EAC5D,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;EACpE,OAAO;EACP,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAgDD,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA+B;IACpE,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/advisor/sessionLog.d.ts

@@ -0,0 +1,41 @@
+import type { UserProfile } from "../core/state/schema.js";
+import type { AdvisorAction } from "./actionSchema.js";
+import type { AdvisorMarketSnapshot } from "./contextBuilder.js";
+export type AdvisorSessionTurn = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: string;
+} | {
+    role: "assistant";
+    content: string;
+    reasoning_content?: string;
+    action?: AdvisorAction;
+};
+export type AdvisorSessionFile = {
+    sessionId: string;
+    coin: string;
+    createdAtMs: number;
+    model: string;
+    userProfileSnapshot: UserProfile | null;
+    marketSnapshot: {
+        coin: string;
+        network: string;
+        now_ms: number;
+        mid: number | null;
+        positions: AdvisorMarketSnapshot["positions"];
+        kline_5m: AdvisorMarketSnapshot["kline_5m"];
+        kline_1h: AdvisorMarketSnapshot["kline_1h"];
+        kline_1d: AdvisorMarketSnapshot["kline_1d"];
+    };
+    turns: AdvisorSessionTurn[];
+    executed?: {
+        command: string;
+        actionSpec: AdvisorAction;
+        exchangeResponse: unknown;
+        exitCode: number;
+    };
+};
+export declare function writeAdvisorSessionLog(filePath: string, data: AdvisorSessionFile): Promise<void>;
+//# sourceMappingURL=sessionLog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionLog.d.ts","sourceRoot":"","sources":["../../src/advisor/sessionLog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,WAAW,GAAG,IAAI,CAAC;IACxC,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,SAAS,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAC9C,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAC5C,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAC5C,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;KAC7C,CAAC;IACF,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,aAAa,CAAC;QAC1B,gBAAgB,EAAE,OAAO,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/advisor/sessionLog.js

@@ -0,0 +1,7 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+export async function writeAdvisorSessionLog(filePath, data) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(data, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=sessionLog.js.map

package/dist/advisor/sessionLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionLog.js","sourceRoot":"","sources":["../../src/advisor/sessionLog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AA0C7B,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,IAAwB;IAExB,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC"}

package/dist/cli/advisorCli.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function attachAdvisorCli(program: Command): void;
+//# sourceMappingURL=advisorCli.d.ts.map

package/dist/cli/advisorCli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advisorCli.d.ts","sourceRoot":"","sources":["../../src/cli/advisorCli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4EzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6VvD"}