@gotza02/sequential-thinking 2026.2.39 → 2026.2.41

package/dist/tools/sports/core/constants.js

@@ -0,0 +1,149 @@
+/**
+ * SPORTS MODULE CONSTANTS
+ * Configuration values for the football intelligence system
+ */
+// ============= API Configuration =============
+export const API_CONFIG = {
+    // API-Football (RapidAPI)
+    API_FOOTBALL_KEY: process.env.API_FOOTBALL_KEY || '',
+    API_FOOTBALL_BASE: 'https://api-football-v1.p.rapidapi.com/v3',
+    API_FOOTBALL_HOST: 'api-football-v1.p.rapidapi.com',
+    // Football-Data.org
+    FOOTBALL_DATA_KEY: process.env.FOOTBALL_DATA_KEY || '',
+    FOOTBALL_DATA_BASE: 'https://api.football-data.org/v4',
+    // TheSportsDB
+    SPORTS_DB_KEY: process.env.SPORTS_DB_KEY || '',
+    SPORTS_DB_BASE: 'https://www.thesportsdb.com/api/v1/json',
+    // Rate limits (requests per minute)
+    RATE_LIMITS: {
+        API_FOOTBALL: 10,
+        FOOTBALL_DATA: 10,
+        SPORTS_DB: 30,
+    }
+};
+// ============= Cache Configuration =============
+export const CACHE_CONFIG = {
+    // Default TTL in milliseconds
+    DEFAULT_TTL: parseInt(process.env.SPORTS_CACHE_TTL || '300000'), // 5 minutes
+    // Specific TTLs for different data types
+    TTL: {
+        LIVE_SCORES: 60 * 1000, // 1 minute
+        MATCH_DETAILS: 5 * 60 * 1000, // 5 minutes
+        STANDINGS: 30 * 60 * 1000, // 30 minutes
+        TEAM_STATS: 60 * 60 * 1000, // 1 hour
+        PLAYER_STATS: 60 * 60 * 1000, // 1 hour
+        ODDS: 2 * 60 * 1000, // 2 minutes
+        TRANSFER_NEWS: 15 * 60 * 1000, // 15 minutes
+    },
+    // Cache file path
+    CACHE_PATH: process.env.SPORTS_CACHE_PATH || '.sports_cache.json',
+    // Max cache size (number of entries)
+    MAX_SIZE: 1000,
+};
+// ============= Scraping Configuration =============
+export const SCRAPER_CONFIG = {
+    // Priority domains for sports data
+    PRIORITY_DOMAINS: [
+        'whoscored.com',
+        'sofascore.com',
+        'flashscore.com',
+        'understat.com',
+        'fbref.com',
+        'bbc.co.uk/sport',
+        'skysports.com',
+        'sportsmole.co.uk',
+        'goal.com',
+        'thesquareball.net'
+    ],
+    // Scraping timeout in milliseconds
+    TIMEOUT: 15000,
+    // User agent for scraping
+    USER_AGENT: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
+    // Maximum content length
+    MAX_CONTENT_LENGTH: 50000,
+};
+// ============= Leagues Configuration =============
+export const LEAGUES = {
+    // Major European Leagues
+    PREMIER_LEAGUE: { id: 39, name: 'Premier League', country: 'England', code: 'PL' },
+    LA_LIGA: { id: 140, name: 'La Liga', country: 'Spain', code: 'LL' },
+    BUNDESLIGA: { id: 78, name: 'Bundesliga', country: 'Germany', code: 'BL1' },
+    SERIE_A: { id: 135, name: 'Serie A', country: 'Italy', code: 'SA' },
+    LIGUE_1: { id: 61, name: 'Ligue 1', country: 'France', code: 'FL1' },
+    // Other Top Leagues
+    EREDIVISIE: { id: 88, name: 'Eredivisie', country: 'Netherlands', code: 'DED' },
+    PRIMEIRA_LIGA: { id: 94, name: 'Primeira Liga', country: 'Portugal', code: 'PPL' },
+    CHAMPIONS_LEAGUE: { id: 2, name: 'UEFA Champions League', country: 'Europe', code: 'CL' },
+    EUROPA_LEAGUE: { id: 3, name: 'UEFA Europa League', country: 'Europe', code: 'EL' },
+    FA_CUP: { id: 45, name: 'FA Cup', country: 'England', code: 'FAC' },
+    // Asian Leagues
+    J_LEAGUE: { id: 98, name: 'J1 League', country: 'Japan', code: 'J1' },
+    K_LEAGUE: { id: 251, name: 'K League 1', country: 'South Korea', code: 'KL1' },
+    THAI_LEAGUE: { id: 305, name: 'Thai League 1', country: 'Thailand', code: 'TL1' },
+    CSL: { id: 169, name: 'Chinese Super League', country: 'China', code: 'CSL' },
+};
+// ============= Search Query Types =============
+export const QUERY_TYPES = {
+    GENERAL: 'general',
+    H2H: 'h2h',
+    FORM: 'form',
+    NEWS: 'news',
+    STATS: 'stats',
+    ODDS: 'odds',
+    REFEREE: 'referee',
+    WEATHER: 'weather',
+    FATIGUE: 'fatigue',
+    SETPIECES: 'setpieces',
+};
+// ============= Betting Constants =============
+export const BETTING = {
+    // Kelly Criterion variants
+    KELLY_FULL: 'full',
+    KELLY_HALF: 'half',
+    KELLY_QUARTER: 'quarter',
+    // Value thresholds
+    VALUE_THRESHOLD: 0.05, // 5% value is worth considering
+    HIGH_VALUE_THRESHOLD: 0.10, // 10% value is high value
+    // Confidence levels
+    CONFIDENCE: {
+        LOW: 50,
+        MEDIUM: 65,
+        HIGH: 80,
+        VERY_HIGH: 90,
+    },
+    // Bankroll management
+    DEFAULT_BANKROLL: 1000,
+    MAX_STAKE_PERCENTAGE: 0.05, // Max 5% of bankroll per bet
+};
+// ============= Position Types =============
+export const POSITIONS = {
+    GOALKEEPER: 'GK',
+    DEFENDER: 'DF',
+    MIDFIELDER: 'MF',
+    FORWARD: 'FW',
+    SUBSTITUTE: 'SUB',
+};
+// ============= Match Status =============
+export const MATCH_STATUS = {
+    SCHEDULED: 'scheduled',
+    LIVE: 'live',
+    FINISHED: 'finished',
+    POSTPONED: 'postponed',
+    CANCELLED: 'cancelled',
+    ABANDONED: 'abandoned',
+};
+// ============= Error Messages =============
+export const ERRORS = {
+    NO_API_KEY: 'No API key configured. Please set environment variables.',
+    RATE_LIMITED: 'API rate limit exceeded. Please try again later.',
+    NOT_FOUND: 'Requested data not found.',
+    TIMEOUT: 'Request timed out.',
+    INVALID_RESPONSE: 'Invalid response from API.',
+    ALL_PROVIDERS_FAILED: 'All data providers failed.',
+};
+// ============= Version Info =============
+export const MODULE_INFO = {
+    NAME: 'sports-module',
+    VERSION: '2.0.0',
+    DESCRIPTION: 'Football Intelligence System for MCP Server',
+};

