import { createLogger } from '@sim/logger' import type { HubSpotListEmailsParams, HubSpotListEmailsResponse } from '@/tools/hubspot/types' import { EMAILS_ARRAY_OUTPUT, METADATA_OUTPUT, PAGING_OUTPUT } from '@/tools/hubspot/types' import type { ToolConfig } from '@/tools/types' const logger = createLogger('HubSpotListEmails') export const hubspotListEmailsTool: ToolConfig = { id: 'hubspot_list_emails', name: 'List Emails from HubSpot', description: 'Retrieve all email engagements from HubSpot account with pagination support', version: '1.0.0', oauth: { required: true, provider: 'hubspot', }, params: { accessToken: { type: 'string', required: true, visibility: 'hidden', description: 'The access token for the HubSpot API', }, limit: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Maximum number of results per page (max 100, default 10)', }, after: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Pagination cursor for next page of results (from previous response)', }, properties: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Comma-separated list of HubSpot property names to return (e.g., "hs_email_subject,hs_email_text,hs_timestamp")', }, associations: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Comma-separated list of object types to retrieve associated IDs for (e.g., "contacts,companies,deals")', }, }, request: { url: (params) => { const baseUrl = 'https://api.hubapi.com/crm/v3/objects/emails' const queryParams = new URLSearchParams() if (params.limit) { queryParams.append('limit', params.limit) } if (params.after) { queryParams.append('after', params.after) } if (params.properties) { queryParams.append('properties', params.properties) } if (params.associations) { queryParams.append('associations', params.associations) } const queryString = queryParams.toString() return queryString ? `${baseUrl}?${queryString}` : baseUrl }, method: 'GET', headers: (params) => { if (!params.accessToken) { throw new Error('Access token is required') } return { Authorization: `Bearer ${params.accessToken}`, 'Content-Type': 'application/json', } }, }, transformResponse: async (response: Response) => { const data = await response.json() if (!response.ok) { logger.error('HubSpot API request failed', { data, status: response.status }) throw new Error(data.message || 'Failed to list emails from HubSpot') } return { success: true, output: { emails: data.results || [], paging: data.paging ?? null, metadata: { totalReturned: data.results?.length || 0, hasMore: !!data.paging?.next, }, success: true, }, } }, outputs: { emails: EMAILS_ARRAY_OUTPUT, paging: PAGING_OUTPUT, metadata: METADATA_OUTPUT, success: { type: 'boolean', description: 'Operation success status' }, }, }