@tks/wayfinder 0.5.0 → 0.6.0

package/README.md

@@ -70,6 +70,12 @@ Search with filters:
 wayfinder flights --from LAX --to SEA --date 2026-04-10 --airline AS --max-stops 0 --max-price 250 --depart-after 06:00 --depart-before 12:00
 ```
 
+Search by cabin:
+
+```bash
+wayfinder flights --from JFK --to HND --date 2026-06-15 --cabin premium-economy
+```
+
 Exclude basic economy fares:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tks/wayfinder",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Travel search for your terminal and your AI agents",
   "repository": {
     "type": "git",

package/src/cli.ts

@@ -43,6 +43,7 @@ Flights required:
 
 Flights optional filters:
   --airline <IATA>          Airline code, example UA
+  --cabin <CABIN>           Cabin: economy, premium-economy, preeco, business, first
   --max-stops <0|1|2>       Maximum number of stops
   --max-price <USD>         Max price in USD
   --depart-after <HH:MM>    Start of departure window

package/src/format.ts

@@ -14,6 +14,7 @@ export function renderFlightTable(options: FlightOption[]): string {
     arrive: option.arrivalTime,
     duration: formatDuration(option.durationMinutes),
     stops: String(option.stops),
+    cabin: option.cabin ?? "n/a",
   }));
 
   const headers = {
@@ -23,6 +24,7 @@ export function renderFlightTable(options: FlightOption[]): string {
     arrive: "ARRIVE",
     duration: "DURATION",
     stops: "STOPS",
+    cabin: "CABIN",
   };
 
   const widths = {
@@ -32,6 +34,7 @@ export function renderFlightTable(options: FlightOption[]): string {
     arrive: maxWidth(rows, "arrive", headers.arrive),
     duration: maxWidth(rows, "duration", headers.duration),
     stops: maxWidth(rows, "stops", headers.stops),
+    cabin: maxWidth(rows, "cabin", headers.cabin),
   };
 
   const lines: string[] = [];
@@ -44,6 +47,7 @@ export function renderFlightTable(options: FlightOption[]): string {
       headers.arrive.padEnd(widths.arrive),
       headers.duration.padEnd(widths.duration),
       headers.stops.padEnd(widths.stops),
+      headers.cabin.padEnd(widths.cabin),
     ].join("  "),
   );
 
@@ -55,6 +59,7 @@ export function renderFlightTable(options: FlightOption[]): string {
       "-".repeat(widths.arrive),
       "-".repeat(widths.duration),
       "-".repeat(widths.stops),
+      "-".repeat(widths.cabin),
     ].join("  "),
   );
 
@@ -67,6 +72,7 @@ export function renderFlightTable(options: FlightOption[]): string {
         row.arrive.padEnd(widths.arrive),
         row.duration.padEnd(widths.duration),
         row.stops.padEnd(widths.stops),
+        row.cabin.padEnd(widths.cabin),
       ].join("  "),
     );
   }

package/src/parse.ts

@@ -2,6 +2,7 @@ import { CliError } from "./errors";
 import {
   ExitCode,
   FlightBookingQuery,
+  CabinClass,
   FlightsQuery,
   HotelClass,
   HotelQuery,
@@ -16,6 +17,7 @@ interface FlightRawOptions {
   to?: string;
   dates: string[];
   airline?: string;
+  cabin?: string;
   maxStops?: string;
   maxPrice?: string;
   departAfter?: string;
@@ -140,6 +142,9 @@ function parseFlightsArgs(args: string[]): ParsedArgs {
       case "--airline":
         raw.airline = value;
         break;
+      case "--cabin":
+        raw.cabin = value;
+        break;
       case "--max-stops":
         raw.maxStops = value;
         break;
@@ -428,9 +433,14 @@ function buildFlightQuery(raw: FlightRawOptions): FlightsQuery {
   }
 
   const airlineCode = raw.airline ? normalizeAirlineCode(raw.airline) : undefined;
+  const cabin = raw.cabin ? normalizeCabin(raw.cabin) : undefined;
   const maxStops = raw.maxStops ? normalizeMaxStops(raw.maxStops) : undefined;
   const maxPrice = raw.maxPrice ? normalizePrice(raw.maxPrice, "--max-price") : undefined;
 
+  if (raw.excludeBasic && cabin && cabin !== "economy") {
+    throw new CliError("--exclude-basic can only be used with --cabin economy", ExitCode.InvalidInput);
+  }
+
   const hasDepartAfter = typeof raw.departAfter === "string";
   const hasDepartBefore = typeof raw.departBefore === "string";
 
@@ -460,6 +470,7 @@ function buildFlightQuery(raw: FlightRawOptions): FlightsQuery {
     origin,
     destination,
     airlineCode,
+    cabin,
     maxStops,
     maxPrice,
     departureAfterMinutes,
@@ -639,6 +650,27 @@ function normalizeAirlineCode(value: string): string {
   return upper;
 }
 
+function normalizeCabin(value: string): CabinClass {
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "preeco") {
+    return "premium-economy";
+  }
+
+  if (
+    normalized === "economy" ||
+    normalized === "premium-economy" ||
+    normalized === "business" ||
+    normalized === "first"
+  ) {
+    return normalized;
+  }
+
+  throw new CliError(
+    "--cabin must be one of: economy, premium-economy, preeco, business, first",
+    ExitCode.InvalidInput,
+  );
+}
+
 function normalizeLocation(value: string): string {
   const trimmed = value.trim();
   if (trimmed.length === 0) {

package/src/serpapi.ts

@@ -1,5 +1,6 @@
 import { CliError } from "./errors";
 import {
+  CabinClass,
   ExitCode,
   FlightDateResult,
   FlightBookingQuery,
@@ -22,6 +23,7 @@ interface SerpApiAirport {
 
 interface SerpApiSegment {
   airline?: string;
+  travel_class?: string;
   duration?: number;
   departure_airport?: SerpApiAirport;
   arrival_airport?: SerpApiAirport;
@@ -148,6 +150,7 @@ export async function searchFlightsMultiDate(
       destination: query.destination,
       departureDate: date,
       airlineCode: query.airlineCode,
+      cabin: query.cabin,
       maxStops: query.maxStops,
       maxPrice: query.maxPrice,
       departureAfterMinutes: query.departureAfterMinutes,
@@ -291,6 +294,9 @@ function shapeItinerary(itinerary: SerpApiItinerary): FlightOption | null {
   }
 
   const uniqueAirlines = [...new Set(segments.map((segment) => segment.airline).filter(Boolean))];
+  const cabinClasses = [
+    ...new Set(segments.map((segment) => segment.travel_class).filter(isNonEmptyString)),
+  ];
 
   const option: FlightOption = {
     price: itinerary.price as number,
@@ -301,6 +307,10 @@ function shapeItinerary(itinerary: SerpApiItinerary): FlightOption | null {
     stops: Math.max(0, segments.length - 1),
   };
 
+  if (cabinClasses.length > 0) {
+    option.cabin = cabinClasses.join(", ");
+  }
+
   if (typeof itinerary.booking_token === "string" && itinerary.booking_token.trim() !== "") {
     option.bookingToken = itinerary.booking_token.trim();
   }
@@ -351,6 +361,10 @@ function inferDurationMinutes(itinerary: SerpApiItinerary, segments: SerpApiSegm
   return segmentDuration;
 }
 
+function isNonEmptyString(value: unknown): value is string {
+  return typeof value === "string" && value.trim() !== "";
+}
+
 function buildFlightRequestUrl(query: FlightQuery, apiKey: string): string {
   const url = new URL("https://serpapi.com/search.json");
 
@@ -367,6 +381,10 @@ function buildFlightRequestUrl(query: FlightQuery, apiKey: string): string {
     url.searchParams.set("include_airlines", query.airlineCode);
   }
 
+  if (query.cabin) {
+    url.searchParams.set("travel_class", toSerpApiTravelClass(query.cabin));
+  }
+
   if (typeof query.maxStops === "number") {
     url.searchParams.set("stops", toSerpApiStopsFilter(query.maxStops));
   }
@@ -390,7 +408,7 @@ function buildFlightRequestUrl(query: FlightQuery, apiKey: string): string {
 
   if (query.excludeBasic) {
     url.searchParams.set("exclude_basic", "true");
-    url.searchParams.set("travel_class", "1");
+    url.searchParams.set("travel_class", toSerpApiTravelClass("economy"));
     url.searchParams.set("gl", "us");
   }
 
@@ -479,6 +497,22 @@ function toSerpApiStopsFilter(maxStops: number): string {
   return "3";
 }
 
+function toSerpApiTravelClass(cabin: CabinClass): string {
+  if (cabin === "economy") {
+    return "1";
+  }
+
+  if (cabin === "premium-economy") {
+    return "2";
+  }
+
+  if (cabin === "business") {
+    return "3";
+  }
+
+  return "4";
+}
+
 function toSerpApiRating(rating: 3.5 | 4 | 4.5 | 5): string {
   if (rating === 3.5) {
     return "7";

package/src/types.ts

@@ -9,11 +9,14 @@ export const ExitCode = {
 
 export type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
 
+export type CabinClass = "economy" | "premium-economy" | "business" | "first";
+
 export interface FlightQuery {
   origin: string;
   destination: string;
   departureDate: string;
   airlineCode?: string;
+  cabin?: CabinClass;
   maxStops?: number;
   maxPrice?: number;
   departureAfterMinutes?: number;
@@ -26,6 +29,7 @@ export interface FlightMultiDateQuery {
   destination: string;
   departureDates: string[];
   airlineCode?: string;
+  cabin?: CabinClass;
   maxStops?: number;
   maxPrice?: number;
   departureAfterMinutes?: number;
@@ -123,6 +127,7 @@ export interface FlightOption {
   arrivalTime: string;
   durationMinutes: number;
   stops: number;
+  cabin?: string;
   bookingToken?: string;
 }