package/dist/tools/sports/core/types.d.ts

@@ -0,0 +1,379 @@
+/**
+ * SPORTS MODULE TYPES
+ * Complete data models and interfaces for the football intelligence system
+ */
+export type Position = 'GK' | 'DF' | 'MF' | 'FW' | 'SUB';
+export type MatchStatus = 'scheduled' | 'live' | 'finished' | 'postponed' | 'cancelled' | 'abandoned';
+export type BetType = 'home' | 'draw' | 'away' | 'over' | 'under' | 'btts' | 'handicap';
+export type KellyVariant = 'full' | 'half' | 'quarter';
+export type QueryType = 'general' | 'h2h' | 'form' | 'news' | 'stats' | 'odds' | 'referee' | 'weather' | 'fatigue' | 'setpieces';
+export type ProviderType = 'api-football' | 'football-data' | 'sports-db' | 'scraper';
+export interface SearchQuery {
+    type: QueryType;
+    query: string;
+    priority: number;
+}
+export interface Score {
+    home: number;
+    away: number;
+    halfTime?: {
+        home: number;
+        away: number;
+    };
+    fullTime?: {
+        home: number;
+        away: number;
+    };
+    extraTime?: {
+        home: number;
+        away: number;
+    };
+    penalties?: {
+        home: number;
+        away: number;
+    };
+}
+export interface Team {
+    id: string;
+    name: string;
+    code?: string;
+    country: string;
+    founded?: number;
+    logo?: string;
+    venue?: string;
+    website?: string;
+    stats?: TeamStats;
+}
+export interface TeamStats {
+    matchesPlayed: number;
+    wins: number;
+    draws: number;
+    losses: number;
+    goalsFor: number;
+    goalsAgainst: number;
+    goalDifference: number;
+    points?: number;
+    position?: number;
+    xG?: number;
+    xGA?: number;
+    xGDiff?: number;
+    possessionAvg?: number;
+    shotsPerGame?: number;
+    shotsOnTargetPerGame?: number;
+    cornersPerGame?: number;
+    foulsPerGame?: number;
+    yellowCardsPerGame?: number;
+    redCardsPerGame?: number;
+    homeStats?: TeamStats;
+    awayStats?: TeamStats;
+    form?: 'W' | 'D' | 'L'[];
+}
+export interface Player {
+    id: string;
+    name: string;
+    age?: number;
+    nationality: string;
+    position: Position;
+    number?: number;
+    photo?: string;
+    team?: Team;
+    stats?: PlayerStats;
+    marketValue?: number;
+    injured?: boolean;
+    suspended?: boolean;
+}
+export interface PlayerStats {
+    season?: string;
+    league?: string;
+    matches: number;
+    starts: number;
+    minutes: number;
+    goals: number;
+    assists: number;
+    goalsPlusAssists?: number;
+    shots?: number;
+    shotsOnTarget?: number;
+    xG?: number;
+    xA?: number;
+    xGPlusXA?: number;
+    yellowCards: number;
+    redCards: number;
+    tackles?: number;
+    interceptions?: number;
+    dribbles?: number;
+    dribblesWon?: number;
+    passes?: number;
+    passAccuracy?: number;
+    keyPasses?: number;
+    aerialDuels?: number;
+    aerialDuelsWon?: number;
+}
+export interface League {
+    id: string;
+    name: string;
+    country: string;
+    code?: string;
+    season?: string;
+    type?: 'league' | 'cup' | 'playoff';
+    logo?: string;
+    standings?: TableEntry[];
+    topScorers?: PlayerStats[];
+    topAssists?: PlayerStats[];
+}
+export interface TableEntry {
+    position: number;
+    team: Team;
+    played: number;
+    won: number;
+    drawn: number;
+    lost: number;
+    goalsFor: number;
+    goalsAgainst: number;
+    goalDifference: number;
+    points: number;
+    form?: 'W' | 'D' | 'L'[];
+    homeRecord?: {
+        played: number;
+        won: number;
+        drawn: number;
+        lost: number;
+        goalsFor: number;
+        against: number;
+    };
+    awayRecord?: {
+        played: number;
+        won: number;
+        drawn: number;
+        lost: number;
+        goalsFor: number;
+        against: number;
+    };
+    lastFive?: {
+        result: 'W' | 'D' | 'L';
+        for: number;
+        against: number;
+    }[];
+}
+export interface Match {
+    id: string;
+    homeTeam: Team;
+    awayTeam: Team;
+    league: League;
+    date: Date;
+    status: MatchStatus;
+    venue?: string;
+    referee?: Referee;
+    score?: Score;
+    minute?: number;
+    extraMinute?: number;
+    half?: 'H1' | 'H2' | 'HT' | 'ET' | 'P';
+    odds?: MatchOdds;
+    attendance?: number;
+    weather?: WeatherInfo;
+    homeLineup?: Player[];
+    awayLineup?: Player[];
+    homeSubstitutes?: Player[];
+    awaySubstitutes?: Player[];
+    events?: MatchEvent[];
+}
+export interface MatchOdds {
+    homeWin: number;
+    draw: number;
+    awayWin: number;
+    asianHandicap?: {
+        home: number;
+        away: number;
+        line: number;
+    };
+    overUnder?: {
+        line: number;
+        over: number;
+        under: number;
+    };
+    btts?: {
+        yes: number;
+        no: number;
+    };
+    provider: string;
+    timestamp: Date;
+    opening?: MatchOdds;
+}
+export interface MatchEvent {
+    id: string;
+    type: 'goal' | 'card' | 'substitution' | 'var' | 'injury' | 'whistle';
+    team: 'home' | 'away';
+    player?: Player;
+    assistPlayer?: Player;
+    minute: number;
+    extraMinute?: number;
+    detail?: string;
+}
+export interface Referee {
+    id: string;
+    name: string;
+    country: string;
+    age?: number;
+    photo?: string;
+    stats: RefereeStats;
+}
+export interface RefereeStats {
+    matches: number;
+    yellowCardsAvg: number;
+    redCardsAvg: number;
+    penaltiesAvg: number;
+    homeWinRate: number;
+    awayWinRate: number;
+    drawRate: number;
+    avgGoals: number;
+}
+export interface ValueBet {
+    match: Match;
+    betType: BetType;
+    fairOdds: number;
+    marketOdds: number;
+    value: number;
+    confidence: number;
+    kellyFraction?: number;
+    recommendedStake?: number;
+    reasoning: string;
+}
+export interface WeatherInfo {
+    temperature?: number;
+    condition?: string;
+    humidity?: number;
+    windSpeed?: number;
+    windDirection?: string;
+    precipitation?: number;
+}
+export interface TransferNews {
+    id: string;
+    player: Player;
+    fromTeam?: Team;
+    toTeam?: Team;
+    type: 'rumor' | 'confirmed' | 'loan' | 'free_transfer';
+    fee?: number;
+    feeFormatted?: string;
+    source: string;
+    timestamp: Date;
+    reliability?: 'low' | 'medium' | 'high';
+}
+export interface HeadToHead {
+    homeTeam: Team;
+    awayTeam: Team;
+    totalMatches: number;
+    homeWins: number;
+    draws: number;
+    awayWins: number;
+    homeGoals: number;
+    awayGoals: number;
+    recentMatches: Match[];
+}
+export interface Formation {
+    name: string;
+    defenders: number;
+    midfielders: number;
+    forwards: number;
+}
+export interface TacticalAnalysis {
+    homeFormation?: Formation;
+    awayFormation?: Formation;
+    homeStyle?: string;
+    awayStyle?: string;
+    keyBattles?: TacticalBattle[];
+    strengths?: {
+        home: string[];
+        away: string[];
+    };
+    weaknesses?: {
+        home: string[];
+        away: string[];
+    };
+}
+export interface TacticalBattle {
+    area: string;
+    homePlayer?: Player;
+    awayPlayer?: Player;
+    analysis: string;
+    advantage?: 'home' | 'away' | 'neutral';
+}
+export interface FatigueInfo {
+    team: Team;
+    daysSinceLastMatch: number;
+    lastMatch?: Match;
+    upcomingMatches?: Match[];
+    travelDistance?: number;
+    squadDepth?: number;
+    injuries: number;
+    suspensions: number;
+    fatigueScore: number;
+}
+export interface SetPieceStats {
+    team: Team;
+    cornersPerGame: number;
+    cornersConcededPerGame: number;
+    freeKicksPerGame: number;
+    goalsFromCorners: number;
+    goalsFromFreeKicks: number;
+    concededFromCorners: number;
+    concededFromFreeKicks: number;
+    aerialDuelsWon: number;
+    aerialDuelsTotal: number;
+    aerialWinRate: number;
+}
+export interface WatchlistAlert {
+    id: string;
+    type: 'match' | 'odds' | 'news' | 'injury';
+    target: string;
+    condition: string;
+    triggered: boolean;
+    createdAt: Date;
+    triggeredAt?: Date;
+    data?: any;
+}
+export interface CacheEntry<T = any> {
+    key: string;
+    data: T;
+    timestamp: number;
+    ttl: number;
+    hits: number;
+}
+export interface APIResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    provider?: ProviderType;
+    cached?: boolean;
+    rateLimited?: boolean;
+}
+export interface ProviderStatus {
+    name: ProviderType;
+    available: boolean;
+    quotaRemaining: number;
+    quotaLimit: number;
+    rateLimitUntil?: Date;
+    lastCall?: Date;
+}
+export interface ComparisonResult {
+    teamA: Team;
+    teamB: Team;
+    metrics: ComparisonMetric[];
+    winner?: 'A' | 'B' | 'draw';
+    summary: string;
+}
+export interface ComparisonMetric {
+    name: string;
+    teamAValue: number | string;
+    teamBValue: number | string;
+    winner?: 'A' | 'B' | 'draw';
+    importance: 'high' | 'medium' | 'low';
+    analysis?: string;
+}
+export interface LiveScoreUpdate {
+    matchId: string;
+    homeTeam: string;
+    awayTeam: string;
+    score: Score;
+    minute: number;
+    events: MatchEvent[];
+    timestamp: Date;
+}

