@continuumdao/continuum-node-sdk 1.3.24 → 1.3.27

package/dist/core/chart/ohlcv-integrity.js

@@ -0,0 +1,266 @@
+import { z } from 'zod';
+import { summarizeOhlcvBars } from './chart-ohlcv-summary.js';
+import { normalizeCandleRow, parseChartTimeFromRow } from './point-normalize.js';
+/** Body mid this many × median range away from prior bar → stale/wrong slice. */
+const STALE_BODY_GAP_MULTIPLIER = 3;
+/** Wick must exceed body by this factor before a stale-body composite is considered. */
+const MIN_WICK_BODY_RATIO_FOR_COMPOSITE = 8;
+/** Wick extreme must land within this × median range of the prior bar high/low. */
+const WICK_NEAR_PRIOR_RANGE_MULTIPLIER = 4;
+const MIN_BARS_FOR_MEDIAN = 8;
+export const OhlcvFingerprintSchema = z
+    .object({
+    version: z.literal(1),
+    barCount: z.number().int(),
+    timeStartSec: z.number(),
+    timeEndSec: z.number(),
+    low: z.number(),
+    high: z.number(),
+    lastClose: z.number(),
+    /** Stable id — compare across chart + analyze on the same fetch. */
+    digest: z.string(),
+})
+    .strict();
+export { ANALYSIS_FOLLOWUP_SAME_FETCH, OHLCV_TRUNCATION_MYTH } from './ohlcv-integrity-messages.js';
+export { OhlcvFetchContextSchema, OhlcvWindowExpectationSchema, formatWindowExpectation, parseIntervalLabelFromChartTitle, parseLookbackDaysFromChartTitle, parseLookbackSpanFromChartTitle, rejectIntervalMismatchTitleVsFetch, rejectOhlcvWindowBarCountMismatch, rejectOhlcvWindowMismatch, rejectTitleLookbackBarCountMismatch, rejectTitleLookbackMismatchVsFetch, resolveOhlcvFetchContext, resolveOhlcvWindowExpectation, } from './ohlcv-window-expectations.js';
+export const ROWS_ONLY_WITHOUT_TOOL_RESULT_REASON = 'OHLCV `rows` without fetch `toolResult` are not trusted for charts or analysis. ' +
+    'Re-run the OHLCV fetch and pass the full MCP JSON as `toolResult` unchanged (Hyperliquid, GMX, CoinGecko, CMC, etc.). ' +
+    'Do not hand-copy candle arrays into chat or `rows`.';
+function hasFetchPayload(input) {
+    return (input.toolResult != null || input.executeResult != null || input.fetchResult != null);
+}
+/** Reject hand-copied rows when no fetch payload is present (all vendors). */
+export function rejectRowsOnlyWithoutFetch(input) {
+    if (input.allowRowsOnly) {
+        return { ok: true };
+    }
+    const hasRows = Array.isArray(input.rows) && input.rows.length > 0;
+    if (hasRows && !hasFetchPayload(input)) {
+        return { ok: false, reason: ROWS_ONLY_WITHOUT_TOOL_RESULT_REASON };
+    }
+    return { ok: true };
+}
+function formatTimeSec(timeSec) {
+    if (timeSec == null) {
+        return '?';
+    }
+    return new Date(timeSec * 1000).toISOString();
+}
+function structuralOhlcIssues(open, high, low, close) {
+    const issues = [];
+    if (high < low) {
+        issues.push('high < low');
+    }
+    if (high < open) {
+        issues.push('high < open');
+    }
+    if (high < close) {
+        issues.push('high < close');
+    }
+    if (low > open) {
+        issues.push('low > open');
+    }
+    if (low > close) {
+        issues.push('low > close');
+    }
+    return issues;
+}
+/** Stale body at wrong price level while wick reaches prior-bar range (mixed feed composite). */
+function staleCompositeIssues(open, high, low, close, prev, medianRange) {
+    if (!prev || medianRange == null || medianRange <= 0) {
+        return [];
+    }
+    const body = Math.abs(close - open);
+    const mid = (open + close) / 2;
+    const minBody = Math.max(mid * 1e-4, 1e-6);
+    const prevMid = (prev.open + prev.close) / 2;
+    const bodyGap = Math.abs(mid - prevMid);
+    if (bodyGap <= medianRange * STALE_BODY_GAP_MULTIPLIER) {
+        return [];
+    }
+    const issues = [];
+    const upperWick = high - Math.max(open, close);
+    const lowerWick = Math.min(open, close) - low;
+    const nearPrior = medianRange * WICK_NEAR_PRIOR_RANGE_MULTIPLIER;
+    if (body >= minBody && upperWick > body * MIN_WICK_BODY_RATIO_FOR_COMPOSITE) {
+        if (high >= prev.high - nearPrior && high <= prev.high + nearPrior) {
+            issues.push(`body near ${mid.toFixed(1)} but high ${high.toFixed(1)} matches prior bar while body gap is ${bodyGap.toFixed(1)} — likely stale/mixed composite OHLC`);
+        }
+    }
+    if (body >= minBody && lowerWick > body * MIN_WICK_BODY_RATIO_FOR_COMPOSITE) {
+        if (low <= prev.low + nearPrior && low >= prev.low - nearPrior) {
+            issues.push(`body near ${mid.toFixed(1)} but low ${low.toFixed(1)} matches prior bar while body gap is ${bodyGap.toFixed(1)} — likely stale/mixed composite OHLC`);
+        }
+    }
+    return issues;
+}
+function medianBarRange(candles) {
+    if (candles.length < MIN_BARS_FOR_MEDIAN) {
+        return null;
+    }
+    const ranges = candles.map(c => c.high - c.low).filter(r => r > 0).sort((a, b) => a - b);
+    if (!ranges.length) {
+        return null;
+    }
+    const mid = Math.floor(ranges.length / 2);
+    return ranges.length % 2 ? ranges[mid] : (ranges[mid - 1] + ranges[mid]) / 2;
+}
+/** Validate every bar: structural OHLC + wick/outlier heuristics (all data sources). */
+export function validateOhlcvBarIntegrity(bars, options = {}) {
+    const normalized = [];
+    for (let index = 0; index < bars.length; index++) {
+        const candle = normalizeCandleRow(bars[index]);
+        if (!candle) {
+            continue;
+        }
+        const timeSec = typeof candle.time === 'number'
+            ? candle.time
+            : parseChartTimeFromRow(bars[index]);
+        normalized.push({
+            index,
+            timeSec: typeof timeSec === 'number' ? timeSec : null,
+            open: candle.open,
+            high: candle.high,
+            low: candle.low,
+            close: candle.close,
+        });
+    }
+    const medianRange = medianBarRange(normalized);
+    const invalidBars = [];
+    const maxReport = options.maxReport ?? 3;
+    for (let i = 0; i < normalized.length; i++) {
+        const bar = normalized[i];
+        const prev = i > 0 ? normalized[i - 1] : null;
+        const issues = [
+            ...structuralOhlcIssues(bar.open, bar.high, bar.low, bar.close),
+            ...staleCompositeIssues(bar.open, bar.high, bar.low, bar.close, prev, medianRange),
+        ];
+        if (issues.length) {
+            invalidBars.push({
+                index: bar.index,
+                timeSec: bar.timeSec,
+                open: bar.open,
+                high: bar.high,
+                low: bar.low,
+                close: bar.close,
+                issues,
+            });
+        }
+    }
+    if (!invalidBars.length) {
+        return { ok: true };
+    }
+    const sample = invalidBars.slice(0, maxReport);
+    const detail = sample
+        .map(b => `bar #${b.index + 1} (${formatTimeSec(b.timeSec)} O=${b.open} H=${b.high} L=${b.low} C=${b.close}): ${b.issues.join('; ')}`)
+        .join(' | ');
+    return {
+        ok: false,
+        reason: `Invalid or corrupt OHLCV (${invalidBars.length} bar(s)): ${detail}. ` +
+            'Re-fetch OHLCV and pass the full fetch toolResult unchanged — do not hand-copy rows.',
+        invalidBars,
+    };
+}
+export function buildOhlcvFingerprint(bars) {
+    const summary = summarizeOhlcvBars(bars);
+    if (!summary) {
+        return null;
+    }
+    let firstAnchor = '';
+    let lastAnchor = '';
+    for (const raw of bars) {
+        const c = normalizeCandleRow(raw);
+        if (!c || typeof c.time !== 'number') {
+            continue;
+        }
+        const anchor = `${c.time}:${c.open.toFixed(4)}:${c.high.toFixed(4)}:${c.low.toFixed(4)}:${c.close.toFixed(4)}`;
+        if (!firstAnchor) {
+            firstAnchor = anchor;
+        }
+        lastAnchor = anchor;
+    }
+    const digest = [
+        summary.barCount,
+        summary.timeStartSec,
+        summary.timeEndSec,
+        summary.low.toFixed(2),
+        summary.high.toFixed(2),
+        summary.lastClose.toFixed(2),
+        firstAnchor,
+        lastAnchor,
+    ].join('|');
+    return {
+        version: 1,
+        barCount: summary.barCount,
+        timeStartSec: summary.timeStartSec,
+        timeEndSec: summary.timeEndSec,
+        low: summary.low,
+        high: summary.high,
+        lastClose: summary.lastClose,
+        digest: `v1:${digest}`,
+    };
+}
+export const APPLY_PATTERN_DRAWINGS_WORKFLOW = 'Add a classic pattern overlay with ONE call to apply_chart_pattern_drawings: pass `prepareReplay` + `live` from the prior chart, `analysis` (or patternId/drawings), and `{ title, ohlcvDigest }` from meta.sessionBind (or full fetch toolResult once). Do NOT call prepare_chart_from_rows again.';
+export function rejectApplyPatternDrawingsWithoutChartContext(input) {
+    const hasReplay = input.prepareReplay != null &&
+        typeof input.prepareReplay === 'object' &&
+        !Array.isArray(input.prepareReplay);
+    const hasFetch = input.toolResult != null;
+    const hasRows = Array.isArray(input.rows) && input.rows.length > 0;
+    if (!hasFetch && !hasRows) {
+        return {
+            ok: false,
+            reason: 'Missing OHLCV data for pattern overlay. Pass `toolResult` from the original fetch (preferred) or `rows` from that fetch. ' +
+                APPLY_PATTERN_DRAWINGS_WORKFLOW,
+        };
+    }
+    if (!hasReplay && !hasFetch) {
+        return {
+            ok: false,
+            reason: 'Missing `prepareReplay` from the prior chart. Pass `prepareReplay` (and `live` when present) from prepare_chart_from_rows output — do not recreate the chart. ' +
+                APPLY_PATTERN_DRAWINGS_WORKFLOW,
+        };
+    }
+    return { ok: true };
+}
+const GEOMETRY_MISMATCH_FAIL = 'Pattern geometry prices fall outside loaded OHLCV summary — analysis and chart likely use different data. ' +
+    'Re-fetch once and pass the same full toolResult to prepare_chart_from_rows and analyze_* (compare meta.ohlcvFingerprint).';
+/** Tolerance for pattern geometry vs OHLCV summary (smoothed swings / live mark may slightly exceed bar wicks). */
+export function geometryToleranceForOhlcvSummary(summary) {
+    return Math.max(0.5, summary.high * 0.02);
+}
+/** Hard-fail when referenced prices are outside the loaded bar range (mixed fetches). */
+export function rejectGeometryOutsideOhlcvSummary(summary, prices, tolerance) {
+    const effectiveTolerance = tolerance ?? geometryToleranceForOhlcvSummary(summary);
+    if (!prices.length) {
+        return { ok: true };
+    }
+    const max = Math.max(...prices);
+    const min = Math.min(...prices);
+    if (max > summary.high + effectiveTolerance) {
+        return {
+            ok: false,
+            reason: `Referenced price ${max.toFixed(2)} is above loaded OHLCV high ${summary.high.toFixed(2)}. ${GEOMETRY_MISMATCH_FAIL}`,
+        };
+    }
+    if (min < summary.low - effectiveTolerance) {
+        return {
+            ok: false,
+            reason: `Referenced price ${min.toFixed(2)} is below loaded OHLCV low ${summary.low.toFixed(2)}. ${GEOMETRY_MISMATCH_FAIL}`,
+        };
+    }
+    return { ok: true };
+}
+/** Provenance + per-bar integrity — run before chart prep or analysis. */
+export function runOhlcvIntegrityPipeline(bars, input) {
+    const provenance = rejectRowsOnlyWithoutFetch(input);
+    if (!provenance.ok) {
+        return provenance;
+    }
+    const integrity = validateOhlcvBarIntegrity(bars);
+    if (!integrity.ok) {
+        return { ok: false, reason: integrity.reason };
+    }
+    return { ok: true, data: { fingerprint: buildOhlcvFingerprint(bars) } };
+}
+//# sourceMappingURL=ohlcv-integrity.js.map

