@continuumdao/continuum-node-sdk 1.3.25 → 1.3.28

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

@@ -0,0 +1,31 @@
+import type { MomentumTradeSetup } from './trade-setups/momentum-trade-setup.js';
+export type MomentumHighlight = {
+    summary: string;
+    rsiPeriod: number;
+    rsiValue: number | null;
+    rsiZone: 'overbought' | 'oversold' | 'neutral';
+    macd: number | null;
+    macdSignal: number | null;
+    macdHistogram: number | null;
+    macdCrossover: 'bullish' | 'bearish' | 'none';
+    side: 'long' | 'short' | 'neutral';
+    status: 'clear' | 'unclear';
+    confidence: number;
+    conditionalNote: string;
+    unclearReason?: string;
+};
+export declare function buildMomentumHighlight(input: {
+    rsi: {
+        period: number;
+        value: number | null;
+        zone: 'overbought' | 'oversold' | 'neutral';
+    };
+    macd: {
+        macd: number | null;
+        signal: number | null;
+        histogram: number | null;
+        crossover: 'bullish' | 'bearish' | 'none';
+    };
+    setup: MomentumTradeSetup | null;
+}): MomentumHighlight;
+//# sourceMappingURL=momentum-highlight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"momentum-highlight.d.ts","sourceRoot":"","sources":["../../../../src/core/chart/analysis/momentum-highlight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,wCAAwC,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAoCF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,GAAG,EAAE;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;KAAC,CAAC;IACzF,IAAI,EAAE;QACL,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;KAC1C,CAAC;IACF,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACjC,GAAG,iBAAiB,CA8BpB"}

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

@@ -0,0 +1,59 @@
+function rsiZoneLabel(zone) {
+    if (zone === 'overbought') {
+        return 'overbought';
+    }
+    if (zone === 'oversold') {
+        return 'oversold';
+    }
+    return 'neutral';
+}
+function crossoverLabel(crossover) {
+    if (crossover === 'bullish') {
+        return 'bullish crossover';
+    }
+    if (crossover === 'bearish') {
+        return 'bearish crossover';
+    }
+    return 'no crossover';
+}
+function sideLabel(side) {
+    if (side === 'long') {
+        return 'Long';
+    }
+    if (side === 'short') {
+        return 'Short';
+    }
+    return 'Neutral';
+}
+function formatOptional(value, digits = 2) {
+    return value != null && Number.isFinite(value) ? value.toFixed(digits) : 'n/a';
+}
+export function buildMomentumHighlight(input) {
+    const setup = input.setup;
+    const side = setup?.side ?? 'neutral';
+    const status = setup?.status ?? 'unclear';
+    const confidence = setup?.confidence ?? 0.35;
+    const conditionalNote = setup?.conditionalNote ?? 'Momentum is neutral — no conditional entry.';
+    const rsiPart = input.rsi.value != null
+        ? `RSI(${input.rsi.period}) ${input.rsi.value.toFixed(1)} — ${rsiZoneLabel(input.rsi.zone)}`
+        : `RSI(${input.rsi.period}) unavailable`;
+    const macdPart = `MACD ${formatOptional(input.macd.macd)} / signal ${formatOptional(input.macd.signal)} (${crossoverLabel(input.macd.crossover)})`;
+    const biasPart = `${sideLabel(side)} bias — ${status}`;
+    const summary = `${rsiPart}. ${macdPart}. ${biasPart}. ${conditionalNote}`;
+    return {
+        summary,
+        rsiPeriod: input.rsi.period,
+        rsiValue: input.rsi.value,
+        rsiZone: input.rsi.zone,
+        macd: input.macd.macd,
+        macdSignal: input.macd.signal,
+        macdHistogram: input.macd.histogram,
+        macdCrossover: input.macd.crossover,
+        side,
+        status,
+        confidence,
+        conditionalNote,
+        ...(setup?.unclearReason ? { unclearReason: setup.unclearReason } : {}),
+    };
+}
+//# sourceMappingURL=momentum-highlight.js.map

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

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