package/dist/tools/sports/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * SPORTS MODULE TYPES
+ * Complete data models and interfaces for the football intelligence system
+ */
+export {};

package/dist/tools/sports/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SPORTS MODULE INDEX
+ * Main entry point - Exports all sports functionality
+ */
+export * from './core/constants.js';
+export * from './core/types.js';
+export * from './core/cache.js';
+export * from './core/base.js';
+export * from './providers/api.js';
+export * from './providers/scraper.js';
+export * from './providers/search.js';
+export { getGlobalCache, resetGlobalCache, CacheService, } from './core/cache.js';
+export { createAPIProvider, } from './providers/api.js';
+export { getSearchProvider, resetSearchProvider, SearchProvider, } from './providers/search.js';
+export { scrapeMatchContent, findBestMatchUrl, } from './providers/scraper.js';
+export * from './utils/calculator.js';
+export * from './utils/formatter.js';
+export { formatMatchesTable, formatComparisonResult, formatPlayerStats, formatMatchRow, formatScore, formatMatchStatus, formatHeadToHead, } from './utils/formatter.js';
+/**
+ * Initialize the sports module with custom configuration
+ */
+export declare function initializeSportsModule(config?: {
+    cachePath?: string;
+    cacheTTL?: number;
+}): Promise<void>;
+/**
+ * Get sports module status
+ */
+export declare function getSportsModuleStatus(): {
+    version: string;
+    providers: string[];
+    searchProviders: string[];
+    cacheEnabled: boolean;
+};

