@continuumdao/continuum-node-sdk 1.3.27 → 1.3.29

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

@@ -0,0 +1,289 @@
+import { z } from 'zod';
+import { calculateTechnicalIndicator } from '../../ta/calculate.js';
+import { coerceFiniteNumber } from '../point-normalize.js';
+import { extractOhlcvBarsFromUnknown } from '../fetch-result.js';
+import { ChartLiveTickSchema } from '../live/schemas.js';
+import { validateTimeSeriesPointsFromToolResult } from '../chart-data-validation.js';
+import { buildOhlcvAnalysisMeta, OhlcvAnalysisMetaSchema } from './analysis-meta.js';
+import { prepareOhlcvBarsForAnalysis } from './ohlcv-live-merge.js';
+import { preprocessOhlcvToolInput, missingOhlcvBarsReason } from './ohlcv-input.js';
+import { buildBollingerHighlight } from './bollinger-highlight.js';
+import { buildBollingerTradeSetup, DEFAULT_BOLLINGER_ENTRY_PROXIMITY_PCT, } from './trade-setups/bollinger-trade-setup.js';
+import { extractTimeSeriesFromUnknown } from './time-series-input.js';
+const DEFAULT_BOLLINGER_PERIOD = 20;
+const DEFAULT_BOLLINGER_STD_DEV = 2;
+const bollingerInputSchema = 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(),
+    ohlcvDigest: z.string().trim().min(1).max(512).optional(),
+    mergeLive: z.boolean().optional(),
+    liveTick: ChartLiveTickSchema.optional(),
+    allowRowsOnly: z.boolean().optional(),
+    period: z.number().int().min(2).max(500).optional(),
+    stdDev: z.number().positive().max(10).optional(),
+    entryProximityPct: z.number().min(0).max(50).optional(),
+})
+    .strict();
+export const AnalyzeBollingerBandsInputSchema = z.preprocess(preprocessOhlcvToolInput, bollingerInputSchema);
+export const AnalyzeBollingerBandsOutputSchema = z
+    .object({
+    analysis: z
+        .object({
+        summary: z.string(),
+        interpretation: z.string(),
+        upper: z.number(),
+        middle: z.number(),
+        lower: z.number(),
+        bandWidth: z.number(),
+        percentB: z.number(),
+        period: z.number().int(),
+        stdDev: z.number(),
+        dataKind: z.enum(['ohlcv', 'time_series']),
+        bollingerTradeSetup: z.object({}).catchall(z.unknown()).nullable(),
+        bollingerHighlight: z.object({}).catchall(z.unknown()),
+    })
+        .strict(),
+    meta: z.union([OhlcvAnalysisMetaSchema, z.record(z.string(), z.unknown())]),
+})
+    .strict();
+function pointsFromToolInput(input) {
+    if (input.rows?.length) {
+        return extractTimeSeriesFromUnknown(input.rows) ?? [];
+    }
+    if (input.toolResult != null) {
+        return extractTimeSeriesFromUnknown(input.toolResult) ?? [];
+    }
+    return [];
+}
+function timeSeriesPointRows(points) {
+    return points.map(point => ({ time: point.timeSec, value: point.value }));
+}
+function lastBandValues(closes, period, stdDev) {
+    const result = calculateTechnicalIndicator({
+        indicator: 'bollingerbands',
+        params: { period, stdDev },
+        input: { values: closes },
+        options: { maxPoints: closes.length },
+    });
+    if (!result.ok) {
+        return result;
+    }
+    const rows = result.data.result;
+    if (!Array.isArray(rows) || rows.length === 0) {
+        return { ok: false, reason: 'Bollinger bands returned no data.' };
+    }
+    const lastRow = rows[rows.length - 1];
+    const upper = coerceFiniteNumber(lastRow.upper ?? lastRow.Upper);
+    const middle = coerceFiniteNumber(lastRow.middle ?? lastRow.Middle);
+    const lower = coerceFiniteNumber(lastRow.lower ?? lastRow.Lower);
+    const lastClose = closes.at(-1);
+    if (upper == null ||
+        middle == null ||
+        lower == null ||
+        lastClose == null ||
+        upper <= lower) {
+        return { ok: false, reason: 'Bollinger bands have no valid last values after warmup.' };
+    }
+    const bandWidth = upper - lower;
+    const percentB = bandWidth > 0 ? (lastClose - lower) / bandWidth : 0.5;
+    return { ok: true, data: { upper, middle, lower, percentB, bandWidth } };
+}
+function seriesMeta(points, title) {
+    return {
+        pointCount: points.length,
+        ...(title ? { title } : {}),
+    };
+}
+function lastCloseFromBars(bars) {
+    for (let i = bars.length - 1; i >= 0; i--) {
+        const close = coerceFiniteNumber(bars[i].close);
+        if (close != null) {
+            return close;
+        }
+    }
+    return null;
+}
+export async function analyzeBollingerBands(input) {
+    const parsed = AnalyzeBollingerBandsInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: parsed.error.message };
+    }
+    const period = parsed.data.period ?? DEFAULT_BOLLINGER_PERIOD;
+    const stdDev = parsed.data.stdDev ?? DEFAULT_BOLLINGER_STD_DEV;
+    const entryProximityPct = parsed.data.entryProximityPct ?? DEFAULT_BOLLINGER_ENTRY_PROXIMITY_PCT;
+    const minPoints = period + 1;
+    const ohlcvBars = parsed.data.rows?.length
+        ? extractOhlcvBarsFromUnknown(parsed.data.rows)
+        : parsed.data.toolResult != null
+            ? extractOhlcvBarsFromUnknown(parsed.data.toolResult)
+            : null;
+    if (ohlcvBars?.length) {
+        const prepared = await prepareOhlcvBarsForAnalysis(parsed.data);
+        if (!prepared.ok) {
+            return prepared;
+        }
+        const { bars, liveMerge, fingerprint } = prepared.data;
+        if (bars.length < minPoints) {
+            return {
+                ok: false,
+                reason: `Need at least ${minPoints} OHLCV bars for Bollinger analysis (period ${period}).`,
+            };
+        }
+        const closes = [];
+        for (const bar of bars) {
+            const close = coerceFiniteNumber(bar.close);
+            if (close != null) {
+                closes.push(close);
+            }
+        }
+        if (closes.length < minPoints) {
+            return { ok: false, reason: 'Insufficient valid close prices for Bollinger analysis.' };
+        }
+        const bands = lastBandValues(closes, period, stdDev);
+        if (!bands.ok) {
+            return bands;
+        }
+        const lastClose = lastCloseFromBars(bars) ?? closes.at(-1);
+        const { upper, middle, lower, percentB, bandWidth } = bands.data;
+        const bollingerTradeSetup = buildBollingerTradeSetup({
+            lastClose,
+            upper,
+            middle,
+            lower,
+            period,
+            stdDev,
+            entryProximityPct,
+        });
+        const bollingerHighlight = buildBollingerHighlight({
+            upper,
+            middle,
+            lower,
+            bandWidth,
+            percentB,
+            period,
+            stdDev,
+            setup: bollingerTradeSetup,
+        });
+        const summary = bollingerHighlight.summary;
+        const interpretation = (() => {
+            let msg = `Bollinger bands (${period}, ${stdDev}σ): upper ${upper.toFixed(2)}, middle ${middle.toFixed(2)}, lower ${lower.toFixed(2)}. Last close ${lastClose.toFixed(2)} (%B ${(percentB * 100).toFixed(1)}). `;
+            if (bollingerTradeSetup?.invalidated) {
+                msg += bollingerTradeSetup.unclearReason ?? 'Setup invalidated by band breach.';
+            }
+            else if (bollingerTradeSetup?.status === 'clear' && bollingerTradeSetup.side !== 'neutral') {
+                msg += `Trade setup: ${bollingerTradeSetup.side} fade at ${bollingerTradeSetup.entryLabel} toward ${bollingerTradeSetup.targetLabel}.`;
+            }
+            else {
+                msg += bollingerTradeSetup?.conditionalNote ?? 'No clear band fade — wait for proximity to outer band.';
+            }
+            return msg;
+        })();
+        return {
+            ok: true,
+            data: {
+                analysis: {
+                    summary,
+                    interpretation,
+                    upper,
+                    middle,
+                    lower,
+                    bandWidth,
+                    percentB,
+                    period,
+                    stdDev,
+                    dataKind: 'ohlcv',
+                    bollingerTradeSetup,
+                    bollingerHighlight,
+                },
+                meta: buildOhlcvAnalysisMeta(bars, {
+                    title: parsed.data.title,
+                    toolResult: parsed.data.toolResult,
+                    liveMerge,
+                    ohlcvFingerprint: fingerprint,
+                }),
+            },
+        };
+    }
+    const points = pointsFromToolInput(parsed.data);
+    if (points.length === 0) {
+        return { ok: false, reason: missingOhlcvBarsReason(parsed.data) };
+    }
+    const sorted = [...points].sort((a, b) => a.timeSec - b.timeSec);
+    const pointRows = timeSeriesPointRows(sorted);
+    if (parsed.data.toolResult != null) {
+        const check = validateTimeSeriesPointsFromToolResult(pointRows, parsed.data.toolResult, parsed.data.title);
+        if (!check.ok) {
+            return { ok: false, reason: check.reason };
+        }
+    }
+    if (sorted.length < minPoints) {
+        return {
+            ok: false,
+            reason: `Need at least ${minPoints} time-series points for Bollinger analysis (period ${period}).`,
+        };
+    }
+    const closes = sorted.map(p => p.value);
+    const bands = lastBandValues(closes, period, stdDev);
+    if (!bands.ok) {
+        return bands;
+    }
+    const lastClose = closes.at(-1);
+    const { upper, middle, lower, percentB, bandWidth } = bands.data;
+    const bollingerTradeSetup = buildBollingerTradeSetup({
+        lastClose,
+        upper,
+        middle,
+        lower,
+        period,
+        stdDev,
+        entryProximityPct,
+    });
+    const bollingerHighlight = buildBollingerHighlight({
+        upper,
+        middle,
+        lower,
+        bandWidth,
+        percentB,
+        period,
+        stdDev,
+        setup: bollingerTradeSetup,
+    });
+    const summary = bollingerHighlight.summary;
+    const interpretation = (() => {
+        let msg = `Bollinger bands on time series (${period}, ${stdDev}σ): upper ${upper.toFixed(2)}, middle ${middle.toFixed(2)}, lower ${lower.toFixed(2)}. Last value ${lastClose.toFixed(2)} (%B ${(percentB * 100).toFixed(1)}). `;
+        if (bollingerTradeSetup?.invalidated) {
+            msg += bollingerTradeSetup.unclearReason ?? 'Setup invalidated by band breach.';
+        }
+        else if (bollingerTradeSetup?.status === 'clear' && bollingerTradeSetup.side !== 'neutral') {
+            msg += `Trade setup: ${bollingerTradeSetup.side} fade at ${bollingerTradeSetup.entryLabel} toward ${bollingerTradeSetup.targetLabel}.`;
+        }
+        else {
+            msg += bollingerTradeSetup?.conditionalNote ?? 'No clear band fade — wait for proximity to outer band.';
+        }
+        return msg;
+    })();
+    return {
+        ok: true,
+        data: {
+            analysis: {
+                summary,
+                interpretation,
+                upper,
+                middle,
+                lower,
+                bandWidth,
+                percentB,
+                period,
+                stdDev,
+                dataKind: 'time_series',
+                bollingerTradeSetup,
+                bollingerHighlight,
+            },
+            meta: seriesMeta(sorted, parsed.data.title),
+        },
+    };
+}
+//# sourceMappingURL=bollinger-analyze-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bollinger-analyze-tools.js","sourceRoot":"","sources":["../../../../src/core/chart/analysis/bollinger-analyze-tools.ts"],"names":[],"mappings":"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"}

