@continuumdao/continuum-node-sdk 1.3.24 → 1.3.27

package/dist/core/chart/analysis/analyze-tools.js

@@ -0,0 +1,785 @@
+import { z } from 'zod';
+import { calculateTechnicalIndicator } from '../../ta/calculate.js';
+import { DEFAULT_CHART_RSI_PERIOD } from '../chart-defaults.js';
+import { coerceFiniteNumber } from '../point-normalize.js';
+import { ChartLiveTickSchema } from '../live/schemas.js';
+import { calculateFibonacciRangeFromBars, detectSwingsFromBars, } from '../levels/key-levels.js';
+import { calculateTrendLinesFromBars } from '../levels/trend-lines.js';
+import { buildOhlcvAnalysisMeta, OhlcvAnalysisMetaSchema } from './analysis-meta.js';
+import { prepareOhlcvBarsForAnalysis } from './ohlcv-live-merge.js';
+import { preprocessOhlcvToolInput, missingOhlcvBarsReason } from './ohlcv-input.js';
+import { buildTrendLineMenu, pickTrendLineForTradeSetup, trendLineMenuLabel, } from './trend-line-menu-summary.js';
+import { buildKeyLevelsTradeSetup } from './trade-setups/key-levels-trade-setup.js';
+import { buildKeyLevelFibRetraceTradeSetup, invertedFib618 } from './trade-setups/key-level-fib-retrace-trade-setup.js';
+import { buildKeyLevelAnalysisDataset } from './key-levels-dataset.js';
+import { keyLevelMenuDisplayLabel, pickOuterConcentricFibPair, } from './key-level-menu-summary.js';
+import { buildMomentumTradeSetup } from './trade-setups/momentum-trade-setup.js';
+import { buildTrendStructureTradeSetup } from './trade-setups/trend-structure-trade-setup.js';
+import { ohlcvToolRejectIfLineOnly } from './time-series-analyze-tools.js';
+const barsInputSchema = z
+    .object({
+    toolResult: z.unknown().optional(),
+    rows: z.array(z.unknown()).min(1).optional(),
+    title: z.string().trim().min(1).max(256).optional(),
+    label: z.string().trim().min(1).max(128).optional(),
+    lookback: z.number().int().min(2).max(20).optional(),
+    mergeLive: z.boolean().optional(),
+    liveTick: ChartLiveTickSchema.optional(),
+    allowRowsOnly: z.boolean().optional(),
+})
+    .strict();
+export const AnalyzeTrendStructureInputSchema = z.preprocess(preprocessOhlcvToolInput, barsInputSchema);
+function closesFromBars(bars) {
+    const out = [];
+    for (const bar of bars) {
+        const c = coerceFiniteNumber(bar.close);
+        if (c != null) {
+            out.push(c);
+        }
+    }
+    return out;
+}
+function analysisMeta(bars, title, toolResult, liveMerge, ohlcvFingerprint) {
+    return buildOhlcvAnalysisMeta(bars, { title, toolResult, liveMerge, ohlcvFingerprint });
+}
+function lastClose(bars) {
+    if (!bars.length) {
+        return null;
+    }
+    return coerceFiniteNumber(bars[bars.length - 1].close);
+}
+const trendLineMenuEntrySchema = z
+    .object({
+    index: z.number().int(),
+    trendLineNumber: z.number().int(),
+    kind: z.enum(['support', 'resistance']),
+    score: z.number(),
+    touchCount: z.number(),
+    isPrimary: z.boolean(),
+    barSpan: z
+        .object({
+        fromTimeSec: z.number(),
+        toTimeSec: z.number(),
+        barCount: z.number(),
+        fromBarIndex: z.number(),
+        toBarIndex: z.number(),
+    })
+        .strict(),
+    anchors: z
+        .object({
+        pointA: z.object({ timeSec: z.number(), price: z.number() }).strict(),
+        pointB: z.object({ timeSec: z.number(), price: z.number() }).strict(),
+    })
+        .strict(),
+})
+    .strict();
+const drawableTrendLineSchema = z
+    .object({
+    kind: z.enum(['support', 'resistance']),
+    pointA: z.object({ time: z.number(), price: z.number() }).strict(),
+    pointB: z.object({ time: z.number(), price: z.number() }).strict(),
+    slope: z.number(),
+    touchCount: z.number(),
+    score: z.number(),
+})
+    .strict();
+export const AnalyzeTrendStructureOutputSchema = z
+    .object({
+    analysis: z
+        .object({
+        summary: z.string(),
+        interpretation: z.string(),
+        bias: z.enum(['bullish', 'bearish', 'neutral']),
+        swingHigh: z
+            .object({ price: z.number(), timeSec: z.number() })
+            .strict()
+            .nullable(),
+        swingLow: z
+            .object({ price: z.number(), timeSec: z.number() })
+            .strict()
+            .nullable(),
+        structure: z.enum(['higher_highs', 'lower_lows', 'range', 'mixed']),
+        phases: z.array(z
+            .object({
+            label: z.string(),
+            fromTimeSec: z.number(),
+            toTimeSec: z.number(),
+            direction: z.enum(['up', 'down', 'sideways']),
+        })
+            .strict()),
+        trendLineMenu: z.array(trendLineMenuEntrySchema),
+        drawableTrendLines: z.array(drawableTrendLineSchema),
+        trendStructureTradeSetup: z.object({}).catchall(z.unknown()).nullable(),
+    })
+        .strict(),
+    meta: OhlcvAnalysisMetaSchema,
+})
+    .strict();
+export async function analyzeTrendStructure(input) {
+    const parsed = AnalyzeTrendStructureInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: parsed.error.message };
+    }
+    const lineReject = ohlcvToolRejectIfLineOnly(parsed.data);
+    if (lineReject) {
+        return lineReject;
+    }
+    const prepared = await prepareOhlcvBarsForAnalysis(parsed.data);
+    if (!prepared.ok) {
+        return prepared;
+    }
+    const { bars, liveMerge, fingerprint } = prepared.data;
+    if (bars.length < 5) {
+        return { ok: false, reason: 'Need at least 5 OHLCV bars for trend structure analysis.' };
+    }
+    const lookback = parsed.data.lookback ?? Math.max(2, Math.min(5, Math.floor(bars.length / 10)));
+    const swings = detectSwingsFromBars(bars, lookback);
+    const resistance = swings.filter(s => s.kind === 'resistance').sort((a, b) => b.timeSec - a.timeSec);
+    const support = swings.filter(s => s.kind === 'support').sort((a, b) => b.timeSec - a.timeSec);
+    const swingHigh = resistance[0] ?? null;
+    const swingLow = support[0] ?? null;
+    const recentRes = resistance.slice(0, 3).map(s => s.price);
+    const recentSup = support.slice(0, 3).map(s => s.price);
+    let structure = 'mixed';
+    if (recentRes.length >= 2 &&
+        recentRes[0] > recentRes[1] &&
+        recentSup.length >= 2 &&
+        recentSup[0] > recentSup[1]) {
+        structure = 'higher_highs';
+    }
+    else if (recentRes.length >= 2 &&
+        recentRes[0] < recentRes[1] &&
+        recentSup.length >= 2 &&
+        recentSup[0] < recentSup[1]) {
+        structure = 'lower_lows';
+    }
+    else if (recentRes.length >= 2 && recentSup.length >= 2) {
+        const resRange = Math.max(...recentRes) - Math.min(...recentRes);
+        const supRange = Math.max(...recentSup) - Math.min(...recentSup);
+        const mid = (recentRes[0] + recentSup[0]) / 2;
+        if (mid > 0 && resRange / mid < 0.02 && supRange / mid < 0.02) {
+            structure = 'range';
+        }
+    }
+    const close = lastClose(bars);
+    let bias = 'neutral';
+    if (close != null && swingHigh && swingLow) {
+        const mid = (swingHigh.price + swingLow.price) / 2;
+        if (close > mid * 1.002) {
+            bias = 'bullish';
+        }
+        else if (close < mid * 0.998) {
+            bias = 'bearish';
+        }
+    }
+    const third = Math.floor(bars.length / 3);
+    const phases = [];
+    for (let i = 0; i < 3; i++) {
+        const slice = bars.slice(i * third, i === 2 ? bars.length : (i + 1) * third);
+        if (slice.length < 2) {
+            continue;
+        }
+        const first = coerceFiniteNumber(slice[0].close);
+        const last = coerceFiniteNumber(slice[slice.length - 1].close);
+        const t0 = coerceFiniteNumber(slice[0].time) ?? 0;
+        const t1 = coerceFiniteNumber(slice[slice.length - 1].time) ?? t0;
+        let direction = 'sideways';
+        if (first != null && last != null) {
+            const chg = (last - first) / first;
+            if (chg > 0.005) {
+                direction = 'up';
+            }
+            else if (chg < -0.005) {
+                direction = 'down';
+            }
+        }
+        phases.push({
+            label: i === 0 ? 'early' : i === 1 ? 'mid' : 'recent',
+            fromTimeSec: t0,
+            toTimeSec: t1,
+            direction,
+        });
+    }
+    const drawableTrendLines = calculateTrendLinesFromBars(bars, {});
+    const trendLineMenu = buildTrendLineMenu(drawableTrendLines, bars);
+    const tradeTrendPick = pickTrendLineForTradeSetup(bias, drawableTrendLines);
+    const tradeTrendLine = tradeTrendPick.line;
+    const structureLabel = structure === 'higher_highs'
+        ? 'higher highs / higher lows'
+        : structure === 'lower_lows'
+            ? 'lower highs / lower lows'
+            : structure === 'range'
+                ? 'range-bound'
+                : 'mixed structure';
+    const summary = `${bias} bias · ${structureLabel} · ${trendLineMenu.length} trend line(s)`;
+    const interpretation = (() => {
+        if (trendLineMenu.length === 0) {
+            return 'No diagonal trend lines met the minimum touch threshold — use key levels or classic patterns for drawable structure.';
+        }
+        const top = trendLineMenu[0];
+        const topLine = drawableTrendLines[0];
+        const topLabel = trendLineMenuLabel(topLine, 1);
+        let msg = `${topLabel} ranks highest (score ${top.score}, ${top.touchCount} touch(es)). ` +
+            'Use trendLineMenu #N with apply_trend_line_drawings to draw each line on the chart.';
+        if (tradeTrendPick.trendLineNumber != null && tradeTrendLine) {
+            const tradeLabel = trendLineMenuLabel(tradeTrendLine, tradeTrendPick.trendLineNumber);
+            if (tradeTrendPick.trendLineNumber === 1) {
+                msg += ` Trade setup uses ${tradeLabel} (bias-aligned).`;
+            }
+            else {
+                msg += ` Trade setup uses ${tradeLabel} (highest-scored ${tradeTrendLine.kind} for ${bias} bias), not menu #1.`;
+            }
+        }
+        return msg;
+    })();
+    const trendStructureTradeSetup = buildTrendStructureTradeSetup({
+        bias,
+        structure,
+        lastClose: close ?? 0,
+        swingHigh: swingHigh ? { price: swingHigh.price } : null,
+        swingLow: swingLow ? { price: swingLow.price } : null,
+        primaryTrendLine: tradeTrendLine,
+        trendLineNumber: tradeTrendPick.trendLineNumber,
+        bars,
+    });
+    return {
+        ok: true,
+        data: {
+            analysis: {
+                summary,
+                interpretation,
+                bias,
+                swingHigh: swingHigh ? { price: swingHigh.price, timeSec: swingHigh.timeSec } : null,
+                swingLow: swingLow ? { price: swingLow.price, timeSec: swingLow.timeSec } : null,
+                structure,
+                phases,
+                trendLineMenu,
+                drawableTrendLines,
+                trendStructureTradeSetup,
+            },
+            meta: analysisMeta(bars, parsed.data.title, parsed.data.toolResult, liveMerge, fingerprint),
+        },
+    };
+}
+const keyLevelMenuEntrySchema = z
+    .object({
+    index: z.number().int(),
+    levelNumber: z.number().int(),
+    kind: z.enum(['support', 'resistance']),
+    swingKind: z.enum(['support', 'resistance']),
+    isRoleFlipped: z.boolean(),
+    price: z.number(),
+    strength: z.number(),
+    touchCount: z.number(),
+    distancePct: z.number(),
+    isPrimary: z.boolean(),
+    isNearestSupport: z.boolean(),
+    isNearestResistance: z.boolean(),
+})
+    .strict();
+const keyLevelFibPairSchema = z
+    .object({
+    pairNumber: z.number().int(),
+    pairKind: z.enum(['primary_range', 'concentric']),
+    concentricRank: z.number().int().optional(),
+    lowLevelNumber: z.number().int(),
+    highLevelNumber: z.number().int(),
+    low: z.number(),
+    high: z.number(),
+    closeAboveMid: z.boolean(),
+    chartFibTrend: z.enum(['up', 'down']),
+    retracement618: z.number(),
+    extension1618Up: z.number(),
+    extension1618Down: z.number(),
+    isPrimaryTradePair: z.boolean().optional(),
+})
+    .strict();
+export const AnalyzeKeyLevelsInputSchema = z.preprocess(preprocessOhlcvToolInput, barsInputSchema.extend({
+    maxLevels: z.number().int().min(1).max(12).optional(),
+}));
+export const AnalyzeKeyLevelsOutputSchema = z
+    .object({
+    analysis: z
+        .object({
+        summary: z.string(),
+        interpretation: z.string(),
+        lastClose: z.number(),
+        nearestSupport: z
+            .object({ price: z.number(), distancePct: z.number(), strength: z.number() })
+            .strict()
+            .nullable(),
+        nearestResistance: z
+            .object({ price: z.number(), distancePct: z.number(), strength: z.number() })
+            .strict()
+            .nullable(),
+        levels: z.array(z
+            .object({
+            price: z.number(),
+            kind: z.enum(['support', 'resistance']),
+            strength: z.number(),
+            touchCount: z.number(),
+        })
+            .strict()),
+        levelMenu: z.array(keyLevelMenuEntrySchema),
+        keyLevelsTradeSetup: z.object({}).catchall(z.unknown()).nullable(),
+    })
+        .strict(),
+    meta: OhlcvAnalysisMetaSchema,
+})
+    .strict();
+export const AnalyzeKeyLevelFibonacciInputSchema = z.preprocess(preprocessOhlcvToolInput, barsInputSchema.extend({
+    maxLevels: z.number().int().min(1).max(12).optional(),
+    fibPairNumber: z.number().int().min(1).max(32).optional(),
+}));
+export const AnalyzeKeyLevelFibonacciOutputSchema = z
+    .object({
+    analysis: z
+        .object({
+        summary: z.string(),
+        interpretation: z.string(),
+        lastClose: z.number(),
+        levelMenu: z.array(keyLevelMenuEntrySchema),
+        fibPairs: z.array(keyLevelFibPairSchema),
+        primaryFibPair: keyLevelFibPairSchema.nullable(),
+        keyLevelFibTradeSetup: z.object({}).catchall(z.unknown()).nullable(),
+    })
+        .strict(),
+    meta: OhlcvAnalysisMetaSchema,
+})
+    .strict();
+export async function analyzeKeyLevels(input) {
+    const parsed = AnalyzeKeyLevelsInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: parsed.error.message };
+    }
+    const lineReject = ohlcvToolRejectIfLineOnly(parsed.data);
+    if (lineReject) {
+        return lineReject;
+    }
+    const prepared = await prepareOhlcvBarsForAnalysis(parsed.data);
+    if (!prepared.ok) {
+        return prepared;
+    }
+    const { bars, liveMerge, fingerprint } = prepared.data;
+    if (!bars.length) {
+        return { ok: false, reason: missingOhlcvBarsReason(parsed.data) };
+    }
+    const dataset = buildKeyLevelAnalysisDataset(bars, { maxLevels: parsed.data.maxLevels ?? 8 });
+    if (!dataset.ok) {
+        return dataset;
+    }
+    const { close, levels, levelMenu, nearestSupportRow, nearestResistanceRow } = dataset.data;
+    const meta = analysisMeta(bars, parsed.data.title, parsed.data.toolResult, liveMerge, fingerprint);
+    const keyLevelsTradeSetup = buildKeyLevelsTradeSetup({
+        lastClose: close,
+        nearestSupport: nearestSupportRow
+            ? { price: nearestSupportRow.price, strength: nearestSupportRow.strength }
+            : null,
+        nearestResistance: nearestResistanceRow
+            ? { price: nearestResistanceRow.price, strength: nearestResistanceRow.strength }
+            : null,
+        levels,
+        levelMenu,
+        fibPairs: [],
+        bars,
+    });
+    const summary = `${levels.length} key level(s) · nearest S/R vs last close`;
+    const interpretation = (() => {
+        if (levelMenu.length === 0) {
+            return 'No swing-based key levels met the touch threshold.';
+        }
+        const top = levelMenu[0];
+        const topLabel = keyLevelMenuDisplayLabel(top.kind, top.levelNumber, top.price, top.swingKind);
+        let msg = `${topLabel} ranks highest (strength ${top.strength}, ${top.touchCount} touch(es)). ` +
+            'Nearest-level trade uses closest support below / resistance above last close (not Fib). ' +
+            'Use levelMenu #N with apply_key_level_drawings (level line only). ' +
+            'For outer-range Fib 0.618 retrace, run analyze_key_level_fibonacci.';
+        if (keyLevelsTradeSetup?.levelNumber != null) {
+            const tradeRow = levelMenu.find(m => m.levelNumber === keyLevelsTradeSetup.levelNumber);
+            if (tradeRow) {
+                const tradeLabel = keyLevelMenuDisplayLabel(tradeRow.kind, tradeRow.levelNumber, tradeRow.price, tradeRow.swingKind);
+                msg += ` Trade setup uses ${tradeLabel} (nearest ${tradeRow.kind} for bounce/rejection).`;
+            }
+        }
+        if (keyLevelsTradeSetup?.breakRetestAlternative) {
+            const alt = keyLevelsTradeSetup.breakRetestAlternative;
+            msg += ` Break+retest alternate at Level #${alt.brokenLevelNumber} (${alt.status}) — see trade-defaults to switch.`;
+        }
+        return msg;
+    })();
+    return {
+        ok: true,
+        data: {
+            analysis: {
+                summary,
+                interpretation,
+                lastClose: close,
+                nearestSupport: nearestSupportRow
+                    ? {
+                        price: nearestSupportRow.price,
+                        distancePct: ((close - nearestSupportRow.price) / close) * 100,
+                        strength: nearestSupportRow.strength,
+                    }
+                    : null,
+                nearestResistance: nearestResistanceRow
+                    ? {
+                        price: nearestResistanceRow.price,
+                        distancePct: ((nearestResistanceRow.price - close) / close) * 100,
+                        strength: nearestResistanceRow.strength,
+                    }
+                    : null,
+                levels,
+                levelMenu,
+                keyLevelsTradeSetup,
+            },
+            meta,
+        },
+    };
+}
+export async function analyzeKeyLevelFibonacci(input) {
+    const parsed = AnalyzeKeyLevelFibonacciInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: parsed.error.message };
+    }
+    const lineReject = ohlcvToolRejectIfLineOnly(parsed.data);
+    if (lineReject) {
+        return lineReject;
+    }
+    const prepared = await prepareOhlcvBarsForAnalysis(parsed.data);
+    if (!prepared.ok) {
+        return prepared;
+    }
+    const { bars, liveMerge, fingerprint } = prepared.data;
+    if (!bars.length) {
+        return { ok: false, reason: missingOhlcvBarsReason(parsed.data) };
+    }
+    const dataset = buildKeyLevelAnalysisDataset(bars, { maxLevels: parsed.data.maxLevels ?? 8 });
+    if (!dataset.ok) {
+        return dataset;
+    }
+    const { close, levelMenu, fibPairs } = dataset.data;
+    const primaryFibPair = (parsed.data.fibPairNumber != null
+        ? fibPairs.find(p => p.pairNumber === parsed.data.fibPairNumber)
+        : undefined) ?? pickOuterConcentricFibPair(fibPairs);
+    const meta = analysisMeta(bars, parsed.data.title, parsed.data.toolResult, liveMerge, fingerprint);
+    const keyLevelFibTradeSetup = buildKeyLevelFibRetraceTradeSetup({
+        lastClose: close,
+        levelMenu,
+        fibPairs,
+        bars,
+    });
+    const summary = primaryFibPair
+        ? keyLevelFibTradeSetup?.priceRegime === 'above_range'
+            ? `Fib range #${primaryFibPair.pairNumber} · above high · 1.618 ext @ ${primaryFibPair.extension1618Up.toFixed(2)}`
+            : keyLevelFibTradeSetup?.priceRegime === 'below_range'
+                ? `Fib range #${primaryFibPair.pairNumber} · below low · 1.618 ext @ ${primaryFibPair.extension1618Down.toFixed(2)}`
+                : `Fib range #${primaryFibPair.pairNumber} (levels #${primaryFibPair.lowLevelNumber}–#${primaryFibPair.highLevelNumber}) · 0.618 @ ${primaryFibPair.retracement618.toFixed(2)}`
+        : 'No concentric Fib range pair in window';
+    const interpretation = (() => {
+        if (!primaryFibPair) {
+            return 'Need at least one swing support and one swing resistance to form an outer Fib range.';
+        }
+        let msg = `Outer concentric pair spans ${primaryFibPair.low.toFixed(2)}–${primaryFibPair.high.toFixed(2)} ` +
+            `(Level #${primaryFibPair.lowLevelNumber} swing low × Level #${primaryFibPair.highLevelNumber} swing high). `;
+        if (keyLevelFibTradeSetup?.priceRegime === 'above_range') {
+            msg +=
+                `Last close is above range high — primary long targets Fib 1.618 extension at ${primaryFibPair.extension1618Up.toFixed(2)}. ` +
+                    'Use apply_key_fib_drawings with fibPairNumber. Optional breakRetestAlternative for retest at broken high — see trade-defaults.';
+        }
+        else if (keyLevelFibTradeSetup?.priceRegime === 'below_range') {
+            msg +=
+                `Last close is below range low — primary short targets Fib 1.618 extension at ${primaryFibPair.extension1618Down.toFixed(2)} (reversed range). ` +
+                    'Use apply_key_fib_drawings with fibPairNumber. Optional breakRetestAlternative for retest at broken low — see trade-defaults.';
+        }
+        else {
+            const inverted = keyLevelFibTradeSetup?.fibRangeInverted === true;
+            msg += inverted
+                ? `Below standard 0.618 — inverted range (upper=0 / lower=1); inverted 0.618 at ${invertedFib618(primaryFibPair.low, primaryFibPair.high).toFixed(2)}. Default ${keyLevelFibTradeSetup?.defaultSide ?? 'long'} toward ${keyLevelFibTradeSetup?.targetLabel ?? '0.618'}. `
+                : `Above standard 0.618 — default ${keyLevelFibTradeSetup?.defaultSide ?? 'short'} toward Fib 0.618 at ${primaryFibPair.retracement618.toFixed(2)} (long alternate toward upper). `;
+            msg +=
+                'Use apply_key_fib_drawings with fibPairNumber to draw the Fib range (not level-only apply). Toggle long/short in the trade build form.';
+        }
+        if (keyLevelFibTradeSetup?.status === 'clear') {
+            msg += ` Trade setup: ${keyLevelFibTradeSetup.side} — ${keyLevelFibTradeSetup.entryLabel} toward ${keyLevelFibTradeSetup.targetLabel ?? 'target'}.`;
+        }
+        else if (keyLevelFibTradeSetup?.unclearReason) {
+            msg += ` ${keyLevelFibTradeSetup.unclearReason}`;
+        }
+        if (keyLevelFibTradeSetup?.breakRetestAlternative) {
+            const alt = keyLevelFibTradeSetup.breakRetestAlternative;
+            msg += ` Break+retest alternate at Level #${alt.brokenLevelNumber} (${alt.status}) — see trade-defaults to switch.`;
+        }
+        return msg;
+    })();
+    return {
+        ok: true,
+        data: {
+            analysis: {
+                summary,
+                interpretation,
+                lastClose: close,
+                levelMenu,
+                fibPairs,
+                primaryFibPair: primaryFibPair ?? null,
+                keyLevelFibTradeSetup,
+            },
+            meta,
+        },
+    };
+}
+export const AnalyzeMomentumInputSchema = z.preprocess(preprocessOhlcvToolInput, barsInputSchema.extend({
+    rsiPeriod: z.number().int().min(2).max(100).optional(),
+}));
+export const AnalyzeMomentumOutputSchema = z
+    .object({
+    analysis: z
+        .object({
+        rsi: z
+            .object({
+            period: z.number(),
+            value: z.number().nullable(),
+            zone: z.enum(['overbought', 'oversold', 'neutral']),
+        })
+            .strict(),
+        macd: z
+            .object({
+            macd: z.number().nullable(),
+            signal: z.number().nullable(),
+            histogram: z.number().nullable(),
+            crossover: z.enum(['bullish', 'bearish', 'none']),
+        })
+            .strict(),
+        momentumTradeSetup: z.object({}).catchall(z.unknown()).nullable(),
+    })
+        .strict(),
+    meta: OhlcvAnalysisMetaSchema,
+})
+    .strict();
+function lastIndicatorValue(result, warmupCount) {
+    const idx = result.length - 1;
+    if (idx < warmupCount || idx < 0) {
+        return null;
+    }
+    const v = result[idx];
+    return v != null && Number.isFinite(v) ? v : null;
+}
+export async function analyzeMomentum(input) {
+    const parsed = AnalyzeMomentumInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: parsed.error.message };
+    }
+    const lineReject = ohlcvToolRejectIfLineOnly(parsed.data);
+    if (lineReject) {
+        return lineReject;
+    }
+    const prepared = await prepareOhlcvBarsForAnalysis(parsed.data);
+    if (!prepared.ok) {
+        return prepared;
+    }
+    const { bars, liveMerge, fingerprint } = prepared.data;
+    const closes = closesFromBars(bars);
+    if (closes.length < DEFAULT_CHART_RSI_PERIOD + 2) {
+        return { ok: false, reason: 'Need more bars for momentum analysis.' };
+    }
+    const rsiPeriod = parsed.data.rsiPeriod ?? DEFAULT_CHART_RSI_PERIOD;
+    const rsiResult = calculateTechnicalIndicator({
+        indicator: 'rsi',
+        params: { period: rsiPeriod },
+        input: { values: closes },
+        options: { maxPoints: closes.length },
+    });
+    if (!rsiResult.ok) {
+        return rsiResult;
+    }
+    const rsiValue = Array.isArray(rsiResult.data.result) &&
+        rsiResult.data.result.length > 0 &&
+        typeof rsiResult.data.result[0] === 'number'
+        ? lastIndicatorValue(rsiResult.data.result, rsiResult.data.warmupCount)
+        : null;
+    let rsiZone = 'neutral';
+    if (rsiValue != null) {
+        if (rsiValue >= 70) {
+            rsiZone = 'overbought';
+        }
+        else if (rsiValue <= 30) {
+            rsiZone = 'oversold';
+        }
+    }
+    const macdResult = calculateTechnicalIndicator({
+        indicator: 'macd',
+        params: { fastPeriod: 12, slowPeriod: 26, signalPeriod: 9 },
+        input: { values: closes },
+        options: { maxPoints: closes.length },
+    });
+    if (!macdResult.ok) {
+        return macdResult;
+    }
+    const macdRows = macdResult.data.result;
+    const lastRow = Array.isArray(macdRows) && macdRows.length > 0 && typeof macdRows[0] === 'object'
+        ? macdRows[macdRows.length - 1]
+        : undefined;
+    const macd = lastRow ? (coerceFiniteNumber(lastRow.MACD ?? lastRow.macd) ?? null) : null;
+    const signal = lastRow ? (coerceFiniteNumber(lastRow.signal ?? lastRow.Signal) ?? null) : null;
+    const histogram = lastRow
+        ? (coerceFiniteNumber(lastRow.histogram ?? lastRow.Histogram) ?? null)
+        : null;
+    let crossover = 'none';
+    if (Array.isArray(macdRows) &&
+        macdRows.length >= 2 &&
+        typeof macdRows[0] === 'object') {
+        const prev = macdRows[macdRows.length - 2];
+        const prevMacd = coerceFiniteNumber(prev.MACD ?? prev.macd);
+        const prevSignal = coerceFiniteNumber(prev.signal ?? prev.Signal);
+        if (macd != null && signal != null && prevMacd != null && prevSignal != null) {
+            if (prevMacd <= prevSignal && macd > signal) {
+                crossover = 'bullish';
+            }
+            else if (prevMacd >= prevSignal && macd < signal) {
+                crossover = 'bearish';
+            }
+        }
+    }
+    const close = lastClose(bars) ?? 0;
+    const momentumTradeSetup = buildMomentumTradeSetup({
+        lastClose: close,
+        rsi: { period: rsiPeriod, value: rsiValue, zone: rsiZone },
+        macd: { crossover },
+    });
+    return {
+        ok: true,
+        data: {
+            analysis: {
+                rsi: { period: rsiPeriod, value: rsiValue, zone: rsiZone },
+                macd: { macd, signal, histogram, crossover },
+                momentumTradeSetup,
+            },
+            meta: analysisMeta(bars, parsed.data.title, parsed.data.toolResult, liveMerge, fingerprint),
+        },
+    };
+}
+export const AnalyzeRangeVolatilityInputSchema = z.preprocess(preprocessOhlcvToolInput, barsInputSchema.extend({
+    atrPeriod: z.number().int().min(2).max(50).optional(),
+}));
+export const AnalyzeRangeVolatilityOutputSchema = z
+    .object({
+    analysis: z
+        .object({
+        rangeHigh: z.number(),
+        rangeLow: z.number(),
+        rangePct: z.number(),
+        atr: z.number().nullable(),
+        atrPct: z.number().nullable(),
+        recentRangePct: z.number(),
+        priorRangePct: z.number(),
+        compression: z.enum(['compressing', 'expanding', 'stable']),
+        fibRange: z
+            .object({ high: z.number(), low: z.number(), trend: z.enum(['up', 'down']) })
+            .strict()
+            .nullable(),
+    })
+        .strict(),
+    meta: OhlcvAnalysisMetaSchema,
+})
+    .strict();
+function trueRange(bar, prevClose) {
+    const high = coerceFiniteNumber(bar.high);
+    const low = coerceFiniteNumber(bar.low);
+    if (high == null || low == null) {
+        return null;
+    }
+    if (prevClose == null) {
+        return high - low;
+    }
+    return Math.max(high - low, Math.abs(high - prevClose), Math.abs(low - prevClose));
+}
+export async function analyzeRangeVolatility(input) {
+    const parsed = AnalyzeRangeVolatilityInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: parsed.error.message };
+    }
+    const lineReject = ohlcvToolRejectIfLineOnly(parsed.data);
+    if (lineReject) {
+        return lineReject;
+    }
+    const prepared = await prepareOhlcvBarsForAnalysis(parsed.data);
+    if (!prepared.ok) {
+        return prepared;
+    }
+    const { bars, liveMerge, fingerprint } = prepared.data;
+    if (bars.length < 5) {
+        return { ok: false, reason: 'Need at least 5 OHLCV bars for range/volatility analysis.' };
+    }
+    let rangeHigh = Number.NEGATIVE_INFINITY;
+    let rangeLow = Number.POSITIVE_INFINITY;
+    for (const bar of bars) {
+        const h = coerceFiniteNumber(bar.high);
+        const l = coerceFiniteNumber(bar.low);
+        if (h != null) {
+            rangeHigh = Math.max(rangeHigh, h);
+        }
+        if (l != null) {
+            rangeLow = Math.min(rangeLow, l);
+        }
+    }
+    const close = lastClose(bars) ?? (rangeHigh + rangeLow) / 2;
+    const rangePct = close > 0 ? ((rangeHigh - rangeLow) / close) * 100 : 0;
+    const atrPeriod = parsed.data.atrPeriod ?? 14;
+    const trs = [];
+    let prevClose = null;
+    for (const bar of bars) {
+        const tr = trueRange(bar, prevClose);
+        if (tr != null) {
+            trs.push(tr);
+        }
+        prevClose = coerceFiniteNumber(bar.close) ?? prevClose;
+    }
+    const atrSlice = trs.slice(-atrPeriod);
+    const atr = atrSlice.length ? atrSlice.reduce((a, b) => a + b, 0) / atrSlice.length : null;
+    const atrPct = atr != null && close > 0 ? (atr / close) * 100 : null;
+    const half = Math.floor(bars.length / 2);
+    const priorSlice = bars.slice(0, half);
+    const recentSlice = bars.slice(half);
+    const sliceRangePct = (slice) => {
+        let hi = Number.NEGATIVE_INFINITY;
+        let lo = Number.POSITIVE_INFINITY;
+        for (const bar of slice) {
+            const h = coerceFiniteNumber(bar.high);
+            const l = coerceFiniteNumber(bar.low);
+            if (h != null) {
+                hi = Math.max(hi, h);
+            }
+            if (l != null) {
+                lo = Math.min(lo, l);
+            }
+        }
+        return close > 0 ? ((hi - lo) / close) * 100 : 0;
+    };
+    const recentRangePct = sliceRangePct(recentSlice);
+    const priorRangePct = sliceRangePct(priorSlice);
+    let compression = 'stable';
+    if (recentRangePct < priorRangePct * 0.85) {
+        compression = 'compressing';
+    }
+    else if (recentRangePct > priorRangePct * 1.15) {
+        compression = 'expanding';
+    }
+    const fibRange = calculateFibonacciRangeFromBars(bars);
+    return {
+        ok: true,
+        data: {
+            analysis: {
+                rangeHigh,
+                rangeLow,
+                rangePct,
+                atr,
+                atrPct,
+                recentRangePct,
+                priorRangePct,
+                compression,
+                fibRange,
+            },
+            meta: analysisMeta(bars, parsed.data.title, parsed.data.toolResult, liveMerge, fingerprint),
+        },
+    };
+}
+//# sourceMappingURL=analyze-tools.js.map