@mapbox/mcp-server 0.5.5 → 0.8.1-dev.0

package/dist/esm/tools/matrix-tool/MatrixTool.js

@@ -2,8 +2,8 @@
 // Licensed under the MIT License.
 import { URLSearchParams } from 'node:url';
 import { MapboxApiBasedTool } from '../MapboxApiBasedTool.js';
-import { fetchClient } from '../../utils/fetchRequest.js';
-import { MatrixInputSchema } from './MatrixTool.schema.js';
+import { MatrixInputSchema } from './MatrixTool.input.schema.js';
+import { MatrixResponseSchema } from './MatrixTool.output.schema.js';
 // API documentation: https://docs.mapbox.com/api/navigation/matrix/
 export class MatrixTool extends MapboxApiBasedTool {
     name = 'matrix_tool';
@@ -15,20 +15,38 @@ export class MatrixTool extends MapboxApiBasedTool {
         idempotentHint: true,
         openWorldHint: true
     };
-    fetch;
-    constructor(fetch = fetchClient) {
-        super({ inputSchema: MatrixInputSchema });
-        this.fetch = fetch;
+    constructor(params) {
+        super({
+            inputSchema: MatrixInputSchema,
+            outputSchema: MatrixResponseSchema,
+            httpRequest: params.httpRequest
+        });
     }
     async execute(input, accessToken) {
         // Validate input based on profile type
         if (input.profile === 'driving-traffic' && input.coordinates.length > 10) {
-            throw new Error('The driving-traffic profile supports a maximum of 10 coordinate pairs.');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'The driving-traffic profile supports a maximum of 10 coordinate pairs.'
+                    }
+                ],
+                isError: true
+            };
         }
         // Validate approaches parameter if provided
         if (input.approaches &&
             input.approaches.split(';').length !== input.coordinates.length) {
-            throw new Error('When provided, the number of approaches (including empty/skipped) must match the number of coordinates.');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'When provided, the number of approaches (including empty/skipped) must match the number of coordinates.'
+                    }
+                ],
+                isError: true
+            };
         }
         // Validate that all approaches values are either "curb" or "unrestricted"
         if (input.approaches &&
@@ -37,32 +55,73 @@ export class MatrixTool extends MapboxApiBasedTool {
                 .some((approach) => approach !== '' &&
                 approach !== 'curb' &&
                 approach !== 'unrestricted')) {
-            throw new Error('Approaches parameter contains invalid values. Each value must be either "curb" or "unrestricted".');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Approaches parameter contains invalid values. Each value must be either "curb" or "unrestricted".'
+                    }
+                ],
+                isError: true
+            };
         }
         // Validate bearings parameter if provided
         if (input.bearings &&
             input.bearings.split(';').length !== input.coordinates.length) {
-            throw new Error('When provided, the number of bearings (including empty/skipped) must match the number of coordinates.');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'When provided, the number of bearings (including empty/skipped) must match the number of coordinates.'
+                    }
+                ],
+                isError: true
+            };
         }
         // Additional validation for bearings values
         if (input.bearings) {
             const bearingsArr = input.bearings.split(';');
-            bearingsArr.forEach((bearing, idx) => {
+            for (let idx = 0; idx < bearingsArr.length; idx++) {
+                const bearing = bearingsArr[idx];
                 if (bearing.trim() === '')
-                    return; // allow skipped
+                    continue; // allow skipped
                 const parts = bearing.split(',');
                 if (parts.length !== 2) {
-                    throw new Error(`Invalid bearings format at index ${idx}: '${bearing}'. Each bearing must be two comma-separated numbers (angle,degrees).`);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Invalid bearings format at index ${idx}: '${bearing}'. Each bearing must be two comma-separated numbers (angle,degrees).`
+                            }
+                        ],
+                        isError: true
+                    };
                 }
                 const angle = Number(parts[0]);
                 const degrees = Number(parts[1]);
                 if (isNaN(angle) || angle < 0 || angle > 360) {
-                    throw new Error(`Invalid bearing angle at index ${idx}: '${parts[0]}'. Angle must be a number between 0 and 360.`);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Invalid bearing angle at index ${idx}: '${parts[0]}'. Angle must be a number between 0 and 360.`
+                            }
+                        ],
+                        isError: true
+                    };
                 }
                 if (isNaN(degrees) || degrees < 0 || degrees > 180) {
-                    throw new Error(`Invalid bearing degrees at index ${idx}: '${parts[1]}'. Degrees must be a number between 0 and 180.`);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Invalid bearing degrees at index ${idx}: '${parts[1]}'. Degrees must be a number between 0 and 180.`
+                            }
+                        ],
+                        isError: true
+                    };
                 }
-            });
+            }
         }
         // Validate sources parameter if provided - ensure all indices are valid
         if (input.sources &&
@@ -73,9 +132,17 @@ export class MatrixTool extends MapboxApiBasedTool {
                     parsedIndex < 0 ||
                     parsedIndex >= input.coordinates.length);
             })) {
-            throw new Error('Sources parameter contains invalid indices. All indices must be between 0 and ' +
-                (input.coordinates.length - 1) +
-                '.');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Sources parameter contains invalid indices. All indices must be between 0 and ' +
+                            (input.coordinates.length - 1) +
+                            '.'
+                    }
+                ],
+                isError: true
+            };
         }
         // Validate destinations parameter if provided - ensure all indices are valid
         if (input.destinations &&
@@ -86,9 +153,17 @@ export class MatrixTool extends MapboxApiBasedTool {
                     parsedIndex < 0 ||
                     parsedIndex >= input.coordinates.length);
             })) {
-            throw new Error('Destinations parameter contains invalid indices. All indices must be between 0 and ' +
-                (input.coordinates.length - 1) +
-                '.');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Destinations parameter contains invalid indices. All indices must be between 0 and ' +
+                            (input.coordinates.length - 1) +
+                            '.'
+                    }
+                ],
+                isError: true
+            };
         }
         // Validate that when specifying both sources and destinations, all coordinates are used
         if (input.sources &&
@@ -105,7 +180,15 @@ export class MatrixTool extends MapboxApiBasedTool {
             const usedIndices = new Set([...sourcesIndices, ...destinationsIndices]);
             // Check if all coordinate indices are used
             if (usedIndices.size < input.coordinates.length) {
-                throw new Error('When specifying both sources and destinations, all coordinates must be used as either a source or destination.');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'When specifying both sources and destinations, all coordinates must be used as either a source or destination.'
+                        }
+                    ],
+                    isError: true
+                };
             }
         }
         // Format coordinates for API request
@@ -138,13 +221,35 @@ export class MatrixTool extends MapboxApiBasedTool {
         // Construct the URL for the Matrix API request
         const url = `${MapboxApiBasedTool.mapboxApiEndpoint}directions-matrix/v1/mapbox/${input.profile}/${joined}?${queryParams.toString()}`;
         // Make the request
-        const response = await this.fetch(url);
+        const response = await this.httpRequest(url);
         if (!response.ok) {
-            throw new Error(`Request failed with status ${response.status}: ${response.statusText}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Request failed with status ${response.status}: ${response.statusText}`
+                    }
+                ],
+                isError: true
+            };
         }
         // Return the matrix data
         const data = await response.json();
-        return data;
+        // Validate the response data against our schema
+        let validatedData;
+        try {
+            validatedData = MatrixResponseSchema.parse(data);
+        }
+        catch (error) {
+            // If validation fails, fall back to the original data
+            this.log('warning', `MatrixTool: Response validation failed: ${error}`);
+            validatedData = data;
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(validatedData, null, 2) }],
+            structuredContent: validatedData,
+            isError: false
+        };
     }
 }
 //# sourceMappingURL=MatrixTool.js.map

package/dist/esm/tools/matrix-tool/MatrixTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"MatrixTool.js","sourceRoot":"","sources":["../../../../src/tools/matrix-tool/MatrixTool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MatrixTool.js","sourceRoot":"","sources":["../../../../src/tools/matrix-tool/MatrixTool.ts"],"names":[],"mappings":"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"}

package/dist/esm/tools/matrix-tool/MatrixTool.output.schema.d.ts

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+declare const MatrixWaypointSchema: z.ZodObject<{
+    name: z.ZodString;
+    location: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    distance: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    distance: number;
+    location: [number, number];
+}, {
+    name: string;
+    distance: number;
+    location: [number, number];
+}>;
+export declare const MatrixResponseSchema: z.ZodObject<{
+    code: z.ZodString;
+    durations: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodNullable<z.ZodNumber>, "many">, "many">>;
+    distances: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodNullable<z.ZodNumber>, "many">, "many">>;
+    sources: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        location: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        distance: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        distance: number;
+        location: [number, number];
+    }, {
+        name: string;
+        distance: number;
+        location: [number, number];
+    }>, "many">;
+    destinations: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        location: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        distance: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        distance: number;
+        location: [number, number];
+    }, {
+        name: string;
+        distance: number;
+        location: [number, number];
+    }>, "many">;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    destinations: {
+        name: string;
+        distance: number;
+        location: [number, number];
+    }[];
+    sources: {
+        name: string;
+        distance: number;
+        location: [number, number];
+    }[];
+    message?: string | undefined;
+    durations?: (number | null)[][] | undefined;
+    distances?: (number | null)[][] | undefined;
+}, {
+    code: string;
+    destinations: {
+        name: string;
+        distance: number;
+        location: [number, number];
+    }[];
+    sources: {
+        name: string;
+        distance: number;
+        location: [number, number];
+    }[];
+    message?: string | undefined;
+    durations?: (number | null)[][] | undefined;
+    distances?: (number | null)[][] | undefined;
+}>;
+export type MatrixResponse = z.infer<typeof MatrixResponseSchema>;
+export type MatrixWaypoint = z.infer<typeof MatrixWaypointSchema>;
+export {};
+//# sourceMappingURL=MatrixTool.output.schema.d.ts.map

package/dist/esm/tools/matrix-tool/MatrixTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatrixTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/matrix-tool/MatrixTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,oBAAoB;;;;;;;;;;;;EAIxB,CAAC;AAGH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/esm/tools/matrix-tool/MatrixTool.output.schema.js

@@ -0,0 +1,19 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+// Waypoint object schema (used for both sources and destinations)
+const MatrixWaypointSchema = z.object({
+    name: z.string(),
+    location: z.tuple([z.number(), z.number()]),
+    distance: z.number()
+});
+// Main Matrix API response schema
+export const MatrixResponseSchema = z.object({
+    code: z.string(),
+    durations: z.array(z.array(z.number().nullable())).optional(),
+    distances: z.array(z.array(z.number().nullable())).optional(),
+    sources: z.array(MatrixWaypointSchema),
+    destinations: z.array(MatrixWaypointSchema),
+    message: z.string().optional() // Present in error responses
+});
+//# sourceMappingURL=MatrixTool.output.schema.js.map

package/dist/esm/tools/matrix-tool/MatrixTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatrixTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/matrix-tool/MatrixTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kEAAkE;AAClE,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,kCAAkC;AAClC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7D,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7D,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACtC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,6BAA6B;CAC7D,CAAC,CAAC"}

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.d.ts

@@ -0,0 +1,28 @@
+import { BaseTool } from '../BaseTool.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { ResourceReaderToolInputSchema } from './ResourceReaderTool.input.schema.js';
+import { ResourceReaderToolOutputSchema } from './ResourceReaderTool.output.schema.js';
+/**
+ * Tool for reading MCP resources via the tool interface.
+ * This provides a fallback mechanism for clients that don't support the MCP resource API.
+ */
+export declare class ResourceReaderTool extends BaseTool<typeof ResourceReaderToolInputSchema, typeof ResourceReaderToolOutputSchema> {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    constructor();
+    run(rawInput: unknown, extra?: RequestHandlerExtra<any, any>): Promise<CallToolResult>;
+    private execute;
+    /**
+     * Lists all available resource URIs for error messages
+     */
+    private listAvailableResources;
+}
+//# sourceMappingURL=ResourceReaderTool.d.ts.map

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceReaderTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/resource-reader-tool/ResourceReaderTool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAExF,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAGvF;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ,CAC9C,OAAO,6BAA6B,EACpC,OAAO,8BAA8B,CACtC;IACC,IAAI,SAA0B;IAC9B,WAAW,SACmU;IAC9U,WAAW;;;;;;MAMT;;IASI,GAAG,CACP,QAAQ,EAAE,OAAO,EAEjB,KAAK,CAAC,EAAE,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,GACpC,OAAO,CAAC,cAAc,CAAC;YA+BZ,OAAO;IAqFrB;;OAEG;YACW,sBAAsB;CAOrC"}

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.input.schema.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const ResourceReaderToolInputSchema: z.ZodObject<{
+    uri: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    uri: string;
+}, {
+    uri: string;
+}>;
+export type ResourceReaderToolInput = z.infer<typeof ResourceReaderToolInputSchema>;
+//# sourceMappingURL=ResourceReaderTool.input.schema.d.ts.map

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.input.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceReaderTool.input.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/resource-reader-tool/ResourceReaderTool.input.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,6BAA6B;;;;;;EAOxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC"}

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.input.schema.js

@@ -0,0 +1,10 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+export const ResourceReaderToolInputSchema = z.object({
+    uri: z
+        .string()
+        .min(1, 'URI must not be empty')
+        .describe('The resource URI to read (e.g., "mapbox://categories" or "mapbox://categories/ja")')
+});
+//# sourceMappingURL=ResourceReaderTool.input.schema.js.map

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.input.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceReaderTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/resource-reader-tool/ResourceReaderTool.input.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;SAC/B,QAAQ,CACP,oFAAoF,CACrF;CACJ,CAAC,CAAC"}

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.js

@@ -0,0 +1,137 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { BaseTool } from '../BaseTool.js';
+import { ResourceReaderToolInputSchema } from './ResourceReaderTool.input.schema.js';
+import { ResourceReaderToolOutputSchema } from './ResourceReaderTool.output.schema.js';
+import { getResourceByUri } from '../../resources/resourceRegistry.js';
+/**
+ * Tool for reading MCP resources via the tool interface.
+ * This provides a fallback mechanism for clients that don't support the MCP resource API.
+ */
+export class ResourceReaderTool extends BaseTool {
+    name = 'resource_reader_tool';
+    description = 'Reads an MCP resource by URI. This tool is a fallback for clients that do not support the native MCP resource API. Supports reading category lists and other Mapbox resources. Use "mapbox://categories" for default categories or "mapbox://categories/{language}" for localized versions (e.g., "mapbox://categories/ja" for Japanese).';
+    annotations = {
+        title: 'Resource Reader Tool',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    };
+    constructor() {
+        super({
+            inputSchema: ResourceReaderToolInputSchema,
+            outputSchema: ResourceReaderToolOutputSchema
+        });
+    }
+    async run(rawInput, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    extra) {
+        try {
+            const input = this.inputSchema.parse(rawInput);
+            const result = await this.execute(input, extra);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.log('error', `${this.name}: Error during execution: ${errorMessage}`);
+            const errorResponse = {
+                message: errorMessage,
+                tool: this.name
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(errorResponse)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+    async execute(input, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    extra) {
+        // Find the resource by URI
+        const resource = getResourceByUri(input.uri);
+        if (!resource) {
+            const availableResources = await this.listAvailableResources();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Resource not found: ${input.uri}. Available resource URIs: ${availableResources}`
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            // Read the resource
+            const result = await resource.read(input.uri, extra);
+            // Return the first content item (resources can return multiple, but we'll return the first)
+            const content = result.contents[0];
+            if (!content) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Resource returned no content: ${input.uri}`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+            // Validate output against schema
+            try {
+                ResourceReaderToolOutputSchema.parse(content);
+            }
+            catch (validationError) {
+                this.log('warning', `Output schema validation failed: ${validationError instanceof Error ? validationError.message : 'Unknown validation error'}`);
+            }
+            // Extract text or blob from the content using type guards
+            let textContent;
+            if ('text' in content && typeof content.text === 'string') {
+                textContent = content.text;
+            }
+            else if ('blob' in content && typeof content.blob === 'string') {
+                textContent = content.blob;
+            }
+            else {
+                throw new Error('Resource content must contain either text or blob');
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: textContent
+                    }
+                ],
+                structuredContent: content,
+                isError: false
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error reading resource ${input.uri}: ${errorMessage}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+    /**
+     * Lists all available resource URIs for error messages
+     */
+    async listAvailableResources() {
+        const { getAllResources } = await import('../../resources/resourceRegistry.js');
+        const resources = getAllResources();
+        return resources.map((r) => r.uri).join(', ');
+    }
+}
+//# sourceMappingURL=ResourceReaderTool.js.map

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceReaderTool.js","sourceRoot":"","sources":["../../../../src/tools/resource-reader-tool/ResourceReaderTool.ts"],"names":[],"mappings":"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"}

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.output.schema.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export declare const ResourceReaderToolOutputSchema: z.ZodObject<{
+    uri: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    blob: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    uri: string;
+    text?: string | undefined;
+    mimeType?: string | undefined;
+    blob?: string | undefined;
+}, {
+    uri: string;
+    text?: string | undefined;
+    mimeType?: string | undefined;
+    blob?: string | undefined;
+}>;
+export type ResourceReaderToolOutput = z.infer<typeof ResourceReaderToolOutputSchema>;
+//# sourceMappingURL=ResourceReaderTool.output.schema.d.ts.map

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceReaderTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/resource-reader-tool/ResourceReaderTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;EAKzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC"}

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.output.schema.js

@@ -0,0 +1,10 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+export const ResourceReaderToolOutputSchema = z.object({
+    uri: z.string().describe('The URI that was read'),
+    mimeType: z.string().optional().describe('MIME type of the content'),
+    text: z.string().optional().describe('Text content of the resource'),
+    blob: z.string().optional().describe('Base64-encoded blob content')
+});
+//# sourceMappingURL=ResourceReaderTool.output.schema.js.map

package/dist/esm/tools/resource-reader-tool/ResourceReaderTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceReaderTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/resource-reader-tool/ResourceReaderTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACpE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACpE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CACpE,CAAC,CAAC"}