brinkcommerce-dev-mcp 0.1.0-beta.1

package/dist/tools/order-extended-tools.js

@@ -0,0 +1,1812 @@
+import { createOrderManagementClient } from "../api-client.js";
+import { logger } from "../logger.js";
+// ==================== TOOL ANNOTATIONS ====================
+// Annotations for read-only tools (GET operations)
+const readOnlyAnnotations = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true, // Interacts with external BrinkCommerce APIs
+};
+// Annotations for write tools (POST, PUT, PATCH operations)
+const writeAnnotations = {
+    readOnlyHint: false,
+    destructiveHint: false, // Creates or updates, not destructive
+    openWorldHint: true,
+    idempotentHint: true, // PUT/PATCH are idempotent
+};
+// Annotations for destructive tools (DELETE operations)
+const destructiveAnnotations = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    openWorldHint: true,
+};
+// ==================== TOOL DEFINITIONS ====================
+/**
+ * Order Query Tool Definitions
+ */
+export const orderQueryTools = {
+    get_orders_by_email: {
+        name: "get_orders_by_email",
+        description: "Search for orders by customer's billing email address. Returns up to 100 order summaries. Useful for looking up orders for a specific customer.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                email: {
+                    type: "string",
+                    description: "The email address to search for",
+                },
+                from: {
+                    type: "string",
+                    description: "Optional: Start date filter (RFC3339 format, e.g., '2024-01-01T00:00:00Z')",
+                },
+                to: {
+                    type: "string",
+                    description: "Optional: End date filter (RFC3339 format, e.g., '2024-12-31T23:59:59Z')",
+                },
+            },
+            required: ["email"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    get_orders_by_merchant_ref: {
+        name: "get_orders_by_merchant_ref",
+        description: "Search for orders by merchant reference 1. Returns up to 100 order summaries. Useful for finding orders based on external system references.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                merchantRef1: {
+                    type: "string",
+                    description: "The merchant reference to search for",
+                },
+                from: {
+                    type: "string",
+                    description: "Optional: Start date filter (RFC3339 format)",
+                },
+                to: {
+                    type: "string",
+                    description: "Optional: End date filter (RFC3339 format)",
+                },
+            },
+            required: ["merchantRef1"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    get_order_history: {
+        name: "get_order_history",
+        description: "Get the complete history of operations performed on an order. Shows all status changes and actions taken.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+            },
+            required: ["orderId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    get_order_reservation: {
+        name: "get_order_reservation",
+        description: "Get information about the stock that was reserved when the order was placed. Shows which inventory locations and quantities were reserved.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+            },
+            required: ["orderId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    delete_order: {
+        name: "delete_order",
+        description: "Delete an order from BrinkCommerce. Can only delete orders older than 30 days. " +
+            "WHY CONFIRMATION MATTERS: Permanently removes order data which cannot be recovered.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID to delete (UUID format)",
+                },
+            },
+            required: ["orderId"],
+        },
+        annotations: destructiveAnnotations,
+    },
+};
+/**
+ * Order Collection Tool Definitions
+ */
+export const orderCollectionTools = {
+    list_order_deliveries: {
+        name: "list_order_deliveries",
+        description: "Get all deliveries for an order. Shows fulfillment status and tracking information.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+            },
+            required: ["orderId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    list_order_cancellations: {
+        name: "list_order_cancellations",
+        description: "Get all cancellations for an order. Shows cancellation status and reasons.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+            },
+            required: ["orderId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    list_order_refunds: {
+        name: "list_order_refunds",
+        description: "Get all refunds for an order. Shows refund status and amounts.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+            },
+            required: ["orderId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    list_order_releases: {
+        name: "list_order_releases",
+        description: "Get all releases for an order. Shows inventory release status.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+            },
+            required: ["orderId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    list_order_compensations: {
+        name: "list_order_compensations",
+        description: "Get all compensations for an order. Compensations are partial refunds without returning goods.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+            },
+            required: ["orderId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    list_order_modifications: {
+        name: "list_order_modifications",
+        description: "Get all modifications for an order. Shows order line changes, shipping fee changes, and address changes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+            },
+            required: ["orderId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+};
+/**
+ * Compensation Tool Definitions
+ */
+export const compensationTools = {
+    create_compensation: {
+        name: "create_compensation",
+        description: "Create a compensation for an order. Compensations are partial refunds to the customer without requiring goods to be returned. " +
+            "Can only be created after deliveries exist and before any refunds.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID to create compensation for (UUID format)",
+                },
+                request: {
+                    type: "object",
+                    description: "Compensation request data including amount and reason",
+                },
+            },
+            required: ["orderId", "request"],
+        },
+        annotations: writeAnnotations,
+    },
+    get_compensation: {
+        name: "get_compensation",
+        description: "Get details of a specific compensation by ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compensationId: {
+                    type: "string",
+                    description: "The compensation ID (UUID format)",
+                },
+            },
+            required: ["compensationId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    update_compensation: {
+        name: "update_compensation",
+        description: "Update a compensation before it has been started. Cannot update once started.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compensationId: {
+                    type: "string",
+                    description: "The compensation ID (UUID format)",
+                },
+                request: {
+                    type: "object",
+                    description: "Updated compensation request data",
+                },
+            },
+            required: ["compensationId", "request"],
+        },
+        annotations: writeAnnotations,
+    },
+    delete_compensation: {
+        name: "delete_compensation",
+        description: "Delete a compensation before it has been started. Cannot delete once started.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compensationId: {
+                    type: "string",
+                    description: "The compensation ID (UUID format)",
+                },
+            },
+            required: ["compensationId"],
+        },
+        annotations: destructiveAnnotations,
+    },
+    start_compensation: {
+        name: "start_compensation",
+        description: "Start processing a compensation. Triggers the payment provider to issue the refund.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compensationId: {
+                    type: "string",
+                    description: "The compensation ID (UUID format)",
+                },
+            },
+            required: ["compensationId"],
+        },
+        annotations: writeAnnotations,
+    },
+    restart_compensation: {
+        name: "restart_compensation",
+        description: "Restart a failed compensation. Only failed compensations can be restarted.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                compensationId: {
+                    type: "string",
+                    description: "The compensation ID (UUID format)",
+                },
+            },
+            required: ["compensationId"],
+        },
+        annotations: writeAnnotations,
+    },
+};
+/**
+ * Order Lines Modification Tool Definitions
+ */
+export const orderLinesModificationTools = {
+    create_order_lines_modification: {
+        name: "create_order_lines_modification",
+        description: "Create a modification to order lines. Allows adding, updating, or removing order lines before delivery. Max 4 modifications per order.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+                request: {
+                    type: "object",
+                    description: "Order lines modification request data",
+                },
+            },
+            required: ["orderId", "request"],
+        },
+        annotations: writeAnnotations,
+    },
+    get_order_lines_modification: {
+        name: "get_order_lines_modification",
+        description: "Get details of a specific order lines modification.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    update_order_lines_modification: {
+        name: "update_order_lines_modification",
+        description: "Update an order lines modification before it has been started.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+                request: {
+                    type: "object",
+                    description: "Updated order lines modification request data",
+                },
+            },
+            required: ["modificationId", "request"],
+        },
+        annotations: writeAnnotations,
+    },
+    delete_order_lines_modification: {
+        name: "delete_order_lines_modification",
+        description: "Delete an order lines modification before it has been started.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: destructiveAnnotations,
+    },
+    start_order_lines_modification: {
+        name: "start_order_lines_modification",
+        description: "Start processing an order lines modification.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: writeAnnotations,
+    },
+    restart_order_lines_modification: {
+        name: "restart_order_lines_modification",
+        description: "Restart a failed order lines modification.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: writeAnnotations,
+    },
+};
+/**
+ * Shipping Fees Modification Tool Definitions
+ */
+export const shippingFeesModificationTools = {
+    create_shipping_fees_modification: {
+        name: "create_shipping_fees_modification",
+        description: "Create a modification to shipping fees. Allows updating shipping fee amounts before delivery. Max 4 modifications per order.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+                request: {
+                    type: "object",
+                    description: "Shipping fees modification request data",
+                },
+            },
+            required: ["orderId", "request"],
+        },
+        annotations: writeAnnotations,
+    },
+    get_shipping_fees_modification: {
+        name: "get_shipping_fees_modification",
+        description: "Get details of a specific shipping fees modification.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    update_shipping_fees_modification: {
+        name: "update_shipping_fees_modification",
+        description: "Update a shipping fees modification before it has been started.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+                request: {
+                    type: "object",
+                    description: "Updated shipping fees modification request data",
+                },
+            },
+            required: ["modificationId", "request"],
+        },
+        annotations: writeAnnotations,
+    },
+    delete_shipping_fees_modification: {
+        name: "delete_shipping_fees_modification",
+        description: "Delete a shipping fees modification before it has been started.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: destructiveAnnotations,
+    },
+    start_shipping_fees_modification: {
+        name: "start_shipping_fees_modification",
+        description: "Start processing a shipping fees modification.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: writeAnnotations,
+    },
+    restart_shipping_fees_modification: {
+        name: "restart_shipping_fees_modification",
+        description: "Restart a failed shipping fees modification.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: writeAnnotations,
+    },
+};
+/**
+ * Addresses Modification Tool Definitions
+ */
+export const addressesModificationTools = {
+    create_addresses_modification: {
+        name: "create_addresses_modification",
+        description: "Create a modification to order addresses. Allows updating billing and/or shipping address before delivery. Max 4 modifications per order.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+                request: {
+                    type: "object",
+                    description: "Addresses modification request data with billing and/or shipping address",
+                },
+            },
+            required: ["orderId", "request"],
+        },
+        annotations: writeAnnotations,
+    },
+    get_addresses_modification: {
+        name: "get_addresses_modification",
+        description: "Get details of a specific addresses modification.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    update_addresses_modification: {
+        name: "update_addresses_modification",
+        description: "Update an addresses modification before it has been started.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+                request: {
+                    type: "object",
+                    description: "Updated addresses modification request data",
+                },
+            },
+            required: ["modificationId", "request"],
+        },
+        annotations: writeAnnotations,
+    },
+    delete_addresses_modification: {
+        name: "delete_addresses_modification",
+        description: "Delete an addresses modification before it has been started.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: destructiveAnnotations,
+    },
+    start_addresses_modification: {
+        name: "start_addresses_modification",
+        description: "Start processing an addresses modification.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                modificationId: {
+                    type: "string",
+                    description: "The modification ID (UUID format)",
+                },
+            },
+            required: ["modificationId"],
+        },
+        annotations: writeAnnotations,
+    },
+};
+/**
+ * Custom State Tool Definitions
+ */
+export const customStateTools = {
+    list_custom_states: {
+        name: "list_custom_states",
+        description: "List all custom states defined in the system. Custom states can control order operations.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    get_custom_state: {
+        name: "get_custom_state",
+        description: "Get details of a specific custom state.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                stateId: {
+                    type: "string",
+                    description: "The custom state ID",
+                },
+            },
+            required: ["stateId"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    create_custom_state: {
+        name: "create_custom_state",
+        description: "Create a new custom state. Custom states can block certain order operations when attached to an order.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                stateId: {
+                    type: "string",
+                    description: "The custom state ID (unique identifier)",
+                },
+                name: {
+                    type: "string",
+                    description: "Display name for the custom state",
+                },
+                description: {
+                    type: "string",
+                    description: "Description of the custom state",
+                },
+                blocksDelivery: {
+                    type: "boolean",
+                    description: "Whether this state blocks delivery operations",
+                },
+                blocksRefund: {
+                    type: "boolean",
+                    description: "Whether this state blocks refund operations",
+                },
+                blocksRelease: {
+                    type: "boolean",
+                    description: "Whether this state blocks release operations",
+                },
+                blocksCompensation: {
+                    type: "boolean",
+                    description: "Whether this state blocks compensation operations",
+                },
+                blocksCancellation: {
+                    type: "boolean",
+                    description: "Whether this state blocks cancellation operations",
+                },
+            },
+            required: ["stateId", "name"],
+        },
+        annotations: writeAnnotations,
+    },
+    delete_custom_state: {
+        name: "delete_custom_state",
+        description: "Delete a custom state. Soft delete - doesn't affect orders already using this state.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                stateId: {
+                    type: "string",
+                    description: "The custom state ID",
+                },
+            },
+            required: ["stateId"],
+        },
+        annotations: destructiveAnnotations,
+    },
+    add_order_custom_state: {
+        name: "add_order_custom_state",
+        description: "Add a custom state to an order. This may block certain operations on the order.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+                stateId: {
+                    type: "string",
+                    description: "The custom state ID to add",
+                },
+            },
+            required: ["orderId", "stateId"],
+        },
+        annotations: writeAnnotations,
+    },
+    remove_order_custom_state: {
+        name: "remove_order_custom_state",
+        description: "Remove a custom state from an order.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+                stateId: {
+                    type: "string",
+                    description: "The custom state ID to remove",
+                },
+            },
+            required: ["orderId", "stateId"],
+        },
+        annotations: destructiveAnnotations,
+    },
+};
+/**
+ * Custom Reason Code Tool Definitions
+ */
+export const customReasonCodeTools = {
+    list_custom_reason_codes: {
+        name: "list_custom_reason_codes",
+        description: "List all custom reason codes. These codes can be used when creating operations like cancellations or refunds.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    get_custom_reason_code: {
+        name: "get_custom_reason_code",
+        description: "Get details of a specific custom reason code.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                code: {
+                    type: "string",
+                    description: "The custom reason code",
+                },
+            },
+            required: ["code"],
+        },
+        annotations: readOnlyAnnotations,
+    },
+    create_custom_reason_code: {
+        name: "create_custom_reason_code",
+        description: "Create a new custom reason code for use in operations.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                code: {
+                    type: "string",
+                    description: "The reason code (unique identifier)",
+                },
+                name: {
+                    type: "string",
+                    description: "Display name for the reason code",
+                },
+                description: {
+                    type: "string",
+                    description: "Description of when to use this reason code",
+                },
+            },
+            required: ["code", "name"],
+        },
+        annotations: writeAnnotations,
+    },
+    delete_custom_reason_code: {
+        name: "delete_custom_reason_code",
+        description: "Delete a custom reason code.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                code: {
+                    type: "string",
+                    description: "The custom reason code",
+                },
+            },
+            required: ["code"],
+        },
+        annotations: destructiveAnnotations,
+    },
+};
+/**
+ * Comment Tool Definitions
+ */
+export const commentTools = {
+    create_order_comment: {
+        name: "create_order_comment",
+        description: "Add a comment to an order for internal notes or tracking purposes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+                text: {
+                    type: "string",
+                    description: "The comment text",
+                },
+            },
+            required: ["orderId", "text"],
+        },
+        annotations: writeAnnotations,
+    },
+    update_order_comment: {
+        name: "update_order_comment",
+        description: "Update an existing comment on an order.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+                commentId: {
+                    type: "string",
+                    description: "The comment ID (UUID format)",
+                },
+                text: {
+                    type: "string",
+                    description: "The updated comment text",
+                },
+            },
+            required: ["orderId", "commentId", "text"],
+        },
+        annotations: writeAnnotations,
+    },
+    delete_order_comment: {
+        name: "delete_order_comment",
+        description: "Delete a comment from an order.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                orderId: {
+                    type: "string",
+                    description: "The order ID (UUID format)",
+                },
+                commentId: {
+                    type: "string",
+                    description: "The comment ID (UUID format)",
+                },
+            },
+            required: ["orderId", "commentId"],
+        },
+        annotations: destructiveAnnotations,
+    },
+};
+// ==================== HANDLERS ====================
+/**
+ * Generic error response helper
+ */
+function createErrorResponse(error, context) {
+    logger.error(`Error in ${context}`, { error });
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Unexpected error: ${error instanceof Error ? error.message : "Unknown error"}`,
+            },
+        ],
+        isError: true,
+    };
+}
+/**
+ * Generic API error response helper
+ */
+function createApiErrorResponse(result, context) {
+    let errorText = `Failed to ${context}: ${result.error?.message}\n\nStatus: ${result.error?.status}`;
+    if (result.error?.details) {
+        errorText += `\n\nDetails: ${JSON.stringify(result.error.details, null, 2)}`;
+    }
+    return {
+        content: [{ type: "text", text: errorText }],
+        isError: true,
+    };
+}
+// ==================== ORDER QUERY HANDLERS ====================
+export async function handleGetOrdersByEmail(params) {
+    try {
+        logger.info("Handling get_orders_by_email tool call", { email: params.email });
+        if (!params.email) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'email'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const from = params.from ? new Date(params.from) : undefined;
+        const to = params.to ? new Date(params.to) : undefined;
+        const result = await client.getOrdersByEmail(params.email, from, to);
+        if (result.success && result.data) {
+            const count = result.data.orderSummaries?.length ?? 0;
+            return {
+                content: [{
+                        type: "text",
+                        text: `Found ${count} order(s) for email: ${params.email}\n\n${JSON.stringify(result.data, null, 2)}`,
+                    }],
+            };
+        }
+        return createApiErrorResponse(result, "get orders by email");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetOrdersByEmail");
+    }
+}
+export async function handleGetOrdersByMerchantRef(params) {
+    try {
+        logger.info("Handling get_orders_by_merchant_ref tool call", { merchantRef1: params.merchantRef1 });
+        if (!params.merchantRef1) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'merchantRef1'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const from = params.from ? new Date(params.from) : undefined;
+        const to = params.to ? new Date(params.to) : undefined;
+        const result = await client.getOrdersByMerchantRef(params.merchantRef1, from, to);
+        if (result.success && result.data) {
+            const count = result.data.orderSummaries?.length ?? 0;
+            return {
+                content: [{
+                        type: "text",
+                        text: `Found ${count} order(s) for merchant ref: ${params.merchantRef1}\n\n${JSON.stringify(result.data, null, 2)}`,
+                    }],
+            };
+        }
+        return createApiErrorResponse(result, "get orders by merchant reference");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetOrdersByMerchantRef");
+    }
+}
+export async function handleGetOrderHistory(params) {
+    try {
+        logger.info("Handling get_order_history tool call", { orderId: params.orderId });
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getOrderHistory(params.orderId);
+        if (result.success && result.data) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Order History for ${params.orderId}:\n\n${JSON.stringify(result.data, null, 2)}`,
+                    }],
+            };
+        }
+        return createApiErrorResponse(result, "get order history");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetOrderHistory");
+    }
+}
+export async function handleGetOrderReservation(params) {
+    try {
+        logger.info("Handling get_order_reservation tool call", { orderId: params.orderId });
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getOrderReservation(params.orderId);
+        if (result.success && result.data) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Stock Reservation for Order ${params.orderId}:\n\n${JSON.stringify(result.data, null, 2)}`,
+                    }],
+            };
+        }
+        return createApiErrorResponse(result, "get order reservation");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetOrderReservation");
+    }
+}
+export async function handleDeleteOrder(params) {
+    try {
+        logger.info("Handling delete_order tool call", { orderId: params.orderId });
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.deleteOrder(params.orderId);
+        if (result.success) {
+            return {
+                content: [{ type: "text", text: `Successfully deleted order: ${params.orderId}` }],
+            };
+        }
+        return createApiErrorResponse(result, "delete order");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleDeleteOrder");
+    }
+}
+// ==================== ORDER COLLECTION HANDLERS ====================
+export async function handleListOrderDeliveries(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getOrderDeliveries(params.orderId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Order Deliveries:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "list order deliveries");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleListOrderDeliveries");
+    }
+}
+export async function handleListOrderCancellations(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getOrderCancellations(params.orderId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Order Cancellations:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "list order cancellations");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleListOrderCancellations");
+    }
+}
+export async function handleListOrderRefunds(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getOrderRefunds(params.orderId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Order Refunds:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "list order refunds");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleListOrderRefunds");
+    }
+}
+export async function handleListOrderReleases(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getOrderReleases(params.orderId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Order Releases:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "list order releases");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleListOrderReleases");
+    }
+}
+export async function handleListOrderCompensations(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getOrderCompensations(params.orderId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Order Compensations:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "list order compensations");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleListOrderCompensations");
+    }
+}
+export async function handleListOrderModifications(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getOrderModifications(params.orderId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Order Modifications:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "list order modifications");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleListOrderModifications");
+    }
+}
+// ==================== COMPENSATION HANDLERS ====================
+export async function handleCreateCompensation(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        if (!params.request) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'request'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.createCompensation(params.orderId, params.request);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully created compensation for order ${params.orderId}:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "create compensation");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleCreateCompensation");
+    }
+}
+export async function handleGetCompensation(params) {
+    try {
+        if (!params.compensationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'compensationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getCompensation(params.compensationId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Compensation Details:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "get compensation");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetCompensation");
+    }
+}
+export async function handleUpdateCompensation(params) {
+    try {
+        if (!params.compensationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'compensationId'" }], isError: true };
+        }
+        if (!params.request) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'request'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.updateCompensation(params.compensationId, params.request);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully updated compensation ${params.compensationId}:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "update compensation");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleUpdateCompensation");
+    }
+}
+export async function handleDeleteCompensation(params) {
+    try {
+        if (!params.compensationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'compensationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.deleteCompensation(params.compensationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully deleted compensation: ${params.compensationId}` }] };
+        }
+        return createApiErrorResponse(result, "delete compensation");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleDeleteCompensation");
+    }
+}
+export async function handleStartCompensation(params) {
+    try {
+        if (!params.compensationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'compensationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.startCompensation(params.compensationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully started compensation: ${params.compensationId}` }] };
+        }
+        return createApiErrorResponse(result, "start compensation");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleStartCompensation");
+    }
+}
+export async function handleRestartCompensation(params) {
+    try {
+        if (!params.compensationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'compensationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.restartCompensation(params.compensationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully restarted compensation: ${params.compensationId}` }] };
+        }
+        return createApiErrorResponse(result, "restart compensation");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleRestartCompensation");
+    }
+}
+// ==================== ORDER LINES MODIFICATION HANDLERS ====================
+export async function handleCreateOrderLinesModification(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        if (!params.request) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'request'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.createOrderLinesModification(params.orderId, params.request);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully created order lines modification:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "create order lines modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleCreateOrderLinesModification");
+    }
+}
+export async function handleGetOrderLinesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getOrderLinesModification(params.modificationId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Order Lines Modification:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "get order lines modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetOrderLinesModification");
+    }
+}
+export async function handleUpdateOrderLinesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        if (!params.request) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'request'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.updateOrderLinesModification(params.modificationId, params.request);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully updated order lines modification:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "update order lines modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleUpdateOrderLinesModification");
+    }
+}
+export async function handleDeleteOrderLinesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.deleteOrderLinesModification(params.modificationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully deleted order lines modification: ${params.modificationId}` }] };
+        }
+        return createApiErrorResponse(result, "delete order lines modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleDeleteOrderLinesModification");
+    }
+}
+export async function handleStartOrderLinesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.startOrderLinesModification(params.modificationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully started order lines modification: ${params.modificationId}` }] };
+        }
+        return createApiErrorResponse(result, "start order lines modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleStartOrderLinesModification");
+    }
+}
+export async function handleRestartOrderLinesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.restartOrderLinesModification(params.modificationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully restarted order lines modification: ${params.modificationId}` }] };
+        }
+        return createApiErrorResponse(result, "restart order lines modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleRestartOrderLinesModification");
+    }
+}
+// ==================== SHIPPING FEES MODIFICATION HANDLERS ====================
+export async function handleCreateShippingFeesModification(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        if (!params.request) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'request'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.createShippingFeesModification(params.orderId, params.request);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully created shipping fees modification:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "create shipping fees modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleCreateShippingFeesModification");
+    }
+}
+export async function handleGetShippingFeesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getShippingFeesModification(params.modificationId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Shipping Fees Modification:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "get shipping fees modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetShippingFeesModification");
+    }
+}
+export async function handleUpdateShippingFeesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        if (!params.request) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'request'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.updateShippingFeesModification(params.modificationId, params.request);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully updated shipping fees modification:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "update shipping fees modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleUpdateShippingFeesModification");
+    }
+}
+export async function handleDeleteShippingFeesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.deleteShippingFeesModification(params.modificationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully deleted shipping fees modification: ${params.modificationId}` }] };
+        }
+        return createApiErrorResponse(result, "delete shipping fees modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleDeleteShippingFeesModification");
+    }
+}
+export async function handleStartShippingFeesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.startShippingFeesModification(params.modificationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully started shipping fees modification: ${params.modificationId}` }] };
+        }
+        return createApiErrorResponse(result, "start shipping fees modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleStartShippingFeesModification");
+    }
+}
+export async function handleRestartShippingFeesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.restartShippingFeesModification(params.modificationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully restarted shipping fees modification: ${params.modificationId}` }] };
+        }
+        return createApiErrorResponse(result, "restart shipping fees modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleRestartShippingFeesModification");
+    }
+}
+// ==================== ADDRESSES MODIFICATION HANDLERS ====================
+export async function handleCreateAddressesModification(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        if (!params.request) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'request'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.createAddressesModification(params.orderId, params.request);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully created addresses modification:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "create addresses modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleCreateAddressesModification");
+    }
+}
+export async function handleGetAddressesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getAddressesModification(params.modificationId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Addresses Modification:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "get addresses modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetAddressesModification");
+    }
+}
+export async function handleUpdateAddressesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        if (!params.request) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'request'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.updateAddressesModification(params.modificationId, params.request);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully updated addresses modification:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "update addresses modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleUpdateAddressesModification");
+    }
+}
+export async function handleDeleteAddressesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.deleteAddressesModification(params.modificationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully deleted addresses modification: ${params.modificationId}` }] };
+        }
+        return createApiErrorResponse(result, "delete addresses modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleDeleteAddressesModification");
+    }
+}
+export async function handleStartAddressesModification(params) {
+    try {
+        if (!params.modificationId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'modificationId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.startAddressesModification(params.modificationId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully started addresses modification: ${params.modificationId}` }] };
+        }
+        return createApiErrorResponse(result, "start addresses modification");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleStartAddressesModification");
+    }
+}
+// ==================== CUSTOM STATE HANDLERS ====================
+export async function handleListCustomStates() {
+    try {
+        const client = createOrderManagementClient();
+        const result = await client.listCustomStates();
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Custom States:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "list custom states");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleListCustomStates");
+    }
+}
+export async function handleGetCustomState(params) {
+    try {
+        if (!params.stateId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'stateId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getCustomState(params.stateId);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Custom State:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "get custom state");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetCustomState");
+    }
+}
+export async function handleCreateCustomState(params) {
+    try {
+        if (!params.stateId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'stateId'" }], isError: true };
+        }
+        if (!params.name) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'name'" }], isError: true };
+        }
+        // Determine state type based on whether any blocking options are set
+        const hasBlockingOptions = params.blocksDelivery ||
+            params.blocksRefund ||
+            params.blocksRelease ||
+            params.blocksCompensation ||
+            params.blocksCancellation;
+        const customState = {
+            name: params.name,
+            description: params.description,
+            type: hasBlockingOptions ? "BLOCKING" : "INFORMATIVE",
+            ...(hasBlockingOptions && {
+                blocksDelivery: params.blocksDelivery ?? false,
+                blocksRefund: params.blocksRefund ?? false,
+                blocksRelease: params.blocksRelease ?? false,
+                blocksCompensation: params.blocksCompensation ?? false,
+                blocksCancellation: params.blocksCancellation ?? false,
+            }),
+        };
+        const client = createOrderManagementClient();
+        const result = await client.createCustomState(params.stateId, customState);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully created custom state:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "create custom state");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleCreateCustomState");
+    }
+}
+export async function handleDeleteCustomState(params) {
+    try {
+        if (!params.stateId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'stateId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.deleteCustomState(params.stateId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully deleted custom state: ${params.stateId}` }] };
+        }
+        return createApiErrorResponse(result, "delete custom state");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleDeleteCustomState");
+    }
+}
+export async function handleAddOrderCustomState(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        if (!params.stateId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'stateId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.addOrderCustomState(params.orderId, params.stateId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully added custom state '${params.stateId}' to order ${params.orderId}` }] };
+        }
+        return createApiErrorResponse(result, "add order custom state");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleAddOrderCustomState");
+    }
+}
+export async function handleRemoveOrderCustomState(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        if (!params.stateId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'stateId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.removeOrderCustomState(params.orderId, params.stateId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully removed custom state '${params.stateId}' from order ${params.orderId}` }] };
+        }
+        return createApiErrorResponse(result, "remove order custom state");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleRemoveOrderCustomState");
+    }
+}
+// ==================== CUSTOM REASON CODE HANDLERS ====================
+export async function handleListCustomReasonCodes() {
+    try {
+        const client = createOrderManagementClient();
+        const result = await client.listCustomReasonCodes();
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Custom Reason Codes:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "list custom reason codes");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleListCustomReasonCodes");
+    }
+}
+export async function handleGetCustomReasonCode(params) {
+    try {
+        if (!params.code) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'code'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.getCustomReasonCode(params.code);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Custom Reason Code:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "get custom reason code");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleGetCustomReasonCode");
+    }
+}
+export async function handleCreateCustomReasonCode(params) {
+    try {
+        if (!params.code) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'code'" }], isError: true };
+        }
+        if (!params.name) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'name'" }], isError: true };
+        }
+        const customReasonCode = {
+            name: params.name,
+            description: params.description,
+        };
+        const client = createOrderManagementClient();
+        const result = await client.createCustomReasonCode(params.code, customReasonCode);
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully created custom reason code:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "create custom reason code");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleCreateCustomReasonCode");
+    }
+}
+export async function handleDeleteCustomReasonCode(params) {
+    try {
+        if (!params.code) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'code'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.deleteCustomReasonCode(params.code);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully deleted custom reason code: ${params.code}` }] };
+        }
+        return createApiErrorResponse(result, "delete custom reason code");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleDeleteCustomReasonCode");
+    }
+}
+// ==================== COMMENT HANDLERS ====================
+export async function handleCreateOrderComment(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        if (!params.text) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'text'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.createOrderComment(params.orderId, { text: params.text });
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully created comment:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "create order comment");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleCreateOrderComment");
+    }
+}
+export async function handleUpdateOrderComment(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        if (!params.commentId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'commentId'" }], isError: true };
+        }
+        if (!params.text) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'text'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.updateOrderComment(params.orderId, params.commentId, { text: params.text });
+        if (result.success && result.data) {
+            return {
+                content: [{ type: "text", text: `Successfully updated comment:\n\n${JSON.stringify(result.data, null, 2)}` }],
+            };
+        }
+        return createApiErrorResponse(result, "update order comment");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleUpdateOrderComment");
+    }
+}
+export async function handleDeleteOrderComment(params) {
+    try {
+        if (!params.orderId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'orderId'" }], isError: true };
+        }
+        if (!params.commentId) {
+            return { content: [{ type: "text", text: "Error: Missing required field 'commentId'" }], isError: true };
+        }
+        const client = createOrderManagementClient();
+        const result = await client.deleteOrderComment(params.orderId, params.commentId);
+        if (result.success) {
+            return { content: [{ type: "text", text: `Successfully deleted comment: ${params.commentId}` }] };
+        }
+        return createApiErrorResponse(result, "delete order comment");
+    }
+    catch (error) {
+        return createErrorResponse(error, "handleDeleteOrderComment");
+    }
+}