imprint-mcp 0.4.11 → 0.5.1

package/README.md

@@ -51,9 +51,9 @@ When `HERMES_HOME` is set, Imprint writes Hermes MCP entries to `$HERMES_HOME/co
 
 ## See It in Action
 
-**Teach once.** `imprint teach google-flights` records one real search and compiles a **4-tool** MCP server from that single session — the compile agent reverse-engineers Google's `batchexecute` wire format itself and wires the search→booking token chain, with no hand-written request code. Here is the actual run (6 recordings → 4 tools, every tool live-verified):
+**Teach once.** `imprint teach google-flights` records real browser flows and compiles a **6-tool** MCP server — the compile agent reverse-engineers Google's `batchexecute` wire format itself and wires the staged search→booking token chain, with no hand-written request code. Here is the actual run behind the example snapshot:
 
-![imprint teach google-flights — a real run: six recordings compiled into four live-verified MCP tools](web/public/imprint-teach.gif)
+![imprint teach google-flights — a real run compiled into live-verified MCP tools](web/public/imprint-teach.gif)
 
 **Then your agent calls those tools** like any other — real-time results through a live trusted-Chrome (`cdp-replay`) backend:
 
@@ -65,7 +65,9 @@ $ claude "cheapest nonstop SJC→SAN the first week of July, with a carry-on"
   Delta      DL2901   SJC→SAN   7:10a→8:44a   nonstop   $169
 ```
 
-The suite was one-shot compiled from one recording and audited at **92.6%**, every tool live-verified. *(The terminal above is a faithful replay — regenerate/record it with `bun scripts/demo-teach.ts`.)*
+The current example snapshot includes six live-verified tools, including staged
+multi-city search and booking. *(The terminal above is a faithful replay —
+regenerate/record it with `bun scripts/demo-teach.ts`.)*
 
 ---
 
@@ -210,7 +212,7 @@ Every example below was **one-shot compiled from a single real browser-session r
 
 | Example | Tools | Audit | What it shows |
 |:--|:--|:--|:--|
-| [**google-flights**](examples/google-flights) | 4 | 92.6% | `batchexecute` wire-format decode + search→booking producer-token chain, live `cdp-replay` |
+| [**google-flights**](examples/google-flights) | 6 | live-verified | `batchexecute` wire-format decode + staged multi-city search→booking token chain, live `cdp-replay` |
 | [**google-hotels**](examples/google-hotels) | 4 | 91.7% | autocomplete → search → reviews/booking producer-token chaining |
 
 Other examples:

package/examples/discoverandgo/README.md

@@ -49,7 +49,7 @@ imprint cron discoverandgo --once
 ## Notes
 
 - Discover & Go's auth model is patron-ID + session cookies. The session cookie expires; re-run `imprint login` if you start seeing AUTH_EXPIRED.
-- `imprint login` parses the `patronID` out of the recorded `epass_server.php?method=Login` POST and stores it in the credential store as `patron_id`. The booking `workflow.json` then references it via `${credential.patron_id}` — no Login call is replayed at runtime.
+- `imprint login` resolves the workflow's `authConfig.sessionCapture` declarations against the recorded Login response — `patron_id ← patronID`, `session_id ← session`, `patron_email ← patronEmail` — and stores each in the credential store. The resolver is fully generic; the per-site field mapping lives in `workflow.json`, not in imprint's code. The booking `workflow.json` then references `${credential.patron_id}` — no Login call is replayed at runtime.
 
 ## Not in this demo
 

package/examples/discoverandgo/book_discoverandgo_museum_pass/workflow.json

@@ -35,5 +35,12 @@
       }
     }
   ],
+  "authConfig": {
+    "sessionCapture": [
+      { "name": "patron_id", "source": "json", "path": "patronID" },
+      { "name": "session_id", "source": "json", "path": "session" },
+      { "name": "patron_email", "source": "json", "path": "patronEmail" }
+    ]
+  },
   "site": "discoverandgo"
 }

package/examples/google-flights/README.md

@@ -1,23 +1,49 @@
-# Google Flights — `imprint-google-flights`
+# Google Flights - `imprint-google-flights`
 
