@mapbox/mcp-server 0.9.0 → 0.11.0

package/dist/commonjs/tools/convex-tool/ConvexTool.js

@@ -0,0 +1,70 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConvexTool = void 0;
+const turf_1 = require("@turf/turf");
+const api_1 = require("@opentelemetry/api");
+const tracing_js_1 = require("../../utils/tracing.js");
+const BaseTool_js_1 = require("../BaseTool.js");
+const ConvexTool_input_schema_js_1 = require("./ConvexTool.input.schema.js");
+const ConvexTool_output_schema_js_1 = require("./ConvexTool.output.schema.js");
+class ConvexTool extends BaseTool_js_1.BaseTool {
+    name = 'convex_tool';
+    description = 'Compute the convex hull of a set of points — the smallest convex polygon that contains all the points. ' +
+        'Useful for bounding area analysis, estimating coverage area, or wrapping a set of locations. ' +
+        'Works offline without API calls.';
+    annotations = {
+        title: 'Convex Hull',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    };
+    constructor() {
+        super({ inputSchema: ConvexTool_input_schema_js_1.ConvexInputSchema, outputSchema: ConvexTool_output_schema_js_1.ConvexOutputSchema });
+    }
+    async run(rawInput) {
+        const toolContext = (0, tracing_js_1.createLocalToolExecutionContext)(this.name, 0);
+        return await api_1.context.with(api_1.trace.setSpan(api_1.context.active(), toolContext.span), async () => {
+            try {
+                const input = ConvexTool_input_schema_js_1.ConvexInputSchema.parse(rawInput);
+                const pts = (0, turf_1.featureCollection)(input.points.map((p) => (0, turf_1.point)([p.longitude, p.latitude])));
+                const hull = (0, turf_1.convex)(pts);
+                const output = {
+                    geometry: hull
+                        ? hull.geometry
+                        : null,
+                    num_points: input.points.length
+                };
+                const validated = this.validateOutput(output);
+                const text = validated.geometry
+                    ? `Convex hull computed from ${validated.num_points} points.\nGeometry:\n${JSON.stringify(validated.geometry, null, 2)}`
+                    : `Could not compute convex hull from ${validated.num_points} points (points may be collinear).`;
+                toolContext.span.setStatus({ code: api_1.SpanStatusCode.OK });
+                toolContext.span.end();
+                return {
+                    content: [{ type: 'text', text }],
+                    structuredContent: validated,
+                    isError: false
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                toolContext.span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                toolContext.span.end();
+                return {
+                    content: [
+                        { type: 'text', text: `ConvexTool: ${errorMessage}` }
+                    ],
+                    isError: true
+                };
+            }
+        });
+    }
+}
+exports.ConvexTool = ConvexTool;
+//# sourceMappingURL=ConvexTool.js.map

package/dist/commonjs/tools/convex-tool/ConvexTool.js.map

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

package/dist/commonjs/tools/convex-tool/ConvexTool.output.schema.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const ConvexOutputSchema: z.ZodObject<{
+    geometry: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    num_points: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    geometry: Record<string, unknown> | null;
+    num_points: number;
+}, {
+    geometry: Record<string, unknown> | null;
+    num_points: number;
+}>;
+export type ConvexOutput = z.infer<typeof ConvexOutputSchema>;
+//# sourceMappingURL=ConvexTool.output.schema.d.ts.map

package/dist/commonjs/tools/convex-tool/ConvexTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConvexTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/convex-tool/ConvexTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;EAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/commonjs/tools/convex-tool/ConvexTool.output.schema.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConvexOutputSchema = void 0;
+const zod_1 = require("zod");
+exports.ConvexOutputSchema = zod_1.z.object({
+    geometry: zod_1.z
+        .record(zod_1.z.unknown())
+        .nullable()
+        .describe('GeoJSON Polygon geometry of the convex hull, or null if hull could not be computed'),
+    num_points: zod_1.z.number().describe('Number of input points used')
+});
+//# sourceMappingURL=ConvexTool.output.schema.js.map

package/dist/commonjs/tools/convex-tool/ConvexTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConvexTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/convex-tool/ConvexTool.output.schema.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,6BAAwB;AAEX,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,OAAC;SACR,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,oFAAoF,CACrF;IACH,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CAC/D,CAAC,CAAC"}

package/dist/commonjs/tools/destination-tool/DestinationTool.d.ts

@@ -0,0 +1,18 @@
+import { BaseTool } from '../BaseTool.js';
+import { DestinationInputSchema } from './DestinationTool.input.schema.js';
+import { DestinationOutputSchema } from './DestinationTool.output.schema.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare class DestinationTool extends BaseTool<typeof DestinationInputSchema, typeof DestinationOutputSchema> {
+    readonly name = "destination_tool";
+    readonly description: string;
+    readonly annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    constructor();
+    run(rawInput: unknown): Promise<CallToolResult>;
+}
+//# sourceMappingURL=DestinationTool.d.ts.map

