letsfg 2026.5.66 → 2026.5.68

package/README.md

@@ -86,6 +86,19 @@ and `idempotencyKey`).
 - `offerSummary(offer)` — One-line string summary
 - `cheapestOffer(result)` — Get cheapest offer from search
 
+## Starlink Wi-Fi
+
+Offers may carry `starlink`: `confirmed_all` / `confirmed_some` mean the carrier
+has **fully** fitted that aircraft type; `likely_all` / `likely_some` mean the
+rollout on that type is underway but incomplete. Segments carry `confirmed` or
+`likely`.
+
+Only `confirmed_*` is safe to state as fact — `likely_*` is a signal, not a
+promise. Anything ending `_some` has at least one leg without it. An **absent**
+field means no information, **not** an absence of Wi-Fi.
+
+Full semantics: [docs/api-search.md](https://github.com/LetsFG/LetsFG/blob/main/docs/api-search.md#starlink-wi-fi).
+
 ## Zero Dependencies
 
 Uses native `fetch` (Node 18+). No `axios`, no `node-fetch`, nothing. Safe for sandboxed environments.
@@ -150,6 +163,17 @@ else; after it, the hotel's own cancellation ladder applies and can reach 100%.
 That ladder ships in the booking's `terms`, so you can always see the cost before
 you cancel.
 
+### What search costs
+
+Search is metered separately from booking, on **either** auth path (free PFS
+Bearer token or Developer API key — both count against the same agent):
+**the first 1,000 `search_hotels` calls since your last hotel booking are
+free.** Past that, searches are billed in blocks of 1,000 for **$5**
+(~$0.005/search) from your prepaid balance — refused with a 402 if the
+balance can't cover the next block, never silently allowed. Book a hotel
+and the count resets to zero. Resolving a city name (`hotel_destinations`)
+is not metered, only the search call itself.
+
 ### Things worth knowing before you build
 
 - **A card on file is required for every hotel call, including search.** That is

package/dist/{chunk-2SNO3AGS.mjs → chunk-QLCIHPPX.mjs}

@@ -87,6 +87,23 @@ function collectFlightNumbers(offer) {
     offer.flight_number
   ]);
 }
