add doc tool

Author: zmofei

src/tools/__snapshots__/tool-naming-convention.test.ts.snap

@@ -37,6 +37,11 @@ exports[`Tool Naming Convention should maintain consistent tool list (snapshot t
     "description": "Generate a geojson.io URL to visualize GeoJSON data. Returns only the URL link.",
     "toolName": "geojson_preview_tool",
   },
+  {
+    "className": "GetMapboxDocSourceTool",
+    "description": "Fetch and return Mapbox documentation source collection content from llms.txt",
+    "toolName": "get_mapbox_doc_source_tool",
+  },
   {
     "className": "ListStylesTool",
     "description": "List styles for a Mapbox account. Use limit parameter to avoid large responses (recommended: limit=5-10). Use start parameter for pagination.",

src/tools/get-mapbox-doc-source-tool/GetMapboxDocSourceTool.schema.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+
+export const GetMapboxDocSourceSchema = z.object({});
+
+export type GetMapboxDocSourceInput = z.infer<typeof GetMapboxDocSourceSchema>;

src/tools/get-mapbox-doc-source-tool/GetMapboxDocSourceTool.test.ts

@@ -0,0 +1,117 @@
+import { GetMapboxDocSourceTool } from './GetMapboxDocSourceTool.js';
+
+// Mock fetch for testing
+global.fetch = jest.fn();
+
+describe('GetMapboxDocSourceTool', () => {
+  let tool: GetMapboxDocSourceTool;
+  const mockFetch = global.fetch as jest.MockedFunction<typeof fetch>;
+
+  beforeEach(() => {
+    tool = new GetMapboxDocSourceTool();
+    mockFetch.mockClear();
+  });
+
+  it('should have correct name and description', () => {
+    expect(tool.name).toBe('get_mapbox_doc_source_tool');
+    expect(tool.description).toContain('Fetch and return Mapbox documentation');
+  });
+
+  it('should successfully fetch documentation content', async () => {
+    const mockContent = `# Mapbox Documentation
+    
+This is the Mapbox developer documentation for LLMs.
+
+## Web SDKs
+- Mapbox GL JS for interactive maps
+- Mobile SDKs for iOS and Android
+
+## APIs  
+- Geocoding API for address search
+- Directions API for routing`;
+
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      status: 200,
+      text: () => Promise.resolve(mockContent)
+    } as Response);
+
+    const result = await tool.run({});
+
+    expect(mockFetch).toHaveBeenCalledWith('https://docs.mapbox.com/llms.txt');
+    expect(result.content).toHaveLength(1);
+    expect(result.content[0].type).toBe('text');
+
+    if (result.content[0].type === 'text') {
+      expect(result.content[0].text).toBe(mockContent);
+    }
+    expect(result.isError).toBe(false);
+  });
+
+  it('should handle HTTP errors', async () => {
+    mockFetch.mockResolvedValueOnce({
+      ok: false,
+      status: 404
+    } as Response);
+
+    const result = await tool.run({});
+
+    expect(result.isError).toBe(true);
+    expect(result.content[0].type).toBe('text');
+
+    if (result.content[0].type === 'text') {
+      expect(result.content[0].text).toContain(
+        'Failed to fetch Mapbox documentation'
+      );
+      expect(result.content[0].text).toContain('HTTP error! status: 404');
+    }
+  });
+
+  it('should handle network errors', async () => {
+    mockFetch.mockRejectedValueOnce(new Error('Network error'));
+
+    const result = await tool.run({});
+
+    expect(result.isError).toBe(true);
+    expect(result.content[0].type).toBe('text');
+
+    if (result.content[0].type === 'text') {
+      expect(result.content[0].text).toContain(
+        'Failed to fetch Mapbox documentation'
+      );
+      expect(result.content[0].text).toContain('Network error');
+    }
+  });
+
+  it('should handle unknown errors', async () => {
+    mockFetch.mockRejectedValueOnce('Unknown error');
+
+    const result = await tool.run({});
+
+    expect(result.isError).toBe(true);
+    expect(result.content[0].type).toBe('text');
+
+    if (result.content[0].type === 'text') {
+      expect(result.content[0].text).toContain(
+        'Failed to fetch Mapbox documentation'
+      );
+      expect(result.content[0].text).toContain('Unknown error occurred');
+    }
+  });
+
+  it('should work with empty input object', async () => {
+    const mockContent = 'Test documentation content';
+
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      status: 200,
+      text: () => Promise.resolve(mockContent)
+    } as Response);
+
+    const result = await tool.run({});
+
+    expect(result.isError).toBe(false);
+    expect(result.content).toHaveLength(1);
+    expect(result.content[0].type).toBe('text');
+  });
+});

src/tools/get-mapbox-doc-source-tool/GetMapboxDocSourceTool.ts

@@ -0,0 +1,40 @@
+import { BaseTool } from '../BaseTool.js';
+import {
+  GetMapboxDocSourceSchema,
+  GetMapboxDocSourceInput
+} from './GetMapboxDocSourceTool.schema.js';
+
+export class GetMapboxDocSourceTool extends BaseTool<
+  typeof GetMapboxDocSourceSchema
+> {
+  name = 'get_mapbox_doc_source_tool';
+  description =
+    'Fetch and return Mapbox documentation source collection content from llms.txt';
+
+  constructor() {
+    super({ inputSchema: GetMapboxDocSourceSchema });
+  }
+
+  protected async execute(
+    _input: GetMapboxDocSourceInput
+  ): Promise<{ type: 'text'; text: string }> {
+    try {
+      const response = await fetch('https://docs.mapbox.com/llms.txt');
+
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+
+      const content = await response.text();
+
+      return {
+        type: 'text',
+        text: content
+      };
+    } catch (error) {
+      const errorMessage =
+        error instanceof Error ? error.message : 'Unknown error occurred';
+      throw new Error(`Failed to fetch Mapbox documentation: ${errorMessage}`);
+    }
+  }
+}

src/tools/toolRegistry.ts

@@ -5,6 +5,7 @@ import { CreateStyleTool } from './create-style-tool/CreateStyleTool.js';
 import { CreateTokenTool } from './create-token-tool/CreateTokenTool.js';
 import { DeleteStyleTool } from './delete-style-tool/DeleteStyleTool.js';
 import { GeojsonPreviewTool } from './geojson-preview-tool/GeojsonPreviewTool.js';
+import { GetMapboxDocSourceTool } from './get-mapbox-doc-source-tool/GetMapboxDocSourceTool.js';
 import { ListStylesTool } from './list-styles-tool/ListStylesTool.js';
 import { ListTokensTool } from './list-tokens-tool/ListTokensTool.js';
 import { PreviewStyleTool } from './preview-style-tool/PreviewStyleTool.js';
@@ -29,6 +30,7 @@ export const ALL_TOOLS = [
   new BoundingBoxTool(),
   new CountryBoundingBoxTool(),
   new CoordinateConversionTool(),
+  new GetMapboxDocSourceTool(),
   new StyleComparisonTool(),
   new TilequeryTool()
 ] as const;