import { ErrorExtractorId } from '@/tools/error-extractors' import type { CustomerResponse, UpdateCustomerParams } from '@/tools/square/types' import { CUSTOMER_METADATA_OUTPUT_PROPERTIES, CUSTOMER_OUTPUT, SQUARE_BASE_URL, squareHeaders, } from '@/tools/square/types' import type { ToolConfig } from '@/tools/types' export const squareUpdateCustomerTool: ToolConfig = { id: 'square_update_customer', name: 'Square Update Customer', description: 'Update fields on an existing customer profile', version: '1.0.0', errorExtractor: ErrorExtractorId.SQUARE_ERRORS, params: { apiKey: { type: 'string', required: true, visibility: 'user-only', description: 'Square access token (personal access token)', }, customerId: { type: 'string', required: true, visibility: 'user-or-llm', description: 'ID of the customer to update', }, givenName: { type: 'string', required: false, visibility: 'user-or-llm', description: 'First name of the customer', }, familyName: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Last name of the customer', }, companyName: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Business name of the customer', }, nickname: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Nickname of the customer', }, emailAddress: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Email address of the customer', }, phoneNumber: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Phone number of the customer', }, birthday: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Birthday in YYYY-MM-DD or MM-DD format', }, note: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Note about the customer', }, referenceId: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Optional external reference for the customer', }, address: { type: 'json', required: false, visibility: 'user-or-llm', description: 'Square address object for the customer', }, }, request: { url: (params) => `${SQUARE_BASE_URL}/v2/customers/${encodeURIComponent(params.customerId)}`, method: 'PUT', headers: (params) => squareHeaders(params.apiKey), body: (params) => { const body: Record = {} if (params.givenName !== undefined) body.given_name = params.givenName if (params.familyName !== undefined) body.family_name = params.familyName if (params.companyName !== undefined) body.company_name = params.companyName if (params.nickname !== undefined) body.nickname = params.nickname if (params.emailAddress !== undefined) body.email_address = params.emailAddress if (params.phoneNumber !== undefined) body.phone_number = params.phoneNumber if (params.birthday !== undefined) body.birthday = params.birthday if (params.note !== undefined) body.note = params.note if (params.referenceId !== undefined) body.reference_id = params.referenceId if (params.address !== undefined) body.address = params.address return body }, }, transformResponse: async (response) => { const data = await response.json() const customer = data.customer ?? {} return { success: true, output: { customer, metadata: { id: customer.id, email_address: customer.email_address ?? null, given_name: customer.given_name ?? null, family_name: customer.family_name ?? null, }, }, } }, outputs: { customer: { ...CUSTOMER_OUTPUT, description: 'The updated customer object' }, metadata: { type: 'json', description: 'Customer summary metadata', properties: CUSTOMER_METADATA_OUTPUT_PROPERTIES, }, }, }