package/dist/core/chart/analysis/bollinger-highlight.d.ts

@@ -0,0 +1,29 @@
+import type { BollingerTradeSetup } from './trade-setups/bollinger-trade-setup.js';
+export type BollingerHighlight = {
+    summary: string;
+    upper: number;
+    middle: number;
+    lower: number;
+    bandWidth: number;
+    percentB: number;
+    period: number;
+    stdDev: number;
+    side: 'long' | 'short' | 'neutral';
+    status: 'clear' | 'unclear';
+    invalidated: boolean;
+    confidence: number;
+    conditionalNote: string;
+    chartDrawingHint?: string;
+    unclearReason?: string;
+};
+export declare function buildBollingerHighlight(input: {
+    upper: number;
+    middle: number;
+    lower: number;
+    bandWidth: number;
+    percentB: number;
+    period: number;
+    stdDev: number;
+    setup: BollingerTradeSetup | null;
+}): BollingerHighlight;
+//# sourceMappingURL=bollinger-highlight.d.ts.map

package/dist/core/chart/analysis/bollinger-highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bollinger-highlight.d.ts","sourceRoot":"","sources":["../../../../src/core/chart/analysis/bollinger-highlight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,yCAAyC,CAAC;AAEjF,MAAM,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAYF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAClC,GAAG,kBAAkB,CA+BrB"}

