jcc_hyper_tool 0.1.5 → 0.1.7

package/dist/advisor/indicatorCompute.js

@@ -0,0 +1,259 @@
+import { EMA, MACD, RSI, BollingerBands, ATR } from "trading-signals";
+function parseCandlesWithVolume(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const row of raw) {
+        if (typeof row !== "object" || row === null)
+            continue;
+        const r = row;
+        const h = Number(r.h);
+        const l = Number(r.l);
+        const o = Number(r.o);
+        const c = Number(r.c);
+        const v = Number(r.v);
+        if (Number.isFinite(h) &&
+            Number.isFinite(l) &&
+            Number.isFinite(o) &&
+            Number.isFinite(c) &&
+            h >= l) {
+            out.push({ h, l, o, c, v: Number.isFinite(v) && v >= 0 ? v : 0 });
+        }
+    }
+    return out;
+}
+function emaLabel(candles, period) {
+    if (candles.length < period)
+        return null;
+    const ema = new EMA(period);
+    for (const c of candles)
+        ema.add(c.c);
+    return ema.isStable ? ema.getResultOrThrow().toFixed(4) : null;
+}
+function describeEmaAlignment(candles) {
+    // Pick the largest available period set based on candle count.
+    // EMA needs `period` candles to stabilise; pick the max set that fits.
+    const has60 = candles.length >= 61;
+    const has20 = candles.length >= 21;
+    const has5 = candles.length >= 6;
+    if (!has5)
+        return "数据不足无法计算EMA排列(需≥6根)";
+    const e5 = emaLabel(candles, 5);
+    const e20 = has20 ? emaLabel(candles, 20) : null;
+    const e60 = has60 ? emaLabel(candles, 60) : null;
+    const parts = [];
+    parts.push(`EMA5(${e5})`);
+    if (e20)
+        parts.push(`EMA20(${e20})`);
+    if (e60)
+        parts.push(`EMA60(${e60})`);
+    const v5 = Number(e5);
+    const v20 = e20 ? Number(e20) : null;
+    const v60 = e60 ? Number(e60) : null;
+    let alignment;
+    if (v60 !== null && v20 !== null) {
+        // Full three-line alignment
+        alignment =
+            v5 > v20 && v20 > v60 ? "多头排列"
+                : v5 < v20 && v20 < v60 ? "空头排列"
+                    : v5 > v20 ? "短期偏多(EMA5>EMA20)，长期EMA60待修复"
+                        : v5 < v20 ? "短期偏空(EMA5<EMA20)，长期EMA60支撑中"
+                            : "均线缠绕，方向不明";
+    }
+    else if (v20 !== null) {
+        // Two-line alignment (EMA5 vs EMA20)
+        alignment =
+            v5 > v20 ? "短期偏多(EMA5>EMA20)"
+                : v5 < v20 ? "短期偏空(EMA5<EMA20)"
+                    : "短期均线缠绕，方向不明";
+    }
+    else {
+        alignment = `仅EMA5可用(${e5})，数据不足以判断排列`;
+    }
+    const note = !has60 ? ` (仅${candles.length}根K线，EMA60不可用)`
+        : !has20 ? ` (仅${candles.length}根K线，EMA20/60不可用)`
+            : "";
+    return parts.join(" ") + ` — ${alignment}${note}`;
+}
+function describeMacd(candles) {
+    const shortEma = new EMA(12);
+    const longEma = new EMA(26);
+    const signalEma = new EMA(9);
+    const macd = new MACD(shortEma, longEma, signalEma);
+    for (const c of candles)
+        macd.add(c.c);
+    if (!macd.isStable)
+        return "数据不足无法计算MACD";
+    const r = macd.getResultOrThrow();
+    const dif = r.macd.toFixed(4);
+    const dea = r.signal.toFixed(4);
+    const hist = r.histogram.toFixed(4);
+    const histNum = Number(hist);
+    const difDeaRel = r.macd > r.signal ? `DIF(${dif})>DEA(${dea})` : `DIF(${dif})<DEA(${dea})`;
+    const histDir = histNum > 0.0001
+        ? "绿柱"
+        : histNum < -0.0001
+            ? "红柱"
+            : "柱近零";
+    const direction = histNum > 0 ? (r.macd > r.signal ? "多头动能增强" : "多头动能减弱") : "";
+    const parts = [difDeaRel, `柱${hist}`, histDir];
+    if (direction)
+        parts.push(direction);
+    // Simple divergence check: compare latest close direction vs MACD direction
+    // (We don't compare previous MACD values here — that's for the LLM to interpret)
+    return parts.join("，");
+}
+function computeRsi(candles, period = 14) {
+    if (candles.length < period + 1)
+        return null;
+    const rsi = new RSI(period);
+    for (const c of candles)
+        rsi.add(c.c);
+    return rsi.isStable ? Number(rsi.getResultOrThrow().toFixed(1)) : null;
+}
+function describeBollinger(candles) {
+    const bb = new BollingerBands(20, 2);
+    for (const c of candles)
+        bb.add(c.c);
+    if (!bb.isStable)
+        return "数据不足无法计算布林带";
+    const last = candles[candles.length - 1];
+    const { upper, middle, lower } = bb.getResultOrThrow();
+    const bandwidth = (upper - lower) / middle;
+    const posInBand = (last.c - lower) / (upper - lower);
+    const posLabel = posInBand > 0.9 ? "触及上轨" : posInBand > 0.65 ? "上轨区域" : posInBand < 0.1 ? "触及下轨" : posInBand < 0.35 ? "下轨区域" : "中轨附近";
+    const bwPct = (bandwidth * 100).toFixed(1);
+    const bwLabel = bandwidth > 0.08 ? "带宽较宽(高波动)" : bandwidth < 0.03 ? "带宽收窄(收缩待变)" : "带宽适中";
+    return `上轨${upper.toFixed(4)} 中轨${middle.toFixed(4)} 下轨${lower.toFixed(4)} — 价格在${posLabel}，${bwLabel}(${bwPct}%)`;
+}
+function describeVolume(candles) {
+    if (candles.length < 6)
+        return "数据不足";
+    const vols = candles.map((c) => c.v);
+    const recent = vols.slice(-3);
+    const baseline = vols.slice(0, -3);
+    if (baseline.length === 0)
+        return "数据不足";
+    const avgBaseline = baseline.reduce((s, v) => s + v, 0) / baseline.length;
+    if (avgBaseline <= 0)
+        return "无成交量数据";
+    const avgRecent = recent.reduce((s, v) => s + v, 0) / recent.length;
+    const ratio = avgRecent / avgBaseline;
+    const label = ratio > 2.0
+        ? "放量"
+        : ratio > 1.2
+            ? "温和放量"
+            : ratio < 0.5
+                ? "极度缩量"
+                : ratio < 0.8
+                    ? "缩量"
+                    : "量平";
+    return `${ratio.toFixed(1)}x均量(${label})`;
+}
+// ---------------------------------------------------------------------------
+// Log-return-based indicators
+// ---------------------------------------------------------------------------
+function logReturnVol(candles, window = 20) {
+    if (candles.length < window + 1)
+        return null;
+    const recent = candles.slice(-(window + 1));
+    const lr = [];
+    for (let i = 1; i < recent.length; i++) {
+        lr.push(Math.log(recent[i].c / recent[i - 1].c));
+    }
+    const mean = lr.reduce((s, r) => s + r, 0) / lr.length;
+    const variance = lr.reduce((s, r) => s + (r - mean) ** 2, 0) / (lr.length - 1 || 1);
+    return Math.sqrt(variance);
+}
+function describeLogReturnVol(candles, label, periodsPerYear) {
+    const perPeriod = logReturnVol(candles);
+    if (perPeriod === null)
+        return "数据不足无法计算波动率";
+    const periodPct = (perPeriod * 100).toFixed(2);
+    const annual = (perPeriod * Math.sqrt(periodsPerYear)) * 100;
+    const annualStr = Number.isFinite(annual) ? annual.toFixed(1) : "?";
+    const level = perPeriod > 0.03 ? "极高波动" : perPeriod > 0.015 ? "高波动" : perPeriod > 0.005 ? "中等波动" : "低波动";
+    return `${label}对数收益率 σ=${periodPct}%，年化≈${annualStr}% — ${level}`;
+}
+function computeZScore(candles, period = 20) {
+    if (candles.length < period)
+        return null;
+    const recent = candles.slice(-period);
+    const closes = recent.map((c) => c.c);
+    const mean = closes.reduce((s, v) => s + v, 0) / closes.length;
+    const variance = closes.reduce((s, v) => s + (v - mean) ** 2, 0) / (closes.length - 1 || 1);
+    const std = Math.sqrt(variance);
+    if (std === 0)
+        return 0;
+    return (closes[closes.length - 1] - mean) / std;
+}
+function describeZScore(candles, label) {
+    const z = computeZScore(candles);
+    if (z === null)
+        return "数据不足无法计算Z-Score";
+    const absZ = Math.abs(z);
+    const extreme = absZ > 2.5 ? "极端" : absZ > 1.5 ? "显著偏离" : absZ > 0.75 ? "略微偏离" : "在均值附近";
+    const dir = z > 0 ? "偏高" : z < 0 ? "偏低" : "等于均值";
+    return `${label} Z-Score(SMA20) ${z.toFixed(2)}σ — 价格${dir}，${extreme}`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function computeIndicatorSummary(raw5m, raw1h, raw1d) {
+    const c5m = parseCandlesWithVolume(raw5m);
+    const c1h = parseCandlesWithVolume(raw1h);
+    const c1d = parseCandlesWithVolume(raw1d);
+    const atr5m = computeAtrFromCandles(c5m);
+    const atr1h = computeAtrFromCandles(c1h);
+    const atr1d = computeAtrFromCandles(c1d);
+    const last5m = c5m.length > 0 ? c5m[c5m.length - 1].c : null;
+    const last1h = c1h.length > 0 ? c1h[c1h.length - 1].c : null;
+    const last1d = c1d.length > 0 ? c1d[c1d.length - 1].c : null;
+    const atrPct = (atr, close) => atr !== null && close !== null && close > 0
+        ? `ATR(${atr.toFixed(4)}) 占价格 ${((atr / close) * 100).toFixed(2)}%`
+        : "数据不足";
+    return {
+        atr_5m: atr5m,
+        atr_1h: atr1h,
+        atr_1d: atr1d,
+        atr_pct_5m: atrPct(atr5m, last5m),
+        atr_pct_1h: atrPct(atr1h, last1h),
+        atr_pct_1d: atrPct(atr1d, last1d),
+        ema_5m: describeEmaAlignment(c5m),
+        ema_1h: describeEmaAlignment(c1h),
+        ema_1d: describeEmaAlignment(c1d),
+        macd_5m: describeMacd(c5m),
+        macd_1h: describeMacd(c1h),
+        macd_1d: describeMacd(c1d),
+        rsi_5m: computeRsi(c5m),
+        rsi_1h: computeRsi(c1h),
+        rsi_1d: computeRsi(c1d),
+        bollinger_5m: describeBollinger(c5m),
+        bollinger_1h: describeBollinger(c1h),
+        bollinger_1d: describeBollinger(c1d),
+        log_return_vol_5m: describeLogReturnVol(c5m, "5m", 12 * 24 * 365),
+        log_return_vol_1h: describeLogReturnVol(c1h, "1h", 24 * 365),
+        log_return_vol_1d: describeLogReturnVol(c1d, "1d", 365),
+        zscore_5m: describeZScore(c5m, "5m"),
+        zscore_1h: describeZScore(c1h, "1h"),
+        zscore_1d: describeZScore(c1d, "1d"),
+        volume_5m: describeVolume(c5m),
+        volume_1h: describeVolume(c1h),
+        volume_1d: describeVolume(c1d),
+    };
+}
+function computeAtrFromCandles(candles, period = 14) {
+    if (candles.length < period + 1)
+        return null;
+    const atr = new ATR(period);
+    for (const c of candles)
+        atr.add({ high: c.h, low: c.l, close: c.c });
+    return atr.isStable ? Number(atr.getResultOrThrow().toFixed(4)) : null;
+}
+/** Build compact h/l/c candles for wave/Chan theory analysis in v2 mode. */
+export function buildCompactKlines(raw, maxBars) {
+    const parsed = parseCandlesWithVolume(raw);
+    const trimmed = parsed.length <= maxBars ? parsed : parsed.slice(-maxBars);
+    return trimmed.map((c) => ({ h: c.h, l: c.l, o: c.o, c: c.c, v: c.v }));
+}
+//# sourceMappingURL=indicatorCompute.js.map

package/dist/advisor/indicatorCompute.js.map

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

package/dist/advisor/positionPlan.d.ts

@@ -0,0 +1,33 @@
+import type { BracketIntentRecord, TradeStateFile } from "../core/state/schema.js";
+export type ActivePositionPlan = {
+    intent_id: string;
+    phase: string;
+    side: "buy" | "sell";
+    entry_limit_px: number;
+    tp_px: number;
+    sl_px: number;
+    /** Entry filled but reconcile has not placed TP/SL on book yet. */
+    protection_pending: boolean;
+    protection_active: boolean;
+    open_age_sec: number | null;
+    /** Mid is between entry and TP on the profitable side (thesis still working). */
+    trend_toward_tp: boolean;
+    tp_sl_hit: boolean;
+    /** Fraction of entry→TP distance covered (0 at entry, 1 at TP). */
+    progress_to_tp: number | null;
+    /** Trading strategy: scalp or ambush. */
+    strategy?: "scalp" | "ambush";
+};
+export declare function isTrendTowardTp(side: "buy" | "sell", mid: number, entryPx: number, tp: number, sl: number): boolean;
+export declare function progressTowardTp(side: "buy" | "sell", mid: number, entryPx: number, tp: number): number | null;
+export declare function findBestBracketPlanForPosition(state: TradeStateFile, coin: string, positionSignedSz: number | undefined): BracketIntentRecord | undefined;
+export declare function buildActivePositionPlan(params: {
+    state: TradeStateFile;
+    coin: string;
+    nowMs: number;
+    mid: number | null;
+    positionSignedSz: number | undefined;
+    positionEntryPx: number | undefined;
+}): ActivePositionPlan | undefined;
+export declare function unrealizedPnlPct(positionSignedSz: number, entryPx: number, mid: number): number;
+//# sourceMappingURL=positionPlan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"positionPlan.d.ts","sourceRoot":"","sources":["../../src/advisor/positionPlan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAInF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iFAAiF;IACjF,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC/B,CAAC;AAYF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,KAAK,GAAG,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAWT;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,KAAK,GAAG,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,mBAAmB,GAAG,SAAS,CA4CjC;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG,kBAAkB,GAAG,SAAS,CA6DjC;AAED,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,MAAM,CAQR"}

package/dist/advisor/positionPlan.js

@@ -0,0 +1,118 @@
+import { hasPriceHitTpOrSl, resolvePositionOpenAgeSec } from "./ambushPolicy.js";
+function entryPxForPlan(bracket, positionEntryPx) {
+    if (positionEntryPx !== undefined && Number.isFinite(positionEntryPx) && positionEntryPx > 0) {
+        return positionEntryPx;
+    }
+    return bracket.entryLimitPx;
+}
+export function isTrendTowardTp(side, mid, entryPx, tp, sl) {
+    if (!Number.isFinite(mid) || !Number.isFinite(entryPx) || !Number.isFinite(tp) || !Number.isFinite(sl)) {
+        return false;
+    }
+    if (hasPriceHitTpOrSl(side, mid, tp, sl)) {
+        return false;
+    }
+    if (side === "buy") {
+        return mid >= entryPx && mid < tp && mid > sl;
+    }
+    return mid <= entryPx && mid > tp && mid < sl;
+}
+export function progressTowardTp(side, mid, entryPx, tp) {
+    const span = side === "buy" ? tp - entryPx : entryPx - tp;
+    if (!Number.isFinite(span) || span <= 0) {
+        return null;
+    }
+    const traveled = side === "buy" ? mid - entryPx : entryPx - mid;
+    return Math.max(0, Math.min(1, traveled / span));
+}
+export function findBestBracketPlanForPosition(state, coin, positionSignedSz) {
+    if (positionSignedSz === undefined || positionSignedSz === 0) {
+        return undefined;
+    }
+    const wantBuy = positionSignedSz > 0;
+    const candidates = [];
+    for (const intent of Object.values(state.intents)) {
+        if (intent.kind !== "bracket" || intent.coin !== coin) {
+            continue;
+        }
+        const sideOk = wantBuy ? intent.entrySide === "buy" : intent.entrySide === "sell";
+        if (!sideOk) {
+            continue;
+        }
+        if (intent.phase === "protection_active" ||
+            intent.phase === "entry_filled" ||
+            intent.phase === "entry_partial") {
+            candidates.push(intent);
+        }
+    }
+    if (candidates.length === 0) {
+        return undefined;
+    }
+    const rank = (p) => {
+        if (p === "protection_active") {
+            return 3;
+        }
+        if (p === "entry_filled") {
+            return 2;
+        }
+        if (p === "entry_partial") {
+            return 1;
+        }
+        return 0;
+    };
+    return candidates.sort((a, b) => {
+        const dr = rank(b.phase) - rank(a.phase);
+        if (dr !== 0) {
+            return dr;
+        }
+        return b.updatedAtMs - a.updatedAtMs;
+    })[0];
+}
+export function buildActivePositionPlan(params) {
+    const bracket = findBestBracketPlanForPosition(params.state, params.coin, params.positionSignedSz);
+    if (!bracket) {
+        return undefined;
+    }
+    const entryPx = entryPxForPlan(bracket, params.positionEntryPx);
+    const protectionActive = bracket.phase === "protection_active";
+    const protectionPending = bracket.phase === "entry_filled" ||
+        (bracket.phase === "entry_partial" && Boolean(params.positionSignedSz));
+    const openAge = resolvePositionOpenAgeSec({
+        state: params.state,
+        coin: params.coin,
+        nowMs: params.nowMs,
+    });
+    let trendTowardTp = false;
+    let tpSlHit = false;
+    let progress = null;
+    if (params.mid !== null && params.mid > 0) {
+        trendTowardTp = isTrendTowardTp(bracket.entrySide, params.mid, entryPx, bracket.tpTriggerPx, bracket.slTriggerPx);
+        tpSlHit = hasPriceHitTpOrSl(bracket.entrySide, params.mid, bracket.tpTriggerPx, bracket.slTriggerPx);
+        progress = progressTowardTp(bracket.entrySide, params.mid, entryPx, bracket.tpTriggerPx);
+    }
+    return {
+        intent_id: bracket.id,
+        phase: bracket.phase,
+        side: bracket.entrySide,
+        entry_limit_px: bracket.entryLimitPx,
+        tp_px: bracket.tpTriggerPx,
+        sl_px: bracket.slTriggerPx,
+        protection_pending: protectionPending && !protectionActive,
+        protection_active: protectionActive,
+        open_age_sec: openAge ?? null,
+        trend_toward_tp: trendTowardTp,
+        tp_sl_hit: tpSlHit,
+        progress_to_tp: progress,
+        strategy: bracket.strategy,
+    };
+}
+export function unrealizedPnlPct(positionSignedSz, entryPx, mid) {
+    if (!Number.isFinite(entryPx) || entryPx <= 0) {
+        return 0;
+    }
+    if (positionSignedSz > 0) {
+        return (mid - entryPx) / entryPx;
+    }
+    return (entryPx - mid) / entryPx;
+}
+//# sourceMappingURL=positionPlan.js.map

package/dist/advisor/positionPlan.js.map

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

package/dist/advisor/promptTemplate.d.ts

@@ -1,5 +1,11 @@
 import type { UserProfile } from "../core/state/schema.js";
+import type { PendingAmbushSummary } from "./ambushPolicy.js";
 import type { AdvisorMarketSnapshot } from "./contextBuilder.js";
-export declare function buildAdvisorSystemPrompt(profile: UserProfile | undefined): string;
-export declare function formatFirstUserPayload(snapshot: AdvisorMarketSnapshot): string;
+import type { ActivePositionPlan } from "./positionPlan.js";
+export type ContextVersion = "raw_kline" | "precomputed_indicators";
+export declare function buildAdvisorSystemPrompt(profile: UserProfile | undefined, contextVersion?: ContextVersion): string;
+export declare function formatFirstUserPayload(snapshot: AdvisorMarketSnapshot, extras?: {
+    pendingAmbushIntents?: PendingAmbushSummary[];
+    activePositionPlan?: ActivePositionPlan | null;
+}): string;
 //# sourceMappingURL=promptTemplate.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"promptTemplate.d.ts","sourceRoot":"","sources":["../../src/advisor/promptTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,wBAAwB,CAAC;AAEpE,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,cAAc,GAAE,cAA4B,GAC3C,MAAM,CAwMR;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,CAAC,EAAE;IACP,oBAAoB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC9C,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAChD,GACA,MAAM,CAiCR"}