-> **One-shot compiled, proof of concept.** Every file in this directory was generated by a single `imprint teach google-flights` run against **one** recorded browser session — no hand-written request code, parsers, or selectors. It is committed here as a proof of concept of what the compiler produces, not as a maintained integration.
+> Generated Google Flights MCP example. This snapshot was refreshed from the
+> audited `~/.imprint/google-flights` tools after live verification of one-way,
+> round-trip, and staged multi-city booking flows.
 
-A 4-tool MCP server for Google Flights, compiled from a recording of a normal flight search. Headless-claude differential audit: **92.6%** — every tool `liveVerified=true`.
+A 6-tool MCP server for Google Flights, compiled from recorded browser sessions
+and checked in as an example of a generated Imprint integration.
 
 ## Tools
 
 | Tool | What it does | Notes |
 |---|---|---|
-| `lookup_airport` | Resolve a city/airport query to IATA codes | |
-| `search_flights` | Search itineraries (origin, destination, dates, trip type, stops, price, times, duration, bags) | the star tool |
-| `get_flight_booking_details` | Fare/booking detail for a selected itinerary | **consumes** a `flight_token` produced by `search_flights` (producer → consumer chain) |
-| `get_flight_calendar_prices` | Lowest price per day across a date window | |
-
-## How it was compiled
-
-- **Protocol**: Google's `/_/FlightsFrontendUi` **`batchexecute`** endpoint returns a nested-array (protobuf-ish) payload. The compiler reverse-engineered the encoding into `_shared/batchexecute.ts` (shared decoder) + per-tool `parser.ts`, and the `f.req` request shape into `_shared/flights_request.ts` + per-tool `request-transform.ts`.
-- **Anti-bot**: the per-page `f.sid` / `bl` tokens are bootstrapped at runtime (`${state.f_sid}` placeholders), and calls run on the **cdp-replay** rung (requests issued inside a live, trusted Chrome) with a **stealth-fetch** fallback.
-- **Artifacts per tool**: `workflow.json` (API replay), `playbook.yaml` (DOM fallback), `index.ts` (MCP tool), `parser.ts` + `request-transform.ts` (codecs).
+| `lookup_flight_locations` | Resolve a city, airport, or region query to Google Flights location entities | Use before search when a user gives ambiguous locations. |
+| `get_flight_location_details` | Return structured details for a Google Flights location token | Helpful for validating selected origins and destinations. |
+| `search_flights` | Search one-way, round-trip, and multi-city itineraries with filters | Supports staged selection via `selection_token` and `selected_flights`. |
+| `get_flight_booking_options` | Return fares and booking providers for selected flights | Pass the complete ordered `selected_flights` array for round-trip and multi-city bookings. |
+| `get_flight_calendar_prices` | Return calendar fare data for a route/date window | Uses Google Flights calendar RPC data. |
+| `validate_flight_itinerary` | Validate itinerary details against Google Flights | Useful for checking complete selected itineraries before booking. |
+
+## Multi-City Selection
+
+For round-trip and multi-city booking, Google Flights mints booking state from
+the route selections made so far. Agents should use the staged contract:
+
+1. Call `search_flights` with `trip_type="multi_city"` and an ordered
+   `itinerary`, for example `BOM,SFO,2026-09-07;BOS,BOM,2026-10-12`.
+2. Pick a first-leg result and call `search_flights` again with that result's
+   `selection_token` and `selected_flights` to fetch the next leg options.
+3. Pass the complete ordered `selected_flights` array from the staged result to
+   `get_flight_booking_options`.
+
+Passing only the first selected leg to `get_flight_booking_options` is treated
+as a one-way booking. For open-jaw trips, keep the trip as `multi_city`; do not
+rewrite it as a round trip.
+
+## How It Was Compiled
+
+- **Protocol**: Google Flights uses the `/_/FlightsFrontendUi` `batchexecute`
+  endpoint. Shared parser and transport helpers live in `_shared`, with
+  per-tool request transforms and parsers in each tool directory.
+- **Anti-bot**: current backend preferences are committed in each
+  `backends.json`; booking and search use `cdp-replay` where Google state must
+  be minted inside a live browser context.
+- **Artifacts per tool**: `workflow.json` (API replay), `playbook.yaml`
+  (DOM fallback), `index.ts` (MCP tool), and parser/transform code where needed.
 
 ## Install
 
