jcc_hyper_tool 0.1.4 → 0.1.6

package/dist/advisor/adviseEngine.js

@@ -0,0 +1,172 @@
+import { assistantChatTurnFromResult, deepseekChat } from "./deepseekClient.js";
+import { parseDualAdvisorResponse, dualActionsFromResponse } from "./actionSchema.js";
+import { isAdvisorBracketOpenAction } from "./actionSchema.js";
+import { assertAdvisorActionPassesGuards } from "./guards.js";
+import { mergeUserProfileDefaults } from "../core/state/profileStore.js";
+import { readOrCreateTradeStateFile } from "../core/state/store.js";
+import { reconcilePendingAmbushBeforePlace } from "./ambushPolicy.js";
+import { advisorActionToCliArgs, assertAdviseActionNeedsState, buildGlobalPrefix, formatCliInvocation, spawnJccHyperTool, } from "./actionRunner.js";
+import { assertAdvisorConfidenceGate, assertAdviseExecuteCooldown, prepareAdvisorActionForExecution, readAdviseExecuteHistory, recordAdviseExecuteCooldown, resolveAdvisorExecutionPolicy, resolveAdvisorSzCap, } from "./executionPolicy.js";
+/**
+ * Calls DeepSeek; validates JSON/Zod; on failure appends repair instructions (bounded retries).
+ */
+export async function runAdvisorModelTurnWithRepair(params) {
+    const maxRepair = params.maxRepair ?? 2;
+    const maxAttempts = maxRepair + 1;
+    let msgs = [...params.messages];
+    let lastRes = { content: "" };
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        lastRes = await deepseekChat({
+            apiKey: params.apiKey,
+            messages: msgs,
+            fetchImpl: params.fetchImpl,
+        });
+        try {
+            const response = parseDualAdvisorResponse(lastRes.content);
+            const actions = dualActionsFromResponse(response);
+            msgs = [...msgs, assistantChatTurnFromResult(lastRes)];
+            return { messages: msgs, response, actions, lastAssistant: lastRes };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            if (attempt >= maxAttempts - 1) {
+                throw e;
+            }
+            msgs = [
+                ...msgs,
+                assistantChatTurnFromResult(lastRes),
+                {
+                    role: "user",
+                    content: `Your reply failed validation: ${msg}. Output ONE JSON object only, no markdown, matching the schema.`,
+                },
+            ];
+        }
+    }
+    throw new Error("advisor: model repair loop exhausted");
+}
+export async function executeAdvisorAction(params) {
+    if (params.action.action === "wait") {
+        return {
+            exitCode: 0,
+            stdout: "",
+            stderr: "",
+            command: "(no exchange action)",
+            response: { note: "wait" },
+        };
+    }
+    const posRow = params.snapshot.positions[params.snapshot.coin];
+    const positionSignedSz = posRow?.signed_sz;
+    const nowMs = params.nowMs ?? Date.now();
+    let tradeState = params.statePath && !params.noState
+        ? await readOrCreateTradeStateFile(params.statePath, nowMs)
+        : undefined;
+    const guardInputs = {
+        coin: params.coin,
+        maxSz: params.maxSz,
+        requireTpsl: params.requireTpsl,
+        mid: params.snapshot.mid,
+        positionSignedSz,
+        positionEntryPx: posRow?.entry_px,
+        profile: params.profile,
+        szDecimals: params.snapshot.sz_decimals,
+        tradeState,
+        nowMs,
+        kline1h: params.snapshot.kline_1h,
+        skipTouchProb: true,
+    };
+    const policy = params.executionPolicy ??
+        resolveAdvisorExecutionPolicy(params.profile, params.executionPolicyCli ?? {});
+    assertAdvisorConfidenceGate(params.action, policy.minConfidence);
+    if (policy.executeCooldownSec > 0 && params.statePath && !params.noState) {
+        assertAdviseExecuteCooldown({
+            history: readAdviseExecuteHistory(tradeState),
+            coin: params.coin,
+            action: params.action,
+            cooldownSec: policy.executeCooldownSec,
+            nowMs,
+        });
+    }
+    assertAdvisorActionPassesGuards(params.action, guardInputs);
+    const maxDevPct = mergeUserProfileDefaults(params.profile).priceDeviationPctMax;
+    const slShift = policy.bracketSlEntryShift;
+    const { action: execAction, notes: execNotes } = prepareAdvisorActionForExecution(params.action, {
+        slEntryShift: slShift,
+        limitJitterPct: policy.limitJitterPct,
+        mid: params.snapshot.mid,
+        maxDevPct,
+        szDecimals: params.snapshot.sz_decimals,
+        kline1h: params.snapshot.kline_1h,
+        profile: params.profile,
+    });
+    for (const note of execNotes) {
+        process.stderr.write(`advise: ${note}.\n`);
+    }
+    assertAdvisorActionPassesGuards(execAction, {
+        ...guardInputs,
+        skipEntryMidDeviation: slShift > 0 && isAdvisorBracketOpenAction(execAction),
+        skipTouchProb: false,
+    });
+    assertAdviseActionNeedsState(execAction, params.noState, params.statePath);
+    if (execAction.action === "place_limit_ambush" &&
+        params.statePath &&
+        !params.noState) {
+        const replace = await reconcilePendingAmbushBeforePlace({
+            statePath: params.statePath,
+            coin: params.coin,
+            action: execAction,
+            replaceDeviationPct: policy.ambushReplaceDeviationPct,
+            nowMs,
+        });
+        for (const id of replace.cancelledIntentIds) {
+            process.stderr.write(`advise: ambush replace — requested cancel of stale intent ${id}.\n`);
+        }
+        tradeState = await readOrCreateTradeStateFile(params.statePath, nowMs);
+    }
+    const szCap = resolveAdvisorSzCap(guardInputs);
+    const g = buildGlobalPrefix(params.globals);
+    const argv = advisorActionToCliArgs(execAction, {
+        coin: params.snapshot.coin,
+        mid: params.snapshot.mid,
+        positionSignedSz,
+        globals: g,
+        live: params.live,
+        assumeYes: params.assumeYes,
+        szCap,
+        limitJitterPct: policy.limitJitterPct,
+        maxDevPct,
+        szDecimals: params.snapshot.sz_decimals,
+    });
+    const command = formatCliInvocation(argv);
+    if (params.live && !params.assumeYes && params.confirmLive) {
+        await params.confirmLive(`Proposed command:\n${command}\n`);
+    }
+    const cap = spawnJccHyperTool(argv, { stdio: "pipe" });
+    let response = { stdout: cap.stdout, stderr: cap.stderr };
+    try {
+        response = JSON.parse(cap.stdout);
+    }
+    catch {
+        /* non-JSON stdout */
+    }
+    const exitCode = cap.status ?? 1;
+    if (exitCode === 0 &&
+        params.live &&
+        params.statePath &&
+        !params.noState &&
+        policy.executeCooldownSec > 0) {
+        await recordAdviseExecuteCooldown({
+            statePath: params.statePath,
+            coin: params.coin,
+            action: params.action,
+            nowMs,
+        });
+    }
+    return {
+        exitCode,
+        stdout: cap.stdout,
+        stderr: cap.stderr,
+        command,
+        response,
+    };
+}
+//# sourceMappingURL=adviseEngine.js.map

