@mapbox/mcp-server 0.8.1 → 0.8.3

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

@@ -0,0 +1,84 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+/**
+ * Waypoint schema - snapped coordinates on the road network
+ */
+const waypointSchema = z
+    .object({
+    name: z.string().optional().describe('Name of the road/path at this point'),
+    location: z
+        .tuple([z.number(), z.number()])
+        .describe('Snapped coordinate as [longitude, latitude]'),
+    trips_index: z
+        .number()
+        .describe('Index of the trip this waypoint belongs to'),
+    waypoint_index: z
+        .number()
+        .describe('Position of this waypoint within its trip')
+})
+    .passthrough();
+/**
+ * Leg schema - segment between two waypoints
+ */
+const legSchema = z
+    .object({
+    distance: z.number().describe('Distance for this leg in meters'),
+    duration: z.number().describe('Duration for this leg in seconds'),
+    steps: z
+        .array(z.any())
+        .optional()
+        .describe('Turn-by-turn instructions (if steps=true)'),
+    summary: z
+        .string()
+        .optional()
+        .describe('Summary of the leg (if available)'),
+    annotation: z
+        .object({
+        duration: z.array(z.number()).optional(),
+        distance: z.array(z.number()).optional(),
+        speed: z.array(z.number()).optional()
+    })
+        .optional()
+        .describe('Detailed annotations for the leg (if requested)')
+})
+    .passthrough();
+/**
+ * Trip schema - the optimized route
+ */
+const tripSchema = z
+    .object({
+    geometry: z
+        .union([z.string(), z.any()])
+        .describe('Route geometry as GeoJSON LineString or encoded polyline string'),
+    legs: z.array(legSchema).describe('Array of legs between waypoints'),
+    weight: z.number().describe('Weight value used in optimization'),
+    weight_name: z
+        .string()
+        .optional()
+        .describe('Name of weight type used (default: "routability")'),
+    duration: z.number().describe('Total trip duration in seconds'),
+    distance: z.number().describe('Total trip distance in meters')
+})
+    .passthrough();
+/**
+ * Output schema for OptimizationTool (V1 API)
+ *
+ * Returns the optimized trip through all input coordinates.
+ */
+export const OptimizationOutputSchema = z
+    .object({
+    code: z
+        .string()
+        .describe('Status code (e.g., "Ok" for success, error code otherwise)'),
+    waypoints: z
+        .array(waypointSchema)
+        .describe('Input coordinates snapped to the road network in optimized order'),
+    trips: z
+        .array(tripSchema)
+        .describe('Array containing the optimized trip (typically 1 trip for all waypoints)'),
+    // Error response fields
+    message: z.string().optional().describe('Error message if code is not "Ok"')
+})
+    .passthrough();
+//# sourceMappingURL=OptimizationTool.output.schema.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HttpRequest } from '../../utils/types.js';
+/**
+ * Register the Optimization V2 tool as a task-based tool
+ *
+ * ⚠️ BETA: This tool uses the V2 API which requires early access.
+ * Not registered by default - call this function manually to enable.
+ */
+export declare function registerOptimizationV2Task(server: McpServer, httpRequest: HttpRequest): void;
+//# sourceMappingURL=OptimizationV2Tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OptimizationV2Tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/optimization-tool/OptimizationV2Tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAkSxD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,GACvB,IAAI,CAyIN"}

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

