pmxt-core 2.44.5 → 2.45.0

package/dist/exchanges/kalshi/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-05-25T10:52:11.681Z
+ * Generated at: 2026-05-25T15:44:11.679Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const kalshiApiSpec: {

package/dist/exchanges/kalshi/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.kalshiApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-05-25T10:52:11.681Z
+ * Generated at: 2026-05-25T15:44:11.679Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

package/dist/exchanges/kalshi/fetcher.d.ts

@@ -30,13 +30,20 @@ export interface KalshiRawMarket {
 export interface KalshiRawEvent {
     event_ticker: string;
     title: string;
+    sub_title?: string;
     image_url?: string;
     category?: string;
     tags?: string[];
     series_ticker?: string;
+    series_title?: string;
+    mutually_exclusive?: boolean;
     markets?: KalshiRawMarket[];
     [key: string]: unknown;
 }
+interface KalshiSeriesInfo {
+    title?: string;
+    tags?: string[];
+}
 export interface KalshiRawEventPage {
     events: KalshiRawEvent[];
     cursor?: string | null;
@@ -146,10 +153,13 @@ export declare class KalshiFetcher implements IExchangeFetcher<KalshiRawEvent, K
     }>;
     fetchRawOrders(queryParams: Record<string, any>): Promise<KalshiRawOrder[]>;
     fetchRawHistoricalOrders(queryParams: Record<string, any>): Promise<KalshiRawOrder[]>;
-    fetchRawSeriesMap(): Promise<Map<string, string[]>>;
+    fetchRawSeriesMap(): Promise<Map<string, KalshiSeriesInfo>>;
     fetchRawEventByTicker(eventTicker: string): Promise<KalshiRawEvent[]>;
     private fetchRawEventsDefault;
+    private enrichEventsWithSeriesList;
+    private enrichEventsWithSeriesMap;
     private fetchActiveEvents;
     private fetchAllWithStatus;
     private fetchPageWithStatus;
 }
+export {};

package/dist/exchanges/kalshi/fetcher.js

@@ -65,16 +65,16 @@ class KalshiFetcher {
                     this.fetchAllWithStatus('closed'),
                     this.fetchAllWithStatus('settled'),
                 ]);
-                return [...openEvents, ...closedEvents, ...settledEvents];
+                return this.enrichEventsWithSeriesList([...openEvents, ...closedEvents, ...settledEvents]);
             }
             else if (status === 'closed' || status === 'inactive') {
                 const [closedEvents, settledEvents] = await Promise.all([
                     this.fetchAllWithStatus('closed'),
                     this.fetchAllWithStatus('settled'),
                 ]);
-                return [...closedEvents, ...settledEvents];
+                return this.enrichEventsWithSeriesList([...closedEvents, ...settledEvents]);
             }
