import type { SalesforceGetCasesParams, SalesforceGetCasesResponse } from '@/tools/salesforce/types' import { QUERY_PAGING_OUTPUT, RESPONSE_METADATA_OUTPUT } from '@/tools/salesforce/types' import { extractErrorMessage, getInstanceUrl, requireId } from '@/tools/salesforce/utils' import type { ToolConfig } from '@/tools/types' export const salesforceGetCasesTool: ToolConfig< SalesforceGetCasesParams, SalesforceGetCasesResponse > = { id: 'salesforce_get_cases', name: 'Get Cases from Salesforce', description: 'Get case(s) from Salesforce', version: '1.0.0', oauth: { required: true, provider: 'salesforce', }, params: { accessToken: { type: 'string', required: true, visibility: 'hidden' }, idToken: { type: 'string', required: false, visibility: 'hidden' }, instanceUrl: { type: 'string', required: false, visibility: 'hidden' }, caseId: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Salesforce Case ID (18-character string starting with 500) to get a single case', }, limit: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Maximum number of results to return (default: 100)', }, fields: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Comma-separated list of field API names to return', }, orderBy: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Field and direction for sorting (e.g., CreatedDate DESC)', }, }, request: { url: (params) => { const instanceUrl = getInstanceUrl(params.idToken, params.instanceUrl) if (params.caseId) { const caseId = requireId(params.caseId, 'Case ID') const fields = params.fields || 'Id,CaseNumber,Subject,Status,Priority,Origin,ContactId,AccountId' return `${instanceUrl}/services/data/v59.0/sobjects/Case/${caseId}?fields=${encodeURIComponent(fields)}` } const limit = params.limit ? Number.parseInt(params.limit) : 100 const fields = params.fields || 'Id,CaseNumber,Subject,Status,Priority,Origin,ContactId,AccountId' const orderBy = params.orderBy || 'CreatedDate DESC' const query = `SELECT ${fields} FROM Case ORDER BY ${orderBy} LIMIT ${limit}` return `${instanceUrl}/services/data/v59.0/query?q=${encodeURIComponent(query)}` }, method: 'GET', headers: (params) => ({ Authorization: `Bearer ${params.accessToken}`, 'Content-Type': 'application/json', }), }, transformResponse: async (response, params?) => { const data = await response.json() if (!response.ok) throw new Error(extractErrorMessage(data, response.status, 'Failed to fetch cases')) if (params?.caseId) { return { success: true, output: { case: data, success: true }, } } const cases = data.records || [] return { success: true, output: { cases, paging: { nextRecordsUrl: data.nextRecordsUrl ?? null, totalSize: data.totalSize || cases.length, done: data.done !== false, }, metadata: { totalReturned: cases.length, hasMore: !data.done, }, success: true, }, } }, outputs: { success: { type: 'boolean', description: 'Operation success status' }, output: { type: 'object', description: 'Case data', properties: { case: { type: 'object', description: 'Single case object (when caseId provided)' }, cases: { type: 'array', description: 'Array of case objects (when listing)' }, paging: QUERY_PAGING_OUTPUT, metadata: RESPONSE_METADATA_OUTPUT, success: { type: 'boolean', description: 'Operation success status' }, }, }, }, }