import { appendSportmonksQuery, buildSportmonksHeaders, handleSportmonksError, SPORTMONKS_PAGINATION_OUTPUT, type SportmonksBaseParams, type SportmonksPagination, type SportmonksPaginationParams, } from '@/tools/sportmonks/types' import { SPORTMONKS_FIXTURE_PROPERTIES, SPORTMONKS_FOOTBALL_BASE_URL, type SportmonksFixture, } from '@/tools/sportmonks_football/types' import type { ToolConfig, ToolResponse } from '@/tools/types' export interface SportmonksSearchFixturesParams extends SportmonksBaseParams, SportmonksPaginationParams { query: string } export interface SportmonksSearchFixturesResponse extends ToolResponse { output: { fixtures: SportmonksFixture[] pagination?: SportmonksPagination | null } } export const sportmonksSearchFixturesTool: ToolConfig< SportmonksSearchFixturesParams, SportmonksSearchFixturesResponse > = { id: 'sportmonks_football_search_fixtures', name: 'Search Fixtures', description: 'Search for football fixtures by name (participants) from Sportmonks', version: '1.0.0', params: { apiKey: { type: 'string', required: true, visibility: 'user-only', description: 'Sportmonks API token', }, query: { type: 'string', required: true, visibility: 'user-or-llm', description: 'The fixture name to search for (e.g. Celtic)', }, include: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Semicolon-separated relations to enrich the response (e.g. participants;scores)', }, filters: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Filters to apply (e.g. fixtureLeagues:501)', }, per_page: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Number of results per page (max 50, default 25)', }, page: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Page number to retrieve', }, order: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Order fixtures by starting_at (asc or desc)', }, }, request: { url: (params) => { const url = `${SPORTMONKS_FOOTBALL_BASE_URL}/fixtures/search/${encodeURIComponent(params.query.trim())}` return appendSportmonksQuery(url, params) }, method: 'GET', headers: (params) => buildSportmonksHeaders(params.apiKey), }, transformResponse: async (response: Response) => { const data = await response.json() if (!response.ok) { handleSportmonksError(data, response.status, 'search_fixtures') } return { success: true, output: { fixtures: Array.isArray(data.data) ? data.data : [], pagination: data.pagination ?? null, }, } }, outputs: { fixtures: { type: 'array', description: 'Array of fixture objects matching the search query', items: { type: 'object', properties: SPORTMONKS_FIXTURE_PROPERTIES }, }, pagination: SPORTMONKS_PAGINATION_OUTPUT, }, }