@agenzo/merchant-cli 0.4.3 → 0.5.0

package/dist/index.js

@@ -18,6 +18,9 @@ var CODE_NUM = {
   AUTH_INVITE_CODE_INVALID: 1004,
   KEY_INVALID: 1101,
   KEY_SCOPE_DENIED: 1102,
+  PAYMENT_METHOD_NOT_FOUND: 1401,
+  PAYMENT_METHOD_DISABLED: 1402,
+  INVALID_PAYMENT_METHOD: 1403,
   RESOURCE_NOT_FOUND: 2001,
   RESOURCE_CONFLICT: 2002,
   RESOURCE_STATE_INVALID: 2003,
@@ -38,6 +41,23 @@ var CODE_NUM = {
   QUOTE_EXPIRED: 4202,
   BOOKING_FAILED: 4203,
   CANCELLATION_NOT_ALLOWED: 4204,
+  PRICE_MISMATCH: 4205,
+  VEHICLE_CLASS_MISMATCH: 4206,
+  PAYMENT_METHOD_REQUIRED: 4207,
+  QUOTE_CACHE_UNAVAILABLE: 4208,
+  ARREARS_OUTSTANDING: 4209,
+  CONTACT_REQUIRED: 4210,
+  INVALID_PHONE: 4211,
+  SEAT_LIMIT_EXCEEDED: 4213,
+  RIDE_NOT_FOUND: 4212,
+  NO_AVAILABILITY: 4301,
+  PRICE_CHANGED: 4302,
+  NAME_FORMAT_INVALID: 4303,
+  HOTEL_ORDER_NOT_FOUND: 4304,
+  ALREADY_CANCELLED: 4305,
+  CHECKOUT_NOT_ALLOWED: 4306,
+  CHECKOUT_TASK_NOT_FOUND: 4307,
+  PAY_PER_CALL_NOT_AVAILABLE: 4308,
   RATE_LIMITED: 5001,
   UPSTREAM_ERROR: 5101,
   INTERNAL_ERROR: 5201,
@@ -55,23 +75,29 @@ function codeNum(code) {
   return CODE_NUM[code];
 }
 var CliError = class _CliError extends Error {
-  constructor(code, message, statusCode, requestId, upstream) {
+  constructor(code, message, statusCode, requestId, upstream, backendMessage) {
     super(message);
     this.code = code;
     this.statusCode = statusCode;
     this.requestId = requestId;
     this.upstream = upstream;
+    this.backendMessage = backendMessage;
     this.name = "CliError";
   }
   code;
   statusCode;
   requestId;
   upstream;
+  backendMessage;
   /**
    * Map a backend ApiError to a CLI-facing code (§8.5 transitional mapping).
-   * Backend numeric codes / HTTP status are translated to §8.4 string codes;
-   * the raw backend message is NOT passed through (§8.1 principle 4) — a
-   * stable, fixed message per code is used instead.
+   * Backend numeric codes / HTTP status are translated to §8.4 string codes.
+   * The top-level `message` is always the stable, catalog-owned text for the
+   * resolved code (§8.1 principle 4 — never let raw backend text become the
+   * primary/stable message). The backend's own message is NOT discarded,
+   * though: it is preserved on `backendMessage` and surfaced in the envelope
+   * as `backend_message` so the caller can see the real reason (e.g. which
+   * field failed validation) alongside the stable code/message.
    *
    * The optional `opts.auth` selects the auth semantics for the 401 mapping:
    * - `'bearer'` (default, admin-cli Bearer Token): 401 → `AUTH_SESSION_EXPIRED`.
@@ -95,7 +121,8 @@ var CliError = class _CliError extends Error {
         STABLE_MESSAGE[error.code] ?? "Request failed. Please check your input and retry.",
         error.statusCode,
         error.requestId,
-        error.upstream
+        error.upstream,
+        error.errorMessage
       );
     }
     const status = error.statusCode;
@@ -112,7 +139,8 @@ var CliError = class _CliError extends Error {
       STABLE_MESSAGE[code] ?? "Request failed. Please check your input and retry.",
       status,
       error.requestId,
-      error.upstream
+      error.upstream,
+      error.errorMessage
     );
   }
 };
@@ -167,6 +195,9 @@ var STABLE_MESSAGE = {
   AUTH_INVITE_CODE_INVALID: "The invitation code is invalid.",
   KEY_INVALID: "The API key is invalid or has been revoked. Please check your --api-key and retry.",
   KEY_SCOPE_DENIED: "This API key does not have the required scope for this command.",
+  PAYMENT_METHOD_NOT_FOUND: "Payment method not found.",
+  PAYMENT_METHOD_DISABLED: "This payment method has been disabled.",
+  INVALID_PAYMENT_METHOD: "The payment method is not available for this operation.",
   RESOURCE_NOT_FOUND: "The resource was not found or does not belong to the current organization.",
   RESOURCE_CONFLICT: "A resource with the same unique value already exists.",
   RESOURCE_STATE_INVALID: "The resource is in a state that does not permit this operation.",
@@ -188,18 +219,38 @@ var STABLE_MESSAGE = {
   VEHICLE_UNAVAILABLE: "No vehicle is available for the requested trip. Please try a different time or class.",
   QUOTE_EXPIRED: "The quote has expired. Please request a new quote and retry.",
   BOOKING_FAILED: "The booking could not be completed. Please retry.",
+  PRICE_MISMATCH: "The price does not match the quote. Re-quote and use the exact amount from the quote response.",
+  VEHICLE_CLASS_MISMATCH: "The vehicle class does not match the quote. Use the vehicle class from the quote response.",
+  PAYMENT_METHOD_REQUIRED: "Pay-per-call billing requires an active payment method. Please add a card first.",
+  QUOTE_CACHE_UNAVAILABLE: "Quote cache is temporarily unavailable. Please request a new quote and retry.",
+  ARREARS_OUTSTANDING: "You have outstanding arrears. Please settle your balance before booking a new ride.",
+  CONTACT_REQUIRED: "Passenger contact information is required. Please provide a passenger name and phone number.",
+  INVALID_PHONE: "The passenger phone number is not valid. Please provide a valid international number.",
+  SEAT_LIMIT_EXCEEDED: "The number of child/infant/toddler seats exceeds the vehicle capacity. Reduce seats or choose a larger vehicle.",
+  RIDE_NOT_FOUND: "The ride order was not found or does not belong to you.",
   CANCELLATION_NOT_ALLOWED: "This order cannot be cancelled in its current state.",
+  NO_AVAILABILITY: "No rooms available for the selected hotel and dates.",
+  PRICE_CHANGED: "The price changed since the quote. Re-quote and confirm.",
+  NAME_FORMAT_INVALID: "The guest name format is not accepted; use Latin letters.",
+  HOTEL_ORDER_NOT_FOUND: "Hotel order not found.",
+  ALREADY_CANCELLED: "This hotel order is already cancelled.",
+  CHECKOUT_NOT_ALLOWED: "A partial check-out is not allowed in the current state.",
+  CHECKOUT_TASK_NOT_FOUND: "Check-out application not found.",
+  PAY_PER_CALL_NOT_AVAILABLE: "Pay-per-call billing is not available; use monthly_settlement.",
   NOT_IMPLEMENTED: "This operation is not implemented yet."
 };
 function toErrorEnvelope(error) {
   if (error instanceof CliError) {
+    const stableMessage = error.message || "Unknown error";
+    const backendMessage = error.backendMessage && error.backendMessage !== stableMessage ? error.backendMessage : void 0;
     return {
       error: {
         code: error.code,
         code_num: codeNum(error.code),
-        message: error.message || "Unknown error",
+        message: stableMessage,
         ...error.requestId ? { request_id: error.requestId } : {},
-        ...error.upstream ? { upstream: error.upstream } : {}
+        ...error.upstream ? { upstream: error.upstream } : {},
+        ...backendMessage ? { backend_message: backendMessage } : {}
       }
     };
   }
@@ -262,13 +313,27 @@ function isBelow(current, minimum) {
 var ApiClient = class {
   baseUrl;
   timeout;
+  /**
+   * Correlation id for this CLI invocation. Generated once per `ApiClient`
+   * instance (i.e. once per command execution — each `apps/*` entrypoint
+   * constructs exactly one `ApiClient` per process run) and sent as
+   * `X-Request-Id` on every request this client makes. The backend's
+   * `RequestIdMiddleware` adopts a client-supplied `X-Request-Id` verbatim as
+   * both `trace_id` and `request_id` (only generating its own when the header
+   * is absent), so every HTTP call belonging to one CLI operation — including
+   * multi-step flows like `payment-methods add`'s create + poll + get — shares
+   * a single trace_id server-side and can be followed as one chain in logs.
+   */
+  requestId;
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/+$/, "");
     this.timeout = config.timeout ?? 6e4;
+    this.requestId = crypto.randomUUID();
   }
   buildHeaders(auth) {
     const headers = {
-      "User-Agent": `agenzo-admin-cli/${getCurrentVersion()}`
+      "User-Agent": `agenzo-admin-cli/${getCurrentVersion()}`,
+      "X-Request-Id": this.requestId
     };
     if (auth.type === "bearer") {
       headers["Authorization"] = `Bearer ${auth.token}`;
@@ -806,6 +871,7 @@ async function watchRideStatus(apiClient, apiKey, orderId, opts) {
 // src/verb-schema.ts
 var CLI_NAME = "agenzo-merchant-cli";
 var NOUN = "ride-elife";
+var HOTEL_NOUN = "hotel-redaug";
 function wantsJsonSchema(argv = process.argv) {
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
@@ -1071,6 +1137,691 @@ var listOrdersSchema = {
     PARAM_INVALID: "Ensure --page / --page-size are positive integers, then retry."
   }
 };
+var hotelSearchSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "search",
+  description: "Search hotels near a coordinate OR within a destination for the given stay dates. Two location branches: --destination-id (from find-destination) XOR --lat/--lng (geocoded by the Agent backend). Exactly one branch must be supplied",
+  flags: {
+    "destination-id": { type: "string", required: "conditional", description: "Destination ID from find-destination (alternative to --lat/--lng)", constraints: "Exactly one location branch: --destination-id XOR (--lat + --lng)" },
+    lat: { type: "float", required: "conditional", description: "Latitude of the search center (geocoded by the Agent backend, not by the CLI)", constraints: "-90 to 90; requires --lng; mutually exclusive with --destination-id" },
+    lng: { type: "float", required: "conditional", description: "Longitude of the search center (geocoded by the Agent backend, not by the CLI)", constraints: "-180 to 180; requires --lat; mutually exclusive with --destination-id" },
+    distance: { type: "int", required: false, default: 20, description: "Search radius in kilometers", constraints: 'Agent infers from phrasing \u2014 small (2-5) for "right next to a spot", larger (15-30) for a whole city. Do NOT ask the user for a number' },
+    "check-in": { type: "string", required: true, description: "Check-in date", constraints: "YYYY-MM-DD, today or later" },
+    "check-out": { type: "string", required: true, description: "Check-out date", constraints: "YYYY-MM-DD, strictly after check-in" },
+    adults: { type: "int", required: false, default: 2, description: "Number of adults", constraints: "1-9 per room" },
+    children: { type: "int", required: false, default: 0, description: "Number of children" },
+    "room-num": { type: "int", required: false, default: 1, description: "Number of rooms requested" },
+    star: { type: "int", required: false, description: "Minimum hotel star rating filter", constraints: "Enum 3 / 4 / 5" },
+    keyword: { type: "string", required: false, description: "Optional hotel name keyword to narrow results" },
+    "price-min": { type: "float", required: false, description: "Minimum price filter" },
+    "price-max": { type: "float", required: false, description: "Maximum price filter" },
+    "sort-by": { type: "string", required: false, description: "Sort field" },
+    page: { type: "int", required: false, default: 1, description: "Page number", constraints: ">= 1" },
+    "page-size": { type: "int", required: false, default: 10, description: "Results per page", constraints: ">= 1" },
+    "hotel-facility-codes": { type: "string", required: false, description: "Hotel facility codes (comma-separated or JSON array, from hotel-filters)" },
+    "room-facility-codes": { type: "string", required: false, description: "Room facility codes (comma-separated or JSON array, from hotel-filters)" },
+    "hotel-brand-codes": { type: "string", required: false, description: "Hotel brand codes (comma-separated or JSON array, from hotel-filters)" },
+    "plate-codes": { type: "string", required: false, description: "Plate codes (comma-separated or JSON array, from hotel-filters)" },
+    "hotel-label-ids": { type: "string", required: false, description: "Hotel label IDs (comma-separated or JSON array, from hotel-filters)" },
+    "hotel-sub-category-ids": { type: "string", required: false, description: "Hotel sub-category IDs (comma-separated or JSON array, from hotel-filters)" }
+  },
+  response: {
+    hotels: {
+      type: "array",
+      description: "Matching hotels for the location and dates. Empty when nothing was found (rendered as a successful empty result, not an error).",
+      items: {
+        hotel_id: { type: "string|int", description: "Opaque hotel identifier. Pass verbatim to quote --hotel-id. Do NOT interpret." },
+        hotel_name: { type: "string", description: "Hotel name." },
+        star: { type: "int|null", description: "Star rating." },
+        address: { type: "string|null", description: "Hotel address." },
+        distance_km: { type: "float|null", description: "Approximate distance from the search center, in km." },
+        city_name: { type: "string|null", description: "City name." },
+        district_name: { type: "string|null", description: "District name." },
+        business_name: { type: "string|null", description: "Business area name." },
+        score: { type: "float|null", description: "Hotel score/rating." },
+        main_image: { type: "string|null", description: "Main hotel image URL." },
+        lowest_price: {
+          type: "object|null",
+          description: "Indicative nightly starting price (not the bookable total \u2014 get the real price from quote).",
+          properties: {
+            amount: { type: "float", description: "Starting price in DECIMAL units (NOT cents)." },
+            currency: { type: "string", description: "ISO 4217 currency code." }
+          }
+        }
+      }
+    }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug search --destination-id D12345 --check-in 2026-07-04 --check-out 2026-07-05 --adults 2",
+    output_summary: "Returns hotels[] for the location. Pick one and use hotels[].hotel_id in hotel-redaug quote. Alternatively use --lat/--lng instead of --destination-id."
+  },
+  error_recovery: {
+    NO_AVAILABILITY: "No hotels near this coordinate for these dates. Widen --distance, try different dates, or have the Agent backend geocode a nearby area. As a last resort try another category=hotel service (see cross_service_recovery).",
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after ~2s backoff. Otherwise surface to user."
+  }
+};
+var hotelQuoteSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "quote",
+  description: "Get real-time room types and bookable rates for one hotel and stay. Returns rates each carrying an opaque product_token and per-night price_items that must be passed verbatim to create-order. Run immediately before create-order \u2014 availability and prices change in real time",
+  flags: {
+    "hotel-id": { type: "string", required: true, description: "Hotel chosen from search results (search.response.hotels[].hotel_id)" },
+    "check-in": { type: "string", required: true, description: "Check-in date (match search)", constraints: "YYYY-MM-DD" },
+    "check-out": { type: "string", required: true, description: "Check-out date (match search)", constraints: "YYYY-MM-DD, strictly after check-in" },
+    adults: { type: "int", required: false, default: 2, description: "Adults per room (match search)" },
+    children: { type: "int", required: false, default: 0, description: "Children per room (match search)" },
+    "room-num": { type: "int", required: false, default: 1, description: "Number of rooms (match search)" },
+    nationality: { type: "string", required: false, default: "CN", description: "Guest nationality (ISO country code). Affects rate eligibility for some hotels" }
+  },
+  response: {
+    rates: {
+      type: "array",
+      description: "Bookable room+rate options. Empty when the hotel has no rooms for these dates (treat as NO_AVAILABILITY: re-quote another hotel or change dates).",
+      items: {
+        product_token: { type: "string", description: "Opaque token packing room/rate/supply identifiers. Pass verbatim to create-order --product-token. Do NOT interpret or reuse across quotes." },
+        room_name: { type: "string", description: "Room type name." },
+        rate_plan_name: { type: "string|null", description: "Rate plan name (e.g. 'Breakfast included, free cancellation')." },
+        breakfast: { type: "int|null", description: "Breakfast enum for the rate (-1=bed breakfast, 0=no breakfast, 1+=N breakfasts). Display only." },
+        free_cancellation: { type: "bool|null", description: "Whether this rate is currently in a free-cancellation window. Prefer when the user wants flexibility." },
+        total_price: {
+          type: "object",
+          description: "Total bookable price for the whole stay and room count.",
+          properties: {
+            amount: { type: "float", description: "Total price in DECIMAL units. Pass verbatim to create-order --total-amount." },
+            currency: { type: "string", description: "ISO 4217 currency code. Pass to create-order --currency." }
+          }
+        },
+        price_items: {
+          type: "array",
+          description: "Per-night price breakdown. Pass this array verbatim to create-order --price-items.",
+          items: {
+            sale_date: { type: "string", description: "Night date YYYY-MM-DD." },
+            sale_price: { type: "float", description: "Price for that night in DECIMAL units." },
+            breakfast_num: { type: "int", description: "Breakfast enum for that night (-1=bed breakfast, 0=no breakfast, 1+=N). Copy verbatim into create-order; never alter." }
+          }
+        }
+      }
+    }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug quote --hotel-id 10583772 --check-in 2026-08-20 --check-out 2026-08-21 --adults 2",
+    output_summary: "Returns rates[]. Use rates[].product_token, total_price.amount/currency and price_items[] in hotel-redaug create-order."
+  },
+  error_recovery: {
+    NO_AVAILABILITY: "This hotel has no bookable rooms for these dates (upstream roomItems empty). Re-quote a different hotel from the search result, or re-search with other dates. Do NOT retry the same hotel/dates.",
+    PRICE_CHANGED: "Rates shifted since search. Use the prices returned here; do not reuse search lowest_price. No action other than informing the user if materially higher.",
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after ~2s backoff."
+  }
+};
+var hotelCreateOrderSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "create-order",
+  description: "Create a hotel order WITHOUT charging any account (re-check availability + createOrder upstream), using a product_token and price_items from a recent quote. The order enters AWAITING_PAYMENT \u2014 no money is moved until pay-order. check-in/check-out, guest counts, total-amount and price-items must match the quote",
+  flags: {
+    "product-token": { type: "string", required: true, description: "Chosen rate token from quote (quote.response.rates[].product_token). Pass verbatim" },
+    "total-amount": { type: "float", required: true, description: "Total price for the stay (quote.response.rates[].total_price.amount)", constraints: "DECIMAL units (NOT cents), 0.01\u2013999999999.99. Must equal the chosen rate total_price.amount" },
+    currency: { type: "string", required: true, description: "ISO 4217 currency code from the chosen rate (quote.response.rates[].total_price.currency)", constraints: "Exactly 3 uppercase letters" },
+    "price-items": { type: "string", required: true, description: "Per-night price breakdown from quote, copied verbatim (including breakfast_num)", constraints: "JSON array of {sale_date, sale_price, breakfast_num}; copy breakfast_num verbatim from quote (-1/0/1+ are distinct breakfast products, never alter); else PARAM_INVALID" },
+    "check-in": { type: "string", required: true, description: "Check-in date (match quote)", constraints: "YYYY-MM-DD" },
+    "check-out": { type: "string", required: true, description: "Check-out date (match quote)", constraints: "YYYY-MM-DD, strictly after check-in" },
+    "room-num": { type: "int", required: false, default: 1, description: "Number of rooms (match quote)" },
+    adults: { type: "int", required: false, default: 2, description: "Adults per room (match quote)", constraints: "1-20" },
+    children: { type: "int", required: false, default: 0, description: "Children per room (match quote)", constraints: "0-10" },
+    nationality: { type: "string", required: false, default: "CN", description: "Guest nationality (match quote)" },
+    "guest-name": { type: "string", required: true, description: "Primary guest name", constraints: "Use the name as the user gives it. If a supplier returns NAME_FORMAT_INVALID, re-collect in Latin letters and retry" },
+    "contact-name": { type: "string", required: true, description: "Booking contact name (may equal guest-name)" },
+    "contact-phone": { type: "string", required: true, description: "Booking contact phone number", constraints: "Digits; collect country code separately in --contact-country-code" },
+    "contact-country-code": { type: "string", required: false, default: "86", description: "Phone country calling code without '+'" },
+    "contact-email": { type: "string", required: false, description: "Booking contact email" },
+    "arrive-time": { type: "string", required: false, description: "Expected arrival time", constraints: "HH:mm, hotel local time" },
+    "special-requests": { type: "string", required: false, description: "Free-text special requests (non-binding)" },
+    "idempotency-key": {
+      type: "string",
+      required: true,
+      description: "Unique key forwarded verbatim as the Idempotency-Key header; never auto-generated. Derive from business intent (e.g. hash(user_id + product_token + check_in)) and reuse the SAME key when retrying the same order creation",
+      constraints: "1-128 chars [A-Za-z0-9_-]"
+    }
+  },
+  response: {
+    order_id: { type: "string", description: "Our order reference (coOrderCode). Use as --order-id in pay-order / get / cancel." },
+    fc_order_code: { type: "string", description: "Supplier order reference. Needed as --fc-order-code in cancel and checkout." },
+    total_amount: { type: "float", description: "Amount to be paid in pay-order (DECIMAL units). The order is locked in AWAITING_PAYMENT \u2014 no charge has been made." },
+    currency: { type: "string", description: "ISO 4217 currency code for the payment." }
+  },
+  example: {
+    command: `agenzo-merchant-cli hotel-redaug create-order --product-token <tok> --total-amount 10.00 --currency CNY --price-items '[{"sale_date":"2026-08-20","sale_price":10.00,"breakfast_num":0}]' --check-in 2026-08-20 --check-out 2026-08-21 --adults 2 --guest-name "Zhang San" --contact-name "Zhang San" --contact-phone 13800138000 --idempotency-key create-h1n2`,
+    output_summary: "Returns {order_id, fc_order_code, total_amount, currency}. The order is AWAITING_PAYMENT (no charge). Use order_id as --order-id in pay-order to settle."
+  },
+  error_recovery: {
+    NO_AVAILABILITY: "Availability vanished between quote and create-order. Re-quote the same hotel; if still empty, quote another hotel or change dates. Use a NEW idempotency-key for the new product_token.",
+    PRICE_CHANGED: "The price/price_items no longer match upstream. Re-quote to get fresh total_price and price_items, confirm the new price with the user, then create-order with the new values and a NEW idempotency-key.",
+    NAME_FORMAT_INVALID: "The supplier requires the guest name in a specific format (commonly Latin first/last name for international properties). Re-collect guest-name in Latin letters and retry with the SAME idempotency-key.",
+    PARAM_IDEMPOTENCY_KEY_REQUIRED: "Add a unique --idempotency-key derived from business intent and retry.",
+    PARAM_IDEMPOTENCY_KEY_CONFLICT: "The same idempotency-key was used with different parameters. Retry with the original parameters, or generate a NEW key for the new parameters.",
+    UPSTREAM_ERROR: "Transient upstream error during checkBooking or createOrder. Retry once after ~2s backoff with the SAME idempotency-key."
+  }
+};
+var hotelPayOrderSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "pay-order",
+  description: 'Settle an existing AWAITING_PAYMENT order created by create-order. Takes only --order-id; the billing path is decided server-side by the order billing_mode. monthly_settlement deducts from the developer credit account then confirms with the supplier; pay_per_call verifies the user EVO payment \u2014 the EVO merchantTransID IS the order_id (the user pays via EVO under the order_id), so the platform queries EVO for that order_id and requires an exact amount/currency match before confirming (the response settlement_path is then "active_payment"). On success the order becomes PAID. Supports --watch to poll on PAYMENT_NOT_COMPLETED until PAID',
+  flags: {
+    "order-id": { type: "string", required: true, description: "Order to settle (create-order.response.order_id). For pay_per_call this is also the EVO merchantTransID the user paid under." },
+    "idempotency-key": {
+      type: "string",
+      required: true,
+      description: "Unique key forwarded verbatim as the Idempotency-Key header; never auto-generated. Derive from business intent (e.g. hash(order_id + attempt)) and reuse the SAME key when retrying the same payment",
+      constraints: "1-128 chars [A-Za-z0-9_-]"
+    },
+    watch: { type: "bool", required: false, default: false, description: "Poll automatically on PAYMENT_NOT_COMPLETED until PAID or timeout. Each iteration emits one NDJSON line" },
+    "watch-interval": { type: "int", required: false, default: 5, description: "Seconds between poll attempts in --watch mode" },
+    "watch-timeout": { type: "int", required: false, default: 300, description: "Total seconds before giving up in --watch mode" }
+  },
+  response: {
+    order_id: { type: "string", description: "Order reference." },
+    settlement_path: { type: "string", description: "Which billing path was used: 'monthly_settlement' or 'active_payment'." },
+    amount: { type: "float", description: "Settled amount in DECIMAL units." },
+    currency: { type: "string", description: "ISO 4217 currency code of the settlement." },
+    pay_status: { type: "int", description: "Upstream pay status (1 = paid). The order internal status is now PAID." },
+    settled_at: { type: "string", description: "ISO 8601 settlement timestamp. On idempotent replay, the original first settled_at is returned unchanged." }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug pay-order --order-id hho_01KWC63Z5CD6CKBM33Q7SC2ZDT --idempotency-key pay-h1n2",
+    output_summary: 'Settlement path is chosen server-side by billing_mode. monthly_settlement: deducts from the credit account, confirms with the supplier. Returns {order_id, settlement_path:"monthly_settlement", amount, currency, pay_status:1, settled_at}. Order becomes PAID. For pay_per_call the user must have already paid via EVO using the order_id as the merchantTransID; the same command settles it (settlement_path:"active_payment").'
+  },
+  error_recovery: {
+    PAYMENT_NOT_COMPLETED: "pay_per_call only: EVO has not yet confirmed the payment for this order_id. Retry with the SAME idempotency-key after a delay, or use --watch to poll automatically until PAID.",
+    PAYMENT_NOT_FOUND: "No EVO transaction found for this order_id. Confirm the user paid via EVO using the order_id as the merchantTransID; do NOT retry blindly.",
+    PAYMENT_AMOUNT_MISMATCH: "The EVO-confirmed amount/currency does not match the order. The user must pay the exact order amount in the exact currency under the order_id. Do NOT retry until corrected.",
+    PAYMENT_QUERY_FAILED: "EVO gateway query failed (transport/timeout). Retry once after ~5s with the SAME idempotency-key.",
+    BILLING_MODE_MISMATCH: "The order billing_mode is not a recognized settlement mode (only monthly_settlement and pay_per_call are valid). Check the developer billing_mode; do NOT retry blindly.",
+    INVALID_ORDER_STATE: "The order is not in AWAITING_PAYMENT (it may already be PAID or CANCELLED). Check status via get; do NOT retry pay-order.",
+    ORDER_NOT_FOUND: "No order for this --order-id. Verify it is the order_id returned by create-order. Do NOT retry.",
+    ACCOUNT_INSUFFICIENT_BALANCE: "Settlement credit is insufficient (check via admin-cli accounts get). Direct the user to top up offline.",
+    ACCOUNT_NOT_FOUND: "Developer has no settlement account. Direct the user to complete contract signing.",
+    ACCOUNT_SUSPENDED: "The settlement account is suspended. Direct the user to contact support; do NOT retry.",
+    PAYORDER_FAILED: "Upstream payOrder failed after a successful deduction; the deduction was reversed and the order stays AWAITING_PAYMENT. Retry with the SAME idempotency-key after a delay.",
+    PAYORDER_FAILED_AFTER_PAYMENT: "EVO payment confirmed but upstream payOrder failed. The order is recoverable (the EVO payment under the order_id is preserved). Contact support for reconciliation; do NOT retry automatically.",
+    PARAM_IDEMPOTENCY_KEY_REQUIRED: "Add a unique --idempotency-key and retry.",
+    PARAM_IDEMPOTENCY_KEY_CONFLICT: "Same idempotency-key used with different parameters. Use the original parameters, or generate a NEW key."
+  }
+};
+var hotelGetSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "get",
+  description: "Query a hotel order status by id; with --watch, poll until a terminal status. Confirmation from the property is asynchronous, so order_status is usually PROCESSING (2) immediately after book \u2014 poll until CONFIRMED (3)",
+  flags: {
+    "order-id": { type: "string", required: true, description: "Our order reference (coOrderCode) returned by book (book.response.order_id)" },
+    watch: { type: "bool", required: false, default: false, description: "Poll until a terminal status, emitting one NDJSON line per update" },
+    "watch-interval": { type: "int", required: false, default: 5, description: "Seconds between polls when --watch is set" },
+    "watch-timeout": { type: "int", required: false, default: 600, description: "Max seconds to poll before giving up" }
+  },
+  response: {
+    order_id: { type: "string", description: "Our order reference." },
+    fc_order_code: { type: "string", description: "Supplier order reference." },
+    order_status: { type: "string", description: "Std STRING: PROCESSING | CONFIRMED | CANCELLED | COMPLETED | INIT. There is no order_status_std field." },
+    order_status_code: { type: "int", description: "2 = Processing, 3 = Confirmed, 4 = Cancelled, 5 = Completed. Provider path only; absent on the local-cache fallback." },
+    channel_state: { type: "string|null", description: "Channel-level state (e.g. 'paid' = settled)." },
+    hotel_confirm_no: { type: "string|null", description: "Property confirmation number. Populated once order_status reaches CONFIRMED (3); null while PROCESSING (2)." },
+    hotel_name: { type: "string|null", description: "Hotel name." },
+    room_name: { type: "string|null", description: "Booked room type." },
+    check_in: { type: "string|null", description: "Check-in date YYYY-MM-DD." },
+    check_out: { type: "string|null", description: "Check-out date YYYY-MM-DD." },
+    total_amount: { type: "float|null", description: "Total amount in DECIMAL units." },
+    source: { type: "string", description: "'provider' (live upstream, carries order_status_code) or 'local_cache' (fallback, string status only)." }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug get --order-id E2E1750000000",
+    output_summary: "Returns order_status (string) + order_status_code (int). Poll every 5s until CONFIRMED (3); hotel_confirm_no appears once confirmed."
+  },
+  polling: {
+    recommended_interval_seconds: 5,
+    terminal_statuses: [3, 4, 5],
+    in_progress_statuses: [2],
+    field_availability: {
+      hotel_confirm_no: "Populated only after order_status reaches CONFIRMED (3). Null while PROCESSING (2)."
+    }
+  },
+  error_recovery: {
+    HOTEL_ORDER_NOT_FOUND: "No order for this --order-id. Verify it is the order_id returned by book. Do NOT retry.",
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after 5s; if still failing, surface to user."
+  }
+};
+var hotelCancelSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "cancel",
+  description: "Cancel an entire hotel order within the cancellation policy (a cancellation fee may apply). Returns synchronously, but a successful call is acceptance only, NOT proof: poll get until order_status=CANCELLED (4). For partial-night or out-of-policy cancellation, use checkout instead",
+  flags: {
+    "order-id": { type: "string", required: true, description: "Our order reference (coOrderCode) to cancel (book.response.order_id)" },
+    "fc-order-code": { type: "string", required: true, description: "Supplier order reference (book.response.fc_order_code)" },
+    reason: { type: "string", required: false, description: "Cancellation reason" },
+    "idempotency-key": {
+      type: "string",
+      required: true,
+      description: "Unique key forwarded verbatim as the Idempotency-Key header; never auto-generated. Reuse the SAME key when retrying the same cancellation",
+      constraints: "1-128 chars [A-Za-z0-9_-]"
+    }
+  },
+  response: {
+    order_id: { type: "string", description: "Cancelled order reference." },
+    order_status: { type: "string", description: "Status after the cancel request. Acceptance is NOT proof \u2014 poll get until 'CANCELLED' (order_status_code 4)." },
+    cancellation: {
+      type: "object|null",
+      description: "Confirmed-cancellation details (confirmed shape).",
+      properties: {
+        cancellation_fee: { type: "float", description: "Fee charged for cancellation, in DECIMAL units." },
+        reversal_amount: { type: "float", description: "Amount reversed/refunded, in DECIMAL units." },
+        currency: { type: "string", description: "ISO 4217 currency code." }
+      }
+    },
+    cancellation_fee: { type: "float|null", description: "Fee charged for cancellation (confirmed shape), in DECIMAL units." },
+    refund_amount: { type: "float", description: "Amount credited back to the settlement balance (paid - cancellation_fee), in DECIMAL units." },
+    cancel_status: { type: "string|absent", description: "'cancel_pending' when accepted upstream but not yet observed as CANCELLED (accepted-but-pending shape)." },
+    cancel_result: { type: "unknown|absent", description: "Upstream cancel acknowledgement (pending shape). NOT proof of cancellation \u2014 confirm via get." }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug cancel --order-id E2E1750000000 --fc-order-code FC1750000000 --idempotency-key cancel-h1n2",
+    output_summary: "Returns the cancellation acknowledgement and any fee/refund. Then poll get until order_status=CANCELLED (4) to confirm."
+  },
+  error_recovery: {
+    CANCELLATION_NOT_ALLOWED: "The order is outside its free/allowed cancellation window or already terminal. Do NOT retry cancel. If the user still wants out (e.g. drop some nights or request a waiver), use checkout instead.",
+    ALREADY_CANCELLED: "Order is already cancelled (order_status=4). Treat as success; confirm via get.",
+    HOTEL_ORDER_NOT_FOUND: "Verify --order-id / --fc-order-code from the book response. Do NOT retry.",
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after 5s with the SAME idempotency-key, then poll get to check whether the cancellation actually took effect.",
+    PARAM_IDEMPOTENCY_KEY_REQUIRED: "Add a unique --idempotency-key derived from business intent and retry.",
+    PARAM_IDEMPOTENCY_KEY_CONFLICT: "The same idempotency-key was used with different parameters. Retry with the original parameters, or generate a NEW key for the new parameters."
+  }
+};
+var hotelCheckoutSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "checkout",
+  description: "Request a partial check-out or an out-of-policy cancellation (drop some nights, or cancel after the free window so the property must approve). This is an APPLICATION: it returns a task_order_code synchronously, then the supplier decides asynchronously \u2014 poll get-checkout. Use cancel for a simple whole-order in-policy cancellation",
+  flags: {
+    "order-id": { type: "string", required: true, description: "Our order reference (coOrderCode) for the URL path (book.response.order_id)" },
+    "fc-order-code": { type: "string", required: true, description: "Supplier order reference of the booking to change (book.response.fc_order_code)" },
+    reason: { type: "string", required: true, description: "Why the partial check-out / out-of-policy cancellation is requested" },
+    "checkout-rooms": {
+      type: "string",
+      required: true,
+      description: "Which booked rooms to check out of, taken from the book response (book.response.rooms[]). room_index and guest_name come verbatim from book \u2014 do NOT ask the user for them",
+      constraints: "JSON array of {room_index, guest_name, cancel_check_in_date}; else PARAM_INVALID. cancel_check_in_date is the check-in date of the night(s) being dropped (YYYY-MM-DD)"
+    },
+    "refund-type": { type: "int", required: false, default: 1, description: "Requested refund handling (upstream refund-type code; default to the standard refund flow when unsure)" },
+    "idempotency-key": {
+      type: "string",
+      required: true,
+      description: "Unique key forwarded verbatim as the Idempotency-Key header; never auto-generated. Reuse the SAME key when retrying the same application",
+      constraints: "1-128 chars [A-Za-z0-9_-]"
+    }
+  },
+  response: {
+    order_id: { type: "string", description: "Our order reference (echoes the path order_id)." },
+    task_order_code: { type: "string", description: "Check-out application id. Poll get-checkout --task-order-code to track approval and refund." },
+    apply_status: { type: "string|null", description: "Initial application status (e.g. submitted / pending)." },
+    checkout_status: { type: "string|absent", description: "'checkout_pending' \u2014 async; poll get-checkout for the outcome." }
+  },
+  example: {
+    command: `agenzo-merchant-cli hotel-redaug checkout --order-id E2E1750000000 --fc-order-code FC1750000000 --reason "guest leaving early" --checkout-rooms '[{"room_index":"1","guest_name":"San Zhang","cancel_check_in_date":"2026-07-05"}]' --idempotency-key checkout-h1n2`,
+    output_summary: "Returns task_order_code. Poll hotel-redaug get-checkout --task-order-code <code> until the application is approved/rejected/refunded."
+  },
+  error_recovery: {
+    CHECKOUT_NOT_ALLOWED: "The order state does not permit a check-out application (e.g. not yet confirmed, or already completed). Surface to user; do NOT retry.",
+    HOTEL_ORDER_NOT_FOUND: "Verify --order-id / --fc-order-code from the book response. Do NOT retry.",
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after 5s with the SAME idempotency-key.",
+    PARAM_IDEMPOTENCY_KEY_REQUIRED: "Add a unique --idempotency-key derived from business intent and retry.",
+    PARAM_IDEMPOTENCY_KEY_CONFLICT: "The same idempotency-key was used with different parameters. Retry with the original parameters, or generate a NEW key for the new parameters."
+  }
+};
+var hotelGetCheckoutSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "get-checkout",
+  description: "Poll the status and refund outcome of a check-out application created by checkout. The supplier decides asynchronously; with --watch, keep polling until a terminal refund_status",
+  flags: {
+    "task-order-code": { type: "string", required: true, description: "Check-out application id from checkout (checkout.response.task_order_code)" },
+    watch: { type: "bool", required: false, default: false, description: "Poll until a terminal status, emitting one NDJSON line per update" },
+    "watch-interval": { type: "int", required: false, default: 10, description: "Seconds between polls when --watch is set" },
+    "watch-timeout": { type: "int", required: false, default: 600, description: "Max seconds to poll before giving up" }
+  },
+  response: {
+    task_order_code: { type: "string", description: "Check-out application id." },
+    refund_status: { type: "string", description: "Application/refund status: pending | approved | rejected | refunded." },
+    refund: {
+      type: "object|null",
+      description: "Final refund once approved. Populated only once refund_status is approved or refunded.",
+      properties: {
+        amount: { type: "float", description: "Refunded amount in DECIMAL units." },
+        currency: { type: "string", description: "ISO 4217 currency code." }
+      }
+    }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug get-checkout --task-order-code TASK1750000000",
+    output_summary: "Returns refund_status. Poll every 10s until approved/rejected/refunded; refund appears once approved."
+  },
+  polling: {
+    recommended_interval_seconds: 10,
+    terminal_statuses: ["approved", "rejected", "refunded"],
+    in_progress_statuses: ["pending"],
+    field_availability: {
+      refund: "Populated only once refund_status is approved or refunded."
+    }
+  },
+  error_recovery: {
+    CHECKOUT_TASK_NOT_FOUND: "Verify --task-order-code from the checkout response. Do NOT retry.",
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after 10s."
+  }
+};
+var hotelListOrdersSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "list-orders",
+  description: "List the developer's hotel orders with optional status filtering and pagination",
+  flags: {
+    status: { type: "string", required: false, description: "Filter by order status (e.g. PROCESSING / CONFIRMED / CANCELLED / COMPLETED). Omitted entirely when absent (all statuses)" },
+    page: { type: "int", required: false, default: 1, description: "Page number", constraints: ">= 1" },
+    "page-size": { type: "int", required: false, default: 20, description: "Items per page", constraints: ">= 1 (platform caps at 100 server-side)" }
+  },
+  response: {
+    orders: {
+      type: "array",
+      description: "List of hotel orders (slim list-item shape).",
+      items: {
+        order_id: { type: "string", description: "Our order reference." },
+        fc_order_code: { type: "string", description: "Supplier order reference." },
+        status: { type: "string", description: "Current order status (string)." },
+        provider: { type: "string", description: "Service provider ('redaug')." },
+        check_in: { type: "string|null", description: "Check-in date YYYY-MM-DD." },
+        check_out: { type: "string|null", description: "Check-out date YYYY-MM-DD." },
+        room_num: { type: "int|null", description: "Number of rooms booked." },
+        price_amount: { type: "float|null", description: "Total price in DECIMAL units (NOT cents)." },
+        price_currency: { type: "string", description: "ISO 4217 currency code." },
+        payment_status: { type: "string", description: "Payment status (e.g. 'ON_ACCOUNT')." },
+        hotel_confirm_no: { type: "string|null", description: "Property confirmation number (once confirmed)." },
+        cancellation_fee: { type: "float|null", description: "Cancellation fee for cancelled orders; null otherwise." },
+        refund_amount: { type: "float|null", description: "Amount refunded on cancellation/checkout; null otherwise." },
+        created_at: { type: "string", description: "Order creation time (ISO 8601)." },
+        updated_at: { type: "string", description: "Last update time (ISO 8601)." }
+      }
+    },
+    total: { type: "int", description: "Total matching orders." },
+    page: { type: "int", description: "Current page." },
+    page_size: { type: "int", description: "Items per page." }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug list-orders --status CONFIRMED --page 1 --page-size 10",
+    output_summary: "Returns a paginated list of hotel orders with status, dates and amount info."
+  },
+  error_recovery: {
+    INTERNAL_ERROR: "Transient backend error. Retry once after a short delay.",
+    PARAM_INVALID: "Ensure --page / --page-size are positive integers, then retry."
+  }
+};
+var hotelFindDestinationSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "find-destination",
+  description: "Search for a destination by keyword (city, landmark, airport, etc.). Returns a list of destinations whose destination_id can be passed to search --destination-id or hotel-filters --destination-id",
+  flags: {
+    keyword: { type: "string", required: true, description: "Destination search keyword (city name, landmark, airport code, etc.)" },
+    "data-type": { type: "string", required: false, description: "Optional data type filter to narrow result categories" }
+  },
+  response: {
+    destinations: {
+      type: "array",
+      description: "Matching destinations. Empty when nothing matches the keyword (rendered as a successful empty result, not an error).",
+      items: {
+        destination_id: { type: "string|null", description: "Opaque destination identifier. Pass to search --destination-id or hotel-filters --destination-id." },
+        type: { type: "string|int|null", description: "Destination type (city, landmark, airport, etc.)." },
+        name: { type: "string|null", description: "Destination name." },
+        city_name: { type: "string|null", description: "City name." },
+        city_code: { type: "string|null", description: "City code." },
+        country_name: { type: "string|null", description: "Country name." },
+        lat: { type: "float|null", description: "Latitude (can also be used with search --lat)." },
+        lng: { type: "float|null", description: "Longitude (can also be used with search --lng)." }
+      }
+    }
+  },
+  example: {
+    command: 'agenzo-merchant-cli hotel-redaug find-destination --keyword "Shanghai"',
+    output_summary: "Returns destinations[]. Use destinations[].destination_id in search --destination-id or hotel-filters --destination-id."
+  },
+  error_recovery: {
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after ~2s backoff.",
+    PARAM_INVALID: "Ensure --keyword is non-empty, then retry."
+  }
+};
+var hotelFiltersSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "hotel-filters",
+  description: "Get available filter options (stars, brands, groups, labels, sub-categories, hotel/room facilities) for a location. Each item's code maps directly to the corresponding search filter flag (e.g. hotel_facilities[].code \u2192 search --hotel-facility-codes)",
+  flags: {
+    "destination-id": { type: "string", required: "conditional", description: "Destination ID (alternative to --lat/--lng)", constraints: "Exactly one location branch: --destination-id XOR (--lat + --lng)" },
+    lat: { type: "float", required: "conditional", description: "Latitude (-90 to 90, requires --lng)", constraints: "-90 to 90; mutually exclusive with --destination-id" },
+    lng: { type: "float", required: "conditional", description: "Longitude (-180 to 180, requires --lat)", constraints: "-180 to 180; mutually exclusive with --destination-id" },
+    distance: { type: "int", required: false, default: 20, description: "Search radius in kilometers" }
+  },
+  response: {
+    stars: { type: "array", description: "Star rating options [{code, name, count}]. code \u2192 search --star." },
+    brands: { type: "array", description: "Hotel brand options [{code, name, count}]. code \u2192 search --hotel-brand-codes." },
+    groups: { type: "array", description: "Hotel group options [{code, name, count}]." },
+    labels: { type: "array", description: "Hotel label options [{code, name, count}]. code \u2192 search --hotel-label-ids." },
+    sub_categories: { type: "array", description: "Hotel sub-category options [{code, name, count}]. code \u2192 search --hotel-sub-category-ids." },
+    hotel_facilities: { type: "array", description: "Hotel facility options [{code, name, count, type}]. code \u2192 search --hotel-facility-codes." },
+    room_facilities: { type: "array", description: "Room facility options [{code, name, count, type}]. code \u2192 search --room-facility-codes." }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug hotel-filters --destination-id D12345",
+    output_summary: "Returns filter groups. Use the code values in search filter flags (e.g. search --hotel-facility-codes code1,code2)."
+  },
+  error_recovery: {
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after ~2s backoff.",
+    PARAM_INVALID: "Supply exactly one location branch (--destination-id OR --lat/--lng). Coordinates must be within valid ranges."
+  }
+};
+var hotelListCitiesSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "list-cities",
+  description: "List cities available for hotel booking in a given country. Each city provides a destination_id (for search --destination-id) and/or lat/lng coordinates (for search --lat/--lng)",
+  flags: {
+    country: { type: "string", required: true, description: "ISO country code (e.g. CN, US, TH)" }
+  },
+  response: {
+    cities: {
+      type: "array",
+      description: "Cities for the country. Empty when no cities are available (rendered as success, not an error).",
+      items: {
+        city_code: { type: "string", description: "City code." },
+        city_name: { type: "string", description: "City name." },
+        destination_id: { type: "string|null", description: "Destination ID for this city. Pass to search --destination-id." },
+        province_code: { type: "string|null", description: "Province code." },
+        province_name: { type: "string|null", description: "Province name." },
+        country_code: { type: "string|null", description: "Country code." },
+        country_name: { type: "string|null", description: "Country name." },
+        lat: { type: "float|null", description: "Latitude (can be used with search --lat)." },
+        lng: { type: "float|null", description: "Longitude (can be used with search --lng)." },
+        time_zone: { type: "string|null", description: "Time zone identifier." },
+        popularity_score: { type: "float|null", description: "Popularity score for sorting/ranking." }
+      }
+    }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug list-cities --country CN",
+    output_summary: "Returns cities[]. Use cities[].destination_id in search --destination-id, or cities[].lat/lng in search --lat/--lng."
+  },
+  error_recovery: {
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after ~2s backoff.",
+    PARAM_INVALID: "Ensure --country is a non-empty ISO country code, then retry."
+  }
+};
+var hotelDetailSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "hotel-detail",
+  description: "Get detailed information about a specific hotel including facilities, images, location, check-in/check-out times. Use to show the user hotel details before quoting/booking",
+  flags: {
+    "hotel-id": { type: "string", required: true, description: "Hotel ID from search results (search.response.hotels[].hotel_id)" },
+    "with-images": { type: "bool", required: false, default: true, description: "Include hotel images in the response (set false to reduce payload)" }
+  },
+  response: {
+    hotel_id: { type: "string|int", description: "Hotel identifier." },
+    hotel_name: { type: "string|null", description: "Hotel name." },
+    hotel_eng_name: { type: "string|null", description: "English hotel name." },
+    star: { type: "int|null", description: "Star rating." },
+    address: { type: "string|null", description: "Hotel address." },
+    intro: { type: "string|null", description: "Hotel introduction/description." },
+    appearance_image: { type: "string|null", description: "Main appearance image URL." },
+    telephone: { type: "string|null", description: "Hotel telephone number." },
+    country_name: { type: "string|null", description: "Country name." },
+    province_name: { type: "string|null", description: "Province name." },
+    city_name: { type: "string|null", description: "City name." },
+    district_name: { type: "string|null", description: "District name." },
+    business_name: { type: "string|null", description: "Business area name." },
+    lat: { type: "float|null", description: "Latitude." },
+    lng: { type: "float|null", description: "Longitude." },
+    check_in_time: { type: "string|null", description: "Hotel check-in time." },
+    check_out_time: { type: "string|null", description: "Hotel check-out time." },
+    room_num: { type: "int|null", description: "Number of rooms available." },
+    facilities: {
+      type: "array",
+      description: "Hotel facilities list.",
+      items: {
+        name: { type: "string", description: "Facility name." },
+        type: { type: "string|null", description: "Facility type/category." }
+      }
+    },
+    images: {
+      type: "array",
+      description: "Hotel-level images. Empty array when --with-images false.",
+      items: {
+        url: { type: "string", description: "Image URL." },
+        is_main: { type: "bool", description: "Whether this is the main image." },
+        type: { type: "int|null", description: "Image type/category." }
+      }
+    },
+    rooms: {
+      type: "array",
+      description: "Room types with STATIC info only (area/floor/beds/max occupancy/images) \u2014 NOT live rates. room_id is the SAME id space as quote's roomItems[].roomId, so relate a room here to its live rate/price/product_token by matching room_id to quote's rates. ALWAYS use quote for price/availability/product_token; this verb never has them. Present this alongside quote's rate options so the user sees what the room actually looks like (area, beds, photos) before picking a rate, not just the one-line room_name from quote.",
+      items: {
+        room_id: { type: "int|string|null", description: "Room type id. Matches quote's roomItems[].roomId \u2014 use to relate this room's detail to a specific quoted rate." },
+        room_name: { type: "string|null", description: "Room type name." },
+        area_sqm: { type: "string|null", description: "Room area (upstream unit, commonly square meters), as a string." },
+        floor: { type: "string|null", description: 'Floor(s) this room type is on (may be a range, e.g. "10-15").' },
+        max_person: { type: "int|null", description: "Max total occupancy." },
+        max_adults: { type: "int|null", description: "Max adults." },
+        max_child: { type: "int|null", description: "Max children." },
+        allow_smoking: { type: "bool|null", description: "Whether smoking is allowed in this room type." },
+        beds: {
+          type: "array",
+          description: "Bed configuration for the room area.",
+          items: {
+            name: { type: "string|null", description: 'Bed type name (e.g. "King Bed").' },
+            width: { type: "string|null", description: "Bed width, upstream unit." },
+            num: { type: "string|null", description: "Number of this bed type." }
+          }
+        },
+        living_room_beds: {
+          type: "array",
+          description: "Bed configuration for a separate living-room area, when the room type has one. Same shape as beds.",
+          items: {
+            name: { type: "string|null", description: "Bed type name." },
+            width: { type: "string|null", description: "Bed width, upstream unit." },
+            num: { type: "string|null", description: "Number of this bed type." }
+          }
+        },
+        images: {
+          type: "array",
+          description: "Photos of this specific room type. Empty when --with-images false, or when upstream has none for this room.",
+          items: {
+            url: { type: "string", description: "Image URL." },
+            is_main: { type: "bool", description: "Whether this is the main image for the room." },
+            type: { type: "int|null", description: "Image type/category." }
+          }
+        }
+      }
+    }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug hotel-detail --hotel-id 10583772",
+    output_summary: "Returns full hotel details including facilities, hotel images, AND rooms[] (per-room-type static info + photos). Use to present both the hotel and its room types before quoting \u2014 rooms[].room_id matches quote's roomItems[].roomId so the two can be shown together."
+  },
+  error_recovery: {
+    UPSTREAM_ERROR: "Transient upstream error. Retry once after ~2s backoff.",
+    PARAM_INVALID: "Ensure --hotel-id is a non-empty string, then retry."
+  }
+};
+var ORDERS_NOUN = "orders";
+var unifiedOrdersListSchema = {
+  cli: CLI_NAME,
+  noun: ORDERS_NOUN,
+  verb: "list",
+  description: 'List orders across ALL providers (ride + hotel) in one call. Use this for generic "my orders" / "order history" requests. Prefer ride-elife/hotel-redaug list-orders when the user names a specific business.',
+  flags: {
+    "order-type": { type: "string", required: false, description: "Filter by provider: ride | hotel" },
+    status: { type: "string", required: false, description: "Filter by NORMALIZED status (NOT the domain-specific status): PENDING | CONFIRMED | COMPLETED | CANCELLED | FAILED" },
+    page: { type: "int", required: false, default: 1, description: "Page number", constraints: ">= 1" },
+    "page-size": { type: "int", required: false, default: 20, description: "Items per page", constraints: ">= 1" }
+  },
+  response: {
+    orders: {
+      type: "array",
+      description: "Slim cross-provider order-index items. For business-specific fields (vehicle_class, hotel_name, etc.), call `orders get --order-id <id>` or the domain-specific `get`.",
+      items: {
+        order_id: { type: "string", description: "Order id (rio_... for ride, hho_... for hotel). Pass to `orders get`." },
+        order_type: { type: "string", description: "'ride' or 'hotel'" },
+        status: { type: "string", description: "Normalized status: PENDING | CONFIRMED | COMPLETED | CANCELLED | FAILED" },
+        amount: { type: "float|null", description: "Order amount in DECIMAL currency units (NOT cents)" },
+        currency: { type: "string|null", description: "ISO 4217 currency code" },
+        created_at: { type: "string|null", description: "ISO 8601 datetime" },
+        updated_at: { type: "string|null", description: "ISO 8601 datetime" }
+      }
+    },
+    total: { type: "int", description: "Total matching orders across all providers" },
+    page: { type: "int", description: "Current page" },
+    page_size: { type: "int", description: "Items per page" }
+  },
+  example: {
+    command: "agenzo-merchant-cli orders list --page 1 --page-size 10",
+    output_summary: "Returns a paginated, cross-provider list of orders (both ride and hotel). If the user then asks about one order, use its order_id with `orders get`."
+  },
+  error_recovery: {
+    INVALID_REQUEST: "The --status value is not one of PENDING/CONFIRMED/COMPLETED/CANCELLED/FAILED. Fix and retry.",
+    INTERNAL_ERROR: "Transient backend error. Retry once after a short delay.",
+    PARAM_INVALID: "Ensure --page / --page-size are positive integers, then retry."
+  }
+};
+var unifiedOrdersGetSchema = {
+  cli: CLI_NAME,
+  noun: ORDERS_NOUN,
+  verb: "get",
+  description: "Get a single order detail by id, regardless of which provider (ride/hotel) it belongs to. The platform resolves order_id -> provider internally and returns that provider's own detail shape.",
+  flags: {
+    "order-id": { type: "string", required: true, description: "Order id from `orders list` (rio_... for ride, hho_... for hotel)" }
+  },
+  response: {
+    "(varies by order_type)": {
+      type: "object",
+      description: "The response shape is delegated to the owning provider and therefore varies: a ride order returns the same shape as `ride-elife get`; a hotel order returns the same shape as `hotel-redaug get`. Treat the result as an opaque object and surface whatever fields it contains \u2014 do NOT assume a fixed schema."
+    }
+  },
+  example: {
+    command: "agenzo-merchant-cli orders get --order-id hho_01K...",
+    output_summary: "Returns the order's detail, delegated to its owning provider (ride or hotel)."
+  },
+  error_recovery: {
+    ORDER_NOT_FOUND: "The order_id does not exist or does not belong to this developer/org. Verify the id from `orders list`. Do NOT retry blindly.",
+    INTERNAL_ERROR: "The order's provider detail lookup is temporarily unavailable. Retry once after a short delay."
+  }
+};
 
 // src/ride-elife/quote.ts
 function need(value, flag) {
@@ -1221,6 +1972,17 @@ function num2(value, flag) {
   }
   return n;
 }