package/dist/core/chart/ohlcv-integrity.js.map

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

package/dist/core/chart/ohlcv-session-store.d.ts

@@ -0,0 +1,38 @@
+import type { SdkResult } from '../result.js';
+import { type OhlcvFingerprint } from './ohlcv-integrity.js';
+export type BoundOhlcvFetch = {
+    toolResult: unknown;
+    fingerprint: OhlcvFingerprint | null;
+    title?: string;
+    boundAt: number;
+};
+export type OhlcvSessionResolveInput = {
+    toolResult?: unknown;
+    rows?: unknown;
+    title?: string;
+    ohlcvDigest?: string;
+    allowRowsOnly?: boolean;
+};
+export type OhlcvSessionBindHint = {
+    ohlcvDigest: string;
+    title?: string;
+    reuseInput: {
+        title?: string;
+        ohlcvDigest: string;
+    };
+};
+export declare function clearOhlcvSession(sessionKey: string): void;
+export declare function getBoundOhlcvFetch(sessionKey: string): BoundOhlcvFetch | undefined;
+/** Store the latest OHLCV fetch for a session (fetch, chart, or analyze with full toolResult). */
+export declare function bindOhlcvSessionFetch(sessionKey: string, toolResult: unknown, options?: {
+    title?: string;
+    fingerprint?: OhlcvFingerprint | null;
+}): BoundOhlcvFetch | null;
+export declare function buildOhlcvSessionBindHint(bound: BoundOhlcvFetch): OhlcvSessionBindHint | undefined;
+/** Strip trailing parenthetical suffixes so "ETH 1H — last 7d" matches "ETH 1H — last 7d (Hyperliquid)". */
+export declare function normalizeOhlcvSessionTitle(title: string): string;
+/** Resolve MCP input: inject bound toolResult from session when only title/digest provided. */
+export declare function resolveOhlcvSessionInput(sessionKey: string, input: OhlcvSessionResolveInput): SdkResult<OhlcvSessionResolveInput & {
+    toolResult?: unknown;
+}>;
+//# sourceMappingURL=ohlcv-session-store.d.ts.map

