import { generateId } from '@sim/utils/id' import { ErrorExtractorId } from '@/tools/error-extractors' import type { CreateCustomerParams, CustomerResponse } 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 squareCreateCustomerTool: ToolConfig = { id: 'square_create_customer', name: 'Square Create Customer', description: 'Create a new customer profile in the Square customer directory', version: '1.0.0', errorExtractor: ErrorExtractorId.SQUARE_ERRORS, params: { apiKey: { type: 'string', required: true, visibility: 'user-only', description: 'Square access token (personal access token)', }, 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', }, idempotencyKey: { type: 'string', required: false, visibility: 'user-only', description: 'Unique key to make the request idempotent (auto-generated if omitted)', }, }, request: { url: () => `${SQUARE_BASE_URL}/v2/customers`, method: 'POST', headers: (params) => squareHeaders(params.apiKey), body: (params) => { const body: Record = { idempotency_key: params.idempotencyKey || generateId(), } if (params.givenName) body.given_name = params.givenName if (params.familyName) body.family_name = params.familyName if (params.companyName) body.company_name = params.companyName if (params.nickname) body.nickname = params.nickname if (params.emailAddress) body.email_address = params.emailAddress if (params.phoneNumber) body.phone_number = params.phoneNumber if (params.birthday) body.birthday = params.birthday if (params.note) body.note = params.note if (params.referenceId) body.reference_id = params.referenceId if (params.address) 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 created customer object' }, metadata: { type: 'json', description: 'Customer summary metadata', properties: CUSTOMER_METADATA_OUTPUT_PROPERTIES, }, }, }