package/dist/advisor/adviseEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adviseEngine.js","sourceRoot":"","sources":["../../src/advisor/adviseEngine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,gCAAgC,EAChC,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAY9B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,MAMnD;IACC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,SAAS,GAAG,CAAC,CAAC;IAClC,IAAI,IAAI,GAAe,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,OAAO,GAAuB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAElD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,OAAO,GAAG,MAAM,YAAY,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,wBAAwB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC;YACvD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,IAAI,OAAO,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,CAAC;YACV,CAAC;YACD,IAAI,GAAG;gBACL,GAAG,IAAI;gBACP,2BAA2B,CAAC,OAAO,CAAC;gBACpC;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,iCAAiC,GAAG,kEAAkE;iBAChH;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC1D,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAgB1C;IACC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACpC,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAmC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/F,MAAM,gBAAgB,GAAG,MAAM,EAAE,SAAS,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACzC,IAAI,UAAU,GACZ,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,OAAO;QACjC,CAAC,CAAC,MAAM,0BAA0B,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC;QAC3D,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,WAAW,GAAG;QAClB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG;QACxB,gBAAgB;QAChB,eAAe,EAAE,MAAM,EAAE,QAAQ;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW;QACvC,UAAU;QACV,KAAK;QACL,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;QACjC,aAAa,EAAE,IAAI;KACpB,CAAC;IAEF,MAAM,MAAM,GACV,MAAM,CAAC,eAAe;QACtB,6BAA6B,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;IAEjF,2BAA2B,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IAEjE,IAAI,MAAM,CAAC,kBAAkB,GAAG,CAAC,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACzE,2BAA2B,CAAC;YAC1B,OAAO,EAAE,wBAAwB,CAAC,UAAU,CAAC;YAC7C,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,kBAAkB;YACtC,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,+BAA+B,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAE5D,MAAM,SAAS,GAAG,wBAAwB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC;IAChF,MAAM,OAAO,GAAG,MAAM,CAAC,mBAAmB,CAAC;IAC3C,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,gCAAgC,CAC/E,MAAM,CAAC,MAAM,EACb;QACE,YAAY,EAAE,OAAO;QACrB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG;QACxB,SAAS;QACT,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW;QACvC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CACF,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,+BAA+B,CAAC,UAAU,EAAE;QAC1C,GAAG,WAAW;QACd,qBAAqB,EACnB,OAAO,GAAG,CAAC,IAAI,0BAA0B,CAAC,UAAU,CAAC;QACvD,aAAa,EAAE,KAAK;KACrB,CAAC,CAAC;IAEH,4BAA4B,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAE3E,IACE,UAAU,CAAC,MAAM,KAAK,oBAAoB;QAC1C,MAAM,CAAC,SAAS;QAChB,CAAC,MAAM,CAAC,OAAO,EACf,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,iCAAiC,CAAC;YACtD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,UAAU;YAClB,mBAAmB,EAAE,MAAM,CAAC,yBAAyB;YACrD,KAAK;SACN,CAAC,CAAC;QACH,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6DAA6D,EAAE,KAAK,CACrE,CAAC;QACJ,CAAC;QACD,UAAU,GAAG,MAAM,0BAA0B,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,sBAAsB,CAAC,UAAU,EAAE;QAC9C,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;QAC1B,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG;QACxB,gBAAgB;QAChB,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK;QACL,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,SAAS;QACT,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW;KACxC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAE1C,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,MAAM,CAAC,WAAW,CAAC,sBAAsB,OAAO,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,IAAI,QAAQ,GAAY,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;IACnE,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAY,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACjC,IACE,QAAQ,KAAK,CAAC;QACd,MAAM,CAAC,IAAI;QACX,MAAM,CAAC,SAAS;QAChB,CAAC,MAAM,CAAC,OAAO;QACf,MAAM,CAAC,kBAAkB,GAAG,CAAC,EAC7B,CAAC;QACD,MAAM,2BAA2B,CAAC;YAChC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO;QACP,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/advisor/ambushPolicy.d.ts

