@burdenoff/mcp-libs 2026.626.1 → 2026.627.2

package/dist/modules/movethewheels/index.js

@@ -0,0 +1,3854 @@
+import { mcpToolName, errorResult, jsonResult, mcpResourceUri, mcpPromptName } from '../../chunk-H2OYWLOA.js';
+import { z } from 'zod';
+
+// src/modules/movethewheels/operations.ts
+var CONTEXT_FIELDS = `context { appId projectId userId workspaceId custom }`;
+var AUDIT_FIELDS = `workspaceId createdBy onBehalfOf updatedBy createdAt updatedAt deletedAt`;
+var CUSTOMER_FIELDS = `
+  id name email phone company type address taxId businessLicense rating
+  ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var DRIVER_FIELDS = `
+  id firstName lastName email phone employeeId userId vehicleId status
+  licenseNumber licenseClass licenseExpiry certifications currentLocation
+  performanceMetrics rating ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var VEHICLE_FIELDS = `
+  id vehicleNumber type status make model year licensePlate capacity
+  currentLocation fuelLevel mileage ownershipType ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var PRODUCT_FIELDS = `
+  id name sku description category brand weight value dimensions fragile
+  hazardous temperatureControlled ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var ORDER_STATUS_HISTORY_FIELDS = `
+  id orderId status previousStatus notes location createdAt
+`;
+var ORDER_FIELDS = `
+  id orderNumber customerId driverId vehicleId orderType status priority
+  pickupAddress deliveryAddress items pricing trackingNumber scheduledDelivery
+  specialInstructions ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var SHIPMENT_FIELDS = `
+  id shipmentNumber orderId customerId carrierId origin destination status
+  trackingNumber cargoDetails estimatedDelivery actualDelivery
+  ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var TRACKING_EVENT_FIELDS = `
+  id shipmentId eventType details location timestamp
+  workspaceId createdBy onBehalfOf updatedBy createdAt updatedAt deletedAt
+  ${CONTEXT_FIELDS}
+`;
+var TRACKING_ALERT_FIELDS = `
+  shipmentId shipmentNumber alertType message
+`;
+var ROUTE_FIELDS = `
+  id name status shipmentId driverId vehicleId waypoints estimatedDistance
+  actualDistance estimatedDuration actualDuration fuelCost
+  ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var WAREHOUSE_LOCATION_FIELDS = `
+  id warehouseId locationCode locationType status zone aisle rack shelf bin
+  capacity ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var WAREHOUSE_FIELDS = `
+  id name code type status address contactInfo operatingHours capabilities
+  totalCapacity usedCapacity ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var INVENTORY_ITEM_FIELDS = `
+  id productId warehouseId locationId onHand available allocated damaged
+  reorderPoint safetyStock unitCost ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var INVENTORY_TRANSACTION_FIELDS = `
+  id transactionNumber type productId warehouseId inventoryItemId quantity
+  unitCost referenceType referenceId notes ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var SERVICE_OFFERING_FIELDS = `
+  id name providerId category description price currency availability
+  ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var SERVICE_PROVIDER_FIELDS = `
+  id name type description isActive isVerified rating services contactInfo
+  ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var REPORT_FIELDS = `
+  id name type status description configuration schedule lastGenerated
+  ${AUDIT_FIELDS} ${CONTEXT_FIELDS}
+`;
+var GET_CUSTOMER = `
+  query MovethewheelsGetCustomer($id: ID!) {
+    customer(id: $id) { ${CUSTOMER_FIELDS} }
+  }
+`;
+var LIST_CUSTOMERS = `
+  query MovethewheelsListCustomers($filter: CustomerFilterInput, $pagination: PaginationInput) {
+    customers(filter: $filter, pagination: $pagination) { ${CUSTOMER_FIELDS} }
+  }
+`;
+var CREATE_CUSTOMER = `
+  mutation MovethewheelsCreateCustomer($input: CreateCustomerInput!) {
+    createCustomer(input: $input) { ${CUSTOMER_FIELDS} }
+  }
+`;
+var UPDATE_CUSTOMER = `
+  mutation MovethewheelsUpdateCustomer($id: ID!, $input: UpdateCustomerInput!) {
+    updateCustomer(id: $id, input: $input) { ${CUSTOMER_FIELDS} }
+  }
+`;
+var DELETE_CUSTOMER = `
+  mutation MovethewheelsDeleteCustomer($id: ID!) {
+    deleteCustomer(id: $id)
+  }
+`;
+var GET_DRIVER = `
+  query MovethewheelsGetDriver($id: ID!) {
+    driver(id: $id) { ${DRIVER_FIELDS} }
+  }
+`;
+var LIST_DRIVERS = `
+  query MovethewheelsListDrivers($filter: DriverFilterInput, $pagination: PaginationInput) {
+    drivers(filter: $filter, pagination: $pagination) { ${DRIVER_FIELDS} }
+  }
+`;
+var CREATE_DRIVER = `
+  mutation MovethewheelsCreateDriver($input: CreateDriverInput!) {
+    createDriver(input: $input) { ${DRIVER_FIELDS} }
+  }
+`;
+var UPDATE_DRIVER = `
+  mutation MovethewheelsUpdateDriver($id: ID!, $input: UpdateDriverInput!) {
+    updateDriver(id: $id, input: $input) { ${DRIVER_FIELDS} }
+  }
+`;
+var UPDATE_DRIVER_STATUS = `
+  mutation MovethewheelsUpdateDriverStatus($id: ID!, $status: DriverStatus!) {
+    updateDriverStatus(id: $id, status: $status) { ${DRIVER_FIELDS} }
+  }
+`;
+var ASSIGN_DRIVER_VEHICLE = `
+  mutation MovethewheelsAssignDriverVehicle($id: ID!, $vehicleId: ID) {
+    assignDriverVehicle(id: $id, vehicleId: $vehicleId) { ${DRIVER_FIELDS} }
+  }
+`;
+var DELETE_DRIVER = `
+  mutation MovethewheelsDeleteDriver($id: ID!) {
+    deleteDriver(id: $id)
+  }
+`;
+var GET_VEHICLE = `
+  query MovethewheelsGetVehicle($id: ID!) {
+    vehicle(id: $id) { ${VEHICLE_FIELDS} }
+  }
+`;
+var LIST_VEHICLES = `
+  query MovethewheelsListVehicles($filter: VehicleFilterInput, $pagination: PaginationInput) {
+    vehicles(filter: $filter, pagination: $pagination) { ${VEHICLE_FIELDS} }
+  }
+`;
+var CREATE_VEHICLE = `
+  mutation MovethewheelsCreateVehicle($input: CreateVehicleInput!) {
+    createVehicle(input: $input) { ${VEHICLE_FIELDS} }
+  }
+`;
+var UPDATE_VEHICLE = `
+  mutation MovethewheelsUpdateVehicle($id: ID!, $input: UpdateVehicleInput!) {
+    updateVehicle(id: $id, input: $input) { ${VEHICLE_FIELDS} }
+  }
+`;
+var UPDATE_VEHICLE_STATUS = `
+  mutation MovethewheelsUpdateVehicleStatus($id: ID!, $status: VehicleStatus!) {
+    updateVehicleStatus(id: $id, status: $status) { ${VEHICLE_FIELDS} }
+  }
+`;
+var UPDATE_VEHICLE_LOCATION = `
+  mutation MovethewheelsUpdateVehicleLocation($id: ID!, $location: JSON!) {
+    updateVehicleLocation(id: $id, location: $location) { ${VEHICLE_FIELDS} }
+  }
+`;
+var DELETE_VEHICLE = `
+  mutation MovethewheelsDeleteVehicle($id: ID!) {
+    deleteVehicle(id: $id)
+  }
+`;
+var GET_PRODUCT = `
+  query MovethewheelsGetProduct($id: ID!) {
+    product(id: $id) { ${PRODUCT_FIELDS} }
+  }
+`;
+var LIST_PRODUCTS = `
+  query MovethewheelsListProducts($filter: ProductFilterInput, $pagination: PaginationInput) {
+    products(filter: $filter, pagination: $pagination) { ${PRODUCT_FIELDS} }
+  }
+`;
+var CREATE_PRODUCT = `
+  mutation MovethewheelsCreateProduct($input: CreateProductInput!) {
+    createProduct(input: $input) { ${PRODUCT_FIELDS} }
+  }
+`;
+var UPDATE_PRODUCT = `
+  mutation MovethewheelsUpdateProduct($id: ID!, $input: UpdateProductInput!) {
+    updateProduct(id: $id, input: $input) { ${PRODUCT_FIELDS} }
+  }
+`;
+var DELETE_PRODUCT = `
+  mutation MovethewheelsDeleteProduct($id: ID!) {
+    deleteProduct(id: $id)
+  }
+`;
+var GET_ORDER = `
+  query MovethewheelsGetOrder($id: ID!) {
+    movethewheelsOrder(id: $id) {
+      ${ORDER_FIELDS}
+      customer { id name email phone }
+      driver { id firstName lastName status }
+      vehicle { id vehicleNumber type status }
+      shipment { id shipmentNumber status }
+      statusHistory { ${ORDER_STATUS_HISTORY_FIELDS} }
+    }
+  }
+`;
+var LIST_ORDERS = `
+  query MovethewheelsListOrders($filter: OrderFilterInput, $pagination: PaginationInput) {
+    movethewheelsOrders(filter: $filter, pagination: $pagination) { ${ORDER_FIELDS} }
+  }
+`;
+var CREATE_ORDER = `
+  mutation MovethewheelsCreateOrder($input: CreateOrderInput!) {
+    createMovethewheelsOrder(input: $input) { ${ORDER_FIELDS} }
+  }
+`;
+var UPDATE_ORDER = `
+  mutation MovethewheelsUpdateOrder($id: ID!, $input: UpdateOrderInput!) {
+    updateMovethewheelsOrder(id: $id, input: $input) { ${ORDER_FIELDS} }
+  }
+`;
+var UPDATE_ORDER_STATUS = `
+  mutation MovethewheelsUpdateOrderStatus($id: ID!, $input: UpdateOrderStatusInput!) {
+    updateMovethewheelsOrderStatus(id: $id, input: $input) {
+      ${ORDER_FIELDS}
+      statusHistory { ${ORDER_STATUS_HISTORY_FIELDS} }
+    }
+  }
+`;
+var DELETE_ORDER = `
+  mutation MovethewheelsDeleteOrder($id: ID!) {
+    deleteMovethewheelsOrder(id: $id)
+  }
+`;
+var GET_SHIPMENT = `
+  query MovethewheelsGetShipment($id: ID!) {
+    shipment(id: $id) {
+      ${SHIPMENT_FIELDS}
+      order { id orderNumber status }
+      trackingEvents { ${TRACKING_EVENT_FIELDS} }
+    }
+  }
+`;
+var LIST_SHIPMENTS = `
+  query MovethewheelsListShipments($filter: ShipmentFilterInput, $pagination: PaginationInput) {
+    shipments(filter: $filter, pagination: $pagination) { ${SHIPMENT_FIELDS} }
+  }
+`;
+var LIST_ACTIVE_DELIVERIES = `
+  query MovethewheelsActiveDeliveries($pagination: PaginationInput) {
+    activeDeliveries(pagination: $pagination) { ${SHIPMENT_FIELDS} }
+  }
+`;
+var CREATE_SHIPMENT = `
+  mutation MovethewheelsCreateShipment($input: CreateShipmentInput!) {
+    createShipment(input: $input) { ${SHIPMENT_FIELDS} }
+  }
+`;
+var UPDATE_SHIPMENT = `
+  mutation MovethewheelsUpdateShipment($id: ID!, $input: UpdateShipmentInput!) {
+    updateShipment(id: $id, input: $input) { ${SHIPMENT_FIELDS} }
+  }
+`;
+var DELETE_SHIPMENT = `
+  mutation MovethewheelsDeleteShipment($id: ID!) {
+    deleteShipment(id: $id)
+  }
+`;
+var GET_ORDER_TRACKING = `
+  query MovethewheelsOrderTracking($orderId: ID!, $pagination: PaginationInput) {
+    orderTracking(orderId: $orderId, pagination: $pagination) { ${TRACKING_EVENT_FIELDS} }
+  }
+`;
+var GET_SHIPMENT_TRACKING = `
+  query MovethewheelsShipmentTracking($shipmentId: ID!, $pagination: PaginationInput) {
+    shipmentTracking(shipmentId: $shipmentId, pagination: $pagination) { ${TRACKING_EVENT_FIELDS} }
+  }
+`;
+var LIST_TRACKING_ALERTS = `
+  query MovethewheelsTrackingAlerts($pagination: PaginationInput) {
+    trackingAlerts(pagination: $pagination) { ${TRACKING_ALERT_FIELDS} }
+  }
+`;
+var ADD_TRACKING_EVENT = `
+  mutation MovethewheelsAddTrackingEvent($input: AddTrackingEventInput!) {
+    addTrackingEvent(input: $input) { ${TRACKING_EVENT_FIELDS} }
+  }
+`;
+var GET_ROUTE = `
+  query MovethewheelsGetRoute($id: ID!) {
+    route(id: $id) {
+      ${ROUTE_FIELDS}
+      driver { id firstName lastName }
+      vehicle { id vehicleNumber type }
+      shipment { id shipmentNumber status }
+    }
+  }
+`;
+var LIST_ROUTES = `
+  query MovethewheelsListRoutes($filter: RouteFilterInput, $pagination: PaginationInput) {
+    routes(filter: $filter, pagination: $pagination) { ${ROUTE_FIELDS} }
+  }
+`;
+var CREATE_ROUTE = `
+  mutation MovethewheelsCreateRoute($input: CreateRouteInput!) {
+    createRoute(input: $input) { ${ROUTE_FIELDS} }
+  }
+`;
+var UPDATE_ROUTE = `
+  mutation MovethewheelsUpdateRoute($id: ID!, $input: UpdateRouteInput!) {
+    updateRoute(id: $id, input: $input) { ${ROUTE_FIELDS} }
+  }
+`;
+var OPTIMIZE_ROUTE = `
+  mutation MovethewheelsOptimizeRoute($id: ID!) {
+    optimizeRoute(id: $id) { ${ROUTE_FIELDS} }
+  }
+`;
+var DELETE_ROUTE = `
+  mutation MovethewheelsDeleteRoute($id: ID!) {
+    deleteRoute(id: $id)
+  }
+`;
+var GET_WAREHOUSE = `
+  query MovethewheelsGetWarehouse($id: ID!) {
+    warehouse(id: $id) {
+      ${WAREHOUSE_FIELDS}
+      locations { ${WAREHOUSE_LOCATION_FIELDS} }
+    }
+  }
+`;
+var LIST_WAREHOUSES = `
+  query MovethewheelsListWarehouses($filter: WarehouseFilterInput, $pagination: PaginationInput) {
+    warehouses(filter: $filter, pagination: $pagination) { ${WAREHOUSE_FIELDS} }
+  }
+`;
+var CREATE_WAREHOUSE = `
+  mutation MovethewheelsCreateWarehouse($input: CreateWarehouseInput!) {
+    createWarehouse(input: $input) { ${WAREHOUSE_FIELDS} }
+  }
+`;
+var UPDATE_WAREHOUSE = `
+  mutation MovethewheelsUpdateWarehouse($id: ID!, $input: UpdateWarehouseInput!) {
+    updateWarehouse(id: $id, input: $input) { ${WAREHOUSE_FIELDS} }
+  }
+`;
+var DELETE_WAREHOUSE = `
+  mutation MovethewheelsDeleteWarehouse($id: ID!) {
+    deleteWarehouse(id: $id)
+  }
+`;
+var CREATE_WAREHOUSE_LOCATION = `
+  mutation MovethewheelsCreateWarehouseLocation($input: CreateWarehouseLocationInput!) {
+    createWarehouseLocation(input: $input) { ${WAREHOUSE_LOCATION_FIELDS} }
+  }
+`;
+var UPDATE_WAREHOUSE_LOCATION = `
+  mutation MovethewheelsUpdateWarehouseLocation($id: ID!, $input: UpdateWarehouseLocationInput!) {
+    updateWarehouseLocation(id: $id, input: $input) { ${WAREHOUSE_LOCATION_FIELDS} }
+  }
+`;
+var GET_INVENTORY_ITEM = `
+  query MovethewheelsGetInventoryItem($id: ID!) {
+    inventoryItem(id: $id) {
+      ${INVENTORY_ITEM_FIELDS}
+      product { id name sku }
+      warehouse { id name code }
+      location { id locationCode }
+    }
+  }
+`;
+var LIST_INVENTORY_ITEMS = `
+  query MovethewheelsListInventoryItems($filter: InventoryFilterInput, $pagination: PaginationInput) {
+    inventoryItems(filter: $filter, pagination: $pagination) { ${INVENTORY_ITEM_FIELDS} }
+  }
+`;
+var GET_INVENTORY_STATS = `
+  query MovethewheelsInventoryStats {
+    inventoryStats {
+      lowStockCount
+      totalAllocated
+      totalAvailable
+      totalDamaged
+      totalOnHand
+    }
+  }
+`;
+var LIST_INVENTORY_TRANSACTIONS = `
+  query MovethewheelsListInventoryTransactions(
+    $filter: InventoryFilterInput
+    $pagination: PaginationInput
+  ) {
+    inventoryTransactions(filter: $filter, pagination: $pagination) {
+      ${INVENTORY_TRANSACTION_FIELDS}
+    }
+  }
+`;
+var CREATE_INVENTORY_ITEM = `
+  mutation MovethewheelsCreateInventoryItem($input: CreateInventoryItemInput!) {
+    createInventoryItem(input: $input) { ${INVENTORY_ITEM_FIELDS} }
+  }
+`;
+var UPDATE_INVENTORY_ITEM = `
+  mutation MovethewheelsUpdateInventoryItem($id: ID!, $input: UpdateInventoryItemInput!) {
+    updateInventoryItem(id: $id, input: $input) { ${INVENTORY_ITEM_FIELDS} }
+  }
+`;
+var ADJUST_INVENTORY_STOCK = `
+  mutation MovethewheelsAdjustInventoryStock($input: AdjustInventoryStockInput!) {
+    adjustInventoryStock(input: $input) { ${INVENTORY_ITEM_FIELDS} }
+  }
+`;
+var DELETE_INVENTORY_ITEM = `
+  mutation MovethewheelsDeleteInventoryItem($id: ID!) {
+    deleteInventoryItem(id: $id)
+  }
+`;
+var CREATE_INVENTORY_TRANSACTION = `
+  mutation MovethewheelsCreateInventoryTransaction($input: CreateInventoryTransactionInput!) {
+    createInventoryTransaction(input: $input) { ${INVENTORY_TRANSACTION_FIELDS} }
+  }
+`;
+var GET_SERVICE_PROVIDER = `
+  query MovethewheelsGetServiceProvider($id: ID!) {
+    serviceProvider(id: $id) {
+      ${SERVICE_PROVIDER_FIELDS}
+      offerings { ${SERVICE_OFFERING_FIELDS} }
+    }
+  }
+`;
+var LIST_SERVICE_PROVIDERS = `
+  query MovethewheelsListServiceProviders(
+    $filter: ServiceProviderFilterInput
+    $pagination: PaginationInput
+  ) {
+    serviceProviders(filter: $filter, pagination: $pagination) { ${SERVICE_PROVIDER_FIELDS} }
+  }
+`;
+var CREATE_SERVICE_PROVIDER = `
+  mutation MovethewheelsCreateServiceProvider($input: CreateServiceProviderInput!) {
+    createServiceProvider(input: $input) { ${SERVICE_PROVIDER_FIELDS} }
+  }
+`;
+var UPDATE_SERVICE_PROVIDER = `
+  mutation MovethewheelsUpdateServiceProvider($id: ID!, $input: UpdateServiceProviderInput!) {
+    updateServiceProvider(id: $id, input: $input) { ${SERVICE_PROVIDER_FIELDS} }
+  }
+`;
+var DELETE_SERVICE_PROVIDER = `
+  mutation MovethewheelsDeleteServiceProvider($id: ID!) {
+    deleteServiceProvider(id: $id)
+  }
+`;
+var GET_SERVICE_OFFERING = `
+  query MovethewheelsGetServiceOffering($id: ID!) {
+    serviceOffering(id: $id) {
+      ${SERVICE_OFFERING_FIELDS}
+      provider { id name type }
+    }
+  }
+`;
+var LIST_SERVICE_OFFERINGS = `
+  query MovethewheelsListServiceOfferings(
+    $filter: ServiceOfferingFilterInput
+    $pagination: PaginationInput
+  ) {
+    serviceOfferings(filter: $filter, pagination: $pagination) { ${SERVICE_OFFERING_FIELDS} }
+  }
+`;
+var CREATE_SERVICE_OFFERING = `
+  mutation MovethewheelsCreateServiceOffering($input: CreateServiceOfferingInput!) {
+    createServiceOffering(input: $input) { ${SERVICE_OFFERING_FIELDS} }
+  }
+`;
+var UPDATE_SERVICE_OFFERING = `
+  mutation MovethewheelsUpdateServiceOffering($id: ID!, $input: UpdateServiceOfferingInput!) {
+    updateServiceOffering(id: $id, input: $input) { ${SERVICE_OFFERING_FIELDS} }
+  }
+`;
+var DELETE_SERVICE_OFFERING = `
+  mutation MovethewheelsDeleteServiceOffering($id: ID!) {
+    deleteServiceOffering(id: $id)
+  }
+`;
+var GET_REPORT = `
+  query MovethewheelsGetReport($id: ID!) {
+    movethewheelsReport(id: $id) { ${REPORT_FIELDS} }
+  }
+`;
+var LIST_REPORTS = `
+  query MovethewheelsListReports(
+    $filter: MovethewheelsReportFilterInput
+    $pagination: PaginationInput
+  ) {
+    movethewheelsReports(filter: $filter, pagination: $pagination) { ${REPORT_FIELDS} }
+  }
+`;
+var CREATE_REPORT = `
+  mutation MovethewheelsCreateReport($input: CreateMovethewheelsReportInput!) {
+    createMovethewheelsReport(input: $input) { ${REPORT_FIELDS} }
+  }
+`;
+var UPDATE_REPORT = `
+  mutation MovethewheelsUpdateReport($id: ID!, $input: UpdateMovethewheelsReportInput!) {
+    updateMovethewheelsReport(id: $id, input: $input) { ${REPORT_FIELDS} }
+  }
+`;
+var DELETE_REPORT = `
+  mutation MovethewheelsDeleteReport($id: ID!) {
+    deleteMovethewheelsReport(id: $id)
+  }
+`;
+var GENERATE_REPORT = `
+  mutation MovethewheelsGenerateReport($input: GenerateMovethewheelsReportInput!) {
+    generateMovethewheelsReport(input: $input) {
+      generatedAt
+      result
+      report { ${REPORT_FIELDS} }
+    }
+  }
+`;
+var GET_MODULE_SETTINGS = `
+  query MovethewheelsModuleSettings {
+    moduleSettings { workspaceId preferences updatedAt }
+  }
+`;
+var UPDATE_MODULE_SETTINGS = `
+  mutation MovethewheelsUpdateModuleSettings(
+    $input: UpdateMovethewheelsModuleSettingsInput!
+  ) {
+    updateModuleSettings(input: $input) { workspaceId preferences updatedAt }
+  }
+`;
+var EXPORT_DATA = `
+  mutation MovethewheelsExportData($input: MovethewheelsExportDataInput!) {
+    exportData(input: $input) { success message payload }
+  }
+`;
+var IMPORT_DATA = `
+  mutation MovethewheelsImportData($input: MovethewheelsImportDataInput!) {
+    importData(input: $input) { success message payload }
+  }
+`;
+var GET_ANALYTICS = `
+  query MovethewheelsAnalytics {
+    analytics {
+      orderTrend { label value }
+      deliveryTrend { label value }
+      revenueTrend { label value }
+    }
+  }
+`;
+var GET_DASHBOARD_METRICS = `
+  query MovethewheelsDashboardMetrics {
+    dashboardMetrics {
+      totalOrders
+      activeDeliveries
+      activeVehicles
+      availableDrivers
+      lowStockItems
+      totalRevenue
+      recentOrders { id orderNumber status priority createdAt }
+    }
+  }
+`;
+var GET_ORDER_STATS = `
+  query MovethewheelsOrderStats {
+    orderStats { total pending inTransit delivered cancelled failed }
+  }
+`;
+var GET_FLEET_STATS = `
+  query MovethewheelsFleetStats {
+    fleetStats {
+      totalVehicles
+      activeVehicles
+      inTransitVehicles
+      maintenanceVehicles
+      totalDrivers
+      availableDrivers
+      onDeliveryDrivers
+    }
+  }
+`;
+var GET_FINANCE_METRICS = `
+  query MovethewheelsFinanceMetrics {
+    financeMetrics {
+      revenue { totalRevenue deliveredRevenue averageOrderValue }
+      fuelCost
+      openInvoices
+    }
+  }
+`;
+var GET_ASSISTANT_INSIGHTS = `
+  query MovethewheelsAssistantInsights($question: String!) {
+    assistantInsights(question: $question) { question answer generatedAt }
+  }
+`;
+var DriverStatusEnum = z.enum(["AVAILABLE", "INACTIVE", "OFF_DUTY", "ON_BREAK", "ON_DELIVERY"]).describe("Availability/duty status of a driver");
+var InventoryTransactionTypeEnum = z.enum(["ADJUSTMENT", "ISSUE", "RECEIPT", "RETURN", "TRANSFER"]).describe("Type of inventory ledger movement");
+var OrderPriorityEnum = z.enum(["CRITICAL", "HIGH", "LOW", "MEDIUM", "URGENT"]).describe("Fulfilment priority of an order");
+var OrderStatusEnum = z.enum([
+  "ASSIGNED",
+  "CANCELLED",
+  "CONFIRMED",
+  "DELIVERED",
+  "FAILED",
+  "IN_TRANSIT",
+  "OUT_FOR_DELIVERY",
+  "PENDING",
+  "PICKED_UP",
+  "RETURNED"
+]).describe("Fulfilment status of an order");
+var OrderTypeEnum = z.enum(["B2B", "B2C", "MARKETPLACE", "SUBSCRIPTION"]).describe("Commercial type of an order");
+var RouteStatusEnum = z.enum(["CANCELLED", "COMPLETED", "IN_PROGRESS", "PLANNED"]).describe("Lifecycle status of a route");
+var ShipmentStatusEnum = z.enum(["DELIVERED", "FAILED", "IN_TRANSIT", "PICKED_UP", "PLANNED", "RETURNED"]).describe("Lifecycle status of a shipment");
+var TrackingEventTypeEnum = z.enum([
+  "ARRIVED",
+  "CREATED",
+  "DELIVERED",
+  "DEPARTED",
+  "FAILED",
+  "IN_TRANSIT",
+  "OUT_FOR_DELIVERY",
+  "PICKED_UP",
+  "RETURNED"
+]).describe("Type of shipment tracking event");
+var VehicleStatusEnum = z.enum(["ACTIVE", "DECOMMISSIONED", "INACTIVE", "IN_TRANSIT", "MAINTENANCE"]).describe("Operational status of a vehicle");
+var VehicleTypeEnum = z.enum([
+  "BICYCLE",
+  "DRONE",
+  "FLATBED",
+  "MOTORCYCLE",
+  "REFRIGERATED",
+  "SEMI_TRAILER",
+  "TRUCK",
+  "VAN"
+]).describe("Class of vehicle in the fleet");
+var WarehouseTypeEnum = z.enum(["COLD_STORAGE", "CROSS_DOCK", "DISTRIBUTION", "FULFILLMENT", "RETAIL"]).describe("Type of warehouse facility");
+var JsonObject = z.record(z.string(), z.unknown());
+var JsonValue = z.union([JsonObject, z.array(z.unknown())]);
+
+// src/modules/movethewheels/tools/customers.ts
+function registerCustomerTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "customers_get")),
+    {
+      title: "Get Customer",
+      description: "Fetch a single Movethewheels customer by ID.",
+      inputSchema: { id: z.string().describe("Customer ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_CUSTOMER, { id });
+        if (!data.customer) return errorResult(`Customer ${id} not found`);
+        return jsonResult(data.customer);
+      } catch (error) {
+        ctx.logger.error("movethewheels customers_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get customer: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "customers_list")),
+    {
+      title: "List Customers",
+      description: "List customers in the bound workspace with optional type/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across name/company/email"),
+        type: z.string().optional().describe('Filter by customer type, e.g. "b2c" or "b2b"'),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, type, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (type !== void 0) filter.type = type;
+        const data = await ctx.gql.workspace.request(LIST_CUSTOMERS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.customers);
+      } catch (error) {
+        ctx.logger.error("movethewheels customers_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list customers: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "customers_create")),
+    {
+      title: "Create Customer",
+      description: 'Onboard a new customer. `name` is required; `type` defaults to "b2c".',
+      inputSchema: {
+        name: z.string().min(1).describe("Customer display name"),
+        email: z.string().optional().describe("Contact email"),
+        phone: z.string().optional().describe("Contact phone"),
+        company: z.string().optional().describe("Company name (B2B)"),
+        type: z.string().optional().describe('Customer type, e.g. "b2c" or "b2b" (default "b2c")'),
+        address: JsonObject.optional().describe("Address JSON"),
+        taxId: z.string().optional().describe("Tax identifier"),
+        businessLicense: z.string().optional().describe("Business license identifier"),
+        rating: z.number().optional().describe("Customer rating")
+      }
+    },
+    async ({ name, email, phone, company, type, address, taxId, businessLicense, rating }) => {
+      try {
+        const input = { name };
+        if (email !== void 0) input.email = email;
+        if (phone !== void 0) input.phone = phone;
+        if (company !== void 0) input.company = company;
+        if (type !== void 0) input.type = type;
+        if (address !== void 0) input.address = address;
+        if (taxId !== void 0) input.taxId = taxId;
+        if (businessLicense !== void 0) input.businessLicense = businessLicense;
+        if (rating !== void 0) input.rating = rating;
+        const data = await ctx.gql.workspace.request(CREATE_CUSTOMER, { input });
+        return jsonResult(data.createCustomer);
+      } catch (error) {
+        ctx.logger.error("movethewheels customers_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create customer: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "customers_update")),
+    {
+      title: "Update Customer",
+      description: "Update a customer. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Customer ID"),
+        name: z.string().optional().describe("Updated display name"),
+        email: z.string().optional().describe("Updated email"),
+        phone: z.string().optional().describe("Updated phone"),
+        company: z.string().optional().describe("Updated company"),
+        type: z.string().optional().describe("Updated customer type"),
+        address: JsonObject.optional().describe("Updated address JSON"),
+        taxId: z.string().optional().describe("Updated tax identifier"),
+        businessLicense: z.string().optional().describe("Updated business license"),
+        rating: z.number().optional().describe("Updated rating")
+      }
+    },
+    async ({ id, name, email, phone, company, type, address, taxId, businessLicense, rating }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (email !== void 0) input.email = email;
+        if (phone !== void 0) input.phone = phone;
+        if (company !== void 0) input.company = company;
+        if (type !== void 0) input.type = type;
+        if (address !== void 0) input.address = address;
+        if (taxId !== void 0) input.taxId = taxId;
+        if (businessLicense !== void 0) input.businessLicense = businessLicense;
+        if (rating !== void 0) input.rating = rating;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_CUSTOMER, { id, input });
+        return jsonResult(data.updateCustomer);
+      } catch (error) {
+        ctx.logger.error("movethewheels customers_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update customer: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "customers_delete")),
+    {
+      title: "Delete Customer",
+      description: "Soft-delete a customer by ID.",
+      inputSchema: { id: z.string().describe("Customer ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_CUSTOMER,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteCustomer, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels customers_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete customer: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerDriverTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "drivers_get")),
+    {
+      title: "Get Driver",
+      description: "Fetch a single driver by ID.",
+      inputSchema: { id: z.string().describe("Driver ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_DRIVER, { id });
+        if (!data.driver) return errorResult(`Driver ${id} not found`);
+        return jsonResult(data.driver);
+      } catch (error) {
+        ctx.logger.error("movethewheels drivers_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get driver: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "drivers_list")),
+    {
+      title: "List Drivers",
+      description: "List drivers with optional status/vehicle/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across name/employeeId"),
+        status: DriverStatusEnum.optional().describe("Filter by driver status"),
+        vehicleId: z.string().optional().describe("Filter by assigned vehicle ID"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, status, vehicleId, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (status !== void 0) filter.status = status;
+        if (vehicleId !== void 0) filter.vehicleId = vehicleId;
+        const data = await ctx.gql.workspace.request(LIST_DRIVERS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.drivers);
+      } catch (error) {
+        ctx.logger.error("movethewheels drivers_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list drivers: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "drivers_create")),
+    {
+      title: "Create Driver",
+      description: "Add a driver to the fleet roster. `employeeId`, `firstName`, and `lastName` are required; `status` defaults to AVAILABLE.",
+      inputSchema: {
+        employeeId: z.string().min(1).describe("Internal employee identifier"),
+        firstName: z.string().min(1).describe("Driver first name"),
+        lastName: z.string().min(1).describe("Driver last name"),
+        email: z.string().optional().describe("Contact email"),
+        phone: z.string().optional().describe("Contact phone"),
+        userId: z.string().optional().describe("Linked platform user ID"),
+        vehicleId: z.string().optional().describe("Assigned vehicle ID"),
+        status: DriverStatusEnum.optional().describe("Initial status (default AVAILABLE)"),
+        licenseNumber: z.string().optional().describe("Driving license number"),
+        licenseClass: z.string().optional().describe("Driving license class"),
+        licenseExpiry: z.string().optional().describe("License expiry (ISO 8601 DateTime)"),
+        certifications: JsonObject.optional().describe("Certifications JSON"),
+        currentLocation: JsonObject.optional().describe("Current location JSON ({ lat, lng })"),
+        performanceMetrics: JsonObject.optional().describe("Performance metrics JSON"),
+        rating: z.number().optional().describe("Driver rating")
+      }
+    },
+    async ({
+      employeeId,
+      firstName,
+      lastName,
+      email,
+      phone,
+      userId,
+      vehicleId,
+      status,
+      licenseNumber,
+      licenseClass,
+      licenseExpiry,
+      certifications,
+      currentLocation,
+      performanceMetrics,
+      rating
+    }) => {
+      try {
+        const input = { employeeId, firstName, lastName };
+        if (email !== void 0) input.email = email;
+        if (phone !== void 0) input.phone = phone;
+        if (userId !== void 0) input.userId = userId;
+        if (vehicleId !== void 0) input.vehicleId = vehicleId;
+        if (status !== void 0) input.status = status;
+        if (licenseNumber !== void 0) input.licenseNumber = licenseNumber;
+        if (licenseClass !== void 0) input.licenseClass = licenseClass;
+        if (licenseExpiry !== void 0) input.licenseExpiry = licenseExpiry;
+        if (certifications !== void 0) input.certifications = certifications;
+        if (currentLocation !== void 0) input.currentLocation = currentLocation;
+        if (performanceMetrics !== void 0) input.performanceMetrics = performanceMetrics;
+        if (rating !== void 0) input.rating = rating;
+        const data = await ctx.gql.workspace.request(CREATE_DRIVER, { input });
+        return jsonResult(data.createDriver);
+      } catch (error) {
+        ctx.logger.error("movethewheels drivers_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create driver: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "drivers_update")),
+    {
+      title: "Update Driver",
+      description: "Update a driver. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Driver ID"),
+        firstName: z.string().optional().describe("Updated first name"),
+        lastName: z.string().optional().describe("Updated last name"),
+        email: z.string().optional().describe("Updated email"),
+        phone: z.string().optional().describe("Updated phone"),
+        userId: z.string().optional().describe("Updated linked user ID"),
+        vehicleId: z.string().optional().describe("Updated assigned vehicle ID"),
+        status: DriverStatusEnum.optional().describe("Updated status"),
+        licenseNumber: z.string().optional().describe("Updated license number"),
+        licenseClass: z.string().optional().describe("Updated license class"),
+        licenseExpiry: z.string().optional().describe("Updated license expiry (ISO 8601)"),
+        certifications: JsonObject.optional().describe("Updated certifications JSON"),
+        currentLocation: JsonObject.optional().describe("Updated location JSON"),
+        performanceMetrics: JsonObject.optional().describe("Updated performance metrics JSON"),
+        rating: z.number().optional().describe("Updated rating")
+      }
+    },
+    async ({
+      id,
+      firstName,
+      lastName,
+      email,
+      phone,
+      userId,
+      vehicleId,
+      status,
+      licenseNumber,
+      licenseClass,
+      licenseExpiry,
+      certifications,
+      currentLocation,
+      performanceMetrics,
+      rating
+    }) => {
+      try {
+        const input = {};
+        if (firstName !== void 0) input.firstName = firstName;
+        if (lastName !== void 0) input.lastName = lastName;
+        if (email !== void 0) input.email = email;
+        if (phone !== void 0) input.phone = phone;
+        if (userId !== void 0) input.userId = userId;
+        if (vehicleId !== void 0) input.vehicleId = vehicleId;
+        if (status !== void 0) input.status = status;
+        if (licenseNumber !== void 0) input.licenseNumber = licenseNumber;
+        if (licenseClass !== void 0) input.licenseClass = licenseClass;
+        if (licenseExpiry !== void 0) input.licenseExpiry = licenseExpiry;
+        if (certifications !== void 0) input.certifications = certifications;
+        if (currentLocation !== void 0) input.currentLocation = currentLocation;
+        if (performanceMetrics !== void 0) input.performanceMetrics = performanceMetrics;
+        if (rating !== void 0) input.rating = rating;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_DRIVER, { id, input });
+        return jsonResult(data.updateDriver);
+      } catch (error) {
+        ctx.logger.error("movethewheels drivers_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update driver: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "drivers_update_status")),
+    {
+      title: "Update Driver Status",
+      description: "Set a driver\u2019s duty/availability status.",
+      inputSchema: {
+        id: z.string().describe("Driver ID"),
+        status: DriverStatusEnum.describe("New driver status")
+      }
+    },
+    async ({ id, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(UPDATE_DRIVER_STATUS, { id, status });
+        return jsonResult(data.updateDriverStatus);
+      } catch (error) {
+        ctx.logger.error("movethewheels drivers_update_status failed", { error: String(error) });
+        return errorResult(
+          `Failed to update driver status: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "drivers_assign_vehicle")),
+    {
+      title: "Assign Driver Vehicle",
+      description: "Assign (or, with no vehicleId, unassign) a vehicle to a driver. Pass `vehicleId` to assign; omit it to clear the assignment.",
+      inputSchema: {
+        id: z.string().describe("Driver ID"),
+        vehicleId: z.string().optional().describe("Vehicle ID to assign (omit to unassign)")
+      }
+    },
+    async ({ id, vehicleId }) => {
+      try {
+        const data = await ctx.gql.workspace.request(ASSIGN_DRIVER_VEHICLE, { id, vehicleId: vehicleId ?? null });
+        return jsonResult(data.assignDriverVehicle);
+      } catch (error) {
+        ctx.logger.error("movethewheels drivers_assign_vehicle failed", { error: String(error) });
+        return errorResult(
+          `Failed to assign vehicle: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "drivers_delete")),
+    {
+      title: "Delete Driver",
+      description: "Soft-delete a driver by ID.",
+      inputSchema: { id: z.string().describe("Driver ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(DELETE_DRIVER, {
+          id
+        });
+        return jsonResult({ deleted: data.deleteDriver, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels drivers_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete driver: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerVehicleTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "vehicles_get")),
+    {
+      title: "Get Vehicle",
+      description: "Fetch a single vehicle by ID.",
+      inputSchema: { id: z.string().describe("Vehicle ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_VEHICLE, { id });
+        if (!data.vehicle) return errorResult(`Vehicle ${id} not found`);
+        return jsonResult(data.vehicle);
+      } catch (error) {
+        ctx.logger.error("movethewheels vehicles_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get vehicle: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "vehicles_list")),
+    {
+      title: "List Vehicles",
+      description: "List fleet vehicles with optional status/type/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across vehicleNumber/make/model"),
+        status: VehicleStatusEnum.optional().describe("Filter by vehicle status"),
+        type: VehicleTypeEnum.optional().describe("Filter by vehicle type"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, status, type, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (status !== void 0) filter.status = status;
+        if (type !== void 0) filter.type = type;
+        const data = await ctx.gql.workspace.request(LIST_VEHICLES, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.vehicles);
+      } catch (error) {
+        ctx.logger.error("movethewheels vehicles_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list vehicles: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "vehicles_create")),
+    {
+      title: "Create Vehicle",
+      description: "Register a vehicle in the fleet. `vehicleNumber` and `type` are required; `status` defaults to ACTIVE.",
+      inputSchema: {
+        vehicleNumber: z.string().min(1).describe("Fleet vehicle number / registration"),
+        type: VehicleTypeEnum.describe("Vehicle class"),
+        status: VehicleStatusEnum.optional().describe("Initial status (default ACTIVE)"),
+        make: z.string().optional().describe("Manufacturer"),
+        model: z.string().optional().describe("Model"),
+        year: z.number().int().optional().describe("Model year"),
+        licensePlate: z.string().optional().describe("License plate"),
+        capacity: JsonObject.optional().describe("Capacity JSON ({ weight, volume, ... })"),
+        currentLocation: JsonObject.optional().describe("Current location JSON ({ lat, lng })"),
+        fuelLevel: z.number().optional().describe("Fuel level (0-100)"),
+        mileage: z.number().optional().describe("Odometer mileage"),
+        ownershipType: z.string().optional().describe('Ownership type, e.g. "owned", "leased"')
+      }
+    },
+    async ({
+      vehicleNumber,
+      type,
+      status,
+      make,
+      model,
+      year,
+      licensePlate,
+      capacity,
+      currentLocation,
+      fuelLevel,
+      mileage,
+      ownershipType
+    }) => {
+      try {
+        const input = { vehicleNumber, type };
+        if (status !== void 0) input.status = status;
+        if (make !== void 0) input.make = make;
+        if (model !== void 0) input.model = model;
+        if (year !== void 0) input.year = year;
+        if (licensePlate !== void 0) input.licensePlate = licensePlate;
+        if (capacity !== void 0) input.capacity = capacity;
+        if (currentLocation !== void 0) input.currentLocation = currentLocation;
+        if (fuelLevel !== void 0) input.fuelLevel = fuelLevel;
+        if (mileage !== void 0) input.mileage = mileage;
+        if (ownershipType !== void 0) input.ownershipType = ownershipType;
+        const data = await ctx.gql.workspace.request(CREATE_VEHICLE, { input });
+        return jsonResult(data.createVehicle);
+      } catch (error) {
+        ctx.logger.error("movethewheels vehicles_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create vehicle: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "vehicles_update")),
+    {
+      title: "Update Vehicle",
+      description: "Update a vehicle. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Vehicle ID"),
+        vehicleNumber: z.string().optional().describe("Updated vehicle number"),
+        type: VehicleTypeEnum.optional().describe("Updated vehicle type"),
+        status: VehicleStatusEnum.optional().describe("Updated status"),
+        make: z.string().optional().describe("Updated manufacturer"),
+        model: z.string().optional().describe("Updated model"),
+        year: z.number().int().optional().describe("Updated model year"),
+        licensePlate: z.string().optional().describe("Updated license plate"),
+        capacity: JsonObject.optional().describe("Updated capacity JSON"),
+        currentLocation: JsonObject.optional().describe("Updated location JSON"),
+        fuelLevel: z.number().optional().describe("Updated fuel level"),
+        mileage: z.number().optional().describe("Updated mileage"),
+        ownershipType: z.string().optional().describe("Updated ownership type")
+      }
+    },
+    async ({
+      id,
+      vehicleNumber,
+      type,
+      status,
+      make,
+      model,
+      year,
+      licensePlate,
+      capacity,
+      currentLocation,
+      fuelLevel,
+      mileage,
+      ownershipType
+    }) => {
+      try {
+        const input = {};
+        if (vehicleNumber !== void 0) input.vehicleNumber = vehicleNumber;
+        if (type !== void 0) input.type = type;
+        if (status !== void 0) input.status = status;
+        if (make !== void 0) input.make = make;
+        if (model !== void 0) input.model = model;
+        if (year !== void 0) input.year = year;
+        if (licensePlate !== void 0) input.licensePlate = licensePlate;
+        if (capacity !== void 0) input.capacity = capacity;
+        if (currentLocation !== void 0) input.currentLocation = currentLocation;
+        if (fuelLevel !== void 0) input.fuelLevel = fuelLevel;
+        if (mileage !== void 0) input.mileage = mileage;
+        if (ownershipType !== void 0) input.ownershipType = ownershipType;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_VEHICLE, { id, input });
+        return jsonResult(data.updateVehicle);
+      } catch (error) {
+        ctx.logger.error("movethewheels vehicles_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update vehicle: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "vehicles_update_status")),
+    {
+      title: "Update Vehicle Status",
+      description: "Set a vehicle\u2019s operational status.",
+      inputSchema: {
+        id: z.string().describe("Vehicle ID"),
+        status: VehicleStatusEnum.describe("New vehicle status")
+      }
+    },
+    async ({ id, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(UPDATE_VEHICLE_STATUS, { id, status });
+        return jsonResult(data.updateVehicleStatus);
+      } catch (error) {
+        ctx.logger.error("movethewheels vehicles_update_status failed", { error: String(error) });
+        return errorResult(
+          `Failed to update vehicle status: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "vehicles_update_location")),
+    {
+      title: "Update Vehicle Location",
+      description: "Push a new GPS/telemetry location for a vehicle (location JSON, e.g. { lat, lng }).",
+      inputSchema: {
+        id: z.string().describe("Vehicle ID"),
+        location: JsonObject.describe("Location JSON ({ lat, lng, ... })")
+      }
+    },
+    async ({ id, location }) => {
+      try {
+        const data = await ctx.gql.workspace.request(UPDATE_VEHICLE_LOCATION, { id, location });
+        return jsonResult(data.updateVehicleLocation);
+      } catch (error) {
+        ctx.logger.error("movethewheels vehicles_update_location failed", { error: String(error) });
+        return errorResult(
+          `Failed to update vehicle location: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "vehicles_delete")),
+    {
+      title: "Delete Vehicle",
+      description: "Soft-delete a vehicle by ID.",
+      inputSchema: { id: z.string().describe("Vehicle ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_VEHICLE,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteVehicle, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels vehicles_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete vehicle: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerProductTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "products_get")),
+    {
+      title: "Get Product",
+      description: "Fetch a single product (cargo SKU) by ID.",
+      inputSchema: { id: z.string().describe("Product ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_PRODUCT, { id });
+        if (!data.product) return errorResult(`Product ${id} not found`);
+        return jsonResult(data.product);
+      } catch (error) {
+        ctx.logger.error("movethewheels products_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get product: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "products_list")),
+    {
+      title: "List Products",
+      description: "List products with optional category/sku/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across name/description"),
+        category: z.string().optional().describe("Filter by category"),
+        sku: z.string().optional().describe("Filter by SKU"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, category, sku, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (category !== void 0) filter.category = category;
+        if (sku !== void 0) filter.sku = sku;
+        const data = await ctx.gql.workspace.request(LIST_PRODUCTS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.products);
+      } catch (error) {
+        ctx.logger.error("movethewheels products_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list products: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "products_create")),
+    {
+      title: "Create Product",
+      description: "Create a product (cargo SKU). `name` and `sku` are required.",
+      inputSchema: {
+        name: z.string().min(1).describe("Product name"),
+        sku: z.string().min(1).describe("Stock-keeping unit (unique)"),
+        description: z.string().optional().describe("Description"),
+        category: z.string().optional().describe("Category"),
+        brand: z.string().optional().describe("Brand"),
+        weight: z.number().optional().describe("Unit weight"),
+        value: z.number().optional().describe("Declared value"),
+        dimensions: JsonObject.optional().describe("Dimensions JSON ({ length, width, height })"),
+        fragile: z.boolean().optional().describe("Whether the item is fragile (default false)"),
+        hazardous: z.boolean().optional().describe("Whether the item is hazardous (default false)"),
+        temperatureControlled: z.boolean().optional().describe("Whether the item needs temperature control (default false)")
+      }
+    },
+    async ({
+      name,
+      sku,
+      description,
+      category,
+      brand,
+      weight,
+      value,
+      dimensions,
+      fragile,
+      hazardous,
+      temperatureControlled
+    }) => {
+      try {
+        const input = { name, sku };
+        if (description !== void 0) input.description = description;
+        if (category !== void 0) input.category = category;
+        if (brand !== void 0) input.brand = brand;
+        if (weight !== void 0) input.weight = weight;
+        if (value !== void 0) input.value = value;
+        if (dimensions !== void 0) input.dimensions = dimensions;
+        if (fragile !== void 0) input.fragile = fragile;
+        if (hazardous !== void 0) input.hazardous = hazardous;
+        if (temperatureControlled !== void 0) {
+          input.temperatureControlled = temperatureControlled;
+        }
+        const data = await ctx.gql.workspace.request(CREATE_PRODUCT, { input });
+        return jsonResult(data.createProduct);
+      } catch (error) {
+        ctx.logger.error("movethewheels products_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create product: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "products_update")),
+    {
+      title: "Update Product",
+      description: "Update a product. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Product ID"),
+        name: z.string().optional().describe("Updated name"),
+        sku: z.string().optional().describe("Updated SKU"),
+        description: z.string().optional().describe("Updated description"),
+        category: z.string().optional().describe("Updated category"),
+        brand: z.string().optional().describe("Updated brand"),
+        weight: z.number().optional().describe("Updated weight"),
+        value: z.number().optional().describe("Updated value"),
+        dimensions: JsonObject.optional().describe("Updated dimensions JSON"),
+        fragile: z.boolean().optional().describe("Updated fragile flag"),
+        hazardous: z.boolean().optional().describe("Updated hazardous flag"),
+        temperatureControlled: z.boolean().optional().describe("Updated temperature-control flag")
+      }
+    },
+    async ({
+      id,
+      name,
+      sku,
+      description,
+      category,
+      brand,
+      weight,
+      value,
+      dimensions,
+      fragile,
+      hazardous,
+      temperatureControlled
+    }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (sku !== void 0) input.sku = sku;
+        if (description !== void 0) input.description = description;
+        if (category !== void 0) input.category = category;
+        if (brand !== void 0) input.brand = brand;
+        if (weight !== void 0) input.weight = weight;
+        if (value !== void 0) input.value = value;
+        if (dimensions !== void 0) input.dimensions = dimensions;
+        if (fragile !== void 0) input.fragile = fragile;
+        if (hazardous !== void 0) input.hazardous = hazardous;
+        if (temperatureControlled !== void 0) {
+          input.temperatureControlled = temperatureControlled;
+        }
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_PRODUCT, { id, input });
+        return jsonResult(data.updateProduct);
+      } catch (error) {
+        ctx.logger.error("movethewheels products_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update product: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "products_delete")),
+    {
+      title: "Delete Product",
+      description: "Soft-delete a product by ID.",
+      inputSchema: { id: z.string().describe("Product ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_PRODUCT,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteProduct, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels products_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete product: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerOrderTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "orders_get")),
+    {
+      title: "Get Order",
+      description: "Fetch a single delivery order by ID, including customer/driver/vehicle/shipment links and status history.",
+      inputSchema: { id: z.string().describe("Order ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_ORDER, { id });
+        if (!data.movethewheelsOrder) return errorResult(`Order ${id} not found`);
+        return jsonResult(data.movethewheelsOrder);
+      } catch (error) {
+        ctx.logger.error("movethewheels orders_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get order: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "orders_list")),
+    {
+      title: "List Orders",
+      description: "List delivery orders with optional customer/driver/vehicle/type/priority/status/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across orderNumber"),
+        customerId: z.string().optional().describe("Filter by customer ID"),
+        driverId: z.string().optional().describe("Filter by driver ID"),
+        vehicleId: z.string().optional().describe("Filter by vehicle ID"),
+        orderType: OrderTypeEnum.optional().describe("Filter by order type"),
+        priority: OrderPriorityEnum.optional().describe("Filter by priority"),
+        status: OrderStatusEnum.optional().describe("Filter by status"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({
+      search,
+      customerId,
+      driverId,
+      vehicleId,
+      orderType,
+      priority,
+      status,
+      limit,
+      offset
+    }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (customerId !== void 0) filter.customerId = customerId;
+        if (driverId !== void 0) filter.driverId = driverId;
+        if (vehicleId !== void 0) filter.vehicleId = vehicleId;
+        if (orderType !== void 0) filter.orderType = orderType;
+        if (priority !== void 0) filter.priority = priority;
+        if (status !== void 0) filter.status = status;
+        const data = await ctx.gql.workspace.request(LIST_ORDERS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.movethewheelsOrders);
+      } catch (error) {
+        ctx.logger.error("movethewheels orders_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list orders: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "orders_create")),
+    {
+      title: "Create Order",
+      description: "Create a delivery order. `customerId`, `orderNumber`, `pickupAddress`, `deliveryAddress`, and `items` are required. `orderType` defaults to B2C, `priority` to MEDIUM, `status` to PENDING.",
+      inputSchema: {
+        customerId: z.string().min(1).describe("Ordering customer ID"),
+        orderNumber: z.string().min(1).describe("Human-readable order number (unique)"),
+        pickupAddress: JsonObject.describe("Pickup address JSON"),
+        deliveryAddress: JsonObject.describe("Delivery address JSON"),
+        items: JsonValue.describe("Order items JSON (array of line items)"),
+        orderType: OrderTypeEnum.optional().describe("Order type (default B2C)"),
+        priority: OrderPriorityEnum.optional().describe("Priority (default MEDIUM)"),
+        status: OrderStatusEnum.optional().describe("Initial status (default PENDING)"),
+        driverId: z.string().optional().describe("Assigned driver ID"),
+        vehicleId: z.string().optional().describe("Assigned vehicle ID"),
+        pricing: JsonObject.optional().describe("Pricing breakdown JSON"),
+        scheduledDelivery: z.string().optional().describe("Scheduled delivery (ISO 8601 DateTime)"),
+        specialInstructions: z.string().optional().describe("Special handling instructions"),
+        trackingNumber: z.string().optional().describe("Tracking number")
+      }
+    },
+    async ({
+      customerId,
+      orderNumber,
+      pickupAddress,
+      deliveryAddress,
+      items,
+      orderType,
+      priority,
+      status,
+      driverId,
+      vehicleId,
+      pricing,
+      scheduledDelivery,
+      specialInstructions,
+      trackingNumber
+    }) => {
+      try {
+        const input = {
+          customerId,
+          orderNumber,
+          pickupAddress,
+          deliveryAddress,
+          items
+        };
+        if (orderType !== void 0) input.orderType = orderType;
+        if (priority !== void 0) input.priority = priority;
+        if (status !== void 0) input.status = status;
+        if (driverId !== void 0) input.driverId = driverId;
+        if (vehicleId !== void 0) input.vehicleId = vehicleId;
+        if (pricing !== void 0) input.pricing = pricing;
+        if (scheduledDelivery !== void 0) input.scheduledDelivery = scheduledDelivery;
+        if (specialInstructions !== void 0) input.specialInstructions = specialInstructions;
+        if (trackingNumber !== void 0) input.trackingNumber = trackingNumber;
+        const data = await ctx.gql.workspace.request(CREATE_ORDER, { input });
+        return jsonResult(data.createMovethewheelsOrder);
+      } catch (error) {
+        ctx.logger.error("movethewheels orders_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create order: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "orders_update")),
+    {
+      title: "Update Order",
+      description: "Update a delivery order. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Order ID"),
+        customerId: z.string().optional().describe("Updated customer ID"),
+        driverId: z.string().optional().describe("Updated driver ID"),
+        vehicleId: z.string().optional().describe("Updated vehicle ID"),
+        orderType: OrderTypeEnum.optional().describe("Updated order type"),
+        priority: OrderPriorityEnum.optional().describe("Updated priority"),
+        status: OrderStatusEnum.optional().describe("Updated status"),
+        pickupAddress: JsonObject.optional().describe("Updated pickup address JSON"),
+        deliveryAddress: JsonObject.optional().describe("Updated delivery address JSON"),
+        items: JsonValue.optional().describe("Updated items JSON"),
+        pricing: JsonObject.optional().describe("Updated pricing JSON"),
+        scheduledDelivery: z.string().optional().describe("Updated scheduled delivery (ISO 8601)"),
+        specialInstructions: z.string().optional().describe("Updated special instructions"),
+        trackingNumber: z.string().optional().describe("Updated tracking number")
+      }
+    },
+    async ({
+      id,
+      customerId,
+      driverId,
+      vehicleId,
+      orderType,
+      priority,
+      status,
+      pickupAddress,
+      deliveryAddress,
+      items,
+      pricing,
+      scheduledDelivery,
+      specialInstructions,
+      trackingNumber
+    }) => {
+      try {
+        const input = {};
+        if (customerId !== void 0) input.customerId = customerId;
+        if (driverId !== void 0) input.driverId = driverId;
+        if (vehicleId !== void 0) input.vehicleId = vehicleId;
+        if (orderType !== void 0) input.orderType = orderType;
+        if (priority !== void 0) input.priority = priority;
+        if (status !== void 0) input.status = status;
+        if (pickupAddress !== void 0) input.pickupAddress = pickupAddress;
+        if (deliveryAddress !== void 0) input.deliveryAddress = deliveryAddress;
+        if (items !== void 0) input.items = items;
+        if (pricing !== void 0) input.pricing = pricing;
+        if (scheduledDelivery !== void 0) input.scheduledDelivery = scheduledDelivery;
+        if (specialInstructions !== void 0) input.specialInstructions = specialInstructions;
+        if (trackingNumber !== void 0) input.trackingNumber = trackingNumber;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_ORDER, { id, input });
+        return jsonResult(data.updateMovethewheelsOrder);
+      } catch (error) {
+        ctx.logger.error("movethewheels orders_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update order: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "orders_update_status")),
+    {
+      title: "Update Order Status",
+      description: "Advance an order through its delivery lifecycle (e.g. PENDING \u2192 CONFIRMED \u2192 ASSIGNED \u2192 PICKED_UP \u2192 IN_TRANSIT \u2192 OUT_FOR_DELIVERY \u2192 DELIVERED, or CANCELLED/FAILED/RETURNED). Records a status-history entry.",
+      inputSchema: {
+        id: z.string().describe("Order ID"),
+        status: OrderStatusEnum.describe("New order status"),
+        notes: z.string().optional().describe("Status-change notes"),
+        location: JsonObject.optional().describe("Location JSON at time of status change")
+      }
+    },
+    async ({ id, status, notes, location }) => {
+      try {
+        const input = { status };
+        if (notes !== void 0) input.notes = notes;
+        if (location !== void 0) input.location = location;
+        const data = await ctx.gql.workspace.request(UPDATE_ORDER_STATUS, { id, input });
+        return jsonResult(data.updateMovethewheelsOrderStatus);
+      } catch (error) {
+        ctx.logger.error("movethewheels orders_update_status failed", { error: String(error) });
+        return errorResult(
+          `Failed to update order status: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "orders_delete")),
+    {
+      title: "Delete Order",
+      description: "Soft-delete a delivery order by ID.",
+      inputSchema: { id: z.string().describe("Order ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_ORDER,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteMovethewheelsOrder, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels orders_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete order: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerShipmentTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "shipments_get")),
+    {
+      title: "Get Shipment",
+      description: "Fetch a single shipment by ID, including its linked order and tracking events.",
+      inputSchema: { id: z.string().describe("Shipment ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_SHIPMENT, { id });
+        if (!data.shipment) return errorResult(`Shipment ${id} not found`);
+        return jsonResult(data.shipment);
+      } catch (error) {
+        ctx.logger.error("movethewheels shipments_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get shipment: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "shipments_list")),
+    {
+      title: "List Shipments",
+      description: "List shipments with optional order/customer/carrier/status/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across shipmentNumber"),
+        orderId: z.string().optional().describe("Filter by order ID"),
+        customerId: z.string().optional().describe("Filter by customer ID"),
+        carrierId: z.string().optional().describe("Filter by carrier ID"),
+        status: ShipmentStatusEnum.optional().describe("Filter by shipment status"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, orderId, customerId, carrierId, status, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (orderId !== void 0) filter.orderId = orderId;
+        if (customerId !== void 0) filter.customerId = customerId;
+        if (carrierId !== void 0) filter.carrierId = carrierId;
+        if (status !== void 0) filter.status = status;
+        const data = await ctx.gql.workspace.request(LIST_SHIPMENTS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.shipments);
+      } catch (error) {
+        ctx.logger.error("movethewheels shipments_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list shipments: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "shipments_active_deliveries")),
+    {
+      title: "List Active Deliveries",
+      description: "List shipments currently in active delivery (in-transit / out-for-delivery).",
+      inputSchema: {
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_ACTIVE_DELIVERIES, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.activeDeliveries);
+      } catch (error) {
+        ctx.logger.error("movethewheels shipments_active_deliveries failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to list active deliveries: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "shipments_create")),
+    {
+      title: "Create Shipment",
+      description: "Create a shipment for an order. `orderId`, `shipmentNumber`, `origin`, and `destination` are required. `status` defaults to PLANNED.",
+      inputSchema: {
+        orderId: z.string().min(1).describe("Source order ID"),
+        shipmentNumber: z.string().min(1).describe("Human-readable shipment number (unique)"),
+        origin: JsonObject.describe("Origin address JSON"),
+        destination: JsonObject.describe("Destination address JSON"),
+        status: ShipmentStatusEnum.optional().describe("Initial status (default PLANNED)"),
+        customerId: z.string().optional().describe("Customer ID"),
+        carrierId: z.string().optional().describe("Carrier ID"),
+        trackingNumber: z.string().optional().describe("Carrier tracking number"),
+        cargoDetails: JsonObject.optional().describe("Cargo details JSON"),
+        estimatedDelivery: z.string().optional().describe("Estimated delivery (ISO 8601 DateTime)"),
+        actualDelivery: z.string().optional().describe("Actual delivery (ISO 8601 DateTime)")
+      }
+    },
+    async ({
+      orderId,
+      shipmentNumber,
+      origin,
+      destination,
+      status,
+      customerId,
+      carrierId,
+      trackingNumber,
+      cargoDetails,
+      estimatedDelivery,
+      actualDelivery
+    }) => {
+      try {
+        const input = { orderId, shipmentNumber, origin, destination };
+        if (status !== void 0) input.status = status;
+        if (customerId !== void 0) input.customerId = customerId;
+        if (carrierId !== void 0) input.carrierId = carrierId;
+        if (trackingNumber !== void 0) input.trackingNumber = trackingNumber;
+        if (cargoDetails !== void 0) input.cargoDetails = cargoDetails;
+        if (estimatedDelivery !== void 0) input.estimatedDelivery = estimatedDelivery;
+        if (actualDelivery !== void 0) input.actualDelivery = actualDelivery;
+        const data = await ctx.gql.workspace.request(CREATE_SHIPMENT, { input });
+        return jsonResult(data.createShipment);
+      } catch (error) {
+        ctx.logger.error("movethewheels shipments_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create shipment: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "shipments_update")),
+    {
+      title: "Update Shipment",
+      description: "Update a shipment. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Shipment ID"),
+        status: ShipmentStatusEnum.optional().describe("Updated status"),
+        customerId: z.string().optional().describe("Updated customer ID"),
+        carrierId: z.string().optional().describe("Updated carrier ID"),
+        origin: JsonObject.optional().describe("Updated origin JSON"),
+        destination: JsonObject.optional().describe("Updated destination JSON"),
+        trackingNumber: z.string().optional().describe("Updated tracking number"),
+        cargoDetails: JsonObject.optional().describe("Updated cargo details JSON"),
+        estimatedDelivery: z.string().optional().describe("Updated estimated delivery (ISO 8601)"),
+        actualDelivery: z.string().optional().describe("Updated actual delivery (ISO 8601)")
+      }
+    },
+    async ({
+      id,
+      status,
+      customerId,
+      carrierId,
+      origin,
+      destination,
+      trackingNumber,
+      cargoDetails,
+      estimatedDelivery,
+      actualDelivery
+    }) => {
+      try {
+        const input = {};
+        if (status !== void 0) input.status = status;
+        if (customerId !== void 0) input.customerId = customerId;
+        if (carrierId !== void 0) input.carrierId = carrierId;
+        if (origin !== void 0) input.origin = origin;
+        if (destination !== void 0) input.destination = destination;
+        if (trackingNumber !== void 0) input.trackingNumber = trackingNumber;
+        if (cargoDetails !== void 0) input.cargoDetails = cargoDetails;
+        if (estimatedDelivery !== void 0) input.estimatedDelivery = estimatedDelivery;
+        if (actualDelivery !== void 0) input.actualDelivery = actualDelivery;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_SHIPMENT, { id, input });
+        return jsonResult(data.updateShipment);
+      } catch (error) {
+        ctx.logger.error("movethewheels shipments_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update shipment: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "shipments_delete")),
+    {
+      title: "Delete Shipment",
+      description: "Soft-delete a shipment by ID.",
+      inputSchema: { id: z.string().describe("Shipment ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_SHIPMENT,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteShipment, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels shipments_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete shipment: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerTrackingTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tracking_order_events")),
+    {
+      title: "Order Tracking Timeline",
+      description: "List tracking events for an order (across its shipments), most recent first.",
+      inputSchema: {
+        orderId: z.string().describe("Order ID"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ orderId, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_ORDER_TRACKING, {
+          orderId,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.orderTracking);
+      } catch (error) {
+        ctx.logger.error("movethewheels tracking_order_events failed", { error: String(error) });
+        return errorResult(
+          `Failed to get order tracking: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tracking_shipment_events")),
+    {
+      title: "Shipment Tracking Timeline",
+      description: "List tracking events for a single shipment, most recent first.",
+      inputSchema: {
+        shipmentId: z.string().describe("Shipment ID"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ shipmentId, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_SHIPMENT_TRACKING, {
+          shipmentId,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.shipmentTracking);
+      } catch (error) {
+        ctx.logger.error("movethewheels tracking_shipment_events failed", { error: String(error) });
+        return errorResult(
+          `Failed to get shipment tracking: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tracking_alerts")),
+    {
+      title: "Tracking Alerts",
+      description: "List active tracking alerts (delayed / exception shipments needing attention).",
+      inputSchema: {
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_TRACKING_ALERTS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.trackingAlerts);
+      } catch (error) {
+        ctx.logger.error("movethewheels tracking_alerts failed", { error: String(error) });
+        return errorResult(
+          `Failed to list tracking alerts: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tracking_add_event")),
+    {
+      title: "Add Tracking Event",
+      description: "Append a tracking event to a shipment timeline. `shipmentId` and `eventType` are required.",
+      inputSchema: {
+        shipmentId: z.string().min(1).describe("Shipment ID"),
+        eventType: TrackingEventTypeEnum.describe("Type of tracking event"),
+        details: z.string().optional().describe("Free-text event details"),
+        location: JsonObject.optional().describe("Location JSON ({ lat, lng, address })"),
+        timestamp: z.string().optional().describe("Event timestamp (ISO 8601; defaults to now)")
+      }
+    },
+    async ({ shipmentId, eventType, details, location, timestamp }) => {
+      try {
+        const input = { shipmentId, eventType };
+        if (details !== void 0) input.details = details;
+        if (location !== void 0) input.location = location;
+        if (timestamp !== void 0) input.timestamp = timestamp;
+        const data = await ctx.gql.workspace.request(ADD_TRACKING_EVENT, { input });
+        return jsonResult(data.addTrackingEvent);
+      } catch (error) {
+        ctx.logger.error("movethewheels tracking_add_event failed", { error: String(error) });
+        return errorResult(
+          `Failed to add tracking event: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerRouteTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "routes_get")),
+    {
+      title: "Get Route",
+      description: "Fetch a single route by ID, including its linked driver, vehicle, and shipment.",
+      inputSchema: { id: z.string().describe("Route ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_ROUTE, { id });
+        if (!data.route) return errorResult(`Route ${id} not found`);
+        return jsonResult(data.route);
+      } catch (error) {
+        ctx.logger.error("movethewheels routes_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get route: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "routes_list")),
+    {
+      title: "List Routes",
+      description: "List routes with optional driver/vehicle/shipment/status/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across route name"),
+        driverId: z.string().optional().describe("Filter by driver ID"),
+        vehicleId: z.string().optional().describe("Filter by vehicle ID"),
+        shipmentId: z.string().optional().describe("Filter by shipment ID"),
+        status: RouteStatusEnum.optional().describe("Filter by route status"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, driverId, vehicleId, shipmentId, status, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (driverId !== void 0) filter.driverId = driverId;
+        if (vehicleId !== void 0) filter.vehicleId = vehicleId;
+        if (shipmentId !== void 0) filter.shipmentId = shipmentId;
+        if (status !== void 0) filter.status = status;
+        const data = await ctx.gql.workspace.request(LIST_ROUTES, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.routes);
+      } catch (error) {
+        ctx.logger.error("movethewheels routes_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list routes: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "routes_create")),
+    {
+      title: "Create Route",
+      description: "Plan a route. `name` and `waypoints` are required; `status` defaults to PLANNED.",
+      inputSchema: {
+        name: z.string().min(1).describe("Route name"),
+        waypoints: JsonValue.describe("Waypoints JSON (ordered array of stops)"),
+        status: RouteStatusEnum.optional().describe("Initial status (default PLANNED)"),
+        shipmentId: z.string().optional().describe("Linked shipment ID"),
+        driverId: z.string().optional().describe("Assigned driver ID"),
+        vehicleId: z.string().optional().describe("Assigned vehicle ID"),
+        estimatedDistance: z.number().optional().describe("Estimated distance"),
+        actualDistance: z.number().optional().describe("Actual distance"),
+        estimatedDuration: z.number().optional().describe("Estimated duration"),
+        actualDuration: z.number().optional().describe("Actual duration"),
+        fuelCost: z.number().optional().describe("Estimated/actual fuel cost")
+      }
+    },
+    async ({
+      name,
+      waypoints,
+      status,
+      shipmentId,
+      driverId,
+      vehicleId,
+      estimatedDistance,
+      actualDistance,
+      estimatedDuration,
+      actualDuration,
+      fuelCost
+    }) => {
+      try {
+        const input = { name, waypoints };
+        if (status !== void 0) input.status = status;
+        if (shipmentId !== void 0) input.shipmentId = shipmentId;
+        if (driverId !== void 0) input.driverId = driverId;
+        if (vehicleId !== void 0) input.vehicleId = vehicleId;
+        if (estimatedDistance !== void 0) input.estimatedDistance = estimatedDistance;
+        if (actualDistance !== void 0) input.actualDistance = actualDistance;
+        if (estimatedDuration !== void 0) input.estimatedDuration = estimatedDuration;
+        if (actualDuration !== void 0) input.actualDuration = actualDuration;
+        if (fuelCost !== void 0) input.fuelCost = fuelCost;
+        const data = await ctx.gql.workspace.request(CREATE_ROUTE, { input });
+        return jsonResult(data.createRoute);
+      } catch (error) {
+        ctx.logger.error("movethewheels routes_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create route: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "routes_update")),
+    {
+      title: "Update Route",
+      description: "Update a route. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Route ID"),
+        name: z.string().optional().describe("Updated route name"),
+        waypoints: JsonValue.optional().describe("Updated waypoints JSON"),
+        status: RouteStatusEnum.optional().describe("Updated status"),
+        shipmentId: z.string().optional().describe("Updated shipment ID"),
+        driverId: z.string().optional().describe("Updated driver ID"),
+        vehicleId: z.string().optional().describe("Updated vehicle ID"),
+        estimatedDistance: z.number().optional().describe("Updated estimated distance"),
+        actualDistance: z.number().optional().describe("Updated actual distance"),
+        estimatedDuration: z.number().optional().describe("Updated estimated duration"),
+        actualDuration: z.number().optional().describe("Updated actual duration"),
+        fuelCost: z.number().optional().describe("Updated fuel cost")
+      }
+    },
+    async ({
+      id,
+      name,
+      waypoints,
+      status,
+      shipmentId,
+      driverId,
+      vehicleId,
+      estimatedDistance,
+      actualDistance,
+      estimatedDuration,
+      actualDuration,
+      fuelCost
+    }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (waypoints !== void 0) input.waypoints = waypoints;
+        if (status !== void 0) input.status = status;
+        if (shipmentId !== void 0) input.shipmentId = shipmentId;
+        if (driverId !== void 0) input.driverId = driverId;
+        if (vehicleId !== void 0) input.vehicleId = vehicleId;
+        if (estimatedDistance !== void 0) input.estimatedDistance = estimatedDistance;
+        if (actualDistance !== void 0) input.actualDistance = actualDistance;
+        if (estimatedDuration !== void 0) input.estimatedDuration = estimatedDuration;
+        if (actualDuration !== void 0) input.actualDuration = actualDuration;
+        if (fuelCost !== void 0) input.fuelCost = fuelCost;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_ROUTE, { id, input });
+        return jsonResult(data.updateRoute);
+      } catch (error) {
+        ctx.logger.error("movethewheels routes_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update route: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "routes_optimize")),
+    {
+      title: "Optimize Route",
+      description: "Run route optimization for a route (reorders waypoints / recomputes distance & duration).",
+      inputSchema: { id: z.string().describe("Route ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(OPTIMIZE_ROUTE, { id });
+        return jsonResult(data.optimizeRoute);
+      } catch (error) {
+        ctx.logger.error("movethewheels routes_optimize failed", { error: String(error) });
+        return errorResult(
+          `Failed to optimize route: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "routes_delete")),
+    {
+      title: "Delete Route",
+      description: "Soft-delete a route by ID.",
+      inputSchema: { id: z.string().describe("Route ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(DELETE_ROUTE, {
+          id
+        });
+        return jsonResult({ deleted: data.deleteRoute, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels routes_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete route: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerWarehouseTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "warehouses_get")),
+    {
+      title: "Get Warehouse",
+      description: "Fetch a single warehouse by ID, including its storage locations.",
+      inputSchema: { id: z.string().describe("Warehouse ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_WAREHOUSE, { id });
+        if (!data.warehouse) return errorResult(`Warehouse ${id} not found`);
+        return jsonResult(data.warehouse);
+      } catch (error) {
+        ctx.logger.error("movethewheels warehouses_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get warehouse: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "warehouses_list")),
+    {
+      title: "List Warehouses",
+      description: "List warehouses with optional type/status/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across name/code"),
+        status: z.string().optional().describe('Filter by status, e.g. "ACTIVE"'),
+        type: WarehouseTypeEnum.optional().describe("Filter by warehouse type"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, status, type, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (status !== void 0) filter.status = status;
+        if (type !== void 0) filter.type = type;
+        const data = await ctx.gql.workspace.request(LIST_WAREHOUSES, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.warehouses);
+      } catch (error) {
+        ctx.logger.error("movethewheels warehouses_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list warehouses: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "warehouses_create")),
+    {
+      title: "Create Warehouse",
+      description: 'Create a warehouse facility. `name`, `code`, `type`, and `address` are required; `status` defaults to "ACTIVE".',
+      inputSchema: {
+        name: z.string().min(1).describe("Warehouse name"),
+        code: z.string().min(1).describe("Warehouse code (unique)"),
+        type: WarehouseTypeEnum.describe("Warehouse type"),
+        address: JsonObject.describe("Address JSON"),
+        status: z.string().optional().describe('Status (default "ACTIVE")'),
+        contactInfo: JsonObject.optional().describe("Contact info JSON"),
+        operatingHours: JsonObject.optional().describe("Operating hours JSON"),
+        capabilities: JsonObject.optional().describe("Capabilities JSON"),
+        totalCapacity: z.number().optional().describe("Total capacity"),
+        usedCapacity: z.number().optional().describe("Used capacity")
+      }
+    },
+    async ({
+      name,
+      code,
+      type,
+      address,
+      status,
+      contactInfo,
+      operatingHours,
+      capabilities,
+      totalCapacity,
+      usedCapacity
+    }) => {
+      try {
+        const input = { name, code, type, address };
+        if (status !== void 0) input.status = status;
+        if (contactInfo !== void 0) input.contactInfo = contactInfo;
+        if (operatingHours !== void 0) input.operatingHours = operatingHours;
+        if (capabilities !== void 0) input.capabilities = capabilities;
+        if (totalCapacity !== void 0) input.totalCapacity = totalCapacity;
+        if (usedCapacity !== void 0) input.usedCapacity = usedCapacity;
+        const data = await ctx.gql.workspace.request(CREATE_WAREHOUSE, { input });
+        return jsonResult(data.createWarehouse);
+      } catch (error) {
+        ctx.logger.error("movethewheels warehouses_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create warehouse: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "warehouses_update")),
+    {
+      title: "Update Warehouse",
+      description: "Update a warehouse. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Warehouse ID"),
+        name: z.string().optional().describe("Updated name"),
+        code: z.string().optional().describe("Updated code"),
+        type: WarehouseTypeEnum.optional().describe("Updated type"),
+        status: z.string().optional().describe("Updated status"),
+        address: JsonObject.optional().describe("Updated address JSON"),
+        contactInfo: JsonObject.optional().describe("Updated contact info JSON"),
+        operatingHours: JsonObject.optional().describe("Updated operating hours JSON"),
+        capabilities: JsonObject.optional().describe("Updated capabilities JSON"),
+        totalCapacity: z.number().optional().describe("Updated total capacity"),
+        usedCapacity: z.number().optional().describe("Updated used capacity")
+      }
+    },
+    async ({
+      id,
+      name,
+      code,
+      type,
+      status,
+      address,
+      contactInfo,
+      operatingHours,
+      capabilities,
+      totalCapacity,
+      usedCapacity
+    }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (code !== void 0) input.code = code;
+        if (type !== void 0) input.type = type;
+        if (status !== void 0) input.status = status;
+        if (address !== void 0) input.address = address;
+        if (contactInfo !== void 0) input.contactInfo = contactInfo;
+        if (operatingHours !== void 0) input.operatingHours = operatingHours;
+        if (capabilities !== void 0) input.capabilities = capabilities;
+        if (totalCapacity !== void 0) input.totalCapacity = totalCapacity;
+        if (usedCapacity !== void 0) input.usedCapacity = usedCapacity;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_WAREHOUSE, { id, input });
+        return jsonResult(data.updateWarehouse);
+      } catch (error) {
+        ctx.logger.error("movethewheels warehouses_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update warehouse: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "warehouses_delete")),
+    {
+      title: "Delete Warehouse",
+      description: "Soft-delete a warehouse by ID.",
+      inputSchema: { id: z.string().describe("Warehouse ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_WAREHOUSE,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteWarehouse, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels warehouses_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete warehouse: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "warehouses_create_location")),
+    {
+      title: "Create Warehouse Location",
+      description: 'Create a storage location (bin/shelf/zone) inside a warehouse. `warehouseId` and `locationCode` are required; `status` defaults to "ACTIVE".',
+      inputSchema: {
+        warehouseId: z.string().min(1).describe("Parent warehouse ID"),
+        locationCode: z.string().min(1).describe("Location code (unique within warehouse)"),
+        locationType: z.string().optional().describe('Location type, e.g. "bin", "shelf"'),
+        status: z.string().optional().describe('Status (default "ACTIVE")'),
+        zone: z.string().optional().describe("Zone"),
+        aisle: z.string().optional().describe("Aisle"),
+        rack: z.string().optional().describe("Rack"),
+        shelf: z.string().optional().describe("Shelf"),
+        bin: z.string().optional().describe("Bin"),
+        capacity: z.number().optional().describe("Capacity")
+      }
+    },
+    async ({
+      warehouseId,
+      locationCode,
+      locationType,
+      status,
+      zone,
+      aisle,
+      rack,
+      shelf,
+      bin,
+      capacity
+    }) => {
+      try {
+        const input = { warehouseId, locationCode };
+        if (locationType !== void 0) input.locationType = locationType;
+        if (status !== void 0) input.status = status;
+        if (zone !== void 0) input.zone = zone;
+        if (aisle !== void 0) input.aisle = aisle;
+        if (rack !== void 0) input.rack = rack;
+        if (shelf !== void 0) input.shelf = shelf;
+        if (bin !== void 0) input.bin = bin;
+        if (capacity !== void 0) input.capacity = capacity;
+        const data = await ctx.gql.workspace.request(CREATE_WAREHOUSE_LOCATION, { input });
+        return jsonResult(data.createWarehouseLocation);
+      } catch (error) {
+        ctx.logger.error("movethewheels warehouses_create_location failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to create warehouse location: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "warehouses_update_location")),
+    {
+      title: "Update Warehouse Location",
+      description: "Update a warehouse storage location. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Warehouse location ID"),
+        locationCode: z.string().optional().describe("Updated location code"),
+        locationType: z.string().optional().describe("Updated location type"),
+        status: z.string().optional().describe("Updated status"),
+        zone: z.string().optional().describe("Updated zone"),
+        aisle: z.string().optional().describe("Updated aisle"),
+        rack: z.string().optional().describe("Updated rack"),
+        shelf: z.string().optional().describe("Updated shelf"),
+        bin: z.string().optional().describe("Updated bin"),
+        capacity: z.number().optional().describe("Updated capacity")
+      }
+    },
+    async ({ id, locationCode, locationType, status, zone, aisle, rack, shelf, bin, capacity }) => {
+      try {
+        const input = {};
+        if (locationCode !== void 0) input.locationCode = locationCode;
+        if (locationType !== void 0) input.locationType = locationType;
+        if (status !== void 0) input.status = status;
+        if (zone !== void 0) input.zone = zone;
+        if (aisle !== void 0) input.aisle = aisle;
+        if (rack !== void 0) input.rack = rack;
+        if (shelf !== void 0) input.shelf = shelf;
+        if (bin !== void 0) input.bin = bin;
+        if (capacity !== void 0) input.capacity = capacity;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_WAREHOUSE_LOCATION, { id, input });
+        return jsonResult(data.updateWarehouseLocation);
+      } catch (error) {
+        ctx.logger.error("movethewheels warehouses_update_location failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to update warehouse location: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerInventoryTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_get_item")),
+    {
+      title: "Get Inventory Item",
+      description: "Fetch a single inventory item by ID, including its product, warehouse, and location.",
+      inputSchema: { id: z.string().describe("Inventory item ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_INVENTORY_ITEM, { id });
+        if (!data.inventoryItem) return errorResult(`Inventory item ${id} not found`);
+        return jsonResult(data.inventoryItem);
+      } catch (error) {
+        ctx.logger.error("movethewheels inventory_get_item failed", { error: String(error) });
+        return errorResult(
+          `Failed to get inventory item: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_list_items")),
+    {
+      title: "List Inventory Items",
+      description: "List inventory items with optional product/warehouse/location/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search"),
+        productId: z.string().optional().describe("Filter by product ID"),
+        warehouseId: z.string().optional().describe("Filter by warehouse ID"),
+        locationId: z.string().optional().describe("Filter by location ID"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, productId, warehouseId, locationId, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (productId !== void 0) filter.productId = productId;
+        if (warehouseId !== void 0) filter.warehouseId = warehouseId;
+        if (locationId !== void 0) filter.locationId = locationId;
+        const data = await ctx.gql.workspace.request(LIST_INVENTORY_ITEMS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.inventoryItems);
+      } catch (error) {
+        ctx.logger.error("movethewheels inventory_list_items failed", { error: String(error) });
+        return errorResult(
+          `Failed to list inventory items: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_stats")),
+    {
+      title: "Inventory Stats",
+      description: "Aggregate inventory KPIs: total on-hand / available / allocated / damaged and low-stock count.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_INVENTORY_STATS, {});
+        return jsonResult(data.inventoryStats);
+      } catch (error) {
+        ctx.logger.error("movethewheels inventory_stats failed", { error: String(error) });
+        return errorResult(
+          `Failed to get inventory stats: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_list_transactions")),
+    {
+      title: "List Inventory Transactions",
+      description: "List inventory ledger transactions (receipts/issues/transfers/adjustments/returns) with optional product/warehouse/location/text filters.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search"),
+        productId: z.string().optional().describe("Filter by product ID"),
+        warehouseId: z.string().optional().describe("Filter by warehouse ID"),
+        locationId: z.string().optional().describe("Filter by location ID"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, productId, warehouseId, locationId, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (productId !== void 0) filter.productId = productId;
+        if (warehouseId !== void 0) filter.warehouseId = warehouseId;
+        if (locationId !== void 0) filter.locationId = locationId;
+        const data = await ctx.gql.workspace.request(LIST_INVENTORY_TRANSACTIONS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.inventoryTransactions);
+      } catch (error) {
+        ctx.logger.error("movethewheels inventory_list_transactions failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to list inventory transactions: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_create_item")),
+    {
+      title: "Create Inventory Item",
+      description: "Create an inventory item for a product at a warehouse. `productId` and `warehouseId` are required; stock counts default to 0.",
+      inputSchema: {
+        productId: z.string().min(1).describe("Product ID"),
+        warehouseId: z.string().min(1).describe("Warehouse ID"),
+        locationId: z.string().optional().describe("Storage location ID"),
+        onHand: z.number().int().optional().describe("On-hand quantity (default 0)"),
+        available: z.number().int().optional().describe("Available quantity (default 0)"),
+        allocated: z.number().int().optional().describe("Allocated quantity (default 0)"),
+        damaged: z.number().int().optional().describe("Damaged quantity (default 0)"),
+        reorderPoint: z.number().int().optional().describe("Reorder point"),
+        safetyStock: z.number().int().optional().describe("Safety stock"),
+        unitCost: z.number().optional().describe("Unit cost")
+      }
+    },
+    async ({
+      productId,
+      warehouseId,
+      locationId,
+      onHand,
+      available,
+      allocated,
+      damaged,
+      reorderPoint,
+      safetyStock,
+      unitCost
+    }) => {
+      try {
+        const input = { productId, warehouseId };
+        if (locationId !== void 0) input.locationId = locationId;
+        if (onHand !== void 0) input.onHand = onHand;
+        if (available !== void 0) input.available = available;
+        if (allocated !== void 0) input.allocated = allocated;
+        if (damaged !== void 0) input.damaged = damaged;
+        if (reorderPoint !== void 0) input.reorderPoint = reorderPoint;
+        if (safetyStock !== void 0) input.safetyStock = safetyStock;
+        if (unitCost !== void 0) input.unitCost = unitCost;
+        const data = await ctx.gql.workspace.request(CREATE_INVENTORY_ITEM, { input });
+        return jsonResult(data.createInventoryItem);
+      } catch (error) {
+        ctx.logger.error("movethewheels inventory_create_item failed", { error: String(error) });
+        return errorResult(
+          `Failed to create inventory item: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_update_item")),
+    {
+      title: "Update Inventory Item",
+      description: "Update an inventory item. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Inventory item ID"),
+        locationId: z.string().optional().describe("Updated location ID"),
+        onHand: z.number().int().optional().describe("Updated on-hand quantity"),
+        available: z.number().int().optional().describe("Updated available quantity"),
+        allocated: z.number().int().optional().describe("Updated allocated quantity"),
+        damaged: z.number().int().optional().describe("Updated damaged quantity"),
+        reorderPoint: z.number().int().optional().describe("Updated reorder point"),
+        safetyStock: z.number().int().optional().describe("Updated safety stock"),
+        unitCost: z.number().optional().describe("Updated unit cost")
+      }
+    },
+    async ({
+      id,
+      locationId,
+      onHand,
+      available,
+      allocated,
+      damaged,
+      reorderPoint,
+      safetyStock,
+      unitCost
+    }) => {
+      try {
+        const input = {};
+        if (locationId !== void 0) input.locationId = locationId;
+        if (onHand !== void 0) input.onHand = onHand;
+        if (available !== void 0) input.available = available;
+        if (allocated !== void 0) input.allocated = allocated;
+        if (damaged !== void 0) input.damaged = damaged;
+        if (reorderPoint !== void 0) input.reorderPoint = reorderPoint;
+        if (safetyStock !== void 0) input.safetyStock = safetyStock;
+        if (unitCost !== void 0) input.unitCost = unitCost;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_INVENTORY_ITEM, { id, input });
+        return jsonResult(data.updateInventoryItem);
+      } catch (error) {
+        ctx.logger.error("movethewheels inventory_update_item failed", { error: String(error) });
+        return errorResult(
+          `Failed to update inventory item: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_adjust_stock")),
+    {
+      title: "Adjust Inventory Stock",
+      description: "Directly set one or more stock counts (onHand/available/allocated/damaged) for an inventory item. Provide the item id and at least one count.",
+      inputSchema: {
+        id: z.string().describe("Inventory item ID"),
+        onHand: z.number().int().optional().describe("New on-hand quantity"),
+        available: z.number().int().optional().describe("New available quantity"),
+        allocated: z.number().int().optional().describe("New allocated quantity"),
+        damaged: z.number().int().optional().describe("New damaged quantity")
+      }
+    },
+    async ({ id, onHand, available, allocated, damaged }) => {
+      try {
+        const input = { id };
+        if (onHand !== void 0) input.onHand = onHand;
+        if (available !== void 0) input.available = available;
+        if (allocated !== void 0) input.allocated = allocated;
+        if (damaged !== void 0) input.damaged = damaged;
+        if (Object.keys(input).length === 1) {
+          return errorResult(
+            "No stock counts specified \u2014 provide at least one of onHand/available/allocated/damaged."
+          );
+        }
+        const data = await ctx.gql.workspace.request(ADJUST_INVENTORY_STOCK, { input });
+        return jsonResult(data.adjustInventoryStock);
+      } catch (error) {
+        ctx.logger.error("movethewheels inventory_adjust_stock failed", { error: String(error) });
+        return errorResult(
+          `Failed to adjust inventory stock: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_create_transaction")),
+    {
+      title: "Create Inventory Transaction",
+      description: "Record an inventory ledger transaction (RECEIPT/ISSUE/TRANSFER/ADJUSTMENT/RETURN). `transactionNumber`, `type`, `productId`, `warehouseId`, and `quantity` are required.",
+      inputSchema: {
+        transactionNumber: z.string().min(1).describe("Transaction number (unique)"),
+        type: InventoryTransactionTypeEnum.describe("Transaction type"),
+        productId: z.string().min(1).describe("Product ID"),
+        warehouseId: z.string().min(1).describe("Warehouse ID"),
+        quantity: z.number().int().describe("Quantity moved (sign per transaction semantics)"),
+        inventoryItemId: z.string().optional().describe("Affected inventory item ID"),
+        unitCost: z.number().optional().describe("Unit cost"),
+        referenceType: z.string().optional().describe('Reference type, e.g. "order", "shipment"'),
+        referenceId: z.string().optional().describe("Reference ID"),
+        notes: z.string().optional().describe("Notes")
+      }
+    },
+    async ({
+      transactionNumber,
+      type,
+      productId,
+      warehouseId,
+      quantity,
+      inventoryItemId,
+      unitCost,
+      referenceType,
+      referenceId,
+      notes
+    }) => {
+      try {
+        const input = {
+          transactionNumber,
+          type,
+          productId,
+          warehouseId,
+          quantity
+        };
+        if (inventoryItemId !== void 0) input.inventoryItemId = inventoryItemId;
+        if (unitCost !== void 0) input.unitCost = unitCost;
+        if (referenceType !== void 0) input.referenceType = referenceType;
+        if (referenceId !== void 0) input.referenceId = referenceId;
+        if (notes !== void 0) input.notes = notes;
+        const data = await ctx.gql.workspace.request(CREATE_INVENTORY_TRANSACTION, { input });
+        return jsonResult(data.createInventoryTransaction);
+      } catch (error) {
+        ctx.logger.error("movethewheels inventory_create_transaction failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to create inventory transaction: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_delete_item")),
+    {
+      title: "Delete Inventory Item",
+      description: "Soft-delete an inventory item by ID.",
+      inputSchema: { id: z.string().describe("Inventory item ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_INVENTORY_ITEM,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteInventoryItem, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels inventory_delete_item failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete inventory item: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerMarketplaceTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_get_provider")),
+    {
+      title: "Get Service Provider",
+      description: "Fetch a single logistics service provider by ID, including its offerings.",
+      inputSchema: { id: z.string().describe("Service provider ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_SERVICE_PROVIDER, { id });
+        if (!data.serviceProvider) return errorResult(`Service provider ${id} not found`);
+        return jsonResult(data.serviceProvider);
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_get_provider failed", { error: String(error) });
+        return errorResult(
+          `Failed to get service provider: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_list_providers")),
+    {
+      title: "List Service Providers",
+      description: "List logistics service providers with optional type/active/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across name/description"),
+        type: z.string().optional().describe("Filter by provider type"),
+        isActive: z.boolean().optional().describe("Filter by active flag"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, type, isActive, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (type !== void 0) filter.type = type;
+        if (isActive !== void 0) filter.isActive = isActive;
+        const data = await ctx.gql.workspace.request(LIST_SERVICE_PROVIDERS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.serviceProviders);
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_list_providers failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to list service providers: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_create_provider")),
+    {
+      title: "Create Service Provider",
+      description: "Onboard a logistics service provider. `name` and `type` are required; `isActive` defaults to true, `isVerified` to false.",
+      inputSchema: {
+        name: z.string().min(1).describe("Provider name"),
+        type: z.string().min(1).describe('Provider type, e.g. "carrier", "broker"'),
+        description: z.string().optional().describe("Description"),
+        isActive: z.boolean().optional().describe("Active flag (default true)"),
+        isVerified: z.boolean().optional().describe("Verified flag (default false)"),
+        rating: z.number().optional().describe("Rating"),
+        services: JsonObject.optional().describe("Services JSON"),
+        contactInfo: JsonObject.optional().describe("Contact info JSON")
+      }
+    },
+    async ({ name, type, description, isActive, isVerified, rating, services, contactInfo }) => {
+      try {
+        const input = { name, type };
+        if (description !== void 0) input.description = description;
+        if (isActive !== void 0) input.isActive = isActive;
+        if (isVerified !== void 0) input.isVerified = isVerified;
+        if (rating !== void 0) input.rating = rating;
+        if (services !== void 0) input.services = services;
+        if (contactInfo !== void 0) input.contactInfo = contactInfo;
+        const data = await ctx.gql.workspace.request(CREATE_SERVICE_PROVIDER, { input });
+        return jsonResult(data.createServiceProvider);
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_create_provider failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to create service provider: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_update_provider")),
+    {
+      title: "Update Service Provider",
+      description: "Update a service provider. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Service provider ID"),
+        name: z.string().optional().describe("Updated name"),
+        type: z.string().optional().describe("Updated type"),
+        description: z.string().optional().describe("Updated description"),
+        isActive: z.boolean().optional().describe("Updated active flag"),
+        isVerified: z.boolean().optional().describe("Updated verified flag"),
+        rating: z.number().optional().describe("Updated rating"),
+        services: JsonObject.optional().describe("Updated services JSON"),
+        contactInfo: JsonObject.optional().describe("Updated contact info JSON")
+      }
+    },
+    async ({
+      id,
+      name,
+      type,
+      description,
+      isActive,
+      isVerified,
+      rating,
+      services,
+      contactInfo
+    }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (type !== void 0) input.type = type;
+        if (description !== void 0) input.description = description;
+        if (isActive !== void 0) input.isActive = isActive;
+        if (isVerified !== void 0) input.isVerified = isVerified;
+        if (rating !== void 0) input.rating = rating;
+        if (services !== void 0) input.services = services;
+        if (contactInfo !== void 0) input.contactInfo = contactInfo;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_SERVICE_PROVIDER, { id, input });
+        return jsonResult(data.updateServiceProvider);
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_update_provider failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to update service provider: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_delete_provider")),
+    {
+      title: "Delete Service Provider",
+      description: "Soft-delete a service provider by ID.",
+      inputSchema: { id: z.string().describe("Service provider ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_SERVICE_PROVIDER,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteServiceProvider, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_delete_provider failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to delete service provider: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_get_offering")),
+    {
+      title: "Get Service Offering",
+      description: "Fetch a single service offering by ID, including its provider.",
+      inputSchema: { id: z.string().describe("Service offering ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_SERVICE_OFFERING, { id });
+        if (!data.serviceOffering) return errorResult(`Service offering ${id} not found`);
+        return jsonResult(data.serviceOffering);
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_get_offering failed", { error: String(error) });
+        return errorResult(
+          `Failed to get service offering: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_list_offerings")),
+    {
+      title: "List Service Offerings",
+      description: "List service offerings with optional provider/category/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across name/description"),
+        providerId: z.string().optional().describe("Filter by provider ID"),
+        category: z.string().optional().describe("Filter by category"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, providerId, category, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (providerId !== void 0) filter.providerId = providerId;
+        if (category !== void 0) filter.category = category;
+        const data = await ctx.gql.workspace.request(LIST_SERVICE_OFFERINGS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.serviceOfferings);
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_list_offerings failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to list service offerings: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_create_offering")),
+    {
+      title: "Create Service Offering",
+      description: 'Create a service offering for a provider. `name`, `price`, and `providerId` are required; `currency` defaults to "USD".',
+      inputSchema: {
+        name: z.string().min(1).describe("Offering name"),
+        price: z.number().describe("Price"),
+        providerId: z.string().min(1).describe("Owning provider ID"),
+        category: z.string().optional().describe("Category"),
+        description: z.string().optional().describe("Description"),
+        currency: z.string().optional().describe('Currency (default "USD")'),
+        availability: JsonObject.optional().describe("Availability JSON")
+      }
+    },
+    async ({ name, price, providerId, category, description, currency, availability }) => {
+      try {
+        const input = { name, price, providerId };
+        if (category !== void 0) input.category = category;
+        if (description !== void 0) input.description = description;
+        if (currency !== void 0) input.currency = currency;
+        if (availability !== void 0) input.availability = availability;
+        const data = await ctx.gql.workspace.request(CREATE_SERVICE_OFFERING, { input });
+        return jsonResult(data.createServiceOffering);
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_create_offering failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to create service offering: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_update_offering")),
+    {
+      title: "Update Service Offering",
+      description: "Update a service offering. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Service offering ID"),
+        name: z.string().optional().describe("Updated name"),
+        price: z.number().optional().describe("Updated price"),
+        providerId: z.string().optional().describe("Updated provider ID"),
+        category: z.string().optional().describe("Updated category"),
+        description: z.string().optional().describe("Updated description"),
+        currency: z.string().optional().describe("Updated currency"),
+        availability: JsonObject.optional().describe("Updated availability JSON")
+      }
+    },
+    async ({ id, name, price, providerId, category, description, currency, availability }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (price !== void 0) input.price = price;
+        if (providerId !== void 0) input.providerId = providerId;
+        if (category !== void 0) input.category = category;
+        if (description !== void 0) input.description = description;
+        if (currency !== void 0) input.currency = currency;
+        if (availability !== void 0) input.availability = availability;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_SERVICE_OFFERING, { id, input });
+        return jsonResult(data.updateServiceOffering);
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_update_offering failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to update service offering: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_delete_offering")),
+    {
+      title: "Delete Service Offering",
+      description: "Soft-delete a service offering by ID.",
+      inputSchema: { id: z.string().describe("Service offering ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_SERVICE_OFFERING,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteServiceOffering, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels marketplace_delete_offering failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to delete service offering: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerReportTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "reports_get")),
+    {
+      title: "Get Report",
+      description: "Fetch a single report definition by ID.",
+      inputSchema: { id: z.string().describe("Report ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_REPORT, { id });
+        if (!data.movethewheelsReport) return errorResult(`Report ${id} not found`);
+        return jsonResult(data.movethewheelsReport);
+      } catch (error) {
+        ctx.logger.error("movethewheels reports_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get report: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "reports_list")),
+    {
+      title: "List Reports",
+      description: "List report definitions with optional type/status/text filters and pagination.",
+      inputSchema: {
+        search: z.string().optional().describe("Free-text search across name"),
+        type: z.string().optional().describe("Filter by report type"),
+        status: z.string().optional().describe('Filter by status, e.g. "DRAFT", "ACTIVE"'),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ search, type, status, limit, offset }) => {
+      try {
+        const filter = {};
+        if (search !== void 0) filter.search = search;
+        if (type !== void 0) filter.type = type;
+        if (status !== void 0) filter.status = status;
+        const data = await ctx.gql.workspace.request(LIST_REPORTS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.movethewheelsReports);
+      } catch (error) {
+        ctx.logger.error("movethewheels reports_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list reports: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "reports_create")),
+    {
+      title: "Create Report",
+      description: 'Create a report definition. `name` and `type` are required; `status` defaults to "DRAFT".',
+      inputSchema: {
+        name: z.string().min(1).describe("Report name"),
+        type: z.string().min(1).describe("Report type"),
+        status: z.string().optional().describe('Status (default "DRAFT")'),
+        description: z.string().optional().describe("Description"),
+        configuration: JsonObject.optional().describe("Report configuration JSON"),
+        schedule: z.string().optional().describe("Schedule (e.g. cron string)")
+      }
+    },
+    async ({ name, type, status, description, configuration, schedule }) => {
+      try {
+        const input = { name, type };
+        if (status !== void 0) input.status = status;
+        if (description !== void 0) input.description = description;
+        if (configuration !== void 0) input.configuration = configuration;
+        if (schedule !== void 0) input.schedule = schedule;
+        const data = await ctx.gql.workspace.request(CREATE_REPORT, { input });
+        return jsonResult(data.createMovethewheelsReport);
+      } catch (error) {
+        ctx.logger.error("movethewheels reports_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create report: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "reports_update")),
+    {
+      title: "Update Report",
+      description: "Update a report definition. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Report ID"),
+        name: z.string().optional().describe("Updated name"),
+        type: z.string().optional().describe("Updated type"),
+        status: z.string().optional().describe("Updated status"),
+        description: z.string().optional().describe("Updated description"),
+        configuration: JsonObject.optional().describe("Updated configuration JSON"),
+        schedule: z.string().optional().describe("Updated schedule")
+      }
+    },
+    async ({ id, name, type, status, description, configuration, schedule }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (type !== void 0) input.type = type;
+        if (status !== void 0) input.status = status;
+        if (description !== void 0) input.description = description;
+        if (configuration !== void 0) input.configuration = configuration;
+        if (schedule !== void 0) input.schedule = schedule;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable field.");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_REPORT, { id, input });
+        return jsonResult(data.updateMovethewheelsReport);
+      } catch (error) {
+        ctx.logger.error("movethewheels reports_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update report: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "reports_generate")),
+    {
+      title: "Generate Report",
+      description: "Run a report definition and return the generated result payload.",
+      inputSchema: {
+        reportId: z.string().describe("Report ID to generate"),
+        parameters: JsonObject.optional().describe("Runtime parameters JSON")
+      }
+    },
+    async ({ reportId, parameters }) => {
+      try {
+        const input = { reportId };
+        if (parameters !== void 0) input.parameters = parameters;
+        const data = await ctx.gql.workspace.request(GENERATE_REPORT, { input });
+        return jsonResult(data.generateMovethewheelsReport);
+      } catch (error) {
+        ctx.logger.error("movethewheels reports_generate failed", { error: String(error) });
+        return errorResult(
+          `Failed to generate report: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "reports_delete")),
+    {
+      title: "Delete Report",
+      description: "Soft-delete a report definition by ID.",
+      inputSchema: { id: z.string().describe("Report ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_REPORT,
+          { id }
+        );
+        return jsonResult({ deleted: data.deleteMovethewheelsReport, id });
+      } catch (error) {
+        ctx.logger.error("movethewheels reports_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete report: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "settings_get")),
+    {
+      title: "Get Module Settings",
+      description: "Fetch the Movethewheels module settings (preferences) for the bound workspace.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_MODULE_SETTINGS, {});
+        return jsonResult(data.moduleSettings);
+      } catch (error) {
+        ctx.logger.error("movethewheels settings_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get module settings: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "settings_update")),
+    {
+      title: "Update Module Settings",
+      description: "Replace the Movethewheels module preferences JSON for the bound workspace.",
+      inputSchema: {
+        preferences: JsonObject.describe("Module preferences JSON (full replacement)")
+      }
+    },
+    async ({ preferences }) => {
+      try {
+        const data = await ctx.gql.workspace.request(UPDATE_MODULE_SETTINGS, { input: { preferences } });
+        return jsonResult(data.updateModuleSettings);
+      } catch (error) {
+        ctx.logger.error("movethewheels settings_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update module settings: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "data_export")),
+    {
+      title: "Export Data",
+      description: 'Export a Movethewheels resource (e.g. "orders", "shipments", "inventory") as a payload. `format` defaults to "json".',
+      inputSchema: {
+        resource: z.string().min(1).describe('Resource to export, e.g. "orders"'),
+        format: z.string().optional().describe('Export format (default "json")')
+      }
+    },
+    async ({ resource, format }) => {
+      try {
+        const input = { resource };
+        if (format !== void 0) input.format = format;
+        const data = await ctx.gql.workspace.request(EXPORT_DATA, { input });
+        return jsonResult(data.exportData);
+      } catch (error) {
+        ctx.logger.error("movethewheels data_export failed", { error: String(error) });
+        return errorResult(
+          `Failed to export data: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "data_import")),
+    {
+      title: "Import Data",
+      description: 'Import a payload into a Movethewheels resource (e.g. "orders", "customers"). `resource` and `payload` are required.',
+      inputSchema: {
+        resource: z.string().min(1).describe('Resource to import into, e.g. "customers"'),
+        payload: JsonObject.describe("Payload JSON to import")
+      }
+    },
+    async ({ resource, payload }) => {
+      try {
+        const data = await ctx.gql.workspace.request(IMPORT_DATA, { input: { resource, payload } });
+        return jsonResult(data.importData);
+      } catch (error) {
+        ctx.logger.error("movethewheels data_import failed", { error: String(error) });
+        return errorResult(
+          `Failed to import data: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerAnalyticsTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "analytics_series")),
+    {
+      title: "Analytics Time Series",
+      description: "Time-series trends for orders, deliveries, and revenue.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_ANALYTICS, {});
+        return jsonResult(data.analytics);
+      } catch (error) {
+        ctx.logger.error("movethewheels analytics_series failed", { error: String(error) });
+        return errorResult(
+          `Failed to get analytics: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "analytics_dashboard")),
+    {
+      title: "Dashboard Metrics",
+      description: "Headline operations KPIs: total orders, active deliveries, active vehicles, available drivers, low-stock items, total revenue, and recent orders.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_DASHBOARD_METRICS, {});
+        return jsonResult(data.dashboardMetrics);
+      } catch (error) {
+        ctx.logger.error("movethewheels analytics_dashboard failed", { error: String(error) });
+        return errorResult(
+          `Failed to get dashboard metrics: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "analytics_order_stats")),
+    {
+      title: "Order Stats",
+      description: "Order counts by lifecycle bucket: total, pending, in-transit, delivered, cancelled, failed.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_ORDER_STATS, {});
+        return jsonResult(data.orderStats);
+      } catch (error) {
+        ctx.logger.error("movethewheels analytics_order_stats failed", { error: String(error) });
+        return errorResult(
+          `Failed to get order stats: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "analytics_fleet")),
+    {
+      title: "Fleet Stats",
+      description: "Fleet KPIs: total/active/in-transit/maintenance vehicles and total/available/on-delivery drivers.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_FLEET_STATS, {});
+        return jsonResult(data.fleetStats);
+      } catch (error) {
+        ctx.logger.error("movethewheels analytics_fleet failed", { error: String(error) });
+        return errorResult(
+          `Failed to get fleet stats: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "analytics_finance")),
+    {
+      title: "Finance Metrics",
+      description: "Finance KPIs: revenue breakdown, fuel cost, and open invoice count.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_FINANCE_METRICS, {});
+        return jsonResult(data.financeMetrics);
+      } catch (error) {
+        ctx.logger.error("movethewheels analytics_finance failed", { error: String(error) });
+        return errorResult(
+          `Failed to get finance metrics: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "analytics_insights")),
+    {
+      title: "Assistant Insights",
+      description: "Ask the Movethewheels operations assistant a natural-language question and get a generated insight answer.",
+      inputSchema: {
+        question: z.string().min(1).describe("Natural-language operations question")
+      }
+    },
+    async ({ question }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_ASSISTANT_INSIGHTS, { question });
+        return jsonResult(data.assistantInsights);
+      } catch (error) {
+        ctx.logger.error("movethewheels analytics_insights failed", {
+          error: String(error)
+        });
+        return errorResult(
+          `Failed to get assistant insights: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/movethewheels/resources.ts
+function registerMovethewheelsResources(server, ctx, track) {
+  const schemaUri = track(mcpResourceUri(ctx.productName, "schema"));
+  const dashboardUri = track(mcpResourceUri(ctx.productName, "dashboard"));
+  const fleetUri = track(mcpResourceUri(ctx.productName, "fleet"));
+  const activeUri = track(mcpResourceUri(ctx.productName, "active-deliveries"));
+  server.registerResource(
+    "movethewheels-schema",
+    schemaUri,
+    {
+      title: "Movethewheels Domain Schema",
+      description: "Overview of the Movethewheels logistics domain \u2014 entities, enums, and the per-group tool surface.",
+      mimeType: "text/plain"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${schemaUri} requested`);
+      const schema = `# Movethewheels Domain (Overview)
+
+Logistics / fleet / warehouse / last-mile-delivery operations platform.
+
+## Entities
+- Customer \u2014 shipper/consignee (B2B/B2C)
+- Driver \u2014 fleet driver (status, license, telemetry)
+- Vehicle \u2014 fleet vehicle (type, status, capacity, location)
+- Product \u2014 cargo SKU master (weight, dimensions, hazardous/fragile/temp)
+- MovethewheelsOrder (+OrderStatusHistory) \u2014 delivery order + status timeline
+- Shipment (+TrackingEvent) \u2014 freight shipment + tracking timeline
+- Route \u2014 planned/optimized delivery route
+- Warehouse (+WarehouseLocation) \u2014 facilities + storage locations
+- InventoryItem (+InventoryTransaction) \u2014 stock at a warehouse + ledger
+- ServiceProvider (+ServiceOffering) \u2014 3PL marketplace providers + offerings
+- MovethewheelsReport \u2014 report definitions
+
+## Enums
+- DriverStatus: AVAILABLE, INACTIVE, OFF_DUTY, ON_BREAK, ON_DELIVERY
+- VehicleStatus: ACTIVE, DECOMMISSIONED, INACTIVE, IN_TRANSIT, MAINTENANCE
+- VehicleType: BICYCLE, DRONE, FLATBED, MOTORCYCLE, REFRIGERATED, SEMI_TRAILER, TRUCK, VAN
+- OrderType: B2B, B2C, MARKETPLACE, SUBSCRIPTION
+- OrderPriority: CRITICAL, HIGH, LOW, MEDIUM, URGENT
+- OrderStatus: PENDING, CONFIRMED, ASSIGNED, PICKED_UP, IN_TRANSIT, OUT_FOR_DELIVERY, DELIVERED, CANCELLED, FAILED, RETURNED
+- ShipmentStatus: PLANNED, PICKED_UP, IN_TRANSIT, DELIVERED, FAILED, RETURNED
+- TrackingEventType: CREATED, PICKED_UP, DEPARTED, ARRIVED, IN_TRANSIT, OUT_FOR_DELIVERY, DELIVERED, FAILED, RETURNED
+- RouteStatus: PLANNED, IN_PROGRESS, COMPLETED, CANCELLED
+- WarehouseType: COLD_STORAGE, CROSS_DOCK, DISTRIBUTION, FULFILLMENT, RETAIL
+- InventoryTransactionType: RECEIPT, ISSUE, TRANSFER, ADJUSTMENT, RETURN
+
+## Tool groups
+customers, drivers, vehicles, products, orders, shipments, tracking, routes,
+warehouses, inventory, marketplace (service providers + offerings), reports
+(+ settings + import/export), analytics.
+All run against the WORKSPACE gateway (workspace-scoped). The subgraph has no
+@public health field, so there is no health tool.
+`;
+      return {
+        contents: [{ uri: schemaUri, text: schema, mimeType: "text/plain" }]
+      };
+    }
+  );
+  server.registerResource(
+    "movethewheels-dashboard",
+    dashboardUri,
+    {
+      title: "Movethewheels Dashboard Metrics",
+      description: "Live headline operations KPIs (orders, active deliveries, vehicles, drivers, low-stock, revenue).",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${dashboardUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(
+          GET_DASHBOARD_METRICS,
+          {}
+        );
+        return {
+          contents: [
+            {
+              uri: dashboardUri,
+              text: JSON.stringify(data.dashboardMetrics, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: dashboardUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+  server.registerResource(
+    "movethewheels-fleet",
+    fleetUri,
+    {
+      title: "Movethewheels Fleet Stats",
+      description: "Fleet KPIs: vehicle and driver counts by status.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${fleetUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(GET_FLEET_STATS, {});
+        return {
+          contents: [
+            {
+              uri: fleetUri,
+              text: JSON.stringify(data.fleetStats, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: fleetUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+  server.registerResource(
+    "movethewheels-active-deliveries",
+    activeUri,
+    {
+      title: "Movethewheels Active Deliveries",
+      description: "The first 50 shipments currently in active delivery in the bound workspace.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${activeUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(
+          LIST_ACTIVE_DELIVERIES,
+          { pagination: { limit: 50, offset: 0 } }
+        );
+        return {
+          contents: [
+            {
+              uri: activeUri,
+              text: JSON.stringify(data.activeDeliveries, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: activeUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+function registerMovethewheelsPrompts(server, ctx, track) {
+  const p = ctx.productName;
+  const fulfilmentName = track(mcpPromptName(p, "delivery-fulfilment"));
+  const fleetName = track(mcpPromptName(p, "fleet-ops"));
+  server.registerPrompt(
+    fulfilmentName,
+    {
+      title: "Delivery Fulfilment",
+      description: "Guide for fulfilling a delivery order end to end: create the order, create a shipment, assign a driver/vehicle, and advance it through tracking to delivery.",
+      argsSchema: {
+        customerId: z.string().optional().describe("Customer placing the order"),
+        orderId: z.string().optional().describe("Existing order ID to fulfil")
+      }
+    },
+    ({ customerId, orderId }) => {
+      ctx.logger.debug(`Prompt ${fulfilmentName} called`, { customerId, orderId });
+      const orderNote = orderId ? `Operate the existing order "${orderId}".` : customerId ? `Create a new order for customer "${customerId}".` : `First pick a customer with ${p}_customers_list (or create one with ${p}_customers_create).`;
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Help me fulfil a Movethewheels delivery order. ${orderNote}
+
+1. **Order**: If needed, use ${p}_orders_create with a unique orderNumber, pickupAddress, deliveryAddress, and items.
+2. **Assign Capacity**: Use ${p}_drivers_list (status=AVAILABLE) and ${p}_vehicles_list (status=ACTIVE), then ${p}_drivers_assign_vehicle and ${p}_orders_update to attach driverId/vehicleId.
+3. **Shipment**: Use ${p}_shipments_create with the orderId, a unique shipmentNumber, origin, and destination.
+4. **Track**: As the shipment moves, use ${p}_tracking_add_event (PICKED_UP \u2192 IN_TRANSIT \u2192 OUT_FOR_DELIVERY \u2192 DELIVERED) and mirror order state with ${p}_orders_update_status.
+5. **Verify**: Use ${p}_tracking_order_events to confirm the timeline and ${p}_orders_get for the final state.
+
+Show results at each step and confirm before marking DELIVERED.`
+            }
+          }
+        ]
+      };
+    }
+  );
+  server.registerPrompt(
+    fleetName,
+    {
+      title: "Fleet & Warehouse Operations",
+      description: "Daily operations workflow: review KPIs, triage the order queue and tracking alerts, balance fleet status, and watch low inventory.",
+      argsSchema: {}
+    },
+    () => {
+      ctx.logger.debug(`Prompt ${fleetName} called`);
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Run daily Movethewheels operations.
+
+1. **KPIs**: Use ${p}_analytics_dashboard for headline numbers, ${p}_analytics_order_stats and ${p}_analytics_fleet for status breakdowns, and ${p}_analytics_finance for revenue/fuel/invoices.
+2. **Order Queue**: Use ${p}_orders_list filtered by status=PENDING (and CONFIRMED) to find orders needing assignment; advance them with ${p}_orders_update_status.
+3. **Tracking Alerts**: Use ${p}_tracking_alerts to find delayed/exception shipments and ${p}_shipments_get to investigate.
+4. **Fleet Balance**: Use ${p}_vehicles_list and ${p}_drivers_list to spot MAINTENANCE/OFF_DUTY capacity; update with ${p}_vehicles_update_status / ${p}_drivers_update_status.
+5. **Inventory**: Use ${p}_inventory_stats and ${p}_inventory_list_items to find low-stock items; record movements with ${p}_inventory_create_transaction.
+
+Summarize what needs attention after each step.`
+            }
+          }
+        ]
+      };
+    }
+  );
+}
+
+// src/modules/movethewheels/index.ts
+var movethewheelsModule = {
+  id: "movethewheels",
+  version: "0.0.1",
+  displayName: "Movethewheels",
+  dependsOn: ["auth"],
+  capabilities: { tools: {}, resources: {}, prompts: {} },
+  register(server, ctx) {
+    const tools = [];
+    const resources = [];
+    const prompts = [];
+    const trackTool = (n) => {
+      tools.push(n);
+      return n;
+    };
+    const trackResource = (uri) => {
+      resources.push(uri);
+      return uri;
+    };
+    const trackPrompt = (n) => {
+      prompts.push(n);
+      return n;
+    };
+    registerCustomerTools(server, ctx, trackTool);
+    registerDriverTools(server, ctx, trackTool);
+    registerVehicleTools(server, ctx, trackTool);
+    registerProductTools(server, ctx, trackTool);
+    registerOrderTools(server, ctx, trackTool);
+    registerShipmentTools(server, ctx, trackTool);
+    registerTrackingTools(server, ctx, trackTool);
+    registerRouteTools(server, ctx, trackTool);
+    registerWarehouseTools(server, ctx, trackTool);
+    registerInventoryTools(server, ctx, trackTool);
+    registerMarketplaceTools(server, ctx, trackTool);
+    registerReportTools(server, ctx, trackTool);
+    registerAnalyticsTools(server, ctx, trackTool);
+    registerMovethewheelsResources(server, ctx, trackResource);
+    registerMovethewheelsPrompts(server, ctx, trackPrompt);
+    return { tools, resources, prompts };
+  }
+};
+var movethewheels_default = movethewheelsModule;
+
+export { movethewheels_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map