@senpi/runtime 1.0.95-dev.20260408174401

package/dist/scanners/protocol/scanner.d.ts

@@ -0,0 +1,47 @@
+import type { ScannerDefinition } from "../scanner-definition.js";
+import type { ScannerScanOutput } from "../types.js";
+import type { ScanContext, ScannerInitContext } from "./context.js";
+import type { ScannerHooks } from "./hooks.js";
+/**
+ * Core scanner contract implemented by all strategy-runtime scanners.
+ *
+ * Each scanner declares a {@link ScannerDefinition} describing its identity,
+ * provider-backed inputs, shared market intelligence contracts, scheduling interval, and persistence/retention policies. The engine
+ * calls {@link initialize} once per (address, scannerId) registration, then
+ * calls {@link scan} on each scheduled or manual run.
+ *
+ * **Lifecycle:**
+ * 1. Engine loads/creates runtime state and builds an init context.
+ * 2. `initialize(ctx)` is called once — use it to bootstrap scanner-local state
+ *    or validate prerequisites. The init context provides `setState()` for persisting
+ *    initial state and `loadSharedArtifact()` / `saveSharedArtifact()` for shared market intelligence.
+ * 3. On each run, the engine builds a scan context with resolved provider-backed
+ *    inputs plus shared market intelligence under `ctx.inputs.artifacts`.
+ * 4. If `hooks.beforeScan` is defined, it runs first and may throw `SkipScan` to abort.
+ * 5. `scan(ctx)` executes scanner logic and returns signals + metadata.
+ * 6. The engine normalizes scores to [0, 1], applies `hooks.isActionable` filtering,
+ *    and persists results according to the scanner's policies.
+ *
+ * @typeParam Cfg - Scanner configuration type (validated against `definition.configSchema`).
+ * @typeParam St  - Scanner-local mutable state type (persisted across runs via `ctx.setState()`).
+ */
+export interface Scanner<Cfg = unknown, St = unknown> {
+    /** Static scanner metadata: identity, input contracts, scheduling, persistence. */
+    definition: ScannerDefinition<Cfg, St>;
+    /** Optional pre/post-scan behavior customizations. */
+    hooks?: ScannerHooks<Cfg, St>;
+    /**
+     * Called once per (address, scannerId) registration before the first scan.
+     * Use this to initialize scanner-local state, validate config, or load prerequisites.
+     * The context provides `setState()` for persisting initial state to disk.
+     */
+    initialize: (ctx: ScannerInitContext<Cfg, St>) => Promise<void>;
+    /**
+     * Executes one scanner run and returns signals with execution metadata.
+     * The context includes resolved provider-backed inputs, shared market intelligence,
+     * current config/state, and shared artifact accessors. Signals returned here are normalized by the
+     * engine (score clamping, factor coercion) before persistence.
+     */
+    scan: (ctx: ScanContext<Cfg, St>) => Promise<ScannerScanOutput>;
+}
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanners/protocol/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/scanners/protocol/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,OAAO,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO;IAClD,mFAAmF;IACnF,UAAU,EAAE,iBAAiB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAEvC,sDAAsD;IACtD,KAAK,CAAC,EAAE,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAE9B;;;;OAIG;IACH,UAAU,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjE"}

package/dist/scanners/protocol/scanner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scanner.js.map

package/dist/scanners/protocol/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../../src/scanners/protocol/scanner.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,23 @@
+import type { CandleResult, Instrument, SmMarket } from "../types.js";
+/** Summary of rows/issues encountered while normalizing one provider payload. */
+export interface NormalizationDiagnostics {
+    acceptedCount: number;
+    discardedCount: number;
+    issueCounts: Record<string, number>;
+}
+/** Normalized value paired with diagnostics describing discarded rows/issues. */
+export interface NormalizationResult<T> {
+    value: T;
+    diagnostics: NormalizationDiagnostics;
+}
+/** Strictly maps `market_list_instruments` payload into scanner `Instrument[]`. */
+export declare function normalizeInstruments(raw: unknown): Instrument[];
+/** Strictly maps `market_list_instruments` payload and reports discarded-row diagnostics. */
+export declare function normalizeInstrumentsWithDiagnostics(raw: unknown): NormalizationResult<Instrument[]>;
+/** Strictly maps one `market_get_asset_data` payload into scanner `CandleResult`. */
+export declare function normalizeAssetCandles(raw: unknown): CandleResult;
+/** Strictly maps `leaderboard_get_markets` payload into scanner `SmMarket[]`. */
+export declare function normalizeSmMarkets(raw: unknown): SmMarket[];
+/** Strictly maps `leaderboard_get_markets` payload and reports discarded-row diagnostics. */
+export declare function normalizeSmMarketsWithDiagnostics(raw: unknown): NormalizationResult<SmMarket[]>;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/scanners/providers/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAS9E,iFAAiF;AACjF,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,iFAAiF;AACjF,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,EAAE,wBAAwB,CAAC;CACvC;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,CAE/D;AAED,6FAA6F;AAC7F,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,OAAO,GACX,mBAAmB,CAAC,UAAU,EAAE,CAAC,CAuEnC;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAqChE;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,EAAE,CAE3D;AAED,6FAA6F;AAC7F,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,OAAO,GACX,mBAAmB,CAAC,QAAQ,EAAE,CAAC,CAiDjC"}

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