linear_get_attachments

Instructions

Implementation Reference

• src/tools/linear_get_attachments.ts:37-136 (handler)

  The main handler function that implements the tool logic: validates the issueId input, uses mock data to simulate fetching attachments from Linear, formats the response as JSON, and handles errors.

  export const linearGetAttachmentsHandler = async (
    args: ToolArgs
  ): Promise<{
    content: Array<{ type: string; text: string }>;
    isError?: boolean;
  }> => {
    try {
      // Type check and validate the input
      if (!args.issueId || typeof args.issueId !== 'string') {
        throw new Error('Issue ID is required and must be a string');
      }
  
      // Extract the issueId
      const issueId = args.issueId;
  
      // In a real implementation, we would use linearClient.issue(issueId)
      // and then issue.attachments()
  
      // First, check if issue exists
      const mockIssues: Record<string, { id: string; title: string; attachments: AttachmentData[] }> =
        {
          issue1: {
            id: 'issue1',
            title: 'Test Issue 1',
            attachments: [
              {
                id: 'attachment1',
                url: 'https://example.com/doc1.pdf',
                title: 'Requirements Document',
                subtitle: 'Project requirements',
                icon: 'https://example.com/pdf-icon.png',
                createdAt: '2023-03-01T12:00:00Z',
              },
              {
                id: 'attachment2',
                url: 'https://example.com/design.png',
                title: 'Design Mockup',
                subtitle: 'UI design',
                icon: 'https://example.com/image-icon.png',
                createdAt: '2023-03-02T14:30:00Z',
              },
            ],
          },
          issue2: {
            id: 'issue2',
            title: 'Test Issue 2',
            attachments: [
              {
                id: 'attachment3',
                url: 'https://example.com/spec.pdf',
                title: 'Technical Specification',
                createdAt: '2023-03-03T09:15:00Z',
              },
            ],
          },
          issue3: {
            id: 'issue3',
            title: 'Test Issue 3',
            attachments: [],
          },
        };
  
      if (!mockIssues[issueId]) {
        throw new Error(`Issue with ID ${issueId} not found`);
      }
  
      const attachments = mockIssues[issueId].attachments;
  
      // Format the response
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(
              {
                success: true,
                issueId,
                issueTitle: mockIssues[issueId].title,
                attachments,
                totalCount: attachments.length,
              },
              null,
              2
            ),
          },
        ],
      };
    } catch (error) {
      console.error('Error in linear_get_attachments:', error);
      return {
        content: [
          {
            type: 'text',
            text: `Error: ${(error as Error).message || String(error)}`,
          },
        ],
        isError: true,
      };
    }
  };

• src/tools/linear_get_attachments.ts:21-34 (schema)

  Tool definition object containing the name, description, and inputSchema for parameter validation (requires 'issueId' string).

  export const linearGetAttachmentsTool = {
    name: 'linear_get_attachments',
    description: 'Get attachments for an issue in Linear',
    inputSchema: {
      type: 'object' as const,
      properties: {
        issueId: {
          type: 'string',
          description: 'Issue ID to get attachments for',
        },
      },
      required: ['issueId'],
    },
  };

• src/tools/linear_get_attachments.ts:139-139 (registration)

  Registers the tool definition and handler function with the MCP registry.

  registerTool(linearGetAttachmentsTool, linearGetAttachmentsHandler);