fortrip 0.2.1 → 0.3.0

package/AGENT_GUIDE.md

@@ -58,9 +58,12 @@ token into the chat.
    ```
 
    Use `--near lat,lng,radiusKm` for "near X", `--city-code` when known.
+   Pass `--currency` (`CNY`, the default, or `USD`) to suit the user, inferred
+   from their language or location, on both `search` and `rates`;
+   `--price-min` / `--price-max` are in that currency.
    `--facility` names must match the catalogue exactly (e.g. `Swimming pool`,
    `Parking`), otherwise nothing matches. Prices here (`price.nightlyFrom`,
-   `totalFrom`, CNY) are **indicative floors**, not quotes — say so.
+   `totalFrom`) are **indicative floors**, not quotes — say so.
 
 2. **Hotel detail** (optional) — description, policies, facilities, photos:
 
@@ -73,11 +76,13 @@ token into the chat.
    ```bash
    fortrip rates --hotel 266000 --hotel 266001 --check-in 2026-11-10 \
      --check-out 2026-11-12 --rooms 1 --adults 2 [--child-age 6] \
-     [--nationality CN] [--board BB] [--free-cancellation]
+     [--nationality CN] [--board BB] [--free-cancellation] [--currency USD]
    ```
 
-   This call takes about 15 seconds. `totalPrice` is CNY at Stripe's exchange
-   rate (refreshed hourly). Present each option with meal plan (`boardCode`: RO room only,
+   This call takes about 15 seconds. Prices are in the response's `currency`,
+   converted at Stripe's exchange rate (refreshed hourly), or a fixed fallback
+   rate when Stripe is unavailable; `fx` says which, and is `null` when
+   nothing needed converting. Present each option with meal plan (`boardCode`: RO room only,
    BB breakfast, HB half board, FB full board, AI all inclusive),
    `freeCancelUntil` / `refundable`, `isInstantConfirm`, and any `fees`
    (taxes paid at the hotel, in their own currency).
@@ -106,11 +111,11 @@ token into the chat.
    (`boardCode`, `boardCount`), cancellation (`refundable`, `freeCancelUntil`,
    the `cancellation` ladder), confirmation (`isInstantConfirm`,
    `confirmByMins`) and `payAtHotelFees`.
-2. **Explain the amount.** `rates` showed CNY, but the charge is `amount` in
-   `currency` (usually USD), and the Stripe page may display the user's local
-   currency at Stripe's rate. The CNY figure used a Stripe rate too, so it is
-   usually close, but the amount on the payment page is what will be charged;
-   the CNY figure was a reference.
+2. **Explain the amount.** `rates` showed a converted figure, but the charge
+   is `amount` in `currency` (usually USD), and the Stripe page may display
+   the user's local currency at Stripe's rate. The `rates` figure used a
+   Stripe rate too, so it is usually close, but the amount on the payment page
+   is what will be charged; the `rates` figure was a reference.
 3. The link is for **this user only**: whoever has it can pay. Don't post it
    in shared channels, logs or tickets. It expires after about 3 hours 45
    minutes; call `book` again with the same details for a fresh one.

package/README.md

@@ -48,6 +48,9 @@ Output is JSON on stdout. Errors are JSON on stderr, with fixed exit codes:
 - `FORTRIP_TOKEN` overrides the saved login (CI, remote sandboxes).
 - `FORTRIP_API_URL` overrides the base URL (default `https://fortrip.ai`).
   Plain `http` is only accepted for `localhost`.
+- `FORTRIP_CURRENCY` sets the default `--currency` for `search` and `rates`
+  (`CNY` or `USD`; the API defaults to `CNY`). Display only: `book`
+  charges the currency it returns.
 
 Tokens don't expire; `logout` revokes them.
 

package/dist/cli.js