@@ -0,0 +1,47 @@
+import type { BracketIntentRecord, TradeStateFile } from "../core/state/schema.js";
+import type { AdvisorAction } from "./actionSchema.js";
+export type PendingAmbushSummary = {
+    intentId: string;
+    phase: string;
+    side: "buy" | "sell";
+    limitPx: number;
+    sz: number;
+    tpPx: number;
+    slPx: number;
+    expiresAtMs: number;
+    expiresInSec: number;
+    strategy?: "scalp" | "ambush";
+};
+export declare function isAmbushBracket(intent: BracketIntentRecord): boolean;
+export declare function isActivePendingAmbush(intent: BracketIntentRecord, nowMs: number): boolean;
+export declare function listPendingAmbushIntents(state: TradeStateFile, coin: string, nowMs: number): PendingAmbushSummary[];
+export declare function hasActiveUnexpiredAmbush(state: TradeStateFile, coin: string, nowMs: number): boolean;
+export declare function priceDeviationFraction(oldPx: number, newPx: number): number;
+export declare function shouldReplaceAmbush(existingLimitPx: number, newLimitPx: number, thresholdPct: number): boolean;
+export declare function requestBracketEntryCancel(statePath: string, intentId: string, nowMs: number): Promise<void>;
+export declare function findActiveProtectionBracket(state: TradeStateFile, coin: string): BracketIntentRecord | undefined;
+export declare function resolvePositionOpenAgeSec(params: {
+    state: TradeStateFile;
+    coin: string;
+    nowMs: number;
+}): number | undefined;
+export declare function hasPriceHitTpOrSl(side: "buy" | "sell", mid: number, tp: number, sl: number): boolean;
+export type AmbushReplaceResult = {
+    cancelledIntentIds: string[];
+    skippedDuplicate: boolean;
+};
+/**
+ * Before placing a new ambush: cancel stale pending ambushes when price/side diverges;
+ * block duplicate placement when an unexpired ambush already matches the new estimate.
+ */
+export declare function reconcilePendingAmbushBeforePlace(params: {
+    statePath: string;
+    coin: string;
+    action: Extract<AdvisorAction, {
+        action: "place_limit_ambush";
+    }>;
+    replaceDeviationPct: number;
+    nowMs: number;
+}): Promise<AmbushReplaceResult>;
+export declare function ambushActionSummary(action: AdvisorAction): string | undefined;
+//# sourceMappingURL=ambushPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ambushPolicy.d.ts","sourceRoot":"","sources":["../../src/advisor/ambushPolicy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC/B,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAGpE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAWzF;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,oBAAoB,EAAE,CAwBxB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAET;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3E;AAED,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAET;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,GACX,mBAAmB,GAAG,SAAS,CAUjC;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,GAAG,SAAS,CAqCrB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,KAAK,GAAG,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAKT;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,iCAAiC,CAAC,MAAM,EAAE;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC,CAAC;IACjE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuB/B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAO7E"}