package/dist/core/chart/analysis/bollinger-highlight.js

@@ -0,0 +1,39 @@
+function sideLabel(side) {
+    if (side === 'long') {
+        return 'Long';
+    }
+    if (side === 'short') {
+        return 'Short';
+    }
+    return 'Neutral';
+}
+export function buildBollingerHighlight(input) {
+    const setup = input.setup;
+    const side = setup?.side ?? 'neutral';
+    const status = setup?.status ?? 'unclear';
+    const invalidated = setup?.invalidated ?? false;
+    const confidence = setup?.confidence ?? 0.4;
+    const conditionalNote = setup?.conditionalNote ??
+        'Bollinger bands — wait for price to reach an outer band for a fade entry.';
+    const statusPart = invalidated ? 'Invalid' : status === 'clear' ? 'Clear' : 'Unclear';
+    const summary = `BB(${input.period}, ${input.stdDev}) · ${input.lower.toFixed(2)}–${input.upper.toFixed(2)} · %B ${(input.percentB * 100).toFixed(1)}. ${sideLabel(side)} — ${statusPart}. ${conditionalNote}`;
+    const chartDrawingHint = 'When a chart is already prepared, merge `{ type: "bollinger", sourceSeriesId, period, stdDev }` into prepareReplay.overlays and call prepare_chart_from_rows with the same OHLCV session.';
+    return {
+        summary,
+        upper: input.upper,
+        middle: input.middle,
+        lower: input.lower,
+        bandWidth: input.bandWidth,
+        percentB: input.percentB,
+        period: input.period,
+        stdDev: input.stdDev,
+        side,
+        status,
+        invalidated,
+        confidence,
+        conditionalNote,
+        chartDrawingHint,
+        ...(setup?.unclearReason ? { unclearReason: setup.unclearReason } : {}),
+    };
+}
+//# sourceMappingURL=bollinger-highlight.js.map