-            return this.fetchAllWithStatus('open');
+            return this.enrichEventsWithSeriesList(await this.fetchAllWithStatus('open'));
         }
         catch (error) {
             throw errors_1.kalshiErrorMapper.mapError(error);
@@ -92,7 +92,9 @@ class KalshiFetcher {
             if (status === 'settled')
                 apiStatus = 'settled';
             const limit = Math.max(1, Math.floor(params.limit || BATCH_SIZE));
-            return this.fetchPageWithStatus(apiStatus, limit, params.cursor);
+            const page = await this.fetchPageWithStatus(apiStatus, limit, params.cursor);
+            await this.enrichEventsWithSeriesList(page.events);
+            return page;
         }
         catch (error) {
             throw errors_1.kalshiErrorMapper.mapError(error);
@@ -217,8 +219,11 @@ class KalshiFetcher {
             const seriesList = data.series || [];
             const map = new Map();
             for (const series of seriesList) {
-                if (series.tags && series.tags.length > 0) {
-                    map.set(series.ticker, series.tags);
+                if (series.ticker) {
+                    map.set(series.ticker, {
+                        title: typeof series.title === 'string' ? series.title : undefined,
+                        tags: Array.isArray(series.tags) ? series.tags : undefined,
+                    });
                 }
             }
             return map;
@@ -237,20 +242,24 @@ class KalshiFetcher {
         const event = data.event;
         if (!event)
             return [];
-        // Enrich with series tags
+        // Enrich with series metadata. The series title helps the normalizer
+        // avoid polluted event titles on multi-market futures.
         if (event.series_ticker) {
             try {
                 const seriesData = await this.ctx.callApi('GetSeries', {
                     series_ticker: event.series_ticker,
                 });
                 const series = seriesData.series;
+                if (typeof series?.title === 'string' && series.title.trim()) {
+                    event.series_title = series.title.trim();
+                }
                 if (series?.tags?.length > 0 && (!event.tags || event.tags.length === 0)) {
                     event.tags = series.tags;
                 }
             }
             catch (err) {
-                // Non-critical — tags are enrichment only.
-                logger_1.logger.warn('kalshi: series tag fetch failed', {
+                // Non-critical — series metadata is enrichment only.
+                logger_1.logger.warn('kalshi: series metadata fetch failed', {
                     series_ticker: event.series_ticker,
                     error: err instanceof Error ? err.message : String(err),
                 });
@@ -275,14 +284,7 @@ class KalshiFetcher {
             this.fetchActiveEvents(fetchLimit, apiStatus),
             this.fetchRawSeriesMap(),
         ]);
-        // Enrich events with series tags
-        for (const event of allEvents) {
-            if (event.series_ticker && fetchedSeriesMap.has(event.series_ticker)) {
-                if (!event.tags || event.tags.length === 0) {
-                    event.tags = fetchedSeriesMap.get(event.series_ticker);
-                }
-            }
-        }
+        this.enrichEventsWithSeriesMap(allEvents, fetchedSeriesMap);
         if (fetchLimit >= 1000 && useCache) {
             this.cachedEvents = allEvents;
             this.cachedSeriesMap = fetchedSeriesMap;
@@ -290,6 +292,36 @@ class KalshiFetcher {
         }
         return allEvents;
     }
+    async enrichEventsWithSeriesList(events) {
+        if (events.length === 0)
+            return events;
+        try {
+            const seriesMap = await this.fetchRawSeriesMap();
+            this.enrichEventsWithSeriesMap(events, seriesMap);
+        }
+        catch (err) {
+            // Non-critical — callers can still normalize the venue-native title.
+            logger_1.logger.warn('kalshi: series list enrichment failed', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        return events;
+    }
+    enrichEventsWithSeriesMap(events, seriesMap) {
+        for (const event of events) {
+            if (!event.series_ticker)
+                continue;
+            const seriesInfo = seriesMap.get(event.series_ticker);
+            if (!seriesInfo)
+                continue;
+            if (seriesInfo.title) {
+                event.series_title = seriesInfo.title;
+            }
+            if (seriesInfo.tags?.length && (!event.tags || event.tags.length === 0)) {
+                event.tags = seriesInfo.tags;
+            }
+        }
+    }
     async fetchActiveEvents(targetMarketCount, status = 'open') {
         let allEvents = [];
         let totalMarketCount = 0;

package/dist/exchanges/kalshi/normalizer.d.ts

@@ -21,6 +21,18 @@ export declare class KalshiNormalizer implements IExchangeNormalizer<KalshiRawEv
     }): Balance[];
     private mapOrderStatus;
     private deriveEventDescription;
+    private deriveEventTitle;
+    private shouldUseSeriesTitle;
+    private deriveCommonEventTitle;
+    private extractEventTitleFromMarketTitle;
+    private composeSeriesTitle;
+    private ensureWinnerTitle;
+    private hasResolutionTerm;
+    private extractEventTitlePrefix;
+    private extractResolutionTerm;
+    private hasWinVerb;
+    private normalizeTitleText;
+    private escapeRegExp;
     private deriveOutcomeLabel;
     private cleanLabel;
     private templateRule;

package/dist/exchanges/kalshi/normalizer.js

@@ -102,7 +102,7 @@ class KalshiNormalizer {
         const markets = this.normalizeMarketsFromEvent(raw);
         return {
             id: raw.event_ticker,
-            title: raw.title,
+            title: this.deriveEventTitle(raw),
             description: this.deriveEventDescription(raw.markets || []),
             slug: raw.event_ticker,
             markets,
@@ -299,6 +299,130 @@ class KalshiNormalizer {
         }
         return texts[0];
     }
+    deriveEventTitle(event) {
+        const rawTitle = this.cleanLabel(event.title) || event.event_ticker;
+        const seriesTitle = this.cleanLabel(event.series_title);
+        const markets = event.markets || [];
+        if (!seriesTitle || !this.shouldUseSeriesTitle(event, markets)) {
+            return rawTitle;
+        }
+        return this.composeSeriesTitle(seriesTitle, this.deriveCommonEventTitle(event, markets));
+    }
+    shouldUseSeriesTitle(event, markets) {
+        if (event.mutually_exclusive !== true)
+            return false;
+        if (markets.length < 4)
+            return false;
+        const rawTitle = this.cleanLabel(event.title);
+        if (!rawTitle)
+            return false;
+        const titleLooksScoped = /(?:\bvs\.?\b|\bversus\b|:)/i.test(rawTitle);
+        if (!titleLooksScoped)
+            return false;
+        const candidateLabels = markets
+            .map((market) => this.deriveOutcomeLabel(market))
+            .filter((label) => label != null && label.length >= 3);
+        if (candidateLabels.length < 4)
+            return false;
+        const normalizedTitle = this.normalizeTitleText(rawTitle);
+        const containedLabels = new Set();
+        for (const label of candidateLabels) {
+            const normalizedLabel = this.normalizeTitleText(label);
+            if (normalizedLabel && normalizedTitle.includes(normalizedLabel)) {
+                containedLabels.add(normalizedLabel);
+            }
+        }
+        return containedLabels.size >= 2;
+    }
+    deriveCommonEventTitle(event, markets) {
+        const eventTitlePrefix = this.extractEventTitlePrefix(event.title);
+        if (eventTitlePrefix) {
+            if (this.hasWinVerb(eventTitlePrefix))
+                return 'Winner';
+            if (this.hasResolutionTerm(eventTitlePrefix))
+                return eventTitlePrefix;
+        }
+        const candidates = new Map();
+        for (const market of markets) {
+            const marketTitle = this.cleanLabel(market.title);
+            if (!marketTitle)
+                continue;
+            const outcomeLabel = this.deriveOutcomeLabel(market);
+            const candidate = this.extractEventTitleFromMarketTitle(marketTitle, outcomeLabel);
+            if (!candidate)
+                continue;
+            candidates.set(candidate, (candidates.get(candidate) ?? 0) + 1);
+        }
+        let best = null;
+        let bestCount = 0;
+        for (const [candidate, count] of candidates.entries()) {
+            if (count > bestCount) {
+                best = candidate;
+                bestCount = count;
+            }
+        }
+        return best;
+    }
+    extractEventTitleFromMarketTitle(title, outcomeLabel) {
+        const escapedOutcome = outcomeLabel ? this.escapeRegExp(outcomeLabel) : '[^?]+?';
+        const winPattern = new RegExp(`^Will (?:the )?${escapedOutcome} win (?:the )?(.+?)\\??$`, 'i');
+        const winMatch = title.match(winPattern);
+        if (winMatch?.[1]) {
+            return this.ensureWinnerTitle(winMatch[1].trim());
+        }
+        const plainWinnerMatch = title.match(/^(.+? Winner)\??$/i);
+        if (plainWinnerMatch?.[1])
+            return plainWinnerMatch[1].trim();
+        const championMatch = title.match(/^(.+? Champion(?:ship)?)\??$/i);
+        if (championMatch?.[1])
+            return championMatch[1].trim();
+        return null;
+    }
+    composeSeriesTitle(seriesTitle, commonTitle) {
+        if (!commonTitle)
+            return seriesTitle;
+        let title = seriesTitle;
+        const year = commonTitle.match(/^\s*(20\d{2})\b/)?.[1];
+        if (year && !new RegExp(`\\b${year}\\b`).test(title)) {
+            title = `${year} ${title}`;
+        }
+        if (this.hasResolutionTerm(title)) {
+            return title;
+        }
+        const resolutionTerm = this.extractResolutionTerm(commonTitle);
+        if (resolutionTerm) {
+            return `${title} ${resolutionTerm}`;
+        }
+        return title;
+    }
+    ensureWinnerTitle(title) {
+        if (this.hasResolutionTerm(title))
+            return title;
+        return `${title} Winner`;
+    }
+    hasResolutionTerm(title) {
+        return /\b(winner|champion|championship|nominee|nomination|election|finals?|cup|award)\b/i.test(title);
+    }
+    extractEventTitlePrefix(title) {
+        const match = title.match(/^(.+?)(?:\s*:\s*|\s+[-\u2013\u2014]\s+)(.+)$/u);
+        const prefix = match?.[1]?.trim();
+        if (prefix && this.normalizeTitleText(prefix) === 'series winner')
+            return null;
+        return prefix || null;
+    }
+    extractResolutionTerm(title) {
+        const match = title.match(/\b(Winner|Champion|Championship|Nominee|Nomination|Election|Finals?|Cup|Award)\b\s*$/i);
+        return match?.[1] || null;
+    }
+    hasWinVerb(title) {
+        return /\bwin(?:s|ning)?\b/i.test(title);
+    }
+    normalizeTitleText(value) {
+        return value.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, ' ').trim();
+    }
+    escapeRegExp(value) {
+        return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
     deriveOutcomeLabel(market) {
         const yesSubtitle = this.cleanLabel(market.yes_sub_title);
         if (yesSubtitle)

package/dist/exchanges/limitless/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-05-25T10:52:11.722Z
+ * Generated at: 2026-05-25T15:44:11.717Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const limitlessApiSpec: {

package/dist/exchanges/limitless/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.limitlessApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-05-25T10:52:11.722Z
+ * Generated at: 2026-05-25T15:44:11.717Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

package/dist/exchanges/mock/index.js

@@ -5,6 +5,17 @@ const BaseExchange_1 = require("../../BaseExchange");
 const seededRng_1 = require("./seededRng");
 const clamp = (n, lo, hi) => Math.min(hi, Math.max(lo, n));
 const round = (n, decimals = 3) => parseFloat(n.toFixed(decimals));
+const toTimestamp = (value) => {
+    if (value === undefined)
+        return undefined;
+    if (value instanceof Date)
+        return value.getTime();
+    const parsed = typeof value === 'number' ? value : new Date(value).getTime();
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`Invalid date value: ${String(value)}`);
+    }
+    return parsed;
+};
 const CATEGORIES = ['Politics', 'Sports', 'Crypto', 'Finance', 'Science', 'Entertainment', 'Tech', 'World'];
 const LOREM = `lorem ipsum dolor sit amet consectetur adipiscing elit sed do eiusmod tempor
 incididunt ut labore et dolore magna aliqua enim ad minim veniam quis nostrud
@@ -333,8 +344,8 @@ class MockExchange extends BaseExchange_1.PredictionMarketExchange {
         };
         const step = resolutionMs[params.resolution] ?? 3_600_000;
         const limit = params.limit ?? 100;
-        const end = params.end ? params.end.getTime() : Date.now();
-        const start = params.start ? params.start.getTime() : end - step * limit;
+        const end = toTimestamp(params.end) ?? Date.now();
+        const start = toTimestamp(params.start) ?? end - step * limit;
         const candles = [];
         let price = round(f.float(0.2, 0.8), 3);
         let t = start;

package/dist/exchanges/myriad/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-05-25T10:52:11.733Z
+ * Generated at: 2026-05-25T15:44:11.728Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const myriadApiSpec: {

package/dist/exchanges/myriad/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.myriadApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-05-25T10:52:11.733Z
+ * Generated at: 2026-05-25T15:44:11.728Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.myriadApiSpec = {

package/dist/exchanges/opinion/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-05-25T10:52:11.737Z
+ * Generated at: 2026-05-25T15:44:11.734Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const opinionApiSpec: {

package/dist/exchanges/opinion/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.opinionApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-05-25T10:52:11.737Z
+ * Generated at: 2026-05-25T15:44:11.734Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

package/dist/exchanges/polymarket/api-clob.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-05-25T10:52:11.689Z
+ * Generated at: 2026-05-25T15:44:11.685Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketClobSpec: {

package/dist/exchanges/polymarket/api-clob.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketClobSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-05-25T10:52:11.689Z
+ * Generated at: 2026-05-25T15:44:11.685Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketClobSpec = {

package/dist/exchanges/polymarket/api-data.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-05-25T10:52:11.704Z
+ * Generated at: 2026-05-25T15:44:11.697Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketDataSpec: {

package/dist/exchanges/polymarket/api-data.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketDataSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-05-25T10:52:11.704Z
+ * Generated at: 2026-05-25T15:44:11.697Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketDataSpec = {

package/dist/exchanges/polymarket/api-gamma.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-05-25T10:52:11.701Z
+ * Generated at: 2026-05-25T15:44:11.694Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketGammaSpec: {

package/dist/exchanges/polymarket/api-gamma.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketGammaSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-05-25T10:52:11.701Z
+ * Generated at: 2026-05-25T15:44:11.694Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/websocket.d.ts

@@ -49,6 +49,8 @@ export interface PolymarketWebSocketConfig {
     userChannelCreds?: PolymarketUserChannelCreds;
     /** Timeout in ms for WebSocket connections to open (default: 30000). */
     connectionTimeoutMs?: number;
+    /** Time to wait for an initial market-channel book before using a REST snapshot fallback. */
+    snapshotFallbackMs?: number;
 }
 /**
  * Native WebSocket implementation for Polymarket market data.
@@ -64,6 +66,8 @@ export declare class PolymarketWebSocket {
     private orderBooks;
     private config;
     private initializationPromise?;
+    private marketPingInterval;
+    private readonly callApi;
     constructor(callApi: (operationId: string, params?: Record<string, any>) => Promise<any>, config?: PolymarketWebSocketConfig);
     watchOrderBook(outcomeId: string): Promise<OrderBook>;
     unwatchOrderBook(outcomeId: string): Promise<void>;
@@ -95,6 +99,14 @@ export declare class PolymarketWebSocket {
     private subscribe;
     private ensureInitialized;
     private handleBookSnapshot;
+    private withSnapshotFallback;
+    private removeOrderBookResolver;
+    private fetchOrderBookSnapshot;
+    private normalizeRawOrderBook;
+    private parseTimestamp;
+    private startMarketHeartbeat;
+    private stopMarketHeartbeat;
+    private rejectPendingMarketResolvers;
     private handlePriceChange;
     private handleTrade;
     private resolveOrderBook;