package/dist/advisor/ambushPolicy.js

@@ -0,0 +1,161 @@
+import { ConfigError } from "../core/errors.js";
+import { readOrCreateTradeStateFile, updateTradeStateFileAtomic } from "../core/state/store.js";
+import { isAdvisorBracketOpenAction } from "./actionSchema.js";
+const PENDING_ENTRY_PHASES = new Set(["planned", "entry_pending", "entry_partial"]);
+export function isAmbushBracket(intent) {
+    // undefined strategy = legacy intent, treated as ambush
+    return intent.strategy !== "scalp";
+}
+export function isActivePendingAmbush(intent, nowMs) {
+    if (!isAmbushBracket(intent)) {
+        return false;
+    }
+    if (!PENDING_ENTRY_PHASES.has(intent.phase)) {
+        return false;
+    }
+    if (intent.expiresAtMs !== undefined && nowMs > intent.expiresAtMs) {
+        return false;
+    }
+    return intent.phase !== "expired" && intent.phase !== "cancelled";
+}
+export function listPendingAmbushIntents(state, coin, nowMs) {
+    const out = [];
+    for (const [intentId, intent] of Object.entries(state.intents)) {
+        if (intent.kind !== "bracket" || intent.coin !== coin) {
+            continue;
+        }
+        if (!isActivePendingAmbush(intent, nowMs)) {
+            continue;
+        }
+        const expiresAtMs = intent.expiresAtMs ?? nowMs;
+        out.push({
+            intentId,
+            phase: intent.phase,
+            side: intent.entrySide,
+            limitPx: intent.entryLimitPx,
+            sz: intent.entrySz,
+            tpPx: intent.tpTriggerPx,
+            slPx: intent.slTriggerPx,
+            expiresAtMs,
+            expiresInSec: Math.max(0, Math.ceil((expiresAtMs - nowMs) / 1000)),
+            strategy: intent.strategy,
+        });
+    }
+    return out.sort((a, b) => a.expiresAtMs - b.expiresAtMs);
+}
+export function hasActiveUnexpiredAmbush(state, coin, nowMs) {
+    return listPendingAmbushIntents(state, coin, nowMs).length > 0;
+}
+export function priceDeviationFraction(oldPx, newPx) {
+    if (!Number.isFinite(oldPx) || oldPx <= 0) {
+        return Number.POSITIVE_INFINITY;
+    }
+    return Math.abs(newPx - oldPx) / oldPx;
+}
+export function shouldReplaceAmbush(existingLimitPx, newLimitPx, thresholdPct) {
+    return priceDeviationFraction(existingLimitPx, newLimitPx) > thresholdPct;
+}
+export async function requestBracketEntryCancel(statePath, intentId, nowMs) {
+    await updateTradeStateFileAtomic(statePath, (cur) => {
+        const row = cur.intents[intentId];
+        if (!row || row.kind !== "bracket") {
+            throw new ConfigError(`Bracket intent not found: ${intentId}`);
+        }
+        const nextB = { ...row, cancelRequested: true, updatedAtMs: nowMs };
+        return {
+            ...cur,
+            updatedAtMs: nowMs,
+            intents: { ...cur.intents, [intentId]: nextB },
+            events: [
+                ...cur.events,
+                {
+                    t: nowMs,
+                    intentId,
+                    type: "user_cancel_request",
+                    message: "cancelRequested=true (advise ambush replace)",
+                },
+            ],
+        };
+    }, nowMs);
+}
+export function findActiveProtectionBracket(state, coin) {
+    for (const intent of Object.values(state.intents)) {
+        if (intent.kind !== "bracket" || intent.coin !== coin) {
+            continue;
+        }
+        if (intent.phase === "protection_active" || intent.phase === "entry_filled") {
+            return intent;
+        }
+    }
+    return undefined;
+}
+export function resolvePositionOpenAgeSec(params) {
+    const bracket = findActiveProtectionBracket(params.state, params.coin);
+    if (bracket) {
+        for (let i = params.state.events.length - 1; i >= 0; i--) {
+            const ev = params.state.events[i];
+            if (ev.intentId !== bracket.id) {
+                continue;
+            }
+            if (ev.message?.includes("entry_filled") || ev.type === "phase" && ev.message?.includes("entry_filled")) {
+                return Math.max(0, (params.nowMs - ev.t) / 1000);
+            }
+        }
+        return Math.max(0, (params.nowMs - bracket.createdAtMs) / 1000);
+    }
+    const history = params.state.adviseExecuteHistory;
+    if (!history) {
+        return undefined;
+    }
+    let latest;
+    for (const [key, rec] of Object.entries(history)) {
+        if (!key.startsWith(`${params.coin}:`)) {
+            continue;
+        }
+        if (rec.action !== "place_limit_ambush" &&
+            rec.action !== "open_with_bracket") {
+            continue;
+        }
+        if (latest === undefined || rec.atMs > latest) {
+            latest = rec.atMs;
+        }
+    }
+    if (latest === undefined) {
+        return undefined;
+    }
+    return Math.max(0, (params.nowMs - latest) / 1000);
+}
+export function hasPriceHitTpOrSl(side, mid, tp, sl) {
+    if (side === "buy") {
+        return mid >= tp || mid <= sl;
+    }
+    return mid <= tp || mid >= sl;
+}
+/**
+ * Before placing a new ambush: cancel stale pending ambushes when price/side diverges;
+ * block duplicate placement when an unexpired ambush already matches the new estimate.
+ */
+export async function reconcilePendingAmbushBeforePlace(params) {
+    const state = await readOrCreateTradeStateFile(params.statePath, params.nowMs);
+    const pending = listPendingAmbushIntents(state, params.coin, params.nowMs);
+    const cancelledIntentIds = [];
+    for (const p of pending) {
+        const sideChanged = p.side !== params.action.side;
+        const priceDiverged = shouldReplaceAmbush(p.limitPx, params.action.limit_px, params.replaceDeviationPct);
+        if (sideChanged || priceDiverged) {
+            await requestBracketEntryCancel(params.statePath, p.intentId, params.nowMs);
+            cancelledIntentIds.push(p.intentId);
+            continue;
+        }
+        throw new ConfigError(`advise: pending ambush ${p.intentId} at ${p.limitPx} (${p.side}) matches new estimate within ${(params.replaceDeviationPct * 100).toFixed(2)}%; wait for TTL (${p.expiresInSec}s left) or choose "wait".`);
+    }
+    return { cancelledIntentIds, skippedDuplicate: false };
+}
+export function ambushActionSummary(action) {
+    if (!isAdvisorBracketOpenAction(action)) {
+        return undefined;
+    }
+    const ttl = action.action === "place_limit_ambush" ? ` TTL ${action.expires_in_min}m` : "";
+    return `${action.side} @ ${action.limit_px} sz ${action.sz} tp ${action.tp_px} sl ${action.sl_px}${ttl}`;
+}
+//# sourceMappingURL=ambushPolicy.js.map

