simstudioai--sim/apps/sim/tools/linear/create_project_milestone.ts

import type {
  LinearCreateProjectMilestoneParams,
  LinearCreateProjectMilestoneResponse,
} from '@/tools/linear/types'
import { PROJECT_MILESTONE_OUTPUT_PROPERTIES } from '@/tools/linear/types'
import type { ToolConfig } from '@/tools/types'

export const linearCreateProjectMilestoneTool: ToolConfig<
  LinearCreateProjectMilestoneParams,
  LinearCreateProjectMilestoneResponse
> = {
  id: 'linear_create_project_milestone',
  name: 'Linear Create Project Milestone',
  description: 'Create a new project milestone in Linear',
  version: '1.0.0',

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

  params: {
    projectId: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Project ID',
    },
    name: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Milestone name',
    },
    description: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Milestone description',
    },
    targetDate: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Target date (ISO 8601)',
    },
  },

  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) => {
      const input: Record<string, any> = {
        projectId: params.projectId,
        name: params.name,
      }

      if (params.description != null && params.description !== '') {
        input.description = params.description
      }
      if (params.targetDate != null && params.targetDate !== '') {
        input.targetDate = params.targetDate
      }

      return {
        query: `
          mutation ProjectMilestoneCreate($input: ProjectMilestoneCreateInput!) {
            projectMilestoneCreate(input: $input) {
              success
              projectMilestone {
                id
                name
                description
                targetDate
                progress
                sortOrder
                status
                createdAt
                archivedAt
                project {
                  id
                }
              }
            }
          }
        `,
        variables: {
          input,
        },
      }
    },
  },

  transformResponse: async (response) => {
    const data = await response.json()

    if (data.errors) {
      return {
        success: false,
        error: data.errors[0]?.message || 'Failed to create project milestone',
        output: {},
      }
    }

    const result = data.data.projectMilestoneCreate
    if (!result.success) {
      return {
        success: false,
        error: 'Project milestone creation was not successful',
        output: {},
      }
    }

    const milestone = result.projectMilestone
    return {
      success: true,
      output: {
        projectMilestone: {
          ...milestone,
          projectId: milestone.project?.id ?? null,
          project: undefined,
        },
      },
    }
  },

  outputs: {
    projectMilestone: {
      type: 'object',
      description: 'The created project milestone',
      properties: PROJECT_MILESTONE_OUTPUT_PROPERTIES,
    },
  },
}