simstudioai--sim/apps/sim/tools/jsm/get_requests.ts

import type { JsmGetRequestsParams, JsmGetRequestsResponse } from '@/tools/jsm/types'
import { REQUEST_ITEM_PROPERTIES } from '@/tools/jsm/types'
import type { ToolConfig } from '@/tools/types'

export const jsmGetRequestsTool: ToolConfig<JsmGetRequestsParams, JsmGetRequestsResponse> = {
  id: 'jsm_get_requests',
  name: 'JSM Get Requests',
  description: 'Get multiple service requests from Jira Service Management',
  version: '1.0.0',

  oauth: {
    required: true,
    provider: 'jira',
  },

  params: {
    accessToken: {
      type: 'string',
      required: true,
      visibility: 'hidden',
      description: 'OAuth access token for Jira Service Management',
    },
    domain: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Your Jira domain (e.g., yourcompany.atlassian.net)',
    },
    cloudId: {
      type: 'string',
      required: false,
      visibility: 'hidden',
      description: 'Jira Cloud ID for the instance',
    },
    serviceDeskId: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Filter by service desk ID (e.g., "1", "2")',
    },
    requestOwnership: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description:
        'Filter by ownership: OWNED_REQUESTS, PARTICIPATED_REQUESTS, APPROVER, ALL_REQUESTS',
    },
    requestStatus: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Filter by status: OPEN_REQUESTS, CLOSED_REQUESTS, ALL_REQUESTS',
    },
    requestTypeId: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Filter by request type ID',
    },
    searchTerm: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Search term to filter requests (e.g., "password reset", "laptop")',
    },
    expand: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description:
        'Comma-separated fields to expand: participant, status, sla, requestType, serviceDesk, attachment, comment, action',
    },
    start: {
      type: 'number',
      required: false,
      visibility: 'user-or-llm',
      description: 'Start index for pagination (e.g., 0, 50, 100)',
    },
    limit: {
      type: 'number',
      required: false,
      visibility: 'user-or-llm',
      description: 'Maximum results to return (e.g., 10, 25, 50)',
    },
  },

  request: {
    url: '/api/tools/jsm/requests',
    method: 'POST',
    headers: () => ({
      'Content-Type': 'application/json',
    }),
    body: (params) => ({
      domain: params.domain,
      accessToken: params.accessToken,
      cloudId: params.cloudId,
      serviceDeskId: params.serviceDeskId,
      requestOwnership: params.requestOwnership,
      requestStatus: params.requestStatus,
      requestTypeId: params.requestTypeId,
      searchTerm: params.searchTerm,
      expand: params.expand,
      start: params.start,
      limit: params.limit,
    }),
  },

  transformResponse: async (response: Response) => {
    const responseText = await response.text()

    if (!responseText) {
      return {
        success: false,
        output: {
          ts: new Date().toISOString(),
          requests: [],
          total: 0,
          isLastPage: true,
        },
        error: 'Empty response from API',
      }
    }

    const data = JSON.parse(responseText)

    if (data.success && data.output) {
      return data
    }

    return {
      success: data.success || false,
      output: data.output || {
        ts: new Date().toISOString(),
        requests: [],
        total: 0,
        isLastPage: true,
      },
      error: data.error,
    }
  },

  outputs: {
    ts: { type: 'string', description: 'Timestamp of the operation' },
    requests: {
      type: 'array',
      description: 'List of service requests',
      items: {
        type: 'object',
        properties: REQUEST_ITEM_PROPERTIES,
      },
    },
    total: { type: 'number', description: 'Total number of requests in current page' },
    isLastPage: { type: 'boolean', description: 'Whether this is the last page' },
  },
}