package/dist/advisor/ambushPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambushPolicy.js","sourceRoot":"","sources":["../../src/advisor/ambushPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGhG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC;AAepF,MAAM,UAAU,eAAe,CAAC,MAA2B;IACzD,wDAAwD;IACxD,OAAO,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAA2B,EAAE,KAAa;IAC9E,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAqB,EACrB,IAAY,EACZ,KAAa;IAEb,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC;YACP,QAAQ;YACR,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,SAAS;YACtB,OAAO,EAAE,MAAM,CAAC,YAAY;YAC5B,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,IAAI,EAAE,MAAM,CAAC,WAAW;YACxB,IAAI,EAAE,MAAM,CAAC,WAAW;YACxB,WAAW;YACX,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YAClE,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAqB,EACrB,IAAY,EACZ,KAAa;IAEb,OAAO,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,KAAa;IACjE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,iBAAiB,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,eAAuB,EACvB,UAAkB,EAClB,YAAoB;IAEpB,OAAO,sBAAsB,CAAC,eAAe,EAAE,UAAU,CAAC,GAAG,YAAY,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,SAAiB,EACjB,QAAgB,EAChB,KAAa;IAEb,MAAM,0BAA0B,CAC9B,SAAS,EACT,CAAC,GAAG,EAAE,EAAE;QACN,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,WAAW,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,KAAK,GAAwB,EAAE,GAAG,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QACzF,OAAO;YACL,GAAG,GAAG;YACN,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE;YAC9C,MAAM,EAAE;gBACN,GAAG,GAAG,CAAC,MAAM;gBACb;oBACE,CAAC,EAAE,KAAK;oBACR,QAAQ;oBACR,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,8CAA8C;iBACxD;aACF;SACF,CAAC;IACJ,CAAC,EACD,KAAK,CACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAqB,EACrB,IAAY;IAEZ,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,mBAAmB,IAAI,MAAM,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YAC5E,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAIzC;IACC,MAAM,OAAO,GAAG,2BAA2B,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,EAAE,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACxG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAA0B,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACvC,SAAS;QACX,CAAC;QACD,IACE,GAAG,CAAC,MAAM,KAAK,oBAAoB;YACnC,GAAG,CAAC,MAAM,KAAK,mBAAmB,EAClC,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC;YAC9C,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAoB,EACpB,GAAW,EACX,EAAU,EACV,EAAU;IAEV,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC;AAChC,CAAC;AAOD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,MAMvD;IACC,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3E,MAAM,kBAAkB,GAAa,EAAE,CAAC;IAExC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QAClD,MAAM,aAAa,GAAG,mBAAmB,CACvC,CAAC,CAAC,OAAO,EACT,MAAM,CAAC,MAAM,CAAC,QAAQ,EACtB,MAAM,CAAC,mBAAmB,CAC3B,CAAC;QACF,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,yBAAyB,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,MAAM,IAAI,WAAW,CACnB,0BAA0B,CAAC,CAAC,QAAQ,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,iCAAiC,CAAC,MAAM,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,YAAY,2BAA2B,CAC3M,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GACP,MAAM,CAAC,MAAM,KAAK,oBAAoB,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,OAAO,GAAG,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,QAAQ,OAAO,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,KAAK,OAAO,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC;AAC3G,CAAC"}