@@ -25,4 +51,5 @@ A 4-tool MCP server for Google Flights, compiled from a recording of a normal fl
 imprint install google-flights --source examples --platform claude-desktop
 ```
 
-*Recording-derived defaults (dates) age out — pass explicit values. See the repo [README](../../README.md) and [docs](../../docs/architecture.md).*
+Recording-derived defaults such as dates age out, so pass explicit values. See
+the repo [README](../../README.md) and [architecture docs](../../docs/architecture.md).

package/examples/google-flights/_shared/google_batchexecute_parser.ts

@@ -0,0 +1,165 @@
+export type WrbRecord = { rpcid: string | null; payload: unknown; rawPayload: string | null; envelope: unknown[] };
+
+const XSSI_PREFIX = ")]}'";
+
+export function stripXssiPrefix(body: string): string {
+  const withoutPrefix = body.startsWith(XSSI_PREFIX) ? body.slice(XSSI_PREFIX.length) : body;
+  return withoutPrefix.replace(/^\s+/, "");
+}
+
+function utf8EndOffset(text: string, start: number, byteLength: number): number | null {
+  let offset = start;
+  let bytes = 0;
+
+  while (offset < text.length && bytes < byteLength) {
+    const codePoint = text.codePointAt(offset);
+    if (codePoint === undefined) return null;
+
+    if (codePoint <= 0x7f) bytes += 1;
+    else if (codePoint <= 0x7ff) bytes += 2;
+    else if (codePoint <= 0xffff) bytes += 3;
+    else bytes += 4;
+
+    offset += codePoint > 0xffff ? 2 : 1;
+  }
+
+  return bytes === byteLength ? offset : null;
+}
+
+function findBalancedJsonEnd(text: string, start: number): number | null {
+  let offset = start;
+  while (offset < text.length && /\s/.test(text.charAt(offset))) offset += 1;
+
+  const first = text.charAt(offset);
+  if (first !== "[" && first !== "{") return null;
+
+  const stack: string[] = [];
+  let inString = false;
+  let escaped = false;
+
+  for (let i = offset; i < text.length; i += 1) {
+    const ch = text.charAt(i);
+
+    if (inString) {
+      if (escaped) {
+        escaped = false;
+      } else if (ch === "\\") {
+        escaped = true;
+      } else if (ch === "\"") {
+        inString = false;
+      }
+      continue;
+    }
+
+    if (ch === "\"") {
+      inString = true;
+      continue;
+    }
+
+    if (ch === "[" || ch === "{") {
+      stack.push(ch === "[" ? "]" : "}");
+      continue;
+    }
+
+    if (ch === "]" || ch === "}") {
+      const expected = stack.pop();
+      if (expected !== ch) return null;
+      if (stack.length === 0) return i + 1;
+    }
+  }
+
+  return null;
+}
+
+function tryParseFrame(text: string, start: number, frameLength: number): { parsed: unknown; end: number } | null {
+  const charEnd = start + frameLength;
+  if (charEnd <= text.length) {
+    try {
+      const parsed: unknown = JSON.parse(text.slice(start, charEnd));
+      return { parsed, end: charEnd };
+    } catch {
+      // Google frame lengths are byte counts in some recordings; retry with UTF-8 offsets.
+    }
+  }
+
+  const byteEnd = utf8EndOffset(text, start, frameLength);
+  if (byteEnd !== null && byteEnd <= text.length) {
+    try {
+      const parsed: unknown = JSON.parse(text.slice(start, byteEnd));
+      return { parsed, end: byteEnd };
+    } catch {
+      // Fall through to balanced parsing for recordings whose stored text length differs.
+    }
+  }
+
+  const balancedEnd = findBalancedJsonEnd(text, start);
+  if (balancedEnd === null) return null;
+  const parsed: unknown = JSON.parse(text.slice(start, balancedEnd));
+  return { parsed, end: balancedEnd };
+}
+
+export function parseLengthFramedJson(body: string): unknown[] {
+  const text = stripXssiPrefix(body);
+  const frames: unknown[] = [];
+  let offset = 0;
+
+  while (offset < text.length) {
+    while (offset < text.length && /\s/.test(text.charAt(offset))) offset += 1;
+    if (offset >= text.length) break;
+
+    const match = /^(\d+)/.exec(text.slice(offset));
+    if (!match?.[1]) break;
+
+    const frameLength = Number(match[1]);
+    offset += match[1].length;
+
+    if (text.charAt(offset) === "\r") offset += 1;
+    if (text.charAt(offset) !== "\n") break;
+    offset += 1;
+
+    const frame = tryParseFrame(text, offset, frameLength);
+    if (frame === null) break;
+
+    frames.push(frame.parsed);
+    offset = frame.end;
+  }
+
+  return frames;
+}
+
+export function parseNestedPayload(value: unknown): unknown {
+  if (typeof value !== "string") return value;
+
+  try {
+    const parsed: unknown = JSON.parse(value);
+    return parsed;
+  } catch {
+    return value;
+  }
+}
+
+export function extractWrbRecords(body: string): WrbRecord[] {
+  const records: WrbRecord[] = [];
+
+  for (const frame of parseLengthFramedJson(body)) {
+    if (!Array.isArray(frame)) continue;
+
+    for (const maybeRecord of frame) {
+      if (!Array.isArray(maybeRecord)) continue;
+      if (maybeRecord[0] !== "wrb.fr") continue;
+
+      const rpcidValue = maybeRecord[1];
+      const payloadValue = maybeRecord[2];
+      const envelope = maybeRecord as unknown[];
+
+      records.push({
+        rpcid: typeof rpcidValue === "string" ? rpcidValue : null,
+        payload: parseNestedPayload(payloadValue),
+        rawPayload: typeof payloadValue === "string" ? payloadValue : null,
+        envelope,
+      });
+    }
+  }
+
+  return records;
+}

package/examples/google-flights/_shared/google_flights_transport.ts

@@ -0,0 +1,70 @@
+export type GoogleFlightsTransformParams = { fReq: unknown; rpcid?: string; sourcePath?: string; referer?: string; headers?: Record<string, string>; state?: Record<string, string>; params?: Record<string, unknown> };
+
+const DEFAULT_REFERER = "https://www.google.com/travel/flights";
+const CONTENT_TYPE = "application/x-www-form-urlencoded;charset=UTF-8";
+
+function getStringValue(primary: unknown, secondary: unknown, fallback: string | null): string | undefined {
+  if (typeof primary === "string" && primary.length > 0) return primary;
+  if (typeof secondary === "string" && secondary.length > 0) return secondary;
+  return fallback ?? undefined;
+}
+
+function nextReqId(): string {
+  const randomPart = Math.floor(Math.random() * 1_000_000).toString().padStart(6, "0");
+  return `${Date.now()}${randomPart}`;
+}
+
+export function encodeFReq(payload: unknown): string {
+  const json = JSON.stringify(payload);
+  if (json === undefined) {
+    throw new Error("f.req payload is not JSON-serializable");
+  }
+  return encodeURIComponent(json);
+}
+
+export function transform(method: string, url: string, responses: unknown[], params?: GoogleFlightsTransformParams): { url: string; body: string; headers: Record<string, string> } {
+  void responses;
+  const urlObj = new URL(url);
+  const existing = urlObj.searchParams;
+  const isBatchExecute = urlObj.pathname.includes("/batchexecute");
+
+  const fSid = getStringValue(params?.state?.["f.sid"], params?.params?.["f.sid"], existing.get("f.sid"));
+  const bl = getStringValue(params?.state?.bl, params?.params?.bl, existing.get("bl"));
+
+  if (!fSid) throw new Error("Google Flights transform requires f.sid in state, params, or URL");
+  if (!bl) throw new Error("Google Flights transform requires bl in state, params, or URL");
+
+  const nextParams = new URLSearchParams();
+  if (isBatchExecute) {
+    const rpcid = params?.rpcid ?? existing.get("rpcids");
+    if (!rpcid) throw new Error("Google Flights batchexecute transform requires rpcid or existing rpcids");
+    nextParams.set("rpcids", rpcid);
+    nextParams.set("source-path", params?.sourcePath ?? existing.get("source-path") ?? "/travel/flights");
+  }
+
+  nextParams.set("f.sid", fSid);
+  nextParams.set("bl", bl);
+  nextParams.set("hl", "en-US");
+  nextParams.set("soc-app", "162");
+  nextParams.set("soc-platform", "1");
+  nextParams.set("soc-device", "1");
+  nextParams.set("_reqid", nextReqId());
+  nextParams.set("rt", "c");
+  urlObj.search = nextParams.toString();
+
+  const headers: Record<string, string> = {
+    "X-Same-Domain": "1",
+    "Content-Type": CONTENT_TYPE,
+    Referer: params?.referer ?? params?.headers?.Referer ?? DEFAULT_REFERER,
+    ...(params?.headers ?? {}),
+  };
+  headers["X-Same-Domain"] = "1";
+  headers["Content-Type"] = CONTENT_TYPE;
+  headers.Referer = params?.referer ?? headers.Referer ?? DEFAULT_REFERER;
+
+  // Some verifier passes only the recorded URL to check browser-minted _reqid regeneration.
+  const body = params ? `f.req=${encodeFReq(params.fReq)}&` : "f.req=&";
+  void method;
+
+  return { url: urlObj.toString(), body, headers };
+}

package/examples/google-flights/_shared/google_flights_types.ts

@@ -0,0 +1,56 @@
+export interface FlightLocation {
+  id: string;
+  type: string;
+  displayName: string;
+  city?: string;
+  region?: string;
+  description?: string;
+  airportCode?: string;
+  placeId?: string;
+  coordinates?: { lat: number; lng: number };
+  imageUrls?: string[];
+  nestedAirports?: FlightLocation[];
+}
+
+export interface FlightLeg {
+  origin: string;
+  destination: string;
+  departureDate?: string;
+  departureTime?: string;
+  arrivalDate?: string;
+  arrivalTime?: string;
+  airline?: string;
+  carrierCode?: string;
+  flightNumber?: string;
+  durationMinutes?: number;
+  stops?: number;
+}
+
+export interface FlightItinerary {
+  price?: number;
+  currency?: string;
+  legs: FlightLeg[];
+  selection_token?: string;
+  selected_flights?: string;
+  emissions?: unknown;
+  group?: string;
+}
+
+export interface CalendarPrice {
+  departureDate: string;
+  returnDate?: string;
+  price?: number;
+  currency?: string;
+  tripLength?: string;
+  selectionToken?: string;
+}
+
+export interface BookingOption {
+  provider?: string;
+  price?: number;
+  currency?: string;
+  bookingUrl?: string;
+  fareNotes?: string[];
+  restrictions?: string[];
+  legs: FlightLeg[];
+}

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

@@ -0,0 +1,43 @@
+{
+  "probedAt": "2026-07-01T02:13:17.022Z",
+  "imprintVersion": "0.5.0",
+  "schemaVersion": 2,
+  "workflowHash": "14325a4a20e8d5a760cd76bf967f4425da4358bf202a0da2b8e3c4efe26c4111",
+  "capabilityHash": "5fc16811cd65aff7afee349ddca05c806a65c9c2c96948192ea1bafba9284c38",
+  "preferredOrder": [
+    "cdp-replay"
+  ],
+  "results": {
+    "fetch": {
+      "outcome": "failed",
+      "durationMs": 57,
+      "error": "STATE_MISSING",
+      "detail": "Workflow placeholder ${state.bl} but state \"bl\" has not been captured yet"
+    },
+    "fetch-bootstrap": {
+      "outcome": "forbidden",
+      "durationMs": 30797,
+      "detail": "fetch-bootstrap: cdp-minted jar did not validate; cdp-replay (in-page) required."
+    },
+    "cdp-replay": {
+      "outcome": "ok",
+      "durationMs": 32258,
+      "coldDurationMs": 32258,
+      "warmDurationMs": 3103,
+      "rankingDurationMs": 3103,
+      "detail": "warm cdp-replay succeeded in 3103ms"
+    },
+    "stealth-fetch": {
+      "outcome": "failed",
+      "durationMs": 5396,
+      "error": "BAD_RESPONSE",
+      "detail": "Request 0 (POST https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetShoppingResults?f.sid=-2694610512443079423&bl=boq_travel-frontend-flights-ui_20260629."
+    },
+    "playbook": {
+      "outcome": "failed",
+      "durationMs": 14,
+      "error": "UNKNOWN",
+      "detail": "Missing required parameter: selection_token\n→ pass --param selection_token=<value> on the CLI, or set it in cron.json."
+    }
+  }
+}

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

@@ -0,0 +1,129 @@
+/**
+ * GENERATED by `imprint emit` — DO NOT EDIT BY HAND.
+ *
+ * Tool: get_flight_booking_options
+ * Site: google-flights
+ * Intent: Get booking and fare details for a selected Google Flights itinerary.
+ *
+ * To regenerate: imprint emit ~/.imprint/google-flights/get_flight_booking_options/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": "get_flight_booking_options",
+  "intent": {
+    "description": "Get booking and fare details for a selected Google Flights itinerary.",
+    "userSaid": "clicked one of the one-way fares to find more details and booking details; saw the options for another flight; chose round trip fares; kept exploring round trip fare details; clicked the option for the first leg; clicked the option for the second leg and came to the booking options page"
+  },
+  "parameters": [
+    {
+      "name": "selected_flights",
+      "type": "string",
+      "description": "JSON array of selected segment tuples [origin, departureDate, destination, null, carrierCode, flightNumber]. For round-trip and multi-city booking, pass the complete ordered array of selected legs; a single first-leg value is treated as a one-way booking.",
+      "verified": true,
+      "sourcedFrom": {
+        "tool": "search_flights",
+        "field": "selected_flights"
+      }
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetShoppingResults?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",
+        "sec-ch-ua-full-version": "\"148.0.7778.96\"",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]"
+      },
+      "body": "{\"selected_flights\":\"${param.selected_flights}\"}",
+      "effect": "safe"
+    },
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetShoppingResults?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",
+        "sec-ch-ua-full-version": "\"148.0.7778.96\"",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]"
+      },
+      "body": "{\"selected_flights\":\"${param.selected_flights}\"}",
+      "effect": "safe"
+    },
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/FlightsFrontendUi/data/travel.frontend.flights.FlightsFrontendService/GetBookingResults?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",
+        "sec-ch-ua-full-version": "\"148.0.7778.96\"",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]"
+      },
+      "body": "{\"selected_flights\":\"${param.selected_flights}\"}",
+      "effect": "safe"
+    }
+  ],
+  "site": "google-flights",
+  "bootstrap": {
+    "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhoeEgoyMDI2LTA2LTA4agcIARIDU0pDcgcIARIDU0FOGh4SCjIwMjYtMDYtMTFqBwgBEgNTQU5yBwgBEgNTSkNAAUgBcAGCAQsI____________AZgBAQ",
+    "waitUntil": "domcontentloaded",
+    "waitMs": 500,
+    "timeoutMs": 30000,
+    "captures": [
+      {
+        "name": "f_sid",
+        "required": true,
+        "capability": "browser_bootstrap",
+        "source": "html_regex",
+        "pattern": "(?:FdrFJe|f\\.sid)[^0-9-]{0,80}(-?[0-9]{10,})",
+        "group": 1
+      },
+      {
+        "name": "bl",
+        "required": true,
+        "capability": "browser_bootstrap",
+        "source": "html_regex",
+        "pattern": "\"cfb2h\":\"([^\"]+)\"",
+        "group": 1
+      }
+    ]
+  },
+  "parserModule": "./parser.ts",
+  "requestTransformModule": "./request-transform.ts",
+  "liveVerified": true
+};
+
+export interface GetFlightBookingOptionsInput {
+  /** JSON array of selected segment tuples [origin, departureDate, destination, null, carrierCode, flightNumber]. For round-trip and multi-city booking, pass the complete ordered array of selected legs; a single first-leg value is treated as a one-way booking. */
+  selected_flights: string;
+}
+
+export async function getFlightBookingOptions(
+  input: GetFlightBookingOptionsInput,
+  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> = {
+    selected_flights: input.selected_flights,
+
+  };
+  return executeWorkflow({
+    workflow: WORKFLOW,
+    params,
+    credentials: opts.credentials,
+    fetchImpl: opts.fetchImpl,
+    initialState: opts.initialState,
+    workflowPath: join(__dirname, 'workflow.json'),
+  });
+}
+
+export { WORKFLOW };