@continuumdao/continuum-node-sdk 1.3.25 → 1.3.28

package/dist/core/chart/apply-chart-drawings.js

@@ -1,14 +1,40 @@
-import { extractOhlcvBarsFromUnknown } from './fetch-result.js';
-import { prepareChartFromRows } from './prepare-from-rows.js';
+import { preprocessOhlcvToolInput, missingOhlcvBarsReason } from './analysis/ohlcv-input.js';
+import { extractOhlcvBarsFromUnknown, parseJsonIfString } from './fetch-result.js';
+import { extractLiveBindingFromFetchPayload } from './live/binding-extract.js';
+import { validateOhlcvBarsFromToolResult, sanitizeOhlcvBarRows, OHLCV_EXTRACT_MAX_BARS } from './ohlcv-window.js';
+import { attachChartLoadMeta } from './chart-ohlcv-load-status.js';
+import { runOhlcvIntegrityPipeline } from './ohlcv-integrity.js';
 import { prepareChart } from './prepare.js';
-function barsFromInput(input) {
-    if (input.rows?.length) {
-        return input.rows;
+import { AGENT_CHART_DISPLAY_MAX_POINTS } from './schemas.js';
+const APPLY_DRAWINGS_MAX_POINTS = AGENT_CHART_DISPLAY_MAX_POINTS;
+export function preprocessApplyChartDrawingsInput(raw) {
+    if (typeof raw !== 'object' || raw == null) {
+        return preprocessOhlcvToolInput(raw);
     }
-    if (input.toolResult != null) {
-        return (extractOhlcvBarsFromUnknown(input.toolResult) ?? []);
+    const input = { ...preprocessOhlcvToolInput(raw) };
+    if (input.prepareReplay != null) {
+        input.prepareReplay = parseJsonIfString(input.prepareReplay);
+    }
+    if (input.live != null) {
+        input.live = parseJsonIfString(input.live);
+    }
+    if (input.trendLines == null) {
+        const calcTrendLines = input.data?.trendLines;
+        if (Array.isArray(calcTrendLines)) {
+            input.trendLines = calcTrendLines;
+        }
     }
-    return [];
+    return input;
+}
+function barsFromInput(input) {
+    const extractOptions = { maxPoints: OHLCV_EXTRACT_MAX_BARS };
+    const fromTool = input.toolResult != null
+        ? (extractOhlcvBarsFromUnknown(input.toolResult, extractOptions) ?? [])
+        : [];
+    const raw = (fromTool.length ? fromTool : null) ??
+        (input.rows?.length ? input.rows : null) ??
+        [];
+    return sanitizeOhlcvBarRows(raw);
 }
 function drawingOverlaysFromInput(input) {
     if (input.removeDrawings) {
@@ -25,6 +51,13 @@ function drawingOverlaysFromInput(input) {
         out.push(input.fibonacci);
     }
     if (input.trendLines?.length) {
+        const incomplete = input.trendLines.some(line => !line.pointA ||
+            !line.pointB ||
+            !Number.isFinite(line.pointA.time) ||
+            !Number.isFinite(line.pointB.time));
+        if (incomplete) {
+            return out;
+        }
         out.push({
             type: 'trend_lines',
             lines: input.trendLines.map(line => ({
@@ -44,20 +77,59 @@ function stripDrawingOverlays(replay) {
     const kept = replay.overlays.filter(o => o.type !== 'horizontal_levels' &&
         o.type !== 'pivot_levels' &&
         o.type !== 'fibonacci' &&
-        o.type !== 'trend_lines');
+        o.type !== 'trend_lines' &&
+        o.type !== 'chart_pattern');
     return { ...replay, overlays: kept };
 }
+function shouldSkipDefaultOverlays(baseReplay, indicatorOverlays) {
+    return (baseReplay.skipDefaultOverlays === true ||
+        baseReplay.usedDefaultOverlays === true ||
+        indicatorOverlays.length > 0);
+}
+function resolveLiveBinding(input) {
+    if (input.live) {
+        return input.live;
+    }
+    if (input.toolResult != null) {
+        return extractLiveBindingFromFetchPayload(input.toolResult, {
+            maxPoints: APPLY_DRAWINGS_MAX_POINTS,
+        });
+    }
+    return undefined;
+}
 /** Re-prepare chart with drawing overlays merged into prepareReplay. */
 export function applyChartDrawings(input) {
     const bars = barsFromInput(input);
     if (!bars.length) {
         return {
             ok: false,
-            reason: 'Provide `rows` or `toolResult` with OHLCV bars to apply chart drawings.',
+            reason: missingOhlcvBarsReason(input) +
+                ' Use the same fetch JSON as the original chart — do not substitute analysis JSON or market snapshot.',
         };
     }
+    if (input.toolResult != null) {
+        const windowCheck = validateOhlcvBarsFromToolResult(bars, input.toolResult, input.title);
+        if (!windowCheck.ok) {
+            return windowCheck;
+        }
+    }
+    const integrity = runOhlcvIntegrityPipeline(bars, {
+        toolResult: input.toolResult,
+        rows: input.rows,
+    });
+    if (!integrity.ok) {
+        return integrity;
+    }
     const title = input.title?.trim() || 'Chart';
     const newDrawings = drawingOverlaysFromInput(input);
+    if (input.trendLines?.length &&
+        !newDrawings.some(o => o.type === 'trend_lines') &&
+        !input.removeDrawings) {
+        return {
+            ok: false,
+            reason: '`trendLines` entries must include `pointA` and `pointB` from `calculate_trend_lines`. `analyze_trend_structure` summaries cannot be drawn directly.',
+        };
+    }
     let baseReplay = input.prepareReplay ?? {};
     if (input.removeDrawings) {
         baseReplay = stripDrawingOverlays(baseReplay);
@@ -65,31 +137,29 @@ export function applyChartDrawings(input) {
     const indicatorOverlays = baseReplay.overlays?.filter(o => o.type !== 'horizontal_levels' &&
         o.type !== 'pivot_levels' &&
         o.type !== 'fibonacci' &&
-        o.type !== 'trend_lines') ?? [];
+        o.type !== 'trend_lines' &&
+        o.type !== 'chart_pattern') ?? [];
     const mergedOverlays = [...indicatorOverlays, ...newDrawings];
-    if (input.toolResult != null) {
-        const fromRows = prepareChartFromRows({
-            title,
-            toolResult: input.toolResult,
-        });
-        if (!fromRows.ok) {
-            return fromRows;
-        }
-        if (!mergedOverlays.length && !baseReplay.skipDefaultOverlays) {
-            return fromRows;
-        }
-        return prepareChart({
-            title,
-            bars,
-            overlays: mergedOverlays.length ? mergedOverlays : [],
-            ...(baseReplay.skipDefaultOverlays ? { options: { skipDefaultOverlays: true } } : {}),
-        });
-    }
-    return prepareChart({
+    const skipDefaults = shouldSkipDefaultOverlays(baseReplay, indicatorOverlays);
+    const chartResult = prepareChart({
         title,
         bars,
         ...(mergedOverlays.length ? { overlays: mergedOverlays } : {}),
-        ...(baseReplay.skipDefaultOverlays ? { options: { skipDefaultOverlays: true } } : {}),
+        options: {
+            maxPoints: APPLY_DRAWINGS_MAX_POINTS,
+            ...(skipDefaults ? { skipDefaultOverlays: true } : {}),
+        },
     });
+    if (!chartResult.ok) {
+        return chartResult;
+    }
+    const live = resolveLiveBinding(input);
+    return {
+        ok: true,
+        data: attachChartLoadMeta({
+            ...chartResult.data,
+            ...(live ? { live } : {}),
+        }, bars, { toolResult: input.toolResult, title: input.title, ohlcvFingerprint: integrity.data.fingerprint }),
+    };
 }
 //# sourceMappingURL=apply-chart-drawings.js.map

package/dist/core/chart/apply-chart-drawings.js.map

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

package/dist/core/chart/chart-agent-view.d.ts

@@ -0,0 +1,4 @@
+import type { PrepareChartOutput } from './schemas.js';
+/** Agent-facing chart payload — omits series point arrays (UI still gets full chart via structuredContent). */
+export declare function slimChartOutputForAgent(output: PrepareChartOutput): Record<string, unknown>;
+//# sourceMappingURL=chart-agent-view.d.ts.map

package/dist/core/chart/chart-agent-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-agent-view.d.ts","sourceRoot":"","sources":["../../../src/core/chart/chart-agent-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAErD,+GAA+G;AAC/G,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyB3F"}

package/dist/core/chart/chart-agent-view.js

@@ -0,0 +1,27 @@
+/** Agent-facing chart payload — omits series point arrays (UI still gets full chart via structuredContent). */
+export function slimChartOutputForAgent(output) {
+    const series = output.chart.series.map(s => ({
+        id: s.id,
+        type: s.type,
+        label: s.label,
+        pointCount: s.data.length,
+        ...(s.priceScaleId ? { priceScaleId: s.priceScaleId } : {}),
+        ...(s.paneId ? { paneId: s.paneId } : {}),
+        ...(s.overlay != null ? { overlay: s.overlay } : {}),
+        ...(s.lastValueVisible != null ? { lastValueVisible: s.lastValueVisible } : {}),
+    }));
+    return {
+        kind: output.kind,
+        agentView: 'slim',
+        chart: {
+            ...(output.chart.title ? { title: output.chart.title } : {}),
+            ...(output.chart.height != null ? { height: output.chart.height } : {}),
+            ...(output.chart.panes ? { paneCount: output.chart.panes.length } : {}),
+            series,
+        },
+        ...(output.prepareReplay ? { prepareReplay: output.prepareReplay } : {}),
+        ...(output.live ? { live: output.live } : {}),
+        ...(output.meta ? { meta: output.meta } : {}),
+    };
+}
+//# sourceMappingURL=chart-agent-view.js.map

package/dist/core/chart/chart-agent-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-agent-view.js","sourceRoot":"","sources":["../../../src/core/chart/chart-agent-view.ts"],"names":[],"mappings":"AAEA,+GAA+G;AAC/G,MAAM,UAAU,uBAAuB,CAAC,MAA0B;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5C,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM;QACzB,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAC,YAAY,EAAE,CAAC,CAAC,YAAY,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,CAAC,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC,CAAC,CAAC;IAEJ,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM;QACjB,KAAK,EAAE;YACN,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM;SACN;QACD,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAC,aAAa,EAAE,MAAM,CAAC,aAAa,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3C,CAAC;AACH,CAAC"}

package/dist/core/chart/chart-data-validation.d.ts

@@ -0,0 +1,63 @@
+/** OHLCV bar array keys seen across DeFi and market-data providers. */
+export declare const OHLCV_COLLECTION_KEYS: readonly ["candles", "klines", "bars", "candlesticks"];
+/** Line / metric point array keys (time series analysis and some chart sources). */
+export declare const TIME_SERIES_COLLECTION_KEYS: readonly ["series", "points", "values", "data", "list"];
+export declare const CHART_DATA_COLLECTION_KEYS: readonly ["candles", "klines", "bars", "candlesticks", "series", "points", "values", "data", "list"];
+export declare const FETCH_WINDOW_MS_KEYS: readonly ["startTimeMs", "endTimeMs", "startMs", "endMs"];
+export declare const FETCH_LOOKBACK_KEYS: readonly ["lookbackDays", "lookbackHours"];
+export declare const FETCH_DECLARED_COUNT_KEYS: readonly ["candleCount", "expectedBars", "barCount", "pointCount", "expectedPoints"];
+export declare const MANGLED_CHART_DATA_REASON: string;
+/** Primary data record for interval-based OHLCV fetches (nested `ohlcv` or flat symbol envelope). */
+export declare function intervalDataRecordFromPayload(payload: unknown): Record<string, unknown> | null;
+export declare function collectionIsItemWrapper(raw: unknown): boolean;
+export declare function recordHasCollectionKey(record: Record<string, unknown>, keys: readonly string[]): boolean;
+/** Payload layers to scan for mangled `{ item: [...] }` collections. */
+export declare function payloadRecordsForValidation(toolResult: unknown): Record<string, unknown>[];
+/** Interval OHLCV envelope: symbol + bar interval + bar collection. */
+export declare function structuredIntervalEnvelopeRecord(toolResult: unknown): Record<string, unknown> | null;
+/** Time-series envelope: explicit fetch title + point collection (metric / line charts). */
+export declare function structuredTimeSeriesEnvelopeRecord(toolResult: unknown): Record<string, unknown> | null;
+export declare function fetchMetadataPresent(toolResult: unknown, record: Record<string, unknown>): boolean;
+/** Reject agent-reconstructed chart fetch payloads (OHLCV or time series). */
+export declare function rejectMangledChartDataToolResult(toolResult: unknown): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** @deprecated Alias — use rejectMangledChartDataToolResult */
+export declare const rejectMangledVendorFetchToolResult: typeof rejectMangledChartDataToolResult;
+/** Validate declared bar count and timestamp field consistency for interval OHLCV fetches. */
+export declare function validateStructuredIntervalFetchShape(toolResult: unknown, bars: Record<string, unknown>[]): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Hard-fail when point times disagree with chart title lookback (OHLCV bars or line series). */
+export declare function rejectTitleLookbackVsPointTimes(title: string | undefined, rows: Record<string, unknown>[], timeSecFromRow: (row: Record<string, unknown>) => number | null): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function rejectTitleLookbackVsBarTimes(title: string | undefined, bars: Record<string, unknown>[]): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function rejectTitleLookbackVsTimeSeriesPoints(title: string | undefined, points: Record<string, unknown>[]): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** When toolResult is present, reject mangled fetches and title/point timeline mismatches. */
+export declare function validateTimeSeriesPointsFromToolResult(points: Record<string, unknown>[], toolResult: unknown, title?: string): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+//# sourceMappingURL=chart-data-validation.d.ts.map

package/dist/core/chart/chart-data-validation.d.ts.map

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

package/dist/core/chart/chart-data-validation.js

@@ -0,0 +1,320 @@
+import { barTimeSecFromRow } from './live/bar-merge.js';
+import { timeSeriesPointTimeSec } from './analysis/time-series-input.js';
+import { parseLookbackSpanFromChartTitle } from './ohlcv-window-expectations.js';
+import { parseChartTime } from './point-normalize.js';
+/** OHLCV bar array keys seen across DeFi and market-data providers. */
+export const OHLCV_COLLECTION_KEYS = ['candles', 'klines', 'bars', 'candlesticks'];
+/** Line / metric point array keys (time series analysis and some chart sources). */
+export const TIME_SERIES_COLLECTION_KEYS = ['series', 'points', 'values', 'data', 'list'];
+export const CHART_DATA_COLLECTION_KEYS = [
+    ...OHLCV_COLLECTION_KEYS,
+    ...TIME_SERIES_COLLECTION_KEYS,
+];
+export const FETCH_WINDOW_MS_KEYS = ['startTimeMs', 'endTimeMs', 'startMs', 'endMs'];
+export const FETCH_LOOKBACK_KEYS = ['lookbackDays', 'lookbackHours'];
+export const FETCH_DECLARED_COUNT_KEYS = [
+    'candleCount',
+    'expectedBars',
+    'barCount',
+    'pointCount',
+    'expectedPoints',
+];
+export const MANGLED_CHART_DATA_REASON = 'Chart data toolResult must be the full provider fetch MCP result — not hand-reconstructed rows. ' +
+    'Run the provider fetch once and pass the structured JSON unchanged (timestamps and window metadata). ' +
+    'Do not wrap arrays as `{ item: [...] }`.';
+const TITLE_LOOKBACK_POINT_GRACE_SEC = 2 * 86_400;
+function coerceCount(raw) {
+    if (typeof raw === 'number' && Number.isFinite(raw) && raw > 0) {
+        return Math.floor(raw);
+    }
+    if (typeof raw === 'string') {
+        const n = Number(raw.trim());
+        if (Number.isFinite(n) && n > 0) {
+            return Math.floor(n);
+        }
+    }
+    return null;
+}
+function coerceMs(raw) {
+    if (typeof raw === 'number' && Number.isFinite(raw) && raw > 0) {
+        return raw;
+    }
+    if (typeof raw === 'string') {
+        const n = Number(raw.trim());
+        if (Number.isFinite(n) && n > 0) {
+            return n;
+        }
+    }
+    return null;
+}
+/** Primary data record for interval-based OHLCV fetches (nested `ohlcv` or flat symbol envelope). */
+export function intervalDataRecordFromPayload(payload) {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+        return null;
+    }
+    const record = payload;
+    if (record.ohlcv && typeof record.ohlcv === 'object' && !Array.isArray(record.ohlcv)) {
+        return record.ohlcv;
+    }
+    for (const key of ['candles', 'startTimeMs', 'coin', 'symbol', 'timeframe', 'interval']) {
+        if (key in record) {
+            return record;
+        }
+    }
+    return null;
+}
+export function collectionIsItemWrapper(raw) {
+    return (raw != null &&
+        typeof raw === 'object' &&
+        !Array.isArray(raw) &&
+        Array.isArray(raw.item));
+}
+export function recordHasCollectionKey(record, keys) {
+    for (const key of keys) {
+        if (key in record) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Payload layers to scan for mangled `{ item: [...] }` collections. */
+export function payloadRecordsForValidation(toolResult) {
+    if (!toolResult || typeof toolResult !== 'object' || Array.isArray(toolResult)) {
+        return [];
+    }
+    const root = toolResult;
+    const records = [root];
+    const intervalRecord = intervalDataRecordFromPayload(toolResult);
+    if (intervalRecord && intervalRecord !== root) {
+        records.push(intervalRecord);
+    }
+    if (root.result && typeof root.result === 'object' && !Array.isArray(root.result)) {
+        records.push(root.result);
+    }
+    return records;
+}
+/** Interval OHLCV envelope: symbol + bar interval + bar collection. */
+export function structuredIntervalEnvelopeRecord(toolResult) {
+    const record = intervalDataRecordFromPayload(toolResult);
+    if (!record) {
+        return null;
+    }
+    const symbolRaw = record.coin ?? record.symbol;
+    const hasSymbol = typeof symbolRaw === 'string' && symbolRaw.trim().length > 0;
+    const intervalRaw = record.interval ?? record.timeframe;
+    const hasInterval = typeof intervalRaw === 'string' && intervalRaw.trim().length > 0;
+    if (!hasSymbol || !hasInterval || !recordHasCollectionKey(record, OHLCV_COLLECTION_KEYS)) {
+        return null;
+    }
+    return record;
+}
+/** Time-series envelope: explicit fetch title + point collection (metric / line charts). */
+export function structuredTimeSeriesEnvelopeRecord(toolResult) {
+    if (!toolResult || typeof toolResult !== 'object' || Array.isArray(toolResult)) {
+        return null;
+    }
+    const root = toolResult;
+    const title = typeof root.title === 'string' && root.title.trim()
+        ? root.title.trim()
+        : typeof root.result?.title === 'string'
+            ? String(root.result.title).trim()
+            : '';
+    if (!title) {
+        return null;
+    }
+    for (const record of payloadRecordsForValidation(toolResult)) {
+        if (recordHasCollectionKey(record, TIME_SERIES_COLLECTION_KEYS)) {
+            return record;
+        }
+    }
+    if (recordHasCollectionKey(root, TIME_SERIES_COLLECTION_KEYS)) {
+        return root;
+    }
+    return null;
+}
+function hasFetchWindowMs(record) {
+    const start = coerceMs(record.startTimeMs ?? record.startMs);
+    const end = coerceMs(record.endTimeMs ?? record.endMs);
+    return start != null && end != null;
+}
+function candlesFromIntervalRecord(record) {
+    for (const key of OHLCV_COLLECTION_KEYS) {
+        const raw = record[key];
+        if (Array.isArray(raw)) {
+            return raw.filter((row) => row != null && typeof row === 'object');
+        }
+    }
+    return null;
+}
+/** Vendor interval fetches use millisecond bar timestamps; agent hand-copies often use generic `time`. */
+function intervalEnvelopeHasVendorBarTimestamps(record) {
+    const candles = candlesFromIntervalRecord(record);
+    if (!candles?.length) {
+        return false;
+    }
+    const hasVendorMs = (bar) => coerceMs(bar.timestampMs) != null || coerceMs(bar.openTime) != null;
+    return hasVendorMs(candles[0]) && hasVendorMs(candles[candles.length - 1]);
+}
+export function fetchMetadataPresent(toolResult, record) {
+    const layers = [record, ...payloadRecordsForValidation(toolResult)];
+    for (const layer of layers) {
+        if (hasFetchWindowMs(layer)) {
+            return true;
+        }
+        for (const key of FETCH_LOOKBACK_KEYS) {
+            if (coerceCount(layer[key]) != null) {
+                return true;
+            }
+        }
+        for (const key of FETCH_DECLARED_COUNT_KEYS) {
+            if (coerceCount(layer[key]) != null) {
+                return true;
+            }
+        }
+    }
+    if (intervalEnvelopeHasVendorBarTimestamps(record)) {
+        return true;
+    }
+    return false;
+}
+/** Reject agent-reconstructed chart fetch payloads (OHLCV or time series). */
+export function rejectMangledChartDataToolResult(toolResult) {
+    if (!toolResult || typeof toolResult !== 'object') {
+        return { ok: true };
+    }
+    for (const record of payloadRecordsForValidation(toolResult)) {
+        for (const key of CHART_DATA_COLLECTION_KEYS) {
+            if (collectionIsItemWrapper(record[key])) {
+                return { ok: false, reason: MANGLED_CHART_DATA_REASON };
+            }
+        }
+    }
+    const intervalEnvelope = structuredIntervalEnvelopeRecord(toolResult);
+    if (intervalEnvelope && !fetchMetadataPresent(toolResult, intervalEnvelope)) {
+        return { ok: false, reason: MANGLED_CHART_DATA_REASON };
+    }
+    return { ok: true };
+}
+/** @deprecated Alias — use rejectMangledChartDataToolResult */
+export const rejectMangledVendorFetchToolResult = rejectMangledChartDataToolResult;
+function barTimeTimestampConflict(bar) {
+    if (bar.timestampMs == null || !('time' in bar)) {
+        return false;
+    }
+    const fromMs = parseChartTime(bar.timestampMs);
+    const fromTime = parseChartTime(bar.time);
+    if (fromMs == null || fromTime == null) {
+        return false;
+    }
+    const msSec = typeof fromMs === 'number' ? fromMs : null;
+    const timeSec = typeof fromTime === 'number' ? fromTime : null;
+    if (msSec == null || timeSec == null) {
+        return false;
+    }
+    return Math.abs(msSec - timeSec) > 86_400;
+}
+/** Validate declared bar count and timestamp field consistency for interval OHLCV fetches. */
+export function validateStructuredIntervalFetchShape(toolResult, bars) {
+    const record = intervalDataRecordFromPayload(toolResult);
+    if (!record) {
+        return { ok: true };
+    }
+    const symbolRaw = record.coin ?? record.symbol;
+    if (typeof symbolRaw !== 'string' || !symbolRaw.trim()) {
+        return { ok: true };
+    }
+    const fetchUsesTimestampMs = bars.some(bar => bar.timestampMs != null);
+    for (const bar of bars) {
+        if (barTimeTimestampConflict(bar)) {
+            return {
+                ok: false,
+                reason: 'OHLCV rows have conflicting `time` and `timestampMs` fields. ' +
+                    'Pass the full fetch toolResult unchanged — do not rewrite timestamps.',
+            };
+        }
+        if (fetchUsesTimestampMs &&
+            bar.timestampMs == null &&
+            !('openTime' in bar) &&
+            'time' in bar) {
+            return {
+                ok: false,
+                reason: 'OHLCV rows must keep vendor timestamp fields from the fetch result. ' +
+                    'Pass the full fetch toolResult unchanged — do not replace with generic `time` fields.',
+            };
+        }
+    }
+    let expected = null;
+    for (const key of FETCH_DECLARED_COUNT_KEYS) {
+        const n = coerceCount(record[key]);
+        if (n != null) {
+            expected = expected == null ? n : Math.max(expected, n);
+        }
+    }
+    if (expected != null && Math.abs(bars.length - expected) > 1) {
+        return {
+            ok: false,
+            reason: `Row count (${bars.length}) does not match fetch declared count (${expected}). ` +
+                'Pass the full chart data fetch toolResult unchanged.',
+        };
+    }
+    return { ok: true };
+}
+/** Hard-fail when point times disagree with chart title lookback (OHLCV bars or line series). */
+export function rejectTitleLookbackVsPointTimes(title, rows, timeSecFromRow) {
+    if (!title?.trim() || rows.length < 2) {
+        return { ok: true };
+    }
+    const lookback = parseLookbackSpanFromChartTitle(title);
+    if (!lookback) {
+        return { ok: true };
+    }
+    const times = rows
+        .map(row => timeSecFromRow(row))
+        .filter((t) => t != null);
+    if (times.length < 2) {
+        return { ok: true };
+    }
+    const firstSec = Math.min(...times);
+    const lastSec = Math.max(...times);
+    const nowSec = Math.floor(Date.now() / 1000);
+    const graceSec = TITLE_LOOKBACK_POINT_GRACE_SEC;
+    const earliestAllowed = nowSec - lookback.spanSec - graceSec;
+    if (firstSec < earliestAllowed) {
+        return {
+            ok: false,
+            reason: `First point is too old for chart title lookback (${lookback.label}). ` +
+                'Run the provider fetch for the requested window and pass the full MCP toolResult unchanged — do not paste rows from memory.',
+        };
+    }
+    if (lastSec < nowSec - lookback.spanSec - graceSec) {
+        return {
+            ok: false,
+            reason: `Latest point is too stale for chart title lookback (${lookback.label}). ` +
+                'Re-run the provider fetch and pass the full MCP result unchanged.',
+        };
+    }
+    const actualSpanSec = Math.max(0, lastSec - firstSec);
+    if (actualSpanSec > lookback.spanSec * 1.35) {
+        return {
+            ok: false,
+            reason: `Point span (~${Math.round(actualSpanSec / 86_400)}d) exceeds chart title lookback (${lookback.label}) — likely mixed timelines. ` +
+                'Pass the full fetch toolResult unchanged; do not merge old and new data.',
+        };
+    }
+    return { ok: true };
+}
+export function rejectTitleLookbackVsBarTimes(title, bars) {
+    return rejectTitleLookbackVsPointTimes(title, bars, barTimeSecFromRow);
+}
+export function rejectTitleLookbackVsTimeSeriesPoints(title, points) {
+    return rejectTitleLookbackVsPointTimes(title, points, timeSeriesPointTimeSec);
+}
+/** When toolResult is present, reject mangled fetches and title/point timeline mismatches. */
+export function validateTimeSeriesPointsFromToolResult(points, toolResult, title) {
+    const mangled = rejectMangledChartDataToolResult(toolResult);
+    if (!mangled.ok) {
+        return mangled;
+    }
+    return rejectTitleLookbackVsTimeSeriesPoints(title, points);
+}
+//# sourceMappingURL=chart-data-validation.js.map