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

import type {
  LinearListIssueRelationsParams,
  LinearListIssueRelationsResponse,
} from '@/tools/linear/types'
import type { ToolConfig } from '@/tools/types'

export const linearListIssueRelationsTool: ToolConfig<
  LinearListIssueRelationsParams,
  LinearListIssueRelationsResponse
> = {
  id: 'linear_list_issue_relations',
  name: 'Linear List Issue Relations',
  description: 'List all relations (dependencies) for an issue in Linear',
  version: '1.0.0',

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

  params: {
    issueId: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Issue ID',
    },
    first: {
      type: 'number',
      required: false,
      visibility: 'user-or-llm',
      description: 'Number of relations 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) => ({
      query: `
        query ListIssueRelations($issueId: String!, $first: Int, $after: String) {
          issue(id: $issueId) {
            relations(first: $first, after: $after) {
              nodes {
                id
                type
                issue {
                  id
                  title
                }
                relatedIssue {
                  id
                  title
                }
              }
              pageInfo {
                hasNextPage
                endCursor
              }
            }
          }
        }
      `,
      variables: {
        issueId: params.issueId,
        first: params.first ? Number(params.first) : 50,
        after: params.after?.trim() || undefined,
      },
    }),
  },

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

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

    if (!data.data?.issue) {
      return {
        success: false,
        error: 'Issue not found',
        output: {},
      }
    }

    const result = data.data.issue.relations
    return {
      success: true,
      output: {
        relations: result.nodes,
        pageInfo: {
          hasNextPage: result.pageInfo.hasNextPage,
          endCursor: result.pageInfo.endCursor,
        },
      },
    }
  },

  outputs: {
    relations: {
      type: 'array',
      description: 'Array of issue relations',
      items: {
        type: 'object',
        properties: {
          id: { type: 'string', description: 'Relation ID' },
          type: { type: 'string', description: 'Relation type' },
          issue: { type: 'object', description: 'Source issue' },
          relatedIssue: { type: 'object', description: 'Target issue' },
        },
      },
    },
    pageInfo: {
      type: 'object',
      description: 'Pagination information',
    },
  },
}