import { buildMailchimpUrl, handleMailchimpError, type MailchimpMember, } from '@/tools/mailchimp/types' import type { ToolConfig } from '@/tools/types' export interface MailchimpGetMembersParams { apiKey: string listId: string status?: string count?: string offset?: string } export interface MailchimpGetMembersResponse { success: boolean output: { members: MailchimpMember[] total_items: number total_returned: number } } export const mailchimpGetMembersTool: ToolConfig< MailchimpGetMembersParams, MailchimpGetMembersResponse > = { id: 'mailchimp_get_members', name: 'Get Members from Mailchimp Audience', description: 'Retrieve a list of members from a Mailchimp audience', version: '1.0.0', params: { apiKey: { type: 'string', required: true, visibility: 'hidden', description: 'Mailchimp API key with server prefix', }, listId: { type: 'string', required: true, visibility: 'user-or-llm', description: 'The unique ID for the audience/list (e.g., "abc123def4")', }, status: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Filter by status: "subscribed", "unsubscribed", "cleaned", or "pending"', }, count: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Number of results to return (default: 10, max: 1000)', }, offset: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Number of results to skip for pagination', }, }, request: { url: (params) => { const queryParams = new URLSearchParams() if (params.status) queryParams.append('status', params.status) if (params.count) queryParams.append('count', params.count) if (params.offset) queryParams.append('offset', params.offset) const query = queryParams.toString() const url = buildMailchimpUrl(params.apiKey, `/lists/${params.listId}/members`) return query ? `${url}?${query}` : url }, method: 'GET', headers: (params) => ({ Authorization: `Bearer ${params.apiKey}`, 'Content-Type': 'application/json', }), }, transformResponse: async (response: Response) => { if (!response.ok) { const data = await response.json() handleMailchimpError(data, response.status, 'get_members') } const data = await response.json() const members = data.members || [] return { success: true, output: { members, total_items: data.total_items || members.length, total_returned: members.length, }, } }, outputs: { success: { type: 'boolean', description: 'Whether the members were successfully retrieved' }, output: { type: 'object', description: 'Members data', properties: { members: { type: 'json', description: 'Array of member objects' }, total_items: { type: 'number', description: 'Total number of members' }, total_returned: { type: 'number', description: 'Number of members returned in this response', }, }, }, }, }