package/dist/core/chart/analysis/ohlcv-input.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/** Shared OHLCV tool fields — pass fetch object once; follow-ups use title + ohlcvDigest. */
+export declare const OhlcvToolInputSchema: z.ZodObject<{
+    toolResult: z.ZodOptional<z.ZodUnknown>;
+    rows: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    title: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    ohlcvDigest: z.ZodOptional<z.ZodString>;
+    mergeLive: z.ZodOptional<z.ZodBoolean>;
+    liveTick: z.ZodOptional<z.ZodObject<{
+        timeMs: z.ZodNumber;
+        price: z.ZodNumber;
+        volume: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    allowRowsOnly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type OhlcvToolInput = z.infer<typeof OhlcvToolInputSchema>;
+/** Parse stringified JSON rows before zod validation. toolResult must stay an object (session bind handles follow-ups). */
+export declare function preprocessOhlcvToolInput(raw: unknown): unknown;
+export declare function rejectStringToolResultInput(input: {
+    toolResult?: unknown;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function barsFromOhlcvToolInput(input: {
+    toolResult?: unknown;
+    rows?: unknown[];
+    executeResult?: unknown;
+    fetchResult?: unknown;
+    maxPoints?: number;
+}): Record<string, unknown>[];
+export declare function missingOhlcvBarsReason(input: {
+    toolResult?: unknown;
+    rows?: unknown;
+}): string;
+//# sourceMappingURL=ohlcv-input.d.ts.map

package/dist/core/chart/analysis/ohlcv-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcv-input.d.ts","sourceRoot":"","sources":["../../../../src/core/chart/analysis/ohlcv-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAOtB,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;kBAevB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,2HAA2H;AAC3H,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAkB9D;AAED,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAC,GAC3B;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAY1C;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAmB5B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf,GAAG,MAAM,CAiBT"}

package/dist/core/chart/analysis/ohlcv-input.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { extractOhlcvBarsFromUnknown, parseJsonIfString } from '../fetch-result.js';
+import { CHART_MISSING_OHLCV_DATA_REASON } from '../ohlcv-integrity-messages.js';
+import { ChartLiveTickSchema } from '../live/schemas.js';
+import { invalidStringToolResultReason, isUnparsedJsonString } from '../ohlcv-window.js';
+import { sanitizeOhlcvBarRows } from '../ohlcv-window.js';
+/** Shared OHLCV tool fields — pass fetch object once; follow-ups use title + ohlcvDigest. */
+export const OhlcvToolInputSchema = 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(),
+    /** Bound-session handoff — pass with title instead of re-pasting fetch JSON. */
+    ohlcvDigest: z.string().trim().min(1).max(512).optional(),
+    /** When true (default), merge a live tick into the last bar for current-market analysis. Set false for historical backtests. */
+    mergeLive: z.boolean().optional(),
+    /** Optional pre-fetched tick (e.g. from chart live poll). Skips network fetch when set. */
+    liveTick: ChartLiveTickSchema.optional(),
+    /** Test/synthetic data only — MCP agents must pass fetch `toolResult`. */
+    allowRowsOnly: z.boolean().optional(),
+})
+    .strict();
+/** Parse stringified JSON rows before zod validation. toolResult must stay an object (session bind handles follow-ups). */
+export function preprocessOhlcvToolInput(raw) {
+    if (typeof raw !== 'object' || raw == null) {
+        return raw;
+    }
+    const input = { ...raw };
+    for (const key of ['rows', 'candles']) {
+        if (!(key in input) || input[key] == null) {
+            continue;
+        }
+        const parsed = parseJsonIfString(input[key]);
+        if (Array.isArray(parsed)) {
+            input.rows = parsed;
+            if (key === 'candles') {
+                delete input.candles;
+            }
+        }
+    }
+    return input;
+}
+export function rejectStringToolResultInput(input) {
+    if (input.toolResult == null || typeof input.toolResult !== 'string') {
+        return { ok: true };
+    }
+    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.',
+    };
+}
+export function barsFromOhlcvToolInput(input) {
+    const extractOptions = { maxPoints: input.maxPoints ?? 10_000 };
+    const fromTool = (() => {
+        for (const source of [input.toolResult, input.executeResult, input.fetchResult]) {
+            if (source == null) {
+                continue;
+            }
+            const bars = extractOhlcvBarsFromUnknown(source, extractOptions);
+            if (bars?.length) {
+                return bars;
+            }
+        }
+        return [];
+    })();
+    const raw = (fromTool.length ? fromTool : null) ??
+        (input.rows?.length ? input.rows : null) ??
+        [];
+    return sanitizeOhlcvBarRows(raw);
+}
+export function missingOhlcvBarsReason(input) {
+    if (typeof input.toolResult === 'string') {
+        const trimmed = input.toolResult.trim();
+        if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+            return ('Could not extract OHLCV bars from string `toolResult` (JSON may be truncated). ' +
+                'Pass the full fetch MCP JSON or pass `rows` as a candle array (not a string).');
+        }
+    }
+    if (typeof input.rows === 'string') {
+        return ('`rows` was a JSON string but did not parse to a candle array. ' +
+            'Pass `rows` as an array or use full fetch JSON as `toolResult`.');
+    }
+    return CHART_MISSING_OHLCV_DATA_REASON;
+}
+//# sourceMappingURL=ohlcv-input.js.map

