@agenzo/merchant-cli 0.8.11 → 0.8.12

package/dist/index.js

@@ -1182,6 +1182,91 @@ var cancelSchema = {
     PARAM_IDEMPOTENCY_KEY_REQUIRED: "Supply --idempotency-key (1-128 chars [A-Za-z0-9_-]); the CLI never generates one under --yes."
   }
 };
+var rideUpdateSchema = {
+  cli: CLI_NAME,
+  noun: NOUN,
+  verb: "update",
+  description: "Modify an existing ride booking: trip details (time / route / flight info) and/or passenger details. Fare changes are rejected \u2014 cancel and book again instead",
+  flags: {
+    "order-id": { type: "string", required: true, description: "The numeric ride_id (e.g. 4112961) to modify \u2014 use the `ride_id` field from book/list-orders responses, NOT the rio_... order_id" },
+    "idempotency-key": {
+      type: "string",
+      required: true,
+      description: "Unique key (1-128 chars [A-Za-z0-9_-]) forwarded verbatim as the Idempotency-Key header; never auto-generated"
+    },
+    "pickup-lat": { type: "float", required: false, description: "New pickup latitude", constraints: "-90 to 90" },
+    "pickup-lng": { type: "float", required: false, description: "New pickup longitude", constraints: "-180 to 180" },
+    "pickup-name": { type: "string", required: false, description: "New pickup location name" },
+    "dropoff-lat": { type: "float", required: false, description: "New dropoff latitude", constraints: "-90 to 90" },
+    "dropoff-lng": { type: "float", required: false, description: "New dropoff longitude", constraints: "-180 to 180" },
+    "dropoff-name": { type: "string", required: false, description: "New dropoff location name" },
+    "pickup-time": { type: "int|string", required: false, description: "New pickup time: epoch seconds or 'now'" },
+    "welcome-sign": { type: "string", required: false, description: "New welcome sign text (meet & greet)" },
+    "arrival-flight-no": { type: "string", required: false, description: "New arrival flight number" },
+    "arrival-airline": { type: "string", required: false, description: "New arrival airline name" },
+    "departure-flight-no": { type: "string", required: false, description: "New departure flight number" },
+    "departure-airline": { type: "string", required: false, description: "New departure airline name" },
+    "service-area-id": { type: "string", required: false, description: "Service area id, when the upstream requires re-scoping the ride" },
+    "passenger-name": { type: "string", required: false, description: "New passenger full name (passing any passenger-* flag triggers a passenger update)" },
+    "passenger-phone": { type: "string", required: false, description: "New passenger phone in E.164 format (e.g. +14155551234)" },
+    "passenger-email": { type: "string", required: false, description: "New passenger email" },
+    "luggage-count": { type: "int", required: false, description: "New luggage count" }
+  },
+  response: {
+    ride_id: { type: "string|int", description: "Modified ride id" },
+    status: { type: "string", description: "Result status, 'updated' when the modification was applied" },
+    ride_updated: { type: "bool", description: "true when trip-side fields were sent upstream" },
+    passenger_updated: { type: "bool", description: "true when passenger fields were sent upstream" }
+  },
+  example: {
+    command: "agenzo-merchant-cli ride-elife update --order-id 4112961 --pickup-time 1780000000 --idempotency-key update-789",
+    output_summary: "Returns which sides were applied (ride_updated / passenger_updated)."
+  },
+  error_recovery: {
+    PARAM_INVALID: "No modifiable field was supplied. Pass at least one trip field or one passenger-* flag.",
+    RIDE_NOT_FOUND: "The ride does not exist or belongs to another developer. Verify --order-id is the ride_id from book.",
+    CANCELLATION_NOT_ALLOWED: "The ride is past the modifiable window. Query with `ride-elife get`; cancel and re-book if the user needs a different trip.",
+    UPSTREAM_ERROR: "Partial update: one side applied upstream, the other failed (see data.partial_update). The upstream has NO rollback \u2014 re-issue update for the failed side ONLY, then confirm with `ride-elife get`.",
+    PARAM_IDEMPOTENCY_KEY_REQUIRED: "Supply --idempotency-key (1-128 chars [A-Za-z0-9_-]); the CLI never generates one under --yes."
+  }
+};
+var rideTripStatusSchema = {
+  cli: CLI_NAME,
+  noun: NOUN,
+  verb: "trip-status",
+  description: "Query the status and driver location points of a single leg of a multi-leg ride",
+  flags: {
+    "order-id": { type: "string", required: true, description: "The numeric ride_id (e.g. 4112961) \u2014 use the `ride_id` field from book/list-orders responses" },
+    "trip-no": { type: "int", required: false, default: 1, description: "1-based leg index; defaults to the first leg" }
+  },
+  response: {
+    ride_id: { type: "string|int", description: "Ride identifier" },
+    trip_no: { type: "int", description: "Leg number this status refers to" },
+    status: { type: "string", description: "Leg status, same vocabulary as `ride-elife get`" },
+    points: {
+      type: "array|null",
+      description: "Driver location points for this leg",
+      items: { lat: { type: "float" }, lng: { type: "float" }, utc_timestamp: { type: "int" } }
+    }
+  },
+  example: {
+    command: "agenzo-merchant-cli ride-elife trip-status --order-id 4112961 --trip-no 2",
+    output_summary: "Returns the leg status plus its driver location points."
+  },
+  polling: {
+    recommended_interval_seconds: DEFAULT_WATCH_INTERVAL_SECONDS,
+    terminal_statuses: [...TERMINAL_STATUSES],
+    in_progress_statuses: ["Pending", "Accepted", "On my way", "Waiting", "On board"],
+    field_availability: {
+      points: "Populated only after the driver starts moving on this leg; empty or null before that."
+    }
+  },
+  error_recovery: {
+    RIDE_NOT_FOUND: "The ride or the requested leg does not exist. Confirm the ride has multiple legs via `ride-elife get` first.",
+    UPSTREAM_ERROR: "Upstream Trip Status errored. Legs only exist after a driver is dispatched \u2014 use get.response.next_trip_no and only query once the ride has started. As of 2026-08 the sandbox returns 502 here for rides with no dispatched legs regardless of --trip-no; fall back to `ride-elife get`.",
+    BOOKING_FAILED: "Transient upstream error. Retry once after 5s, or fall back to `ride-elife get` for whole-ride status."
+  }
+};
 var listOrdersSchema = {
   cli: CLI_NAME,
   noun: NOUN,
@@ -2105,12 +2190,15 @@ var flightCreateOrderSchema = flightSchema(
 );
 var flightPayOrderSchema = flightSchema(
   "pay-order",
-  "Settle a created order by --order-no (triggers upstream ticketing). AWAITING_PAYMENT \u2192 PAID.",
+  "Charge the order and trigger upstream ticketing. AWAITING_PAYMENT \u2192 PAID. Funds move HERE, not in create-order.",
   {
     "order-no": { type: "string", required: true, description: "Our order reference from create-order." },
+    "payment-method-id": { type: "string", required: false, description: "Optional bound-card id to charge (pay_per_call only; omit to use the default card)." },
+    "payment-token-id": { type: "string", required: false, description: "Optional network-token id; settles via direct charge instead of EVO preauth." },
+    "authorized-merchant-trans-id": { type: "string", required: false, description: "Resume a 3DS challenge with an already-authorised preauth trans id." },
     "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." } },
+  { order_no: { type: "string", description: "Our order reference." }, status: { type: "string", description: "PAID on success; AUTHENTICATION_REQUIRED when the card needs 3DS." } },
   { 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(
@@ -2730,6 +2818,225 @@ function registerCancelCommand(parent, deps) {
   });
 }
 
+// src/ride-elife/update.ts
+import { confirm as confirm3 } from "@inquirer/prompts";
+function need5(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function num3(value, flag) {
+  if (value === void 0) return void 0;
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
+  }
+  return parsed;
+}
+function int(value, flag) {
+  const parsed = num3(value, flag);
+  if (parsed === void 0) return void 0;
+  if (!Number.isInteger(parsed)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be an integer.`);
+  }
+  return parsed;
+}
+function pickupTime(value) {
+  if (value === void 0) return void 0;
+  if (value === "now") return "now";
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed)) {
+    throw new CliError("PARAM_INVALID", "--pickup-time must be epoch seconds or 'now'.");
+  }
+  return parsed;
+}
+function location(lat, lng, name, side) {
+  if (lat === void 0 && lng === void 0 && name === void 0) return void 0;
+  if (lat === void 0 || lng === void 0 || name === void 0) {
+    throw new CliError(
+      "PARAM_INVALID",
+      `--${side}-lat, --${side}-lng and --${side}-name must be passed together.`
+    );
+  }
+  return {
+    lat: num3(lat, `${side}-lat`),
+    lng: num3(lng, `${side}-lng`),
+    name
+  };
+}
+function formatUpdate(data) {
+  return Formatter.keyValue([
+    ["Ride ID", String(data.ride_id ?? "-")],
+    ["Status", String(data.status ?? "-")],
+    ["Trip details updated", data.ride_updated ? "yes" : "no"],
+    ["Passenger updated", data.passenger_updated ? "yes" : "no"]
+  ]);
+}
+function registerRideUpdateCommand(parent, deps) {
+  const cmd = parent.command("update").description("Modify an existing ride order (trip details and/or passenger)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-id <id>", "Ride order id to modify (the ride_id returned by book)").option(
+    "--idempotency-key <key>",
+    "Idempotency key forwarded verbatim as the Idempotency-Key header"
+  ).option("--quote-id <id>", "New quote id when the fare changes").option("--vehicle-class <class>", "New vehicle class").option("--price-amount <amount>", "New fare in decimal currency units (NOT cents)").option("--price-currency <code>", "ISO 4217 currency code for the new fare").option("--pickup-lat <lat>", "New pickup latitude").option("--pickup-lng <lng>", "New pickup longitude").option("--pickup-name <name>", "New pickup location name").option("--dropoff-lat <lat>", "New dropoff latitude").option("--dropoff-lng <lng>", "New dropoff longitude").option("--dropoff-name <name>", "New dropoff location name").option("--pickup-time <time>", "New pickup time: epoch seconds or 'now'").option("--meet-and-greet", "Enable meet & greet service").option("--no-meet-and-greet", "Disable meet & greet service").option("--welcome-sign <text>", "New welcome sign text (meet & greet)").option("--arrival-flight-no <no>", "New arrival flight number").option("--arrival-airline <name>", "New arrival airline name").option("--departure-flight-no <no>", "New departure flight number").option("--departure-airline <name>", "New departure airline name").option("--service-area-id <id>", "Service area id, when the upstream requires re-scoping").option("--passenger-name <name>", "New passenger full name").option("--passenger-phone <phone>", "New passenger phone (E.164)").option("--passenger-email <email>", "New passenger email").option("--luggage-count <count>", "New luggage count");
+  attachSchemaHelp(cmd, rideUpdateSchema);
+  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 = need5(opts.orderId, "order-id");
+    const mgTouched = process.argv.some(
+      (a) => a === "--meet-and-greet" || a === "--no-meet-and-greet"
+    );
+    const body = {};
+    const set = (key, value) => {
+      if (value !== void 0) body[key] = value;
+    };
+    set("quote_id", opts.quoteId);
+    set("vehicle_class", opts.vehicleClass);
+    set("price_amount", num3(opts.priceAmount, "price-amount"));
+    set("price_currency", opts.priceCurrency);
+    set(
+      "pickup",
+      location(
+        opts.pickupLat,
+        opts.pickupLng,
+        opts.pickupName,
+        "pickup"
+      )
+    );
+    set(
+      "dropoff",
+      location(
+        opts.dropoffLat,
+        opts.dropoffLng,
+        opts.dropoffName,
+        "dropoff"
+      )
+    );
+    set("pickup_time", pickupTime(opts.pickupTime));
+    if (mgTouched) set("meet_and_greet", Boolean(opts.meetAndGreet));
+    set("welcome_sign", opts.welcomeSign);
+    if (opts.arrivalFlightNo !== void 0 || opts.arrivalAirline !== void 0) {
+      set("arrival_flight", {
+        flight_no: opts.arrivalFlightNo,
+        airline: opts.arrivalAirline
+      });
+    }
+    if (opts.departureFlightNo !== void 0 || opts.departureAirline !== void 0) {
+      set("departure_flight", {
+        flight_no: opts.departureFlightNo,
+        airline: opts.departureAirline
+      });
+    }
+    set("service_area_id", opts.serviceAreaId);
+    set("passenger_name", opts.passengerName);
+    set("passenger_phone", opts.passengerPhone);
+    set("passenger_email", opts.passengerEmail);
+    set("luggage_count", int(opts.luggageCount, "luggage-count"));
+    if (Object.keys(body).length === 0) {
+      throw new CliError(
+        "PARAM_INVALID",
+        "Nothing to update. Pass at least one trip field or one passenger-* flag."
+      );
+    }
+    if (!isYes) {
+      const confirmed = await confirm3({
+        message: `Apply ${Object.keys(body).length} change(s) to ride ${orderId}? The fare may change.`,
+        default: false
+      });
+      if (!confirmed) {
+        throw new CliError("CLIENT_ABORTED", "Update aborted by user.");
+      }
+    }
+    const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
+      yes: isYes,
+      commandPath: "ride-elife update"
+    });
+    const spinner = format === "json" ? null : createSpinner("Updating ride...");
+    const result = await deps.apiClient.post(
+      `/ride/${encodeURIComponent(orderId)}/update`,
+      { 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: () => formatUpdate(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
+// src/ride-elife/trip-status.ts
+function need6(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function tripNo(value) {
+  if (value === void 0) return 1;
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed < 1) {
+    throw new CliError("PARAM_INVALID", "--trip-no must be an integer >= 1.");
+  }
+  return parsed;
+}
+function formatTripStatus(data) {
+  const lines = [
+    ["Ride ID", String(data.ride_id ?? "-")],
+    ["Trip no", String(data.trip_no ?? "-")],
+    ["Status", String(data.status ?? "-")]
+  ];
+  const points = data.points ?? [];
+  lines.push(["Location points", String(points.length)]);
+  const latest = points[points.length - 1];
+  if (latest) {
+    lines.push(["Latest position", `${latest.lat}, ${latest.lng} @ ${latest.utc_timestamp}`]);
+  }
+  return Formatter.keyValue(lines);
+}
+function registerRideTripStatusCommand(parent, deps) {
+  const cmd = parent.command("trip-status").description("Retrieve the status and driver location points of one leg of a ride").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-id <id>", "Ride order id (the ride_id returned by `ride-elife book`)").option("--trip-no <no>", "1-based leg index (default 1)");
+  attachSchemaHelp(cmd, rideTripStatusSchema);
+  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 = need6(opts.orderId, "order-id");
+    const leg = tripNo(opts.tripNo);
+    const spinner = format === "json" ? null : createSpinner("Fetching trip status...");
+    const result = await deps.apiClient.get(
+      `/ride/${encodeURIComponent(orderId)}/trips/${leg}`,
+      { 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: () => formatTripStatus(data)
+    };
+    await renderWithContext(commandResult, { format }, configManager);
+  });
+}
+
 // src/ride-elife/list-orders.ts
 var DEFAULT_PAGE = "1";
 var DEFAULT_PAGE_SIZE = "20";
@@ -2814,15 +3121,24 @@ var SERVICE_REGISTRY = [
     version: "1.0.0",
     provider: "elife",
     cli_noun: "ride-elife",
-    verbs: ["quote", "book", "get", "cancel", "list-orders"],
+    verbs: ["quote", "book", "get", "cancel", "update", "trip-status", "list-orders"],
     verb_descriptions: {
       quote: "Request fare quotes for a ride between two points.",
       book: "Book a ride using a quote_id returned by quote.",
       get: "Retrieve a ride order by id (poll for status changes with --watch).",
       cancel: "Cancel a ride order by id (may incur a fee).",
+      update: "Modify a booked ride: trip details and/or passenger info.",
+      "trip-status": "Retrieve status and driver location points for one leg of a multi-leg ride.",
       "list-orders": "List previously placed ride orders."
     },
-    workflow: ["quote", "book", "get (poll for status)", "cancel (optional)"],
+    workflow: [
+      "quote",
+      "book",
+      "get (poll for status)",
+      "update (optional)",
+      "trip-status (optional, multi-leg rides)",
+      "cancel (optional)"
+    ],
     since: "2026-06-01",
     discovery: {
       help_command: "agenzo-merchant-cli ride-elife --help"
@@ -3229,28 +3545,28 @@ function registerOrdersGetCommand(parent, deps) {
 }
 
 // src/hotel-redaug/search.ts
-function need5(value, flag) {
+function need7(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));
+function num4(value, flag) {
+  const n = Number(need7(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);
+  const n = num4(value, flag);
   if (n < min || n > max) {
     throw new CliError("PARAM_INVALID", `--${flag} must be between ${min} and ${max}.`);
   }
   return n;
 }
 function positiveInt3(value, flag) {
-  const n = num3(value, flag);
+  const n = num4(value, flag);
   if (!Number.isInteger(n) || n <= 0) {
     throw new CliError("PARAM_INVALID", `--${flag} must be a positive integer.`);
   }
@@ -3258,7 +3574,7 @@ function positiveInt3(value, flag) {
 }
 var YMD_RE = /^\d{4}-\d{2}-\d{2}$/;
 function stayDate(value, flag) {
-  const raw = need5(value, flag);
+  const raw = need7(value, flag);
   if (!YMD_RE.test(raw)) {
     throw new CliError("PARAM_INVALID", `--${flag} must be a YYYY-MM-DD date.`);
   }
@@ -3330,21 +3646,21 @@ function registerHotelSearchCommand(parent, deps) {
     const pageSize = positiveInt3(opts.pageSize, "page-size");
     const body = {};
     if (hasDestination) {
-      body.destination_id = need5(opts.destinationId, "destination-id");
+      body.destination_id = need7(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.distance = num4(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");
+    body.adults = num4(opts.adults, "adults");
+    body.children = num4(opts.children, "children");
+    body.room_num = num4(opts.roomNum, "room-num");
+    if (opts.star !== void 0) body.star = num4(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.priceMin !== void 0) body.price_min = num4(opts.priceMin, "price-min");
+    if (opts.priceMax !== void 0) body.price_max = num4(opts.priceMax, "price-max");
     if (opts.sortBy !== void 0) body.sort_by = opts.sortBy;
     body.page = page;
     body.page_size = pageSize;
@@ -3373,14 +3689,14 @@ function registerHotelSearchCommand(parent, deps) {
 }
 
 // src/hotel-redaug/quote.ts
-function need6(value, flag) {
+function need8(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));
+function num5(value, flag) {
+  const n = Number(need8(value, flag));
   if (!Number.isFinite(n)) {
     throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
   }
@@ -3388,7 +3704,7 @@ function num4(value, flag) {
 }
 var YMD_RE2 = /^\d{4}-\d{2}-\d{2}$/;
 function stayDate2(value, flag) {
-  const raw = need6(value, flag);
+  const raw = need8(value, flag);
   if (!YMD_RE2.test(raw)) {
     throw new CliError("PARAM_INVALID", `--${flag} must be a YYYY-MM-DD date.`);
   }
@@ -3428,7 +3744,7 @@ function registerHotelQuoteCommand(parent, deps) {
       message: "API Key:",
       type: "password"
     });
-    const hotelId = need6(opts.hotelId, "hotel-id");
+    const hotelId = need8(opts.hotelId, "hotel-id");
     const checkIn = stayDate2(opts.checkIn, "check-in");
     const checkOut = stayDate2(opts.checkOut, "check-out");
     if (!(checkOut > checkIn)) {
@@ -3438,9 +3754,9 @@ function registerHotelQuoteCommand(parent, deps) {
       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"),
+      adults: num5(opts.adults, "adults"),
+      children: num5(opts.children, "children"),
+      room_num: num5(opts.roomNum, "room-num"),
       nationality: opts.nationality
     };
     const result = await deps.apiClient.post(
@@ -3462,7 +3778,7 @@ function registerHotelQuoteCommand(parent, deps) {
 }
 
 // src/hotel-redaug/create-order.ts
-import { confirm as confirm3 } from "@inquirer/prompts";
+import { confirm as confirm4 } 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;
@@ -3520,14 +3836,14 @@ function parseCancellation(raw) {
   }
   return parsed;
 }
-function need7(value, flag) {
+function need9(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));
+function num6(value, flag) {
+  const n = Number(need9(value, flag));
   if (!Number.isFinite(n)) {
     throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
   }
@@ -3535,7 +3851,7 @@ function num5(value, flag) {
 }
 var YMD_RE3 = /^\d{4}-\d{2}-\d{2}$/;
 function stayDate3(value, flag) {
-  const raw = need7(value, flag);
+  const raw = need9(value, flag);
   if (!YMD_RE3.test(raw)) {
     throw new CliError("PARAM_INVALID", `--${flag} must be a YYYY-MM-DD date.`);
   }
@@ -3604,18 +3920,18 @@ function registerHotelCreateOrderCommand(parent, deps) {
       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 productToken = need9(opts.productToken, "product-token");
+    const totalAmount = num6(opts.totalAmount, "total-amount");
+    const currency = need9(opts.currency, "currency");
+    const priceItems = parsePriceItems(need9(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 guestName = need9(opts.guestName, "guest-name");
+    const contactName = need9(opts.contactName, "contact-name");
+    const contactPhone = need9(opts.contactPhone, "contact-phone");
     const body = {
       product_token: productToken,
       total_amount: totalAmount,
@@ -3623,9 +3939,9 @@ function registerHotelCreateOrderCommand(parent, deps) {
       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"),
+      room_num: num6(opts.roomNum, "room-num"),
+      adults: num6(opts.adults, "adults"),
+      children: num6(opts.children, "children"),
       nationality: opts.nationality,
       guest_name: guestName,
       contact_name: contactName,
@@ -3649,7 +3965,7 @@ function registerHotelCreateOrderCommand(parent, deps) {
     if (member !== void 0) body.member_id = member;
     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.";
-      const confirmed = await confirm3({
+      const confirmed = await confirm4({
         message: `Create this hotel order for ${totalAmount} ${currency} (check-in ${checkIn}, check-out ${checkOut})? ${chargeNote}`,
         default: false
       });
@@ -3683,7 +3999,7 @@ function registerHotelCreateOrderCommand(parent, deps) {
 }
 
 // src/hotel-redaug/pay-order.ts
-import { confirm as confirm4 } from "@inquirer/prompts";
+import { confirm as confirm5 } from "@inquirer/prompts";
 
 // src/hotel-redaug/watch.ts
 var DEFAULT_ORDER_WATCH_INTERVAL_SECONDS = 5;
@@ -3859,7 +4175,7 @@ function registerHotelPayOrderCommand(parent, deps) {
     const watchTimeout = resolveSeconds(opts.watchTimeout, DEFAULT_PAY_WATCH_TIMEOUT_SECONDS);
     const body = {};
     if (!isYes) {
-      const confirmed = await confirm4({
+      const confirmed = await confirm5({
         message: `Settle hotel order ${orderId}? This moves money via the order's configured billing mode (monthly_settlement or pay_per_call).`,
         default: false
       });
@@ -3937,7 +4253,7 @@ function registerHotelPayOrderCommand(parent, deps) {
 }
 
 // src/hotel-redaug/get.ts
-function need8(value, flag) {
+function need10(value, flag) {
   if (value === void 0) {
     throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
   }
@@ -4001,7 +4317,7 @@ function registerHotelGetCommand(parent, deps) {
       message: "API Key:",
       type: "password"
     });
-    const orderId = need8(opts.orderId, "order-id");
+    const orderId = need10(opts.orderId, "order-id");
     if (opts.watch) {
       await watchOrderStatus(deps.apiClient, apiKey, orderId, {
         intervalSeconds: resolveSeconds(
@@ -4035,7 +4351,7 @@ function registerHotelGetCommand(parent, deps) {
 }
 
 // src/hotel-redaug/cancel.ts
-function need9(value, flag) {
+function need11(value, flag) {
   if (value === void 0) {
     throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
   }
@@ -4088,8 +4404,8 @@ function registerHotelCancelCommand(parent, deps) {
       message: "API Key:",
       type: "password"
     });
-    const orderId = need9(opts.orderId, "order-id");
-    const fcOrderCode = need9(opts.fcOrderCode, "fc-order-code");
+    const orderId = need11(opts.orderId, "order-id");
+    const fcOrderCode = need11(opts.fcOrderCode, "fc-order-code");
     const body = { fc_order_code: fcOrderCode };
     if (opts.reason !== void 0) body.reason = opts.reason;
     const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
@@ -4118,15 +4434,15 @@ function registerHotelCancelCommand(parent, deps) {
 }
 
 // src/hotel-redaug/checkout.ts
-import { confirm as confirm5 } from "@inquirer/prompts";
-function need10(value, flag) {
+import { confirm as confirm6 } from "@inquirer/prompts";
+function need12(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));
+function num7(value, flag) {
+  const n = Number(need12(value, flag));
   if (!Number.isFinite(n)) {
     throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
   }
@@ -4192,11 +4508,11 @@ function registerHotelCheckoutCommand(parent, deps) {
       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 orderId = need12(opts.orderId, "order-id");
+    const fcOrderCode = need12(opts.fcOrderCode, "fc-order-code");
+    const reason = need12(opts.reason, "reason");
+    const checkoutRooms = parseCheckoutRooms(need12(opts.checkoutRooms, "checkout-rooms"));
+    const refundType = num7(opts.refundType, "refund-type");
     const body = {
       fc_order_code: fcOrderCode,
       reason,
@@ -4204,7 +4520,7 @@ function registerHotelCheckoutCommand(parent, deps) {
       checkout_rooms: checkoutRooms
     };
     if (!isYes) {
-      const confirmed = await confirm5({
+      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
       });
@@ -4238,7 +4554,7 @@ function registerHotelCheckoutCommand(parent, deps) {
 }
 
 // src/hotel-redaug/get-checkout.ts
-function need11(value, flag) {
+function need13(value, flag) {
   if (value === void 0) {
     throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
   }
@@ -4274,7 +4590,7 @@ function registerHotelGetCheckoutCommand(parent, deps) {
       message: "API Key:",
       type: "password"
     });
-    const taskOrderCode = need11(opts.taskOrderCode, "task-order-code");
+    const taskOrderCode = need13(opts.taskOrderCode, "task-order-code");
     if (opts.watch) {
       await watchCheckoutStatus(deps.apiClient, apiKey, taskOrderCode, {
         intervalSeconds: resolveSeconds(
@@ -4378,7 +4694,7 @@ function registerHotelListOrdersCommand(parent, deps) {
 }
 
 // src/hotel-redaug/find-destination.ts
-function need12(value, flag) {
+function need14(value, flag) {
   if (value === void 0 || value.trim() === "") {
     throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
   }
@@ -4412,7 +4728,7 @@ function registerHotelFindDestinationCommand(parent, deps) {
       message: "API Key:",
       type: "password"
     });
-    const keyword = need12(opts.keyword, "keyword");
+    const keyword = need14(opts.keyword, "keyword");
     const body = { keyword };
     if (opts.dataType !== void 0) {
       body.data_type = opts.dataType;
@@ -4436,21 +4752,21 @@ function registerHotelFindDestinationCommand(parent, deps) {
 }
 
 // src/hotel-redaug/hotel-filters.ts
-function need13(value, flag) {
+function need15(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));
+function num8(value, flag) {
+  const n = Number(need15(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);
+  const n = num8(value, flag);
   if (n < min || n > max) {
     throw new CliError("PARAM_INVALID", `--${flag} must be between ${min} and ${max}.`);
   }
@@ -4523,12 +4839,12 @@ function registerHotelFiltersCommand(parent, deps) {
     }
     const body = {};
     if (hasDestination) {
-      body.destination_id = need13(opts.destinationId, "destination-id");
+      body.destination_id = need15(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");
+    body.distance = num8(opts.distance, "distance");
     const result = await deps.apiClient.post(
       "/hotel/filters",
       { type: "api-key", key: apiKey },
@@ -4548,7 +4864,7 @@ function registerHotelFiltersCommand(parent, deps) {
 }
 
 // src/hotel-redaug/list-cities.ts
-function need14(value, flag) {
+function need16(value, flag) {
   if (value === void 0 || value.trim() === "") {
     throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
   }
@@ -4581,7 +4897,7 @@ function registerHotelListCitiesCommand(parent, deps) {
       message: "API Key:",
       type: "password"
     });
-    const country = need14(opts.country, "country");
+    const country = need16(opts.country, "country");
     const body = { country_code: country };
     const result = await deps.apiClient.post(
       "/hotel/cities",
@@ -4602,7 +4918,7 @@ function registerHotelListCitiesCommand(parent, deps) {
 }
 
 // src/hotel-redaug/hotel-detail.ts
-function need15(value, flag) {
+function need17(value, flag) {
   if (value === void 0 || value.trim() === "") {
     throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
   }
@@ -4749,7 +5065,7 @@ function registerHotelDetailCommand(parent, deps) {
       message: "API Key:",
       type: "password"
     });
-    const hotelId = need15(opts.hotelId, "hotel-id");
+    const hotelId = need17(opts.hotelId, "hotel-id");
     const rawWithImages = opts.withImages;
     const withImages = rawWithImages !== "false" && rawWithImages !== false;
     const settings = parseSettings(opts.settings);
@@ -4957,14 +5273,14 @@ function registerHotelSkillCommand(parent) {
 }
 
 // src/flight-flink/_helpers.ts
-function need16(value, flag) {
+function need18(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));
+function num9(value, flag) {
+  const n = Number(need18(value, flag));
   if (!Number.isFinite(n)) {
     throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
   }
@@ -4999,7 +5315,7 @@ function registerFindAirportCommand(parent, deps) {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
     const apiKey = await resolveApiKey(opts.apiKey);
-    const keyword = need16(opts.keyword, "keyword");
+    const keyword = need18(opts.keyword, "keyword");
     const spinner = format === "json" ? null : createSpinner("Resolving airports...");
     const result = await deps.apiClient.post(
       "/flight/find-airport",
@@ -5025,8 +5341,8 @@ function registerListAirportsCommand(parent, deps) {
     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")
+      page: num9(opts.page, "page"),
+      page_size: num9(opts.pageSize, "page-size")
     };
     if (opts.keyword !== void 0) body.keyword = opts.keyword;
     const spinner = format === "json" ? null : createSpinner("Fetching airports...");
@@ -5050,8 +5366,8 @@ function registerListAirlinesCommand(parent, deps) {
     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")
+      page: num9(opts.page, "page"),
+      page_size: num9(opts.pageSize, "page-size")
     };
     if (opts.keyword !== void 0) body.keyword = opts.keyword;
     const spinner = format === "json" ? null : createSpinner("Fetching airlines...");
@@ -5095,13 +5411,13 @@ function registerSearchCommand(parent, deps) {
     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"),
+      trip_type: num9(opts.tripType, "trip-type"),
+      journeys: jsonArray(need18(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")
+      adult_num: num9(opts.adultNum, "adult-num"),
+      child_num: num9(opts.childNum, "child-num"),
+      infant_num: num9(opts.infantNum, "infant-num"),
+      transfer_number: num9(opts.transferNumber, "transfer-number")
     };
     if (opts.airline !== void 0) body.airline = opts.airline;
     if (opts.journeyId !== void 0) {
@@ -5127,7 +5443,7 @@ function registerMoreOffersCommand(parent, deps) {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
     const apiKey = await resolveApiKey(opts.apiKey);
-    const productToken = need16(opts.productToken, "product-token");
+    const productToken = need18(opts.productToken, "product-token");
     const spinner = format === "json" ? null : createSpinner("Fetching offers...");
     const result = await deps.apiClient.post(
       "/flight/more-offers",
@@ -5148,7 +5464,7 @@ function registerVerifyCommand(parent, deps) {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
     const apiKey = await resolveApiKey(opts.apiKey);
-    const productToken = need16(opts.productToken, "product-token");
+    const productToken = need18(opts.productToken, "product-token");
     const spinner = format === "json" ? null : createSpinner("Verifying price...");
     const result = await deps.apiClient.post(
       "/flight/verify",
@@ -5170,7 +5486,7 @@ function registerVerifyCommand(parent, deps) {
 }
 
 // src/flight-flink/create-order.ts
-import { confirm as confirm6 } from "@inquirer/prompts";
+import { confirm as confirm7 } 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("--payment-token-id <id>", "Optional UPI network-token id (unionpay charge path)").option(
     "--authorized-merchant-trans-id <id>",
@@ -5182,19 +5498,19 @@ function registerCreateOrderCommand(parent, deps) {
     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 productToken = need18(opts.productToken, "product-token");
+    const totalAmount = num9(opts.totalAmount, "total-amount");
+    const currency = need18(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")
+      trip_type: num9(opts.tripType, "trip-type"),
+      contact_name: need18(opts.contactName, "contact-name"),
+      contact_region: need18(opts.contactRegion, "contact-region"),
+      contact_phone: need18(opts.contactPhone, "contact-phone"),
+      contact_email: need18(opts.contactEmail, "contact-email"),
+      passengers: jsonArray(need18(opts.passengers, "passengers"), "passengers")
     };
     if (opts.paymentMethodId !== void 0) body.payment_method_id = opts.paymentMethodId;
     if (opts.paymentTokenId !== void 0) body.payment_token_id = opts.paymentTokenId;
@@ -5204,7 +5520,7 @@ function registerCreateOrderCommand(parent, deps) {
     const member = memberIdOf(opts);
     if (member !== void 0) body.member_id = member;
     if (!isYes) {
-      const ok = await confirm6({
+      const ok = await confirm7({
         message: `Create this flight order for ${totalAmount} ${currency}? This locks the fare but does NOT charge yet.`,
         default: false
       });
@@ -5243,18 +5559,21 @@ function registerCreateOrderCommand(parent, deps) {
 }
 
 // src/flight-flink/pay-order.ts
-import { confirm as confirm7 } from "@inquirer/prompts";
+import { confirm as confirm8 } 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");
+  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("--payment-method-id <id>", "Optional bound-card id to charge (pay_per_call only)").option("--payment-token-id <id>", "Optional network-token id (unionpay/visa charge path)").option(
+    "--authorized-merchant-trans-id <id>",
+    "Resume a 3DS challenge: merchant trans id of an already-authorised preauth"
+  ).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");
+    const orderNo = need18(opts.orderNo, "order-no");
     if (!isYes) {
-      const ok = await confirm7({
+      const ok = await confirm8({
         message: `Pay and ticket order ${orderNo}? This settles the order and issues tickets.`,
         default: false
       });
@@ -5265,10 +5584,16 @@ function registerPayOrderCommand(parent, deps) {
       commandPath: "flight-flink pay-order"
     });
     const spinner = format === "json" ? null : createSpinner("Paying flight order...");
+    const body = {};
+    if (opts.paymentMethodId !== void 0) body.payment_method_id = opts.paymentMethodId;
+    if (opts.paymentTokenId !== void 0) body.payment_token_id = opts.paymentTokenId;
+    if (opts.authorizedMerchantTransId !== void 0) {
+      body.authorized_merchant_trans_id = opts.authorizedMerchantTransId;
+    }
     const result = await deps.apiClient.post(
       `/flight/${encodeURIComponent(orderNo)}/pay`,
       { type: "api-key", key: apiKey },
-      {},
+      body,
       { "Idempotency-Key": idempotencyKey }
     );
     spinner?.stop();
@@ -5297,12 +5622,12 @@ function registerGetOrderCommand(parent, deps) {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
     const apiKey = await resolveApiKey(opts.apiKey);
-    const orderNo = need16(opts.orderNo, "order-no");
+    const orderNo = need18(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 interval = num9(opts.watchInterval, "watch-interval") * 1e3;
+      const timeoutMs = num9(opts.watchTimeout, "watch-timeout") * 1e3;
       const deadline = Date.now() + timeoutMs;
       for (; ; ) {
         const r = await deps.apiClient.get(path, auth);
@@ -5337,7 +5662,7 @@ function registerGetOrderCommand(parent, deps) {
 }
 
 // src/flight-flink/cancel-order.ts
-import { confirm as confirm8 } from "@inquirer/prompts";
+import { confirm as confirm9 } 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);
@@ -5346,9 +5671,9 @@ function registerCancelOrderCommand(parent, deps) {
     const format = resolveFormat(opts.format);
     const isYes = Boolean(opts.yes);
     const apiKey = await resolveApiKey(opts.apiKey);
-    const orderNo = need16(opts.orderNo, "order-no");
+    const orderNo = need18(opts.orderNo, "order-no");
     if (!isYes) {
-      const ok = await confirm8({
+      const ok = await confirm9({
         message: `Cancel order ${orderNo}? This requests cancellation and a refund.`,
         default: false
       });
@@ -5393,8 +5718,8 @@ function registerListOrdersCommand2(parent, deps) {
     if (opts.status !== void 0) params.set("status", opts.status);
     const member = memberIdOf(opts);
     if (member !== void 0) params.set("member_id", member);
-    params.set("page", String(num8(opts.page, "page")));
-    params.set("page_size", String(num8(opts.pageSize, "page-size")));
+    params.set("page", String(num9(opts.page, "page")));
+    params.set("page_size", String(num9(opts.pageSize, "page-size")));
     const spinner = format === "json" ? null : createSpinner("Fetching flight orders...");
     const result = await deps.apiClient.get(
       `/flight/orders?${params.toString()}`,
@@ -5422,10 +5747,10 @@ function registerChangeSearchCommand(parent, deps) {
     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"),
+      order_no: need18(opts.orderNo, "order-no"),
+      date: need18(opts.date, "date"),
+      passenger: need18(opts.passenger, "passenger"),
+      segment_id: need18(opts.segmentId, "segment-id"),
       cabin_class: opts.cabinClass
     };
     const spinner = format === "json" ? null : createSpinner("Searching change options...");
@@ -5441,7 +5766,7 @@ function registerChangeSearchCommand(parent, deps) {
 }
 
 // src/flight-flink/change-apply.ts
-import { confirm as confirm9 } from "@inquirer/prompts";
+import { confirm as confirm10 } 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);
@@ -5451,17 +5776,17 @@ function registerChangeApplyCommand(parent, deps) {
     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")
+      order_no: need18(opts.orderNo, "order-no"),
+      passenger: need18(opts.passenger, "passenger"),
+      segment_id: need18(opts.segmentId, "segment-id"),
+      product_token: need18(opts.productToken, "product-token"),
+      contact_name: need18(opts.contactName, "contact-name"),
+      contact_region: need18(opts.contactRegion, "contact-region"),
+      contact_phone: need18(opts.contactPhone, "contact-phone"),
+      contact_email: need18(opts.contactEmail, "contact-email")
     };
     if (!isYes) {
-      const ok = await confirm9({
+      const ok = await confirm10({
         message: `Submit a change request for order ${body.order_no}?`,
         default: false
       });
@@ -5492,7 +5817,7 @@ function registerChangeDetailCommand(parent, deps) {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
     const apiKey = await resolveApiKey(opts.apiKey);
-    const changeOrderNo = need16(opts.changeOrderNo, "change-order-no");
+    const changeOrderNo = need18(opts.changeOrderNo, "change-order-no");
     const spinner = format === "json" ? null : createSpinner("Fetching change detail...");
     const result = await deps.apiClient.get(
       `/flight/change/${encodeURIComponent(changeOrderNo)}`,
@@ -5505,7 +5830,7 @@ function registerChangeDetailCommand(parent, deps) {
 }
 
 // src/flight-flink/change-cancel.ts
-import { confirm as confirm10 } from "@inquirer/prompts";
+import { confirm as confirm11 } 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);
@@ -5514,9 +5839,9 @@ function registerChangeCancelCommand(parent, deps) {
     const format = resolveFormat(opts.format);
     const isYes = Boolean(opts.yes);
     const apiKey = await resolveApiKey(opts.apiKey);
-    const changeOrderNo = need16(opts.changeOrderNo, "change-order-no");
+    const changeOrderNo = need18(opts.changeOrderNo, "change-order-no");
     if (!isYes) {
-      const ok = await confirm10({ message: `Cancel change request ${changeOrderNo}?`, default: false });
+      const ok = await confirm11({ 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, {
@@ -5537,7 +5862,7 @@ function registerChangeCancelCommand(parent, deps) {
 }
 
 // src/flight-flink/change-pay.ts
-import { confirm as confirm11 } from "@inquirer/prompts";
+import { confirm as confirm12 } from "@inquirer/prompts";
 function registerChangePayCommand(parent, deps) {
   const cmd = parent.command("change-pay").description("Pay a change request fee (like a normal order) and trigger change ticketing").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--change-order-no <id>", "Change order number").option("--order-no <id>", "Original order reference (ownership check)").option("--amount <amount>", "Change fee total in decimal units (change-detail price_total)").option("--currency <currency>", "ISO 4217 currency code", "USD").option("--payment-method-id <id>", "Optional bound-card id (EVO path)").option("--payment-token-id <id>", "Optional UPI network-token id (unionpay charge path)").option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
   attachSchemaHelp(cmd, flightChangePaySchema);
@@ -5546,10 +5871,10 @@ function registerChangePayCommand(parent, deps) {
     const format = resolveFormat(opts.format);
     const isYes = Boolean(opts.yes);
     const apiKey = await resolveApiKey(opts.apiKey);
-    const changeOrderNo = need16(opts.changeOrderNo, "change-order-no");
-    const orderNo = need16(opts.orderNo, "order-no");
-    const amount = num8(opts.amount, "amount");
-    const currency = need16(opts.currency, "currency");
+    const changeOrderNo = need18(opts.changeOrderNo, "change-order-no");
+    const orderNo = need18(opts.orderNo, "order-no");
+    const amount = num9(opts.amount, "amount");
+    const currency = need18(opts.currency, "currency");
     const body = {
       order_no: orderNo,
       amount,
@@ -5558,7 +5883,7 @@ function registerChangePayCommand(parent, deps) {
     if (opts.paymentMethodId !== void 0) body.payment_method_id = opts.paymentMethodId;
     if (opts.paymentTokenId !== void 0) body.payment_token_id = opts.paymentTokenId;
     if (!isYes) {
-      const ok = await confirm11({
+      const ok = await confirm12({
         message: `Pay change fee ${amount} ${currency} for change order ${changeOrderNo}? This charges the customer and triggers change ticketing.`,
         default: false
       });
@@ -5594,7 +5919,7 @@ function registerChangePayCommand(parent, deps) {
 }
 
 // src/flight-flink/refund-apply.ts
-import { confirm as confirm12 } from "@inquirer/prompts";
+import { confirm as confirm13 } 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);
@@ -5604,18 +5929,18 @@ function registerRefundApplyCommand(parent, deps) {
     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")
+      order_no: need18(opts.orderNo, "order-no"),
+      passenger: need18(opts.passenger, "passenger"),
+      segment_id: need18(opts.segmentId, "segment-id"),
+      reason_type: num9(opts.reasonType, "reason-type"),
+      contact_name: need18(opts.contactName, "contact-name"),
+      contact_region: need18(opts.contactRegion, "contact-region"),
+      contact_phone: need18(opts.contactPhone, "contact-phone"),
+      contact_email: need18(opts.contactEmail, "contact-email")
     };
     if (opts.reason !== void 0) body.reason = opts.reason;
     if (!isYes) {
-      const ok = await confirm12({
+      const ok = await confirm13({
         message: `Submit a refund request for order ${body.order_no}?`,
         default: false
       });
@@ -5646,7 +5971,7 @@ function registerRefundDetailCommand(parent, deps) {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
     const apiKey = await resolveApiKey(opts.apiKey);
-    const refundOrderNo = need16(opts.refundOrderNo, "refund-order-no");
+    const refundOrderNo = need18(opts.refundOrderNo, "refund-order-no");
     const spinner = format === "json" ? null : createSpinner("Fetching refund detail...");
     const result = await deps.apiClient.get(
       `/flight/refund/${encodeURIComponent(refundOrderNo)}`,
@@ -5659,7 +5984,7 @@ function registerRefundDetailCommand(parent, deps) {
 }
 
 // src/flight-flink/refund-confirm.ts
-import { confirm as confirm13 } from "@inquirer/prompts";
+import { confirm as confirm14 } 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);
@@ -5668,14 +5993,14 @@ function registerRefundConfirmCommand(parent, deps) {
     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");
+    const refundOrderNo = need18(opts.refundOrderNo, "refund-order-no");
+    const confirmFlag = need18(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 confirm13({ message: `${action} refund ${refundOrderNo}?`, default: false });
+      const ok = await confirm14({ message: `${action} refund ${refundOrderNo}?`, default: false });
       if (!ok) throw new CliError("CLIENT_ABORTED", "Refund confirmation aborted by user.");
     }
     const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
@@ -5805,13 +6130,16 @@ async function main() {
     process.env.AGENZO_FORMAT = resolveFormat(flag);
   });
   const rideCmd = program.command("ride-elife").description(
-    `Ride ordering (eLife) \u2014 quote a fare, book it, poll status, and cancel.
+    `Ride ordering (eLife) \u2014 quote a fare, book it, poll status, modify it, and cancel.
 
 Workflow (typical order):
   1. quote        Get fare quotes between two points \u2192 vehicle_classes[] each with a quote_id
   2. book         Book one vehicle_class using its quote_id \u2192 ride_id (write; needs --idempotency-key)
   3. get          Poll ride status by --order-id=<ride_id> until terminal (or use --watch for NDJSON)
   4. cancel       (optional) Cancel a ride by --order-id (write; may incur a fee)
+     update       (optional) Modify trip details and/or passenger of a booked ride
+                  (write; needs --idempotency-key; the fare may change)
+     trip-status  (optional) Status + driver location points of ONE leg of a multi-leg ride
      list-orders  (standalone) List the developer's previous ride orders
 
 Key notes:
@@ -5826,13 +6154,19 @@ Key notes:
   \u2022 All amounts are DECIMAL currency units (e.g. 42.50 = $42.50), never minor units (cents).
   \u2022 Billing mode is decided server-side: pay_per_call needs a PAID --payment-order-id (from
     payment-cli); monthly_settlement forbids it (settled against the developer's account).
-  \u2022 Write verbs (book / cancel) require --idempotency-key; reuse the SAME key when retrying the
-    same intent.`
+  \u2022 Write verbs (book / cancel / update) require --idempotency-key; reuse the SAME key when
+    retrying the same intent.
+  \u2022 update changes ONLY the fields you pass. Trip-side and passenger-side changes are two separate
+    upstream calls with no transaction: the response reports ride_updated / passenger_updated, and a
+    partial application returns UPSTREAM_ERROR with data.partial_update \u2014 re-issue update for the
+    failed side only.`
   );
   registerQuoteCommand(rideCmd, deps);
   registerBookCommand(rideCmd, deps);
   registerRideGetCommand(rideCmd, deps);
   registerCancelCommand(rideCmd, deps);
+  registerRideUpdateCommand(rideCmd, deps);
+  registerRideTripStatusCommand(rideCmd, deps);
   registerListOrdersCommand(rideCmd, deps);
   const servicesCmd = program.command("services").description("Merchant service discovery");
   registerServicesListCommand(servicesCmd, { discoveryClient, program });