@gotza02/sequential-thinking 2026.2.40 → 2026.2.42

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

@@ -0,0 +1,179 @@
+/**
+ * SPORTS MODULE CONSTANTS
+ * Configuration values for the football intelligence system
+ */
+export declare const API_CONFIG: {
+    readonly API_FOOTBALL_KEY: string;
+    readonly API_FOOTBALL_BASE: "https://api-football-v1.p.rapidapi.com/v3";
+    readonly API_FOOTBALL_HOST: "api-football-v1.p.rapidapi.com";
+    readonly FOOTBALL_DATA_KEY: string;
+    readonly FOOTBALL_DATA_BASE: "https://api.football-data.org/v4";
+    readonly SPORTS_DB_KEY: string;
+    readonly SPORTS_DB_BASE: "https://www.thesportsdb.com/api/v1/json";
+    readonly RATE_LIMITS: {
+        readonly API_FOOTBALL: 10;
+        readonly FOOTBALL_DATA: 10;
+        readonly SPORTS_DB: 30;
+    };
+};
+export declare const CACHE_CONFIG: {
+    readonly DEFAULT_TTL: number;
+    readonly TTL: {
+        readonly LIVE_SCORES: number;
+        readonly MATCH_DETAILS: number;
+        readonly STANDINGS: number;
+        readonly TEAM_STATS: number;
+        readonly PLAYER_STATS: number;
+        readonly ODDS: number;
+        readonly TRANSFER_NEWS: number;
+    };
+    readonly CACHE_PATH: string;
+    readonly MAX_SIZE: 1000;
+};
+export declare const SCRAPER_CONFIG: {
+    readonly PRIORITY_DOMAINS: readonly ["whoscored.com", "sofascore.com", "flashscore.com", "understat.com", "fbref.com", "bbc.co.uk/sport", "skysports.com", "sportsmole.co.uk", "goal.com", "thesquareball.net"];
+    readonly TIMEOUT: 15000;
+    readonly USER_AGENT: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36";
+    readonly MAX_CONTENT_LENGTH: 50000;
+};
+export declare const LEAGUES: {
+    readonly PREMIER_LEAGUE: {
+        readonly id: 39;
+        readonly name: "Premier League";
+        readonly country: "England";
+        readonly code: "PL";
+    };
+    readonly LA_LIGA: {
+        readonly id: 140;
+        readonly name: "La Liga";
+        readonly country: "Spain";
+        readonly code: "LL";
+    };
+    readonly BUNDESLIGA: {
+        readonly id: 78;
+        readonly name: "Bundesliga";
+        readonly country: "Germany";
+        readonly code: "BL1";
+    };
+    readonly SERIE_A: {
+        readonly id: 135;
+        readonly name: "Serie A";
+        readonly country: "Italy";
+        readonly code: "SA";
+    };
+    readonly LIGUE_1: {
+        readonly id: 61;
+        readonly name: "Ligue 1";
+        readonly country: "France";
+        readonly code: "FL1";
+    };
+    readonly EREDIVISIE: {
+        readonly id: 88;
+        readonly name: "Eredivisie";
+        readonly country: "Netherlands";
+        readonly code: "DED";
+    };
+    readonly PRIMEIRA_LIGA: {
+        readonly id: 94;
+        readonly name: "Primeira Liga";
+        readonly country: "Portugal";
+        readonly code: "PPL";
+    };
+    readonly CHAMPIONS_LEAGUE: {
+        readonly id: 2;
+        readonly name: "UEFA Champions League";
+        readonly country: "Europe";
+        readonly code: "CL";
+    };
+    readonly EUROPA_LEAGUE: {
+        readonly id: 3;
+        readonly name: "UEFA Europa League";
+        readonly country: "Europe";
+        readonly code: "EL";
+    };
+    readonly FA_CUP: {
+        readonly id: 45;
+        readonly name: "FA Cup";
+        readonly country: "England";
+        readonly code: "FAC";
+    };
+    readonly J_LEAGUE: {
+        readonly id: 98;
+        readonly name: "J1 League";
+        readonly country: "Japan";
+        readonly code: "J1";
+    };
+    readonly K_LEAGUE: {
+        readonly id: 251;
+        readonly name: "K League 1";
+        readonly country: "South Korea";
+        readonly code: "KL1";
+    };
+    readonly THAI_LEAGUE: {
+        readonly id: 305;
+        readonly name: "Thai League 1";
+        readonly country: "Thailand";
+        readonly code: "TL1";
+    };
+    readonly CSL: {
+        readonly id: 169;
+        readonly name: "Chinese Super League";
+        readonly country: "China";
+        readonly code: "CSL";
+    };
+};
+export declare const QUERY_TYPES: {
+    readonly GENERAL: "general";
+    readonly H2H: "h2h";
+    readonly FORM: "form";
+    readonly NEWS: "news";
+    readonly STATS: "stats";
+    readonly ODDS: "odds";
+    readonly REFEREE: "referee";
+    readonly WEATHER: "weather";
+    readonly FATIGUE: "fatigue";
+    readonly SETPIECES: "setpieces";
+};
+export declare const BETTING: {
+    readonly KELLY_FULL: "full";
+    readonly KELLY_HALF: "half";
+    readonly KELLY_QUARTER: "quarter";
+    readonly VALUE_THRESHOLD: 0.05;
+    readonly HIGH_VALUE_THRESHOLD: 0.1;
+    readonly CONFIDENCE: {
+        readonly LOW: 50;
+        readonly MEDIUM: 65;
+        readonly HIGH: 80;
+        readonly VERY_HIGH: 90;
+    };
+    readonly DEFAULT_BANKROLL: 1000;
+    readonly MAX_STAKE_PERCENTAGE: 0.05;
+};
+export declare const POSITIONS: {
+    readonly GOALKEEPER: "GK";
+    readonly DEFENDER: "DF";
+    readonly MIDFIELDER: "MF";
+    readonly FORWARD: "FW";
+    readonly SUBSTITUTE: "SUB";
+};
+export declare const MATCH_STATUS: {
+    readonly SCHEDULED: "scheduled";
+    readonly LIVE: "live";
+    readonly FINISHED: "finished";
+    readonly POSTPONED: "postponed";
+    readonly CANCELLED: "cancelled";
+    readonly ABANDONED: "abandoned";
+};
+export declare const ERRORS: {
+    readonly NO_API_KEY: "No API key configured. Please set environment variables.";
+    readonly RATE_LIMITED: "API rate limit exceeded. Please try again later.";
+    readonly NOT_FOUND: "Requested data not found.";
+    readonly TIMEOUT: "Request timed out.";
+    readonly INVALID_RESPONSE: "Invalid response from API.";
+    readonly ALL_PROVIDERS_FAILED: "All data providers failed.";
+};
+export declare const MODULE_INFO: {
+    readonly NAME: "sports-module";
+    readonly VERSION: "2.0.0";
+    readonly DESCRIPTION: "Football Intelligence System for MCP Server";
+};

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 {};