chore: import upstream snapshot with attribution

apps/sim/tools/calcom/get_slots.ts

@@ -0,0 +1,173 @@
+import type { ToolConfig, ToolResponse } from '@/tools/types'
+
+export interface CalcomGetSlotsParams {
+  accessToken: string
+  start: string
+  end: string
+  eventTypeId?: number
+  eventTypeSlug?: string
+  username?: string
+  timeZone?: string
+  duration?: number
+}
+
+export interface CalcomGetSlotsResponse extends ToolResponse {
+  output: {
+    status: string
+    /** Slots grouped by date (YYYY-MM-DD format) */
+    data: Record<
+      string,
+      Array<{
+        /** ISO 8601 timestamp of slot start time */
+        start: string
+        /** ISO 8601 timestamp of slot end time (only when format=range) */
+        end?: string
+        /** Number of attendees already booked (for seated events) */
+        attendeesCount?: number
+        /** Booking UID (for seated events) */
+        bookingUid?: string
+      }>
+    >
+  }
+}
+
+export const getSlotsTool: ToolConfig<CalcomGetSlotsParams, CalcomGetSlotsResponse> = {
+  id: 'calcom_get_slots',
+  name: 'Cal.com Get Slots',
+  description: 'Get available booking slots for a Cal.com event type within a time range',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'calcom',
+  },
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'Cal.com OAuth access token',
+    },
+    start: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Start of time range in UTC ISO 8601 format (e.g., 2024-01-15T00:00:00Z)',
+    },
+    end: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'End of time range in UTC ISO 8601 format (e.g., 2024-01-22T00:00:00Z)',
+    },
+    eventTypeId: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Event type ID for direct lookup',
+    },
+    eventTypeSlug: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Event type slug (requires username to be set)',
+    },
+    username: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Username for personal event types (required when using eventTypeSlug)',
+    },
+    timeZone: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Timezone for returned slots (defaults to UTC)',
+    },
+    duration: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Slot length in minutes',
+    },
+  },
+
+  request: {
+    url: (params: CalcomGetSlotsParams) => {
+      const baseUrl = 'https://api.cal.com/v2/slots'
+      const queryParams: string[] = []
+
+      queryParams.push(`start=${encodeURIComponent(params.start)}`)
+      queryParams.push(`end=${encodeURIComponent(params.end)}`)
+
+      if (
+        params.eventTypeId !== undefined &&
+        params.eventTypeId !== null &&
+        !Number.isNaN(params.eventTypeId) &&
+        String(params.eventTypeId) !== ''
+      ) {
+        queryParams.push(`eventTypeId=${params.eventTypeId}`)
+      }
+
+      if (params.eventTypeSlug) {
+        queryParams.push(`eventTypeSlug=${encodeURIComponent(params.eventTypeSlug)}`)
+      }
+
+      if (params.username) {
+        queryParams.push(`username=${encodeURIComponent(params.username)}`)
+      }
+
+      if (params.timeZone) {
+        queryParams.push(`timeZone=${encodeURIComponent(params.timeZone)}`)
+      }
+
+      if (
+        params.duration !== undefined &&
+        params.duration !== null &&
+        !Number.isNaN(params.duration) &&
+        String(params.duration) !== ''
+      ) {
+        queryParams.push(`duration=${params.duration}`)
+      }
+
+      return `${baseUrl}?${queryParams.join('&')}`
+    },
+    method: 'GET',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.accessToken}`,
+      'Content-Type': 'application/json',
+      'cal-api-version': '2024-09-04',
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      return {
+        success: false,
+        output: data,
+        error:
+          data.error?.message || data.message || `Request failed with status ${response.status}`,
+      }
+    }
+
+    return {
+      success: true,
+      output: data,
+    }
+  },
+
+  outputs: {
+    status: {
+      type: 'string',
+      description: 'Response status',
+    },
+    data: {
+      type: 'json',
+      description:
+        'Available time slots grouped by date (YYYY-MM-DD keys). Each date maps to an array of slot objects with start time, optional end time, and seated event info.',
+    },
+  },
+}