import type { ListAllListsParams, ListsResult, SendGridList } from '@/tools/sendgrid/types' import type { ToolConfig } from '@/tools/types' export const sendGridListAllListsTool: ToolConfig = { id: 'sendgrid_list_all_lists', name: 'SendGrid List All Lists', description: 'Get all contact lists from SendGrid', version: '1.0.0', params: { apiKey: { type: 'string', required: true, visibility: 'user-only', description: 'SendGrid API key', }, pageSize: { type: 'number', required: false, visibility: 'user-or-llm', description: 'Number of lists to return per page (default: 100, max: 1000)', }, pageToken: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Page token from a previous response (nextPageToken) to fetch the next page', }, }, request: { url: (params) => { const url = new URL('https://api.sendgrid.com/v3/marketing/lists') if (params.pageSize) { url.searchParams.append('page_size', params.pageSize.toString()) } if (params.pageToken) { url.searchParams.append('page_token', params.pageToken) } return url.toString() }, method: 'GET', headers: (params) => ({ Authorization: `Bearer ${params.apiKey}`, }), }, transformResponse: async (response): Promise => { if (!response.ok) { const error = (await response.json()) as { errors?: Array<{ message?: string }> } throw new Error(error.errors?.[0]?.message || 'Failed to list all lists') } const data = (await response.json()) as { result?: SendGridList[] _metadata?: { next?: string } } let nextPageToken: string | null = null if (data._metadata?.next) { try { nextPageToken = new URL(data._metadata.next).searchParams.get('page_token') } catch { nextPageToken = null } } return { success: true, output: { lists: data.result || [], nextPageToken, }, } }, outputs: { lists: { type: 'json', description: 'Array of lists' }, nextPageToken: { type: 'string', description: 'Token to pass as pageToken to fetch the next page, if more results exist', optional: true, }, }, }