@senpi/trading-runtime 1.0.0

package/dist/scanners/providers/adapter.js

@@ -0,0 +1,227 @@
+import { isRecord, unwrapEnvelope, asString, asNumber } from "../../utils/response.js";
+/** Strictly maps `market_list_instruments` payload into scanner `Instrument[]`. */
+export function normalizeInstruments(raw) {
+    return normalizeInstrumentsWithDiagnostics(raw).value;
+}
+/** Strictly maps `market_list_instruments` payload and reports discarded-row diagnostics. */
+export function normalizeInstrumentsWithDiagnostics(raw) {
+    const diagnostics = createNormalizationDiagnostics();
+    const unwrapped = unwrapEnvelope(raw);
+    if (!isRecord(unwrapped)) {
+        recordIssue(diagnostics, "invalid_payload");
+        return createNormalizationResult([], diagnostics);
+    }
+    const instrumentsRaw = unwrapped.instruments;
+    if (!Array.isArray(instrumentsRaw)) {
+        recordIssue(diagnostics, "missing_instruments_array");
+        return createNormalizationResult([], diagnostics);
+    }
+    const result = [];
+    for (const row of instrumentsRaw) {
+        if (!isRecord(row)) {
+            recordDiscard(diagnostics, "invalid_row_shape");
+            continue;
+        }
+        const name = asString(row.name);
+        const isDelisted = asBoolean(row.is_delisted);
+        const maxLeverage = asNumber(row.max_leverage);
+        const context = isRecord(row.context) ? row.context : null;
+        if (name === null ||
+            isDelisted === null ||
+            maxLeverage === null ||
+            context === null) {
+            recordDiscard(diagnostics, "missing_required_fields");
+            continue;
+        }
+        const markPx = asNumber(context.markPx);
+        const prevDayPx = asNumber(context.prevDayPx);
+        const midPx = asNumber(context.midPx);
+        const dayNtlVlm = asNumber(context.dayNtlVlm);
+        const openInterest = asNumber(context.openInterest);
+        const funding = asNumber(context.funding);
+        if (markPx === null ||
+            prevDayPx === null ||
+            midPx === null ||
+            dayNtlVlm === null ||
+            openInterest === null ||
+            funding === null) {
+            recordDiscard(diagnostics, "invalid_context_fields");
+            continue;
+        }
+        result.push({
+            name,
+            isDelisted,
+            maxLeverage,
+            context: {
+                ...context,
+                markPx,
+                prevDayPx,
+                midPx,
+                dayNtlVlm,
+                openInterest,
+                funding,
+            },
+        });
+        diagnostics.acceptedCount += 1;
+    }
+    return createNormalizationResult(result, diagnostics);
+}
+/** Strictly maps one `market_get_asset_data` payload into scanner `CandleResult`. */
+export function normalizeAssetCandles(raw) {
+    const unwrapped = unwrapEnvelope(raw);
+    if (!isRecord(unwrapped)) {
+        return {
+            candles: {},
+            error: "Invalid asset data payload.",
+        };
+    }
+    const payload = unwrapped;
+    const candleMap = isRecord(payload.candles) ? payload.candles : {};
+    const candles = {};
+    let invalidRows = 0;
+    for (const [timeframe, series] of Object.entries(candleMap)) {
+        if (!Array.isArray(series)) {
+            invalidRows += 1;
+            continue;
+        }
+        const normalized = series
+            .map((row) => normalizeCandleRow(row))
+            .filter((row) => row !== null);
+        invalidRows += series.length - normalized.length;
+        candles[timeframe] = normalized;
+    }
+    const providerError = typeof payload.error === "string" ? payload.error : undefined;
+    const parseError = invalidRows > 0
+        ? `Discarded ${invalidRows} candle rows due to invalid shape.`
+        : undefined;
+    return {
+        candles,
+        error: [providerError, parseError].filter(Boolean).join(" | ") || undefined,
+    };
+}
+/** Strictly maps `leaderboard_get_markets` payload into scanner `SmMarket[]`. */
+export function normalizeSmMarkets(raw) {
+    return normalizeSmMarketsWithDiagnostics(raw).value;
+}
+/** Strictly maps `leaderboard_get_markets` payload and reports discarded-row diagnostics. */
+export function normalizeSmMarketsWithDiagnostics(raw) {
+    const diagnostics = createNormalizationDiagnostics();
+    const unwrapped = unwrapEnvelope(raw);
+    const rows = readRawMarketRows(unwrapped);
+    if (rows.length === 0) {
+        if (!Array.isArray(unwrapped) && !isRecord(unwrapped)) {
+            recordIssue(diagnostics, "invalid_payload");
+        }
+        else {
+            recordIssue(diagnostics, "missing_markets_array");
+        }
+        return createNormalizationResult([], diagnostics);
+    }
+    const result = [];
+    for (const row of rows) {
+        if (!isRecord(row)) {
+            recordDiscard(diagnostics, "invalid_row_shape");
+            continue;
+        }
+        const token = asString(row.token);
+        const direction = asString(row.direction);
+        const pctOfTopTradersGain = asNumber(row.pct_of_top_traders_gain);
+        const traderCount = asNumber(row.trader_count);
+        const tokenPriceChangePct4h = asNumber(row.token_price_change_pct_4h);
+        if (token === null ||
+            direction === null ||
+            pctOfTopTradersGain === null ||
+            traderCount === null ||
+            tokenPriceChangePct4h === null) {
+            recordDiscard(diagnostics, "missing_required_fields");
+            continue;
+        }
+        const dex = asString(row.dex);
+        result.push({
+            token,
+            direction,
+            pctOfTopTradersGain,
+            traderCount,
+            tokenPriceChangePct4h,
+            ...(dex !== null ? { dex } : {}),
+        });
+        diagnostics.acceptedCount += 1;
+    }
+    return createNormalizationResult(result, diagnostics);
+}
+function normalizeCandleRow(raw) {
+    if (!isRecord(raw)) {
+        return null;
+    }
+    const row = {
+        t: raw.t,
+        o: raw.o,
+        h: raw.h,
+        l: raw.l,
+        c: raw.c,
+        v: raw.v,
+    };
+    const timestamp = asNumber(row.t);
+    const open = asNumber(row.o);
+    const high = asNumber(row.h);
+    const low = asNumber(row.l);
+    const close = asNumber(row.c);
+    const volume = asNumber(row.v);
+    if (timestamp === null ||
+        open === null ||
+        high === null ||
+        low === null ||
+        close === null ||
+        volume === null) {
+        return null;
+    }
+    return {
+        timestamp,
+        open,
+        high,
+        low,
+        close,
+        volume,
+    };
+}
+function readRawMarketRows(input) {
+    if (Array.isArray(input)) {
+        return input;
+    }
+    if (!isRecord(input)) {
+        return [];
+    }
+    const markets = input.markets;
+    if (Array.isArray(markets)) {
+        return markets;
+    }
+    if (!isRecord(markets)) {
+        return [];
+    }
+    const nested = markets.markets;
+    return Array.isArray(nested) ? nested : [];
+}
+function asBoolean(value) {
+    return typeof value === "boolean" ? value : null;
+}
+function createNormalizationDiagnostics() {
+    return {
+        acceptedCount: 0,
+        discardedCount: 0,
+        issueCounts: {},
+    };
+}
+function recordDiscard(diagnostics, issue) {
+    diagnostics.discardedCount += 1;
+    diagnostics.issueCounts[issue] = (diagnostics.issueCounts[issue] ?? 0) + 1;
+}
+function recordIssue(diagnostics, issue) {
+    diagnostics.issueCounts[issue] = (diagnostics.issueCounts[issue] ?? 0) + 1;
+}
+function createNormalizationResult(value, diagnostics) {
+    return {
+        value,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/scanners/providers/adapter.js.map

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

package/dist/scanners/providers/cache.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Small in-memory cache with TTL + in-flight de-duplication.
+ * Intended for provider-layer request fanout control.
+ */
+/** Cache used by providers to reuse recent responses and collapse concurrent calls. */
+export declare class ProviderCache {
+    private readonly now;
+    private readonly entries;
+    private readonly inflight;
+    constructor(now?: () => number);
+    /**
+     * Returns cached value when fresh; otherwise executes loader once for all callers.
+     * `ttlMs <= 0` disables persistence but still preserves in-flight de-duplication.
+     */
+    getOrLoad<T>(key: string, ttlMs: number, loader: () => Promise<T>): Promise<T>;
+    /** Drops all cached and in-flight entries. */
+    clear(): void;
+    private readCached;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/scanners/providers/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/scanners/providers/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,uFAAuF;AACvF,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;gBAEnC,GAAG,GAAE,MAAM,MAAiB;IAEzD;;;OAGG;IACG,SAAS,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC;IA8Bb,8CAA8C;IAC9C,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,UAAU;CAWnB"}

package/dist/scanners/providers/cache.js

@@ -0,0 +1,61 @@
+/**
+ * Small in-memory cache with TTL + in-flight de-duplication.
+ * Intended for provider-layer request fanout control.
+ */
+/** Cache used by providers to reuse recent responses and collapse concurrent calls. */
+export class ProviderCache {
+    now;
+    entries = new Map();
+    inflight = new Map();
+    constructor(now = Date.now) {
+        this.now = now;
+    }
+    /**
+     * Returns cached value when fresh; otherwise executes loader once for all callers.
+     * `ttlMs <= 0` disables persistence but still preserves in-flight de-duplication.
+     */
+    async getOrLoad(key, ttlMs, loader) {
+        const cached = this.readCached(key);
+        if (cached !== null) {
+            return cached;
+        }
+        const existingInflight = this.inflight.get(key);
+        if (existingInflight) {
+            return existingInflight;
+        }
+        const promise = (async () => {
+            try {
+                const value = await loader();
+                if (ttlMs > 0) {
+                    this.entries.set(key, {
+                        value,
+                        expiresAt: this.now() + ttlMs,
+                    });
+                }
+                return value;
+            }
+            finally {
+                this.inflight.delete(key);
+            }
+        })();
+        this.inflight.set(key, promise);
+        return promise;
+    }
+    /** Drops all cached and in-flight entries. */
+    clear() {
+        this.entries.clear();
+        this.inflight.clear();
+    }
+    readCached(key) {
+        const entry = this.entries.get(key);
+        if (!entry) {
+            return null;
+        }
+        if (entry.expiresAt <= this.now()) {
+            this.entries.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/scanners/providers/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/scanners/providers/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,uFAAuF;AACvF,MAAM,OAAO,aAAa;IAIK;IAHZ,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACxC,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEhE,YAA6B,MAAoB,IAAI,CAAC,GAAG;QAA5B,QAAG,GAAH,GAAG,CAAyB;IAAG,CAAC;IAE7D;;;OAGG;IACH,KAAK,CAAC,SAAS,CACb,GAAW,EACX,KAAa,EACb,MAAwB;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAI,GAAG,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,gBAA8B,CAAC;QACxC,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YAC1B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC;gBAC7B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;wBACpB,KAAK;wBACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;qBAC9B,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,8CAA8C;IAC9C,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEO,UAAU,CAAI,GAAW;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;CACF"}

package/dist/scanners/providers/client.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Provider-side client wrapper for MCP tool calls.
+ * Adds retries, timeout, and structured logging with optional debug envelope dumps.
+ */
+export type ProviderLogLevel = "error" | "warn" | "info" | "debug";
+/** Minimal logger contract used by providers. */
+export interface ProviderLogger {
+    error: (message: string, meta?: Record<string, unknown>) => void;
+    warn: (message: string, meta?: Record<string, unknown>) => void;
+    info: (message: string, meta?: Record<string, unknown>) => void;
+    debug: (message: string, meta?: Record<string, unknown>) => void;
+}
+/** Base tool client expected by scanner providers. */
+export interface SenpiToolClient {
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+}
+/** Optional metadata included in tool-call logs. */
+export interface ToolCallContext {
+    address?: string;
+    scannerId?: string;
+}
+/** Per-call overrides for retry/timeout behavior. */
+export interface ToolCallOptions extends ToolCallContext {
+    retries?: number;
+    timeoutMs?: number;
+}
+/** Provider client wrapper options. */
+export interface ProviderClientOptions {
+    logger?: ProviderLogger;
+    logLevel?: ProviderLogLevel;
+    retries?: number;
+    timeoutMs?: number;
+    redactKeys?: string[];
+}
+/** Provider tool client with instrumentation and guardrails. */
+export interface ProviderToolClient {
+    callTool<T = unknown>(name: string, args: Record<string, unknown>, options?: ToolCallOptions): Promise<T>;
+}
+/** Creates a provider client wrapper around a raw MCP tool client. */
+export declare function createProviderClient(client: SenpiToolClient, options?: ProviderClientOptions): ProviderToolClient;
+/** Console-backed provider logger used when no custom logger is supplied. */
+export declare function createConsoleProviderLogger(): ProviderLogger;
+/**
+ * Wraps a winston-style logger (`debug/info/warn/error` methods) so providers
+ * can use it without importing winston types directly.
+ */
+export declare function createWinstonProviderLogger(logger: {
+    debug: (message: string, meta?: Record<string, unknown>) => void;
+    info: (message: string, meta?: Record<string, unknown>) => void;
+    warn: (message: string, meta?: Record<string, unknown>) => void;
+    error: (message: string, meta?: Record<string, unknown>) => void;
+}): ProviderLogger;
+//# sourceMappingURL=client.d.ts.map

package/dist/scanners/providers/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/scanners/providers/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,qBAA0B,GAClC,kBAAkB,CA0FpB;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,IAAI,cAAc,CAE5D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE,GAAG,cAAc,CAOjB"}

package/dist/scanners/providers/client.js

@@ -0,0 +1,174 @@
+/**
+ * Provider-side client wrapper for MCP tool calls.
+ * Adds retries, timeout, and structured logging with optional debug envelope dumps.
+ */
+/** Creates a provider client wrapper around a raw MCP tool client. */
+export function createProviderClient(client, options = {}) {
+    const logger = options.logger ?? createConsoleLogger();
+    const level = options.logLevel ?? "info";
+    const defaultRetries = options.retries ?? 2;
+    const defaultTimeoutMs = options.timeoutMs ?? 10_000;
+    const redactKeys = new Set(options.redactKeys ?? [
+        "authorization",
+        "api_key",
+        "apikey",
+        "password",
+        "secret",
+        "x-api-key",
+    ]);
+    return {
+        async callTool(name, args, callOptions) {
+            const retries = callOptions?.retries ?? defaultRetries;
+            const timeoutMs = callOptions?.timeoutMs ?? defaultTimeoutMs;
+            let lastError;
+            for (let attempt = 1; attempt <= retries + 1; attempt += 1) {
+                const startedAt = Date.now();
+                try {
+                    if (shouldLog(level, "debug")) {
+                        logger.debug("Provider tool call request.", {
+                            tool: name,
+                            attempt,
+                            timeoutMs,
+                            ...readCallContext(callOptions),
+                            request: redactValue(args, redactKeys),
+                        });
+                    }
+                    const response = (await withTimeout(client.callTool(name, args), timeoutMs));
+                    const durationMs = Date.now() - startedAt;
+                    if (shouldLog(level, "debug")) {
+                        logger.debug("Provider tool call response.", {
+                            tool: name,
+                            attempt,
+                            durationMs,
+                            ...readCallContext(callOptions),
+                            response: redactValue(response, redactKeys),
+                        });
+                    }
+                    else if (shouldLog(level, "info")) {
+                        logger.info("Provider tool call succeeded.", {
+                            tool: name,
+                            attempt,
+                            durationMs,
+                            ...readCallContext(callOptions),
+                        });
+                    }
+                    return response;
+                }
+                catch (error) {
+                    lastError = error;
+                    const durationMs = Date.now() - startedAt;
+                    const meta = {
+                        tool: name,
+                        attempt,
+                        durationMs,
+                        retriesRemaining: retries + 1 - attempt,
+                        ...readCallContext(callOptions),
+                        error: toErrorMessage(error),
+                    };
+                    if (attempt <= retries) {
+                        if (shouldLog(level, "warn")) {
+                            logger.warn("Provider tool call failed, retrying.", meta);
+                        }
+                        continue;
+                    }
+                    logger.error("Provider tool call failed.", meta);
+                    throw error;
+                }
+            }
+            throw new Error(`Provider tool call failed: ${toErrorMessage(lastError)}`);
+        },
+    };
+}
+/** Console-backed provider logger used when no custom logger is supplied. */
+export function createConsoleProviderLogger() {
+    return createConsoleLogger();
+}
+/**
+ * Wraps a winston-style logger (`debug/info/warn/error` methods) so providers
+ * can use it without importing winston types directly.
+ */
+export function createWinstonProviderLogger(logger) {
+    return {
+        debug: (message, meta) => logger.debug(message, meta),
+        info: (message, meta) => logger.info(message, meta),
+        warn: (message, meta) => logger.warn(message, meta),
+        error: (message, meta) => logger.error(message, meta),
+    };
+}
+function createConsoleLogger() {
+    return {
+        debug: (message, meta) => {
+            console.debug(message, meta ?? {});
+        },
+        info: (message, meta) => {
+            console.info(message, meta ?? {});
+        },
+        warn: (message, meta) => {
+            console.warn(message, meta ?? {});
+        },
+        error: (message, meta) => {
+            console.error(message, meta ?? {});
+        },
+    };
+}
+function shouldLog(current, required) {
+    return toPriority(current) >= toPriority(required);
+}
+function toPriority(level) {
+    switch (level) {
+        case "error":
+            return 1;
+        case "warn":
+            return 2;
+        case "info":
+            return 3;
+        case "debug":
+            return 4;
+    }
+}
+function readCallContext(options) {
+    return {
+        address: options?.address,
+        scannerId: options?.scannerId,
+    };
+}
+function redactValue(value, redactKeys) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => redactValue(entry, redactKeys));
+    }
+    if (typeof value !== "object" || value === null) {
+        return value;
+    }
+    const source = value;
+    const target = {};
+    for (const [key, entry] of Object.entries(source)) {
+        const lowered = key.toLowerCase();
+        if (redactKeys.has(lowered)) {
+            target[key] = "[REDACTED]";
+            continue;
+        }
+        target[key] = redactValue(entry, redactKeys);
+    }
+    return target;
+}
+async function withTimeout(promise, timeoutMs) {
+    if (timeoutMs <= 0) {
+        return promise;
+    }
+    return await Promise.race([
+        promise,
+        new Promise((_, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error(`Timeout after ${timeoutMs}ms.`));
+            }, timeoutMs);
+            timeout.unref?.();
+        }),
+    ]);
+}
+function toErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=client.js.map

