@continuumdao/continuum-node-sdk 1.3.25 → 1.3.27

package/dist/core/chart/analysis/analysis-meta.d.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { type ChartOhlcvSummary } from '../chart-ohlcv-summary.js';
+import type { OhlcvLiveMergeMeta } from './ohlcv-live-merge.js';
+import type { OhlcvFingerprint } from '../ohlcv-integrity.js';
+export declare const OhlcvSessionBindHintSchema: z.ZodObject<{
+    ohlcvDigest: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    reuseInput: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        ohlcvDigest: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** One-line policy on tool responses — full rules live in chart_analysis_docs. */
+export declare const AGENT_OHLCV_DATA_POLICY: string;
+/** Long-form policy for markdown resources and skills. */
+export declare const AGENT_OHLCV_DATA_POLICY_DOCS: string;
+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 declare const OhlcvAnalysisMetaSchema: z.ZodObject<{
+    barCount: z.ZodNumber;
+    title: z.ZodOptional<z.ZodString>;
+    ohlcvSummary: z.ZodOptional<z.ZodObject<{
+        barCount: z.ZodNumber;
+        timeStartSec: z.ZodNumber;
+        timeEndSec: z.ZodNumber;
+        low: z.ZodNumber;
+        high: z.ZodNumber;
+        lastClose: z.ZodNumber;
+    }, z.core.$strict>>;
+    ohlcvFingerprint: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        barCount: z.ZodNumber;
+        timeStartSec: z.ZodNumber;
+        timeEndSec: z.ZodNumber;
+        low: z.ZodNumber;
+        high: z.ZodNumber;
+        lastClose: z.ZodNumber;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    fetchContext: z.ZodOptional<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>>;
+    windowExpectation: z.ZodOptional<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>>;
+    liveMerge: z.ZodOptional<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>>;
+    patternsScanned: z.ZodOptional<z.ZodNumber>;
+    dataPolicy: z.ZodString;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sessionBind: z.ZodOptional<z.ZodObject<{
+        ohlcvDigest: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        reuseInput: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            ohlcvDigest: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type OhlcvAnalysisMeta = z.infer<typeof OhlcvAnalysisMetaSchema>;
+export declare function buildOhlcvAnalysisMeta(bars: Record<string, unknown>[], options?: {
+    title?: string;
+    toolResult?: unknown;
+    patternsScanned?: number;
+    liveMerge?: OhlcvLiveMergeMeta;
+    ohlcvFingerprint?: OhlcvFingerprint | null;
+    extraWarnings?: string[];
+}): OhlcvAnalysisMeta;
+export declare function ohlcvSummaryFromBars(bars: Record<string, unknown>[]): ChartOhlcvSummary | null;
+//# sourceMappingURL=analysis-meta.d.ts.map

package/dist/core/chart/analysis/analysis-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-meta.d.ts","sourceRoot":"","sources":["../../../../src/core/chart/analysis/analysis-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAEN,KAAK,iBAAiB,EAEtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AAU5D,eAAO,MAAM,0BAA0B;;;;;;;kBAW7B,CAAC;AAEX,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,QAGoF,CAAC;AAEzH,0DAA0D;AAC1D,eAAO,MAAM,4BAA4B,QAU8F,CAAC;AAExI,eAAO,MAAM,wBAAwB;;;;;;;;kBAU3B,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAc1B,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,OAAO,GAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACJ,iBAAiB,CAyBnB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,iBAAiB,GAAG,IAAI,CAE9F"}

package/dist/core/chart/analysis/analysis-meta.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { ChartOhlcvSummarySchema, summarizeOhlcvBars, } from '../chart-ohlcv-summary.js';
+import { OhlcvFingerprintSchema } from '../ohlcv-integrity.js';
+import { ANALYSIS_FOLLOWUP_SAME_FETCH, OHLCV_TRUNCATION_MYTH } from '../ohlcv-integrity-messages.js';
+import { OhlcvFetchContextSchema, OhlcvWindowExpectationSchema, resolveOhlcvFetchContext, resolveOhlcvWindowExpectation, } from '../ohlcv-window-expectations.js';
+export const OhlcvSessionBindHintSchema = z
+    .object({
+    ohlcvDigest: z.string(),
+    title: z.string().optional(),
+    reuseInput: z
+        .object({
+        title: z.string().optional(),
+        ohlcvDigest: z.string(),
+    })
+        .strict(),
+})
+    .strict();
+/** One-line policy on tool responses — full rules live in chart_analysis_docs. */
+export const AGENT_OHLCV_DATA_POLICY = 'Quote numbers only from this tool JSON. Same fetch → same meta.ohlcvFingerprint.digest (fetch identity; stable with live merge). ' +
+    'When meta.liveMerge.merged, quote meta.ohlcvSummary.lastClose for current price. ' +
+    'Follow-ups: pass `{ title, ohlcvDigest }` from meta.sessionBind — do not re-paste fetch JSON or stringify toolResult.';
+/** Long-form policy for markdown resources and skills. */
+export const AGENT_OHLCV_DATA_POLICY_DOCS = 'Do not invent OHLCV prices, timestamps, volumes, bar counts, highs/lows, or pattern levels. ' +
+    'Quote only values from tool JSON (meta.ohlcvSummary, meta.ohlcvFingerprint, meta.fetchContext, meta.liveMerge, meta.loadStatus, analysis.*, pattern points/levels). ' +
+    'Chart and analyze on the same fetch must share the same meta.ohlcvFingerprint.digest and meta.fetchContext.interval. ' +
+    ANALYSIS_FOLLOWUP_SAME_FETCH +
+    ' ' +
+    OHLCV_TRUNCATION_MYTH +
+    ' ' +
+    'For current-market analysis, meta.liveMerge.merged=true means lastClose includes a live tick; use meta.ohlcvSummary.lastClose. ' +
+    'Never substitute a coarser interval or truncate candles because of bar count or payload size — use meta.windowExpectation and meta.loadStatus for the operator\'s requested interval × lookback. ' +
+    'Never paste reformatted candle tables or prices from memory — re-fetch only when the operator changes symbol, interval, or lookback.';
+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 OhlcvAnalysisMetaSchema = z
+    .object({
+    barCount: z.number().int(),
+    title: z.string().optional(),
+    ohlcvSummary: ChartOhlcvSummarySchema.optional(),
+    ohlcvFingerprint: OhlcvFingerprintSchema.optional(),
+    fetchContext: OhlcvFetchContextSchema.optional(),
+    windowExpectation: OhlcvWindowExpectationSchema.optional(),
+    liveMerge: OhlcvLiveMergeMetaSchema.optional(),
+    patternsScanned: z.number().int().optional(),
+    dataPolicy: z.string(),
+    warnings: z.array(z.string()).optional(),
+    sessionBind: OhlcvSessionBindHintSchema.optional(),
+})
+    .strict();
+export function buildOhlcvAnalysisMeta(bars, options = {}) {
+    const ohlcvSummary = summarizeOhlcvBars(bars) ?? undefined;
+    const fetchContext = options.toolResult != null ? resolveOhlcvFetchContext(options.toolResult) : null;
+    const windowExpectation = resolveOhlcvWindowExpectation(options.title, options.toolResult);
+    const warnings = [...(options.extraWarnings ?? [])];
+    if (options.liveMerge?.merged && options.liveMerge.priorLastClose != null && ohlcvSummary) {
+        warnings.push(`Live tick merged: lastClose updated from ${options.liveMerge.priorLastClose.toFixed(2)} to ${ohlcvSummary.lastClose.toFixed(2)}.`);
+    }
+    else if (options.liveMerge?.skippedReason) {
+        warnings.push(`Live merge skipped: ${options.liveMerge.skippedReason}`);
+    }
+    return {
+        barCount: bars.length,
+        ...(options.title ? { title: options.title } : {}),
+        ...(ohlcvSummary ? { ohlcvSummary } : {}),
+        ...(options.ohlcvFingerprint ? { ohlcvFingerprint: options.ohlcvFingerprint } : {}),
+        ...(fetchContext ? { fetchContext } : {}),
+        ...(windowExpectation ? { windowExpectation } : {}),
+        ...(options.liveMerge ? { liveMerge: options.liveMerge } : {}),
+        ...(options.patternsScanned != null ? { patternsScanned: options.patternsScanned } : {}),
+        dataPolicy: AGENT_OHLCV_DATA_POLICY,
+        ...(warnings.length ? { warnings } : {}),
+    };
+}
+export function ohlcvSummaryFromBars(bars) {
+    return summarizeOhlcvBars(bars);
+}
+//# sourceMappingURL=analysis-meta.js.map

package/dist/core/chart/analysis/analysis-meta.js.map

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