+function buildStarlinkNote(offer) {
+  const segments = collectOfferSegments(offer);
+  const label = (s) => s.origin && s.destination ? `${s.origin}\u2192${s.destination}` : (s.flight_number || "").trim();
+  const confirmed = segments.filter((s) => s.starlink === "confirmed");
+  const likely = segments.filter((s) => s.starlink === "likely");
+  if (confirmed.length === 0 && likely.length === 0) return void 0;
+  const parts = [];
+  if (confirmed.length > 0) {
+    const where = confirmed.length === segments.length ? "every leg" : confirmed.map(label).filter(Boolean).join(", ");
+    parts.push(`Starlink Wi-Fi on ${where}`);
+  }
+  if (likely.length > 0) {
+    const where = likely.map(label).filter(Boolean).join(", ");
+    parts.push(`Starlink being installed on this aircraft type${where ? ` (${where})` : ""}, not guaranteed`);
+  }
+  return parts.join("; ");
+}
 function collectAircraftTypes(offer) {
   return collectUniqueDetailValues(
     collectOfferSegments(offer).map((segment) => segment.aircraft?.replace(/\s*\([^)]*\)/g, "").trim())
@@ -428,6 +445,10 @@ function getOfferDetailPromptNotes(offer) {
   if (aircraftTypes.length > 0) {
     pushUniqueNote(notes, `Aircraft shown: ${aircraftTypes.join(", ")}`);
   }
+  const starlinkNote = buildStarlinkNote(offer);
+  if (starlinkNote) {
+    pushUniqueNote(notes, starlinkNote);
+  }
   const operatingCarriers = collectOperatingCarriers(offer);
   const normalizedOfferAirline = typeof offer.airline === "string" ? offer.airline.trim().toLowerCase() : "";
   if (operatingCarriers.length === 1 && operatingCarriers[0].toLowerCase() !== normalizedOfferAirline) {

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   LetsFG,
   LetsFGError,
   offerSummary
-} from "./chunk-2SNO3AGS.mjs";
+} from "./chunk-QLCIHPPX.mjs";
 import {
   BearerTokenError,
   getBearerToken,

package/dist/index.d.mts

@@ -212,6 +212,10 @@ interface OfferDetailSegmentLike {
     airline?: string;
     flight_number?: string;
     aircraft?: string;
+    origin?: string;
+    destination?: string;
+    /** Per-leg Starlink verdict; see StarlinkSegmentVerdict in index.ts. */
+    starlink?: 'confirmed' | 'likely';
 }
 interface OfferDetailLegLike {
     segments?: OfferDetailSegmentLike[];
@@ -296,7 +300,17 @@ interface FlightSegment {
     duration_seconds: number;
     cabin_class: string;
     aircraft: string;
+    /** Starlink Wi-Fi on this leg. 'confirmed' = the carrier has fitted every
+     *  aircraft of this type. 'likely' = installation on this type is underway
+     *  but incomplete, so this airframe may not have it. Undefined means no
+     *  information — NOT an absence of Wi-Fi. */
+    starlink?: StarlinkSegmentVerdict;
 }
+type StarlinkSegmentVerdict = 'confirmed' | 'likely';
+/** Itinerary-level Starlink verdict. '*_some' means at least one leg has none;
+ *  'likely_*' means the rollout on that subfleet is underway but incomplete.
+ *  Only 'confirmed_*' should be shown to an end user as a fact. */
+type StarlinkOfferVerdict = 'confirmed_all' | 'confirmed_some' | 'likely_all' | 'likely_some';
 interface FlightRoute {
     segments: FlightSegment[];
     total_duration_seconds: number;
@@ -312,6 +326,9 @@ interface FlightOffer {
     airlines: string[];
     owner_airline: string;
     bags_price: Record<string, number>;
+    /** Starlink Wi-Fi across the whole itinerary; per-leg detail is on each
+     *  segment's `starlink`. Undefined when no leg has any information. */
+    starlink?: StarlinkOfferVerdict;
     availability_seats: number | null;
     conditions: Record<string, string>;
     is_locked: boolean;
@@ -628,4 +645,4 @@ declare const BoostedTravel: typeof LetsFG;
 declare const BoostedTravelError: typeof LetsFGError;
 type BoostedTravelConfig = LetsFGConfig;
 
-export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, type OfferDetailSignals, OfferExpiredError, type Passenger, PaymentRequiredError, type RankOffer, type RankedOffer, type RankingContext, type ScoreBreakdown, type SearchOptions, TRIP_PURPOSES, type TripPurpose, type TripPurposeOptions, type UnlockResult, ValidationError, cheapestOffer, deduplicateOffers, LetsFG as default, extractOfferDetailSignals, getOfferDetailBadges, getOfferDetailPromptNotes, getPrimaryTripPurpose, getProfileLabel, normalizeTripPurposes, offerSummary, rankOffers, selectDiverseTop };
+export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, type OfferDetailSignals, OfferExpiredError, type Passenger, PaymentRequiredError, type RankOffer, type RankedOffer, type RankingContext, type ScoreBreakdown, type SearchOptions, type StarlinkOfferVerdict, type StarlinkSegmentVerdict, TRIP_PURPOSES, type TripPurpose, type TripPurposeOptions, type UnlockResult, ValidationError, cheapestOffer, deduplicateOffers, LetsFG as default, extractOfferDetailSignals, getOfferDetailBadges, getOfferDetailPromptNotes, getPrimaryTripPurpose, getProfileLabel, normalizeTripPurposes, offerSummary, rankOffers, selectDiverseTop };

package/dist/index.d.ts

@@ -212,6 +212,10 @@ interface OfferDetailSegmentLike {
     airline?: string;
     flight_number?: string;
     aircraft?: string;
+    origin?: string;
+    destination?: string;
+    /** Per-leg Starlink verdict; see StarlinkSegmentVerdict in index.ts. */
+    starlink?: 'confirmed' | 'likely';
 }
 interface OfferDetailLegLike {
     segments?: OfferDetailSegmentLike[];
@@ -296,7 +300,17 @@ interface FlightSegment {
     duration_seconds: number;
     cabin_class: string;
     aircraft: string;
+    /** Starlink Wi-Fi on this leg. 'confirmed' = the carrier has fitted every
+     *  aircraft of this type. 'likely' = installation on this type is underway
+     *  but incomplete, so this airframe may not have it. Undefined means no
+     *  information — NOT an absence of Wi-Fi. */
+    starlink?: StarlinkSegmentVerdict;
 }
+type StarlinkSegmentVerdict = 'confirmed' | 'likely';
+/** Itinerary-level Starlink verdict. '*_some' means at least one leg has none;
+ *  'likely_*' means the rollout on that subfleet is underway but incomplete.
+ *  Only 'confirmed_*' should be shown to an end user as a fact. */
+type StarlinkOfferVerdict = 'confirmed_all' | 'confirmed_some' | 'likely_all' | 'likely_some';
 interface FlightRoute {
     segments: FlightSegment[];
     total_duration_seconds: number;
@@ -312,6 +326,9 @@ interface FlightOffer {
     airlines: string[];
     owner_airline: string;
     bags_price: Record<string, number>;
+    /** Starlink Wi-Fi across the whole itinerary; per-leg detail is on each
+     *  segment's `starlink`. Undefined when no leg has any information. */
+    starlink?: StarlinkOfferVerdict;
     availability_seats: number | null;
     conditions: Record<string, string>;
     is_locked: boolean;
@@ -628,4 +645,4 @@ declare const BoostedTravel: typeof LetsFG;
 declare const BoostedTravelError: typeof LetsFGError;
 type BoostedTravelConfig = LetsFGConfig;
 
-export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, type OfferDetailSignals, OfferExpiredError, type Passenger, PaymentRequiredError, type RankOffer, type RankedOffer, type RankingContext, type ScoreBreakdown, type SearchOptions, TRIP_PURPOSES, type TripPurpose, type TripPurposeOptions, type UnlockResult, ValidationError, cheapestOffer, deduplicateOffers, LetsFG as default, extractOfferDetailSignals, getOfferDetailBadges, getOfferDetailPromptNotes, getPrimaryTripPurpose, getProfileLabel, normalizeTripPurposes, offerSummary, rankOffers, selectDiverseTop };
+export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, type OfferDetailSignals, OfferExpiredError, type Passenger, PaymentRequiredError, type RankOffer, type RankedOffer, type RankingContext, type ScoreBreakdown, type SearchOptions, type StarlinkOfferVerdict, type StarlinkSegmentVerdict, TRIP_PURPOSES, type TripPurpose, type TripPurposeOptions, type UnlockResult, ValidationError, cheapestOffer, deduplicateOffers, LetsFG as default, extractOfferDetailSignals, getOfferDetailBadges, getOfferDetailPromptNotes, getPrimaryTripPurpose, getProfileLabel, normalizeTripPurposes, offerSummary, rankOffers, selectDiverseTop };

package/dist/index.js

@@ -135,6 +135,23 @@ function collectFlightNumbers(offer) {
     offer.flight_number
   ]);
 }
+function buildStarlinkNote(offer) {
+  const segments = collectOfferSegments(offer);
+  const label = (s) => s.origin && s.destination ? `${s.origin}\u2192${s.destination}` : (s.flight_number || "").trim();
+  const confirmed = segments.filter((s) => s.starlink === "confirmed");
+  const likely = segments.filter((s) => s.starlink === "likely");
+  if (confirmed.length === 0 && likely.length === 0) return void 0;
+  const parts = [];
+  if (confirmed.length > 0) {
+    const where = confirmed.length === segments.length ? "every leg" : confirmed.map(label).filter(Boolean).join(", ");
+    parts.push(`Starlink Wi-Fi on ${where}`);
+  }
+  if (likely.length > 0) {
+    const where = likely.map(label).filter(Boolean).join(", ");
+    parts.push(`Starlink being installed on this aircraft type${where ? ` (${where})` : ""}, not guaranteed`);
+  }
+  return parts.join("; ");
+}
 function collectAircraftTypes(offer) {
   return collectUniqueDetailValues(
     collectOfferSegments(offer).map((segment) => segment.aircraft?.replace(/\s*\([^)]*\)/g, "").trim())
@@ -476,6 +493,10 @@ function getOfferDetailPromptNotes(offer) {
   if (aircraftTypes.length > 0) {
     pushUniqueNote(notes, `Aircraft shown: ${aircraftTypes.join(", ")}`);
   }
+  const starlinkNote = buildStarlinkNote(offer);
+  if (starlinkNote) {
+    pushUniqueNote(notes, starlinkNote);
+  }
   const operatingCarriers = collectOperatingCarriers(offer);
   const normalizedOfferAirline = typeof offer.airline === "string" ? offer.airline.trim().toLowerCase() : "";
   if (operatingCarriers.length === 1 && operatingCarriers[0].toLowerCase() !== normalizedOfferAirline) {

package/dist/index.mjs

@@ -22,7 +22,7 @@ import {
   offerSummary,
   rankOffers,
   selectDiverseTop
-} from "./chunk-2SNO3AGS.mjs";
+} from "./chunk-QLCIHPPX.mjs";
 export {
   AuthenticationError,
   BoostedTravel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "letsfg",
-  "version": "2026.5.66",
+  "version": "2026.5.68",
   "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.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",