@agenzo/merchant-cli 0.7.0 → 0.8.1

package/dist/index.js

@@ -58,6 +58,7 @@ var CODE_NUM = {
   CHECKOUT_NOT_ALLOWED: 4306,
   CHECKOUT_TASK_NOT_FOUND: 4307,
   PAY_PER_CALL_NOT_AVAILABLE: 4308,
+  HOTEL_NOT_FOUND: 4309,
   RATE_LIMITED: 5001,
   UPSTREAM_ERROR: 5101,
   INTERNAL_ERROR: 5201,
@@ -237,6 +238,7 @@ var STABLE_MESSAGE = {
   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.",
+  HOTEL_NOT_FOUND: "This hotel is no longer available from the supplier.",
   NOT_IMPLEMENTED: "This operation is not implemented yet."
 };
 function toErrorEnvelope(error) {
@@ -629,12 +631,12 @@ var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834"
 function createSpinner(message, intervalMs = 60) {
   let frameIdx = 0;
   let currentMessage = message;
-  const render2 = () => {
+  const render22 = () => {
     process.stdout.write(`\r\x1B[K${SPINNER_FRAMES[frameIdx]} ${currentMessage}`);
     frameIdx = (frameIdx + 1) % SPINNER_FRAMES.length;
   };
-  render2();
-  const timer = setInterval(render2, intervalMs);
+  render22();
+  const timer = setInterval(render22, intervalMs);
   return {
     update(msg) {
       currentMessage = msg;
@@ -872,6 +874,7 @@ async function watchRideStatus(apiClient, apiKey, orderId, opts) {
 var CLI_NAME = "agenzo-merchant-cli";
 var NOUN = "ride-elife";
 var HOTEL_NOUN = "hotel-redaug";
+var FLIGHT_NOUN = "flight-flink";
 function wantsJsonSchema(argv = process.argv) {
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
@@ -1280,6 +1283,12 @@ var hotelCreateOrderSchema = {
     "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)" },
+    tips: { type: "string", required: false, description: "FCG \u5BA2\u6237\u81EA\u6D4B\u70B95 \u63D0\u793A\u4FE1\u606F: the chosen quote rate's tips (tips[].tipsDetails[]) as a JSON array [{title,text}], captured at booking. Stored on the order for the order-detail page only; platform-local, not sent upstream", constraints: "JSON array of {title (string, optional), text (string, optional)}; else PARAM_INVALID" },
+    "bed-type": {
+      type: "string",
+      required: false,
+      description: "Product bed-type code from the chosen quote rate's beds[].code (e.g. 'L000000' King / '1000000' Queen). Forwarded verbatim to upstream createOrder bedType; upstream recommends passing the product-dimension bed type at booking."
+    },
     "payment-token-id": {
       type: "string",
       required: false,
@@ -1674,10 +1683,15 @@ 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",
+  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. hotel_id is stable but hotel_name/room_name may change upstream without notice. special_instructions (when requested via --settings hotelTextPolicies) MUST be shown to the user \u2014 the upstream data provider does not accept liability for booking issues caused by it not being displayed.",
   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)" }
+    "with-images": { type: "bool", required: false, default: true, description: "Include hotel images in the response (set false to reduce payload)" },
+    settings: {
+      type: "string",
+      required: false,
+      description: "Optional on-demand upstream fields, comma-separated or JSON array \u2014 request only what you need: hotelFacilityNew, breakfast, importantNotices, parking, chargingParking, hotelCertificates, comment, hotelMeetingInfos, hotelVideoInfos, hotelTextPolicies (includes special_instructions), hotelStructuredPolicies.childPolicy, hotelStructuredPolicies.extraBedPolicy, hotelStructuredPolicies.petPolicy. Omitted codes are NOT returned by upstream (an upstream requirement, not a display choice). Pass hotelTextPolicies to get special_instructions."
+    }
   },
   response: {
     hotel_id: { type: "string|int", description: "Hotel identifier." },
@@ -1755,6 +1769,45 @@ var hotelDetailSchema = {
           }
         }
       }
+    },
+    comment: {
+      type: "array",
+      description: "Guest review scores per channel. Empty unless --settings included 'comment'.",
+      items: {
+        channel: { type: "string|null", description: "Review source channel (e.g. EPS)." },
+        average_score: { type: "float|null", description: "Average review score for that channel." }
+      }
+    },
+    hotel_certificates: {
+      type: "array",
+      description: "Hotel business certificates/qualifications, when the property has any. Empty unless --settings included 'hotelCertificates' (and the property may simply have none).",
+      items: {
+        unify_code: { type: "string|null", description: "Unified business registration code." },
+        certification_name: { type: "string|null", description: "Certificate name." },
+        file_url: { type: "string|null", description: "Certificate image URL." }
+      }
+    },
+    hotel_text_policies: {
+      type: "array",
+      description: "Free-text hotel policies keyed by code (hotelPolicy/instructions/specialInstructions/mandatoryFees/optionalFees/cleanAndSafety/importantNotices/ageLimit/checkInCheckOut). Empty unless --settings included 'hotelTextPolicies'. special_instructions below is also pulled from this same data, surfaced separately because it MUST be shown to the user.",
+      items: {
+        code: { type: "string|null", description: 'Policy code, e.g. "specialInstructions".' },
+        code_name: { type: "string|null", description: 'Display name of the policy code (e.g. "\u7279\u522B\u5165\u4F4F\u8BF4\u660E").' },
+        text: { type: "string|null", description: "Policy text (may contain HTML list markup from upstream)." }
+      }
+    },
+    hotel_structured_policies: {
+      type: "object|null",
+      description: "Structured child/extra-bed/pet policies (raw upstream shape, snake_cased). null unless --settings included the relevant hotelStructuredPolicies.* code(s).",
+      properties: {
+        child_policy: { type: "object|null", description: "Child stay/breakfast policy." },
+        extra_bed_policy: { type: "object|null", description: "Extra-bed charge policy by age range." },
+        pet_policy: { type: "object|null", description: "Pet/service-animal policy." }
+      }
+    },
+    special_instructions: {
+      type: "string|null",
+      description: "IMPORTANT: the property's 'special check-in instructions' (upstream code specialInstructions, distinct from the general 'instructions' code). The Agent/caller MUST surface this to the user in the booking UI when present \u2014 the upstream data provider does not accept liability for booking problems caused by this not being displayed. Only populated when --settings included 'hotelTextPolicies'; null otherwise (does not mean the hotel has none \u2014 it means it wasn't requested)."
     }
   },
   example: {
@@ -1763,7 +1816,8 @@ var hotelDetailSchema = {
   },
   error_recovery: {
     UPSTREAM_ERROR: "Transient upstream error. Retry once after ~2s backoff.",
-    PARAM_INVALID: "Ensure --hotel-id is a non-empty string, then retry."
+    PARAM_INVALID: "Ensure --hotel-id is a non-empty string, then retry.",
+    HOTEL_NOT_FOUND: "The hotel is no longer available from the supplier (no matching hotel node in the upstream response). Do not retry with the same hotel_id \u2014 drop it from any local cache/mapping and re-search."
   }
 };
 var ORDERS_NOUN = "orders";
@@ -1829,6 +1883,254 @@ var unifiedOrdersGetSchema = {
     INTERNAL_ERROR: "The order's provider detail lookup is temporarily unavailable. Retry once after a short delay."
   }
 };
+function flightSchema(verb, description, flags, response, example, extra = {}) {
+  return { cli: CLI_NAME, noun: FLIGHT_NOUN, verb, description, flags, response, example, ...extra };
+}
+var flightFindAirportSchema = flightSchema(
+  "find-airport",
+  "Resolve free-text into city/airport candidates (city hits carry children airports).",
+  { keyword: { type: "string", required: true, description: "Free-text place/airport/city name." } },
+  { airports: { type: "array", description: "City/airport candidates with IATA codes." } },
+  { command: "agenzo-merchant-cli flight-flink find-airport --keyword beijing", output_summary: "Returns candidate city/airport IATA codes." }
+);
+var flightListAirportsSchema = flightSchema(
+  "list-airports",
+  "Paged airport dictionary (requires page + page-size).",
+  {
+    page: { type: "int", required: false, default: 1, description: "1-based page." },
+    "page-size": { type: "int", required: false, default: 20, description: "Items per page (1-100)." },
+    keyword: { type: "string", required: false, description: "Optional name filter." }
+  },
+  { airports: { type: "array", description: "Airport records." } },
+  { command: "agenzo-merchant-cli flight-flink list-airports --page 1 --page-size 20", output_summary: "Paged airport dictionary." }
+);
+var flightListAirlinesSchema = flightSchema(
+  "list-airlines",
+  "Paged airline dictionary (requires page + page-size).",
+  {
+    page: { type: "int", required: false, default: 1, description: "1-based page." },
+    "page-size": { type: "int", required: false, default: 20, description: "Items per page (1-100)." },
+    keyword: { type: "string", required: false, description: "Optional name filter." }
+  },
+  { airlines: { type: "array", description: "Airline records." } },
+  { command: "agenzo-merchant-cli flight-flink list-airlines --page 1 --page-size 20", output_summary: "Paged airline dictionary." }
+);
+var flightListNationalitiesSchema = flightSchema(
+  "list-nationalities",
+  "Nationality list (no params).",
+  {},
+  { nationalities: { type: "array", description: "Nationality codes/names." } },
+  { command: "agenzo-merchant-cli flight-flink list-nationalities", output_summary: "Nationality list." }
+);
+var flightSearchSchema = flightSchema(
+  "search",
+  "Search flights (one-way/round-trip/multi-city). journeys always carries all legs; journey-id accumulates progress and only the final search returns a real priceKey (product_token).",
+  {
+    "trip-type": { type: "int", required: true, description: "1=one-way, 2=round-trip, 3=multi-city." },
+    journeys: { type: "json", required: true, description: "JSON array of {date, origin, destination, origin_type?, destination_type?}. origin/destination are IATA 3-letter codes; *_type 1=city, 2=airport." },
+    "cabin-class": { type: "string", required: false, default: "economy", description: "economy | premium_economy | business | first." },
+    "adult-num": { type: "int", required: false, default: 1, description: "Adults (1-9)." },
+    "child-num": { type: "int", required: false, default: 0, description: "Children (0-9)." },
+    "infant-num": { type: "int", required: false, default: 0, description: "Infants (0-9)." },
+    airline: { type: "string", required: false, description: "Airline 2-letter code filter." },
+    "transfer-number": { type: "int", required: false, default: 0, description: "0=any,1=direct,2=1 stop,3=2 stops." },
+    "journey-id": { type: "json", required: false, description: "JSON array of already-selected journey ids (relay for round-trip/multi-city)." }
+  },
+  {
+    offers: { type: "array", description: "Offers; each has product_token (when price_key_ready), total_sale_price, currency." },
+    price_key_ready: { type: "bool", description: "True only when all legs are selected (final search)." },
+    journey_ids: { type: "array", description: "journeyId values to relay into the next search." }
+  },
+  { command: `agenzo-merchant-cli flight-flink search --trip-type 1 --journeys '[{"date":"2026-08-01","origin":"PEK","destination":"SHA"}]'`, output_summary: "Returns offers[]; use a product_token where price_key_ready is true, then verify." }
+);
+var flightMoreOffersSchema = flightSchema(
+  "more-offers",
+  "More fare offers for a priceKey (carried by product_token).",
+  { "product-token": { type: "string", required: true, description: "Opaque token from search." } },
+  { offers: { type: "array", description: "Additional fare candidates." } },
+  { command: "agenzo-merchant-cli flight-flink more-offers --product-token pt_...", output_summary: "Additional fare offers." }
+);
+var flightVerifySchema = flightSchema(
+  "verify",
+  "Pre-booking price verification. Returns the authoritative product_token and a price_changed flag; pass the returned token to create-order.",
+  { "product-token": { type: "string", required: true, description: "Opaque token from search." } },
+  {
+    product_token: { type: "string", description: "Authoritative token to pass to create-order." },
+    total_price: { type: "int", description: "Verified total price (integer)." },
+    currency: { type: "string", description: "Currency code." },
+    price_changed: { type: "bool", description: "True if the price changed since search; re-confirm with the user." }
+  },
+  { command: "agenzo-merchant-cli flight-flink verify --product-token pt_...", output_summary: "Returns the authoritative product_token + price_changed." }
+);
+var flightCreateOrderSchema = flightSchema(
+  "create-order",
+  "Create a flight order without charging (locks the fare, status AWAITING_PAYMENT). Forward the verify product_token and its total/currency verbatim.",
+  {
+    "product-token": { type: "string", required: true, description: "Authoritative token from verify." },
+    "total-amount": { type: "string", required: true, description: "Verified total price (decimal units)." },
+    currency: { type: "string", required: true, description: "ISO 4217 currency code." },
+    "trip-type": { type: "int", required: false, default: 1, description: "1/2/3." },
+    "contact-name": { type: "string", required: true, description: "Contact name." },
+    "contact-region": { type: "string", required: true, description: "Contact phone country code (no +)." },
+    "contact-phone": { type: "string", required: true, description: "Contact phone." },
+    "contact-email": { type: "string", required: true, description: "Contact email." },
+    passengers: { type: "json", required: true, description: 'JSON array of passengers. gender/id_type are STRINGS ("1"/"2"). child/infant require adult_passenger_name.' },
+    "idempotency-key": { type: "string", required: true, description: "Forwarded verbatim as the Idempotency-Key header." }
+  },
+  {
+    order_no: { type: "string", description: "Our order reference (ffo_...)." },
+    upstream_order_no: { type: "string", description: "Supplier order number." },
+    status: { type: "string", description: "AWAITING_PAYMENT after a successful create." },
+    total_amount: { type: "float", description: "Total amount." },
+    currency: { type: "string", description: "Currency code." }
+  },
+  { command: "agenzo-merchant-cli flight-flink create-order --product-token pt_... --total-amount 1200 --currency CNY --contact-name 'ZHANG SAN' --contact-region 86 --contact-phone 138... --contact-email a@b.com --passengers '[...]' --idempotency-key k1", output_summary: "Returns order_no; then pay-order to ticket." },
+  {
+    error_recovery: {
+      PRICE_CHANGED: "Price changed since verify. Re-run verify and confirm the new price with the user before retrying.",
+      ORDER_CREATE_FAILED: "Upstream create failed; funds released. Safe to retry with the same idempotency-key.",
+      IDEMPOTENCY_CONFLICT: "Same key reused with different params. Use a fresh idempotency-key."
+    }
+  }
+);
+var flightPayOrderSchema = flightSchema(
+  "pay-order",
+  "Settle a created order by --order-no (triggers upstream ticketing). AWAITING_PAYMENT \u2192 PAID.",
+  {
+    "order-no": { type: "string", required: true, description: "Our order reference from create-order." },
+    "idempotency-key": { type: "string", required: true, description: "Forwarded verbatim as the Idempotency-Key header." }
+  },
+  { order_no: { type: "string", description: "Our order reference." }, status: { type: "string", description: "PAID on success." } },
+  { command: "agenzo-merchant-cli flight-flink pay-order --order-no ffo_... --idempotency-key k2", output_summary: "Order becomes PAID; poll get-order until TICKETED." }
+);
+var flightGetOrderSchema = flightSchema(
+  "get-order",
+  "Query flight order status by --order-no. Ticketing is asynchronous \u2014 poll until TICKETED.",
+  {
+    "order-no": { type: "string", required: true, description: "Our order reference." },
+    watch: { type: "bool", required: false, default: false, description: "Poll until terminal, one NDJSON line per update." },
+    "watch-interval": { type: "int", required: false, default: 5, description: "Seconds between polls." },
+    "watch-timeout": { type: "int", required: false, default: 600, description: "Max seconds to poll." }
+  },
+  {
+    order_no: { type: "string", description: "Our order reference." },
+    status: { type: "string", description: "AWAITING_PAYMENT | PAID | TICKETING | TICKETED | CANCELLED | FAILED." },
+    ticket_infos: { type: "array", description: "Ticket numbers once TICKETED." }
+  },
+  { command: "agenzo-merchant-cli flight-flink get-order --order-no ffo_...", output_summary: "Returns status; poll until TICKETED." },
+  {
+    polling: {
+      recommended_interval_seconds: 5,
+      terminal_statuses: ["TICKETED", "CANCELLED", "FAILED"],
+      in_progress_statuses: ["AWAITING_PAYMENT", "PAID", "TICKETING"]
+    }
+  }
+);
+var flightCancelOrderSchema = flightSchema(
+  "cancel-order",
+  "Cancel an un-ticketed order by --order-no (with refund). A ticketed order is rejected upstream.",
+  {
+    "order-no": { type: "string", required: true, description: "Our order reference." },
+    reason: { type: "string", required: false, description: "Optional cancellation reason." },
+    "idempotency-key": { type: "string", required: true, description: "Forwarded verbatim as the Idempotency-Key header." }
+  },
+  { order_no: { type: "string", description: "Our order reference." }, status: { type: "string", description: "CANCELLED on success." }, refund_amount: { type: "float|null", description: "Refunded amount." } },
+  { command: "agenzo-merchant-cli flight-flink cancel-order --order-no ffo_... --idempotency-key k3", output_summary: "Order becomes CANCELLED; refund issued." }
+);
+var flightListOrdersSchema = flightSchema(
+  "list-orders",
+  "List the developer's flight orders (local read, no upstream call).",
+  {
+    status: { type: "string", required: false, description: "Optional status filter." },
+    page: { type: "int", required: false, default: 1, description: "1-based page." },
+    "page-size": { type: "int", required: false, default: 20, description: "Items per page (1-100)." }
+  },
+  { orders: { type: "array", description: "Flight order summaries." }, total: { type: "int", description: "Total count." } },
+  { command: "agenzo-merchant-cli flight-flink list-orders", output_summary: "Paged flight orders." }
+);
+var flightChangeSearchSchema = flightSchema(
+  "change-search",
+  "Search rebook-eligible flights for an order.",
+  {
+    "order-no": { type: "string", required: true, description: "Our order reference." },
+    date: { type: "string", required: true, description: "Target change date YYYY-MM-DD." },
+    passenger: { type: "string", required: true, description: "passengerCode." },
+    "segment-id": { type: "string", required: true, description: "Comma-separated segment ids." },
+    "cabin-class": { type: "string", required: false, default: "economy", description: "Cabin class." }
+  },
+  { flights: { type: "array", description: "Rebook-eligible flights." } },
+  { command: "agenzo-merchant-cli flight-flink change-search --order-no ffo_... --date 2026-08-05 --passenger P1 --segment-id S1", output_summary: "Rebook options." }
+);
+var flightChangeApplySchema = flightSchema(
+  "change-apply",
+  "Submit a change request. Returns change_order_no, status 0 (pending review).",
+  {
+    "order-no": { type: "string", required: true, description: "Our order reference." },
+    passenger: { type: "string", required: true, description: "passengerCode." },
+    "segment-id": { type: "string", required: true, description: "Comma-separated segment ids." },
+    "product-token": { type: "string", required: true, description: "Change priceKey token." },
+    "contact-name": { type: "string", required: true, description: "Contact name." },
+    "contact-region": { type: "string", required: true, description: "Contact region." },
+    "contact-phone": { type: "string", required: true, description: "Contact phone." },
+    "contact-email": { type: "string", required: true, description: "Contact email." },
+    "idempotency-key": { type: "string", required: true, description: "Idempotency-Key header." }
+  },
+  { change_order_no: { type: "string", description: "Change order number." }, status: { type: "int", description: "0 = pending review." } },
+  { command: "agenzo-merchant-cli flight-flink change-apply --order-no ffo_... --passenger P1 --segment-id S1 --product-token pt_... --contact-name X --contact-region 86 --contact-phone 138 --contact-email a@b.com --idempotency-key k4", output_summary: "Returns change_order_no; pay-order type=1 to confirm." }
+);
+var flightChangeDetailSchema = flightSchema(
+  "change-detail",
+  "Change request detail by --change-order-no.",
+  { "change-order-no": { type: "string", required: true, description: "Change order number." } },
+  { status: { type: "int", description: "Change status." } },
+  { command: "agenzo-merchant-cli flight-flink change-detail --change-order-no C1", output_summary: "Change request detail." }
+);
+var flightChangeCancelSchema = flightSchema(
+  "change-cancel",
+  "Cancel a change request (immediate terminal).",
+  {
+    "change-order-no": { type: "string", required: true, description: "Change order number." },
+    "idempotency-key": { type: "string", required: true, description: "Idempotency-Key header." }
+  },
+  { status: { type: "int", description: "Terminal 5 (cancelled)." } },
+  { command: "agenzo-merchant-cli flight-flink change-cancel --change-order-no C1 --idempotency-key k5", output_summary: "Change request cancelled." }
+);
+var flightRefundApplySchema = flightSchema(
+  "refund-apply",
+  "Submit a refund request. Returns refund_order_no, status 0 (pending review).",
+  {
+    "order-no": { type: "string", required: true, description: "Our order reference." },
+    passenger: { type: "string", required: true, description: "passengerCode." },
+    "segment-id": { type: "string", required: true, description: "Comma-separated segment ids." },
+    "reason-type": { type: "int", required: true, description: "Refund reason type code." },
+    reason: { type: "string", required: false, description: "Free-text reason." },
+    "contact-name": { type: "string", required: true, description: "Contact name." },
+    "contact-region": { type: "string", required: true, description: "Contact region." },
+    "contact-phone": { type: "string", required: true, description: "Contact phone." },
+    "contact-email": { type: "string", required: true, description: "Contact email." },
+    "idempotency-key": { type: "string", required: true, description: "Idempotency-Key header." }
+  },
+  { refund_order_no: { type: "string", description: "Refund order number." }, status: { type: "int", description: "0 = pending review." } },
+  { command: "agenzo-merchant-cli flight-flink refund-apply --order-no ffo_... --passenger P1 --segment-id S1 --reason-type 1 --contact-name X --contact-region 86 --contact-phone 138 --contact-email a@b.com --idempotency-key k6", output_summary: "Returns refund_order_no; refund-confirm 1 to confirm." }
+);
+var flightRefundDetailSchema = flightSchema(
+  "refund-detail",
+  "Refund request detail by --refund-order-no.",
+  { "refund-order-no": { type: "string", required: true, description: "Refund order number." } },
+  { status: { type: "int", description: "Refund status." } },
+  { command: "agenzo-merchant-cli flight-flink refund-detail --refund-order-no R1", output_summary: "Refund request detail." }
+);
+var flightRefundConfirmSchema = flightSchema(
+  "refund-confirm",
+  'Confirm ("1") or cancel ("2") a refund. Cancel takes effect immediately to terminal 5.',
+  {
+    "refund-order-no": { type: "string", required: true, description: "Refund order number." },
+    confirm: { type: "string", required: true, description: '"1" confirm / "2" cancel.' },
+    "idempotency-key": { type: "string", required: true, description: "Idempotency-Key header." }
+  },
+  { status: { type: "int", description: "Refund status after the action." } },
+  { command: "agenzo-merchant-cli flight-flink refund-confirm --refund-order-no R1 --confirm 1 --idempotency-key k7", output_summary: "Refund confirmed or cancelled." }
+);
 
 // src/ride-elife/quote.ts
 function need(value, flag) {
@@ -2435,6 +2737,72 @@ var SERVICE_REGISTRY = [
     discovery: {
       help_command: "agenzo-merchant-cli hotel-redaug --help"
     }
+  },
+  {
+    // 与后端 services/merchant_service/discovery/catalog.py 的 flight-flink 条目 + provider
+    // schema flight-flink.json 的 service_id 保持一致。Agent 拼命令用 cli_noun="flight-flink"。
+    service_id: "svc_01J0HT5FLINK0001",
+    name: "Flight booking (Flink)",
+    description: "International flight booking: airport/city resolution, one-way/round-trip/multi-city search with journeyId relay, price verification, two-step create-then-pay ticketing, order polling, plus change (rebooking) and refund flows.",
+    category: "flight",
+    version: "1.0.0",
+    provider: "flink",
+    cli_noun: "flight-flink",
+    verbs: [
+      "find-airport",
+      "list-airports",
+      "list-airlines",
+      "list-nationalities",
+      "search",
+      "more-offers",
+      "verify",
+      "create-order",
+      "pay-order",
+      "get-order",
+      "cancel-order",
+      "list-orders",
+      "change-search",
+      "change-apply",
+      "change-detail",
+      "change-cancel",
+      "refund-apply",
+      "refund-detail",
+      "refund-confirm"
+    ],
+    verb_descriptions: {
+      "find-airport": "Resolve free-text into city/airport candidates.",
+      "list-airports": "Paged airport dictionary.",
+      "list-airlines": "Paged airline dictionary.",
+      "list-nationalities": "Nationality list.",
+      search: "Search flights (one-way/round-trip/multi-city) with journeyId relay.",
+      "more-offers": "More fare offers for a priceKey.",
+      verify: "Verify the latest price before booking; returns the authoritative product_token.",
+      "create-order": "Create a flight order without charging (locks the fare).",
+      "pay-order": "Settle a created order by --order-no (triggers ticketing).",
+      "get-order": "Query order status (poll ticketing 5\u21928).",
+      "cancel-order": "Cancel an un-ticketed order (with refund).",
+      "list-orders": "List flight orders (local store, no upstream call).",
+      "change-search": "Search rebook-eligible flights.",
+      "change-apply": "Submit a change request (pending review).",
+      "change-detail": "Change request detail.",
+      "change-cancel": "Cancel a change request (immediate terminal).",
+      "refund-apply": "Submit a refund request (pending review).",
+      "refund-detail": "Refund request detail.",
+      "refund-confirm": 'Confirm ("1") or cancel ("2") a refund.'
+    },
+    workflow: [
+      "find-airport",
+      "search (relay journey-id for round-trip/multi-city)",
+      "verify",
+      "create-order (locks the fare, no charge)",
+      "pay-order (settles + ticketing)",
+      "get-order (poll until TICKETED)",
+      "change-* / refund-* / cancel-order (optional)"
+    ],
+    since: "2026-07-09",
+    discovery: {
+      help_command: "agenzo-merchant-cli flight-flink --help"
+    }
   }
 ];
 function findService(serviceId) {
@@ -2969,6 +3337,28 @@ function parsePriceItems(raw) {
   }
   return parsed;
 }
+function parseTips(raw) {
+  const INVALID = "--tips must be a JSON array of {title (string, optional), text (string, optional)}.";
+  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 (item.title !== void 0 && typeof item.title !== "string" || item.text !== void 0 && typeof item.text !== "string") {
+      throw new CliError("PARAM_INVALID", INVALID);
+    }
+  }
+  return parsed;
+}
 function need7(value, flag) {
   if (value === void 0) {
     throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
@@ -3019,7 +3409,13 @@ function formatCreateOrder(data) {
   return out.join("\n");
 }
 function registerHotelCreateOrderCommand(parent, deps) {
-  const cmd = parent.command("create-order").description("Create a hotel order without charging (lock inventory, await payment)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--product-token <token>", "Chosen rate token from quote (rates[].product_token)").option("--total-amount <amount>", "Total stay price in decimal currency units (not cents)").option("--currency <currency>", "ISO 4217 currency code from the chosen rate").option("--price-items <json>", "Per-night price breakdown JSON array (copied verbatim from quote)").option("--check-in <date>", "Check-in date (YYYY-MM-DD, match quote)").option("--check-out <date>", "Check-out date (YYYY-MM-DD, strictly after check-in)").option("--room-num <n>", "Number of rooms (match quote)", "1").option("--adults <n>", "Adults per room (match quote)", "2").option("--children <n>", "Children per room (match quote)", "0").option("--nationality <code>", "Guest nationality (ISO country code)", "CN").option("--guest-name <name>", "Primary guest name").option("--contact-name <name>", "Booking contact name (may equal guest-name)").option("--contact-phone <phone>", "Booking contact phone number (digits)").option("--contact-country-code <code>", "Phone country calling code without '+'", "86").option("--contact-email <email>", "Booking contact email").option("--arrive-time <time>", "Expected arrival time (HH:mm, hotel local time)").option("--special-requests <text>", "Free-text special requests (non-binding)").option("--hotel-name <name>", "Hotel name (display-only, stored for order summary)").option(
+  const cmd = parent.command("create-order").description("Create a hotel order without charging (lock inventory, await payment)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--product-token <token>", "Chosen rate token from quote (rates[].product_token)").option("--total-amount <amount>", "Total stay price in decimal currency units (not cents)").option("--currency <currency>", "ISO 4217 currency code from the chosen rate").option("--price-items <json>", "Per-night price breakdown JSON array (copied verbatim from quote)").option("--check-in <date>", "Check-in date (YYYY-MM-DD, match quote)").option("--check-out <date>", "Check-out date (YYYY-MM-DD, strictly after check-in)").option("--room-num <n>", "Number of rooms (match quote)", "1").option("--adults <n>", "Adults per room (match quote)", "2").option("--children <n>", "Children per room (match quote)", "0").option("--nationality <code>", "Guest nationality (ISO country code)", "CN").option("--guest-name <name>", "Primary guest name").option("--contact-name <name>", "Booking contact name (may equal guest-name)").option("--contact-phone <phone>", "Booking contact phone number (digits)").option("--contact-country-code <code>", "Phone country calling code without '+'", "86").option("--contact-email <email>", "Booking contact email").option("--arrive-time <time>", "Expected arrival time (HH:mm, hotel local time)").option("--special-requests <text>", "Free-text special requests (non-binding)").option(
+    "--tips <json>",
+    "\u5BA2\u6237\u81EA\u6D4B\u70B95 \u63D0\u793A\u4FE1\u606F: the chosen quote rate's tips as a JSON array [{title,text}]. Stored on the order for the order-detail page ONLY \u2014 platform-local, not sent upstream."
+  ).option("--hotel-name <name>", "Hotel name (display-only, stored for order summary)").option(
+    "--bed-type <code>",
+    "Product bed-type code from the chosen quote rate's beds[].code (e.g. 'L000000' King / '1000000' Queen); forwarded verbatim to upstream createOrder bedType."
+  ).option(
     "--payment-token-id <id>",
     "UPI Agent Pay: payment token id from an already-completed UnionPay network-token capture. When set, the platform skips EVO preauth/capture and only locks the order + records this credential (funds already charged)."
   ).option(
@@ -3066,7 +3462,9 @@ function registerHotelCreateOrderCommand(parent, deps) {
     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.tips !== void 0) body.tips = parseTips(opts.tips);
     if (opts.hotelName !== void 0) body.hotel_name = opts.hotelName;
+    if (opts.bedType !== void 0) body.bed_type = opts.bedType;
     if (opts.paymentTokenId !== void 0) body.payment_token_id = opts.paymentTokenId;
     if (!isYes) {
       const chargeNote = opts.paymentTokenId !== void 0 ? "Payment has already been captured via UPI Agent Pay; this only locks the room." : "This locks the rate but does NOT charge anything yet.";
@@ -3456,7 +3854,6 @@ function registerHotelGetCommand(parent, deps) {
 }
 
 // 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}.`);
@@ -3514,15 +3911,6 @@ function registerHotelCancelCommand(parent, deps) {
     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"
@@ -3549,7 +3937,7 @@ function registerHotelCancelCommand(parent, deps) {
 }
 
 // src/hotel-redaug/checkout.ts
-import { confirm as confirm6 } from "@inquirer/prompts";
+import { confirm as confirm5 } from "@inquirer/prompts";
 function need10(value, flag) {
   if (value === void 0) {
     throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
@@ -3635,7 +4023,7 @@ function registerHotelCheckoutCommand(parent, deps) {
       checkout_rooms: checkoutRooms
     };
     if (!isYes) {
-      const confirmed = await confirm6({
+      const confirmed = await confirm5({
         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
       });
@@ -4037,6 +4425,23 @@ function need15(value, flag) {
   }
   return value;
 }
+function parseSettings(value) {
+  if (value === void 0 || value.trim() === "") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  if (trimmed.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (Array.isArray(parsed) && parsed.every((v) => typeof v === "string")) {
+        return parsed;
+      }
+    } catch {
+    }
+    throw new CliError("PARAM_INVALID", "Invalid --settings JSON array.");
+  }
+  return trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+}
 function formatHotelDetail(data) {
   const lines = [];
   const kvPairs = [
@@ -4059,6 +4464,10 @@ function formatHotelDetail(data) {
     ["Room Count", String(data.room_num ?? "-")]
   ];
   lines.push(Formatter.keyValue(kvPairs));
+  if (data.special_instructions) {
+    lines.push("");
+    lines.push(Formatter.status("warning", `Special Check-in Instructions: ${data.special_instructions}`));
+  }
   const facilities = data.facilities ?? [];
   if (facilities.length > 0) {
     lines.push("");
@@ -4116,10 +4525,39 @@ function formatHotelDetail(data) {
     lines.push("");
     lines.push(Formatter.status("info", "No room-type details available"));
   }
+  const comments = data.comment ?? [];
+  if (comments.length > 0) {
+    lines.push("");
+    lines.push("Review Scores:");
+    const headers = ["Channel", "Average Score"];
+    const rows = comments.map((c) => [String(c.channel ?? "-"), String(c.average_score ?? "-")]);
+    lines.push(Formatter.table(headers, rows));
+  }
+  const certs = data.hotel_certificates ?? [];
+  if (certs.length > 0) {
+    lines.push("");
+    lines.push("Certificates:");
+    const headers = ["Name", "Unify Code"];
+    const rows = certs.map((c) => [String(c.certification_name ?? "-"), String(c.unify_code ?? "-")]);
+    lines.push(Formatter.table(headers, rows));
+  }
+  const textPolicies = (data.hotel_text_policies ?? []).filter(
+    (p) => p.code !== "specialInstructions"
+  );
+  if (textPolicies.length > 0) {
+    lines.push("");
+    lines.push("Hotel Policies:");
+    const headers = ["Policy", "Text"];
+    const rows = textPolicies.map((p) => [String(p.code_name ?? p.code ?? "-"), String(p.text ?? "-")]);
+    lines.push(Formatter.table(headers, rows));
+  }
   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);
+  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).option(
+    "--settings <list>",
+    "Optional on-demand upstream fields, comma-separated or JSON array (hotelFacilityNew, breakfast, importantNotices, parking, chargingParking, hotelCertificates, comment, hotelMeetingInfos, hotelVideoInfos, hotelTextPolicies, hotelStructuredPolicies.childPolicy, hotelStructuredPolicies.extraBedPolicy, hotelStructuredPolicies.petPolicy). Pass hotelTextPolicies to get special_instructions."
+  );
   attachSchemaHelp(cmd, hotelDetailSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -4131,10 +4569,14 @@ function registerHotelDetailCommand(parent, deps) {
     const hotelId = need15(opts.hotelId, "hotel-id");
     const rawWithImages = opts.withImages;
     const withImages = rawWithImages !== "false" && rawWithImages !== false;
+    const settings = parseSettings(opts.settings);
     const body = {
       hotel_id: hotelId,
       with_images: withImages
     };
+    if (settings !== void 0) {
+      body.settings = settings;
+    }
     const result = await deps.apiClient.post(
       "/hotel/detail",
       { type: "api-key", key: apiKey },
@@ -4331,6 +4773,763 @@ function registerHotelSkillCommand(parent) {
   });
 }
 
+// src/flight-flink/_helpers.ts
+function need16(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function num8(value, flag) {
+  const n = Number(need16(value, flag));
+  if (!Number.isFinite(n)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
+  }
+  return n;
+}
+function jsonArray(raw, flag) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a JSON array.`);
+  }
+  if (!Array.isArray(parsed)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a JSON array.`);
+  }
+  return parsed;
+}
+function resolveApiKey(flag) {
+  return PromptEngine.resolveInput(flag, { message: "API Key:", type: "password" });
+}
+async function render2(data, format, text) {
+  const resolved = resolveFormat(format);
+  const result = { data, text: () => text(data) };
+  await renderWithContext(result, { format: resolved }, new ConfigManager());
+}
+
+// src/flight-flink/find-airport.ts
+function registerFindAirportCommand(parent, deps) {
+  const cmd = parent.command("find-airport").description("Resolve free-text into city/airport candidates").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--keyword <text>", "Free-text place/airport/city name");
+  attachSchemaHelp(cmd, flightFindAirportSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const keyword = need16(opts.keyword, "keyword");
+    const spinner = format === "json" ? null : createSpinner("Resolving airports...");
+    const result = await deps.apiClient.post(
+      "/flight/find-airport",
+      { type: "api-key", key: apiKey },
+      { keyword }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(
+      result.data,
+      opts.format,
+      (d) => JSON.stringify(d.airports ?? d, null, 2)
+    );
+  });
+}
+
+// src/flight-flink/list-airports.ts
+function registerListAirportsCommand(parent, deps) {
+  const cmd = parent.command("list-airports").description("Paged airport dictionary").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--page <n>", "Page (1-based)", "1").option("--page-size <n>", "Items per page (1-100)", "20").option("--keyword <text>", "Optional name filter");
+  attachSchemaHelp(cmd, flightListAirportsSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const body = {
+      page: num8(opts.page, "page"),
+      page_size: num8(opts.pageSize, "page-size")
+    };
+    if (opts.keyword !== void 0) body.keyword = opts.keyword;
+    const spinner = format === "json" ? null : createSpinner("Fetching airports...");
+    const result = await deps.apiClient.post(
+      "/flight/airports",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/list-airlines.ts
+function registerListAirlinesCommand(parent, deps) {
+  const cmd = parent.command("list-airlines").description("Paged airline dictionary").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--page <n>", "Page (1-based)", "1").option("--page-size <n>", "Items per page (1-100)", "20").option("--keyword <text>", "Optional name filter");
+  attachSchemaHelp(cmd, flightListAirlinesSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const body = {
+      page: num8(opts.page, "page"),
+      page_size: num8(opts.pageSize, "page-size")
+    };
+    if (opts.keyword !== void 0) body.keyword = opts.keyword;
+    const spinner = format === "json" ? null : createSpinner("Fetching airlines...");
+    const result = await deps.apiClient.post(
+      "/flight/airlines",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/list-nationalities.ts
+function registerListNationalitiesCommand(parent, deps) {
+  const cmd = parent.command("list-nationalities").description("Nationality list").option("--api-key <key>", "API Key for authentication (X-Api-Key)");
+  attachSchemaHelp(cmd, flightListNationalitiesSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const spinner = format === "json" ? null : createSpinner("Fetching nationalities...");
+    const result = await deps.apiClient.post(
+      "/flight/nationalities",
+      { type: "api-key", key: apiKey },
+      {}
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/search.ts
+function registerSearchCommand(parent, deps) {
+  const cmd = parent.command("search").description("Search flights (one-way/round-trip/multi-city, journeyId relay)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--trip-type <n>", "1=one-way, 2=round-trip, 3=multi-city").option("--journeys <json>", "JSON array of {date, origin, destination, origin_type?, destination_type?}").option("--cabin-class <c>", "economy | premium_economy | business | first", "economy").option("--adult-num <n>", "Adults (1-9)", "1").option("--child-num <n>", "Children (0-9)", "0").option("--infant-num <n>", "Infants (0-9)", "0").option("--airline <code>", "Airline 2-letter code filter").option("--transfer-number <n>", "0=any,1=direct,2=1 stop,3=2 stops", "0").option("--journey-id <json>", "JSON array of already-selected journey ids (relay)");
+  attachSchemaHelp(cmd, flightSearchSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const body = {
+      trip_type: num8(opts.tripType, "trip-type"),
+      journeys: jsonArray(need16(opts.journeys, "journeys"), "journeys"),
+      cabin_class: opts.cabinClass,
+      adult_num: num8(opts.adultNum, "adult-num"),
+      child_num: num8(opts.childNum, "child-num"),
+      infant_num: num8(opts.infantNum, "infant-num"),
+      transfer_number: num8(opts.transferNumber, "transfer-number")
+    };
+    if (opts.airline !== void 0) body.airline = opts.airline;
+    if (opts.journeyId !== void 0) {
+      body.journey_id = jsonArray(opts.journeyId, "journey-id");
+    }
+    const spinner = format === "json" ? null : createSpinner("Searching flights...");
+    const result = await deps.apiClient.post(
+      "/flight/search",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/more-offers.ts
+function registerMoreOffersCommand(parent, deps) {
+  const cmd = parent.command("more-offers").description("More fare offers for a priceKey (carried by product_token)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--product-token <token>", "Opaque token from search");
+  attachSchemaHelp(cmd, flightMoreOffersSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const productToken = need16(opts.productToken, "product-token");
+    const spinner = format === "json" ? null : createSpinner("Fetching offers...");
+    const result = await deps.apiClient.post(
+      "/flight/more-offers",
+      { type: "api-key", key: apiKey },
+      { product_token: productToken }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/verify.ts
+function registerVerifyCommand(parent, deps) {
+  const cmd = parent.command("verify").description("Verify the latest price before booking; returns the authoritative product_token").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--product-token <token>", "Opaque token from search");
+  attachSchemaHelp(cmd, flightVerifySchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const productToken = need16(opts.productToken, "product-token");
+    const spinner = format === "json" ? null : createSpinner("Verifying price...");
+    const result = await deps.apiClient.post(
+      "/flight/verify",
+      { type: "api-key", key: apiKey },
+      { product_token: productToken }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(
+      result.data,
+      opts.format,
+      (d) => Formatter.keyValue([
+        ["Product token", String(d.product_token ?? "-")],
+        ["Total price", `${d.total_price ?? "-"} ${d.currency ?? ""}`.trim()],
+        ["Price changed", String(d.price_changed)]
+      ])
+    );
+  });
+}
+
+// src/flight-flink/create-order.ts
+import { confirm as confirm6 } from "@inquirer/prompts";
+function registerCreateOrderCommand(parent, deps) {
+  const cmd = parent.command("create-order").description("Create a flight order without charging (locks the fare, await payment)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--product-token <token>", "Authoritative rate token from verify").option("--total-amount <amount>", "Verified total price in decimal units").option("--currency <currency>", "ISO 4217 currency code").option("--trip-type <n>", "1/2/3", "1").option("--contact-name <name>", "Booking contact name").option("--contact-region <code>", "Contact phone country code (no '+')").option("--contact-phone <phone>", "Booking contact phone").option("--contact-email <email>", "Booking contact email").option("--passengers <json>", "JSON array of passengers (gender/id_type are strings)").option("--payment-method-id <id>", "Optional bound-card id (pay_per_call only)").option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  attachSchemaHelp(cmd, flightCreateOrderSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const productToken = need16(opts.productToken, "product-token");
+    const totalAmount = num8(opts.totalAmount, "total-amount");
+    const currency = need16(opts.currency, "currency");
+    const body = {
+      product_token: productToken,
+      total_amount: totalAmount,
+      currency,
+      trip_type: num8(opts.tripType, "trip-type"),
+      contact_name: need16(opts.contactName, "contact-name"),
+      contact_region: need16(opts.contactRegion, "contact-region"),
+      contact_phone: need16(opts.contactPhone, "contact-phone"),
+      contact_email: need16(opts.contactEmail, "contact-email"),
+      passengers: jsonArray(need16(opts.passengers, "passengers"), "passengers")
+    };
+    if (opts.paymentMethodId !== void 0) body.payment_method_id = opts.paymentMethodId;
+    if (!isYes) {
+      const ok = await confirm6({
+        message: `Create this flight order for ${totalAmount} ${currency}? This locks the fare but does NOT charge yet.`,
+        default: false
+      });
+      if (!ok) throw new CliError("CLIENT_ABORTED", "Order creation aborted by user.");
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "flight-flink create-order"
+    });
+    const spinner = format === "json" ? null : createSpinner("Creating flight order...");
+    const result = await deps.apiClient.post(
+      "/flight/create-order",
+      { type: "api-key", key: apiKey },
+      body,
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(
+      result.data,
+      opts.format,
+      (d) => [
+        Formatter.keyValue([
+          ["Order no", String(d.order_no ?? "-")],
+          ["Upstream order no", String(d.upstream_order_no ?? "-")],
+          ["Status", String(d.status ?? "-")],
+          ["Total amount", `${d.total_amount ?? "-"} ${d.currency ?? ""}`.trim()]
+        ]),
+        Formatter.status(
+          "info",
+          `Order created (AWAITING_PAYMENT) \u2014 settle with 'flight-flink pay-order --order-no ${d.order_no ?? "<order_no>"}'.`
+        )
+      ].join("\n\n")
+    );
+  });
+}
+
+// src/flight-flink/pay-order.ts
+import { confirm as confirm7 } from "@inquirer/prompts";
+function registerPayOrderCommand(parent, deps) {
+  const cmd = parent.command("pay-order").description("Settle a created order by --order-no (triggers ticketing)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-no <id>", "Our order reference from create-order").option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  attachSchemaHelp(cmd, flightPayOrderSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const orderNo = need16(opts.orderNo, "order-no");
+    if (!isYes) {
+      const ok = await confirm7({
+        message: `Pay and ticket order ${orderNo}? This settles the order and issues tickets.`,
+        default: false
+      });
+      if (!ok) throw new CliError("CLIENT_ABORTED", "Payment aborted by user.");
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "flight-flink pay-order"
+    });
+    const spinner = format === "json" ? null : createSpinner("Paying flight order...");
+    const result = await deps.apiClient.post(
+      `/flight/${encodeURIComponent(orderNo)}/pay`,
+      { type: "api-key", key: apiKey },
+      {},
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(
+      result.data,
+      opts.format,
+      (d) => Formatter.keyValue([
+        ["Order no", String(d.order_no ?? "-")],
+        ["Status", String(d.status ?? "-")],
+        ["Amount", `${d.amount ?? "-"} ${d.currency ?? ""}`.trim()]
+      ])
+    );
+  });
+}
+
+// src/flight-flink/get-order.ts
+var TERMINAL = /* @__PURE__ */ new Set(["TICKETED", "CANCELLED", "FAILED"]);
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+function registerGetOrderCommand(parent, deps) {
+  const cmd = parent.command("get-order").description("Query a flight order status by id (poll ticketing 5\u21928)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-no <id>", "Our order reference").option("--watch", "Poll until a terminal status, one NDJSON line per update").option("--watch-interval <seconds>", "Seconds between polls", "5").option("--watch-timeout <seconds>", "Max seconds to poll", "600");
+  attachSchemaHelp(cmd, flightGetOrderSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const orderNo = need16(opts.orderNo, "order-no");
+    const path = `/flight/${encodeURIComponent(orderNo)}/status`;
+    const auth = { type: "api-key", key: apiKey };
+    if (opts.watch) {
+      const interval = num8(opts.watchInterval, "watch-interval") * 1e3;
+      const timeoutMs = num8(opts.watchTimeout, "watch-timeout") * 1e3;
+      const deadline = Date.now() + timeoutMs;
+      for (; ; ) {
+        const r = await deps.apiClient.get(path, auth);
+        if (!r.success) throw CliError.fromApi(r, { auth: "api-key" });
+        process.stdout.write(`${JSON.stringify(r.data)}
+`);
+        if (TERMINAL.has(String(r.data.status))) return;
+        if (Date.now() + interval >= deadline) {
+          process.stdout.write(`${JSON.stringify({ watch_status: "timeout", order_no: orderNo })}
+`);
+          return;
+        }
+        await sleep(interval);
+      }
+    }
+    const spinner = format === "json" ? null : createSpinner("Fetching flight order status...");
+    const result = await deps.apiClient.get(path, auth);
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(
+      result.data,
+      opts.format,
+      (d) => Formatter.keyValue([
+        ["Order no", String(d.order_no ?? "-")],
+        ["Upstream order no", String(d.upstream_order_no ?? "-")],
+        ["PNR", String(d.pnr ?? "-")],
+        ["Status", String(d.status ?? "-")],
+        ["Total amount", `${d.total_amount ?? "-"} ${d.currency ?? ""}`.trim()]
+      ])
+    );
+  });
+}
+
+// src/flight-flink/cancel-order.ts
+import { confirm as confirm8 } from "@inquirer/prompts";
+function registerCancelOrderCommand(parent, deps) {
+  const cmd = parent.command("cancel-order").description("Cancel an un-ticketed flight order (with refund)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-no <id>", "Our order reference").option("--reason <text>", "Optional cancellation reason").option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  attachSchemaHelp(cmd, flightCancelOrderSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const orderNo = need16(opts.orderNo, "order-no");
+    if (!isYes) {
+      const ok = await confirm8({
+        message: `Cancel order ${orderNo}? This requests cancellation and a refund.`,
+        default: false
+      });
+      if (!ok) throw new CliError("CLIENT_ABORTED", "Cancellation aborted by user.");
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "flight-flink cancel-order"
+    });
+    const body = {};
+    if (opts.reason !== void 0) body.reason = opts.reason;
+    const spinner = format === "json" ? null : createSpinner("Cancelling flight order...");
+    const result = await deps.apiClient.post(
+      `/flight/${encodeURIComponent(orderNo)}/cancel`,
+      { type: "api-key", key: apiKey },
+      body,
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(
+      result.data,
+      opts.format,
+      (d) => Formatter.keyValue([
+        ["Order no", String(d.order_no ?? "-")],
+        ["Status", String(d.status ?? "-")],
+        ["Refund amount", `${d.refund_amount ?? "-"} ${d.currency ?? ""}`.trim()]
+      ])
+    );
+  });
+}
+
+// src/flight-flink/list-orders.ts
+function registerListOrdersCommand2(parent, deps) {
+  const cmd = parent.command("list-orders").description("List the developer's flight orders (local read, no upstream call)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--status <status>", "Optional status filter").option("--page <n>", "Page (1-based)", "1").option("--page-size <n>", "Items per page (1-100)", "20");
+  attachSchemaHelp(cmd, flightListOrdersSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const params = new URLSearchParams();
+    if (opts.status !== void 0) params.set("status", opts.status);
+    params.set("page", String(num8(opts.page, "page")));
+    params.set("page_size", String(num8(opts.pageSize, "page-size")));
+    const spinner = format === "json" ? null : createSpinner("Fetching flight orders...");
+    const result = await deps.apiClient.get(
+      `/flight/orders?${params.toString()}`,
+      { type: "api-key", key: apiKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => {
+      const rows = (d.orders ?? []).map((o) => [
+        String(o.order_no ?? "-"),
+        String(o.status ?? "-"),
+        `${o.total_amount ?? "-"} ${o.currency ?? ""}`.trim()
+      ]);
+      return Formatter.table(["Order no", "Status", "Amount"], rows);
+    });
+  });
+}
+
+// src/flight-flink/change-search.ts
+function registerChangeSearchCommand(parent, deps) {
+  const cmd = parent.command("change-search").description("Search rebook-eligible flights for an order").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-no <id>", "Our order reference").option("--date <date>", "Target change date YYYY-MM-DD").option("--passenger <code>", "passengerCode").option("--segment-id <ids>", "Comma-separated segment ids").option("--cabin-class <c>", "Cabin class", "economy");
+  attachSchemaHelp(cmd, flightChangeSearchSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const body = {
+      order_no: need16(opts.orderNo, "order-no"),
+      date: need16(opts.date, "date"),
+      passenger: need16(opts.passenger, "passenger"),
+      segment_id: need16(opts.segmentId, "segment-id"),
+      cabin_class: opts.cabinClass
+    };
+    const spinner = format === "json" ? null : createSpinner("Searching change options...");
+    const result = await deps.apiClient.post(
+      "/flight/change/search",
+      { type: "api-key", key: apiKey },
+      body
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/change-apply.ts
+import { confirm as confirm9 } from "@inquirer/prompts";
+function registerChangeApplyCommand(parent, deps) {
+  const cmd = parent.command("change-apply").description("Submit a change request (returns change_order_no, pending review)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-no <id>", "Our order reference").option("--passenger <code>", "passengerCode").option("--segment-id <ids>", "Comma-separated segment ids").option("--product-token <token>", "Change priceKey token").option("--contact-name <name>", "Contact name").option("--contact-region <code>", "Contact region").option("--contact-phone <phone>", "Contact phone").option("--contact-email <email>", "Contact email").option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  attachSchemaHelp(cmd, flightChangeApplySchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const body = {
+      order_no: need16(opts.orderNo, "order-no"),
+      passenger: need16(opts.passenger, "passenger"),
+      segment_id: need16(opts.segmentId, "segment-id"),
+      product_token: need16(opts.productToken, "product-token"),
+      contact_name: need16(opts.contactName, "contact-name"),
+      contact_region: need16(opts.contactRegion, "contact-region"),
+      contact_phone: need16(opts.contactPhone, "contact-phone"),
+      contact_email: need16(opts.contactEmail, "contact-email")
+    };
+    if (!isYes) {
+      const ok = await confirm9({
+        message: `Submit a change request for order ${body.order_no}?`,
+        default: false
+      });
+      if (!ok) throw new CliError("CLIENT_ABORTED", "Change request aborted by user.");
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "flight-flink change-apply"
+    });
+    const spinner = format === "json" ? null : createSpinner("Submitting change request...");
+    const result = await deps.apiClient.post(
+      "/flight/change/apply",
+      { type: "api-key", key: apiKey },
+      body,
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/change-detail.ts
+function registerChangeDetailCommand(parent, deps) {
+  const cmd = parent.command("change-detail").description("Change request detail by change order number").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--change-order-no <id>", "Change order number");
+  attachSchemaHelp(cmd, flightChangeDetailSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const changeOrderNo = need16(opts.changeOrderNo, "change-order-no");
+    const spinner = format === "json" ? null : createSpinner("Fetching change detail...");
+    const result = await deps.apiClient.get(
+      `/flight/change/${encodeURIComponent(changeOrderNo)}`,
+      { type: "api-key", key: apiKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/change-cancel.ts
+import { confirm as confirm10 } from "@inquirer/prompts";
+function registerChangeCancelCommand(parent, deps) {
+  const cmd = parent.command("change-cancel").description("Cancel a change request (immediate terminal)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--change-order-no <id>", "Change order number").option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  attachSchemaHelp(cmd, flightChangeCancelSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const changeOrderNo = need16(opts.changeOrderNo, "change-order-no");
+    if (!isYes) {
+      const ok = await confirm10({ message: `Cancel change request ${changeOrderNo}?`, default: false });
+      if (!ok) throw new CliError("CLIENT_ABORTED", "Change cancellation aborted by user.");
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "flight-flink change-cancel"
+    });
+    const spinner = format === "json" ? null : createSpinner("Cancelling change request...");
+    const result = await deps.apiClient.post(
+      `/flight/change/${encodeURIComponent(changeOrderNo)}/cancel`,
+      { type: "api-key", key: apiKey },
+      {},
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/refund-apply.ts
+import { confirm as confirm11 } from "@inquirer/prompts";
+function registerRefundApplyCommand(parent, deps) {
+  const cmd = parent.command("refund-apply").description("Submit a refund request (returns refund_order_no, pending review)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-no <id>", "Our order reference").option("--passenger <code>", "passengerCode").option("--segment-id <ids>", "Comma-separated segment ids").option("--reason-type <n>", "Refund reason type code").option("--reason <text>", "Free-text reason").option("--contact-name <name>", "Contact name").option("--contact-region <code>", "Contact region").option("--contact-phone <phone>", "Contact phone").option("--contact-email <email>", "Contact email").option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  attachSchemaHelp(cmd, flightRefundApplySchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const body = {
+      order_no: need16(opts.orderNo, "order-no"),
+      passenger: need16(opts.passenger, "passenger"),
+      segment_id: need16(opts.segmentId, "segment-id"),
+      reason_type: num8(opts.reasonType, "reason-type"),
+      contact_name: need16(opts.contactName, "contact-name"),
+      contact_region: need16(opts.contactRegion, "contact-region"),
+      contact_phone: need16(opts.contactPhone, "contact-phone"),
+      contact_email: need16(opts.contactEmail, "contact-email")
+    };
+    if (opts.reason !== void 0) body.reason = opts.reason;
+    if (!isYes) {
+      const ok = await confirm11({
+        message: `Submit a refund request for order ${body.order_no}?`,
+        default: false
+      });
+      if (!ok) throw new CliError("CLIENT_ABORTED", "Refund request aborted by user.");
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "flight-flink refund-apply"
+    });
+    const spinner = format === "json" ? null : createSpinner("Submitting refund request...");
+    const result = await deps.apiClient.post(
+      "/flight/refund/apply",
+      { type: "api-key", key: apiKey },
+      body,
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/refund-detail.ts
+function registerRefundDetailCommand(parent, deps) {
+  const cmd = parent.command("refund-detail").description("Refund request detail by refund order number").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--refund-order-no <id>", "Refund order number");
+  attachSchemaHelp(cmd, flightRefundDetailSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const refundOrderNo = need16(opts.refundOrderNo, "refund-order-no");
+    const spinner = format === "json" ? null : createSpinner("Fetching refund detail...");
+    const result = await deps.apiClient.get(
+      `/flight/refund/${encodeURIComponent(refundOrderNo)}`,
+      { type: "api-key", key: apiKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/refund-confirm.ts
+import { confirm as confirm12 } from "@inquirer/prompts";
+function registerRefundConfirmCommand(parent, deps) {
+  const cmd = parent.command("refund-confirm").description('Confirm ("1") or cancel ("2") a refund').option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--refund-order-no <id>", "Refund order number").option("--confirm <flag>", '"1" confirm / "2" cancel').option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  attachSchemaHelp(cmd, flightRefundConfirmSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const isYes = Boolean(opts.yes);
+    const apiKey = await resolveApiKey(opts.apiKey);
+    const refundOrderNo = need16(opts.refundOrderNo, "refund-order-no");
+    const confirmFlag = need16(opts.confirm, "confirm");
+    if (confirmFlag !== "1" && confirmFlag !== "2") {
+      throw new CliError("PARAM_INVALID", '--confirm must be "1" (confirm) or "2" (cancel).');
+    }
+    if (!isYes) {
+      const action = confirmFlag === "1" ? "confirm" : "cancel";
+      const ok = await confirm12({ message: `${action} refund ${refundOrderNo}?`, default: false });
+      if (!ok) throw new CliError("CLIENT_ABORTED", "Refund confirmation aborted by user.");
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "flight-flink refund-confirm"
+    });
+    const spinner = format === "json" ? null : createSpinner("Processing refund confirmation...");
+    const result = await deps.apiClient.post(
+      `/flight/refund/${encodeURIComponent(refundOrderNo)}/confirm`,
+      { type: "api-key", key: apiKey },
+      { confirm: confirmFlag },
+      { "Idempotency-Key": idempotencyKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render2(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/flight-flink/skill.ts
+var SKILL_TEXT2 = `
+---
+name: flight-flink
+description: Search, book, and manage international flight reservations. Two-step create-then-pay ticketing with journeyId relay for round-trip/multi-city, plus change (rebooking) and refund flows. Use when the user wants to find flights, verify a fare, book a ticket, or view/cancel/change/refund an existing flight order. Not for hotels or rides.
+---
+
+# flight-flink \u2014 Agent Skill
+
+You orchestrate flight bookings through CLI verbs. This guide covers HOW to chain
+verbs and pass data between them. For exact flags and field types, read the schema
+(\`flight-flink <verb> --help --format json\`).
+
+## Prerequisites
+- API key with merchant scope. Pass --api-key <key> --format json on every call; add --yes on writes.
+- Billing is decided server-side by the developer's billing_mode (monthly_settlement or pay_per_call).
+
+## Workflow (book)
+1. find-airport --keyword "<place>"    \u2192 resolve to IATA city/airport codes
+2. search --trip-type <1|2|3> --journeys '<json>'
+   - journeys ALWAYS carries ALL legs. For round-trip/multi-city, relay journey-id
+     from the previous search into the next until price_key_ready is true.
+   - Only offers where price_key_ready is true carry a real product_token; earlier-leg
+     offers carry only an identifier (product_token null).
+   - Code<->type consistency: tag each code with its matching type \u2014 an AIRPORT code (e.g. NRT)
+     uses type 2, a CITY code (e.g. TYO) uses type 1. Mislabeling (e.g. NRT with type 1, since NRT
+     is an airport whose city is TYO) is rejected with code 400 "destination not exist".
+     find-airport returns the correct type per candidate (city hit \u2192 type 1 with children airports;
+     airport hit \u2192 type 2) \u2014 pass code + type together verbatim.
+3. verify --product-token <token from search>
+   - Returns the authoritative product_token + price_changed. If price_changed, re-confirm
+     the new price with the user before booking. Pass the RETURNED token to create-order.
+4. create-order --product-token <verify token> --total-amount <verify total> --currency <cur>
+     --contact-* --passengers '<json>' --idempotency-key <k>
+   - Locks the fare, NO charge. Order status \u2192 AWAITING_PAYMENT. Save order_no.
+   - passengers: gender/id_type are STRINGS ("1"/"2"); child/infant require adult_passenger_name.
+5. pay-order --order-no <order_no> --idempotency-key <k>
+   - Settles + triggers ticketing. Status \u2192 PAID.
+6. get-order --order-no <order_no> [--watch]
+   - Ticketing is asynchronous. Poll until TICKETED (ticket_infos populated). Do NOT
+     report success before TICKETED. Single-passenger orders ticket in ~100-110s;
+     multi-passenger orders (adult+child+infant) take longer (150s+) \u2014 widen --watch-timeout
+     for multi-passenger bookings; still TICKETING past 150s is normal, not a failure.
+
+## Change (rebooking)
+- change-search \u2192 change-apply (returns change_order_no) \u2192 change-detail
+- Confirm branch: pay-order the change order (settlement). Cancel branch: change-cancel.
+
+## Refund
+- refund-apply (returns refund_order_no) \u2192 refund-detail \u2192 refund-confirm --confirm 1 (confirm)
+  or --confirm 2 (cancel). Cancel takes effect immediately.
+
+## Cancel (un-ticketed order)
+- cancel-order --order-no <order_no> --idempotency-key <k>  \u2192 CANCELLED + refund.
+  A ticketed order is rejected upstream \u2014 use refund-apply instead.
+
+## Data passing
+- product_token : search \u2192 verify \u2192 create-order (opaque; never fabricate or edit; verify's token wins)
+- order_no      : create-order \u2192 pay-order / get-order / cancel-order
+- journey_id    : search \u2192 next search (relay for round-trip/multi-city)
+- change_order_no / refund_order_no : *-apply \u2192 *-detail / *-confirm / pay-order (change)
+
+## Invariants
+- Never create-order without a fresh verify (tokens/prices change).
+- Never claim "booked" until get-order returns TICKETED.
+- create-order and pay-order are separate steps; create-order does NOT charge.
+- Write verbs (create-order/pay-order/cancel-order/change-apply/change-cancel/refund-apply/
+  refund-confirm) always need --idempotency-key; reuse the SAME key when retrying the same intent.
+- --yes only skips this CLI's interactive prompt (for non-interactive Agents); it does NOT
+  remove the requirement to confirm the flight/fare/price with the user in the chat UI.
+
+## Errors
+- INVALID_ARGUMENT     \u2192 bad argument; run <verb> --help and correct it.
+- PRICE_CHANGED        \u2192 price changed since verify; re-verify and confirm the new price.
+- ORDER_CREATE_FAILED  \u2192 upstream create failed; funds released. Safe to retry with same key.
+- PAYMENT_FAILED       \u2192 settlement/payment failed; check balance/method and retry.
+- NOT_FOUND            \u2192 no such order for this key/owner. Do NOT retry blindly.
+- IDEMPOTENCY_CONFLICT \u2192 same key reused with different params; use a fresh key.
+- UPSTREAM_ERROR       \u2192 transient; retry once after a short wait.
+`.trim();
+function registerFlightSkillCommand(parent) {
+  parent.command("skill").description("Print the flight-flink usage guide (orchestration flow, data passing, rules)").action(() => {
+    console.log(SKILL_TEXT2);
+  });
+}
+
 // src/index.ts
 var programRef;
 async function main() {
@@ -4344,7 +5543,7 @@ async function main() {
   const program = new Command();
   programRef = program;
   program.name("agenzo-merchant-cli").version(getCurrentVersion()).description(
-    "Agenzo merchant fulfillment plane: service discovery (services), ride ordering (ride-elife), and hotel booking (hotel-redaug)"
+    "Agenzo merchant fulfillment plane: service discovery (services), ride ordering (ride-elife), hotel booking (hotel-redaug), and flight booking (flight-flink)"
   ).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)",
@@ -4439,6 +5638,49 @@ Key notes:
   registerHotelListCitiesCommand(hotelCmd, deps);
   registerHotelDetailCommand(hotelCmd, deps);
   registerHotelSkillCommand(hotelCmd);
+  const flightCmd = program.command("flight-flink").description(
+    `Flight booking (Flink) \u2014 international flight search, price verification, two-step create-then-pay ticketing, plus change (rebooking) and refund.
+
+Workflow (typical order):
+  1. find-airport      Resolve a place name \u2192 IATA city/airport codes
+  2. search            Search flights (one-way/round-trip/multi-city). journeys carries ALL legs;
+                       relay --journey-id for round-trip/multi-city until price_key_ready is true
+  3. verify            Verify the fare \u2192 authoritative product_token + price_changed flag
+  4. create-order      Create the order using verify's product_token (locks the fare, no charge)
+  5. pay-order         Settle by --order-no (triggers ticketing); order \u2192 PAID
+  6. get-order         Poll by --order-no until TICKETED (or use --watch for NDJSON)
+     cancel-order      (optional) Cancel an un-ticketed order (+ refund)
+     change-*          (optional) change-search \u2192 change-apply \u2192 change-detail; confirm via pay-order, cancel via change-cancel
+     refund-*          (optional) refund-apply \u2192 refund-detail \u2192 refund-confirm (1=confirm, 2=cancel)
+     list-orders       List the developer's flight orders
+
+Key notes:
+  \u2022 product_token from search/verify is opaque \u2014 pass it unchanged; verify's token supersedes search's
+  \u2022 passengers is a JSON array; gender/id_type are STRINGS ("1"/"2"); child/infant need adult_passenger_name
+  \u2022 Ticketing is asynchronous \u2014 never claim "booked" until get-order returns TICKETED
+  \u2022 create-order and pay-order are separate steps; create-order does NOT charge
+  \u2022 Write verbs require --idempotency-key; reuse the SAME key when retrying the same intent`
+  );
+  registerFindAirportCommand(flightCmd, deps);
+  registerListAirportsCommand(flightCmd, deps);
+  registerListAirlinesCommand(flightCmd, deps);
+  registerListNationalitiesCommand(flightCmd, deps);
+  registerSearchCommand(flightCmd, deps);
+  registerMoreOffersCommand(flightCmd, deps);
+  registerVerifyCommand(flightCmd, deps);
+  registerCreateOrderCommand(flightCmd, deps);
+  registerPayOrderCommand(flightCmd, deps);
+  registerGetOrderCommand(flightCmd, deps);
+  registerCancelOrderCommand(flightCmd, deps);
+  registerListOrdersCommand2(flightCmd, deps);
+  registerChangeSearchCommand(flightCmd, deps);
+  registerChangeApplyCommand(flightCmd, deps);
+  registerChangeDetailCommand(flightCmd, deps);
+  registerChangeCancelCommand(flightCmd, deps);
+  registerRefundApplyCommand(flightCmd, deps);
+  registerRefundDetailCommand(flightCmd, deps);
+  registerRefundConfirmCommand(flightCmd, deps);
+  registerFlightSkillCommand(flightCmd);
   await program.parseAsync(process.argv);
 }
 function resolveActiveFormat() {