package/dist/core/chart/ohlcv-session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcv-session-store.d.ts","sourceRoot":"","sources":["../../../src/core/chart/ohlcv-session-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAwB,KAAK,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAGlF,MAAM,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC;CAClD,CAAC;AAIF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAElF;AAUD,kGAAkG;AAClG,wBAAgB,qBAAqB,CACpC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,OAAO,EACnB,OAAO,GAAE;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAM,GACnE,eAAe,GAAG,IAAI,CAcxB;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,eAAe,GACpB,oBAAoB,GAAG,SAAS,CAalC;AAQD,4GAA4G;AAC5G,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAgBD,+FAA+F;AAC/F,wBAAgB,wBAAwB,CACvC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,wBAAwB,GAC7B,SAAS,CAAC,wBAAwB,GAAG;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAC,CAAC,CAgD9D"}

package/dist/core/chart/ohlcv-session-store.js

@@ -0,0 +1,107 @@
+import { extractOhlcvBarsFromUnknown } from './fetch-result.js';
+import { buildOhlcvFingerprint } from './ohlcv-integrity.js';
+import { invalidStringToolResultReason, isUnparsedJsonString } from './ohlcv-window.js';
+const store = new Map();
+export function clearOhlcvSession(sessionKey) {
+    store.delete(sessionKey);
+}
+export function getBoundOhlcvFetch(sessionKey) {
+    return store.get(sessionKey);
+}
+function fingerprintFromToolResult(toolResult) {
+    const bars = extractOhlcvBarsFromUnknown(toolResult, { maxPoints: 10_000 });
+    if (!bars?.length) {
+        return null;
+    }
+    return buildOhlcvFingerprint(bars);
+}
+/** Store the latest OHLCV fetch for a session (fetch, chart, or analyze with full toolResult). */
+export function bindOhlcvSessionFetch(sessionKey, toolResult, options = {}) {
+    if (toolResult == null || typeof toolResult !== 'object') {
+        return null;
+    }
+    const fingerprint = options.fingerprint ?? fingerprintFromToolResult(toolResult);
+    const bound = {
+        toolResult,
+        fingerprint,
+        ...(options.title?.trim() ? { title: options.title.trim() } : {}),
+        boundAt: Date.now(),
+    };
+    store.set(sessionKey, bound);
+    return bound;
+}
+export function buildOhlcvSessionBindHint(bound) {
+    const digest = bound.fingerprint?.digest;
+    if (!digest) {
+        return undefined;
+    }
+    return {
+        ohlcvDigest: digest,
+        ...(bound.title ? { title: bound.title } : {}),
+        reuseInput: {
+            ...(bound.title ? { title: bound.title } : {}),
+            ohlcvDigest: digest,
+        },
+    };
+}
+const DIGEST_MISMATCH_REASON = '`ohlcvDigest` does not match the bound session fetch. Pass the digest from the prior chart/analyze meta.sessionBind, or pass the full fetch object once after re-fetching.';
+const SESSION_MISS_REASON = 'No OHLCV in this request and no bound fetch in this session. Run fetch_ohlcv once, then pass `{ title, ohlcvDigest }` from meta.sessionBind on follow-ups — do not re-paste candle JSON.';
+/** Strip trailing parenthetical suffixes so "ETH 1H — last 7d" matches "ETH 1H — last 7d (Hyperliquid)". */
+export function normalizeOhlcvSessionTitle(title) {
+    return title.trim().replace(/\s*\([^)]*\)\s*$/u, '').trim();
+}
+function ohlcvSessionTitlesCompatible(requested, bound) {
+    const req = requested?.trim();
+    const bnd = bound?.trim();
+    if (!req || !bnd) {
+        return true;
+    }
+    if (req === bnd) {
+        return true;
+    }
+    const reqNorm = normalizeOhlcvSessionTitle(req);
+    const bndNorm = normalizeOhlcvSessionTitle(bnd);
+    return reqNorm === bndNorm || bndNorm.startsWith(reqNorm) || reqNorm.startsWith(bndNorm);
+}
+/** Resolve MCP input: inject bound toolResult from session when only title/digest provided. */
+export function resolveOhlcvSessionInput(sessionKey, input) {
+    if (input.toolResult != null) {
+        if (typeof input.toolResult === 'string') {
+            if (isUnparsedJsonString(input.toolResult)) {
+                return { ok: false, reason: invalidStringToolResultReason() };
+            }
+            return {
+                ok: false,
+                reason: '`toolResult` must be the fetch JSON object, not a string. On follow-ups pass `{ title, ohlcvDigest }` from meta.sessionBind instead of re-pasting fetch JSON.',
+            };
+        }
+        return { ok: true, data: input };
+    }
+    if (Array.isArray(input.rows) && input.rows.length > 0) {
+        return { ok: true, data: input };
+    }
+    const bound = store.get(sessionKey);
+    if (!bound) {
+        return { ok: false, reason: SESSION_MISS_REASON };
+    }
+    const requestedDigest = input.ohlcvDigest?.trim();
+    if (requestedDigest && bound.fingerprint?.digest !== requestedDigest) {
+        return { ok: false, reason: DIGEST_MISMATCH_REASON };
+    }
+    if (input.title?.trim() &&
+        bound.title &&
+        !ohlcvSessionTitlesCompatible(input.title, bound.title)) {
+        return {
+            ok: false,
+            reason: '`title` does not match the bound session fetch. Use the same title as the chart step, or pass matching meta.ohlcvFingerprint.digest via `ohlcvDigest`.',
+        };
+    }
+    return {
+        ok: true,
+        data: {
+            ...input,
+            toolResult: bound.toolResult,
+        },
+    };
+}
+//# sourceMappingURL=ohlcv-session-store.js.map

