@agenzo/merchant-cli 0.4.3 → 0.5.1

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,14 @@ var CODE_NUM = {
   QUOTE_EXPIRED: 4202,
   BOOKING_FAILED: 4203,
   CANCELLATION_NOT_ALLOWED: 4204,
+  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 +66,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 +112,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 +130,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 +186,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.",
@@ -189,17 +211,28 @@ var STABLE_MESSAGE = {
   QUOTE_EXPIRED: "The quote has expired. Please request a new quote and retry.",
   BOOKING_FAILED: "The booking could not be completed. Please retry.",
   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 +295,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 +853,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 +1119,623 @@ 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 AND pay for a hotel order in one call, using a product_token and price_items from a recent quote. The backend re-checks availability, authorizes/captures payment via the platform payment gateway (funds path decided server-side by the developer billing_mode \u2014 monthly_settlement or pay_per_call), locks the room with the supplier, and returns the order already PAID. There is no separate settlement step. If any step after funds are taken fails, the funds are automatically released/refunded before the error is returned. 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)" },
+    "payment-method-id": { type: "string", required: false, description: "pay_per_call only: charge this SPECIFIC already-bound card instead of the platform auto-selected default/most-recent one. Ignored for monthly_settlement.", constraints: "Must be an ACTIVE card belonging to this developer, else PAYMENT_METHOD_REQUIRED" },
+    "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 identical request. This single call covers both order creation AND payment",
+      constraints: "1-128 chars [A-Za-z0-9_-]"
+    }
+  },
+  response: {
+    order_id: { type: "string", description: "Our order reference (coOrderCode). Use as --order-id in 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 actually charged (DECIMAL units) \u2014 the order is already PAID by the time this response is returned." },
+    currency: { type: "string", description: "ISO 4217 currency code of the charge." }
+  },
+  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 already PAID \u2014 proceed to get to poll for supplier CONFIRMED status."
+  },
+  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 a NEW idempotency-key (the request is no longer identical).",
+    PAYMENT_METHOD_REQUIRED: "pay_per_call developer has no ACTIVE bound card at all, OR the explicitly-passed --payment-method-id is missing/not ACTIVE/does not belong to this developer. Direct the user to bind a card, drop --payment-method-id to auto-select, or pass a valid one.",
+    ACCOUNT_INSUFFICIENT_BALANCE: "monthly_settlement developer settlement credit is insufficient (check via admin-cli accounts get). Direct the user to top up offline; do NOT retry until funded.",
+    ACCOUNT_NOT_FOUND: "monthly_settlement 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.",
+    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. Any funds already taken are automatically released/refunded before this error is returned. Retry once after ~2s backoff with the SAME idempotency-key."
+  }
+};
+var hotelPayOrderSchema = {
+  cli: CLI_NAME,
+  noun: HOTEL_NOUN,
+  verb: "pay-order",
+  description: "Trigger supplier confirmation (upstream payOrder) for an order that was already paid via create-order. Takes only --order-id; no payment parameters needed. On success the supplier begins asynchronous confirmation \u2014 poll get until CONFIRMED (3). Idempotent: calling pay-order on an already-confirmed order replays the existing result",
+  flags: {
+    "order-id": { type: "string", required: true, description: "Order to confirm with the supplier (create-order.response.order_id)." },
+    "idempotency-key": {
+      type: "string",
+      required: true,
+      description: "Unique key forwarded verbatim as the Idempotency-Key header; never auto-generated. Derive from business intent and reuse the SAME key when retrying the same pay-order call",
+      constraints: "1-128 chars [A-Za-z0-9_-]"
+    },
+    watch: { type: "bool", required: false, default: false, description: "Retained for backward compatibility. 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: "The order's billing_mode echoed: 'monthly_settlement' or 'pay_per_call'." },
+    status: { type: "string", description: "'PAID' \u2014 supplier confirmation is asynchronous; poll get until CONFIRMED." },
+    amount: { type: "float", description: "Settled amount in DECIMAL units (from create-order)." },
+    currency: { type: "string", description: "ISO 4217 currency code." }
+  },
+  example: {
+    command: "agenzo-merchant-cli hotel-redaug pay-order --order-id hho_01KWC63Z5CD6CKBM33Q7SC2ZDT --idempotency-key pay-h1n2",
+    output_summary: 'Triggers supplier payOrder (confirmation/ticket issuance). Returns {order_id, settlement_path, status:"PAID", amount, currency}. Then poll get until CONFIRMED.'
+  },
+  error_recovery: {
+    INVALID_ORDER_STATE: "The order is not in a payable state (it may already be confirmed, cancelled, or missing auth). 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.",
+    UPSTREAM_ERROR: "Transient upstream error during supplier payOrder. Retry once after ~5s with the SAME idempotency-key, then poll get to check whether the confirmation actually took effect.",
+    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."
+  }
+};
 
 // src/ride-elife/quote.ts
 function need(value, flag) {
@@ -1221,6 +1886,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 +1942,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 +2060,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;
@@ -1589,7 +2265,10 @@ function registerListOrdersCommand(parent, deps) {
 // src/services/registry.ts
 var SERVICE_REGISTRY = [
   {
-    service_id: "ride-elife",
+    // service_id 是平台级不透明内部引用（svc_ 前缀 + ULID），不进 Agent 日常拼的命令
+    // ——Agent 拼命令用的是 cli_noun="ride-elife"。与后端
+    // services/merchant_service/discovery/catalog.py 的 RIDE_ELIFE_SERVICE_ID 保持一致。
+    service_id: "svc_01KWTPBWDH5YZ52H717BFVWZA8",
     name: "Ride hailing (eLife)",
     description: "On-demand ride ordering: quote a fare, book it, poll status, and cancel.",
     category: "ride",
@@ -1607,32 +2286,129 @@ 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/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: 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,
+    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 registerServicesListCommand(parent) {
-  const cmd = parent.command("list").description("List available merchant services from the registry");
+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 services = SERVICE_REGISTRY.map(toListItem);
+    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 },
@@ -1657,46 +2433,1732 @@ function registerServicesListCommand(parent) {
 }
 
 // src/services/get.ts
+function buildVerbsSummary(data) {
+  const verbs = Array.isArray(data.verbs) ? data.verbs : [];
+  const verbDescriptions = data.verb_descriptions ?? {};
+  const schema = data.schema_content;
+  const schemaVerbs = schema?.verbs;
+  return verbs.map((verb) => {
+    const item = {
+      verb,
+      description: verbDescriptions[verb] ?? String(schemaVerbs?.[verb]?.description ?? "")
+    };
+    const annotations = schemaVerbs?.[verb]?.annotations;
+    if (annotations) item.annotations = annotations;
+    return item;
+  });
+}
+function toServiceLayerView(data) {
+  const schema = data.schema_content;
+  const view = {
+    service_id: data.service_id,
+    cli_noun: data.cli_noun,
+    category: data.category,
+    name: data.name,
+    summary: data.description ?? schema?.summary,
+    status: data.status ?? "available",
+    provider: data.provider,
+    version: data.version
+  };
+  if (schema?.selection_hints) view.selection_hints = schema.selection_hints;
+  const discovery = data.discovery;
+  view.schema_ref = schema?.schema_ref ?? {
+    help_command: discovery?.help_command,
+    ...discovery?.schema_url ? { schema_url: discovery.schema_url } : {}
+  };
+  if (schema?.conventions) view.conventions = schema.conventions;
+  if (schema?.workflow) {
+    view.workflow = schema.workflow;
+  } else if (Array.isArray(data.workflow)) {
+    view.workflow = { description: data.workflow.join(" \u2192 ") };
+  }
+  view.verbs_summary = buildVerbsSummary(data);
+  if (schema?.cross_service_recovery) view.cross_service_recovery = schema.cross_service_recovery;
+  return view;
+}
 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]
+    ["Service ID", String(s.service_id ?? "")],
+    ["CLI Noun", String(s.cli_noun ?? "")],
+    ["Category", String(s.category ?? "")],
+    ["Name", String(s.name ?? "")],
+    ["Summary", String(s.summary ?? "")],
+    ["Status", String(s.status ?? "")],
+    ["Provider", String(s.provider ?? "")],
+    ["Version", String(s.version ?? "")]
   ];
-  const verbDetail = s.verbs.map((v) => `  ${v}: ${s.verb_descriptions[v] ?? ""}`).join("\n");
-  return `${Formatter.keyValue(lines)}
-Verb descriptions:
-${verbDetail}`;
+  const block = Formatter.keyValue(lines);
+  const sections = [];
+  for (const key of [
+    "selection_hints",
+    "schema_ref",
+    "conventions",
+    "workflow",
+    "verbs_summary",
+    "cross_service_recovery"
+  ]) {
+    if (s[key] !== void 0) {
+      sections.push(`${key}:
+${JSON.stringify(s[key], null, 2)}`);
+    }
+  }
+  return sections.length > 0 ? `${block}
+
+${sections.join("\n\n")}` : block;
 }
-function registerServiceGetCommand(parent) {
-  const cmd = parent.command("get <service-id>").description("Retrieve a single merchant service by id");
+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 (service-layer view: workflow + conventions + verbs_summary)").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 service = findService(serviceId);
-    if (!service) {
-      throw new CliError(
-        "SERVICE_NOT_FOUND",
-        `Service '${serviceId}' was not found in the registry. Run "services list" to see available services.`
+    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 = toServiceLayerView(data);
+    const configManager = new ConfigManager();
+    const commandResult = {
+      data: resolved,
+      text: () => formatServiceGet(resolved)
+    };
+    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 positiveInt2(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 = positiveInt2(opts.page, "page");
+    const pageSize = positiveInt2(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));
+  }
+  return out.join("\n");
+}
+function registerHotelCreateOrderCommand(parent, deps) {
+  const cmd = parent.command("create-order").description("Create AND pay for a hotel order in one call (billing path decided server-side by billing_mode)").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(
+    "--payment-method-id <id>",
+    "pay_per_call only: charge this SPECIFIC already-bound card instead of the platform auto-selected one"
+  ).option(
+    "--idempotency-key <key>",
+    "Idempotency key forwarded verbatim as the Idempotency-Key header (covers both order creation AND payment)"
+  );
+  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.paymentMethodId !== void 0) body.payment_method_id = opts.paymentMethodId;
+    if (!isYes) {
+      const confirmed = await confirm3({
+        message: `Create and pay for this hotel order: ${totalAmount} ${currency} (check-in ${checkIn}, check-out ${checkOut})? This locks the rate AND charges the amount immediately.`,
+        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.status ?? "-")]
+  ];
+  if (data.settlement_path) lines.push(["Settlement path", String(data.settlement_path)]);
+  if (data.amount != null && data.currency) {
+    lines.push(["Amount", `${data.amount} ${data.currency}`]);
+  }
+  return Formatter.keyValue(lines);
+}
+function isPaymentTerminal(record) {
+  const status = record.status;
+  return status === "PAID";
+}
+function registerHotelPayOrderCommand(parent, deps) {
+  const cmd = parent.command("pay-order").description("Trigger supplier confirmation for a paid hotel order (upstream payOrder)").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: `Confirm hotel order ${orderId} with the supplier? (Payment was already settled in create-order; this triggers supplier confirmation.)`,
+        default: true
+      });
+      if (!confirmed) {
+        throw new CliError("CLIENT_ABORTED", "Confirmation 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 {
+          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) {
+    const currency = data.currency ? ` ${data.currency}` : "";
+    lines.push(["Total amount", `${String(data.total_amount)}${currency}`]);
+  }
+  if (data.settlement_path) lines.push(["Settlement path", String(data.settlement_path)]);
+  if (data.rooms && data.rooms.length > 0) {
+    lines.push([
+      "Rooms",
+      data.rooms.map((r) => `${r.room_index}:${r.guest_name}`).join(", ")
+    ]);
+  }
+  if (data.room_num !== void 0 && data.room_num !== null) {
+    lines.push(["Rooms booked", String(data.room_num)]);
+  }
+  if (data.guest?.name) lines.push(["Guest", String(data.guest.name)]);
+  if (data.contact?.name) {
+    const phone2 = data.contact.phone ? ` (+${data.contact.country_code ?? ""} ${data.contact.phone})` : "";
+    lines.push(["Contact", `${data.contact.name}${phone2}`]);
+  }
+  if (data.arrive_time) lines.push(["Arrive time", String(data.arrive_time)]);
+  if (data.special_requests) lines.push(["Special requests", String(data.special_requests)]);
+  if (data.channel_state) lines.push(["Channel state", String(data.channel_state)]);
+  if (data.created_at) lines.push(["Created at", String(data.created_at)]);
+  if (data.updated_at) lines.push(["Updated at", String(data.updated_at)]);
+  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_PAGE2 = "1";
+var DEFAULT_PAGE_SIZE2 = "20";
+function positiveInt3(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 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 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_PAGE2).option("--page-size <size>", "Page size", DEFAULT_PAGE_SIZE2);
+  attachSchemaHelp(cmd, hotelListOrdersSchema);
+  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: positiveInt3(opts.page ?? DEFAULT_PAGE2, "page"),
+      page_size: positiveInt3(opts.pageSize ?? DEFAULT_PAGE_SIZE2, "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,
+      text: () => formatOrders2(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// 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 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 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 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 "pay_per_call")
+- 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)
+
+6. BRANCH ON BILLING_MODE \u2014 decide THIS before calling pay-order, not inside it
+   - You (the developer/Agent) know your own billing_mode; the order does not expose it.
+   a) monthly_settlement \u2192 skip straight to step 7 (pay-order). Nothing to do here.
+   b) pay_per_call \u2192 STOP. Do NOT call pay-order yet.
+      - Drive YOUR OWN EVO payment integration now, using the order_id from step 5 AS THE
+        EVO merchantTransID (this is the id you pass to your EVO payment call \u2014 not a new
+        or random id).
+      - Wait for the end-user to actually complete that EVO payment for total_amount+currency.
+      - Only once EVO shows the payment as complete, proceed to step 7 \u2014 pay-order is what
+        tells the platform "go verify and settle this", it does NOT itself collect payment.
+
+7. 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 (for pay_per_call, confirm the EVO payment from step 6 was completed first)
+   - 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:
+        - Requires step 6 to have already happened (user paid via EVO under this order_id).
+          Calling pay-order now just makes the platform query EVO for that order_id and
+          verify exact amount/currency \u2014 it does NOT initiate the EVO payment itself.
+          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
+
+8. Confirm (upstream confirmation is async)
+   - Poll get --order-id until CONFIRMED (success) or CANCELLED (failed)
+   - Do not report success before CONFIRMED
+
+9. 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 YOU (the developer/Agent)
+  use it to drive your own EVO payment call BEFORE pay-order (see step 6); pay-order itself
+  takes no separate merchant-transaction-id, it only verifies the payment already made
+- 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 "pay_per_call") |
+| 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. YOU drive your own EVO payment integration now, passing the order_id as the EVO
+   merchantTransID, and get the user to pay total_amount+currency
+   (the shared EVO parameters are onboarded separately, out of band \u2014 pay-order does not do
+   this step for you)
+3. ONLY once that EVO payment is complete, call 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 7 (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 +4166,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 +4189,55 @@ 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 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 +4253,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);
     }