simstudioai--sim/apps/sim/tools/zendesk/search.ts

import type { ToolConfig } from '@/tools/types'
import {
  appendCursorPaginationParams,
  buildZendeskUrl,
  extractCursorPagingInfo,
  handleZendeskError,
  METADATA_OUTPUT,
  PAGING_OUTPUT,
} from '@/tools/zendesk/types'

export interface ZendeskSearchParams {
  email: string
  apiToken: string
  subdomain: string
  query: string
  filterType: string
  perPage?: string
  pageAfter?: string
}

export interface ZendeskSearchResponse {
  success: boolean
  output: {
    results: any[]
    paging?: {
      after_cursor: string | null
      has_more: boolean
    }
    metadata: {
      total_returned: number
      has_more: boolean
    }
    success: boolean
  }
}

export const zendeskSearchTool: ToolConfig<ZendeskSearchParams, ZendeskSearchResponse> = {
  id: 'zendesk_search',
  name: 'Search Zendesk',
  description: 'Unified search across tickets, users, and organizations in Zendesk',
  version: '1.0.0',

  params: {
    email: {
      type: 'string',
      required: true,
      visibility: 'user-only',
      description: 'Your Zendesk email address',
    },
    apiToken: {
      type: 'string',
      required: true,
      visibility: 'hidden',
      description: 'Zendesk API token',
    },
    subdomain: {
      type: 'string',
      required: true,
      visibility: 'user-only',
      description: 'Your Zendesk subdomain',
    },
    query: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description:
        'Search query string using Zendesk search syntax (e.g., "type:ticket status:open")',
    },
    filterType: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Resource type to search for: "ticket", "user", "organization", or "group"',
    },
    perPage: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Results per page as a number string (default: "100", max: "100")',
    },
    pageAfter: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Cursor from a previous response to fetch the next page of results',
    },
  },

  request: {
    url: (params) => {
      const queryParams = new URLSearchParams()
      queryParams.append('query', params.query)
      queryParams.append('filter[type]', params.filterType)
      appendCursorPaginationParams(queryParams, params)

      const query = queryParams.toString()
      const url = buildZendeskUrl(params.subdomain, '/search/export')
      return `${url}?${query}`
    },
    method: 'GET',
    headers: (params) => {
      const credentials = `${params.email}/token:${params.apiToken}`
      const base64Credentials = Buffer.from(credentials).toString('base64')
      return {
        Authorization: `Basic ${base64Credentials}`,
        'Content-Type': 'application/json',
      }
    },
  },

  transformResponse: async (response: Response) => {
    if (!response.ok) {
      const data = await response.json()
      handleZendeskError(data, response.status, 'search')
    }

    const data = await response.json()
    const results = data.results || []
    const paging = extractCursorPagingInfo(data)

    return {
      success: true,
      output: {
        results,
        paging,
        metadata: {
          total_returned: results.length,
          has_more: paging.has_more,
        },
        success: true,
      },
    }
  },

  outputs: {
    results: {
      type: 'array',
      description:
        'Array of result objects (tickets, users, or organizations depending on search query)',
    },
    paging: PAGING_OUTPUT,
    metadata: METADATA_OUTPUT,
  },
}