package/dist/core/chart/ohlcv-session-store.js.map

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

package/dist/core/chart/ohlcv-window-expectations.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+export type LookbackSpan = {
+    label: string;
+    spanSec: number;
+};
+export declare const OhlcvFetchContextSchema: z.ZodObject<{
+    interval: z.ZodNullable<z.ZodString>;
+    intervalSec: z.ZodNullable<z.ZodNumber>;
+    lookbackDays: z.ZodNullable<z.ZodNumber>;
+    lookbackHours: z.ZodNullable<z.ZodNumber>;
+    lookbackLabel: z.ZodNullable<z.ZodString>;
+    coin: z.ZodNullable<z.ZodString>;
+    declaredBarCount: z.ZodNullable<z.ZodNumber>;
+    windowExpectedBarCount: z.ZodNullable<z.ZodNumber>;
+    expectedBarCount: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+export type OhlcvFetchContext = z.infer<typeof OhlcvFetchContextSchema>;
+export declare const OhlcvWindowExpectationSchema: z.ZodObject<{
+    interval: z.ZodNullable<z.ZodString>;
+    intervalSec: z.ZodNullable<z.ZodNumber>;
+    lookbackLabel: z.ZodNullable<z.ZodString>;
+    expectedBarCount: z.ZodNullable<z.ZodNumber>;
+    minBarCount: z.ZodNullable<z.ZodNumber>;
+    sources: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type OhlcvWindowExpectation = z.infer<typeof OhlcvWindowExpectationSchema>;
+/** Parse bar interval from title: 15m, 4H, 1d, 1w, etc. (not lookback phrases). */
+export declare function parseIntervalLabelFromChartTitle(title: string): string | null;
+/** Parse calendar lookback from title: 7d, 24h, 4 weeks, 6 months, etc. */
+export declare function parseLookbackSpanFromChartTitle(title: string): LookbackSpan | null;
+/** @deprecated Use parseLookbackSpanFromChartTitle — returns whole days when span is day-based. */
+export declare function parseLookbackDaysFromChartTitle(title: string): number | null;
+/** Read interval, lookback, and expected bar count from any vendor fetch payload. */
+export declare function resolveOhlcvFetchContext(toolResult: unknown): OhlcvFetchContext | null;
+/** Merge title + fetch metadata into one bar-count expectation (any interval × any lookback). */
+export declare function resolveOhlcvWindowExpectation(title: string | undefined, toolResult: unknown | undefined): OhlcvWindowExpectation | null;
+export declare function formatWindowExpectation(expectation: OhlcvWindowExpectation): string;
+/** Hard-fail when title interval ≠ fetch interval. */
+export declare function rejectIntervalMismatchTitleVsFetch(title: string, toolResult: unknown | undefined): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Hard-fail when chart title lookback ≠ fetch lookback/window (e.g. title "3d" after lookbackDays: 7). */
+export declare function rejectTitleLookbackMismatchVsFetch(title: string, toolResult: unknown | undefined): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Hard-fail when loaded bar count is far below title/fetch window (truncated or wrong refetch). */
+export declare function rejectOhlcvWindowBarCountMismatch(title: string | undefined, barCount: number, toolResult: unknown | undefined): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Interval + bar-count checks for chart and analyze (all vendors, all intervals/lookbacks). */
+export declare function rejectOhlcvWindowMismatch(input: {
+    title?: string;
+    barCount: number;
+    toolResult?: unknown;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** @deprecated Use rejectOhlcvWindowBarCountMismatch */
+export declare function rejectTitleLookbackBarCountMismatch(title: string, barCount: number, toolResult: unknown | undefined): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+//# sourceMappingURL=ohlcv-window-expectations.d.ts.map

package/dist/core/chart/ohlcv-window-expectations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcv-window-expectations.d.ts","sourceRoot":"","sources":["../../../src/core/chart/ohlcv-window-expectations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAQtB,MAAM,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;kBAY1B,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,4BAA4B;;;;;;;kBAS/B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AA4ClF,mFAAmF;AACnF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsD7E;AAED,2EAA2E;AAC3E,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAwElF;AA0BD,mGAAmG;AACnG,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM5E;AAgCD,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAgCtF;AAED,iGAAiG;AACjG,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,UAAU,EAAE,OAAO,GAAG,SAAS,GAC7B,sBAAsB,GAAG,IAAI,CAkD/B;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,sBAAsB,GAAG,MAAM,CAInF;AAED,sDAAsD;AACtD,wBAAgB,kCAAkC,CACjD,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,OAAO,GAAG,SAAS,GAC7B;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAyB1C;AAED,2GAA2G;AAC3G,wBAAgB,kCAAkC,CACjD,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,OAAO,GAAG,SAAS,GAC7B;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAmD1C;AAED,oGAAoG;AACpG,wBAAgB,iCAAiC,CAChD,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,OAAO,GAAG,SAAS,GAC7B;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAe1C;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAY3C;AAED,wDAAwD;AACxD,wBAAgB,mCAAmC,CAClD,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,OAAO,GAAG,SAAS,GAC7B;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAE1C"}