package/dist/core/chart/analysis/ohlcv-input.js.map

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

package/dist/core/chart/analysis/ohlcv-live-merge.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { type ChartLiveTick } from '../live/schemas.js';
+import { type OhlcvToolInput } from './ohlcv-input.js';
+import type { SdkResult } from '../../result.js';
+import type { OhlcvFingerprint } from '../ohlcv-integrity.js';
+export declare const OhlcvLiveMergeMetaSchema: z.ZodObject<{
+    attempted: z.ZodBoolean;
+    merged: z.ZodBoolean;
+    livePrice: z.ZodOptional<z.ZodNumber>;
+    liveTickTimeMs: z.ZodOptional<z.ZodNumber>;
+    priorLastClose: z.ZodOptional<z.ZodNumber>;
+    barRolledOver: z.ZodOptional<z.ZodBoolean>;
+    skippedReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type OhlcvLiveMergeMeta = z.infer<typeof OhlcvLiveMergeMetaSchema>;
+export declare const OhlcvAnalysisInputSchema: z.ZodObject<{
+    mergeLive: z.ZodOptional<z.ZodBoolean>;
+    liveTick: z.ZodOptional<z.ZodObject<{
+        timeMs: z.ZodNumber;
+        price: z.ZodNumber;
+        volume: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare function shouldMergeLiveForAnalysis(bars: Record<string, unknown>[], toolResult: unknown | undefined, mergeLive: boolean | undefined): {
+    merge: boolean;
+    skippedReason?: string;
+};
+export declare function prepareOhlcvBarsForAnalysis(input: OhlcvToolInput & {
+    executeResult?: unknown;
+    fetchResult?: unknown;
+    maxPoints?: number;
+    mergeLive?: boolean;
+    liveTick?: ChartLiveTick;
+}): Promise<SdkResult<{
+    bars: Record<string, unknown>[];
+    liveMerge: OhlcvLiveMergeMeta;
+    fingerprint: OhlcvFingerprint | null;
+}>>;
+//# sourceMappingURL=ohlcv-live-merge.d.ts.map

package/dist/core/chart/analysis/ohlcv-live-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcv-live-merge.d.ts","sourceRoot":"","sources":["../../../../src/core/chart/analysis/ohlcv-live-merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAMtB,OAAO,EAAsB,KAAK,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAG3E,OAAO,EAAsD,KAAK,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAC1G,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;;kBAU3B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,wBAAwB;;;;;;;kBAK3B,CAAC;AAEX,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,SAAS,EAAE,OAAO,GAAG,SAAS,GAC5B;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAC,CAgC1C;AAED,wBAAsB,2BAA2B,CAChD,KAAK,EAAE,cAAc,GAAG;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,aAAa,CAAC;CACzB,GACC,OAAO,CACT,SAAS,CAAC;IACT,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACrC,CAAC,CACF,CAyGA"}

package/dist/core/chart/analysis/ohlcv-live-merge.js

@@ -0,0 +1,158 @@
+import { z } from 'zod';
+import { coerceFiniteNumber } from '../point-normalize.js';
+import { extractLiveBindingFromFetchPayload } from '../live/binding-extract.js';
+import { barTimeSecFromRow } from '../live/bar-merge.js';
+import { fetchChartLiveTick } from '../live/fetch-tick.js';
+import { inferBarPeriodSec, mergeLiveTickIntoBars } from '../live/merge-tick.js';
+import { ChartLiveTickSchema } from '../live/schemas.js';
+import { extractOhlcvFetchWindow, validateOhlcvBarsFromToolResult } from '../ohlcv-window.js';
+import { runOhlcvIntegrityPipeline, rejectOhlcvWindowMismatch } from '../ohlcv-integrity.js';
+import { barsFromOhlcvToolInput, rejectStringToolResultInput } from './ohlcv-input.js';
+export const OhlcvLiveMergeMetaSchema = z
+    .object({
+    attempted: z.boolean(),
+    merged: z.boolean(),
+    livePrice: z.number().optional(),
+    liveTickTimeMs: z.number().optional(),
+    priorLastClose: z.number().optional(),
+    barRolledOver: z.boolean().optional(),
+    skippedReason: z.string().optional(),
+})
+    .strict();
+export const OhlcvAnalysisInputSchema = z
+    .object({
+    mergeLive: z.boolean().optional(),
+    liveTick: ChartLiveTickSchema.optional(),
+})
+    .strict();
+export function shouldMergeLiveForAnalysis(bars, toolResult, mergeLive) {
+    if (mergeLive === false) {
+        return { merge: false, skippedReason: 'mergeLive disabled (historical or explicit opt-out)' };
+    }
+    const binding = extractLiveBindingFromFetchPayload(toolResult);
+    if (!binding) {
+        return { merge: false, skippedReason: 'no live binding for this data source' };
+    }
+    const barPeriodSec = inferBarPeriodSec(bars) ?? binding.bucketSec;
+    const window = extractOhlcvFetchWindow(toolResult);
+    if (window != null) {
+        const ageMs = Date.now() - window.endTimeMs;
+        if (ageMs > barPeriodSec * 2_000) {
+            return {
+                merge: false,
+                skippedReason: 'historical fetch window (endTimeMs is in the past)',
+            };
+        }
+    }
+    const lastBar = bars[bars.length - 1];
+    const lastSec = lastBar ? barTimeSecFromRow(lastBar) : null;
+    if (lastSec != null) {
+        const tickSec = Math.floor(Date.now() / 1000);
+        if (tickSec >= lastSec + barPeriodSec * 2) {
+            return {
+                merge: false,
+                skippedReason: 'OHLCV tail is more than one bar behind live — pass the same chart fetch toolResult; only re-fetch if the operator changed symbol, interval, or lookback',
+            };
+        }
+    }
+    return { merge: true };
+}
+export async function prepareOhlcvBarsForAnalysis(input) {
+    const stringReject = rejectStringToolResultInput(input);
+    if (!stringReject.ok) {
+        return stringReject;
+    }
+    const bars = barsFromOhlcvToolInput(input);
+    if (!bars.length) {
+        return {
+            ok: false,
+            reason: 'no OHLCV bars',
+        };
+    }
+    const integrity = runOhlcvIntegrityPipeline(bars, input);
+    if (!integrity.ok) {
+        return integrity;
+    }
+    if (input.toolResult != null) {
+        const shapeCheck = validateOhlcvBarsFromToolResult(bars, input.toolResult, input.title);
+        if (!shapeCheck.ok) {
+            return shapeCheck;
+        }
+    }
+    if (input.title?.trim()) {
+        const windowCheck = rejectOhlcvWindowMismatch({
+            title: input.title.trim(),
+            barCount: bars.length,
+            toolResult: input.toolResult,
+        });
+        if (!windowCheck.ok) {
+            return windowCheck;
+        }
+    }
+    const decision = shouldMergeLiveForAnalysis(bars, input.toolResult, input.mergeLive);
+    if (!decision.merge) {
+        return {
+            ok: true,
+            data: {
+                bars,
+                liveMerge: {
+                    attempted: decision.skippedReason !== 'mergeLive disabled (historical or explicit opt-out)',
+                    merged: false,
+                    skippedReason: decision.skippedReason,
+                },
+                fingerprint: integrity.data.fingerprint,
+            },
+        };
+    }
+    const binding = extractLiveBindingFromFetchPayload(input.toolResult);
+    const priorLastClose = coerceFiniteNumber(bars[bars.length - 1]?.close) ?? undefined;
+    let tick = input.liveTick;
+    if (!tick) {
+        try {
+            tick = (await fetchChartLiveTick(binding)) ?? undefined;
+        }
+        catch {
+            tick = undefined;
+        }
+    }
+    if (!tick) {
+        return {
+            ok: true,
+            data: {
+                bars,
+                liveMerge: {
+                    attempted: true,
+                    merged: false,
+                    priorLastClose,
+                    skippedReason: 'live tick fetch failed — quote priorLastClose or re-fetch OHLCV',
+                },
+                fingerprint: integrity.data.fingerprint,
+            },
+        };
+    }
+    const { bars: merged, barRolledOver } = mergeLiveTickIntoBars(bars, tick, {
+        bucketSec: binding.bucketSec,
+        maxPoints: input.maxPoints ?? 10_000,
+    });
+    const mergedIntegrity = runOhlcvIntegrityPipeline(merged, { ...input, allowRowsOnly: true });
+    if (!mergedIntegrity.ok) {
+        return mergedIntegrity;
+    }
+    return {
+        ok: true,
+        data: {
+            bars: merged,
+            liveMerge: {
+                attempted: true,
+                merged: true,
+                livePrice: tick.price,
+                liveTickTimeMs: tick.timeMs,
+                priorLastClose,
+                barRolledOver,
+            },
+            // Fetch identity — unchanged by live tick merge (matches meta.sessionBind / chart fingerprint).
+            fingerprint: integrity.data.fingerprint,
+        },
+    };
+}
+//# sourceMappingURL=ohlcv-live-merge.js.map

package/dist/core/chart/analysis/ohlcv-live-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcv-live-merge.js","sourceRoot":"","sources":["../../../../src/core/chart/analysis/ohlcv-live-merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAC,kCAAkC,EAAC,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAC,iBAAiB,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAC,mBAAmB,EAAqB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAC,uBAAuB,EAAE,+BAA+B,EAAC,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAC,yBAAyB,EAAE,yBAAyB,EAAC,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAC,sBAAsB,EAAE,2BAA2B,EAAsB,MAAM,kBAAkB,CAAC;AAI1G,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACvC,MAAM,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAIX,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACvC,MAAM,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAEX,MAAM,UAAU,0BAA0B,CACzC,IAA+B,EAC/B,UAA+B,EAC/B,SAA8B;IAE9B,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,qDAAqD,EAAC,CAAC;IAC7F,CAAC;IACD,MAAM,OAAO,GAAG,kCAAkC,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,sCAAsC,EAAC,CAAC;IAC9E,CAAC;IACD,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC;IAClE,MAAM,MAAM,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC;QAC5C,IAAI,KAAK,GAAG,YAAY,GAAG,KAAK,EAAE,CAAC;YAClC,OAAO;gBACN,KAAK,EAAE,KAAK;gBACZ,aAAa,EAAE,oDAAoD;aACnE,CAAC;QACH,CAAC;IACF,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9C,IAAI,OAAO,IAAI,OAAO,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC;YAC3C,OAAO;gBACN,KAAK,EAAE,KAAK;gBACZ,aAAa,EACZ,yJAAyJ;aAC1J,CAAC;QACH,CAAC;IACF,CAAC;IACD,OAAO,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAChD,KAMC;IAQD,MAAM,YAAY,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO;YACN,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,eAAe;SACvB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,+BAA+B,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACxF,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACpB,OAAO,UAAU,CAAC;QACnB,CAAC;IACF,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,yBAAyB,CAAC;YAC7C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;YACzB,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC5B,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;YACrB,OAAO,WAAW,CAAC;QACpB,CAAC;IACF,CAAC;IAED,MAAM,QAAQ,GAAG,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACrF,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO;YACN,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACL,IAAI;gBACJ,SAAS,EAAE;oBACV,SAAS,EAAE,QAAQ,CAAC,aAAa,KAAK,qDAAqD;oBAC3F,MAAM,EAAE,KAAK;oBACb,aAAa,EAAE,QAAQ,CAAC,aAAa;iBACrC;gBACD,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW;aACvC;SACD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,kCAAkC,CAAC,KAAK,CAAC,UAAU,CAAE,CAAC;IACtE,MAAM,cAAc,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC;IACrF,IAAI,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,IAAI,CAAC;YACJ,IAAI,GAAG,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,GAAG,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,OAAO;YACN,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACL,IAAI;gBACJ,SAAS,EAAE;oBACV,SAAS,EAAE,IAAI;oBACf,MAAM,EAAE,KAAK;oBACb,cAAc;oBACd,aAAa,EAAE,iEAAiE;iBAChF;gBACD,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW;aACvC;SACD,CAAC;IACH,CAAC;IAED,MAAM,EAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAC,GAAG,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE;QACvE,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,MAAM;KACpC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,yBAAyB,CAAC,MAAM,EAAE,EAAC,GAAG,KAAK,EAAE,aAAa,EAAE,IAAI,EAAC,CAAC,CAAC;IAC3F,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;QACzB,OAAO,eAAe,CAAC;IACxB,CAAC;IAED,OAAO;QACN,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACL,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE;gBACV,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,IAAI;gBACZ,SAAS,EAAE,IAAI,CAAC,KAAK;gBACrB,cAAc,EAAE,IAAI,CAAC,MAAM;gBAC3B,cAAc;gBACd,aAAa;aACb;YACD,gGAAgG;YAChG,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW;SACvC;KACD,CAAC;AACH,CAAC"}

package/dist/core/chart/analysis/range-volatility-highlight.d.ts

@@ -0,0 +1,31 @@
+import type { RangeVolatilityTradeSetup } from './trade-setups/range-volatility-trade-setup.js';
+export type RangeVolatilityHighlight = {
+    summary: string;
+    rangeHigh: number;
+    rangeLow: number;
+    rangePct: number;
+    atr: number | null;
+    atrPct: number | null;
+    compression: 'compressing' | 'expanding' | 'stable';
+    recentRangePct: number;
+    priorRangePct: number;
+    rangePosition: number;
+    side: 'long' | 'short' | 'neutral';
+    status: 'clear' | 'unclear';
+    confidence: number;
+    conditionalNote: string;
+    chartDrawingHint?: string;
+    unclearReason?: string;
+};
+export declare function buildRangeVolatilityHighlight(input: {
+    rangeHigh: number;
+    rangeLow: number;
+    rangePct: number;
+    atr: number | null;
+    atrPct: number | null;
+    recentRangePct: number;
+    priorRangePct: number;
+    compression: 'compressing' | 'expanding' | 'stable';
+    setup: RangeVolatilityTradeSetup | null;
+}): RangeVolatilityHighlight;
+//# sourceMappingURL=range-volatility-highlight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"range-volatility-highlight.d.ts","sourceRoot":"","sources":["../../../../src/core/chart/analysis/range-volatility-highlight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,gDAAgD,CAAC;AAE9F,MAAM,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAsBF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;CACxC,GAAG,wBAAwB,CAqC3B"}

package/dist/core/chart/analysis/range-volatility-highlight.js

@@ -0,0 +1,53 @@
+function compressionLabel(compression) {
+    if (compression === 'compressing') {
+        return 'compressing';
+    }
+    if (compression === 'expanding') {
+        return 'expanding';
+    }
+    return 'stable';
+}
+function sideLabel(side) {
+    if (side === 'long') {
+        return 'Long';
+    }
+    if (side === 'short') {
+        return 'Short';
+    }
+    return 'Neutral';
+}
+export function buildRangeVolatilityHighlight(input) {
+    const setup = input.setup;
+    const side = setup?.side ?? 'neutral';
+    const status = setup?.status ?? 'unclear';
+    const confidence = setup?.confidence ?? 0.35;
+    const rangePosition = setup?.rangePosition ?? 0.5;
+    const conditionalNote = setup?.conditionalNote ??
+        'Range/volatility is neutral — wait for compression breakout or range-edge fade.';
+    const atrPart = input.atrPct != null
+        ? `ATR ~${input.atrPct.toFixed(2)}% of price`
+        : input.atr != null
+            ? `ATR ${input.atr.toFixed(2)}`
+            : 'ATR n/a';
+    const summary = `${compressionLabel(input.compression)} volatility · range ${input.rangePct.toFixed(1)}% (${input.rangeLow.toFixed(2)}–${input.rangeHigh.toFixed(2)}) · ${atrPart}. ${sideLabel(side)} — ${status}. ${conditionalNote}`;
+    const chartDrawingHint = 'Optional chart overlay: on a prepared chart, apply horizontal levels at rangeHigh and rangeLow from this analysis (no dedicated draw button — analysis does not update the chart by itself).';
+    return {
+        summary,
+        rangeHigh: input.rangeHigh,
+        rangeLow: input.rangeLow,
+        rangePct: input.rangePct,
+        atr: input.atr,
+        atrPct: input.atrPct,
+        compression: input.compression,
+        recentRangePct: input.recentRangePct,
+        priorRangePct: input.priorRangePct,
+        rangePosition,
+        side,
+        status,
+        confidence,
+        conditionalNote,
+        chartDrawingHint,
+        ...(setup?.unclearReason ? { unclearReason: setup.unclearReason } : {}),
+    };
+}
+//# sourceMappingURL=range-volatility-highlight.js.map

package/dist/core/chart/analysis/range-volatility-highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-volatility-highlight.js","sourceRoot":"","sources":["../../../../src/core/chart/analysis/range-volatility-highlight.ts"],"names":[],"mappings":"AAqBA,SAAS,gBAAgB,CAAC,WAAoD;IAC7E,IAAI,WAAW,KAAK,aAAa,EAAE,CAAC;QACnC,OAAO,aAAa,CAAC;IACtB,CAAC;IACD,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC;IACpB,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,SAAS,CAAC,IAAsC;IACxD,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,6BAA6B,CAAC,KAU7C;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,UAAU,GAAG,KAAK,EAAE,UAAU,IAAI,IAAI,CAAC;IAC7C,MAAM,aAAa,GAAG,KAAK,EAAE,aAAa,IAAI,GAAG,CAAC;IAClD,MAAM,eAAe,GACpB,KAAK,EAAE,eAAe;QACtB,iFAAiF,CAAC;IACnF,MAAM,OAAO,GACZ,KAAK,CAAC,MAAM,IAAI,IAAI;QACnB,CAAC,CAAC,QAAQ,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY;QAC7C,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI;YAClB,CAAC,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YAC/B,CAAC,CAAC,SAAS,CAAC;IACf,MAAM,OAAO,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,uBAAuB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,KAAK,SAAS,CAAC,IAAI,CAAC,MAAM,MAAM,KAAK,eAAe,EAAE,CAAC;IACxO,MAAM,gBAAgB,GACrB,8LAA8L,CAAC;IAEhM,OAAO;QACN,OAAO;QACP,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,aAAa;QACb,IAAI;QACJ,MAAM;QACN,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/time-series-analyze-tools.d.ts

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import type { SdkResult } from '../../result.js';
+export declare const AnalyzeTimeSeriesTrendInputSchema: z.ZodObject<{
+    toolResult: z.ZodOptional<z.ZodUnknown>;
+    rows: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    title: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const AnalyzeTimeSeriesTrendOutputSchema: z.ZodObject<{
+    analysis: z.ZodObject<{
+        bias: z.ZodEnum<{
+            flat: "flat";
+            rising: "rising";
+            falling: "falling";
+        }>;
+        slopePct: z.ZodNumber;
+        firstValue: z.ZodNumber;
+        lastValue: z.ZodNumber;
+        changePct: z.ZodNumber;
+        extrema: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                trough: "trough";
+                peak: "peak";
+            }>;
+            timeSec: z.ZodNumber;
+            value: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    meta: z.ZodObject<{
+        pointCount: z.ZodNumber;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare function analyzeTimeSeriesTrend(input: unknown): SdkResult<z.infer<typeof AnalyzeTimeSeriesTrendOutputSchema>>;
+export declare const AnalyzeTimeSeriesMomentumInputSchema: z.ZodObject<{
+    toolResult: z.ZodOptional<z.ZodUnknown>;
+    rows: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    title: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    rsiPeriod: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const AnalyzeTimeSeriesMomentumOutputSchema: z.ZodObject<{
+    analysis: z.ZodObject<{
+        rsi: z.ZodObject<{
+            period: z.ZodNumber;
+            value: z.ZodNullable<z.ZodNumber>;
+            zone: z.ZodEnum<{
+                neutral: "neutral";
+                overbought: "overbought";
+                oversold: "oversold";
+            }>;
+        }, z.core.$strict>;
+        roc: z.ZodObject<{
+            period: z.ZodNumber;
+            valuePct: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    meta: z.ZodObject<{
+        pointCount: z.ZodNumber;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare function analyzeTimeSeriesMomentum(input: unknown): SdkResult<z.infer<typeof AnalyzeTimeSeriesMomentumOutputSchema>>;
+export declare const AnalyzeTimeSeriesStatsInputSchema: z.ZodObject<{
+    toolResult: z.ZodOptional<z.ZodUnknown>;
+    rows: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    title: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const AnalyzeTimeSeriesStatsOutputSchema: z.ZodObject<{
+    analysis: z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        mean: z.ZodNumber;
+        firstValue: z.ZodNumber;
+        lastValue: z.ZodNumber;
+        changePct: z.ZodNumber;
+        returnVolatilityPct: z.ZodNullable<z.ZodNumber>;
+        recentRangePct: z.ZodNumber;
+        priorRangePct: z.ZodNumber;
+        compression: z.ZodEnum<{
+            compressing: "compressing";
+            expanding: "expanding";
+            stable: "stable";
+        }>;
+    }, z.core.$strict>;
+    meta: z.ZodObject<{
+        pointCount: z.ZodNumber;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare function analyzeTimeSeriesStats(input: unknown): SdkResult<z.infer<typeof AnalyzeTimeSeriesStatsOutputSchema>>;
+/** When input is line-only, OHLCV tools should direct callers to time-series tools. */
+export declare function ohlcvToolRejectIfLineOnly(input: {
+    toolResult?: unknown;
+    rows?: unknown[];
+}): SdkResult<never> | null;
+//# sourceMappingURL=time-series-analyze-tools.d.ts.map