chore: import upstream snapshot with attribution

apps/sim/tools/pipedrive/get_projects.ts

@@ -0,0 +1,148 @@
+import { createLogger } from '@sim/logger'
+import type {
+  PipedriveGetProjectsParams,
+  PipedriveGetProjectsResponse,
+} from '@/tools/pipedrive/types'
+import type { ToolConfig } from '@/tools/types'
+
+const logger = createLogger('PipedriveGetProjects')
+
+export const pipedriveGetProjectsTool: ToolConfig<
+  PipedriveGetProjectsParams,
+  PipedriveGetProjectsResponse
+> = {
+  id: 'pipedrive_get_projects',
+  name: 'Get Projects from Pipedrive',
+  description: 'Retrieve all projects or a specific project from Pipedrive',
+  version: '1.0.0',
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'The access token for the Pipedrive API',
+    },
+    project_id: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Optional: ID of a specific project to retrieve (e.g., "123")',
+    },
+    status: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter by project status: open, completed, deleted (only for listing all)',
+    },
+    limit: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Number of results to return (e.g., "50", default: 100, max: 500, only for listing all)',
+    },
+    cursor: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'For pagination, the marker representing the first item on the next page',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      // If project_id is provided, get specific project
+      if (params.project_id) {
+        return `https://api.pipedrive.com/v1/projects/${params.project_id}`
+      }
+
+      // Otherwise, get all projects with optional filters
+      const baseUrl = 'https://api.pipedrive.com/v1/projects'
+      const queryParams = new URLSearchParams()
+
+      if (params.status) queryParams.append('status', params.status)
+      if (params.limit) queryParams.append('limit', params.limit)
+      if (params.cursor) queryParams.append('cursor', params.cursor)
+
+      const queryString = queryParams.toString()
+      return queryString ? `${baseUrl}?${queryString}` : baseUrl
+    },
+    method: 'GET',
+    headers: (params) => {
+      if (!params.accessToken) {
+        throw new Error('Access token is required')
+      }
+
+      return {
+        Authorization: `Bearer ${params.accessToken}`,
+        Accept: 'application/json',
+      }
+    },
+  },
+
+  transformResponse: async (response: Response, params) => {
+    const data = await response.json()
+
+    if (!data.success) {
+      logger.error('Pipedrive API request failed', { data })
+      throw new Error(data.error || 'Failed to fetch project(s) from Pipedrive')
+    }
+
+    // If project_id was provided, return single project
+    if (params?.project_id) {
+      return {
+        success: true,
+        output: {
+          project: data.data ?? null,
+          success: true,
+        },
+      }
+    }
+
+    // Otherwise, return list of projects
+    const projects = data.data || []
+    const nextCursor = data.additional_data?.next_cursor ?? null
+    const hasMore = nextCursor !== null
+
+    return {
+      success: true,
+      output: {
+        projects,
+        total_items: projects.length,
+        has_more: hasMore,
+        next_cursor: nextCursor,
+        success: true,
+      },
+    }
+  },
+
+  outputs: {
+    projects: {
+      type: 'array',
+      description: 'Array of project objects (when listing all)',
+      optional: true,
+    },
+    project: {
+      type: 'object',
+      description: 'Single project object (when project_id is provided)',
+      optional: true,
+    },
+    total_items: {
+      type: 'number',
+      description: 'Total number of projects returned',
+      optional: true,
+    },
+    has_more: {
+      type: 'boolean',
+      description: 'Whether more projects are available',
+      optional: true,
+    },
+    next_cursor: {
+      type: 'string',
+      description: 'Cursor for fetching the next page',
+      optional: true,
+    },
+    success: { type: 'boolean', description: 'Operation success status' },
+  },
+}