imprint-mcp 0.5.0 → 0.6.0

package/examples/google-flights/{lookup_airport → get_flight_location_details}/index.ts

@@ -1,11 +1,11 @@
 /**
  * GENERATED by `imprint emit` — DO NOT EDIT BY HAND.
  *
- * Tool: lookup_airport
+ * Tool: get_flight_location_details
  * Site: google-flights
- * Intent: Resolve a city or airport query into airport codes and structured airport details.
+ * Intent: Resolve a selected airport, city, or place into detailed Google Flights location metadata.
  *
- * To regenerate: imprint emit ~/.imprint/google-flights/lookup_airport/workflow.json --force
+ * To regenerate: imprint emit ~/.imprint/google-flights/get_flight_location_details/workflow.json --force
  */
 
 import { fileURLToPath } from 'node:url';
@@ -17,23 +17,31 @@ import {
 import type { ToolResult, Workflow } from 'imprint/types';
 
 const WORKFLOW: Workflow = {
-  "toolName": "lookup_airport",
+  "toolName": "get_flight_location_details",
   "intent": {
-    "description": "Resolve a city or airport query into airport codes and structured airport details.",
-    "userSaid": "multi city from SJC to SAN to LAX to SFO"
+    "description": "Resolve a selected airport, city, or place into detailed Google Flights location metadata.",
+    "userSaid": "searched for a multi city flight; multi city from SJC to SAN to LAX to SFO"
   },
   "parameters": [
     {
-      "name": "query",
+      "name": "location_id",
       "type": "string",
-      "description": "City or airport search text, e.g. 'san jose' or 'SJC'",
+      "description": "Airport code such as SJC or Google place id such as /m/0d9jr.",
+      "default": "SJC",
+      "verified": true
+    },
+    {
+      "name": "location_type",
+      "type": "string",
+      "description": "Google Flights location type code: use 0 for airport_code or 5 for google_place_id/city place ids.",
+      "default": "0",
       "verified": true
     }
   ],
   "requests": [
     {
       "method": "POST",
-      "url": "https://www.google.com/_/FlightsFrontendUi/data/batchexecute?rpcids=tDoGIe&source-path=%2Ftravel%2Fflights&f.sid=${state.f_sid}&bl=${state.bl}&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=608023&rt=c",
+      "url": "https://www.google.com/_/FlightsFrontendUi/data/batchexecute?rpcids=tDoGIe&source-path=%2Ftravel%2Fflights&f.sid=${state.f_sid}&bl=${state.bl}&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=${generated.nonce}&rt=c",
       "headers": {
         "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
         "X-Same-Domain": "1",
@@ -41,7 +49,7 @@ const WORKFLOW: Workflow = {
         "Accept-Language": "en-US,en;q=0.9",
         "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]"
       },
-      "body": "f.req=%5B%5B%5B%22tDoGIe%22%2C%22%5Bnull%2C%5B%5B%5C%22${param.query}%5C%22%2C0%5D%5D%5D%22%2Cnull%2C%22generic%22%5D%5D%5D&",
+      "body": "f.req=%5B%5B%5B%22tDoGIe%22%2C%22%5Bnull%2C%5B%5B%5C%22${param.location_id}%5C%22%2C${param.location_type}%5D%5D%5D%22%2Cnull%2C%22generic%22%5D%5D%5D&",
       "effect": "safe"
     }
   ],
@@ -49,14 +57,13 @@ const WORKFLOW: Workflow = {
   "bootstrap": {
     "url": "https://www.google.com/travel/flights",
     "waitUntil": "domcontentloaded",
-    "timeoutMs": 30000,
     "captures": [
       {
         "name": "f_sid",
         "required": true,
         "capability": "browser_bootstrap",
         "source": "html_regex",
-        "pattern": "\"FdrFJe\":\"([^\"]+)\"",
+        "pattern": "\\\"FdrFJe\\\":\\\"([^\\\"]+)\\\"",
         "group": 1
       },
       {
@@ -64,28 +71,31 @@ const WORKFLOW: Workflow = {
         "required": true,
         "capability": "browser_bootstrap",
         "source": "html_regex",
-        "pattern": "\"cfb2h\":\"([^\"]+)\"",
+        "pattern": "\\\"cfb2h\\\":\\\"([^\\\"]+)\\\"",
         "group": 1
       }
     ]
   },
   "parserModule": "./parser.ts",
-  "requestTransformModule": "./request-transform.ts",
+  "requestTransformModule": "../_shared/google_flights_transport.ts",
   "liveVerified": true
 };
 
-export interface LookupAirportInput {
-  /** City or airport search text, e.g. 'san jose' or 'SJC' */
-  query: string;
+export interface GetFlightLocationDetailsInput {
+  /** Airport code such as SJC or Google place id such as /m/0d9jr. */
+  location_id?: string;
+  /** Google Flights location type code: use 0 for airport_code or 5 for google_place_id/city place ids. */
+  location_type?: string;
 }
 
-export async function lookupAirport(
-  input: LookupAirportInput,
+export async function getFlightLocationDetails(
+  input: GetFlightLocationDetailsInput,
   opts: { credentials?: CredentialStore; fetchImpl?: typeof fetch; initialState?: Record<string, unknown> } = {},
 ): Promise<ToolResult> {
   const __dirname = dirname(fileURLToPath(import.meta.url));
   const params: Record<string, string | number | boolean> = {
-    query: input.query,
+    location_id: input.location_id ?? "SJC",
+    location_type: input.location_type ?? "0",
 
   };
   return executeWorkflow({

package/examples/google-flights/get_flight_location_details/parser.ts

@@ -0,0 +1,103 @@
+import { extractWrbRecords, parseNestedPayload } from '../_shared/google_batchexecute_parser.ts';
+import type { FlightLocation } from '../_shared/google_flights_types.ts';
+
+type Output = {
+  locations: FlightLocation[];
+  location?: FlightLocation;
+};
+
+function asArray(value: unknown): unknown[] | undefined {
+  return Array.isArray(value) ? value : undefined;
+}
+
+function asString(value: unknown): string | undefined {
+  return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+
+function asNumber(value: unknown): number | undefined {
+  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+
+function apiTypeToName(type: unknown): string {
+  if (type === 0) return 'airport_code';
+  if (type === 4) return 'city';
+  if (type === 5) return 'google_place_id';
+  return typeof type === 'number' ? `google_flights_type_${type}` : 'unknown';
+}
+
+function imageUrls(details: unknown[]): string[] {
+  const images = asArray(details[2]) ?? [];
+  const urls: string[] = [];
+  for (const image of images) {
+    const nested = asArray(image);
+    const url = nested ? asString(nested[0]) : asString(image);
+    if (url) urls.push(url);
+  }
+  return urls;
+}
+
+function parseLocation(record: unknown): FlightLocation | undefined {
+  const item = asArray(record);
+  if (!item) return undefined;
+
+  const idPair = asArray(item[0]) ?? [];
+  const id = asString(idPair[0]);
+  const apiType = idPair[1];
+  const displayName = asString(item[1]);
+  const details = asArray(item[2]) ?? [];
+  const coordinatesRaw = asArray(item[3]) ?? [];
+  const lat = asNumber(coordinatesRaw[0]);
+  const lng = asNumber(coordinatesRaw[1]);
+
+  if (!id && !displayName) return undefined;
+
+  const detailId = asString(details[0]);
+  const detailName = asString(details[1]);
+  const airportCode = apiType === 0 ? id : asString(details[5]);
+  const placeId = id?.startsWith('/m/') ? id : detailId?.startsWith('/m/') ? detailId : undefined;
+
+  const location: FlightLocation = {
+    id: id ?? detailId ?? displayName ?? '',
+    type: apiTypeToName(apiType),
+    displayName: displayName ?? detailName ?? id ?? '',
+  };
+
+  if (detailName && detailName !== location.displayName) location.city = detailName;
+  if (asString(item[6])) location.region = asString(item[6]);
+  if (asString(details[3])) location.description = asString(details[3]);
+  if (airportCode) location.airportCode = airportCode;
+  if (placeId) location.placeId = placeId;
+  if (lat !== undefined && lng !== undefined) location.coordinates = { lat, lng };
+
+  const urls = imageUrls(details);
+  if (urls.length > 0) location.imageUrls = urls;
+
+  return location;
+}
+
+function payloadFromRaw(rawResponse: unknown): unknown {
+  if (typeof rawResponse === 'string') {
+    const records = extractWrbRecords(rawResponse).filter((record) => record.rpcid === 'tDoGIe');
+    return parseNestedPayload(records[0]?.payload);
+  }
+  return parseNestedPayload(rawResponse);
+}
+
+export function extract(rawResponse: unknown): Output {
+  const payload = payloadFromRaw(rawResponse);
+  const root = asArray(payload) ?? [];
+  const locationsRaw = asArray(root[1]) ?? [];
+  const locations = locationsRaw
+    .map(parseLocation)
+    .filter((location): location is FlightLocation => Boolean(location && location.id && location.displayName));
+
+  if (locations.length > 1) {
+    const [primary, ...rest] = locations;
+    if (primary) primary.nestedAirports = rest;
+  }
+
+  return {
+    locations,
+    location: locations[0],
+  };
+}

package/examples/google-flights/get_flight_location_details/playbook.yaml

@@ -0,0 +1,59 @@
+toolName: get_flight_location_details
+summary: Resolve a selected Google Flights airport, city, or place into normalized location metadata.
+parameters:
+  - name: location_id
+    type: string
+    description: Airport code such as SJC or place id such as /m/0d9jr.
+  - name: location_type
+    type: string
+    description: Location id type, such as airport_code or google_place_id.
+steps:
+  - action: navigate
+    url: https://www.google.com/travel/flights
+    wait_for: networkidle
+  - action: click
+    locators:
+      - by: role
+        value: textbox
+        name: Where from?
+      - by: aria_label
+        value_pattern: Where from
+      - by: text
+        value_pattern: Where from
+      - by: css
+        value: input[aria-label^="Where from"]
+    wait_for:
+      sleep_ms: 300
+  - action: type
+    locators:
+      - by: role
+        value: textbox
+        name: Where else?
+      - by: aria_label
+        value_pattern: Where else
+      - by: aria_label
+        value_pattern: Where from
+      - by: css
+        value: input[type="text"]
+    value: ${location_id}
+    wait_for:
+      xhr: rpcids=H028ib
+  - action: click
+    locators:
+      - by: role
+        value: option
+        name: ${location_id}
+      - by: aria_label
+        value_pattern: ${location_id}
+      - by: text
+        value_pattern: ${location_id}
+      - by: css
+        value: ul.DFGgtd li
+    wait_for:
+      xhr: rpcids=tDoGIe
+result:
+  source: xhr
+  url_pattern: rpcids=tDoGIe
+  extract: "0.2"
+  return_as: location_details
+notes: The selected-location response is a Google batchexecute payload; downstream parsing should strip the JSON prefix, find the wrb.fr record for tDoGIe, then parse its inner JSON string for coordinates, image URLs, display names, descriptions, canonical IDs, and country metadata.

package/examples/google-flights/{lookup_airport → get_flight_location_details}/workflow.json

@@ -1,27 +1,34 @@
 {
-  "toolName": "lookup_airport",
+  "toolName": "get_flight_location_details",
   "intent": {
-    "description": "Resolve a city or airport query into airport codes and structured airport details.",
-    "userSaid": "multi city from SJC to SAN to LAX to SFO"
+    "description": "Resolve a selected airport, city, or place into detailed Google Flights location metadata.",
+    "userSaid": "searched for a multi city flight; multi city from SJC to SAN to LAX to SFO"
   },
   "site": "google-flights",
   "parameters": [
     {
-      "name": "query",
+      "name": "location_id",
       "type": "string",
-      "description": "City or airport search text, e.g. 'san jose' or 'SJC'",
+      "description": "Airport code such as SJC or Google place id such as /m/0d9jr.",
+      "default": "SJC",
+      "verified": true
+    },
+    {
+      "name": "location_type",
+      "type": "string",
+      "description": "Google Flights location type code: use 0 for airport_code or 5 for google_place_id/city place ids.",
+      "default": "0",
       "verified": true
     }
   ],
   "bootstrap": {
     "url": "https://www.google.com/travel/flights",
     "waitUntil": "domcontentloaded",
-    "timeoutMs": 30000,
     "captures": [
       {
         "source": "html_regex",
         "name": "f_sid",
-        "pattern": "\"FdrFJe\":\"([^\"]+)\"",
+        "pattern": "\\\"FdrFJe\\\":\\\"([^\\\"]+)\\\"",
         "group": 1,
         "required": true,
         "capability": "browser_bootstrap"
@@ -29,17 +36,19 @@
       {
         "source": "html_regex",
         "name": "bl",
-        "pattern": "\"cfb2h\":\"([^\"]+)\"",
+        "pattern": "\\\"cfb2h\\\":\\\"([^\\\"]+)\\\"",
         "group": 1,
         "required": true,
         "capability": "browser_bootstrap"
       }
     ]
   },
+  "requestTransformModule": "../_shared/google_flights_transport.ts",
+  "parserModule": "./parser.ts",
   "requests": [
     {
       "method": "POST",
-      "url": "https://www.google.com/_/FlightsFrontendUi/data/batchexecute?rpcids=tDoGIe&source-path=%2Ftravel%2Fflights&f.sid=${state.f_sid}&bl=${state.bl}&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=608023&rt=c",
+      "url": "https://www.google.com/_/FlightsFrontendUi/data/batchexecute?rpcids=tDoGIe&source-path=%2Ftravel%2Fflights&f.sid=${state.f_sid}&bl=${state.bl}&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=${generated.nonce}&rt=c",
       "headers": {
         "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
         "X-Same-Domain": "1",
@@ -47,11 +56,9 @@
         "Accept-Language": "en-US,en;q=0.9",
         "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]"
       },
-      "body": "f.req=%5B%5B%5B%22tDoGIe%22%2C%22%5Bnull%2C%5B%5B%5C%22${param.query}%5C%22%2C0%5D%5D%5D%22%2Cnull%2C%22generic%22%5D%5D%5D&",
+      "body": "f.req=%5B%5B%5B%22tDoGIe%22%2C%22%5Bnull%2C%5B%5B%5C%22${param.location_id}%5C%22%2C${param.location_type}%5D%5D%5D%22%2Cnull%2C%22generic%22%5D%5D%5D&",
       "effect": "safe"
     }
   ],
-  "parserModule": "./parser.ts",
-  "requestTransformModule": "./request-transform.ts",
   "liveVerified": true
 }

package/examples/google-flights/lookup_flight_locations/backends.json

@@ -0,0 +1,27 @@
+{
+  "probedAt": "2026-07-01T01:16:34.053Z",
+  "imprintVersion": "0.5.0",
+  "schemaVersion": 2,
+  "workflowHash": "0540c5b796bac7278bf655a5f0dc27c2508e08483eed2cd9453be4356b8b69cf",
+  "capabilityHash": "5fc16811cd65aff7afee349ddca05c806a65c9c2c96948192ea1bafba9284c38",
+  "preferredOrder": [
+    "cdp-replay"
+  ],
+  "results": {
+    "fetch": {
+      "outcome": "failed",
+      "durationMs": 18,
+      "error": "STATE_MISSING",
+      "detail": "STATE_MISSING: Workflow placeholder ${state.bl} but state \"bl\" has not been captured yet"
+    },
+    "fetch-bootstrap": {
+      "outcome": "forbidden",
+      "durationMs": 30187,
+      "detail": "FORBIDDEN: fetch-bootstrap: cdp-minted jar did not validate; cdp-replay (in-page) required."
+    },
+    "cdp-replay": {
+      "outcome": "ok",
+      "durationMs": 470
+    }
+  }
+}

package/examples/google-flights/lookup_flight_locations/index.ts

@@ -0,0 +1,111 @@
+/**
+ * GENERATED by `imprint emit` — DO NOT EDIT BY HAND.
+ *
+ * Tool: lookup_flight_locations
+ * Site: google-flights
+ * Intent: Search Google Flights location autocomplete for airports, cities, and travel places by text query.
+ *
+ * To regenerate: imprint emit ~/.imprint/google-flights/lookup_flight_locations/workflow.json --force
+ */
+
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import {
+  executeWorkflow,
+  type CredentialStore,
+} from 'imprint/runtime';
+import type { ToolResult, Workflow } from 'imprint/types';
+
+const WORKFLOW: Workflow = {
+  "toolName": "lookup_flight_locations",
+  "intent": {
+    "description": "Search Google Flights location autocomplete for airports, cities, and travel places by text query.",
+    "userSaid": "searched for a round trip flight; multi city from SJC to SAN to LAX to SFO; searched for a multi city flight"
+  },
+  "parameters": [
+    {
+      "name": "query",
+      "type": "string",
+      "description": "Partial or full airport, city, or place query typed by the user.",
+      "default": "san di",
+      "verified": true
+    },
+    {
+      "name": "location_types",
+      "type": "string",
+      "description": "Optional type filter. Use default for recorded Google Flights location types, or all to include the expanded region/county type.",
+      "default": "default",
+      "verified": true
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/FlightsFrontendUi/data/batchexecute?rpcids=H028ib&source-path=%2Ftravel%2Fflights&f.sid=${state.f_sid}&bl=${state.bl}&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&rt=c",
+      "headers": {
+        "X-Same-Domain": "1",
+        "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+        "Referer": "https://www.google.com/travel/flights",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]"
+      },
+      "body": "f.req=${param.query}&location_types=${param.location_types}",
+      "effect": "safe"
+    }
+  ],
+  "site": "google-flights",
+  "bootstrap": {
+    "url": "https://www.google.com/travel/flights",
+    "waitUntil": "load",
+    "waitMs": 1000,
+    "captures": [
+      {
+        "name": "f_sid",
+        "required": true,
+        "capability": "browser_bootstrap",
+        "source": "html_regex",
+        "pattern": "(?:\\\\?\"|")FdrFJe(?:\\\\?\"|")\\s*:\\s*(?:\\\\?\"|")(-?[0-9]+)",
+        "group": 1
+      },
+      {
+        "name": "bl",
+        "required": true,
+        "capability": "browser_bootstrap",
+        "source": "html_regex",
+        "pattern": "(?:\\\\?\"|")cfb2h(?:\\\\?\"|")\\s*:\\s*(?:\\\\?\"|")(boq_travel-frontend-flights-ui_[^\\\\\"&]+)",
+        "group": 1
+      }
+    ]
+  },
+  "parserModule": "./parser.ts",
+  "requestTransformModule": "./request-transform.ts",
+  "liveVerified": true
+};
+
+export interface LookupFlightLocationsInput {
+  /** Partial or full airport, city, or place query typed by the user. */
+  query?: string;
+  /** Optional type filter. Use default for recorded Google Flights location types, or all to include the expanded region/county type. */
+  location_types?: string;
+}
+
+export async function lookupFlightLocations(
+  input: LookupFlightLocationsInput,
+  opts: { credentials?: CredentialStore; fetchImpl?: typeof fetch; initialState?: Record<string, unknown> } = {},
+): Promise<ToolResult> {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const params: Record<string, string | number | boolean> = {
+    query: input.query ?? "san di",
+    location_types: input.location_types ?? "default",
+
+  };
+  return executeWorkflow({
+    workflow: WORKFLOW,
+    params,
+    credentials: opts.credentials,
+    fetchImpl: opts.fetchImpl,
+    initialState: opts.initialState,
+    workflowPath: join(__dirname, 'workflow.json'),
+  });
+}
+
+export { WORKFLOW };

package/examples/google-flights/lookup_flight_locations/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "imprint-tool-google-flights",
+  "private": true,
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "latest",
+    "bun-types": "latest"
+  }
+}

package/examples/google-flights/lookup_flight_locations/parser.ts

@@ -0,0 +1,135 @@
+import { extractWrbRecords, parseNestedPayload } from '../_shared/google_batchexecute_parser.ts';
+import type { FlightLocation } from '../_shared/google_flights_types.ts';
+
+type LookupResult = {
+  query?: string;
+  items: FlightLocation[];
+};
+
+function asArray(value: unknown): unknown[] | undefined {
+  return Array.isArray(value) ? value : undefined;
+}
+
+function asString(value: unknown): string | undefined {
+  return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+
+function asNumber(value: unknown): number | undefined {
+  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+
+function typeName(typeCode: unknown): string {
+  switch (typeCode) {
+    case 1:
+      return 'airport';
+    case 3:
+      return 'city';
+    case 4:
+      return 'region';
+    case 5:
+      return 'station';
+    default:
+      return `type_${String(typeCode ?? 'unknown')}`;
+  }
+}
+
+function parseTuple(tuple: unknown, distanceText?: unknown): (FlightLocation & { score?: number; distance?: string }) | null {
+  const values = asArray(tuple);
+  if (!values) return null;
+
+  const type = typeName(values[0]);
+  const displayName = asString(values[1]);
+  const secondaryName = asString(values[2]);
+  const description = asString(values[3]);
+  const placeId = asString(values[4]);
+  const airportCode = asString(values[5]) ?? asString(values[8]);
+  const id = airportCode ?? placeId ?? displayName;
+
+  if (!id || !displayName) return null;
+
+  const location: FlightLocation & { score?: number; distance?: string } = {
+    id,
+    type,
+    displayName,
+  };
+
+  if (type === 'region') {
+    if (secondaryName) location.region = secondaryName;
+  } else if (secondaryName) {
+    location.city = secondaryName;
+  }
+  if (description) location.description = description;
+  if (airportCode) location.airportCode = airportCode;
+  if (placeId) location.placeId = placeId;
+  const score = asNumber(values[12]);
+  if (score !== undefined) location.score = score;
+  const distance = asString(distanceText);
+  if (distance) location.distance = distance;
+
+  return location;
+}
+
+function parseNestedAirports(value: unknown): FlightLocation[] | undefined {
+  const options = asArray(value);
+  if (!options) return undefined;
+
+  const nested = options
+    .map((option) => {
+      const parts = asArray(option);
+      if (!parts) return null;
+      return parseTuple(parts[0], parts[1]);
+    })
+    .filter((item): item is FlightLocation => Boolean(item));
+
+  return nested.length > 0 ? nested : undefined;
+}
+
+function unwrapRows(payload: unknown): unknown[] {
+  let parsed = payload;
+  for (let i = 0; i < 4; i += 1) {
+    parsed = parseNestedPayload(parsed);
+  }
+
+  const top = asArray(parsed);
+  return asArray(top?.[0]) ?? [];
+}
+
+export function extract(
+  rawResponse: unknown,
+  context?: { params: Record<string, string | number | boolean>; responses: unknown[] },
+): LookupResult {
+  const query = typeof context?.params?.query === 'string' ? context.params.query : undefined;
+
+  if (typeof rawResponse !== 'string') {
+    const rows = unwrapRows(rawResponse);
+    return {
+      query,
+      items: rows.map(parseRow).filter((item): item is FlightLocation => Boolean(item)),
+    };
+  }
+
+  const records = extractWrbRecords(rawResponse);
+  const record = records.find((entry) => entry.rpcid === 'H028ib');
+  if (!record) {
+    throw new Error('Google Flights location lookup response did not include H028ib wrb.fr data');
+  }
+
+  const rows = unwrapRows(record.rawPayload ?? record.payload);
+  return {
+    query,
+    items: rows.map(parseRow).filter((item): item is FlightLocation => Boolean(item)),
+  };
+}
+
+function parseRow(row: unknown): FlightLocation | null {
+  const parts = asArray(row);
+  if (!parts) return null;
+
+  const location = parseTuple(parts[0]);
+  if (!location) return null;
+
+  const nestedAirports = parseNestedAirports(parts[1]);
+  if (nestedAirports) location.nestedAirports = nestedAirports;
+
+  return location;
+}