package/dist/tools/sports/index.js

@@ -0,0 +1,50 @@
+/**
+ * SPORTS MODULE INDEX
+ * Main entry point - Exports all sports functionality
+ */
+// ============= Core Exports =============
+export * from './core/constants.js';
+export * from './core/types.js';
+export * from './core/cache.js';
+export * from './core/base.js';
+// ============= Provider Exports =============
+export * from './providers/api.js';
+export * from './providers/scraper.js';
+export * from './providers/search.js';
+// Re-exports for convenience
+export { getGlobalCache, resetGlobalCache, CacheService, } from './core/cache.js';
+export { createAPIProvider, } from './providers/api.js';
+export { getSearchProvider, resetSearchProvider, SearchProvider, } from './providers/search.js';
+export { scrapeMatchContent, findBestMatchUrl, } from './providers/scraper.js';
+// ============= Utility Exports =============
+export * from './utils/calculator.js';
+export * from './utils/formatter.js';
+// Re-export specific utility functions for convenience
+export { formatMatchesTable, formatComparisonResult, formatPlayerStats, formatMatchRow, formatScore, formatMatchStatus, formatHeadToHead, } from './utils/formatter.js';
+// ============= Utility Functions =============
+/**
+ * Initialize the sports module with custom configuration
+ */
+export async function initializeSportsModule(config) {
+    const { getGlobalCache } = await import('./core/cache.js');
+    // Initialize cache with config if provided
+    if (config?.cachePath || config?.cacheTTL) {
+        // Cache is already initialized, but we could add reconfiguration here
+    }
+}
+/**
+ * Get sports module status
+ */
+export function getSportsModuleStatus() {
+    const { MODULE_INFO } = require('./core/constants.js');
+    const apiProvider = require('./providers/api.js').createAPIProvider();
+    const searchProvider = require('./providers/search.js').getSearchProvider();
+    return {
+        version: MODULE_INFO.VERSION,
+        providers: apiProvider.getStatus().available
+            ? ['api-football', 'football-data', 'sports-db'].filter((p) => process.env[`${p.replace('-', '_').toUpperCase()}_KEY`])
+            : [],
+        searchProviders: searchProvider.getAvailableProviders(),
+        cacheEnabled: true,
+    };
+}