@@ -0,0 +1,303 @@
+import z from 'zod';
+export declare const OptimizationV2InputSchema: 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"]>>>;
+    vehicles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        routing_profile: z.ZodOptional<z.ZodEnum<["mapbox/driving", "mapbox/walking", "mapbox/cycling", "mapbox/driving-traffic"]>>;
+        start_location: z.ZodOptional<z.ZodString>;
+        end_location: z.ZodOptional<z.ZodString>;
+        capacities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        earliest_start: z.ZodOptional<z.ZodString>;
+        latest_end: z.ZodOptional<z.ZodString>;
+        breaks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            earliest_start: z.ZodString;
+            latest_end: z.ZodString;
+            duration: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            duration: number;
+            earliest_start: string;
+            latest_end: string;
+        }, {
+            duration: number;
+            earliest_start: string;
+            latest_end: string;
+        }>, "many">>;
+        loading_policy: z.ZodOptional<z.ZodEnum<["any", "fifo", "lifo"]>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        capabilities?: string[] | undefined;
+        routing_profile?: "mapbox/driving-traffic" | "mapbox/driving" | "mapbox/walking" | "mapbox/cycling" | undefined;
+        earliest_start?: string | undefined;
+        latest_end?: string | undefined;
+        start_location?: string | undefined;
+        end_location?: string | undefined;
+        capacities?: Record<string, number> | undefined;
+        breaks?: {
+            duration: number;
+            earliest_start: string;
+            latest_end: string;
+        }[] | undefined;
+        loading_policy?: "any" | "fifo" | "lifo" | undefined;
+    }, {
+        name: string;
+        capabilities?: string[] | undefined;
+        routing_profile?: "mapbox/driving-traffic" | "mapbox/driving" | "mapbox/walking" | "mapbox/cycling" | undefined;
+        earliest_start?: string | undefined;
+        latest_end?: string | undefined;
+        start_location?: string | undefined;
+        end_location?: string | undefined;
+        capacities?: Record<string, number> | undefined;
+        breaks?: {
+            duration: number;
+            earliest_start: string;
+            latest_end: string;
+        }[] | undefined;
+        loading_policy?: "any" | "fifo" | "lifo" | undefined;
+    }>, "many">>;
+    services: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        location: z.ZodString;
+        duration: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        requirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        service_times: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            earliest: z.ZodString;
+            latest: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<["strict", "soft", "soft_start", "soft_end"]>>;
+        }, "strip", z.ZodTypeAny, {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }, {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        duration: number;
+        name: string;
+        location: string;
+        requirements?: string[] | undefined;
+        service_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+    }, {
+        name: string;
+        location: string;
+        duration?: number | undefined;
+        requirements?: string[] | undefined;
+        service_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    shipments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodString;
+        size: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        requirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pickup_duration: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        dropoff_duration: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        pickup_times: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            earliest: z.ZodString;
+            latest: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<["strict", "soft", "soft_start", "soft_end"]>>;
+        }, "strip", z.ZodTypeAny, {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }, {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }>, "many">>;
+        dropoff_times: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            earliest: z.ZodString;
+            latest: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<["strict", "soft", "soft_start", "soft_end"]>>;
+        }, "strip", z.ZodTypeAny, {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }, {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        from: string;
+        to: string;
+        pickup_duration: number;
+        dropoff_duration: number;
+        size?: Record<string, number> | undefined;
+        requirements?: string[] | undefined;
+        pickup_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+        dropoff_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+    }, {
+        name: string;
+        from: string;
+        to: string;
+        size?: Record<string, number> | undefined;
+        requirements?: string[] | undefined;
+        pickup_duration?: number | undefined;
+        dropoff_duration?: number | undefined;
+        pickup_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+        dropoff_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    options: z.ZodOptional<z.ZodObject<{
+        objectives: z.ZodOptional<z.ZodArray<z.ZodEnum<["min-total-travel-duration", "min-schedule-completion-time"]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        objectives?: ("min-total-travel-duration" | "min-schedule-completion-time")[] | undefined;
+    }, {
+        objectives?: ("min-total-travel-duration" | "min-schedule-completion-time")[] | undefined;
+    }>>;
+    max_polling_attempts: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    polling_interval_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    coordinates: {
+        longitude: number;
+        latitude: number;
+    }[];
+    profile: "mapbox/driving-traffic" | "mapbox/driving" | "mapbox/walking" | "mapbox/cycling";
+    max_polling_attempts: number;
+    polling_interval_ms: number;
+    options?: {
+        objectives?: ("min-total-travel-duration" | "min-schedule-completion-time")[] | undefined;
+    } | undefined;
+    vehicles?: {
+        name: string;
+        capabilities?: string[] | undefined;
+        routing_profile?: "mapbox/driving-traffic" | "mapbox/driving" | "mapbox/walking" | "mapbox/cycling" | undefined;
+        earliest_start?: string | undefined;
+        latest_end?: string | undefined;
+        start_location?: string | undefined;
+        end_location?: string | undefined;
+        capacities?: Record<string, number> | undefined;
+        breaks?: {
+            duration: number;
+            earliest_start: string;
+            latest_end: string;
+        }[] | undefined;
+        loading_policy?: "any" | "fifo" | "lifo" | undefined;
+    }[] | undefined;
+    services?: {
+        duration: number;
+        name: string;
+        location: string;
+        requirements?: string[] | undefined;
+        service_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    shipments?: {
+        name: string;
+        from: string;
+        to: string;
+        pickup_duration: number;
+        dropoff_duration: number;
+        size?: Record<string, number> | undefined;
+        requirements?: string[] | undefined;
+        pickup_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+        dropoff_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+    }[] | undefined;
+}, {
+    coordinates: {
+        longitude: number;
+        latitude: number;
+    }[];
+    options?: {
+        objectives?: ("min-total-travel-duration" | "min-schedule-completion-time")[] | undefined;
+    } | undefined;
+    profile?: "mapbox/driving-traffic" | "mapbox/driving" | "mapbox/walking" | "mapbox/cycling" | undefined;
+    vehicles?: {
+        name: string;
+        capabilities?: string[] | undefined;
+        routing_profile?: "mapbox/driving-traffic" | "mapbox/driving" | "mapbox/walking" | "mapbox/cycling" | undefined;
+        earliest_start?: string | undefined;
+        latest_end?: string | undefined;
+        start_location?: string | undefined;
+        end_location?: string | undefined;
+        capacities?: Record<string, number> | undefined;
+        breaks?: {
+            duration: number;
+            earliest_start: string;
+            latest_end: string;
+        }[] | undefined;
+        loading_policy?: "any" | "fifo" | "lifo" | undefined;
+    }[] | undefined;
+    services?: {
+        name: string;
+        location: string;
+        duration?: number | undefined;
+        requirements?: string[] | undefined;
+        service_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    shipments?: {
+        name: string;
+        from: string;
+        to: string;
+        size?: Record<string, number> | undefined;
+        requirements?: string[] | undefined;
+        pickup_duration?: number | undefined;
+        dropoff_duration?: number | undefined;
+        pickup_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+        dropoff_times?: {
+            earliest: string;
+            latest: string;
+            type?: "strict" | "soft" | "soft_start" | "soft_end" | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    max_polling_attempts?: number | undefined;
+    polling_interval_ms?: number | undefined;
+}>;
+export type OptimizationV2Input = z.infer<typeof OptimizationV2InputSchema>;
+//# sourceMappingURL=OptimizationV2Tool.input.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OptimizationV2Tool.input.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/optimization-tool/OptimizationV2Tool.input.schema.ts"],"names":[],"mappings":"AAGA,OAAO,CAAC,MAAM,KAAK,CAAC;AA+JpB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

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

@@ -0,0 +1,180 @@
+// 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 OptimizationV2Tool (V2 API - Beta)
+ *
+ * The V2 API is currently in beta and requires early access.
+ * Supports advanced features: time windows, capacity limits, vehicle capabilities,
+ * shipments, breaks, and more.
+ */
+const optionsSchema = z.object({
+    objectives: z
+        .array(z.enum(['min-total-travel-duration', 'min-schedule-completion-time']))
+        .optional()
+        .describe('Optimization objectives')
+});
+const iso8601Schema = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?([+-]\d{2}:\d{2}|Z)?$/, 'Must be a valid ISO 8601 datetime string (e.g., 2023-07-22T14:29:23-07:00)');
+const timeWindowSchema = z.object({
+    earliest: iso8601Schema.describe('Earliest time for this window'),
+    latest: iso8601Schema.describe('Latest time for this window'),
+    type: z
+        .enum(['strict', 'soft', 'soft_start', 'soft_end'])
+        .optional()
+        .describe('Type of time window constraint')
+});
+const vehicleBreakSchema = z.object({
+    earliest_start: iso8601Schema.describe('Earliest start time for break'),
+    latest_end: iso8601Schema.describe('Latest end time for break'),
+    duration: z.number().int().positive().describe('Break duration in seconds')
+});
+const vehicleSchema = z.object({
+    name: z.string().describe('Unique identifier for this vehicle'),
+    routing_profile: profileSchema
+        .optional()
+        .describe('Routing profile for this vehicle'),
+    start_location: z
+        .string()
+        .optional()
+        .describe('Starting location as a STRING name (e.g., "location-0" for coordinates[0], NOT the integer 0)'),
+    end_location: z
+        .string()
+        .optional()
+        .describe('Ending location as a STRING name (e.g., "location-0" for coordinates[0], NOT the integer 0)'),
+    capacities: z
+        .record(z.number())
+        .optional()
+        .describe('Custom capacity dimensions (e.g., weight, volume)'),
+    capabilities: z
+        .array(z.string())
+        .optional()
+        .describe('Required vehicle capabilities'),
+    earliest_start: iso8601Schema
+        .optional()
+        .describe('Earliest operation start time'),
+    latest_end: iso8601Schema.optional().describe('Latest operation end time'),
+    breaks: z
+        .array(vehicleBreakSchema)
+        .optional()
+        .describe('Vehicle break requirements'),
+    loading_policy: z
+        .enum(['any', 'fifo', 'lifo'])
+        .optional()
+        .describe('Loading/unloading policy')
+});
+const serviceSchema = z.object({
+    name: z.string().describe('Unique identifier for this service'),
+    location: z
+        .string()
+        .describe('Location as a STRING name where service is performed. Use "location-0" for coordinates[0], "location-1" for coordinates[1], etc. (NOT integers like 0, 1, 2)'),
+    duration: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .default(0)
+        .describe('Service duration in seconds'),
+    requirements: z
+        .array(z.string())
+        .optional()
+        .describe('Required vehicle capabilities'),
+    service_times: z
+        .array(timeWindowSchema)
+        .optional()
+        .describe('Time window constraints for service')
+});
+const shipmentSchema = z.object({
+    name: z.string().describe('Unique identifier for this shipment'),
+    from: z
+        .string()
+        .describe('Pickup location as a STRING name (e.g., "location-0" for coordinates[0], NOT the integer 0)'),
+    to: z
+        .string()
+        .describe('Delivery location as a STRING name (e.g., "location-0" for coordinates[0], NOT the integer 0)'),
+    size: z
+        .record(z.number())
+        .optional()
+        .describe('Capacity consumption (weight, volume, etc.)'),
+    requirements: z
+        .array(z.string())
+        .optional()
+        .describe('Required vehicle capabilities'),
+    pickup_duration: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .default(0)
+        .describe('Pickup duration in seconds'),
+    dropoff_duration: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .default(0)
+        .describe('Dropoff duration in seconds'),
+    pickup_times: z
+        .array(timeWindowSchema)
+        .optional()
+        .describe('Time window constraints for pickup'),
+    dropoff_times: z
+        .array(timeWindowSchema)
+        .optional()
+        .describe('Time window constraints for dropoff')
+});
+export const OptimizationV2InputSchema = z.object({
+    coordinates: z
+        .array(coordinateSchema)
+        .min(2, 'At least 2 coordinates are required')
+        .max(1000, 'Maximum 1000 coordinates allowed')
+        .describe('Array of {longitude, latitude} coordinate pairs to optimize a route through. ' +
+        'Must include at least 2 coordinate pairs. ' +
+        'Up to 1000 coordinates total are supported.'),
+    profile: profileSchema
+        .optional()
+        .default('mapbox/driving')
+        .describe('Routing profile to use for optimization'),
+    vehicles: z
+        .array(vehicleSchema)
+        .optional()
+        .describe('Array of vehicle objects. If not provided, a default vehicle will be created automatically. ' +
+        'IMPORTANT: If you provide vehicles, you MUST also provide either "services" or "shipments" to define the stops each vehicle should visit.'),
+    services: z
+        .array(serviceSchema)
+        .optional()
+        .describe('Array of service objects representing individual stops/tasks (e.g., deliveries, pickups, visits). ' +
+        'Each service is performed at a single location. Required when using custom vehicles.'),
+    shipments: z
+        .array(shipmentSchema)
+        .optional()
+        .describe('Array of shipment objects representing paired pickup/delivery tasks. ' +
+        'Each shipment has a pickup location and a delivery location. Can be used with or instead of services when using custom vehicles.'),
+    options: optionsSchema.optional().describe('Optimization options'),
+    max_polling_attempts: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(30)
+        .describe('Maximum number of polling attempts (default: 30)'),
+    polling_interval_ms: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(1000)
+        .describe('Polling interval in milliseconds (default: 1000)')
+});
+//# sourceMappingURL=OptimizationV2Tool.input.schema.js.map

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

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