package/dist/commonjs/tools/destination-tool/DestinationTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,uBAAuB,EAExB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,qBAAa,eAAgB,SAAQ,QAAQ,CAC3C,OAAO,sBAAsB,EAC7B,OAAO,uBAAuB,CAC/B;IACC,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,SAKiB;IAErC,QAAQ,CAAC,WAAW;;;;;;MAMlB;;IASI,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;CA2DtD"}

package/dist/commonjs/tools/destination-tool/DestinationTool.input.schema.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const DestinationInputSchema: z.ZodObject<{
+    origin: z.ZodObject<{
+        longitude: z.ZodNumber;
+        latitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        longitude: number;
+        latitude: number;
+    }, {
+        longitude: number;
+        latitude: number;
+    }>;
+    distance: z.ZodNumber;
+    bearing: z.ZodNumber;
+    units: z.ZodDefault<z.ZodEnum<["kilometers", "miles", "meters", "feet"]>>;
+}, "strip", z.ZodTypeAny, {
+    units: "kilometers" | "miles" | "meters" | "feet";
+    distance: number;
+    origin: {
+        longitude: number;
+        latitude: number;
+    };
+    bearing: number;
+}, {
+    distance: number;
+    origin: {
+        longitude: number;
+        latitude: number;
+    };
+    bearing: number;
+    units?: "kilometers" | "miles" | "meters" | "feet" | undefined;
+}>;
+export type DestinationInput = z.infer<typeof DestinationInputSchema>;
+//# sourceMappingURL=DestinationTool.input.schema.d.ts.map

package/dist/commonjs/tools/destination-tool/DestinationTool.input.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.input.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.input.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/commonjs/tools/destination-tool/DestinationTool.input.schema.js

@@ -0,0 +1,25 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DestinationInputSchema = void 0;
+const zod_1 = require("zod");
+exports.DestinationInputSchema = zod_1.z.object({
+    origin: zod_1.z
+        .object({
+        longitude: zod_1.z.number().min(-180).max(180),
+        latitude: zod_1.z.number().min(-90).max(90)
+    })
+        .describe('Starting point'),
+    distance: zod_1.z.number().positive().describe('Distance to travel'),
+    bearing: zod_1.z
+        .number()
+        .min(-180)
+        .max(180)
+        .describe('Direction of travel in degrees (0=north, 90=east, -90=west, 180=south)'),
+    units: zod_1.z
+        .enum(['kilometers', 'miles', 'meters', 'feet'])
+        .default('meters')
+        .describe('Units for the distance')
+});
+//# sourceMappingURL=DestinationTool.input.schema.js.map

package/dist/commonjs/tools/destination-tool/DestinationTool.input.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.input.schema.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,6BAAwB;AAEX,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACxC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KACtC,CAAC;SACD,QAAQ,CAAC,gBAAgB,CAAC;IAE7B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAE9D,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,GAAG,CAAC;SACT,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,wEAAwE,CACzE;IAEH,KAAK,EAAE,OAAC;SACL,IAAI,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;SAC/C,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,wBAAwB,CAAC;CACtC,CAAC,CAAC"}

package/dist/commonjs/tools/destination-tool/DestinationTool.js