+function phone(value, flag) {
+  const raw = need2(value, flag);
+  const cleaned = raw.replace(/[\s-]/g, "");
+  if (!/^\+[1-9]\d{7,14}$/.test(cleaned)) {
+    throw new CliError(
+      "PARAM_INVALID",
+      `--${flag} must be a valid international phone number, e.g. +14155552671.`
+    );
+  }
+  return cleaned;
+}
 function seatCount(value, flag) {
   const n = num2(value, flag);
   if (!Number.isInteger(n) || n < 0 || n > 5) {
@@ -1266,7 +2028,7 @@ function registerBookCommand(parent, deps) {
       price_amount: num2(opts.priceAmount, "price-amount"),
       price_currency: opts.priceCurrency ?? "USD",
       passenger_name: need2(opts.passengerName, "passenger-name"),
-      passenger_phone: need2(opts.passengerPhone, "passenger-phone")
+      passenger_phone: phone(opts.passengerPhone, "passenger-phone")
     };
     if (opts.paymentOrderId) body.payment_order_id = opts.paymentOrderId;
     if (opts.passengerEmail) body.passenger_email = opts.passengerEmail;
@@ -1384,8 +2146,8 @@ function formatGetOrder(data) {
   }
   if (data.driver) {
     const driver = data.driver;
-    const phone = driver.phone_number ? ` (${driver.phone_number})` : "";
-    lines.push(["Driver", `${driver.name ?? "-"}${phone}`]);
+    const phone2 = driver.phone_number ? ` (${driver.phone_number})` : "";
+    lines.push(["Driver", `${driver.name ?? "-"}${phone2}`]);
   }
   if (data.vehicle) {
     const v = data.vehicle;
@@ -1607,96 +2369,1918 @@ var SERVICE_REGISTRY = [
     workflow: ["quote", "book", "get (poll for status)", "cancel (optional)"],
     since: "2026-06-01",
     discovery: { help_command: "agenzo-merchant-cli ride-elife --help" }
-  }
+  },
+  {
+    service_id: "svc_01J0HT5REDAUG0001",
+    name: "Hotel booking (Redaug)",
+    description: "International hotel booking via Redaug: search by location, real-time room/rate availability, two-step create-then-pay flow supporting monthly_settlement and pay_per_call (EVO) billing modes, cancel and partial check-out.",
+    category: "hotel",
+    version: "v1",
+    provider: "redaug",
+    cli_noun: "hotel-redaug",
+    verbs: [
+      "find-destination",
+      "hotel-filters",
+      "list-cities",
+      "search",
+      "hotel-detail",
+      "quote",
+      "create-order",
+      "pay-order",
+      "get",
+      "cancel",
+      "checkout",
+      "get-checkout",
+      "list-orders"
+    ],
+    verb_descriptions: {
+      "find-destination": "Resolve a free-text place into destinations.",
+      "hotel-filters": "Get available filter options for a location.",
+      "list-cities": "List the cities of a country.",
+      search: "Search hotels by destination or coordinates.",
+      "hotel-detail": "Get hotel detail (name/star/address/facilities/photos).",
+      quote: "Get real-time room types and bookable rates for a hotel.",
+      "create-order": "Create a hotel order without charging (locks the rate, no payment).",
+      "pay-order": "Settle a created order by --order-id (path chosen server-side by billing_mode: monthly_settlement or pay_per_call).",
+      get: "Query order status (poll for async confirmation).",
+      cancel: "Cancel an order (whole-order, in-policy).",
+      checkout: "Apply for partial check-out / out-of-policy cancellation.",
+      "get-checkout": "Poll a check-out application status.",
+      "list-orders": "List hotel orders (local store, no upstream call)."
+    },
+    workflow: [
+      "find-destination / list-cities (optional)",
+      "hotel-filters (optional)",
+      "search",
+      "hotel-detail (optional)",
+      "quote",
+      "create-order (locks the rate, no charge)",
+      "pay-order (settles: monthly_settlement or pay_per_call)",
+      "get (poll until CONFIRMED)",
+      "cancel / checkout (optional)"
+    ],
+    since: "2026-06-25",
+    discovery: { help_command: "agenzo-merchant-cli hotel-redaug --help" }
+  }
 ];
 function findService(serviceId) {
   return SERVICE_REGISTRY.find((s) => s.service_id === serviceId);
 }
 
-// src/services/list.ts
-function toListItem(s) {
-  return {
-    service_id: s.service_id,
-    name: s.name,
-    category: s.category,
-    provider: s.provider,
-    cli_noun: s.cli_noun,
-    version: s.version,
-    verbs: s.verbs,
-    since: s.since,
-    discovery: s.discovery
-  };
+// src/services/local-caps.ts
+var NON_SERVICE_NOUNS = /* @__PURE__ */ new Set(["services", "help", "config"]);
+function buildLocalCapabilityMap(program) {
+  const map = {};
+  for (const noun of program.commands) {
+    const name = noun.name();
+    if (NON_SERVICE_NOUNS.has(name)) continue;
+    const verbs = noun.commands.map((v) => v.name()).filter((n) => n !== "help");
+    if (verbs.length === 0) continue;
+    map[name] = verbs;
+  }
+  return map;
+}
+
+// src/services/list.ts
+function toListItem(s) {
+  return {
+    service_id: String(s.service_id ?? ""),
+    name: String(s.name ?? ""),
+    category: String(s.category ?? ""),
+    provider: String(s.provider ?? ""),
+    cli_noun: String(s.cli_noun ?? ""),
+    version: String(s.version ?? ""),
+    verbs: Array.isArray(s.verbs) ? s.verbs : [],
+    since: String(s.since ?? ""),
+    discovery: s.discovery
+  };
+}
+function gateByLocalCommands(capabilities, localCaps) {
+  const gated = [];
+  for (const cap of capabilities) {
+    const localVerbs = localCaps[cap.cli_noun];
+    if (!localVerbs) continue;
+    const usableVerbs = (cap.verbs || []).filter((v) => localVerbs.includes(v));
+    if (usableVerbs.length === 0) continue;
+    gated.push({ ...cap, verbs: usableVerbs });
+  }
+  return gated;
+}
+function registerServicesListCommand(parent, deps) {
+  const cmd = parent.command("list").description("List available merchant services (from platform discovery)").option("--api-key <key>", "API Key for authentication (X-Api-Key)");
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const localCaps = buildLocalCapabilityMap(deps.program);
+    let services;
+    try {
+      const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+        message: "API Key:",
+        type: "password"
+      });
+      const result = await deps.discoveryClient.get("/api/discovery/v1/catalog", { type: "api-key", key: apiKey });
+      if (!result.success) {
+        throw CliError.fromApi(result, { auth: "api-key" });
+      }
+      services = gateByLocalCommands(
+        (result.data.capabilities || []).map(toListItem),
+        localCaps
+      );
+    } catch {
+      services = gateByLocalCommands(
+        SERVICE_REGISTRY.map((s) => toListItem(s)),
+        localCaps
+      );
+    }
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data: { services },
+      text: () => {
+        if (services.length === 0) {
+          return Formatter.status("info", "No services found");
+        }
+        const headers = ["Service ID", "Name", "Category", "Provider", "Version", "Verbs"];
+        const rows = services.map((s) => [
+          s.service_id,
+          s.name,
+          s.category,
+          s.provider,
+          s.version,
+          s.verbs.join(", ")
+        ]);
+        return Formatter.table(headers, rows);
+      }
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/services/get.ts
+function formatServiceGet(s) {
+  const lines = [
+    ["Service ID", String(s.service_id ?? "")],
+    ["Name", String(s.name ?? "")],
+    ["Description", String(s.description ?? s.summary ?? "")],
+    ["Category", String(s.category ?? "")],
+    ["Version", String(s.version ?? "")],
+    ["Provider", String(s.provider ?? "")],
+    ["CLI Noun", String(s.cli_noun ?? "")],
+    ["Verbs", Array.isArray(s.verbs) ? s.verbs.join(", ") : ""]
+  ];
+  if (Array.isArray(s.workflow) && s.workflow.length > 0) {
+    lines.push(["Workflow", s.workflow.join(" \u2192 ")]);
+  }
+  const block = Formatter.keyValue(lines);
+  const verbDescriptions = s.verb_descriptions;
+  if (verbDescriptions && Object.keys(verbDescriptions).length > 0) {
+    const detail = Object.entries(verbDescriptions).map(([verb, desc]) => `  ${verb}: ${desc}`).join("\n");
+    return `${block}
+
+Verb descriptions:
+${detail}`;
+  }
+  return block;
+}
+function gateCapability(data, localCaps) {
+  const noun = String(data.cli_noun ?? "");
+  const localVerbs = localCaps[noun];
+  if (!localVerbs) return null;
+  const out = { ...data };
+  if (Array.isArray(out.verbs)) {
+    out.verbs = out.verbs.filter((v) => localVerbs.includes(v));
+  }
+  const schema = out.schema_content;
+  if (schema && schema.verbs && typeof schema.verbs === "object") {
+    const filtered = {};
+    for (const [verb, def] of Object.entries(schema.verbs)) {
+      if (localVerbs.includes(verb)) filtered[verb] = def;
+    }
+    out.schema_content = { ...schema, verbs: filtered };
+  }
+  return out;
+}
+function registerServiceGetCommand(parent, deps) {
+  const cmd = parent.command("get <service-id>").description("Retrieve a single merchant service by id (includes full schema)").option("--api-key <key>", "API Key for authentication (X-Api-Key)");
+  cmd.action(async (serviceId) => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const localCaps = buildLocalCapabilityMap(deps.program);
+    let data = null;
+    try {
+      const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+        message: "API Key:",
+        type: "password"
+      });
+      const result = await deps.discoveryClient.get(
+        `/api/discovery/v1/catalog/${encodeURIComponent(serviceId)}`,
+        { type: "api-key", key: apiKey }
+      );
+      if (!result.success) {
+        throw CliError.fromApi(result, { auth: "api-key" });
+      }
+      data = gateCapability(result.data, localCaps);
+    } catch {
+      const local = findService(serviceId);
+      data = local ? gateCapability(local, localCaps) : null;
+    }
+    if (data === null) {
+      throw new CliError(
+        "SERVICE_NOT_FOUND",
+        `Service '${serviceId}' is not available in this CLI. Run "services list" to see available services.`
+      );
+    }
+    const resolved = data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data: resolved,
+      text: () => formatServiceGet(resolved)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/orders/list.ts
+var DEFAULT_PAGE2 = "1";
+var DEFAULT_PAGE_SIZE2 = "20";
+function positiveInt2(value, flag) {
+  const n = Number(value);
+  if (!Number.isFinite(n) || !Number.isInteger(n) || n < 1) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a positive integer.`);
+  }
+  return String(n);
+}
+function formatOrders2(data) {
+  const orders = data.orders ?? [];
+  if (orders.length === 0) {
+    return Formatter.status("info", "No orders found");
+  }
+  const headers = ["Order ID", "Type", "Status", "Amount", "Currency"];
+  const rows = orders.map((o) => [
+    String(o.order_id ?? "-"),
+    String(o.order_type ?? "-"),
+    String(o.status ?? "-"),
+    String(o.amount ?? "-"),
+    String(o.currency ?? "-")
+  ]);
+  const summary = [
+    ["Total", String(data.total ?? "-")],
+    ["Page", String(data.page ?? "-")],
+    ["Page size", String(data.page_size ?? "-")]
+  ];
+  return `${Formatter.table(headers, rows)}
+${Formatter.keyValue(summary)}`;
+}
+function registerOrdersListCommand(parent, deps) {
+  const cmd = parent.command("list").description("List orders across ALL providers (ride + hotel), with optional type/status filters").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-type <type>", "Filter by order type: ride | hotel").option("--status <status>", "Filter by normalized status: PENDING | CONFIRMED | COMPLETED | CANCELLED | FAILED").option("--page <page>", "Page number", DEFAULT_PAGE2).option("--page-size <size>", "Page size", DEFAULT_PAGE_SIZE2);
+  attachSchemaHelp(cmd, unifiedOrdersListSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const params = {
+      page: positiveInt2(opts.page ?? DEFAULT_PAGE2, "page"),
+      page_size: positiveInt2(opts.pageSize ?? DEFAULT_PAGE_SIZE2, "page-size")
+    };
+    if (opts.orderType !== void 0) params.order_type = opts.orderType;
+    if (opts.status !== void 0) params.status = opts.status;
+    const spinner = format === "json" ? null : createSpinner("Fetching orders...");
+    const result = await deps.apiClient.get(
+      "/orders",
+      { type: "api-key", key: apiKey },
+      params
+    );
+    spinner?.stop();
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatOrders2(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/orders/get.ts
+function registerOrdersGetCommand(parent, deps) {
+  const cmd = parent.command("get").description("Get a single order detail by id, regardless of provider (ride/hotel)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").requiredOption("--order-id <id>", "Order id (e.g. rio_... or hho_...)");
+  attachSchemaHelp(cmd, unifiedOrdersGetSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const spinner = format === "json" ? null : createSpinner("Fetching order...");
+    const result = await deps.apiClient.get(
+      `/orders/${encodeURIComponent(opts.orderId)}`,
+      { type: "api-key", key: apiKey }
+    );
+    spinner?.stop();
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => Formatter.keyValue(
+        Object.entries(data).map(([k, v]) => [k, typeof v === "object" ? JSON.stringify(v) : String(v)])
+      )
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/search.ts
+function need5(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function num3(value, flag) {
+  const n = Number(need5(value, flag));
+  if (!Number.isFinite(n)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
+  }
+  return n;
+}
+function coord(value, flag, min, max) {
+  const n = num3(value, flag);
+  if (n < min || n > max) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be between ${min} and ${max}.`);
+  }
+  return n;
+}
+function positiveInt3(value, flag) {
+  const n = num3(value, flag);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a positive integer.`);
+  }
+  return n;
+}
+var YMD_RE = /^\d{4}-\d{2}-\d{2}$/;
+function stayDate(value, flag) {
+  const raw = need5(value, flag);
+  if (!YMD_RE.test(raw)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a YYYY-MM-DD date.`);
+  }
+  const [y, m, d] = raw.split("-").map(Number);
+  const dt = new Date(Date.UTC(y, m - 1, d));
+  if (dt.getUTCFullYear() !== y || dt.getUTCMonth() !== m - 1 || dt.getUTCDate() !== d) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a valid calendar date (YYYY-MM-DD).`);
+  }
+  return raw;
+}
+function formatSearch(data) {
+  const hotels = data.hotels ?? [];
+  if (hotels.length === 0) {
+    return Formatter.status("info", "No hotels found for this area and dates");
+  }
+  const headers = ["Hotel ID", "Name", "Star", "Distance (km)", "From", "Currency", "City", "Score", "Image", "Address"];
+  const rows = hotels.map((h) => [
+    String(h.hotel_id ?? "-"),
+    String(h.hotel_name ?? "-"),
+    String(h.star ?? "-"),
+    String(h.distance_km ?? "-"),
+    String(h.lowest_price?.amount ?? "-"),
+    String(h.lowest_price?.currency ?? "-"),
+    String(h.city_name ?? "-"),
+    String(h.score ?? "-"),
+    String(h.main_image ?? "-"),
+    String(h.address ?? "-")
+  ]);
+  return Formatter.table(headers, rows);
+}
+function registerHotelSearchCommand(parent, deps) {
+  const cmd = parent.command("search").description("Search hotels near a coordinate or within a destination for the given stay dates").option("--destination-id <id>", "Destination ID (alternative to --lat/--lng)").option("--lat <lat>", "Latitude of the search center (-90 to 90)").option("--lng <lng>", "Longitude of the search center (-180 to 180)").option("--distance <km>", "Search radius in kilometers", "20").option("--check-in <date>", "Check-in date (YYYY-MM-DD)").option("--check-out <date>", "Check-out date (YYYY-MM-DD, strictly after check-in)").option("--adults <n>", "Number of adults", "2").option("--children <n>", "Number of children", "0").option("--room-num <n>", "Number of rooms requested", "1").option("--star <n>", "Minimum hotel star rating filter (3/4/5)").option("--keyword <text>", "Optional hotel name keyword to narrow results").option("--price-min <n>", "Minimum price filter").option("--price-max <n>", "Maximum price filter").option("--sort-by <field>", "Sort field").option("--page <n>", "Page number (positive integer)", "1").option("--page-size <n>", "Results per page (positive integer)", "10").option("--hotel-facility-codes <codes>", "Hotel facility codes (comma-separated or JSON array)").option("--room-facility-codes <codes>", "Room facility codes (comma-separated or JSON array)").option("--hotel-brand-codes <codes>", "Hotel brand codes (comma-separated or JSON array)").option("--plate-codes <codes>", "Plate codes (comma-separated or JSON array)").option("--hotel-label-ids <ids>", "Hotel label IDs (comma-separated or JSON array)").option("--hotel-sub-category-ids <ids>", "Hotel sub-category IDs (comma-separated or JSON array)").option("--api-key <key>", "API Key for authentication (X-Api-Key)");
+  attachSchemaHelp(cmd, hotelSearchSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const hasDestination = opts.destinationId !== void 0;
+    const hasLat = opts.lat !== void 0;
+    const hasLng = opts.lng !== void 0;
+    const hasCoordBranch = hasLat || hasLng;
+    if (hasDestination && hasCoordBranch) {
+      throw new CliError(
+        "PARAM_INVALID",
+        "Supply either --destination-id OR --lat/--lng, not both."
+      );
+    }
+    if (!hasDestination && !hasCoordBranch) {
+      throw new CliError(
+        "PARAM_INVALID",
+        "Supply either --destination-id OR --lat/--lng (one location branch is required)."
+      );
+    }
+    if (hasCoordBranch && !(hasLat && hasLng)) {
+      throw new CliError(
+        "PARAM_INVALID",
+        "--lat and --lng must both be provided together."
+      );
+    }
+    const checkIn = stayDate(opts.checkIn, "check-in");
+    const checkOut = stayDate(opts.checkOut, "check-out");
+    if (!(checkOut > checkIn)) {
+      throw new CliError("PARAM_INVALID", "--check-out must be strictly after --check-in.");
+    }
+    const page = positiveInt3(opts.page, "page");
+    const pageSize = positiveInt3(opts.pageSize, "page-size");
+    const body = {};
+    if (hasDestination) {
+      body.destination_id = need5(opts.destinationId, "destination-id");
+    } else {
+      body.lat = coord(opts.lat, "lat", -90, 90);
+      body.lng = coord(opts.lng, "lng", -180, 180);
+    }
+    body.distance = num3(opts.distance, "distance");
+    body.check_in = checkIn;
+    body.check_out = checkOut;
+    body.adults = num3(opts.adults, "adults");
+    body.children = num3(opts.children, "children");
+    body.room_num = num3(opts.roomNum, "room-num");
+    if (opts.star !== void 0) body.star = num3(opts.star, "star");
+    if (opts.keyword !== void 0) body.keyword = opts.keyword;
+    if (opts.priceMin !== void 0) body.price_min = num3(opts.priceMin, "price-min");
+    if (opts.priceMax !== void 0) body.price_max = num3(opts.priceMax, "price-max");
+    if (opts.sortBy !== void 0) body.sort_by = opts.sortBy;
+    body.page = page;
+    body.page_size = pageSize;
+    if (opts.hotelFacilityCodes !== void 0) body.hotel_facility_codes = opts.hotelFacilityCodes;
+    if (opts.roomFacilityCodes !== void 0) body.room_facility_codes = opts.roomFacilityCodes;
+    if (opts.hotelBrandCodes !== void 0) body.hotel_brand_codes = opts.hotelBrandCodes;
+    if (opts.plateCodes !== void 0) body.plate_codes = opts.plateCodes;
+    if (opts.hotelLabelIds !== void 0) body.hotel_label_ids = opts.hotelLabelIds;
+    if (opts.hotelSubCategoryIds !== void 0) body.hotel_sub_category_ids = opts.hotelSubCategoryIds;
+    const result = await deps.apiClient.post(
+      "/hotel/search",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatSearch(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/quote.ts
+function need6(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function num4(value, flag) {
+  const n = Number(need6(value, flag));
+  if (!Number.isFinite(n)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
+  }
+  return n;
+}
+var YMD_RE2 = /^\d{4}-\d{2}-\d{2}$/;
+function stayDate2(value, flag) {
+  const raw = need6(value, flag);
+  if (!YMD_RE2.test(raw)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a YYYY-MM-DD date.`);
+  }
+  const [y, m, d] = raw.split("-").map(Number);
+  const dt = new Date(Date.UTC(y, m - 1, d));
+  if (dt.getUTCFullYear() !== y || dt.getUTCMonth() !== m - 1 || dt.getUTCDate() !== d) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a valid calendar date (YYYY-MM-DD).`);
+  }
+  return raw;
+}
+function summarizePriceItems(items) {
+  if (!items || items.length === 0) return "-";
+  return items.map((it) => `${it.sale_date}: ${it.sale_price} (bf ${it.breakfast_num})`).join("; ");
+}
+function formatQuote2(data) {
+  const rates = data.rates ?? [];
+  if (rates.length === 0) {
+    return Formatter.status("info", "No bookable rates for this hotel and dates");
+  }
+  const headers = ["Product Token", "Room", "Total", "Currency", "Per-night (price_items)"];
+  const rows = rates.map((r) => [
+    String(r.product_token ?? "-"),
+    String(r.room_name ?? "-"),
+    String(r.total_price?.amount ?? "-"),
+    String(r.total_price?.currency ?? "-"),
+    summarizePriceItems(r.price_items)
+  ]);
+  return Formatter.table(headers, rows);
+}
+function registerHotelQuoteCommand(parent, deps) {
+  const cmd = parent.command("quote").description("Get real-time room types and bookable rates for one hotel and stay").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--hotel-id <id>", "Hotel chosen from search results (hotels[].hotel_id)").option("--check-in <date>", "Check-in date (YYYY-MM-DD, match search)").option("--check-out <date>", "Check-out date (YYYY-MM-DD, strictly after check-in)").option("--adults <n>", "Number of adults per room", "2").option("--children <n>", "Number of children per room", "0").option("--room-num <n>", "Number of rooms requested", "1").option("--nationality <code>", "Guest nationality (ISO country code)", "CN");
+  attachSchemaHelp(cmd, hotelQuoteSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const hotelId = need6(opts.hotelId, "hotel-id");
+    const checkIn = stayDate2(opts.checkIn, "check-in");
+    const checkOut = stayDate2(opts.checkOut, "check-out");
+    if (!(checkOut > checkIn)) {
+      throw new CliError("PARAM_INVALID", "--check-out must be strictly after --check-in.");
+    }
+    const body = {
+      hotel_id: hotelId,
+      check_in: checkIn,
+      check_out: checkOut,
+      adults: num4(opts.adults, "adults"),
+      children: num4(opts.children, "children"),
+      room_num: num4(opts.roomNum, "room-num"),
+      nationality: opts.nationality
+    };
+    const result = await deps.apiClient.post(
+      "/hotel/quote",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatQuote2(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/create-order.ts
+import { confirm as confirm3 } from "@inquirer/prompts";
+function parsePriceItems(raw) {
+  const INVALID = "--price-items must be a JSON array of {sale_date (string), sale_price (number), breakfast_num (number)}.";
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new CliError("PARAM_INVALID", INVALID);
+  }
+  if (!Array.isArray(parsed)) {
+    throw new CliError("PARAM_INVALID", INVALID);
+  }
+  for (const el of parsed) {
+    if (typeof el !== "object" || el === null || Array.isArray(el)) {
+      throw new CliError("PARAM_INVALID", INVALID);
+    }
+    const item = el;
+    if (typeof item.sale_date !== "string" || typeof item.sale_price !== "number" || typeof item.breakfast_num !== "number") {
+      throw new CliError("PARAM_INVALID", INVALID);
+    }
+  }
+  return parsed;
+}
+function need7(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function num5(value, flag) {
+  const n = Number(need7(value, flag));
+  if (!Number.isFinite(n)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
+  }
+  return n;
+}
+var YMD_RE3 = /^\d{4}-\d{2}-\d{2}$/;
+function stayDate3(value, flag) {
+  const raw = need7(value, flag);
+  if (!YMD_RE3.test(raw)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a YYYY-MM-DD date.`);
+  }
+  const [y, m, d] = raw.split("-").map(Number);
+  const dt = new Date(Date.UTC(y, m - 1, d));
+  if (dt.getUTCFullYear() !== y || dt.getUTCMonth() !== m - 1 || dt.getUTCDate() !== d) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a valid calendar date (YYYY-MM-DD).`);
+  }
+  return raw;
+}
+function formatCreateOrder(data) {
+  const lines = [
+    ["Order ID", String(data.order_id ?? "-")],
+    ["FC order code", String(data.fc_order_code ?? "-")],
+    ["Order status", String(data.order_status ?? "-")],
+    ["Total amount", `${data.total_amount} ${data.currency}`]
+  ];
+  const out = [Formatter.keyValue(lines)];
+  const rooms = data.rooms ?? [];
+  if (rooms.length > 0) {
+    const headers = ["Room index", "Guest name"];
+    const rows = rooms.map((r) => [String(r.room_index ?? "-"), String(r.guest_name ?? "-")]);
+    out.push("", Formatter.table(headers, rows));
+  }
+  out.push(
+    "",
+    Formatter.status(
+      "info",
+      `Order created with status AWAITING_PAYMENT \u2014 proceed with 'hotel-redaug pay-order --order-id ${data.order_id ?? "<order_id>"}' to settle.`
+    )
+  );
+  return out.join("\n");
+}
+function registerHotelCreateOrderCommand(parent, deps) {
+  const cmd = parent.command("create-order").description("Create a hotel order without charging (lock inventory, await payment)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--product-token <token>", "Chosen rate token from quote (rates[].product_token)").option("--total-amount <amount>", "Total stay price in decimal currency units (not cents)").option("--currency <currency>", "ISO 4217 currency code from the chosen rate").option("--price-items <json>", "Per-night price breakdown JSON array (copied verbatim from quote)").option("--check-in <date>", "Check-in date (YYYY-MM-DD, match quote)").option("--check-out <date>", "Check-out date (YYYY-MM-DD, strictly after check-in)").option("--room-num <n>", "Number of rooms (match quote)", "1").option("--adults <n>", "Adults per room (match quote)", "2").option("--children <n>", "Children per room (match quote)", "0").option("--nationality <code>", "Guest nationality (ISO country code)", "CN").option("--guest-name <name>", "Primary guest name").option("--contact-name <name>", "Booking contact name (may equal guest-name)").option("--contact-phone <phone>", "Booking contact phone number (digits)").option("--contact-country-code <code>", "Phone country calling code without '+'", "86").option("--contact-email <email>", "Booking contact email").option("--arrive-time <time>", "Expected arrival time (HH:mm, hotel local time)").option("--special-requests <text>", "Free-text special requests (non-binding)").option("--hotel-name <name>", "Hotel name (display-only, stored for order summary)").option(
+    "--idempotency-key <key>",
+    "Idempotency key forwarded verbatim as the Idempotency-Key header"
+  );
+  attachSchemaHelp(cmd, hotelCreateOrderSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const productToken = need7(opts.productToken, "product-token");
+    const totalAmount = num5(opts.totalAmount, "total-amount");
+    const currency = need7(opts.currency, "currency");
+    const priceItems = parsePriceItems(need7(opts.priceItems, "price-items"));
+    const checkIn = stayDate3(opts.checkIn, "check-in");
+    const checkOut = stayDate3(opts.checkOut, "check-out");
+    if (!(checkOut > checkIn)) {
+      throw new CliError("PARAM_INVALID", "--check-out must be strictly after --check-in.");
+    }
+    const guestName = need7(opts.guestName, "guest-name");
+    const contactName = need7(opts.contactName, "contact-name");
+    const contactPhone = need7(opts.contactPhone, "contact-phone");
+    const body = {
+      product_token: productToken,
+      total_amount: totalAmount,
+      currency,
+      price_items: priceItems,
+      check_in: checkIn,
+      check_out: checkOut,
+      room_num: num5(opts.roomNum, "room-num"),
+      adults: num5(opts.adults, "adults"),
+      children: num5(opts.children, "children"),
+      nationality: opts.nationality,
+      guest_name: guestName,
+      contact_name: contactName,
+      contact_phone: contactPhone,
+      contact_country_code: opts.contactCountryCode
+    };
+    if (opts.contactEmail !== void 0) body.contact_email = opts.contactEmail;
+    if (opts.arriveTime !== void 0) body.arrive_time = opts.arriveTime;
+    if (opts.specialRequests !== void 0) body.special_requests = opts.specialRequests;
+    if (opts.hotelName !== void 0) body.hotel_name = opts.hotelName;
+    if (!isYes) {
+      const confirmed = await confirm3({
+        message: `Create this hotel order for ${totalAmount} ${currency} (check-in ${checkIn}, check-out ${checkOut})? This locks the rate but does NOT charge anything yet.`,
+        default: false
+      });
+      if (!confirmed) {
+        throw new CliError("CLIENT_ABORTED", "Order creation aborted by user.");
+      }
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "hotel-redaug create-order"
+    });
+    const spinner = format === "json" ? null : createSpinner("Creating hotel order...");
+    const result = await deps.apiClient.post(
+      "/hotel/create-order",
+      { type: "api-key", key: apiKey },
+      body,
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatCreateOrder(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/pay-order.ts
+import { confirm as confirm4 } from "@inquirer/prompts";
+
+// src/hotel-redaug/watch.ts
+var DEFAULT_ORDER_WATCH_INTERVAL_SECONDS = 5;
+var DEFAULT_CHECKOUT_WATCH_INTERVAL_SECONDS = 10;
+var DEFAULT_WATCH_TIMEOUT_SECONDS2 = 600;
+var HOTEL_TERMINAL_ORDER_CODES = /* @__PURE__ */ new Set([3, 4, 5]);
+var HOTEL_TERMINAL_ORDER_STATUS = /* @__PURE__ */ new Set([
+  "CONFIRMED",
+  "CANCELLED",
+  "COMPLETED"
+]);
+function orderStatusCodeOf(record) {
+  const code = record.order_status_code;
+  return typeof code === "number" ? code : void 0;
+}
+function orderStatusOf(record) {
+  const status = record.order_status;
+  return typeof status === "string" ? status : void 0;
+}
+function isTerminalOrderStatus(record) {
+  const code = orderStatusCodeOf(record);
+  if (code !== void 0 && HOTEL_TERMINAL_ORDER_CODES.has(code)) {
+    return true;
+  }
+  const status = orderStatusOf(record);
+  return status !== void 0 && HOTEL_TERMINAL_ORDER_STATUS.has(status);
+}
+function lastOrderStatusOf(record) {
+  return orderStatusOf(record) ?? orderStatusCodeOf(record) ?? null;
+}
+var CHECKOUT_TERMINAL_REFUND = /* @__PURE__ */ new Set([
+  "approved",
+  "rejected",
+  "refunded"
+]);
+function refundStatusOf(record) {
+  const status = record.refund_status;
+  return typeof status === "string" ? status : void 0;
+}
+function isTerminalRefundStatus(record) {
+  const status = refundStatusOf(record);
+  return status !== void 0 && CHECKOUT_TERMINAL_REFUND.has(status);
+}
+function lastRefundStatusOf(record) {
+  return refundStatusOf(record) ?? null;
+}
+async function runHotelWatch(deps, opts) {
+  const deadline = deps.now() + opts.timeoutMs;
+  for (; ; ) {
+    const record = await deps.fetchStatus();
+    deps.writeLine(record);
+    if (deps.isTerminal(record)) {
+      return;
+    }
+    if (deps.now() + opts.intervalMs >= deadline) {
+      const timeoutLine = {
+        watch_status: "timeout",
+        message: `Polling stopped after ${opts.timeoutMs / 1e3}s without reaching a terminal status.`,
+        last_status: deps.lastStatusOf(record)
+      };
+      deps.writeLine(timeoutLine);
+      return;
+    }
+    await deps.sleep(opts.intervalMs);
+  }
+}
+async function watchOrderStatus(apiClient, apiKey, orderId, opts) {
+  const path = `/hotel/${encodeURIComponent(orderId)}/status`;
+  await runHotelWatch(
+    {
+      fetchStatus: async () => {
+        const result = await apiClient.get(path, {
+          type: "api-key",
+          key: apiKey
+        });
+        if (!result.success) {
+          throw CliError.fromApi(result, { auth: "api-key" });
+        }
+        return result.data;
+      },
+      writeLine: ndjsonWriteLine,
+      sleep: realSleep,
+      now: () => Date.now(),
+      isTerminal: isTerminalOrderStatus,
+      lastStatusOf: lastOrderStatusOf
+    },
+    {
+      intervalMs: opts.intervalSeconds * 1e3,
+      timeoutMs: opts.timeoutSeconds * 1e3
+    }
+  );
+}
+async function watchCheckoutStatus(apiClient, apiKey, taskOrderCode, opts) {
+  const path = `/hotel/checkout/${encodeURIComponent(taskOrderCode)}`;
+  await runHotelWatch(
+    {
+      fetchStatus: async () => {
+        const result = await apiClient.get(path, {
+          type: "api-key",
+          key: apiKey
+        });
+        if (!result.success) {
+          throw CliError.fromApi(result, { auth: "api-key" });
+        }
+        return result.data;
+      },
+      writeLine: ndjsonWriteLine,
+      sleep: realSleep,
+      now: () => Date.now(),
+      isTerminal: isTerminalRefundStatus,
+      lastStatusOf: lastRefundStatusOf
+    },
+    {
+      intervalMs: opts.intervalSeconds * 1e3,
+      timeoutMs: opts.timeoutSeconds * 1e3
+    }
+  );
+}
+
+// src/hotel-redaug/pay-order.ts
+var DEFAULT_PAY_WATCH_INTERVAL_SECONDS = 5;
+var DEFAULT_PAY_WATCH_TIMEOUT_SECONDS = 300;
+function formatPayOrder(data) {
+  const lines = [
+    ["Order ID", String(data.order_id ?? "-")],
+    ["Order status", String(data.order_status ?? "-")]
+  ];
+  if (data.settlement_path) lines.push(["Settlement path", String(data.settlement_path)]);
+  if (data.pay_status) lines.push(["Pay status", String(data.pay_status)]);
+  if (data.total_amount != null && data.currency) {
+    lines.push(["Amount", `${data.total_amount} ${data.currency}`]);
+  }
+  if (data.billing_entry_id) lines.push(["Billing entry", String(data.billing_entry_id)]);
+  if (data.merchant_trans_id) lines.push(["Merchant trans ID", String(data.merchant_trans_id)]);
+  return Formatter.keyValue(lines);
+}
+function isPaymentTerminal(record) {
+  const status = record.order_status;
+  return status === "PAID";
+}
+function registerHotelPayOrderCommand(parent, deps) {
+  const cmd = parent.command("pay-order").description("Settle an existing hotel order (path decided by billing_mode: monthly_settlement or pay_per_call)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-id <id>", "Order ID to pay (from create-order response)").option(
+    "--idempotency-key <key>",
+    "Idempotency key forwarded verbatim as the Idempotency-Key header"
+  ).option("--watch", "Poll until PAID or timeout (NDJSON output)", false).option(
+    "--watch-interval <seconds>",
+    "Seconds between polls when --watch is set",
+    String(DEFAULT_PAY_WATCH_INTERVAL_SECONDS)
+  ).option(
+    "--watch-timeout <seconds>",
+    "Max seconds to poll before giving up",
+    String(DEFAULT_PAY_WATCH_TIMEOUT_SECONDS)
+  );
+  attachSchemaHelp(cmd, hotelPayOrderSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const orderId = opts.orderId;
+    if (orderId === void 0) {
+      throw new CliError("PARAM_INVALID", "Missing required --order-id.");
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "hotel-redaug pay-order"
+    });
+    const watchEnabled = Boolean(opts.watch);
+    const watchInterval = resolveSeconds(opts.watchInterval, DEFAULT_PAY_WATCH_INTERVAL_SECONDS);
+    const watchTimeout = resolveSeconds(opts.watchTimeout, DEFAULT_PAY_WATCH_TIMEOUT_SECONDS);
+    const body = {};
+    if (!isYes) {
+      const confirmed = await confirm4({
+        message: `Settle hotel order ${orderId}? This moves money via the order's configured billing mode (monthly_settlement or pay_per_call).`,
+        default: false
+      });
+      if (!confirmed) {
+        throw new CliError("CLIENT_ABORTED", "Payment aborted by user.");
+      }
+    }
+    const path = `/hotel/${encodeURIComponent(orderId)}/pay`;
+    const headers = { "Idempotency-Key": idempotencyKey };
+    const auth = { type: "api-key", key: apiKey };
+    if (!watchEnabled) {
+      const spinner = format === "json" ? null : createSpinner("Paying hotel order...");
+      const result = await deps.apiClient.post(
+        path,
+        auth,
+        body,
+        headers
+      );
+      spinner?.stop();
+      if (!result.success) {
+        throw CliError.fromApi(result, { auth: "api-key" });
+      }
+      const data = result.data;
+      const configManager = new ConfigManager();
+      const commandResult = {
+        data,
+        text: () => formatPayOrder(data)
+      };
+      await renderWithContext(commandResult, { format }, configManager);
+    } else {
+      const deadline = Date.now() + watchTimeout * 1e3;
+      let lastRecord = null;
+      for (; ; ) {
+        const result = await deps.apiClient.post(
+          path,
+          auth,
+          body,
+          headers
+        );
+        if (result.success) {
+          const data = result.data;
+          lastRecord = data;
+          ndjsonWriteLine(data);
+          if (isPaymentTerminal(data)) {
+            return;
+          }
+        } else {
+          const errorCode = result.code ?? result.errorCode;
+          const errorCodeStr = String(errorCode);
+          if (errorCodeStr === "PAYMENT_NOT_COMPLETED" || errorCodeStr === "1933") {
+            const errorLine = {
+              watch_status: "pending",
+              error_code: errorCodeStr === "1933" ? "PAYMENT_NOT_COMPLETED" : errorCodeStr,
+              message: result.errorMessage ?? "Payment not yet completed"
+            };
+            lastRecord = errorLine;
+            ndjsonWriteLine(errorLine);
+          } else {
+            throw CliError.fromApi(result, { auth: "api-key" });
+          }
+        }
+        if (Date.now() + watchInterval * 1e3 >= deadline) {
+          const timeoutLine = {
+            watch_status: "timeout",
+            message: `Polling stopped after ${watchTimeout}s without reaching PAID status.`,
+            last_status: lastRecord
+          };
+          ndjsonWriteLine(timeoutLine);
+          return;
+        }
+        await realSleep(watchInterval * 1e3);
+      }
+    }
+  });
+}
+
+// src/hotel-redaug/get.ts
+function need8(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function formatGetOrder2(data) {
+  const lines = [
+    ["Order ID", String(data.order_id ?? "-")],
+    ["FC Order Code", String(data.fc_order_code ?? "-")],
+    ["Status", String(data.order_status ?? "-")]
+  ];
+  if (data.order_status_code !== void 0) {
+    lines.push(["Status code", String(data.order_status_code)]);
+  }
+  if (data.hotel_confirm_no !== void 0 && data.hotel_confirm_no !== null) {
+    lines.push(["Hotel confirm no", String(data.hotel_confirm_no)]);
+  }
+  if (data.hotel_name) lines.push(["Hotel", String(data.hotel_name)]);
+  if (data.room_name) lines.push(["Room", String(data.room_name)]);
+  if (data.check_in) lines.push(["Check-in", String(data.check_in)]);
+  if (data.check_out) lines.push(["Check-out", String(data.check_out)]);
+  if (data.total_amount !== void 0 && data.total_amount !== null) {
+    lines.push(["Total amount", String(data.total_amount)]);
+  }
+  if (data.channel_state) lines.push(["Channel state", String(data.channel_state)]);
+  if (data.source) lines.push(["Source", String(data.source)]);
+  return Formatter.keyValue(lines);
+}
+function registerHotelGetCommand(parent, deps) {
+  const cmd = parent.command("get").description("Retrieve a hotel order status by id (repeatable for polling)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-id <id>", "Our order reference (coOrderCode) returned by `hotel-redaug create-order`").option("--watch", "Poll until a terminal status, emitting one NDJSON line per update").option(
+    "--watch-interval <seconds>",
+    `Seconds between polls when --watch is set (default ${DEFAULT_ORDER_WATCH_INTERVAL_SECONDS})`
+  ).option(
+    "--watch-timeout <seconds>",
+    `Max seconds to poll before giving up (default ${DEFAULT_WATCH_TIMEOUT_SECONDS2})`
+  );
+  attachSchemaHelp(cmd, hotelGetSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const orderId = need8(opts.orderId, "order-id");
+    if (opts.watch) {
+      await watchOrderStatus(deps.apiClient, apiKey, orderId, {
+        intervalSeconds: resolveSeconds(
+          opts.watchInterval,
+          DEFAULT_ORDER_WATCH_INTERVAL_SECONDS
+        ),
+        timeoutSeconds: resolveSeconds(
+          opts.watchTimeout,
+          DEFAULT_WATCH_TIMEOUT_SECONDS2
+        )
+      });
+      return;
+    }
+    const spinner = format === "json" ? null : createSpinner("Fetching hotel order status...");
+    const result = await deps.apiClient.get(
+      `/hotel/${encodeURIComponent(orderId)}/status`,
+      { type: "api-key", key: apiKey }
+    );
+    spinner?.stop();
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatGetOrder2(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/cancel.ts
+import { confirm as confirm5 } from "@inquirer/prompts";
+function need9(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function formatCancel2(data) {
+  const lines = [
+    ["Order ID", String(data.order_id ?? "-")],
+    ["Order status", String(data.order_status ?? "-")]
+  ];
+  if (data.cancel_status !== void 0) {
+    lines.push(["Cancel status", String(data.cancel_status)]);
+  }
+  if (data.cancellation) {
+    const c = data.cancellation;
+    const cur = c.currency ? ` ${c.currency}` : "";
+    if (c.cancellation_fee !== void 0) {
+      lines.push(["Cancellation fee", `${c.cancellation_fee}${cur}`]);
+    }
+    if (c.reversal_amount !== void 0) {
+      lines.push(["Reversal amount", `${c.reversal_amount}${cur}`]);
+    }
+  } else if (data.cancellation_fee !== void 0 && data.cancellation_fee !== null) {
+    lines.push(["Cancellation fee", String(data.cancellation_fee)]);
+  }
+  if (data.refund_amount !== void 0 && data.refund_amount !== null) {
+    lines.push(["Refund amount", String(data.refund_amount)]);
+  }
+  const out = [Formatter.keyValue(lines)];
+  out.push(
+    "",
+    Formatter.status(
+      "info",
+      `A successful response is acceptance only, NOT proof of cancellation \u2014 poll 'hotel-redaug get --order-id ${data.order_id ?? "<order_id>"}' until order_status=CANCELLED (code 4) to confirm.`
+    )
+  );
+  return out.join("\n");
+}
+function registerHotelCancelCommand(parent, deps) {
+  const cmd = parent.command("cancel").description("Cancel a whole hotel order within its policy (a cancellation fee may apply)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-id <id>", "Our order reference (coOrderCode) to cancel (book.response.order_id)").option("--fc-order-code <code>", "Supplier order reference (book.response.fc_order_code)").option("--reason <text>", "Cancellation reason").option(
+    "--idempotency-key <key>",
+    "Idempotency key forwarded verbatim as the Idempotency-Key header"
+  );
+  attachSchemaHelp(cmd, hotelCancelSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const orderId = need9(opts.orderId, "order-id");
+    const fcOrderCode = need9(opts.fcOrderCode, "fc-order-code");
+    const body = { fc_order_code: fcOrderCode };
+    if (opts.reason !== void 0) body.reason = opts.reason;
+    if (!isYes) {
+      const confirmed = await confirm5({
+        message: `Cancel hotel order ${orderId}? A cancellation fee may apply.`,
+        default: false
+      });
+      if (!confirmed) {
+        throw new CliError("CLIENT_ABORTED", "Cancellation aborted by user.");
+      }
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "hotel-redaug cancel"
+    });
+    const spinner = format === "json" ? null : createSpinner("Cancelling hotel order...");
+    const result = await deps.apiClient.post(
+      `/hotel/${encodeURIComponent(orderId)}/cancel`,
+      { type: "api-key", key: apiKey },
+      body,
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatCancel2(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/checkout.ts
+import { confirm as confirm6 } from "@inquirer/prompts";
+function need10(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function num6(value, flag) {
+  const n = Number(need10(value, flag));
+  if (!Number.isFinite(n)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
+  }
+  return n;
+}
+function parseCheckoutRooms(raw) {
+  const INVALID = "--checkout-rooms must be a JSON array of {room_index (string), guest_name (string), cancel_check_in_date (string)}.";
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new CliError("PARAM_INVALID", INVALID);
+  }
+  if (!Array.isArray(parsed)) {
+    throw new CliError("PARAM_INVALID", INVALID);
+  }
+  for (const el of parsed) {
+    if (typeof el !== "object" || el === null || Array.isArray(el)) {
+      throw new CliError("PARAM_INVALID", INVALID);
+    }
+    const room = el;
+    if (typeof room.room_index !== "string" || typeof room.guest_name !== "string" || typeof room.cancel_check_in_date !== "string") {
+      throw new CliError("PARAM_INVALID", INVALID);
+    }
+  }
+  return parsed;
+}
+function formatCheckout(data) {
+  const lines = [
+    ["Order ID", String(data.order_id ?? "-")],
+    ["Task order code", String(data.task_order_code ?? "-")]
+  ];
+  if (data.apply_status !== void 0 && data.apply_status !== null) {
+    lines.push(["Apply status", String(data.apply_status)]);
+  }
+  if (data.checkout_status !== void 0) {
+    lines.push(["Checkout status", String(data.checkout_status)]);
+  }
+  const out = [Formatter.keyValue(lines)];
+  out.push(
+    "",
+    Formatter.status(
+      "info",
+      `Check-out is ASYNC \u2014 this response is acceptance only, NOT proof of refund. Poll 'hotel-redaug get-checkout --task-order-code ${data.task_order_code ?? "<task_order_code>"}' until refund_status is approved/rejected/refunded.`
+    )
+  );
+  return out.join("\n");
+}
+function registerHotelCheckoutCommand(parent, deps) {
+  const cmd = parent.command("checkout").description("Request a partial check-out or an out-of-policy cancellation (async; the property must approve)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-id <id>", "Our order reference (coOrderCode) for the URL path (book.response.order_id)").option("--fc-order-code <code>", "Supplier order reference of the booking to change (book.response.fc_order_code)").option("--reason <text>", "Why the partial check-out / out-of-policy cancellation is requested").option(
+    "--checkout-rooms <json>",
+    "Rooms to check out of as a JSON array of {room_index, guest_name, cancel_check_in_date} (room_index/guest_name copied verbatim from book.response.rooms[])"
+  ).option("--refund-type <type>", "Requested refund handling (upstream refund-type code)", "1").option(
+    "--idempotency-key <key>",
+    "Idempotency key forwarded verbatim as the Idempotency-Key header"
+  );
+  attachSchemaHelp(cmd, hotelCheckoutSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const orderId = need10(opts.orderId, "order-id");
+    const fcOrderCode = need10(opts.fcOrderCode, "fc-order-code");
+    const reason = need10(opts.reason, "reason");
+    const checkoutRooms = parseCheckoutRooms(need10(opts.checkoutRooms, "checkout-rooms"));
+    const refundType = num6(opts.refundType, "refund-type");
+    const body = {
+      fc_order_code: fcOrderCode,
+      reason,
+      refund_type: refundType,
+      checkout_rooms: checkoutRooms
+    };
+    if (!isYes) {
+      const confirmed = await confirm6({
+        message: `Request check-out / out-of-policy cancellation for order ${orderId} (${checkoutRooms.length} room(s))? The property must approve and charges may apply.`,
+        default: false
+      });
+      if (!confirmed) {
+        throw new CliError("CLIENT_ABORTED", "Check-out application aborted by user.");
+      }
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "hotel-redaug checkout"
+    });
+    const spinner = format === "json" ? null : createSpinner("Submitting check-out application...");
+    const result = await deps.apiClient.post(
+      `/hotel/${encodeURIComponent(orderId)}/checkout`,
+      { type: "api-key", key: apiKey },
+      body,
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatCheckout(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/get-checkout.ts
+function need11(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function formatGetCheckout(data) {
+  const lines = [
+    ["Task order code", String(data.task_order_code ?? "-")],
+    ["Refund status", String(data.refund_status ?? "-")]
+  ];
+  if (data.refund !== void 0 && data.refund !== null) {
+    lines.push(["Refund amount", String(data.refund.amount)]);
+    lines.push(["Refund currency", String(data.refund.currency)]);
+  }
+  return Formatter.keyValue(lines);
+}
+function registerHotelGetCheckoutCommand(parent, deps) {
+  const cmd = parent.command("get-checkout").description("Retrieve a check-out application status and refund outcome (repeatable for polling)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option(
+    "--task-order-code <code>",
+    "Check-out application id returned by `hotel-redaug checkout`"
+  ).option("--watch", "Poll until a terminal status, emitting one NDJSON line per update").option(
+    "--watch-interval <seconds>",
+    `Seconds between polls when --watch is set (default ${DEFAULT_CHECKOUT_WATCH_INTERVAL_SECONDS})`
+  ).option(
+    "--watch-timeout <seconds>",
+    `Max seconds to poll before giving up (default ${DEFAULT_WATCH_TIMEOUT_SECONDS2})`
+  );
+  attachSchemaHelp(cmd, hotelGetCheckoutSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const taskOrderCode = need11(opts.taskOrderCode, "task-order-code");
+    if (opts.watch) {
+      await watchCheckoutStatus(deps.apiClient, apiKey, taskOrderCode, {
+        intervalSeconds: resolveSeconds(
+          opts.watchInterval,
+          DEFAULT_CHECKOUT_WATCH_INTERVAL_SECONDS
+        ),
+        timeoutSeconds: resolveSeconds(
+          opts.watchTimeout,
+          DEFAULT_WATCH_TIMEOUT_SECONDS2
+        )
+      });
+      return;
+    }
+    const spinner = format === "json" ? null : createSpinner("Fetching check-out application status...");
+    const result = await deps.apiClient.get(
+      `/hotel/checkout/${encodeURIComponent(taskOrderCode)}`,
+      { type: "api-key", key: apiKey }
+    );
+    spinner?.stop();
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatGetCheckout(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/list-orders.ts
+var DEFAULT_PAGE3 = "1";
+var DEFAULT_PAGE_SIZE3 = "20";
+function positiveInt4(value, flag) {
+  const n = Number(value);
+  if (!Number.isFinite(n) || !Number.isInteger(n) || n < 1) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a positive integer.`);
+  }
+  return String(n);
+}
+function formatOrders3(data) {
+  const orders = data.orders ?? [];
+  if (orders.length === 0) {
+    return Formatter.status("info", "No hotel orders found");
+  }
+  const headers = ["Order ID", "FC Order Code", "Status", "Check-in", "Check-out", "Price", "Payment"];
+  const rows = orders.map((o) => [
+    String(o.order_id ?? "-"),
+    String(o.fc_order_code ?? "-"),
+    String(o.status ?? "-"),
+    String(o.check_in ?? "-"),
+    String(o.check_out ?? "-"),
+    o.price_amount != null ? `${o.price_amount} ${o.price_currency ?? ""}`.trim() : "-",
+    String(o.payment_status ?? "-")
+  ]);
+  const summary = [
+    ["Total", String(data.total ?? "-")],
+    ["Page", String(data.page ?? "-")],
+    ["Page size", String(data.page_size ?? "-")]
+  ];
+  return `${Formatter.table(headers, rows)}
+${Formatter.keyValue(summary)}`;
 }
-function registerServicesListCommand(parent) {
-  const cmd = parent.command("list").description("List available merchant services from the registry");
+function registerHotelListOrdersCommand(parent, deps) {
+  const cmd = parent.command("list-orders").description("List the developer's hotel orders with optional status filtering and pagination").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--status <status>", "Filter by order status (omitted entirely when absent \u2192 all statuses)").option("--page <page>", "Page number", DEFAULT_PAGE3).option("--page-size <size>", "Page size", DEFAULT_PAGE_SIZE3);
+  attachSchemaHelp(cmd, hotelListOrdersSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
-    const services = SERVICE_REGISTRY.map(toListItem);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const params = {
+      page: positiveInt4(opts.page ?? DEFAULT_PAGE3, "page"),
+      page_size: positiveInt4(opts.pageSize ?? DEFAULT_PAGE_SIZE3, "page-size")
+    };
+    if (opts.status !== void 0) params.status = opts.status;
+    const spinner = format === "json" ? null : createSpinner("Fetching orders...");
+    const result = await deps.apiClient.get(
+      "/hotel/orders",
+      { type: "api-key", key: apiKey },
+      params
+    );
+    spinner?.stop();
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
     const configManager = new ConfigManager();
     const commandResult = {
-      data: { services },
-      text: () => {
-        if (services.length === 0) {
-          return Formatter.status("info", "No services found");
-        }
-        const headers = ["Service ID", "Name", "Category", "Provider", "Version", "Verbs"];
-        const rows = services.map((s) => [
-          s.service_id,
-          s.name,
-          s.category,
-          s.provider,
-          s.version,
-          s.verbs.join(", ")
-        ]);
-        return Formatter.table(headers, rows);
-      }
+      data,
+      text: () => formatOrders3(data)
     };
     await renderWithContext(commandResult, { format }, configManager);
   });
 }
 
-// src/services/get.ts
-function formatServiceGet(s) {
-  const lines = [
-    ["Service ID", s.service_id],
-    ["Name", s.name],
-    ["Description", s.description],
-    ["Category", s.category],
-    ["Version", s.version],
-    ["Provider", s.provider],
-    ["CLI Noun", s.cli_noun],
-    ["Verbs", s.verbs.join(", ")],
-    ["Workflow", s.workflow.join(" \u2192 ")],
-    ["Since", s.since],
-    ["Help", s.discovery.help_command]
-  ];
-  const verbDetail = s.verbs.map((v) => `  ${v}: ${s.verb_descriptions[v] ?? ""}`).join("\n");
-  return `${Formatter.keyValue(lines)}
-Verb descriptions:
-${verbDetail}`;
+// src/hotel-redaug/find-destination.ts
+function need12(value, flag) {
+  if (value === void 0 || value.trim() === "") {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
 }
-function registerServiceGetCommand(parent) {
-  const cmd = parent.command("get <service-id>").description("Retrieve a single merchant service by id");
-  cmd.action(async (serviceId) => {
+function formatFindDestination(data) {
+  const destinations = data.destinations ?? [];
+  if (destinations.length === 0) {
+    return Formatter.status("info", "No destinations found for this keyword");
+  }
+  const headers = ["Destination ID", "Type", "Name", "City Name", "City Code", "Country", "Lat", "Lng"];
+  const rows = destinations.map((d) => [
+    String(d.destination_id ?? "-"),
+    String(d.type ?? "-"),
+    String(d.name ?? "-"),
+    String(d.city_name ?? "-"),
+    String(d.city_code ?? "-"),
+    String(d.country_name ?? "-"),
+    String(d.lat ?? "-"),
+    String(d.lng ?? "-")
+  ]);
+  return Formatter.table(headers, rows);
+}
+function registerHotelFindDestinationCommand(parent, deps) {
+  const cmd = parent.command("find-destination").description("Search for a hotel destination by keyword (city, landmark, airport, etc.)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--keyword <text>", "Destination search keyword (required)").option("--data-type <type>", "Optional data type filter");
+  attachSchemaHelp(cmd, hotelFindDestinationSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const keyword = need12(opts.keyword, "keyword");
+    const body = { keyword };
+    if (opts.dataType !== void 0) {
+      body.data_type = opts.dataType;
+    }
+    const result = await deps.apiClient.post(
+      "/hotel/find-destination",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatFindDestination(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/hotel-filters.ts
+function need13(value, flag) {
+  if (value === void 0 || value.trim() === "") {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function num7(value, flag) {
+  const n = Number(need13(value, flag));
+  if (!Number.isFinite(n)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
+  }
+  return n;
+}
+function coord2(value, flag, min, max) {
+  const n = num7(value, flag);
+  if (n < min || n > max) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be between ${min} and ${max}.`);
+  }
+  return n;
+}
+function renderGroup(title, items, isFacility = false) {
+  if (items.length === 0) return "";
+  const headers = isFacility ? ["Code", "Name", "Count", "Type"] : ["Code", "Name", "Count"];
+  const rows = items.map((item) => {
+    const base = [
+      String(item.code ?? "-"),
+      String(item.name ?? "-"),
+      String(item.count ?? "-")
+    ];
+    if (isFacility) {
+      base.push(String(item.type ?? "-"));
+    }
+    return base;
+  });
+  return `
+[${title}]
+${Formatter.table(headers, rows)}`;
+}
+function formatFilters(data) {
+  const sections = [
+    renderGroup("Stars (\u2192 search --star)", data.stars ?? []),
+    renderGroup("Brands (\u2192 search --hotel-brand-codes)", data.brands ?? []),
+    renderGroup("Groups", data.groups ?? []),
+    renderGroup("Labels (\u2192 search --hotel-label-ids)", data.labels ?? []),
+    renderGroup("Sub-Categories (\u2192 search --hotel-sub-category-ids)", data.sub_categories ?? []),
+    renderGroup("Hotel Facilities (\u2192 search --hotel-facility-codes)", data.hotel_facilities ?? [], true),
+    renderGroup("Room Facilities (\u2192 search --room-facility-codes)", data.room_facilities ?? [], true)
+  ].filter(Boolean);
+  if (sections.length === 0) {
+    return Formatter.status("info", "No filter options available for this location");
+  }
+  return sections.join("\n");
+}
+function registerHotelFiltersCommand(parent, deps) {
+  const cmd = parent.command("hotel-filters").description("Get available filter options for hotel search at a given location (codes map to search filters)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--destination-id <id>", "Destination ID (alternative to --lat/--lng)").option("--lat <lat>", "Latitude (-90 to 90, requires --lng)").option("--lng <lng>", "Longitude (-180 to 180, requires --lat)").option("--distance <km>", "Search radius in kilometers", "20");
+  attachSchemaHelp(cmd, hotelFiltersSchema);
+  cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
-    const service = findService(serviceId);
-    if (!service) {
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const hasDestination = opts.destinationId !== void 0;
+    const hasLat = opts.lat !== void 0;
+    const hasLng = opts.lng !== void 0;
+    const hasCoordBranch = hasLat || hasLng;
+    if (hasDestination && hasCoordBranch) {
       throw new CliError(
-        "SERVICE_NOT_FOUND",
-        `Service '${serviceId}' was not found in the registry. Run "services list" to see available services.`
+        "PARAM_INVALID",
+        "Supply either --destination-id OR --lat/--lng, not both."
+      );
+    }
+    if (!hasDestination && !hasCoordBranch) {
+      throw new CliError(
+        "PARAM_INVALID",
+        "Supply either --destination-id OR --lat/--lng (one location branch is required)."
+      );
+    }
+    if (hasCoordBranch && !(hasLat && hasLng)) {
+      throw new CliError(
+        "PARAM_INVALID",
+        "--lat and --lng must both be provided together."
       );
     }
+    const body = {};
+    if (hasDestination) {
+      body.destination_id = need13(opts.destinationId, "destination-id");
+    } else {
+      body.lat = coord2(opts.lat, "lat", -90, 90);
+      body.lng = coord2(opts.lng, "lng", -180, 180);
+    }
+    body.distance = num7(opts.distance, "distance");
+    const result = await deps.apiClient.post(
+      "/hotel/filters",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatFilters(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/list-cities.ts
+function need14(value, flag) {
+  if (value === void 0 || value.trim() === "") {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function formatListCities(data) {
+  const cities = data.cities ?? [];
+  if (cities.length === 0) {
+    return Formatter.status("info", "No cities found for this country");
+  }
+  const headers = ["City Code", "City Name", "Destination ID", "Lat", "Lng", "Country", "Time Zone"];
+  const rows = cities.map((c) => [
+    String(c.city_code ?? "-"),
+    String(c.city_name ?? "-"),
+    String(c.destination_id ?? "-"),
+    String(c.lat ?? "-"),
+    String(c.lng ?? "-"),
+    String(c.country_name ?? "-"),
+    String(c.time_zone ?? "-")
+  ]);
+  return Formatter.table(headers, rows);
+}
+function registerHotelListCitiesCommand(parent, deps) {
+  const cmd = parent.command("list-cities").description("List cities available for hotel booking in a given country").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--country <code>", "ISO country code (required)");
+  attachSchemaHelp(cmd, hotelListCitiesSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const country = need14(opts.country, "country");
+    const body = { country_code: country };
+    const result = await deps.apiClient.post(
+      "/hotel/cities",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data,
+      text: () => formatListCities(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/hotel-redaug/hotel-detail.ts
+function need15(value, flag) {
+  if (value === void 0 || value.trim() === "") {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function formatHotelDetail(data) {
+  const lines = [];
+  const kvPairs = [
+    ["Hotel ID", String(data.hotel_id ?? "-")],
+    ["Hotel Name", String(data.hotel_name ?? "-")],
+    ["English Name", String(data.hotel_eng_name ?? "-")],
+    ["Star", String(data.star ?? "-")],
+    ["Address", String(data.address ?? "-")],
+    ["Intro", String(data.intro ?? "-")],
+    ["Telephone", String(data.telephone ?? "-")],
+    ["Country", String(data.country_name ?? "-")],
+    ["Province", String(data.province_name ?? "-")],
+    ["City", String(data.city_name ?? "-")],
+    ["District", String(data.district_name ?? "-")],
+    ["Business Area", String(data.business_name ?? "-")],
+    ["Latitude", String(data.lat ?? "-")],
+    ["Longitude", String(data.lng ?? "-")],
+    ["Check-in Time", String(data.check_in_time ?? "-")],
+    ["Check-out Time", String(data.check_out_time ?? "-")],
+    ["Room Count", String(data.room_num ?? "-")]
+  ];
+  lines.push(Formatter.keyValue(kvPairs));
+  const facilities = data.facilities ?? [];
+  if (facilities.length > 0) {
+    lines.push("");
+    lines.push("Facilities:");
+    const facHeaders = ["Name", "Type"];
+    const facRows = facilities.map((f) => [
+      String(f.name ?? "-"),
+      String(f.type ?? "-")
+    ]);
+    lines.push(Formatter.table(facHeaders, facRows));
+  } else {
+    lines.push("");
+    lines.push(Formatter.status("info", "No facilities listed"));
+  }
+  const images = data.images ?? [];
+  if (images.length > 0) {
+    lines.push("");
+    lines.push("Images:");
+    const imgHeaders = ["URL", "Is Main"];
+    const imgRows = images.map((img) => [
+      String(img.url ?? "-"),
+      String(img.is_main ?? false)
+    ]);
+    lines.push(Formatter.table(imgHeaders, imgRows));
+  } else {
+    lines.push("");
+    lines.push(Formatter.status("info", "No images available"));
+  }
+  const rooms = data.rooms ?? [];
+  if (rooms.length > 0) {
+    lines.push("");
+    lines.push("Rooms:");
+    const roomHeaders = ["Room ID", "Room Name", "Area", "Floor", "Max Person", "Beds", "Images"];
+    const roomRows = rooms.map((r) => {
+      const bedsStr = (r.beds ?? []).map((b) => `${b.name ?? "-"}${b.num ? ` x${b.num}` : ""}`).join(", ") || "-";
+      return [
+        String(r.room_id ?? "-"),
+        String(r.room_name ?? "-"),
+        String(r.area_sqm ?? "-"),
+        String(r.floor ?? "-"),
+        String(r.max_person ?? "-"),
+        bedsStr,
+        String((r.images ?? []).length)
+      ];
+    });
+    lines.push(Formatter.table(roomHeaders, roomRows));
+    lines.push(
+      "",
+      Formatter.status(
+        "info",
+        "room_id matches quote's roomItems[].roomId \u2014 use it to relate a room here to its live rate in quote."
+      )
+    );
+  } else {
+    lines.push("");
+    lines.push(Formatter.status("info", "No room-type details available"));
+  }
+  return lines.join("\n");
+}
+function registerHotelDetailCommand(parent, deps) {
+  const cmd = parent.command("hotel-detail").description("Get detailed information about a specific hotel (facilities, images, etc.)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--hotel-id <id>", "Hotel ID (required)").option("--with-images [value]", "Include hotel images (default: true)", true);
+  attachSchemaHelp(cmd, hotelDetailSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+      message: "API Key:",
+      type: "password"
+    });
+    const hotelId = need15(opts.hotelId, "hotel-id");
+    const rawWithImages = opts.withImages;
+    const withImages = rawWithImages !== "false" && rawWithImages !== false;
+    const body = {
+      hotel_id: hotelId,
+      with_images: withImages
+    };
+    const result = await deps.apiClient.post(
+      "/hotel/detail",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    if (!result.success) {
+      throw CliError.fromApi(result, { auth: "api-key" });
+    }
+    const data = result.data;
     const configManager = new ConfigManager();
     const commandResult = {
-      data: service,
-      text: () => formatServiceGet(service)
+      data,
+      text: () => formatHotelDetail(data)
     };
     await renderWithContext(commandResult, { format }, configManager);
   });
 }
 
+// src/hotel-redaug/skill.ts
+var SKILL_TEXT = `
+---
+name: hotel-redaug
+description: Search, create orders, and manage international hotel reservations via the Redaug provider. Two-step create-then-pay flow supporting monthly_settlement and pay_per_call (EVO) billing modes. Use when the user wants to find hotels, check room prices/availability, make a hotel booking, or view/cancel/modify an existing hotel order. Not for flights, rides, or domestic-only stays.
+---
+
+# hotel-redaug \u2014 Agent Skill
+
+You orchestrate hotel bookings through CLI verbs. This guide covers HOW to chain
+the verbs and pass data between them. For exact flags and field types, read the
+schema (\`services get svc_01J0HT5REDAUG0001 --api-key <key> --format json\`) or
+run \`hotel-redaug <verb> --help\`.
+
+## Prerequisites
+
+- API key with merchant scope
+- Two billing modes supported (set on the developer, not chosen per-call):
+  - **monthly_settlement**: developer has a settlement account with sufficient balance
+  - **pay_per_call**: developer collects payment from their end-user via EVO; the user pays using the create-order \`order_id\` as the EVO merchantTransID, and the platform verifies by querying EVO for that order_id (the pay-order response reports settlement_path "active_payment")
+- BILLING_MODE_MISMATCH means the order billing_mode is not one of the two modes above
+- Pass --api-key <key> --format json on every call; add --yes on writes
+
+## Workflow
+
+1. Resolve location
+   - find-destination --keyword "<place>"  \u2192 lat/lng or destination_id
+   - list-cities --country <code>          \u2192 destination_id
+   - (Need exactly one of these for search.)
+
+2. Search hotels
+   - Pass ONE location branch (coordinates OR destination_id) + dates + guests
+   - Optional: hotel-filters first to get valid filter codes, then pass to search
+
+3. Choose a hotel (MANDATORY unless the user already named one exact hotel)
+   - MUST present the candidates to the user (name, address/distance, star/score if useful)
+     and get an explicit pick \u2014 never auto-select by distance or price alone, even for an
+     open-ended request like "book me something near the Bund"
+   - hotel-detail <hotel-id> for the shortlisted/chosen hotel is OPTIONAL AT THIS STEP for
+     the hotel-level info (address/intro/hotel photos) \u2014 the candidate list above is enough
+     to pick a HOTEL. But you WILL need hotel-detail's rooms[] at step 4 below to describe
+     ROOMS, so in practice call it once the user has picked (or shortlisted) a hotel, before
+     moving to quote \u2014 don't make two round trips when one will do
+
+4. Quote + show room options (ALWAYS call hotel-detail here \u2014 this is the mandatory part)
+   - quote the chosen hotel + same dates/guests \u2192 rates[]
+   - Empty rates[] = no availability \u2192 stop, tell the user
+   - Each rate carries the inputs for create-order: product_token, total_price, price_items
+   - quote's rates[].room_name is only a bare one-line label with NO area/beds/photos. MUST
+     call hotel-detail on the same hotel_id (if not already called in step 3) and match its
+     rooms[] to quote's rates by room_name \u2014 do this proactively, BEFORE presenting rate
+     options, not only if the user asks for more detail. The room is the actual product being
+     booked, so the user picking a rate MUST see area_sqm, floor, beds, and images alongside
+     rate_plan_name/breakfast/free_cancellation/total_price+currency \u2014 never present rate
+     options as a bare list of room_name + price only.
+   - MUST present the combined rate+room options and get the user's explicit pick of which
+     rate to book \u2014 same rule as step 3, and now with real room detail attached, not optional
+
+5. Create order (lock inventory, no charge) \u2014 MUST NOT run until step 3+4 confirmation happened
+   - create-order: forward quote outputs VERBATIM (product_token, amount, currency, price_items)
+   - Collect from user: guest_name, contact_name, contact_phone
+   - Generate a unique idempotency-key
+   - Response \u2192 save order_id + fc_order_code + total_amount + currency
+   - Order status: AWAITING_PAYMENT (no money charged yet)
+   - FOR pay_per_call: tell the user to pay total_amount+currency via EVO
+     USING THIS order_id as the EVO merchantTransID. The verification in step 6 works by
+     querying EVO for exactly this order_id, so paying under any other id will not settle.
+
+6. Pay order (settle the locked order) \u2014 MUST confirm with the user before calling this
+   - Before calling: show the user total_amount + currency from create-order and which
+     billing path applies, and get explicit go-ahead \u2014 pay-order is the step that actually
+     moves money
+   - pay-order --order-id <order_id from create-order>   (that's the only identifier needed)
+   - Billing path determined server-side by developer's billing_mode:
+     a) monthly_settlement:
+        - Platform deducts from settlement account \u2192 calls upstream payOrder
+     b) pay_per_call:
+        - The user must have ALREADY paid via EVO using the order_id as the EVO
+          merchantTransID (see create-order step 5). Just call pay-order --order-id <id>;
+          the platform queries EVO for that order_id and verifies exact amount/currency.
+          There is no merchant-transaction-id flag: the EVO key IS the order_id, so a
+          foreign already-paid EVO transaction cannot be substituted.
+        - If EVO not yet confirmed \u2192 PAYMENT_NOT_COMPLETED; use --watch to poll
+   - On success \u2192 order status becomes PAID
+
+7. Confirm (upstream confirmation is async)
+   - Poll get --order-id until CONFIRMED (success) or CANCELLED (failed)
+   - Do not report success before CONFIRMED
+
+8. Post-booking (only when the user asks)
+   - cancel: order_id + fc_order_code + reason
+   - checkout: partial leave-early \u2192 then poll get-checkout with task_order_code
+   - list-orders: view all orders
+
+## Data passing (where each value comes from)
+
+- product_token   : quote \u2192 create-order  (opaque; never fabricate or edit)
+- price_items     : quote \u2192 create-order  (JSON array; copy exactly)
+- order_id        : create-order \u2192 pay-order / get / cancel
+- fc_order_code   : create-order \u2192 cancel / checkout
+- order_id (again): for pay_per_call it IS the EVO merchantTransID \u2014 the user pays via
+  EVO under the order_id; pay-order takes no separate merchant-transaction-id
+- task_order_code : checkout \u2192 get-checkout
+
+## Billing modes (chosen server-side by billing_mode)
+
+pay-order takes only --order-id; there is NO merchant-transaction-id flag. The platform
+routes purely by the order's billing_mode:
+
+| Developer billing_mode | Behavior |
+|------------------------|----------|
+| monthly_settlement     | Deducts settlement balance \u2192 payOrder |
+| pay_per_call           | Platform queries EVO for the order_id \u2192 verify exact amount/currency \u2192 payOrder (response settlement_path is "active_payment") |
+| anything else          | ERROR: BILLING_MODE_MISMATCH (only the two modes above are valid) |
+
+## pay_per_call flow \u2014 the EVO merchantTransID IS the order_id
+
+1. create-order returns order_id + total_amount + currency (no EVO credentials in response)
+2. User pays total_amount+currency via EVO, USING the order_id as the EVO merchantTransID
+   (the shared EVO parameters are onboarded separately, out of band)
+3. Agent calls pay-order --order-id <order_id>   (no other identifier)
+4. Platform queries EVO for that order_id: paid + exact amount/currency match \u2192 payOrder \u2192 PAID
+5. If not yet paid \u2192 PAYMENT_NOT_COMPLETED; use --watch to auto-poll
+6. Why order_id (not an arbitrary id): it binds the payment to this exact order, so a caller
+   cannot present some other already-paid EVO transaction of the same amount.
+
+## Invariants
+
+- search: exactly one location branch (both or neither = error)
+- Never create-order without a fresh quote (tokens expire)
+- Never claim "booked" until get returns CONFIRMED
+- create-order and pay-order are separate steps; create-order does NOT charge
+- pay-order depends on create-order's output (order_id)
+- Write verbs (create-order/pay-order/cancel/checkout) always need --idempotency-key and --yes
+- IMPORTANT: --yes only skips this CLI's own interactive TTY prompt (needed because the Agent
+  runs non-interactively). It is NOT a substitute for showing the user the hotel/rate/price and
+  getting their decision in the chat UI. Passing --yes does not remove the confirmation steps in
+  step 3/4 (choose hotel + rate) or step 6 (confirm before pay-order) above.
+- After a cancel call returns successfully (including the cancel_status='cancel_pending' shape),
+  do NOT call cancel again for the same order \u2014 poll get instead. A pending acknowledgement is
+  success, not failure.
+
+## Errors
+
+- RESOURCE_NOT_FOUND (find-destination) \u2192 platform 404 for this keyword, distinct from an
+  empty destinations[] (which is a normal no-match, not an error). Do not keep retrying the
+  keyword \u2014 fall back to the coordinate branch (search/hotel-filters --lat/--lng) if you can
+  geocode the place or already know its coordinates; otherwise ask the user for a city or a
+  more specific landmark.
+- BILLING_MODE_MISMATCH            \u2192 order billing_mode is not monthly_settlement or pay_per_call
+- ACCOUNT_INSUFFICIENT_BALANCE     \u2192 settlement account needs top-up; inform user
+- PAYMENT_NOT_COMPLETED            \u2192 EVO not confirmed yet; retry (--watch) or wait
+- PAYMENT_NOT_FOUND                \u2192 no EVO transaction for that ID; verify with user
+- PAYMENT_AMOUNT_MISMATCH          \u2192 EVO amount/currency \u2260 order; user must pay correct amount
+- PAYORDER_FAILED                  \u2192 upstream payOrder failed; money refunded, safe to retry
+- PAYORDER_FAILED_AFTER_PAYMENT    \u2192 EVO confirmed but payOrder failed; needs reconciliation
+- UPSTREAM_ERROR                   \u2192 transient provider issue; wait and retry once
+- PARAM_INVALID                    \u2192 bad argument; run <verb> --help and correct it
+- empty rates[]                    \u2192 no rooms; suggest other dates or hotels
+`.trim();
+function registerHotelSkillCommand(parent) {
+  parent.command("skill").description("Print the hotel-redaug usage guide (orchestration flow, data passing, rules)").action(() => {
+    console.log(SKILL_TEXT);
+  });
+}
+
 // src/index.ts
 var programRef;
 async function main() {
@@ -1704,11 +4288,13 @@ async function main() {
   await configManager.ensureDirectories();
   const apiBaseUrl = await configManager.getApiBaseUrl();
   const apiClient = new ApiClient({ baseUrl: apiBaseUrl });
+  const apiHost = await configManager.getApiHost();
+  const discoveryClient = new ApiClient({ baseUrl: apiHost });
   const deps = { apiClient };
   const program = new Command();
   programRef = program;
   program.name("agenzo-merchant-cli").version(getCurrentVersion()).description(
-    "Agenzo merchant fulfillment plane: service discovery (services) and ride ordering (ride-elife)"
+    "Agenzo merchant fulfillment plane: service discovery (services), ride ordering (ride-elife), and hotel booking (hotel-redaug)"
   ).option("--verbose", "Show verbose logs").option("--yes", "Skip confirmation prompts (for automation/AI Agents)").option(
     "--format <format>",
     "Output format: json | table (default: json; or set AGENZO_FORMAT)",
@@ -1725,8 +4311,60 @@ async function main() {
   registerCancelCommand(rideCmd, deps);
   registerListOrdersCommand(rideCmd, deps);
   const servicesCmd = program.command("services").description("Merchant service discovery");
-  registerServicesListCommand(servicesCmd);
-  registerServiceGetCommand(servicesCmd);
+  registerServicesListCommand(servicesCmd, { discoveryClient, program });
+  registerServiceGetCommand(servicesCmd, { discoveryClient, program });
+  const ordersCmd = program.command("orders").description(
+    'Unified cross-provider order index (spans ride + hotel). Use for generic "my orders" requests; use ride-elife/hotel-redaug commands once the business is known.'
+  );
+  registerOrdersListCommand(ordersCmd, deps);
+  registerOrdersGetCommand(ordersCmd, deps);
+  const hotelCmd = program.command("hotel-redaug").description(
+    `Hotel booking (Redaug) \u2014 international hotel search, quote, create-order, pay-order, cancel, and check-out.
+
+Workflow (typical order):
+  1. find-destination  Resolve a place name \u2192 coordinates (or destination_id via list-cities)
+  2. hotel-filters     (optional) Get filter options for a location (star/brand/facility codes)
+  3. search            Search hotels by coordinates OR destination_id, with date/guest/filter params
+  4. hotel-detail      View hotel + rooms[] (area/floor/beds/photos). Call it for the chosen/
+                       shortlisted hotel BEFORE quote \u2014 quote's room_name alone has no detail,
+                       and the user should see real room info before picking a rate at step 5.
+  5. quote             Get real-time room rates for a hotel + dates \u2192 product_token + price_items.
+                       Pair each rate with hotel-detail's rooms[] (match by room_name) before
+                       presenting options to the user.
+  6. create-order      Create order using product_token from quote (lock inventory, no charge)
+  7. pay-order         Settle the order by --order-id (path chosen server-side by billing_mode)
+  8. get               Poll order status until CONFIRMED (or use --watch for NDJSON stream)
+  9. cancel            Cancel an order (whole-order, within policy)
+ 10. checkout          Apply for partial check-out / out-of-policy cancellation (async)
+ 11. get-checkout      Poll checkout application status
+ 12. list-orders       List developer's hotel orders
+
+Key notes:
+  \u2022 search has two location branches: --destination-id OR --lat/--lng (exactly one required)
+  \u2022 hotel-detail's rooms[] is the actual room info (area/beds/photos) \u2014 quote's room_name is
+    just a bare label; show both together before asking the user to pick a rate
+  \u2022 create-order locks inventory without charging; order enters AWAITING_PAYMENT
+  \u2022 pay-order settles the order by --order-id; the path is chosen server-side by
+    billing_mode. For pay_per_call the user pays via EVO using the order_id
+    as the merchantTransID first; use --watch to poll until PAID
+  \u2022 All amounts are DECIMAL (e.g. 10.00 = ten yuan), never minor units (cents)
+  \u2022 product_token from quote is opaque \u2014 pass it unchanged to create-order
+  \u2022 price_items from quote must be copied verbatim as --price-items JSON array to create-order`
+  );
+  registerHotelSearchCommand(hotelCmd, deps);
+  registerHotelQuoteCommand(hotelCmd, deps);
+  registerHotelCreateOrderCommand(hotelCmd, deps);
+  registerHotelPayOrderCommand(hotelCmd, deps);
+  registerHotelGetCommand(hotelCmd, deps);
+  registerHotelCancelCommand(hotelCmd, deps);
+  registerHotelCheckoutCommand(hotelCmd, deps);
+  registerHotelGetCheckoutCommand(hotelCmd, deps);
+  registerHotelListOrdersCommand(hotelCmd, deps);
+  registerHotelFindDestinationCommand(hotelCmd, deps);
+  registerHotelFiltersCommand(hotelCmd, deps);
+  registerHotelListCitiesCommand(hotelCmd, deps);
+  registerHotelDetailCommand(hotelCmd, deps);
+  registerHotelSkillCommand(hotelCmd);
   await program.parseAsync(process.argv);
 }
 function resolveActiveFormat() {
@@ -1742,6 +4380,9 @@ function reportError(error) {
     console.error(
       Formatter.status("error", `[${envelope.error.code_num}] ${envelope.error.message}`)
     );
+    if (envelope.error.upstream) {
+      console.error(`  \u21B3 [${envelope.error.upstream.code}] ${envelope.error.upstream.message}`);
+    }
     if (!(error instanceof CliError) && process.argv.includes("--verbose")) {
       console.error(error);
     }