chore: import upstream snapshot with attribution

apps/sim/tools/github/get_project.ts

@@ -0,0 +1,246 @@
+import type { GetProjectParams, ProjectResponse } from '@/tools/github/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const getProjectTool: ToolConfig<GetProjectParams, ProjectResponse> = {
+  id: 'github_get_project',
+  name: 'GitHub Get Project',
+  description:
+    'Get detailed information about a specific GitHub Project V2 by its number. Returns project details including ID, title, description, URL, and status.',
+  version: '1.0.0',
+
+  params: {
+    owner_type: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Owner type: "org" for organization or "user" for user',
+    },
+    owner_login: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Organization or user login name',
+    },
+    project_number: {
+      type: 'number',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Project number',
+    },
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'GitHub Personal Access Token with project read permissions',
+    },
+  },
+
+  request: {
+    url: 'https://api.github.com/graphql',
+    method: 'POST',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.apiKey}`,
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => {
+      const ownerType = params.owner_type === 'org' ? 'organization' : 'user'
+      const query = `
+        query($login: String!, $number: Int!) {
+          ${ownerType}(login: $login) {
+            projectV2(number: $number) {
+              id
+              title
+              number
+              url
+              closed
+              public
+              shortDescription
+              readme
+              createdAt
+              updatedAt
+            }
+          }
+        }
+      `
+      return {
+        query,
+        variables: {
+          login: params.owner_login,
+          number: params.project_number,
+        },
+      }
+    },
+  },
+
+  transformResponse: async (response) => {
+    const data = await response.json()
+
+    if (data.errors) {
+      return {
+        success: false,
+        output: {
+          content: `GraphQL Error: ${data.errors[0].message}`,
+          metadata: {
+            id: '',
+            title: '',
+            url: '',
+          },
+        },
+        error: data.errors[0].message,
+      }
+    }
+
+    const ownerData = data.data?.organization || data.data?.user
+    if (!ownerData || !ownerData.projectV2) {
+      return {
+        success: false,
+        output: {
+          content: 'Project not found',
+          metadata: {
+            id: '',
+            title: '',
+            url: '',
+          },
+        },
+        error: 'Project not found',
+      }
+    }
+
+    const project = ownerData.projectV2
+
+    let content = `Project: ${project.title} (#${project.number})\n`
+    content += `ID: ${project.id}\n`
+    content += `URL: ${project.url}\n`
+    content += `Status: ${project.closed ? 'Closed' : 'Open'}\n`
+    content += `Visibility: ${project.public ? 'Public' : 'Private'}\n`
+    if (project.shortDescription) {
+      content += `Description: ${project.shortDescription}\n`
+    }
+    if (project.createdAt) {
+      content += `Created: ${project.createdAt}\n`
+    }
+    if (project.updatedAt) {
+      content += `Updated: ${project.updatedAt}\n`
+    }
+
+    return {
+      success: true,
+      output: {
+        content: content.trim(),
+        metadata: {
+          id: project.id,
+          title: project.title,
+          number: project.number,
+          url: project.url,
+          closed: project.closed,
+          public: project.public,
+          shortDescription: project.shortDescription || '',
+        },
+      },
+    }
+  },
+
+  outputs: {
+    content: { type: 'string', description: 'Human-readable project details' },
+    metadata: {
+      type: 'object',
+      description: 'Project metadata',
+      properties: {
+        id: { type: 'string', description: 'Project node ID' },
+        title: { type: 'string', description: 'Project title' },
+        number: { type: 'number', description: 'Project number', optional: true },
+        url: { type: 'string', description: 'Project URL' },
+        closed: { type: 'boolean', description: 'Whether project is closed', optional: true },
+        public: { type: 'boolean', description: 'Whether project is public', optional: true },
+        shortDescription: {
+          type: 'string',
+          description: 'Project short description',
+          optional: true,
+        },
+      },
+    },
+  },
+}
+
+export const getProjectV2Tool: ToolConfig<GetProjectParams, any> = {
+  id: 'github_get_project_v2',
+  name: getProjectTool.name,
+  description: getProjectTool.description,
+  version: '2.0.0',
+  params: getProjectTool.params,
+  request: getProjectTool.request,
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (data.errors) {
+      return {
+        success: false,
+        output: {
+          id: '',
+          title: '',
+          number: 0,
+          url: '',
+          closed: false,
+          public: false,
+          shortDescription: '',
+          readme: '',
+          createdAt: '',
+          updatedAt: '',
+        },
+        error: data.errors[0].message,
+      }
+    }
+
+    const ownerData = data.data?.organization || data.data?.user
+    const project = ownerData?.projectV2
+
+    if (!project) {
+      return {
+        success: false,
+        output: {
+          id: '',
+          title: '',
+          number: 0,
+          url: '',
+          closed: false,
+          public: false,
+          shortDescription: '',
+          readme: '',
+          createdAt: '',
+          updatedAt: '',
+        },
+        error: 'Project not found',
+      }
+    }
+
+    return {
+      success: true,
+      output: {
+        id: project.id,
+        title: project.title,
+        number: project.number,
+        url: project.url,
+        closed: project.closed,
+        public: project.public,
+        shortDescription: project.shortDescription ?? null,
+        readme: project.readme ?? null,
+        createdAt: project.createdAt,
+        updatedAt: project.updatedAt,
+      },
+    }
+  },
+
+  outputs: {
+    id: { type: 'string', description: 'Project node ID' },
+    title: { type: 'string', description: 'Project title' },
+    number: { type: 'number', description: 'Project number' },
+    url: { type: 'string', description: 'Project URL' },
+    closed: { type: 'boolean', description: 'Whether project is closed' },
+    public: { type: 'boolean', description: 'Whether project is public' },
+    shortDescription: { type: 'string', description: 'Short description', optional: true },
+    readme: { type: 'string', description: 'Project readme', optional: true },
+    createdAt: { type: 'string', description: 'Creation timestamp' },
+    updatedAt: { type: 'string', description: 'Last update timestamp' },
+  },
+}