@@ -0,0 +1,83 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DestinationTool = void 0;
+const turf_1 = require("@turf/turf");
+const api_1 = require("@opentelemetry/api");
+const tracing_js_1 = require("../../utils/tracing.js");
+const BaseTool_js_1 = require("../BaseTool.js");
+const DestinationTool_input_schema_js_1 = require("./DestinationTool.input.schema.js");
+const DestinationTool_output_schema_js_1 = require("./DestinationTool.output.schema.js");
+class DestinationTool extends BaseTool_js_1.BaseTool {
+    name = 'destination_tool';
+    description = 'Calculate a destination point given a starting point, bearing, and distance using geodesic (great-circle) straight-line offset. ' +
+        'Useful for "find a point 5km north of X", constructing search offsets, or computing waypoints. ' +
+        'Bearing: 0=north, 90=east, 180/-180=south, -90=west. ' +
+        'Note: this calculates a straight-line geographic offset, not road-network distance. ' +
+        'Works offline without API calls.';
+    annotations = {
+        title: 'Calculate Destination',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    };
+    constructor() {
+        super({
+            inputSchema: DestinationTool_input_schema_js_1.DestinationInputSchema,
+            outputSchema: DestinationTool_output_schema_js_1.DestinationOutputSchema
+        });
+    }
+    async run(rawInput) {
+        const toolContext = (0, tracing_js_1.createLocalToolExecutionContext)(this.name, 0);
+        return await api_1.context.with(api_1.trace.setSpan(api_1.context.active(), toolContext.span), async () => {
+            try {
+                const input = DestinationTool_input_schema_js_1.DestinationInputSchema.parse(rawInput);
+                const origin = (0, turf_1.point)([input.origin.longitude, input.origin.latitude]);
+                const result = (0, turf_1.destination)(origin, input.distance, input.bearing, {
+                    units: input.units
+                });
+                const output = {
+                    destination: {
+                        longitude: result.geometry.coordinates[0],
+                        latitude: result.geometry.coordinates[1]
+                    },
+                    distance: input.distance,
+                    bearing: input.bearing,
+                    units: input.units
+                };
+                const validated = this.validateOutput(output);
+                const text = `Destination: [${validated.destination.longitude}, ${validated.destination.latitude}]\n` +
+                    `From: [${input.origin.longitude}, ${input.origin.latitude}]\n` +
+                    `Distance: ${validated.distance} ${validated.units} at bearing ${validated.bearing}°`;
+                toolContext.span.setStatus({ code: api_1.SpanStatusCode.OK });
+                toolContext.span.end();
+                return {
+                    content: [{ type: 'text', text }],
+                    structuredContent: validated,
+                    isError: false
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                toolContext.span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                toolContext.span.end();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `DestinationTool: ${errorMessage}`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+        });
+    }
+}
+exports.DestinationTool = DestinationTool;
+//# sourceMappingURL=DestinationTool.js.map

package/dist/commonjs/tools/destination-tool/DestinationTool.js.map

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

package/dist/commonjs/tools/destination-tool/DestinationTool.output.schema.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const DestinationOutputSchema: z.ZodObject<{
+    destination: z.ZodObject<{
+        longitude: z.ZodNumber;
+        latitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        longitude: number;
+        latitude: number;
+    }, {
+        longitude: number;
+        latitude: number;
+    }>;
+    distance: z.ZodNumber;
+    bearing: z.ZodNumber;
+    units: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    units: string;
+    distance: number;
+    bearing: number;
+    destination: {
+        longitude: number;
+        latitude: number;
+    };
+}, {
+    units: string;
+    distance: number;
+    bearing: number;
+    destination: {
+        longitude: number;
+        latitude: number;
+    };
+}>;
+export type DestinationOutput = z.infer<typeof DestinationOutputSchema>;
+//# sourceMappingURL=DestinationTool.output.schema.d.ts.map

package/dist/commonjs/tools/destination-tool/DestinationTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/commonjs/tools/destination-tool/DestinationTool.output.schema.js

@@ -0,0 +1,18 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DestinationOutputSchema = void 0;
+const zod_1 = require("zod");
+exports.DestinationOutputSchema = zod_1.z.object({
+    destination: zod_1.z
+        .object({
+        longitude: zod_1.z.number(),
+        latitude: zod_1.z.number()
+    })
+        .describe('The calculated destination point'),
+    distance: zod_1.z.number().describe('Distance traveled'),
+    bearing: zod_1.z.number().describe('Bearing used'),
+    units: zod_1.z.string().describe('Distance units')
+});
+//# sourceMappingURL=DestinationTool.output.schema.js.map

package/dist/commonjs/tools/destination-tool/DestinationTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.output.schema.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,6BAAwB;AAEX,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,WAAW,EAAE,OAAC;SACX,MAAM,CAAC;QACN,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;KACrB,CAAC;SACD,QAAQ,CAAC,kCAAkC,CAAC;IAC/C,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAClD,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC5C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CAC7C,CAAC,CAAC"}

package/dist/commonjs/tools/difference-tool/DifferenceTool.d.ts

@@ -0,0 +1,18 @@
+import { BaseTool } from '../BaseTool.js';
+import { DifferenceInputSchema } from './DifferenceTool.input.schema.js';
+import { DifferenceOutputSchema } from './DifferenceTool.output.schema.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare class DifferenceTool extends BaseTool<typeof DifferenceInputSchema, typeof DifferenceOutputSchema> {
+    readonly name = "difference_tool";
+    readonly description: string;
+    readonly annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    constructor();
+    run(rawInput: unknown): Promise<CallToolResult>;
+}
+//# sourceMappingURL=DifferenceTool.d.ts.map

package/dist/commonjs/tools/difference-tool/DifferenceTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EACL,sBAAsB,EAEvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,qBAAa,cAAe,SAAQ,QAAQ,CAC1C,OAAO,qBAAqB,EAC5B,OAAO,sBAAsB,CAC9B;IACC,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,SAIiB;IAErC,QAAQ,CAAC,WAAW;;;;;;MAMlB;;IASI,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;CAmDtD"}

package/dist/commonjs/tools/difference-tool/DifferenceTool.input.schema.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const DifferenceInputSchema: z.ZodObject<{
+    polygon1: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodNumber, "many">, "many">, "many">;
+    polygon2: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodNumber, "many">, "many">, "many">;
+}, "strip", z.ZodTypeAny, {
+    polygon1: number[][][];
+    polygon2: number[][][];
+}, {
+    polygon1: number[][][];
+    polygon2: number[][][];
+}>;
+export type DifferenceInput = z.infer<typeof DifferenceInputSchema>;
+//# sourceMappingURL=DifferenceTool.input.schema.d.ts.map

package/dist/commonjs/tools/difference-tool/DifferenceTool.input.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.input.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.input.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/commonjs/tools/difference-tool/DifferenceTool.input.schema.js

@@ -0,0 +1,12 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DifferenceInputSchema = void 0;
+const zod_1 = require("zod");
+const polygonSchema_js_1 = require("../shared/polygonSchema.js");
+exports.DifferenceInputSchema = zod_1.z.object({
+    polygon1: polygonSchema_js_1.PolygonSchema.describe('The polygon to subtract from'),
+    polygon2: polygonSchema_js_1.PolygonSchema.describe('The polygon to subtract')
+});
+//# sourceMappingURL=DifferenceTool.input.schema.js.map

package/dist/commonjs/tools/difference-tool/DifferenceTool.input.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.input.schema.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,6BAAwB;AACxB,iEAA2D;AAE9C,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,gCAAa,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAChE,QAAQ,EAAE,gCAAa,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAC5D,CAAC,CAAC"}

package/dist/commonjs/tools/difference-tool/DifferenceTool.js

@@ -0,0 +1,75 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DifferenceTool = void 0;
+const turf_1 = require("@turf/turf");
+const api_1 = require("@opentelemetry/api");
+const tracing_js_1 = require("../../utils/tracing.js");
+const BaseTool_js_1 = require("../BaseTool.js");
+const DifferenceTool_input_schema_js_1 = require("./DifferenceTool.input.schema.js");
+const DifferenceTool_output_schema_js_1 = require("./DifferenceTool.output.schema.js");
+class DifferenceTool extends BaseTool_js_1.BaseTool {
+    name = 'difference_tool';
+    description = 'Subtract one polygon from another, returning the area in polygon1 that is not covered by polygon2. ' +
+        'Useful for computing exclusion zones, finding uncovered service areas, or "what is in zone A but not zone B?". ' +
+        'Returns null geometry if polygon2 fully covers polygon1. ' +
+        'Works offline without API calls.';
+    annotations = {
+        title: 'Difference of Polygons',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    };
+    constructor() {
+        super({
+            inputSchema: DifferenceTool_input_schema_js_1.DifferenceInputSchema,
+            outputSchema: DifferenceTool_output_schema_js_1.DifferenceOutputSchema
+        });
+    }
+    async run(rawInput) {
+        const toolContext = (0, tracing_js_1.createLocalToolExecutionContext)(this.name, 0);
+        return await api_1.context.with(api_1.trace.setSpan(api_1.context.active(), toolContext.span), async () => {
+            try {
+                const input = DifferenceTool_input_schema_js_1.DifferenceInputSchema.parse(rawInput);
+                const poly1 = (0, turf_1.polygon)(input.polygon1);
+                const poly2 = (0, turf_1.polygon)(input.polygon2);
+                const result = (0, turf_1.difference)((0, turf_1.featureCollection)([poly1, poly2]));
+                const output = {
+                    has_difference: result !== null,
+                    geometry: result
+                        ? result.geometry
+                        : null
+                };
+                const validated = this.validateOutput(output);
+                const text = validated.has_difference
+                    ? `Difference computed (area in polygon1 not covered by polygon2).\nGeometry:\n${JSON.stringify(validated.geometry, null, 2)}`
+                    : 'No difference: polygon2 fully covers polygon1.';
+                toolContext.span.setStatus({ code: api_1.SpanStatusCode.OK });
+                toolContext.span.end();
+                return {
+                    content: [{ type: 'text', text }],
+                    structuredContent: validated,
+                    isError: false
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                toolContext.span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                toolContext.span.end();
+                return {
+                    content: [
+                        { type: 'text', text: `DifferenceTool: ${errorMessage}` }
+                    ],
+                    isError: true
+                };
+            }
+        });
+    }
+}
+exports.DifferenceTool = DifferenceTool;
+//# sourceMappingURL=DifferenceTool.js.map

package/dist/commonjs/tools/difference-tool/DifferenceTool.js.map

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

package/dist/commonjs/tools/difference-tool/DifferenceTool.output.schema.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const DifferenceOutputSchema: z.ZodObject<{
+    has_difference: z.ZodBoolean;
+    geometry: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    geometry: Record<string, unknown> | null;
+    has_difference: boolean;
+}, {
+    geometry: Record<string, unknown> | null;
+    has_difference: boolean;
+}>;
+export type DifferenceOutput = z.infer<typeof DifferenceOutputSchema>;
+//# sourceMappingURL=DifferenceTool.output.schema.d.ts.map

package/dist/commonjs/tools/difference-tool/DifferenceTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;EAYjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/commonjs/tools/difference-tool/DifferenceTool.output.schema.js

@@ -0,0 +1,16 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DifferenceOutputSchema = void 0;
+const zod_1 = require("zod");
+exports.DifferenceOutputSchema = zod_1.z.object({
+    has_difference: zod_1.z
+        .boolean()
+        .describe('Whether any area remains after subtracting polygon2 from polygon1'),
+    geometry: zod_1.z
+        .record(zod_1.z.unknown())
+        .nullable()
+        .describe('GeoJSON geometry of the remaining area (polygon1 minus polygon2), or null if polygon2 fully covers polygon1')
+});
+//# sourceMappingURL=DifferenceTool.output.schema.js.map

package/dist/commonjs/tools/difference-tool/DifferenceTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.output.schema.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,6BAAwB;AAEX,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,cAAc,EAAE,OAAC;SACd,OAAO,EAAE;SACT,QAAQ,CACP,mEAAmE,CACpE;IACH,QAAQ,EAAE,OAAC;SACR,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,6GAA6G,CAC9G;CACJ,CAAC,CAAC"}