imprint-mcp 0.5.0 → 0.6.0

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

@@ -3,7 +3,7 @@
  *
  * Tool: get_flight_calendar_prices
  * Site: google-flights
- * Intent: Get a calendar grid of lowest round-trip prices by departure date for a route over a date window.
+ * Intent: Get Google Flights calendar fare prices for candidate departure and return dates.
  *
  * To regenerate: imprint emit ~/.imprint/google-flights/get_flight_calendar_prices/workflow.json --force
  */
@@ -19,35 +19,47 @@ import type { ToolResult, Workflow } from 'imprint/types';
 const WORKFLOW: Workflow = {
   "toolName": "get_flight_calendar_prices",
   "intent": {
-    "description": "Get a calendar grid of lowest round-trip prices by departure date for a route over a date window.",
-    "userSaid": "searched for a round trip flight; SJC to SAN"
+    "description": "Get Google Flights calendar fare prices for candidate departure and return dates.",
+    "userSaid": "searched for a round trip flight"
   },
   "parameters": [
     {
       "name": "origin",
       "type": "string",
-      "description": "Origin airport IATA code, e.g. SJC",
+      "description": "Origin airport code, city code, or place identifier.",
+      "default": "SJC",
       "verified": false,
       "verifyNote": "annotated"
     },
     {
       "name": "destination",
       "type": "string",
-      "description": "Destination airport IATA code, e.g. SAN",
+      "description": "Destination airport code, city code, or place identifier.",
+      "default": "SAN",
       "verified": false,
       "verifyNote": "annotated"
     },
     {
       "name": "start_date",
       "type": "string",
-      "description": "Start of departure-date window, YYYY-MM-DD",
+      "description": "Start of date range in YYYY-MM-DD format.",
+      "default": "2026-05-24",
       "verified": false,
       "verifyNote": "annotated"
     },
     {
       "name": "end_date",
       "type": "string",
-      "description": "End of departure-date window, YYYY-MM-DD",
+      "description": "End of date range in YYYY-MM-DD format.",
+      "default": "2026-06-30",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "trip_length",
+      "type": "string",
+      "description": "Desired round-trip stay length encoded as a JSON array, such as [7,7] for exactly seven nights.",
+      "default": "[7,7]",
       "verified": false,
       "verifyNote": "annotated"
     }
@@ -55,55 +67,57 @@ const WORKFLOW: Workflow = {
   "requests": [
     {
       "method": "POST",
-      "url": "https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetCalendarPicker?f.sid=${state.f_sid}&bl=${state.bl}&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=1508023&rt=c",
+      "url": "https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetCalendarPicker?f.sid=${state.f_sid}&bl=${state.bl}&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=${generated.epoch_ms}&rt=c",
       "headers": {
         "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
         "X-Same-Domain": "1",
+        "X-Goog-BatchExecute-Bgr": "[\";Ax24HXnQAAZ9xeyCXcVfQlm-O5f3IMQmAEABEArZ1HslyK_BQ4JUKKyty1YaNnvwE0sZIvxZhduE37esgzJCv9uMqDEE1XWJ18RMdQIqq0x78ZaVDYUSpNlkHwAAADRPAAAAA3UBB2MAQlf4Dur8CYS7BGnPB7Iacw3MphUBUI2W-YWb5e8PhXYs-8TUiv6viHhKnooYK5Zh4Bn8BBnjIZRYQcbsJOpFS3ZhooQDMQVPZtietR5D0nXyywzsouTKdgfr-GRsjHAUlFxRsdTnP5169CGPpxrG1D0RMatGaVAf0M36ShU86Y4maDJeysl1scNfvkas-OzyjVF5YrvzbvXAAyZPIS5j1dr9tEXukNKcD1Jw4z5ZzB2pO1gn7nOlo1fQ4OcQnBjhJesq2h4o-LV5hCp2M3dWaLs83Z2d1yRVJHtrDHsCAFKiwAXAOYLsUZuudogTEucsNMX99na4rWfoLD5ccN159OWWW2TenwRa0lKq5aiFxXsJxD25al6H_w_vMZXswB33fovMNoz0o1kFp9OD1qu-X14ts4n0cFlLUeMztzLeGJREyMt2j58Rwcoyf7Exwu5OIgVPPYfoJGCShTdAtystQqvLld2xkUuHWaj2UxiAqSH63PGKJ4xCvcDSMnV6qbXeqStlJEg3rbpNdAsNEGzw5XSyJ54TYH7q_loLQqRdZttrvL_FnlDDFQLcOyNiwXo-2HnNtbUNvcNUrtRVlbnOkaM6L9LKd5lqd2T2ehRm-Tn9YgaKvRBT38Ja2MhR8Yu2kN2WspglRfBMvrzlyRZeu0hp0QeSQowIV0IJqHOMZbAkJ5nUFo23sPg-vCiV2MsSvTeiRSLIe_R0qOH5u_UzxD1mmg7A7-Af-YRG5lnFxl9GuDLAXdyqMMXnsTwVwicln6bF4dfGAoXS0_8YNOPdX1OfZEfypJaMOodYI-R2hH0G_Gc-HlLb_m2KU605V4aPi31gQPvQIp7SQdLiBajE-pQXsF5Am9CfQEkkHeIQasRtHWsEmWz8Dyr3pLu8gOx2IHzevgNdLrqLLcGLqysWxXRK-f7ftjMYvOADGAwTZ7vC_fg8HcLwiCcliIrt4oIWPBfiKh86mJ6_rFh07j50xwBKCyVft8iX8qqrRpj8mUvdD5TxJkC2OlGdX3_hrtU0y46WIX1HjUtiqILu9dShE3VErqkEOS5uHVQrr4fKXholojoNsLQj5DNREkQ7-ajRqcwN4tF3KCHBIapjB0tygaUqxwcy-bRp0qHCJn6q2iSYMGEOmQkj0jHGavGmlAIDC_ZbbhOSgN_OixbX-VN4yqjwbgnh7GE\",null,null,214,8,null,null,0,\"5\"]",
         "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
-        "Referer": "https://www.google.com/travel/flights",
-        "Accept-Language": "en-US,en;q=0.9"
+        "Referer": "https://www.google.com/travel/flights?tfs=CBwQARoSagcIARIDU0pDcgcIARIDU0FOGhJqBwgBEgNTQU5yBwgBEgNTSkNAAUgBcAGCAQsI____________AZgBAQ&tfu=KgIIAw"
       },
-      "body": "f.req=%5Bnull%2C%22%5Bnull%2C%5Bnull%2Cnull%2C1%2Cnull%2C%5B%5D%2C1%2C%5B1%2C0%2C0%2C0%5D%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2C%5B%5B%5B%5B%5B%5C%22${param.origin}%5C%22%2C0%5D%5D%5D%2C%5B%5B%5B%5C%22${param.destination}%5C%22%2C0%5D%5D%5D%2Cnull%2C0%5D%2C%5B%5B%5B%5B%5C%22${param.destination}%5C%22%2C0%5D%5D%5D%2C%5B%5B%5B%5C%22${param.origin}%5C%22%2C0%5D%5D%5D%2Cnull%2C0%5D%5D%2Cnull%2Cnull%2Cnull%2C1%5D%2C%5B%5C%22${param.start_date}%5C%22%2C%5C%22${param.end_date}%5C%22%5D%2Cnull%2C%5B7%2C7%5D%5D%22%5D&",
+      "body": "f.req=%5Bnull%2C%22%5Bnull%2C%5Bnull%2Cnull%2C1%2Cnull%2C%5B%5D%2C1%2C%5B1%2C0%2C0%2C0%5D%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2C%5B%5B%5B%5B%5B%5C%22${param.origin}%5C%22%2C0%5D%5D%5D%2C%5B%5B%5B%5C%22${param.destination}%5C%22%2C0%5D%5D%5D%2Cnull%2C0%5D%2C%5B%5B%5B%5B%5C%22${param.destination}%5C%22%2C0%5D%5D%5D%2C%5B%5B%5B%5C%22${param.origin}%5C%22%2C0%5D%5D%5D%2Cnull%2C0%5D%5D%2Cnull%2Cnull%2Cnull%2C1%5D%2C%5B%5C%22${param.start_date}%5C%22%2C%5C%22${param.end_date}%5C%22%5D%2Cnull%2C${param.trip_length}%5D%22%5D",
       "effect": "safe"
     }
   ],
   "site": "google-flights",
   "bootstrap": {
-    "url": "https://www.google.com/travel/flights?hl=en-US&curr=USD",
+    "url": "https://www.google.com/travel/flights?tfs=CBwQARoSagcIARIDU0pDcgcIARIDU0FOGhJqBwgBEgNTQU5yBwgBEgNTSkNAAUgBcAGCAQsI____________AZgBAQ&tfu=KgIIAw",
     "waitUntil": "domcontentloaded",
     "captures": [
       {
         "name": "f_sid",
-        "required": false,
+        "required": true,
         "capability": "browser_bootstrap",
         "source": "html_regex",
-        "pattern": "\"FdrFJe\":\"([^\"]+)\"",
+        "pattern": "\\\"FdrFJe\\\":\\\"([^\\\"]+)\\\"",
         "group": 1
       },
       {
         "name": "bl",
-        "required": false,
+        "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 GetFlightCalendarPricesInput {
-  /** Origin airport IATA code, e.g. SJC */
-  origin: string;
-  /** Destination airport IATA code, e.g. SAN */
-  destination: string;
-  /** Start of departure-date window, YYYY-MM-DD */
-  start_date: string;
-  /** End of departure-date window, YYYY-MM-DD */
-  end_date: string;
+  /** Origin airport code, city code, or place identifier. */
+  origin?: string;
+  /** Destination airport code, city code, or place identifier. */
+  destination?: string;
+  /** Start of date range in YYYY-MM-DD format. */
+  start_date?: string;
+  /** End of date range in YYYY-MM-DD format. */
+  end_date?: string;
+  /** Desired round-trip stay length encoded as a JSON array, such as [7,7] for exactly seven nights. */
+  trip_length?: string;
 }
 
 export async function getFlightCalendarPrices(
@@ -112,10 +126,11 @@ export async function getFlightCalendarPrices(
 ): Promise<ToolResult> {
   const __dirname = dirname(fileURLToPath(import.meta.url));
   const params: Record<string, string | number | boolean> = {
-    origin: input.origin,
-    destination: input.destination,
-    start_date: input.start_date,
-    end_date: input.end_date,
+    origin: input.origin ?? "SJC",
+    destination: input.destination ?? "SAN",
+    start_date: input.start_date ?? "2026-05-24",
+    end_date: input.end_date ?? "2026-06-30",
+    trip_length: input.trip_length ?? "[7,7]",
 
   };
   return executeWorkflow({

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

@@ -1,86 +1,93 @@
-// Parse a Google Flights GetCalendarPicker batchexecute response into a
-// date->price calendar for the route. Decoding of the )]}' envelope is delegated
-// to the shared batchexecute helper (imported per the build plan).
-import { decodeBatchExecute } from '../_shared/batchexecute.ts';
+import { extractWrbRecords, parseNestedPayload } from '../_shared/google_batchexecute_parser.ts';
+import type { CalendarPrice } from '../_shared/google_flights_types.ts';
 
-type CalendarEntry = {
-  departureDate: string;
-  returnDate: string | null;
-  lowestPriceUSD: number;
+type CalendarOutput = {
+  items: CalendarPrice[];
+  count: number;
+  currency: string;
 };
 
-const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+function asArray(value: unknown): unknown[] | null {
+  return Array.isArray(value) ? value : null;
+}
 
-// The GetCalendarPicker wrb.fr payload is shaped:
-//   [ <metadata>, [ [depDate, retDate, [[null, price], token], 1], ... ] ]
-// The metadata entry is skipped naturally because we only keep array items whose
-// [0] is an ISO date string. We scan every nested array so we are robust to the
-// list living at payload[1] (the recorded shape) or being flattened.
-function collectEntries(payload: unknown): CalendarEntry[] {
-  const entries = new Map<string, CalendarEntry>();
-  if (!Array.isArray(payload)) return [];
+function parsePayload(rawResponse: unknown): unknown[] | null {
+  if (Array.isArray(rawResponse)) return rawResponse;
 
-  const consider = (item: unknown) => {
-    if (!Array.isArray(item)) return;
-    const dep = item[0];
-    if (typeof dep !== 'string' || !ISO_DATE.test(dep)) return;
-    const ret = typeof item[1] === 'string' && ISO_DATE.test(item[1]) ? (item[1] as string) : null;
-    // price lives at item[2][0][1]
-    const priceContainer = item[2];
-    let price: unknown = null;
-    if (Array.isArray(priceContainer) && Array.isArray(priceContainer[0])) {
-      price = (priceContainer[0] as unknown[])[1];
-    }
-    if (typeof price !== 'number') return; // no fare found for that date -> omit
-    const existing = entries.get(dep);
-    if (!existing || price < existing.lowestPriceUSD) {
-      entries.set(dep, { departureDate: dep, returnDate: ret, lowestPriceUSD: price });
-    }
-  };
+  if (typeof rawResponse !== 'string') return null;
+
+  const records = extractWrbRecords(rawResponse);
+  const record = records.find((entry) => Array.isArray(parseNestedPayload(entry.payload)));
+  if (!record) return null;
 
-  for (const top of payload) {
-    if (Array.isArray(top)) {
-      // top may itself be the list of date entries, or a single entry.
-      consider(top);
-      for (const inner of top) consider(inner);
-    }
-  }
-  return [...entries.values()];
+  const payload = parseNestedPayload(record.payload);
+  return asArray(payload);
+}
+
+function dateDiffDays(start: string, end: string): number | undefined {
+  const startMs = Date.parse(`${start}T00:00:00Z`);
+  const endMs = Date.parse(`${end}T00:00:00Z`);
+  if (!Number.isFinite(startMs) || !Number.isFinite(endMs)) return undefined;
+  return Math.round((endMs - startMs) / 86_400_000);
+}
+
+function readCurrency(token: string | undefined): string {
+  if (!token) return 'USD';
+  return token.includes('VVNE') || token.includes('USD') ? 'USD' : 'USD';
 }
 
 export function extract(
   rawResponse: unknown,
-  context?: { params?: Record<string, string | number | boolean>; responses?: unknown[] },
-): unknown {
-  const raw = typeof rawResponse === 'string' ? rawResponse : JSON.stringify(rawResponse ?? '');
-  const frames = decodeBatchExecute(raw);
+  context?: { params: Record<string, string | number | boolean>; responses: unknown[] },
+): CalendarOutput {
+  const payload = parsePayload(rawResponse);
+  const rows = asArray(payload?.[1]) ?? [];
 
-  let payload: unknown = null;
-  for (const f of frames) {
-    const candidate = collectEntries(f.payload);
-    if (candidate.length > 0) {
-      payload = f.payload;
-      break;
-    }
-  }
-  // If no frame produced entries, still attempt the first frame's payload so an
-  // empty (zero-result) response yields an empty calendar rather than throwing.
-  if (payload == null && frames.length > 0) payload = frames[0]?.payload ?? null;
+  const parsedItems = rows
+    .map((row): CalendarPrice | null => {
+      const entry = asArray(row);
+      if (!entry) return null;
 
-  const entries = collectEntries(payload).sort((a, b) =>
-    a.departureDate < b.departureDate ? -1 : a.departureDate > b.departureDate ? 1 : 0,
-  );
+      const departureDate = typeof entry[0] === 'string' ? entry[0] : '';
+      const returnDate = typeof entry[1] === 'string' ? entry[1] : undefined;
+      const priceBlock = asArray(entry[2]);
+      const priceTuple = asArray(priceBlock?.[0]);
+      const rawPrice = priceTuple?.[1];
+      const price = typeof rawPrice === 'number' ? rawPrice : undefined;
+      const selectionToken = typeof priceBlock?.[1] === 'string' ? priceBlock[1] : undefined;
+
+      if (!departureDate && !returnDate && price === undefined && !selectionToken) return null;
+      if (!departureDate) return null;
 
-  const prices: Record<string, number> = {};
-  for (const e of entries) prices[e.departureDate] = e.lowestPriceUSD;
+      const nights = returnDate ? dateDiffDays(departureDate, returnDate) : undefined;
+      const requestedTripLength = context?.params?.trip_length;
+      const tripLength = nights !== undefined ? `${nights} nights` : requestedTripLength ? String(requestedTripLength) : undefined;
+
+      return {
+        departureDate,
+        returnDate,
+        price,
+        currency: readCurrency(selectionToken),
+        tripLength,
+        selectionToken,
+      };
+    })
+    .filter((item): item is CalendarPrice => item !== null);
+  const items = Array.from(
+    parsedItems
+      .reduce((bestByDeparture, item) => {
+        const current = bestByDeparture.get(item.departureDate);
+        if (!current || (item.price ?? Number.POSITIVE_INFINITY) < (current.price ?? Number.POSITIVE_INFINITY)) {
+          bestByDeparture.set(item.departureDate, item);
+        }
+        return bestByDeparture;
+      }, new Map<string, CalendarPrice>())
+      .values(),
+  );
 
-  const params = context?.params ?? {};
   return {
-    origin: params.origin != null ? String(params.origin).toUpperCase() : null,
-    destination: params.destination != null ? String(params.destination).toUpperCase() : null,
-    currency: 'USD',
-    count: entries.length,
-    prices,
-    calendar: entries,
+    items,
+    count: items.length,
+    currency: items[0]?.currency ?? 'USD',
   };
 }

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

@@ -1,56 +1,89 @@
 toolName: get_flight_calendar_prices
-summary: Open the Google Flights date picker for a route to capture the calendar grid of lowest prices by departure/return date.
+summary: Get Google Flights calendar fare prices for a route after opening the date picker.
 parameters:
   - name: origin
     type: string
-    description: Origin airport code, e.g. SJC
+    description: Origin airport code, city code, or place identifier.
   - name: destination
     type: string
-    description: Destination airport code, e.g. SAN
+    description: Destination airport code, city code, or place identifier.
+  - name: trip_type
+    type: string
+    description: Trip type such as round_trip or one_way.
+    default: round_trip
   - name: start_date
     type: string
-    description: Start of date window YYYY-MM-DD (used to filter the returned calendar range; the picker returns a fixed window starting near today)
+    description: Start of date range in YYYY-MM-DD format.
   - name: end_date
     type: string
-    description: End of date window YYYY-MM-DD (used to filter the returned calendar range)
+    description: End of date range in YYYY-MM-DD format.
+  - name: trip_length
+    type: string
+    description: Optional desired trip length or min/max nights for round-trip calendars.
+    default: "7 nights"
 steps:
   - action: navigate
-    url: https://www.google.com/travel/flights
+    url: "https://www.google.com/travel/flights"
     wait_for: networkidle
   - action: click
     locators:
       - by: role
-        value: combobox
-        name: "Where from?"
+        value: button
+        name: Round trip
+      - by: text
+        value: Round trip
+      - by: css
+        value: "div.TQYpgc.gInvKb div.VfPpkd-aPP78e"
+    wait_for:
+      sleep_ms: 300
+  - action: click
+    locators:
+      - by: role
+        value: option
+        name: Round trip
+      - by: text
+        value: Round trip
+      - by: css
+        value: "ul[aria-label='Select your ticket type.'] li"
+    wait_for: visible
+  - action: click
+    locators:
       - by: aria_label
-        value: "Where from?"
+        value: 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: aria_label
-        value: "Where from?"
+        value: Where else?
       - by: aria_label
-        value: "Where else?"
-    value: ${origin}
+        value_pattern: Where from
+      - by: css
+        value: "input.II2One"
+    value: "${origin}"
     wait_for:
       sleep_ms: 500
   - action: click
     locators:
       - by: aria_label
-        value_pattern: ${origin}
-      - by: role
-        value: option
+        value_pattern: "${origin}"
+      - by: text
+        value_pattern: "${origin}"
       - by: css
-        value: "ul.DFGgtd > li.n4HaVc"
+        value: "ul.DFGgtd li"
     wait_for: visible
   - action: click
     locators:
-      - by: role
-        value: combobox
-        name: "Where to?"
       - by: aria_label
         value: "Where to? "
+      - by: text
+        value_pattern: Where to
+      - by: css
+        value: "input[aria-label^='Where to']"
     wait_for:
       sleep_ms: 300
   - action: type
@@ -58,40 +91,34 @@ steps:
       - by: aria_label
         value: "Where to? "
       - by: aria_label
-        value: "Where else?"
-    value: ${destination}
+        value: Where else?
+      - by: css
+        value: "input.II2One"
+    value: "${destination}"
     wait_for:
       sleep_ms: 500
   - action: click
     locators:
       - by: aria_label
-        value_pattern: ${destination}
-      - by: role
-        value: option
+        value_pattern: "${destination}"
+      - by: text
+        value_pattern: "${destination}"
       - by: css
-        value: "ul.DFGgtd > li.n4HaVc"
+        value: "ul.DFGgtd li"
     wait_for: visible
   - action: click
     locators:
       - by: aria_label
         value: Departure
+      - by: text
+        value_pattern: Departure
       - by: css
-        value: "div.GYgkab.YICvqf > div.NA5Egc.ESCxub > input.TP4Lpb.eoY5cb"
+        value: "input[aria-label='Departure']"
     wait_for:
-      xhr: /GetCalendarPicker
+      xhr: GetCalendarPicker
 result:
   source: xhr
-  url_pattern: /GetCalendarPicker
-  extract: "[1][]"
+  url_pattern: GetCalendarPicker
+  extract: "wrb.fr"
   return_as: calendar_prices
-notes: >-
-  The GetCalendarPicker response is a Google batchexecute payload: strip the )]}' prefix, split on
-  numeric length-prefix lines, and JSON.parse the "wrb.fr" envelope's third element (a JSON-encoded
-  string). Inside that decoded array, index [1] is the list of date entries; each entry is
-  [departureDate (YYYY-MM-DD), returnDate (YYYY-MM-DD), [[null, lowestPriceUSD], opaqueFlightToken], 1].
-  Build a departureDate->lowestPriceUSD map and filter to [start_date, end_date]. The extract path
-  "[1][]" is relative to the decoded wrb.fr payload, not the raw HTTP body. start_date/end_date are
-  client-side filters: the picker returns a fixed forward window (~from today) and is opened simply by
-  clicking the Departure field — no date is typed to drive the request. The request is authorized by a
-  per-page f.sid plus X-Goog-BatchExecute-Bgr header that must be captured fresh from the page bootstrap
-  (navigate step), not parameterized.
+notes: Google Flights returns the calendar response inside a batchexecute/WIZ envelope; downstream parsing must strip the JSON prefix, parse the wrb.fr payload string, and map each fare row as departure date, return date, price amount, encoded selection token, and availability flag. The captured calendar for SJC to SAN returned rows shaped like date, return date, price tuple, and flag, e.g. 2026-06-08 to 2026-06-15 at 242 USD.

package/examples/google-flights/get_flight_calendar_prices/workflow.json

@@ -1,58 +1,70 @@
 {
   "toolName": "get_flight_calendar_prices",
+  "site": "google-flights",
   "intent": {
-    "description": "Get a calendar grid of lowest round-trip prices by departure date for a route over a date window.",
-    "userSaid": "searched for a round trip flight; SJC to SAN"
+    "description": "Get Google Flights calendar fare prices for candidate departure and return dates.",
+    "userSaid": "searched for a round trip flight"
   },
-  "site": "google-flights",
   "parameters": [
     {
       "name": "origin",
       "type": "string",
-      "description": "Origin airport IATA code, e.g. SJC",
+      "description": "Origin airport code, city code, or place identifier.",
+      "default": "SJC",
       "verified": false,
       "verifyNote": "annotated"
     },
     {
       "name": "destination",
       "type": "string",
-      "description": "Destination airport IATA code, e.g. SAN",
+      "description": "Destination airport code, city code, or place identifier.",
+      "default": "SAN",
       "verified": false,
       "verifyNote": "annotated"
     },
     {
       "name": "start_date",
       "type": "string",
-      "description": "Start of departure-date window, YYYY-MM-DD",
+      "description": "Start of date range in YYYY-MM-DD format.",
+      "default": "2026-05-24",
       "verified": false,
       "verifyNote": "annotated"
     },
     {
       "name": "end_date",
       "type": "string",
-      "description": "End of departure-date window, YYYY-MM-DD",
+      "description": "End of date range in YYYY-MM-DD format.",
+      "default": "2026-06-30",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "trip_length",
+      "type": "string",
+      "description": "Desired round-trip stay length encoded as a JSON array, such as [7,7] for exactly seven nights.",
+      "default": "[7,7]",
       "verified": false,
       "verifyNote": "annotated"
     }
   ],
   "bootstrap": {
-    "url": "https://www.google.com/travel/flights?hl=en-US&curr=USD",
+    "url": "https://www.google.com/travel/flights?tfs=CBwQARoSagcIARIDU0pDcgcIARIDU0FOGhJqBwgBEgNTQU5yBwgBEgNTSkNAAUgBcAGCAQsI____________AZgBAQ&tfu=KgIIAw",
     "waitUntil": "domcontentloaded",
     "captures": [
       {
         "source": "html_regex",
         "name": "f_sid",
-        "pattern": "\"FdrFJe\":\"([^\"]+)\"",
+        "pattern": "\\\"FdrFJe\\\":\\\"([^\\\"]+)\\\"",
         "group": 1,
-        "required": false,
+        "required": true,
         "capability": "browser_bootstrap"
       },
       {
         "source": "html_regex",
         "name": "bl",
-        "pattern": "\"cfb2h\":\"([^\"]+)\"",
+        "pattern": "\\\"cfb2h\\\":\\\"([^\\\"]+)\\\"",
         "group": 1,
-        "required": false,
+        "required": true,
         "capability": "browser_bootstrap"
       }
     ]
@@ -60,19 +72,19 @@
   "requests": [
     {
       "method": "POST",
-      "url": "https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetCalendarPicker?f.sid=${state.f_sid}&bl=${state.bl}&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=1508023&rt=c",
+      "url": "https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetCalendarPicker?f.sid=${state.f_sid}&bl=${state.bl}&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=${generated.epoch_ms}&rt=c",
       "headers": {
         "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
         "X-Same-Domain": "1",
+        "X-Goog-BatchExecute-Bgr": "[\";Ax24HXnQAAZ9xeyCXcVfQlm-O5f3IMQmAEABEArZ1HslyK_BQ4JUKKyty1YaNnvwE0sZIvxZhduE37esgzJCv9uMqDEE1XWJ18RMdQIqq0x78ZaVDYUSpNlkHwAAADRPAAAAA3UBB2MAQlf4Dur8CYS7BGnPB7Iacw3MphUBUI2W-YWb5e8PhXYs-8TUiv6viHhKnooYK5Zh4Bn8BBnjIZRYQcbsJOpFS3ZhooQDMQVPZtietR5D0nXyywzsouTKdgfr-GRsjHAUlFxRsdTnP5169CGPpxrG1D0RMatGaVAf0M36ShU86Y4maDJeysl1scNfvkas-OzyjVF5YrvzbvXAAyZPIS5j1dr9tEXukNKcD1Jw4z5ZzB2pO1gn7nOlo1fQ4OcQnBjhJesq2h4o-LV5hCp2M3dWaLs83Z2d1yRVJHtrDHsCAFKiwAXAOYLsUZuudogTEucsNMX99na4rWfoLD5ccN159OWWW2TenwRa0lKq5aiFxXsJxD25al6H_w_vMZXswB33fovMNoz0o1kFp9OD1qu-X14ts4n0cFlLUeMztzLeGJREyMt2j58Rwcoyf7Exwu5OIgVPPYfoJGCShTdAtystQqvLld2xkUuHWaj2UxiAqSH63PGKJ4xCvcDSMnV6qbXeqStlJEg3rbpNdAsNEGzw5XSyJ54TYH7q_loLQqRdZttrvL_FnlDDFQLcOyNiwXo-2HnNtbUNvcNUrtRVlbnOkaM6L9LKd5lqd2T2ehRm-Tn9YgaKvRBT38Ja2MhR8Yu2kN2WspglRfBMvrzlyRZeu0hp0QeSQowIV0IJqHOMZbAkJ5nUFo23sPg-vCiV2MsSvTeiRSLIe_R0qOH5u_UzxD1mmg7A7-Af-YRG5lnFxl9GuDLAXdyqMMXnsTwVwicln6bF4dfGAoXS0_8YNOPdX1OfZEfypJaMOodYI-R2hH0G_Gc-HlLb_m2KU605V4aPi31gQPvQIp7SQdLiBajE-pQXsF5Am9CfQEkkHeIQasRtHWsEmWz8Dyr3pLu8gOx2IHzevgNdLrqLLcGLqysWxXRK-f7ftjMYvOADGAwTZ7vC_fg8HcLwiCcliIrt4oIWPBfiKh86mJ6_rFh07j50xwBKCyVft8iX8qqrRpj8mUvdD5TxJkC2OlGdX3_hrtU0y46WIX1HjUtiqILu9dShE3VErqkEOS5uHVQrr4fKXholojoNsLQj5DNREkQ7-ajRqcwN4tF3KCHBIapjB0tygaUqxwcy-bRp0qHCJn6q2iSYMGEOmQkj0jHGavGmlAIDC_ZbbhOSgN_OixbX-VN4yqjwbgnh7GE\",null,null,214,8,null,null,0,\"5\"]",
         "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
-        "Referer": "https://www.google.com/travel/flights",
-        "Accept-Language": "en-US,en;q=0.9"
+        "Referer": "https://www.google.com/travel/flights?tfs=CBwQARoSagcIARIDU0pDcgcIARIDU0FOGhJqBwgBEgNTQU5yBwgBEgNTSkNAAUgBcAGCAQsI____________AZgBAQ&tfu=KgIIAw"
       },
-      "body": "f.req=%5Bnull%2C%22%5Bnull%2C%5Bnull%2Cnull%2C1%2Cnull%2C%5B%5D%2C1%2C%5B1%2C0%2C0%2C0%5D%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2C%5B%5B%5B%5B%5B%5C%22${param.origin}%5C%22%2C0%5D%5D%5D%2C%5B%5B%5B%5C%22${param.destination}%5C%22%2C0%5D%5D%5D%2Cnull%2C0%5D%2C%5B%5B%5B%5B%5C%22${param.destination}%5C%22%2C0%5D%5D%5D%2C%5B%5B%5B%5C%22${param.origin}%5C%22%2C0%5D%5D%5D%2Cnull%2C0%5D%5D%2Cnull%2Cnull%2Cnull%2C1%5D%2C%5B%5C%22${param.start_date}%5C%22%2C%5C%22${param.end_date}%5C%22%5D%2Cnull%2C%5B7%2C7%5D%5D%22%5D&",
+      "body": "f.req=%5Bnull%2C%22%5Bnull%2C%5Bnull%2Cnull%2C1%2Cnull%2C%5B%5D%2C1%2C%5B1%2C0%2C0%2C0%5D%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2C%5B%5B%5B%5B%5B%5C%22${param.origin}%5C%22%2C0%5D%5D%5D%2C%5B%5B%5B%5C%22${param.destination}%5C%22%2C0%5D%5D%5D%2Cnull%2C0%5D%2C%5B%5B%5B%5B%5C%22${param.destination}%5C%22%2C0%5D%5D%5D%2C%5B%5B%5B%5C%22${param.origin}%5C%22%2C0%5D%5D%5D%2Cnull%2C0%5D%5D%2Cnull%2Cnull%2Cnull%2C1%5D%2C%5B%5C%22${param.start_date}%5C%22%2C%5C%22${param.end_date}%5C%22%5D%2Cnull%2C${param.trip_length}%5D%22%5D",
       "effect": "safe"
     }
   ],
-  "requestTransformModule": "./request-transform.ts",
   "parserModule": "./parser.ts",
+  "requestTransformModule": "../_shared/google_flights_transport.ts",
   "liveVerified": true
 }

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

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