chore: import upstream snapshot with attribution

apps/sim/tools/linear/list_projects.ts

@@ -0,0 +1,162 @@
+import type { LinearListProjectsParams, LinearListProjectsResponse } from '@/tools/linear/types'
+import { PAGE_INFO_OUTPUT, PROJECT_FULL_OUTPUT_PROPERTIES } from '@/tools/linear/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const linearListProjectsTool: ToolConfig<
+  LinearListProjectsParams,
+  LinearListProjectsResponse
+> = {
+  id: 'linear_list_projects',
+  name: 'Linear List Projects',
+  description: 'List projects in Linear with optional filtering',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'linear',
+  },
+
+  params: {
+    teamId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter by team ID',
+    },
+    includeArchived: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Include archived projects',
+    },
+    first: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Number of projects to return (default: 50)',
+    },
+    after: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Cursor for pagination',
+    },
+  },
+
+  request: {
+    url: 'https://api.linear.app/graphql',
+    method: 'POST',
+    headers: (params) => {
+      if (!params.accessToken) {
+        throw new Error('Missing access token for Linear API request')
+      }
+      return {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${params.accessToken}`,
+      }
+    },
+    body: (params) => {
+      // Note: ProjectFilter does not support filtering by team directly
+      // We need to filter projects client-side by team if teamId is provided
+      return {
+        query: `
+          query ListProjects($first: Int, $after: String, $includeArchived: Boolean) {
+            projects(first: $first, after: $after, includeArchived: $includeArchived) {
+              nodes {
+                id
+                name
+                description
+                state
+                priority
+                startDate
+                targetDate
+                completedAt
+                canceledAt
+                archivedAt
+                url
+                lead {
+                  id
+                  name
+                }
+                teams {
+                  nodes {
+                    id
+                    name
+                  }
+                }
+              }
+              pageInfo {
+                hasNextPage
+                endCursor
+              }
+            }
+          }
+        `,
+        variables: {
+          first: params.first ? Number(params.first) : 50,
+          after: params.after?.trim() || undefined,
+          includeArchived: params.includeArchived || false,
+        },
+      }
+    },
+  },
+
+  transformResponse: async (response, params) => {
+    const data = await response.json()
+
+    if (data.errors) {
+      return {
+        success: false,
+        error: data.errors[0]?.message || 'Failed to list projects',
+        output: {},
+      }
+    }
+
+    const result = data.data.projects
+    let projects = result.nodes.map((project: any) => ({
+      id: project.id,
+      name: project.name,
+      description: project.description,
+      state: project.state,
+      priority: project.priority,
+      startDate: project.startDate,
+      targetDate: project.targetDate,
+      completedAt: project.completedAt,
+      canceledAt: project.canceledAt,
+      archivedAt: project.archivedAt,
+      url: project.url,
+      lead: project.lead,
+      teams: project.teams?.nodes || [],
+    }))
+
+    // Filter by teamId client-side if provided
+    if (params?.teamId) {
+      projects = projects.filter((project: any) =>
+        project.teams.some((team: any) => team.id === params.teamId)
+      )
+    }
+
+    return {
+      success: true,
+      output: {
+        projects,
+        pageInfo: {
+          hasNextPage: result.pageInfo.hasNextPage,
+          endCursor: result.pageInfo.endCursor,
+        },
+      },
+    }
+  },
+
+  outputs: {
+    projects: {
+      type: 'array',
+      description: 'Array of projects',
+      items: {
+        type: 'object',
+        properties: PROJECT_FULL_OUTPUT_PROPERTIES,
+      },
+    },
+    pageInfo: PAGE_INFO_OUTPUT,
+  },
+}