package/dist/core/chart/analysis/bollinger-highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bollinger-highlight.js","sourceRoot":"","sources":["../../../../src/core/chart/analysis/bollinger-highlight.ts"],"names":[],"mappings":"AAoBA,SAAS,SAAS,CAAC,IAAgC;IAClD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC;IACf,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KASvC;IACA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,SAAS,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,SAAS,CAAC;IAC1C,MAAM,WAAW,GAAG,KAAK,EAAE,WAAW,IAAI,KAAK,CAAC;IAChD,MAAM,UAAU,GAAG,KAAK,EAAE,UAAU,IAAI,GAAG,CAAC;IAC5C,MAAM,eAAe,GACpB,KAAK,EAAE,eAAe;QACtB,2EAA2E,CAAC;IAC7E,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,MAAM,UAAU,KAAK,eAAe,EAAE,CAAC;IAC/M,MAAM,gBAAgB,GACrB,2LAA2L,CAAC;IAE7L,OAAO;QACN,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI;QACJ,MAAM;QACN,WAAW;QACX,UAAU;QACV,eAAe;QACf,gBAAgB;QAChB,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAC,aAAa,EAAE,KAAK,CAAC,aAAa,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;AACH,CAAC"}

package/dist/core/chart/analysis/candlestick-highlight.d.ts

@@ -0,0 +1,55 @@
+export type CandlestickPreviewBar = {
+    index: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    isFocus: boolean;
+};
+export type CandlestickPatternFound = {
+    id: string;
+    name: string;
+    direction: 'bullish' | 'bearish' | 'neutral';
+    confidence: number;
+};
+export type CandlestickHighlight = {
+    summary: string;
+    recommendation: 'buy' | 'sell' | 'hold';
+    recommendationConfidence: number;
+    primaryPattern: {
+        id: string;
+        name: string;
+        description: string;
+        direction?: 'bullish' | 'bearish' | 'neutral';
+    } | null;
+    patternsFound: CandlestickPatternFound[];
+    focusBarIndex: number;
+    previewBars: CandlestickPreviewBar[];
+    previewBarCount: number;
+};
+type OhlcBar = {
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+};
+export declare function buildCandlestickHighlight(input: {
+    bars: OhlcBar[];
+    focusBarIndex: number;
+    primaryPattern: {
+        id: string;
+        name: string;
+        description: string;
+    } | null;
+    patterns: Array<{
+        id: string;
+        name: string;
+        direction: 'bullish' | 'bearish' | 'neutral';
+        confidence: number;
+    }>;
+    recommendation: 'buy' | 'sell' | 'hold';
+    recommendationConfidence: number;
+    previewCount?: number;
+}): CandlestickHighlight;
+export {};
+//# sourceMappingURL=candlestick-highlight.d.ts.map

