letsfg 2026.5.74 → 2026.5.75

package/README.md

@@ -1,6 +1,6 @@
 # LetsFG — Your AI agent just learned to book flights. (Node.js)
 
-**Server-side search engine. Real prices. One function call.** Search hundreds of airlines at raw airline prices — **$20–$50 cheaper** than Booking.com, Kayak, and other OTAs. Zero dependencies. Built for AI agents.
+**Server-side search engine. Real prices. One function call.** Search every airline in the world and the major booking sites; the price shown is the total you pay. Zero dependencies. Built for AI agents.
 
 [![GitHub stars](https://img.shields.io/github/stars/LetsFG/LetsFG?style=social)](https://github.com/LetsFG/LetsFG)
 [![npm](https://img.shields.io/npm/v/letsfg)](https://www.npmjs.com/package/letsfg)
@@ -54,7 +54,7 @@ const flights = await bt.search('GDN', 'BER', '2026-03-03');
 const best = cheapestOffer(flights);
 console.log(offerSummary(best));
 
-// Book — no booking fee, no transaction fee — our margin is already in the price you saw; no unlock step. Starts the booking:
+// Book — no booking fee, no transaction fee on top of the price you saw; no unlock step. Starts the booking:
 // the fare is HELD on your card and a LetsFG agent buys the ticket (4-11 min).
 const result = await bt.book(
   best.id,
@@ -87,7 +87,7 @@ console.log(status); // { state: 'completed', pnr: 'ABC123', charged_amount: 93,
 ### How booking works
 
 `bt.book()` posts to `POST /api/agent-book` and does exactly what the website
-checkout does: the fare plus LetsFG's markup is **held** on the connected card
+checkout does: the price shown is **held** on the connected card
 (not taken), a LetsFG booking agent buys the ticket from the seller, and the
 hold is captured only once a real airline PNR exists. If the booking fails the
 hold is released and nothing is charged. Every offer can be booked this way —
@@ -182,6 +182,12 @@ MIT
 
 Your agent can book hotels as well as flights. Same card-backed token or API key, same connected payment method.
 
+> **Update your SDK before booking hotels.** Hotel booking needs **letsfg 2026.5.101** or later (Python),
+> **letsfg 2026.5.74** or later (JavaScript/TypeScript) or **letsfg-mcp 2026.5.77** or later. Earlier releases send
+> the reservation-fee fields retired on 2026-09-11 (`expected_balance`, no `expected_cost`), and the API refuses
+> every hotel booking they make. Update with `pip install -U letsfg`, `npm install letsfg@latest` or
+> `npx -y letsfg-mcp@latest`. The hosted MCP at `https://letsfg.co/developers/api/mcp` needs no update.
+
 ```python
 from letsfg import LetsFG
 lfg = LetsFG()
@@ -232,9 +238,7 @@ released and nothing is charged.
 There is **no reservation fee, no deposit and no pay link**, and the guest owes the hotel nothing
 further. (Those belonged to the process retired on 2026-09-11.)
 
-`price` is the supplier's cost plus 6.4% (our margin and payment processing) for Revolut Pay or a
-card issued in the EEA, or 8.3% for a card issued outside the EEA — the search response's
-`markup_rate` says which. Nothing is added at booking. Prices are in the currency you search in:
+`price` is what the guest pays. Nothing is added at booking. Prices are in the currency you search in:
 USD unless you ask for another.
 
 Cancelling a refundable rate before its `free_cancellation_until` costs nothing and refunds the

package/dist/{chunk-GVKYPTY3.mjs → chunk-6IWYHW62.mjs}

@@ -1618,15 +1618,23 @@ var LetsFG = class {
       currency: options.currency ?? "EUR",
       limit: options.limit ?? 50
     };
-    if (options.returnDate) body.return_date = options.returnDate;
-    if (options.cabinClass) body.cabin_class = options.cabinClass;
-    if (options.maxStopovers != null) body.max_stopovers = options.maxStopovers;
-    if (options.sort) body.sort = options.sort;
     if (options.departureTimeFrom) body.departure_time_from = options.departureTimeFrom;
     if (options.departureTimeTo) body.departure_time_to = options.departureTimeTo;
     if (this.usingPFS) {
-      return this.searchPFS(body);
+      if (options.returnDate) body.return_date = options.returnDate;
+      if (options.cabinClass) body.cabin = options.cabinClass;
+      if (options.maxStopovers != null) body.max_stops = options.maxStopovers;
+      if (options.sort) body.sort_by = options.sort;
+      const result = await this.searchPFS(body);
+      if (options.limit != null && Array.isArray(result.offers)) {
+        result.offers = result.offers.slice(0, Math.max(0, options.limit));
+      }
+      return result;
     }
+    if (options.returnDate) body.return_from = options.returnDate;
+    if (options.cabinClass) body.cabin_class = options.cabinClass;
+    if (options.maxStopovers != null) body.max_stopovers = options.maxStopovers;
+    if (options.sort) body.sort = options.sort;
     return this.post("/developers/api/v1/flights/search", body);
   }
   /** PFS path: POST /api/search -> poll /api/results/<id> */

package/dist/cli.js

@@ -374,15 +374,23 @@ var LetsFG = class {
       currency: options.currency ?? "EUR",
       limit: options.limit ?? 50
     };
-    if (options.returnDate) body.return_date = options.returnDate;
-    if (options.cabinClass) body.cabin_class = options.cabinClass;
-    if (options.maxStopovers != null) body.max_stopovers = options.maxStopovers;
-    if (options.sort) body.sort = options.sort;
     if (options.departureTimeFrom) body.departure_time_from = options.departureTimeFrom;
     if (options.departureTimeTo) body.departure_time_to = options.departureTimeTo;
     if (this.usingPFS) {
-      return this.searchPFS(body);
+      if (options.returnDate) body.return_date = options.returnDate;
+      if (options.cabinClass) body.cabin = options.cabinClass;
+      if (options.maxStopovers != null) body.max_stops = options.maxStopovers;
+      if (options.sort) body.sort_by = options.sort;
+      const result = await this.searchPFS(body);
+      if (options.limit != null && Array.isArray(result.offers)) {
+        result.offers = result.offers.slice(0, Math.max(0, options.limit));
+      }
+      return result;
     }
+    if (options.returnDate) body.return_from = options.returnDate;
+    if (options.cabinClass) body.cabin_class = options.cabinClass;
+    if (options.maxStopovers != null) body.max_stopovers = options.maxStopovers;
+    if (options.sort) body.sort = options.sort;
     return this.post("/developers/api/v1/flights/search", body);
   }
   /** PFS path: POST /api/search -> poll /api/results/<id> */

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   LetsFG,
   LetsFGError,
   offerSummary
-} from "./chunk-GVKYPTY3.mjs";
+} from "./chunk-6IWYHW62.mjs";
 
 // src/auth.ts
 import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync } from "fs";

package/dist/index.js

@@ -1667,15 +1667,23 @@ var LetsFG = class {
       currency: options.currency ?? "EUR",
       limit: options.limit ?? 50
     };
-    if (options.returnDate) body.return_date = options.returnDate;
-    if (options.cabinClass) body.cabin_class = options.cabinClass;
-    if (options.maxStopovers != null) body.max_stopovers = options.maxStopovers;
-    if (options.sort) body.sort = options.sort;
     if (options.departureTimeFrom) body.departure_time_from = options.departureTimeFrom;
     if (options.departureTimeTo) body.departure_time_to = options.departureTimeTo;
     if (this.usingPFS) {
-      return this.searchPFS(body);
+      if (options.returnDate) body.return_date = options.returnDate;
+      if (options.cabinClass) body.cabin = options.cabinClass;
+      if (options.maxStopovers != null) body.max_stops = options.maxStopovers;
+      if (options.sort) body.sort_by = options.sort;
+      const result = await this.searchPFS(body);
+      if (options.limit != null && Array.isArray(result.offers)) {
+        result.offers = result.offers.slice(0, Math.max(0, options.limit));
+      }
+      return result;
     }
+    if (options.returnDate) body.return_from = options.returnDate;
+    if (options.cabinClass) body.cabin_class = options.cabinClass;
+    if (options.maxStopovers != null) body.max_stopovers = options.maxStopovers;
+    if (options.sort) body.sort = options.sort;
     return this.post("/developers/api/v1/flights/search", body);
   }
   /** PFS path: POST /api/search -> poll /api/results/<id> */

package/dist/index.mjs

@@ -23,7 +23,7 @@ import {
   offerSummary,
   rankOffers,
   selectDiverseTop
-} from "./chunk-GVKYPTY3.mjs";
+} from "./chunk-6IWYHW62.mjs";
 export {
   AuthenticationError,
   BoostedTravel,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "letsfg",
-  "version": "2026.5.74",
-  "description": "Flights and hotels for AI agents. Server-side engine covers hundreds of airlines; hotels are real bookable inventory with free cancellation and pay-later terms. Includes open-source ranking engine.",
+  "version": "2026.5.75",
+  "description": "Flights and hotels for AI agents. Server-side engine covers hundreds of airlines; hotels are real bookable inventory with pay-later terms, and every rate says whether it is refundable. Includes open-source ranking engine.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",