package/dist/advisor/contextBuilder.d.ts

@@ -0,0 +1,51 @@
+import type { HyperliquidInfoClient } from "../core/hyperliquid/client.js";
+import type { JsonValue } from "../core/hyperliquid/types.js";
+import type { CompactCandle, IndicatorSummary } from "./indicatorCompute.js";
+import type { ContextVersion } from "./promptTemplate.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;
+    /** Per-asset size decimals from HL meta (drives price rounding: max 6 - szDecimals decimal places). */
+    sz_decimals: number;
+    /** HL minimum order notional (USD). */
+    min_order_notional_usd: number;
+    /** Smallest sz at current mid meeting min notional; null when mid unknown. */
+    min_order_sz: number | null;
+    positions: Record<string, AdvisorPositionRow>;
+    kline_5m: JsonValue;
+    kline_1h: JsonValue;
+    kline_1d: JsonValue;
+    user_note?: string;
+    /** Prompt context version controlling K-line vs pre-computed indicators. */
+    context_version: ContextVersion;
+    /** Pre-computed indicator summary (v2 only). */
+    indicator_summary?: IndicatorSummary;
+    /** Compact h/l/o/c/v candles for wave/Chan theory (v2 only). */
+    kline_5m_compact?: CompactCandle[];
+    kline_1h_compact?: CompactCandle[];
+    kline_1d_compact?: CompactCandle[];
+};
+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;
+    contextVersion: ContextVersion;
+}): 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;AAW3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,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,uGAAuG;IACvG,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,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;IACnB,4EAA4E;IAC5E,eAAe,EAAE,cAAc,CAAC;IAChC,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,aAAa,EAAE,CAAC;IACnC,gBAAgB,CAAC,EAAE,aAAa,EAAE,CAAC;IACnC,gBAAgB,CAAC,EAAE,aAAa,EAAE,CAAC;CACpC,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;IACpB,cAAc,EAAE,cAAc,CAAC;CAChC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAqEjC"}