@@ -102,6 +102,7 @@ function unwrap(response) {
 import { readFileSync as readFileSync2 } from "fs";
 import { parseArgs } from "util";
 var BODY_OPTION = { body: { type: "string" } };
+var CURRENCY_OPTION = { currency: { type: "string" } };
 function parse(argv, options) {
   try {
     return parseArgs({ args: argv, options, allowPositionals: true, strict: true });
@@ -147,6 +148,13 @@ function str(value) {
 function list(value) {
   return Array.isArray(value) && value.length ? value : void 0;
 }
+function currency(values, base, env) {
+  const flag = str(values.currency)?.trim().toUpperCase();
+  if (flag === "") throw usageError("--currency must not be empty");
+  if (flag) return flag;
+  if (base.currency !== void 0) return void 0;
+  return env.FORTRIP_CURRENCY?.trim().toUpperCase() || void 0;
+}
 function merge(base, overrides) {
   const body = { ...base };
   for (const [key, value] of Object.entries(overrides)) {
@@ -156,6 +164,7 @@ function merge(base, overrides) {
 }
 var SEARCH_OPTIONS = {
   ...BODY_OPTION,
+  ...CURRENCY_OPTION,
   query: { type: "string", short: "q" },
   "city-code": { type: "string" },
   near: { type: "string" },
@@ -170,7 +179,8 @@ var SEARCH_OPTIONS = {
   page: { type: "string" },
   "page-size": { type: "string" }
 };
-function searchBody(values) {
+function searchBody(values, env = process.env) {
+  const base = baseBody(values);
   let near;
   const nearRaw = str(values.near);
   if (nearRaw !== void 0) {
@@ -184,7 +194,7 @@ function searchBody(values) {
       radiusKm: num("near", radiusKm)
     };
   }
-  return merge(baseBody(values), {
+  return merge(base, {
     query: str(values.query),
     cityCode: num("city-code", str(values["city-code"])),
     near,
@@ -197,7 +207,8 @@ function searchBody(values) {
     priceMax: num("price-max", str(values["price-max"])),
     sortBy: str(values.sort),
     page: num("page", str(values.page)),
-    pageSize: num("page-size", str(values["page-size"]))
+    pageSize: num("page-size", str(values["page-size"])),
+    currency: currency(values, base, env)
   });
 }
 var HOTEL_OPTIONS = {
@@ -228,6 +239,7 @@ function stayFields(values, base) {
 }
 var RATES_OPTIONS = {
   ...BODY_OPTION,
+  ...CURRENCY_OPTION,
   ...STAY_OPTIONS,
   hotel: { type: "string", multiple: true },
   nationality: { type: "string" },
@@ -236,7 +248,7 @@ var RATES_OPTIONS = {
   "include-unbookable": { type: "boolean" },
   "max-rooms": { type: "string" }
 };
-function ratesBody(values) {
+function ratesBody(values, env = process.env) {
   const base = baseBody(values);
   return merge(base, {
     hotelIds: nums("hotel", list(values.hotel)),
@@ -247,7 +259,8 @@ function ratesBody(values) {
     ),
     freeCancellation: values["free-cancellation"] ? true : void 0,
     bookableOnly: values["include-unbookable"] ? false : void 0,
-    maxRoomsPerHotel: num("max-rooms", str(values["max-rooms"]))
+    maxRoomsPerHotel: num("max-rooms", str(values["max-rooms"])),
+    currency: currency(values, base, env)
   });
 }
 var BOOK_OPTIONS = {
@@ -538,9 +551,9 @@ Commands:
   login [--no-browser]        Sign in through the browser (device code)
   logout                      Revoke and forget the saved token
   whoami                      Show the signed-in account
-  search                      Find hotels with indicative prices (CNY)
+  search                      Find hotels with indicative prices
   hotel <hotelId>             Static hotel detail [--with-rooms]
-  rates                       Live rooms and rates (CNY) for up to 15 hotels
+  rates                       Live rooms and rates for up to 15 hotels
   book                        Create an order and get a payment link
   skill [planning]            Print the guide for AI agents (Markdown)
 
@@ -548,10 +561,11 @@ search:  --query <text> | --city-code <n> | --near <lat,lng,km>
          --check-in YYYY-MM-DD --check-out YYYY-MM-DD
          [--star-min n] [--star-max n] [--facility <name>]... [--price-min n]
          [--price-max n] [--sort recommended|price-asc|price-desc|star-desc|distance]
-         [--page n] [--page-size n]
+         [--page n] [--page-size n] [--currency CNY|USD]
 rates:   --hotel <id>... --check-in --check-out [--rooms 1] [--adults 2]
          [--child-age n]... [--nationality CN] [--board BB]...
          [--free-cancellation] [--include-unbookable] [--max-rooms n]
+         [--currency CNY|USD]
 book:    --hotel <id> --room-id <id> --rate-plan <code> --check-in --check-out
          [--rooms 1] [--adults 2] [--child-age n]...
          --guest "First Last[:roomNo]"... --contact-name <name>
@@ -561,12 +575,18 @@ book:    --hotel <id> --room-id <id> --rate-plan <code> --check-in --check-out
 search, rates and book also take --body '<json>' (or --body @file.json) with
 the raw request body; flags override its fields.
 
+search and rates ask for prices in --currency (CNY by default, or USD),
+converted at Stripe's rate or a fixed fallback rate; the response's currency
+and fx fields say which. book still charges the currency it returns (usually
+USD).
+
 Output is JSON on stdout; errors are JSON on stderr.
 Exit codes: 0 ok, 1 error, 2 invalid arguments, 3 not logged in, 4 rate limited.
 
 Environment:
   FORTRIP_TOKEN    Use this token instead of the saved login (CI, sandboxes)
   FORTRIP_API_URL  API base URL (default https://fortrip.ai)
+  FORTRIP_CURRENCY Default --currency for search and rates
 `;
 async function run(argv) {
   const [command, ...rest] = argv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fortrip",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Search, price and book Fortrip hotels from the terminal or an AI agent.",
   "type": "module",
   "repository": {