package/dist/core/chart/analysis/candlestick-highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candlestick-highlight.d.ts","sourceRoot":"","sources":["../../../../src/core/chart/analysis/candlestick-highlight.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,wBAAwB,EAAE,MAAM,CAAC;IACjC,cAAc,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;KAC9C,GAAG,IAAI,CAAC;IACT,aAAa,EAAE,uBAAuB,EAAE,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC;AAIF,KAAK,OAAO,GAAG;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AA4BF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAChD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,QAAQ,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAC7C,UAAU,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,wBAAwB,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,oBAAoB,CAiDvB"}

package/dist/core/chart/analysis/candlestick-highlight.js

@@ -0,0 +1,71 @@
+const PREVIEW_BAR_COUNT = 5;
+function recommendationLabel(recommendation) {
+    if (recommendation === 'buy') {
+        return 'bullish';
+    }
+    if (recommendation === 'sell') {
+        return 'bearish';
+    }
+    return 'neutral';
+}
+function buildHighlightSummary(input) {
+    if (!input.primaryPattern) {
+        return 'No candlestick pattern detected on the focus bar — neutral / indecision.';
+    }
+    const bias = recommendationLabel(input.recommendation);
+    const extra = input.patternsFound.length > 1
+        ? ` (${input.patternsFound.length} patterns on focus bar)`
+        : '';
+    return `${input.primaryPattern.name} — ${bias} signal${extra}.`;
+}
+export function buildCandlestickHighlight(input) {
+    const previewCount = Math.max(1, Math.min(input.previewCount ?? PREVIEW_BAR_COUNT, 8));
+    const startIndex = Math.max(0, input.focusBarIndex - previewCount + 1);
+    const previewBars = [];
+    for (let i = startIndex; i <= input.focusBarIndex; i++) {
+        const bar = input.bars[i];
+        if (!bar) {
+            continue;
+        }
+        previewBars.push({
+            index: i,
+            open: bar.open,
+            high: bar.high,
+            low: bar.low,
+            close: bar.close,
+            isFocus: i === input.focusBarIndex,
+        });
+    }
+    const patternsFound = input.patterns.map(hit => ({
+        id: hit.id,
+        name: hit.name,
+        direction: hit.direction,
+        confidence: hit.confidence,
+    }));
+    const primaryHit = input.primaryPattern
+        ? input.patterns.find(p => p.id === input.primaryPattern.id)
+        : undefined;
+    const primaryPattern = input.primaryPattern
+        ? {
+            id: input.primaryPattern.id,
+            name: input.primaryPattern.name,
+            description: input.primaryPattern.description,
+            ...(primaryHit ? { direction: primaryHit.direction } : {}),
+        }
+        : null;
+    return {
+        summary: buildHighlightSummary({
+            primaryPattern,
+            recommendation: input.recommendation,
+            patternsFound,
+        }),
+        recommendation: input.recommendation,
+        recommendationConfidence: input.recommendationConfidence,
+        primaryPattern,
+        patternsFound,
+        focusBarIndex: input.focusBarIndex,
+        previewBars,
+        previewBarCount: previewBars.length,
+    };
+}
+//# sourceMappingURL=candlestick-highlight.js.map

package/dist/core/chart/analysis/candlestick-highlight.js.map

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

package/dist/core/chart/analysis/candlestick-patterns-tools.d.ts