package/dist/advisor/contextBuilder.js

@@ -0,0 +1,153 @@
+import { perpSzDecimalsFromMeta } from "../core/hyperliquid/asset.js";
+import { HL_MIN_ORDER_NOTIONAL_USD, minPerpOrderSzForNotional, } from "../core/hyperliquid/rounding.js";
+import { assertPerpKlineCoinInMeta, resolvePerpKlineCoinArg, } from "../core/hyperliquid/klineCoin.js";
+import { inferHlDexFromPrefixedPerpCoin } from "../core/hyperliquid/prefixedPerpCoin.js";
+import { signedPositionSizeForCoin } from "../core/state/snapshot.js";
+import { buildCompactKlines, computeIndicatorSummary } from "./indicatorCompute.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);
+    const meta = await params.info.meta(dexForMeta);
+    if (dexForMeta) {
+        assertPerpKlineCoinInMeta(meta, resolvedCoin);
+    }
+    const szDecimals = perpSzDecimalsFromMeta(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, dexForMeta),
+        params.info.allMids(dexForMeta),
+    ]);
+    const pos = extractPositionDetail(ch, resolvedCoin);
+    const positions = pos ? { [resolvedCoin]: pos } : {};
+    const mid = readMidFromAllMids(mids, resolvedCoin);
+    const trimmed5m = trimCandles(raw5m, params.kline5mBars);
+    const trimmed1h = trimCandles(raw1h, params.kline1hBars);
+    const trimmed1d = trimCandles(raw1d, params.kline1dBars);
+    const isV2 = params.contextVersion === "precomputed_indicators";
+    return {
+        coin: resolvedCoin,
+        network: params.network,
+        now_ms: params.nowMs,
+        mid,
+        sz_decimals: szDecimals,
+        min_order_notional_usd: HL_MIN_ORDER_NOTIONAL_USD,
+        min_order_sz: mid !== null && mid > 0 ? minPerpOrderSzForNotional(mid, szDecimals) : null,
+        positions,
+        kline_5m: trimmed5m,
+        kline_1h: trimmed1h,
+        kline_1d: trimmed1d,
+        user_note: params.userNote,
+        context_version: params.contextVersion,
+        indicator_summary: isV2
+            ? computeIndicatorSummary(trimmed5m, trimmed1h, trimmed1d)
+            : undefined,
+        kline_5m_compact: isV2 ? buildCompactKlines(trimmed5m, params.kline5mBars) : undefined,
+        kline_1h_compact: isV2 ? buildCompactKlines(trimmed1h, params.kline1hBars) : undefined,
+        kline_1d_compact: isV2 ? buildCompactKlines(trimmed1d, params.kline1dBars) : undefined,
+    };
+}
+//# 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":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAEzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGpF,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC;AAC/B,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC;AAmC5B,SAAS,WAAW,CAAC,GAAc,EAAE,OAAe;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAe,EAAE,IAAY;IAC9D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,GAAI,IAAgC,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,qBAAqB,CACnC,OAAkB,EAClB,IAAY;IAEZ,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,cAAc,GAAI,OAAmC,CAAC,cAAc,CAAC;IAC3E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;QAChC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAI,EAA8B,CAAC,QAAQ,CAAC;QAC1D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,QAAmC,CAAC;QAC9C,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvB,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC;QACzB,CAAC;QACD,MAAM,GAAG,GAAI,EAA8B,CAAC,QAAQ,CAAC;QACrD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACpD,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC;QACrB,CAAC;aAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,GAAI,GAA+B,CAAC,KAAK,CAAC;YACjD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAI,EAA8B,CAAC,aAAa,CAAC;QAC3D,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvB,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,MAWhD;IACC,MAAM,YAAY,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,8BAA8B,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,yBAAyB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAE9D,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7B,MAAM,EAAE,GAAG,OAAO,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,GAAG,SAAS,CAAC;IACxD,MAAM,GAAG,GAAG,OAAO,GAAG,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC;IACnD,MAAM,GAAG,GAAG,OAAO,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAElD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;YACzB,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,EAAE;YACb,OAAO;SACR,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;YACzB,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,GAAG;YACd,OAAO;SACR,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;YACzB,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,GAAG;YACd,OAAO;SACR,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;KAChC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,qBAAqB,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IACpD,MAAM,SAAS,GAAuC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAEnD,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAEzD,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,KAAK,wBAAwB,CAAC;IAEhE,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,KAAK;QACpB,GAAG;QACH,WAAW,EAAE,UAAU;QACvB,sBAAsB,EAAE,yBAAyB;QACjD,YAAY,EACV,GAAG,KAAK,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;QAC7E,SAAS;QACT,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,eAAe,EAAE,MAAM,CAAC,cAAc;QACtC,iBAAiB,EAAE,IAAI;YACrB,CAAC,CAAC,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;YAC1D,CAAC,CAAC,SAAS;QACb,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;QACtF,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;QACtF,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;KACvF,CAAC;AACJ,CAAC"}

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