package/dist/scanners/providers/client.js.map

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

package/dist/scanners/providers/factory.d.ts

@@ -0,0 +1,42 @@
+import type { ScannerDataProviders } from "../engine/data-providers.js";
+import { type ProviderLogLevel, type ProviderLogger, type SenpiToolClient } from "./client.js";
+/** Provider-specific timeout knobs by MCP tool. */
+export interface SenpiProviderTimeouts {
+    marketListInstruments?: number;
+    marketGetAssetData?: number;
+    leaderboardGetMarkets?: number;
+}
+/** Provider cache TTL knobs (milliseconds). */
+export interface SenpiProviderCacheTtlMs {
+    instruments?: number;
+    smData?: number;
+    candles?: number;
+}
+/** Tool-name overrides used when MCP aliases differ by runtime. */
+export interface SenpiProviderToolNames {
+    marketListInstruments?: string;
+    marketGetAssetData?: string;
+    leaderboardGetMarkets?: string;
+}
+/** Winston-compatible logger shape accepted by provider factory. */
+export interface WinstonLikeLogger {
+    debug: (message: string, meta?: Record<string, unknown>) => void;
+    info: (message: string, meta?: Record<string, unknown>) => void;
+    warn: (message: string, meta?: Record<string, unknown>) => void;
+    error: (message: string, meta?: Record<string, unknown>) => void;
+}
+/** Factory options for live Senpi-backed scanner providers. */
+export interface SenpiScannerProviderFactoryOptions {
+    client: SenpiToolClient;
+    logger?: ProviderLogger | WinstonLikeLogger;
+    logLevel?: ProviderLogLevel;
+    candleIntervals?: string[];
+    maxCandleAssets?: number;
+    cacheTtlMs?: SenpiProviderCacheTtlMs;
+    timeouts?: SenpiProviderTimeouts;
+    retries?: number;
+    toolNames?: SenpiProviderToolNames;
+}
+/** Creates a `ScannerDataProviders` bundle backed by Senpi MCP tools. */
+export declare function createSenpiScannerProviders(options: SenpiScannerProviderFactoryOptions): ScannerDataProviders;
+//# sourceMappingURL=factory.d.ts.map

package/dist/scanners/providers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/scanners/providers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AASrC,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAGrB,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,+CAA+C;AAC/C,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE;AAED,+DAA+D;AAC/D,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,cAAc,GAAG,iBAAiB,CAAC;IAC5C,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,oBAAoB,CA8HtB"}