@@ -58,6 +58,45 @@ export declare const AnalyzeCandlestickPatternsOutputSchema: z.ZodObject<{
         recommendationConfidence: z.ZodNumber;
         rationale: z.ZodString;
         candlestickTradeSetup: z.ZodNullable<z.ZodObject<{}, z.core.$catchall<z.ZodUnknown>>>;
+        candlestickHighlight: z.ZodObject<{
+            summary: z.ZodString;
+            recommendation: z.ZodEnum<{
+                buy: "buy";
+                sell: "sell";
+                hold: "hold";
+            }>;
+            recommendationConfidence: z.ZodNumber;
+            primaryPattern: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodString;
+                direction: z.ZodOptional<z.ZodEnum<{
+                    neutral: "neutral";
+                    bullish: "bullish";
+                    bearish: "bearish";
+                }>>;
+            }, z.core.$strict>>;
+            patternsFound: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                direction: z.ZodEnum<{
+                    neutral: "neutral";
+                    bullish: "bullish";
+                    bearish: "bearish";
+                }>;
+                confidence: z.ZodNumber;
+            }, z.core.$strict>>;
+            focusBarIndex: z.ZodNumber;
+            previewBars: z.ZodArray<z.ZodObject<{
+                index: z.ZodNumber;
+                open: z.ZodNumber;
+                high: z.ZodNumber;
+                low: z.ZodNumber;
+                close: z.ZodNumber;
+                isFocus: z.ZodBoolean;
+            }, z.core.$strict>>;
+            previewBarCount: z.ZodNumber;
+        }, z.core.$strict>;
     }, z.core.$strict>;
     meta: z.ZodObject<{
         barCount: z.ZodNumber;

package/dist/core/chart/analysis/candlestick-patterns-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"candlestick-patterns-tools.d.ts","sourceRoot":"","sources":["../../../../src/core/chart/analysis/candlestick-patterns-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAmB/C,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;mBAOjD,CAAC;AAeF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmCzC,CAAC;AAmBX,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC,CAAC,CA4F5E"}
+{"version":3,"file":"candlestick-patterns-tools.d.ts","sourceRoot":"","sources":["../../../../src/core/chart/analysis/candlestick-patterns-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAoB/C,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;mBAOjD,CAAC;AAeF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2EzC,CAAC;AAmBX,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC,CAAC,CAqG5E"}

package/dist/core/chart/analysis/candlestick-patterns-tools.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { buildPatternRecommendation, filterPatternIds, maxLookback, scanCandlestickPatterns, } from '../../candlestick-patterns/index.js';
 import { normalizeCandleRow } from '../point-normalize.js';
+import { buildCandlestickHighlight } from './candlestick-highlight.js';
 import { buildCandlestickTradeSetup } from './trade-setups/candlestick-trade-setup.js';
 import { buildOhlcvAnalysisMeta, OhlcvAnalysisMetaSchema } from './analysis-meta.js';
 import { prepareOhlcvBarsForAnalysis } from './ohlcv-live-merge.js';
@@ -54,6 +55,42 @@ export const AnalyzeCandlestickPatternsOutputSchema = z
         recommendationConfidence: z.number(),
         rationale: z.string(),
         candlestickTradeSetup: z.object({}).catchall(z.unknown()).nullable(),
+        candlestickHighlight: z
+            .object({
+            summary: z.string(),
+            recommendation: z.enum(['buy', 'sell', 'hold']),
+            recommendationConfidence: z.number(),
+            primaryPattern: z
+                .object({
+                id: z.string(),
+                name: z.string(),
+                description: z.string(),
+                direction: z.enum(['bullish', 'bearish', 'neutral']).optional(),
+            })
+                .strict()
+                .nullable(),
+            patternsFound: z.array(z
+                .object({
+                id: z.string(),
+                name: z.string(),
+                direction: z.enum(['bullish', 'bearish', 'neutral']),
+                confidence: z.number(),
+            })
+                .strict()),
+            focusBarIndex: z.number().int(),
+            previewBars: z.array(z
+                .object({
+                index: z.number().int(),
+                open: z.number(),
+                high: z.number(),
+                low: z.number(),
+                close: z.number(),
+                isFocus: z.boolean(),
+            })
+                .strict()),
+            previewBarCount: z.number().int(),
+        })
+            .strict(),
     })
         .strict(),
     meta: OhlcvAnalysisMetaSchema,
@@ -127,6 +164,14 @@ export async function analyzeCandlestickPatterns(input) {
         focusBarClose: focusBar.close,
         lastClose,
     });
+    const candlestickHighlight = buildCandlestickHighlight({
+        bars,
+        focusBarIndex,
+        primaryPattern,
+        patterns: hits,
+        recommendation,
+        recommendationConfidence,
+    });
     return {
         ok: true,
         data: {
@@ -145,6 +190,7 @@ export async function analyzeCandlestickPatterns(input) {
                 recommendationConfidence,
                 rationale,
                 candlestickTradeSetup,
+                candlestickHighlight,
             },
             meta: buildOhlcvAnalysisMeta(rawBars, {
                 title: parsed.data.title,