@mapbox/mcp-server 0.8.1 → 0.8.2

package/dist/esm/tools/midpoint-tool/MidpointTool.input.schema.js

@@ -0,0 +1,21 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import z from 'zod';
+/**
+ * Input schema for MidpointTool
+ */
+export const MidpointInputSchema = z.object({
+    from: z
+        .object({
+        longitude: z.number().min(-180).max(180),
+        latitude: z.number().min(-90).max(90)
+    })
+        .describe('Starting coordinate'),
+    to: z
+        .object({
+        longitude: z.number().min(-180).max(180),
+        latitude: z.number().min(-90).max(90)
+    })
+        .describe('Ending coordinate')
+});
+//# sourceMappingURL=MidpointTool.input.schema.js.map

package/dist/esm/tools/midpoint-tool/MidpointTool.input.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MidpointTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/midpoint-tool/MidpointTool.input.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KACtC,CAAC;SACD,QAAQ,CAAC,qBAAqB,CAAC;IAClC,EAAE,EAAE,CAAC;SACF,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KACtC,CAAC;SACD,QAAQ,CAAC,mBAAmB,CAAC;CACjC,CAAC,CAAC"}

package/dist/esm/tools/midpoint-tool/MidpointTool.js

@@ -0,0 +1,77 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { midpoint as turfMidpoint, point } from '@turf/turf';
+import { context, SpanStatusCode, trace } from '@opentelemetry/api';
+import { createLocalToolExecutionContext } from '../../utils/tracing.js';
+import { BaseTool } from '../BaseTool.js';
+import { MidpointInputSchema } from './MidpointTool.input.schema.js';
+import { MidpointOutputSchema } from './MidpointTool.output.schema.js';
+/**
+ * MidpointTool - Calculate the geographic midpoint between two coordinates
+ */
+export class MidpointTool extends BaseTool {
+    name = 'midpoint_tool';
+    description = 'Calculate the geographic midpoint between two coordinates. ' +
+        'Returns the point that is halfway between the two input points along the great circle path. ' +
+        'Works offline without API calls.';
+    annotations = {
+        title: 'Calculate Midpoint',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    };
+    constructor() {
+        super({
+            inputSchema: MidpointInputSchema,
+            outputSchema: MidpointOutputSchema
+        });
+    }
+    async run(rawInput) {
+        const toolContext = createLocalToolExecutionContext(this.name, 0);
+        return await context.with(trace.setSpan(context.active(), toolContext.span), async () => {
+            try {
+                const input = MidpointInputSchema.parse(rawInput);
+                const { from, to } = input;
+                const pt1 = point([from.longitude, from.latitude]);
+                const pt2 = point([to.longitude, to.latitude]);
+                const mid = turfMidpoint(pt1, pt2);
+                const result = {
+                    midpoint: {
+                        longitude: Math.round(mid.geometry.coordinates[0] * 1000000) / 1000000,
+                        latitude: Math.round(mid.geometry.coordinates[1] * 1000000) / 1000000
+                    },
+                    from,
+                    to
+                };
+                const validatedResult = this.validateOutput(result);
+                const text = `Midpoint: [${validatedResult.midpoint.longitude}, ${validatedResult.midpoint.latitude}]\n` +
+                    `From: [${validatedResult.from.longitude}, ${validatedResult.from.latitude}]\n` +
+                    `To: [${validatedResult.to.longitude}, ${validatedResult.to.latitude}]`;
+                toolContext.span.setStatus({ code: SpanStatusCode.OK });
+                toolContext.span.end();
+                return {
+                    content: [{ type: 'text', text }],
+                    structuredContent: validatedResult,
+                    isError: false
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                toolContext.span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                toolContext.span.end();
+                this.log('error', `${this.name}: ${errorMessage}`);
+                return {
+                    content: [
+                        { type: 'text', text: `MidpointTool: ${errorMessage}` }
+                    ],
+                    isError: true
+                };
+            }
+        });
+    }
+}
+//# sourceMappingURL=MidpointTool.js.map

package/dist/esm/tools/midpoint-tool/MidpointTool.js.map

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

package/dist/esm/tools/midpoint-tool/MidpointTool.output.schema.d.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+/**
+ * Output schema for MidpointTool
+ */
+export declare const MidpointOutputSchema: z.ZodObject<{
+    midpoint: z.ZodObject<{
+        longitude: z.ZodNumber;
+        latitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        longitude: number;
+        latitude: number;
+    }, {
+        longitude: number;
+        latitude: number;
+    }>;
+    from: z.ZodObject<{
+        longitude: z.ZodNumber;
+        latitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        longitude: number;
+        latitude: number;
+    }, {
+        longitude: number;
+        latitude: number;
+    }>;
+    to: z.ZodObject<{
+        longitude: z.ZodNumber;
+        latitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        longitude: number;
+        latitude: number;
+    }, {
+        longitude: number;
+        latitude: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    from: {
+        longitude: number;
+        latitude: number;
+    };
+    to: {
+        longitude: number;
+        latitude: number;
+    };
+    midpoint: {
+        longitude: number;
+        latitude: number;
+    };
+}, {
+    from: {
+        longitude: number;
+        latitude: number;
+    };
+    to: {
+        longitude: number;
+        latitude: number;
+    };
+    midpoint: {
+        longitude: number;
+        latitude: number;
+    };
+}>;
+/**
+ * Type inference for MidpointOutput
+ */
+export type MidpointOutput = z.infer<typeof MidpointOutputSchema>;
+//# sourceMappingURL=MidpointTool.output.schema.d.ts.map

package/dist/esm/tools/midpoint-tool/MidpointTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MidpointTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/midpoint-tool/MidpointTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/esm/tools/midpoint-tool/MidpointTool.output.schema.js

@@ -0,0 +1,21 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+/**
+ * Output schema for MidpointTool
+ */
+export const MidpointOutputSchema = z.object({
+    midpoint: z.object({
+        longitude: z.number(),
+        latitude: z.number()
+    }),
+    from: z.object({
+        longitude: z.number(),
+        latitude: z.number()
+    }),
+    to: z.object({
+        longitude: z.number(),
+        latitude: z.number()
+    })
+});
+//# sourceMappingURL=MidpointTool.output.schema.js.map

package/dist/esm/tools/midpoint-tool/MidpointTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MidpointTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/midpoint-tool/MidpointTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;IACF,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;IACF,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;QACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;CACH,CAAC,CAAC"}

package/dist/esm/tools/optimization-tool/OptimizationTool.d.ts

@@ -0,0 +1,28 @@
+import { MapboxApiBasedTool } from '../MapboxApiBasedTool.js';
+import { OptimizationInputSchema, type OptimizationInput } from './OptimizationTool.input.schema.js';
+import { OptimizationOutputSchema } from './OptimizationTool.output.schema.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolExecutionContext } from '../../utils/tracing.js';
+import type { HttpRequest } from '../../utils/types.js';
+/**
+ * OptimizationTool - Find optimal route through multiple coordinates (V1 API)
+ *
+ * Uses the Mapbox Optimization API V1 to solve the Traveling Salesman Problem
+ * and return the shortest route by travel time through a set of coordinates.
+ */
+export declare class OptimizationTool extends MapboxApiBasedTool<typeof OptimizationInputSchema, typeof OptimizationOutputSchema> {
+    readonly name = "optimization_tool";
+    readonly description: string;
+    readonly annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    constructor(params: {
+        httpRequest: HttpRequest;
+    });
+    protected execute(input: OptimizationInput, accessToken: string, toolContext: ToolExecutionContext): Promise<CallToolResult>;
+}
+//# sourceMappingURL=OptimizationTool.d.ts.map

package/dist/esm/tools/optimization-tool/OptimizationTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptimizationTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/optimization-tool/OptimizationTool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,wBAAwB,EAEzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB,CACtD,OAAO,uBAAuB,EAC9B,OAAO,wBAAwB,CAChC;IACC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,SAGmE;IAEvF,QAAQ,CAAC,WAAW;;;;;;MAMlB;gBAEU,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;cAQhC,OAAO,CACrB,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,oBAAoB,GAChC,OAAO,CAAC,cAAc,CAAC;CAuI3B"}

package/dist/esm/tools/optimization-tool/OptimizationTool.input.schema.d.ts

@@ -0,0 +1,58 @@
+import z from 'zod';
+/**
+ * Input schema for OptimizationTool (V1 API)
+ *
+ * The V1 Optimization API finds the optimal (shortest by travel time) route
+ * through a set of coordinates, solving the Traveling Salesman Problem.
+ */
+export declare const OptimizationInputSchema: z.ZodObject<{
+    coordinates: z.ZodArray<z.ZodObject<{
+        longitude: z.ZodNumber;
+        latitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        longitude: number;
+        latitude: number;
+    }, {
+        longitude: number;
+        latitude: number;
+    }>, "many">;
+    profile: z.ZodDefault<z.ZodOptional<z.ZodEnum<["mapbox/driving", "mapbox/walking", "mapbox/cycling", "mapbox/driving-traffic"]>>>;
+    source: z.ZodDefault<z.ZodOptional<z.ZodEnum<["any", "first"]>>>;
+    destination: z.ZodDefault<z.ZodOptional<z.ZodEnum<["any", "last"]>>>;
+    roundtrip: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    geometries: z.ZodDefault<z.ZodOptional<z.ZodEnum<["geojson", "polyline", "polyline6"]>>>;
+    overview: z.ZodDefault<z.ZodOptional<z.ZodEnum<["full", "simplified", "false"]>>>;
+    steps: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    annotations: z.ZodOptional<z.ZodArray<z.ZodEnum<["duration", "distance", "speed"]>, "many">>;
+    language: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    coordinates: {
+        longitude: number;
+        latitude: number;
+    }[];
+    geometries: "geojson" | "polyline" | "polyline6";
+    steps: boolean;
+    overview: "false" | "simplified" | "full";
+    profile: "mapbox/driving-traffic" | "mapbox/driving" | "mapbox/walking" | "mapbox/cycling";
+    source: "any" | "first";
+    destination: "any" | "last";
+    roundtrip: boolean;
+    annotations?: ("duration" | "distance" | "speed")[] | undefined;
+    language?: string | undefined;
+}, {
+    coordinates: {
+        longitude: number;
+        latitude: number;
+    }[];
+    annotations?: ("duration" | "distance" | "speed")[] | undefined;
+    language?: string | undefined;
+    geometries?: "geojson" | "polyline" | "polyline6" | undefined;
+    steps?: boolean | undefined;
+    overview?: "false" | "simplified" | "full" | undefined;
+    profile?: "mapbox/driving-traffic" | "mapbox/driving" | "mapbox/walking" | "mapbox/cycling" | undefined;
+    source?: "any" | "first" | undefined;
+    destination?: "any" | "last" | undefined;
+    roundtrip?: boolean | undefined;
+}>;
+export type OptimizationInput = z.infer<typeof OptimizationInputSchema>;
+//# sourceMappingURL=OptimizationTool.input.schema.d.ts.map

package/dist/esm/tools/optimization-tool/OptimizationTool.input.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptimizationTool.input.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/optimization-tool/OptimizationTool.input.schema.ts"],"names":[],"mappings":"AAGA,OAAO,CAAC,MAAM,KAAK,CAAC;AAapB;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2DlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/esm/tools/optimization-tool/OptimizationTool.input.schema.js

@@ -0,0 +1,70 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import z from 'zod';
+import { coordinateSchema } from '../../schemas/shared.js';
+// Profile schema (driving, walking, cycling, driving-traffic)
+const profileSchema = z
+    .enum([
+    'mapbox/driving',
+    'mapbox/walking',
+    'mapbox/cycling',
+    'mapbox/driving-traffic'
+])
+    .describe('Routing profile');
+/**
+ * Input schema for OptimizationTool (V1 API)
+ *
+ * The V1 Optimization API finds the optimal (shortest by travel time) route
+ * through a set of coordinates, solving the Traveling Salesman Problem.
+ */
+export const OptimizationInputSchema = z.object({
+    coordinates: z
+        .array(coordinateSchema)
+        .min(2, 'At least 2 coordinates are required')
+        .max(12, 'Maximum 12 coordinates allowed for V1 API')
+        .describe('Array of {longitude, latitude} coordinate pairs to optimize a route through. ' +
+        'The V1 API supports 2-12 coordinates and returns the optimal visiting order.'),
+    profile: profileSchema
+        .optional()
+        .default('mapbox/driving')
+        .describe('Routing profile to use for optimization'),
+    source: z
+        .enum(['any', 'first'])
+        .optional()
+        .default('any')
+        .describe('Location to start the trip. "any" allows any coordinate, "first" forces the first coordinate as start.'),
+    destination: z
+        .enum(['any', 'last'])
+        .optional()
+        .default('any')
+        .describe('Location to end the trip. "any" allows any coordinate, "last" forces the last coordinate as end.'),
+    roundtrip: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Whether to return to the starting point. Set to false for one-way trips.'),
+    geometries: z
+        .enum(['geojson', 'polyline', 'polyline6'])
+        .optional()
+        .default('geojson')
+        .describe('Format for route geometry'),
+    overview: z
+        .enum(['full', 'simplified', 'false'])
+        .optional()
+        .default('simplified')
+        .describe('Detail level of route geometry'),
+    steps: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether to include turn-by-turn instructions'),
+    annotations: z
+        .array(z.enum(['duration', 'distance', 'speed']))
+        .optional()
+        .describe('Additional metadata to include for each route segment'),
+    language: z
+        .string()
+        .optional()
+        .describe('Language for instructions (if steps=true). ISO 639-1 code (e.g., "en", "es").')
+});
+//# sourceMappingURL=OptimizationTool.input.schema.js.map

package/dist/esm/tools/optimization-tool/OptimizationTool.input.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptimizationTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/optimization-tool/OptimizationTool.input.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,8DAA8D;AAC9D,MAAM,aAAa,GAAG,CAAC;KACpB,IAAI,CAAC;IACJ,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,wBAAwB;CACzB,CAAC;KACD,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,gBAAgB,CAAC;SACvB,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;SAC7C,GAAG,CAAC,EAAE,EAAE,2CAA2C,CAAC;SACpD,QAAQ,CACP,+EAA+E;QAC7E,8EAA8E,CACjF;IACH,OAAO,EAAE,aAAa;SACnB,QAAQ,EAAE;SACV,OAAO,CAAC,gBAAgB,CAAC;SACzB,QAAQ,CAAC,yCAAyC,CAAC;IACtD,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;SACtB,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,wGAAwG,CACzG;IACH,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;SACrB,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,kGAAkG,CACnG;IACH,SAAS,EAAE,CAAC;SACT,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACP,0EAA0E,CAC3E;IACH,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;SAC1C,QAAQ,EAAE;SACV,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,2BAA2B,CAAC;IACxC,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;SACrC,QAAQ,EAAE;SACV,OAAO,CAAC,YAAY,CAAC;SACrB,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;SAChD,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;IACpE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+EAA+E,CAChF;CACJ,CAAC,CAAC"}

package/dist/esm/tools/optimization-tool/OptimizationTool.js

@@ -0,0 +1,138 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { SpanStatusCode } from '@opentelemetry/api';
+import { MapboxApiBasedTool } from '../MapboxApiBasedTool.js';
+import { OptimizationInputSchema } from './OptimizationTool.input.schema.js';
+import { OptimizationOutputSchema } from './OptimizationTool.output.schema.js';
+/**
+ * OptimizationTool - Find optimal route through multiple coordinates (V1 API)
+ *
+ * Uses the Mapbox Optimization API V1 to solve the Traveling Salesman Problem
+ * and return the shortest route by travel time through a set of coordinates.
+ */
+export class OptimizationTool extends MapboxApiBasedTool {
+    name = 'optimization_tool';
+    description = 'Find the optimal (shortest by travel time) route through a set of 2-12 coordinates. ' +
+        'Solves the Traveling Salesman Problem to determine the best visiting order. ' +
+        'Supports options for starting point, ending point, and whether to return to start.';
+    annotations = {
+        title: 'Optimize Multi-Stop Route',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    };
+    constructor(params) {
+        super({
+            inputSchema: OptimizationInputSchema,
+            outputSchema: OptimizationOutputSchema,
+            httpRequest: params.httpRequest
+        });
+    }
+    async execute(input, accessToken, toolContext) {
+        try {
+            // Format coordinates for URL: "lon,lat;lon,lat;..."
+            const coordinatesStr = input.coordinates
+                .map((coord) => `${coord.longitude},${coord.latitude}`)
+                .join(';');
+            // Build query parameters
+            const params = new URLSearchParams({
+                access_token: accessToken
+            });
+            if (input.source) {
+                params.set('source', input.source);
+            }
+            if (input.destination) {
+                params.set('destination', input.destination);
+            }
+            params.set('roundtrip', String(input.roundtrip));
+            if (input.geometries) {
+                params.set('geometries', input.geometries);
+            }
+            if (input.overview) {
+                params.set('overview', input.overview);
+            }
+            if (input.steps !== undefined) {
+                params.set('steps', String(input.steps));
+            }
+            if (input.annotations && input.annotations.length > 0) {
+                params.set('annotations', input.annotations.join(','));
+            }
+            if (input.language) {
+                params.set('language', input.language);
+            }
+            // Build URL: GET /optimized-trips/v1/{profile}/{coordinates}
+            const url = `${MapboxApiBasedTool.mapboxApiEndpoint}optimized-trips/v1/${input.profile}/${coordinatesStr}?${params.toString()}`;
+            toolContext.span.setAttribute('optimization.coordinates_count', input.coordinates.length);
+            toolContext.span.setAttribute('optimization.profile', input.profile);
+            toolContext.span.setAttribute('optimization.roundtrip', input.roundtrip);
+            // Make synchronous GET request
+            const response = await this.httpRequest(url);
+            if (!response.ok) {
+                const errorMessage = await this.getErrorMessage(response);
+                toolContext.span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Optimization API error: ${errorMessage}`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+            const data = (await response.json());
+            // Validate output
+            const validatedResult = this.validateOutput(data);
+            // Check for API error in response
+            if (validatedResult.code !== 'Ok') {
+                const errorMsg = validatedResult.message || validatedResult.code;
+                toolContext.span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: errorMsg
+                });
+                return {
+                    content: [
+                        { type: 'text', text: `Optimization error: ${errorMsg}` }
+                    ],
+                    structuredContent: validatedResult,
+                    isError: true
+                };
+            }
+            // Format success response
+            const trip = validatedResult.trips[0];
+            const durationMin = (trip.duration / 60).toFixed(1);
+            const distanceKm = (trip.distance / 1000).toFixed(2);
+            const text = `Optimized route through ${validatedResult.waypoints.length} waypoints:\n` +
+                `- Total duration: ${durationMin} minutes\n` +
+                `- Total distance: ${distanceKm} km\n` +
+                `- Optimized order: ${validatedResult.waypoints.map((_, i) => i).join(' → ')}`;
+            toolContext.span.setAttribute('optimization.duration_seconds', trip.duration);
+            toolContext.span.setAttribute('optimization.distance_meters', trip.distance);
+            toolContext.span.setAttribute('optimization.waypoints_count', validatedResult.waypoints.length);
+            return {
+                content: [{ type: 'text', text }],
+                structuredContent: validatedResult,
+                isError: false
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            toolContext.span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: errorMessage
+            });
+            this.log('error', `${this.name}: ${errorMessage}`);
+            return {
+                content: [
+                    { type: 'text', text: `OptimizationTool: ${errorMessage}` }
+                ],
+                isError: true
+            };
+        }
+    }
+}
+//# sourceMappingURL=OptimizationTool.js.map

package/dist/esm/tools/optimization-tool/OptimizationTool.js.map

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