package/dist/tools/sports/providers/api.d.ts

@@ -0,0 +1,73 @@
+/**
+ * SPORTS MODULE API PROVIDERS
+ * Concrete implementations of football API providers
+ */
+import { Match, Team, Player, TableEntry, APIResponse } from '../core/types.js';
+import { APIProviderBase, FallbackProvider } from '../core/base.js';
+/**
+ * API-Football Provider (via RapidAPI)
+ * Documentation: https://rapidapi.com/api-sports/api/api-football
+ */
+export declare class APIFootballProvider extends APIProviderBase {
+    constructor();
+    protected getAuthHeaders(): Record<string, string>;
+    protected transformResponse<T>(data: any): T;
+    getMatch(matchId: string): Promise<APIResponse<Match>>;
+    getLiveMatches(leagueId?: string): Promise<APIResponse<Match[]>>;
+    getStandings(leagueId: string, season?: string): Promise<APIResponse<TableEntry[]>>;
+    getTeam(teamId: string): Promise<APIResponse<Team>>;
+    getPlayer(playerId: string): Promise<APIResponse<Player>>;
+    searchTeams(query: string): Promise<APIResponse<Team[]>>;
+    searchPlayers(query: string): Promise<APIResponse<Player[]>>;
+    private transformMatch;
+    private transformTeam;
+    private transformPlayer;
+    private transformTableEntry;
+    private mapStatus;
+    private mapPosition;
+}
+/**
+ * Football-Data.org Provider
+ * Documentation: https://www.football-data.org/
+ */
+export declare class FootballDataProvider extends APIProviderBase {
+    constructor();
+    protected getAuthHeaders(): Record<string, string>;
+    protected transformResponse<T>(data: any): T;
+    getMatch(matchId: string): Promise<APIResponse<Match>>;
+    getLiveMatches(leagueId?: string): Promise<APIResponse<Match[]>>;
+    getStandings(leagueId: string, season?: string): Promise<APIResponse<TableEntry[]>>;
+    getTeam(teamId: string): Promise<APIResponse<Team>>;
+    getPlayer(playerId: string): Promise<APIResponse<Player>>;
+    searchTeams(query: string): Promise<APIResponse<Team[]>>;
+    searchPlayers(query: string): Promise<APIResponse<Player[]>>;
+    private transformMatchFD;
+    private transformTeamFD;
+    private transformTableEntryFD;
+    private mapStatusFD;
+}
+/**
+ * TheSportsDB Provider
+ * Documentation: https://www.thesportsdb.com/api.php
+ */
+export declare class SportsDBProvider extends APIProviderBase {
+    constructor();
+    protected getAuthHeaders(): Record<string, string>;
+    protected transformResponse<T>(data: any): T;
+    getMatch(matchId: string): Promise<APIResponse<Match>>;
+    getLiveMatches(): Promise<APIResponse<Match[]>>;
+    getStandings(leagueId: string): Promise<APIResponse<TableEntry[]>>;
+    getTeam(teamId: string): Promise<APIResponse<Team>>;
+    getPlayer(playerId: string): Promise<APIResponse<Player>>;
+    searchTeams(query: string): Promise<APIResponse<Team[]>>;
+    searchPlayers(query: string): Promise<APIResponse<Player[]>>;
+    private transformMatchDB;
+    private transformTeamDB;
+    private transformPlayerDB;
+    private transformTableEntryDB;
+    private mapPositionDB;
+}
+/**
+ * Create a fallback provider with all available API providers
+ */
+export declare function createAPIProvider(): FallbackProvider;