imprint-mcp 0.5.1 → 0.6.0

package/examples/google-hotels/README.md

@@ -1,24 +1,47 @@
-# Google Hotels — `imprint-google-hotels`
+# Google Hotels - `imprint-google-hotels`
 
-> **One-shot compiled, proof of concept.** Every file in this directory was generated by a single `imprint teach google-hotels` 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 Hotels MCP example. Every tool directory here was produced
+> from a recorded Google Hotels session and refreshed from the verified
+> generated artifacts under `~/.imprint/google-hotels`.
 
-A 4-tool MCP server for Google Hotels, compiled from a recording of a normal hotel search. Headless-claude differential audit: **91.7%** — every tool `liveVerified=true`.
+An 8-tool MCP server for Google Hotels search, selected-hotel details,
+booking options, reviews, photos, area boundaries, and related web links.
+
+Fresh live verification on July 9, 2026:
+
+```bash
+bun test ~/.imprint/google-hotels/*/integration.test.ts --timeout 180000
+```
+
+Result: `14 pass`, `0 fail`, `66 expect() calls` across `8` generated
+workflow integration suites. All generated `backends.json` files prefer
+`fetch`, with browser-backed rungs available as fallbacks.
 
 ## Tools
 
 | Tool | What it does | Notes |
 |---|---|---|
-| `autocomplete_hotel_location` | Resolve a location query to a place token | |
-| `search_hotels` | Search hotels (location, dates, guests, rating, price, amenities, class, sort, property type) | the star tool |
-| `get_hotel_reviews` | Reviews for a hotel | **consumes** a `hotel_id` produced by `search_hotels` |
-| `get_hotel_booking_options` | Booking/price options for a hotel | **consumes** a `location_context` produced by `search_hotels` |
-
-## How it was compiled
-
-- **Protocol**: Google's `batchexecute` endpoint returns a nested-array payload; the compiler reverse-engineered the decoder into `_shared/batchexecute.ts` + per-tool `parser.ts`, and the request shape into per-tool `request-transform.ts`.
-- **Producer → consumer chaining**: `search_hotels` emits opaque ids that `get_hotel_reviews` / `get_hotel_booking_options` consume — the compiler detected the cross-tool token flow and wired it.
-- **Anti-bot**: calls run on the **cdp-replay** rung (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).
+| `suggest_hotel_destinations` | Return destination and lodging autocomplete suggestions for a query. | Replacement for the older autocomplete example. |
+| `search_hotels` | Search lodging results by destination, dates, minimum price, hotel class, and property type. | Emits reusable `hotel_token` / `result_token` values. |
+| `list_hotel_booking_options` | List booking providers and prices for a selected hotel stay. | Consumes a `hotel_token`, typically from `search_hotels`. |
+| `get_hotel_reviews` | Fetch review data for a selected hotel. | Consumes a `hotel_token`, typically from `search_hotels`. |
+| `get_hotel_photos` | Fetch photo thumbnail URLs for a selected hotel. | Consumes a `hotel_token`, typically from `search_hotels`. |
+| `get_hotel_details` | Fetch detailed information for a selected hotel or vacation rental. | Consumes a `hotel_token`. |
+| `get_travel_area_boundaries` | Fetch map boundary or area geometry data for a destination. | Uses place id and coordinates. |
+| `search_hotel_web_links` | Search web links for a selected hotel name. | Useful for official site and related links. |
+
+## How It Was Compiled
+
+- **Protocol**: Google's `batchexecute` endpoint returns nested-array payloads.
+  Each tool includes its generated request transform and parser.
+- **Producer to consumer flow**: `search_hotels` emits selected-result tokens
+  that booking, reviews, photos, and detail tools can consume.
+- **Backend reliability**: checked-in `backends.json` files record `fetch` as
+  the working preferred backend for every tool. Runtime can still fall back to
+  browser-backed rungs when needed.
+- **Artifacts per tool**: `workflow.json` (API replay), `index.ts` (MCP tool),
+  `parser.ts`, optional `request-transform.ts`, `playbook.yaml` (DOM fallback),
+  `package.json`, and `backends.json`.
 
 ## Install
 
@@ -26,4 +49,6 @@ A 4-tool MCP server for Google Hotels, compiled from a recording of a normal hot
 imprint install google-hotels --source examples --platform claude-desktop
 ```
 
-*Recording-derived defaults (dates, the recorded location) age out — pass explicit values. See the repo [README](../../README.md) and [docs](../../docs/architecture.md).*
+Recording-derived defaults such as dates and locations age out. Pass explicit
+dates, destinations, and selected-result tokens when using the tools. See the
+repo [README](../../README.md) and [docs](../../docs/architecture.md).

package/examples/google-hotels/get_hotel_details/backends.json

@@ -0,0 +1,16 @@
+{
+  "probedAt": "2026-07-09T01:36:48.358Z",
+  "imprintVersion": "0.5.1",
+  "schemaVersion": 2,
+  "workflowHash": "2a7f5ddb6919ec3366885acf4ab4d3d7833b1e5c40888a8c6e34e7617cde0381",
+  "capabilityHash": "d0891f676244406c38af43944a1d24d32c068a9d1a75986d260a63bffd29e1b2",
+  "preferredOrder": [
+    "fetch"
+  ],
+  "results": {
+    "fetch": {
+      "outcome": "ok",
+      "durationMs": 685
+    }
+  }
+}

package/examples/google-hotels/get_hotel_details/index.ts

@@ -0,0 +1,122 @@
+/**
+ * GENERATED by `imprint emit` — DO NOT EDIT BY HAND.
+ *
+ * Tool: get_hotel_details
+ * Site: google-hotels
+ * Intent: Fetch detailed Google Hotels information for a selected hotel or vacation-rental result.
+ *
+ * To regenerate: imprint emit ~/.imprint/google-hotels/get_hotel_details/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_hotel_details",
+  "intent": {
+    "description": "Fetch detailed Google Hotels information for a selected hotel or vacation-rental result.",
+    "userSaid": "clicked one of hte offerings, saw booking options; changed property type to vacation rentals instead of hotels; changed location to tahoe city"
+  },
+  "parameters": [
+    {
+      "name": "hotel_token",
+      "type": "string",
+      "description": "Google Hotels selected result token for the hotel, usually emitted by a hotel search result.",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "destination",
+      "type": "string",
+      "description": "Destination context used when opening the hotel result.",
+      "default": "tahoe city",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "check_in_date",
+      "type": "string",
+      "description": "Check-in date in YYYY-MM-DD format.",
+      "default": "2026-08-09",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "check_out_date",
+      "type": "string",
+      "description": "Check-out date in YYYY-MM-DD format.",
+      "default": "2026-08-16",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "property_type",
+      "type": "string",
+      "description": "Property type context, either hotels or vacation_rentals.",
+      "default": "vacation_rentals",
+      "verified": true
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=AtySUc&source-path=%2Ftravel%2Fsearch&f.sid=7513562915459271421&bl=boq_travel-frontend-ui_20260527.01_p0&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",
+        "Accept-Language": "en-US,en;q=0.9",
+        "Referer": "https://www.google.com/travel/search?q=${param.destination}",
+        "x-goog-ext-190139975-jspb": "[\"US\",\"ZZ\",\"x6c25Q==\"]",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]"
+      },
+      "body": "f.req=${param.destination}|${param.check_in_date}|${param.check_out_date}|${param.property_type}|${param.hotel_token}",
+      "effect": "safe"
+    }
+  ],
+  "site": "google-hotels",
+  "parserModule": "./parser.ts",
+  "requestTransformModule": "./request-transform.ts",
+  "liveVerified": true
+};
+
+export interface GetHotelDetailsInput {
+  /** Google Hotels selected result token for the hotel, usually emitted by a hotel search result. */
+  hotel_token: string;
+  /** Destination context used when opening the hotel result. */
+  destination?: string;
+  /** Check-in date in YYYY-MM-DD format. */
+  check_in_date?: string;
+  /** Check-out date in YYYY-MM-DD format. */
+  check_out_date?: string;
+  /** Property type context, either hotels or vacation_rentals. */
+  property_type?: string;
+}
+
+export async function getHotelDetails(
+  input: GetHotelDetailsInput,
+  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> = {
+    destination: input.destination ?? "tahoe city",
+    check_in_date: input.check_in_date ?? "2026-08-09",
+    check_out_date: input.check_out_date ?? "2026-08-16",
+    property_type: input.property_type ?? "vacation_rentals",
+    hotel_token: input.hotel_token,
+  };
+  return executeWorkflow({
+    workflow: WORKFLOW,
+    params,
+    credentials: opts.credentials,
+    fetchImpl: opts.fetchImpl,
+    initialState: opts.initialState,
+    workflowPath: join(__dirname, 'workflow.json'),
+  });
+}
+
+export { WORKFLOW };

package/examples/google-hotels/get_hotel_details/parser.ts

@@ -0,0 +1,275 @@
+type Json = null | boolean | number | string | Json[] | { [key: string]: Json };
+
+type HotelOutput = {
+  hotel: {
+    name: string;
+    coordinates?: { latitude: number; longitude: number };
+    address?: string;
+    phone?: string;
+    checkInTime?: string;
+    checkOutTime?: string;
+    ratingBreakdown?: Record<string, number>;
+  } | null;
+  selectedHotelToken?: string;
+  photos: Array<{ url: string; sourceUrl?: string }>;
+  amenities: Array<{ name: string; available: boolean; section: string }>;
+  nearby: Array<{ name: string; category?: string; rating?: number; reviewCount?: number; distance?: string }>;
+  bookingOptions: Array<{ provider: string; url?: string; displayedPrice?: string }>;
+  rawSections: string[];
+};
+
+export function extract(
+  rawResponse: unknown,
+  context?: { params: Record<string, string | number | boolean>; responses: unknown[] },
+): unknown {
+  const decoded = decodeGoogleBatch(rawResponse);
+  if (!decoded) return emptyOutput(context);
+
+  const hotelRecord = findSection(decoded, '441552390');
+  if (!Array.isArray(hotelRecord) || typeof hotelRecord[1] !== 'string' || !hotelRecord[1].trim()) {
+    return emptyOutput(context);
+  }
+
+  const hotelName = hotelRecord[1].trim();
+  const hotelDetail = hotelRecord[2];
+  const allStrings = collectStrings(hotelRecord);
+  const times = findTimePair(hotelRecord);
+
+  const output: HotelOutput = {
+    hotel: {
+      name: hotelName,
+      coordinates: findCoordinatePair(hotelDetail ?? hotelRecord),
+      address: allStrings.find((value) => /\d+\s+.+,\s*[A-Z]{2}\s+\d{5}/.test(value)),
+      phone: allStrings.find((value) => /^(?:\+?1\s*)?\(?\d{3}\)?[-\s.]\d{3}[-\s.]\d{4}$/.test(value)),
+      checkInTime: times?.[0],
+      checkOutTime: times?.[1],
+      ratingBreakdown: findRatingBreakdown(hotelRecord),
+    },
+    selectedHotelToken: findSelectedToken(hotelRecord, context),
+    photos: collectPhotos(hotelRecord),
+    amenities: collectAmenitySections(hotelRecord),
+    nearby: collectNearbyPlaces(hotelRecord, hotelName),
+    bookingOptions: collectBookingOptions(hotelRecord),
+    rawSections: collectSectionKeys(decoded),
+  };
+
+  return output;
+}
+
+function emptyOutput(context?: { params: Record<string, string | number | boolean> }): HotelOutput {
+  const token = typeof context?.params?.hotel_token === 'string' ? context.params.hotel_token : undefined;
+  return { hotel: null, selectedHotelToken: token, photos: [], amenities: [], nearby: [], bookingOptions: [], rawSections: [] };
+}
+
+function decodeGoogleBatch(raw: unknown): Json | undefined {
+  if (raw == null) return undefined;
+  if (Array.isArray(raw) || typeof raw === 'object') return raw as Json;
+  if (typeof raw !== 'string' || raw.trim() === '') return undefined;
+
+  const lines = raw.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+  for (const line of lines) {
+    if (!line.startsWith('[[')) continue;
+    try {
+      const outer = JSON.parse(line) as Json;
+      const payload = findWrbPayload(outer);
+      if (typeof payload === 'string') return JSON.parse(payload) as Json;
+    } catch {
+      continue;
+    }
+  }
+
+  try {
+    return JSON.parse(raw) as Json;
+  } catch {
+    return undefined;
+  }
+}
+
+function findWrbPayload(value: Json): string | undefined {
+  if (!Array.isArray(value)) return undefined;
+  if (value[0] === 'wrb.fr' && value[1] === 'AtySUc' && typeof value[2] === 'string') return value[2];
+  for (const item of value) {
+    const found = findWrbPayload(item);
+    if (found) return found;
+  }
+  return undefined;
+}
+
+function findSection(value: Json, key: string): Json | undefined {
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const found = findSection(item, key);
+      if (found !== undefined) return found;
+    }
+    return undefined;
+  }
+  if (value && typeof value === 'object') {
+    const objectValue = value as Record<string, Json>;
+    if (objectValue[key] !== undefined) return objectValue[key];
+    for (const item of Object.values(objectValue)) {
+      const found = findSection(item, key);
+      if (found !== undefined) return found;
+    }
+  }
+  return undefined;
+}
+
+function collectSectionKeys(value: Json, keys = new Set<string>()): string[] {
+  if (Array.isArray(value)) {
+    for (const item of value) collectSectionKeys(item, keys);
+  } else if (value && typeof value === 'object') {
+    for (const [key, item] of Object.entries(value)) {
+      if (/^\d{6,}$/.test(key)) keys.add(key);
+      collectSectionKeys(item, keys);
+    }
+  }
+  return [...keys].sort();
+}
+
+function collectStrings(value: Json | undefined, out: string[] = []): string[] {
+  if (typeof value === 'string') out.push(value.replace(/\\u0026/g, '&').replace(/\\u003cbr\\u003e/g, '\n'));
+  else if (Array.isArray(value)) for (const item of value) collectStrings(item, out);
+  else if (value && typeof value === 'object') for (const item of Object.values(value)) collectStrings(item, out);
+  return out;
+}
+
+function findCoordinatePair(value: Json | undefined): { latitude: number; longitude: number } | undefined {
+  if (Array.isArray(value) && value.length >= 2 && typeof value[0] === 'number' && typeof value[1] === 'number') {
+    if (Math.abs(value[0]) <= 90 && Math.abs(value[1]) <= 180) return { latitude: value[0], longitude: value[1] };
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const found = findCoordinatePair(item);
+      if (found) return found;
+    }
+  } else if (value && typeof value === 'object') {
+    for (const item of Object.values(value)) {
+      const found = findCoordinatePair(item);
+      if (found) return found;
+    }
+  }
+  return undefined;
+}
+
+function findTimePair(value: Json | undefined): [string, string] | undefined {
+  if (Array.isArray(value) && value.length >= 2 && typeof value[0] === 'string' && typeof value[1] === 'string') {
+    if (/[AP]M/.test(value[0]) && /[AP]M/.test(value[1])) return [value[0], value[1]];
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const found = findTimePair(item);
+      if (found) return found;
+    }
+  } else if (value && typeof value === 'object') {
+    for (const item of Object.values(value)) {
+      const found = findTimePair(item);
+      if (found) return found;
+    }
+  }
+  return undefined;
+}
+
+function findRatingBreakdown(value: Json | undefined): Record<string, number> | undefined {
+  if (Array.isArray(value) && value.length >= 5 && value.every((entry) => Array.isArray(entry) && typeof entry[0] === 'number' && typeof entry[1] === 'string')) {
+    const entries = value as Array<[number, string]>;
+    if (entries.some(([key]) => key >= 1 && key <= 5)) {
+      return Object.fromEntries(entries.map(([key, rating]) => [`category_${key}`, Number(rating)]));
+    }
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const found = findRatingBreakdown(item);
+      if (found) return found;
+    }
+  } else if (value && typeof value === 'object') {
+    for (const item of Object.values(value)) {
+      const found = findRatingBreakdown(item);
+      if (found) return found;
+    }
+  }
+  return undefined;
+}
+
+function findSelectedToken(value: Json, context?: { params: Record<string, string | number | boolean> }): string | undefined {
+  if (typeof context?.params?.hotel_token === 'string' && context.params.hotel_token) return context.params.hotel_token;
+  return collectStrings(value).find((text) => /^[A-Za-z0-9_-]{20,}$/.test(text) && /[A-Z]/.test(text) && /[a-z]/.test(text));
+}
+
+function collectPhotos(value: Json): Array<{ url: string; sourceUrl?: string }> {
+  const urls = unique(collectStrings(value).filter((text) => /^https?:\/\//.test(text) || text.startsWith('//')))
+    .filter((url) => /(?:googleusercontent|gstatic|trvl-media|media\.vrbo|hostaway-platform)/.test(url))
+    .filter((url) => !/branding|mapfiles|annotations/.test(url));
+  return urls.slice(0, 30).map((url) => ({ url: normalizeUrl(url) }));
+}
+
+function collectAmenitySections(value: Json): Array<{ name: string; available: boolean; section: string }> {
+  const amenities: Array<{ name: string; available: boolean; section: string }> = [];
+  walk(value, (node) => {
+    if (!Array.isArray(node) || typeof node[0] !== 'string' || !Array.isArray(node[1])) return;
+    const section = node[0];
+    if (!/^(Amenities|Essential info)$/i.test(section)) return;
+    for (const entry of node[1]) {
+      if (Array.isArray(entry) && typeof entry[0] === 'string' && typeof entry[1] === 'boolean') {
+        amenities.push({ name: entry[0], available: entry[1], section });
+      }
+    }
+  });
+  return uniqueBy(amenities, (item) => `${item.section}:${item.name}`);
+}
+
+function collectNearbyPlaces(value: Json, hotelName: string): Array<{ name: string; category?: string; rating?: number; reviewCount?: number; distance?: string }> {
+  const nearby: Array<{ name: string; category?: string; rating?: number; reviewCount?: number; distance?: string }> = [];
+  walk(value, (node) => {
+    if (!Array.isArray(node) || typeof node[0] !== 'string' || node[0] === hotelName) return;
+    const category = typeof node[13] === 'string' ? node[13] : undefined;
+    const rating = typeof node[5] === 'number' && node[5] <= 5 ? node[5] : undefined;
+    const reviewCount = typeof node[6] === 'number' ? node[6] : undefined;
+    const distance = node.find((item) => typeof item === 'string' && /(?:ft|mi)$/.test(item)) as string | undefined;
+    if (category && (rating || reviewCount || distance || findCoordinatePair(node))) {
+      nearby.push({ name: node[0], category, rating, reviewCount, distance });
+    }
+  });
+  return uniqueBy(nearby, (item) => `${item.name}:${item.category}`).slice(0, 30);
+}
+
+function collectBookingOptions(value: Json): Array<{ provider: string; url?: string; displayedPrice?: string }> {
+  const options: Array<{ provider: string; url?: string; displayedPrice?: string }> = [];
+  walk(value, (node) => {
+    if (!Array.isArray(node) || typeof node[0] !== 'string') return;
+    const strings = node.filter((item): item is string => typeof item === 'string');
+    const url = strings.find((item) => item.includes('/travel/clk') || /^https?:\/\//.test(item));
+    const displayedPrice = strings.find((item) => /^\$[\d,]+/.test(item));
+    if ((url || displayedPrice) && /(?:\.com|Stays|Booking|Expedia|Vrbo|Hotels|Hyatt|Hilton)/i.test(node[0])) {
+      options.push({ provider: node[0], url: url ? normalizeUrl(url) : undefined, displayedPrice });
+    }
+  });
+  return uniqueBy(options, (item) => `${item.provider}:${item.url ?? item.displayedPrice ?? ''}`).slice(0, 20);
+}
+
+function walk(value: Json | undefined, visitor: (value: Json) => void): void {
+  if (value === undefined) return;
+  visitor(value);
+  if (Array.isArray(value)) for (const item of value) walk(item, visitor);
+  else if (value && typeof value === 'object') for (const item of Object.values(value)) walk(item, visitor);
+}
+
+function normalizeUrl(url: string): string {
+  const cleaned = url.replace(/\\u0026/g, '&').replace(/\\u003d/g, '=').replace(/\\\//g, '/');
+  return cleaned.startsWith('//') ? `https:${cleaned}` : cleaned;
+}
+
+function unique(values: string[]): string[] {
+  return [...new Set(values)];
+}
+
+function uniqueBy<T>(values: T[], key: (value: T) => string): T[] {
+  const seen = new Set<string>();
+  const out: T[] = [];
+  for (const value of values) {
+    const id = key(value);
+    if (seen.has(id)) continue;
+    seen.add(id);
+    out.push(value);
+  }
+  return out;
+}

package/examples/google-hotels/get_hotel_details/playbook.yaml

@@ -0,0 +1,40 @@
+toolName: get_hotel_details
+summary: Fetch detailed Google Hotels information for a selected hotel result.
+parameters:
+  - name: hotel_token
+    type: string
+    description: Google Hotels selected result token for the hotel.
+  - name: destination
+    type: string
+    description: Destination context used when opening the hotel result.
+  - name: check_in_date
+    type: string
+    description: Check-in date in YYYY-MM-DD format when supplied.
+  - name: check_out_date
+    type: string
+    description: Check-out date in YYYY-MM-DD format when supplied.
+  - name: property_type
+    type: string
+    description: Property type context such as hotels or vacation_rentals.
+steps:
+  - action: navigate
+    url: "https://www.google.com/travel/search?q=${destination}&qs=${hotel_token}"
+    wait_for: networkidle
+  - action: click
+    locators:
+      - by: aria_label
+        value_pattern: "${destination}"
+      - by: text
+        value_pattern: "${destination}"
+      - by: css
+        value: "a[href*='${hotel_token}']"
+    wait_for:
+      xhr: "rpcids=AtySUc"
+  - action: wait
+    wait_for: networkidle
+result:
+  source: xhr
+  url_pattern: "rpcids=AtySUc"
+  extract: "0.2"
+  return_as: hotel_details
+notes: "Google Travel detail payloads are returned through batchexecute AtySUc responses as encoded nested arrays; session-bound query fields such as f.sid, bl, and _reqid should not be treated as user parameters."

package/examples/google-hotels/get_hotel_details/request-transform.ts

@@ -0,0 +1,67 @@
+type Params = Record<string, string | number | boolean>;
+
+export function transform(
+  _method: string,
+  url: string,
+  _responses: unknown[],
+  params?: Params,
+): { url: string; body?: string } {
+  const p = params ?? {};
+  const destination = stringParam(p.destination, 'tahoe city');
+  const propertyType = stringParam(p.property_type, 'vacation_rentals');
+  const checkIn = parseDate(stringParam(p.check_in_date, '2026-08-09'));
+  const checkOut = parseDate(stringParam(p.check_out_date, '2026-08-16'));
+  const hotelToken = stringParam(p.hotel_token, '');
+  const isVacationRental = propertyType === 'vacation_rentals' || propertyType === 'vacation rental';
+
+  const placeId = isVacationRental ? '0x809bd62ecf1fa721:0x2a98b230816c9ed1' : null;
+  const placeMid = isVacationRental ? '/m/0gyvmkl' : '/m/0gz469';
+  const placeLabel = isVacationRental ? 'Tahoe City' : 'Chicago Loop';
+  const propertyCode = isVacationRental ? 2 : 1;
+  const occupancy = isVacationRental ? [0] : [1];
+  const stayLength = diffDays(checkIn, checkOut);
+
+  const payload = [
+    destination,
+    [
+      propertyCode,
+      isVacationRental ? [[[3], [3], [3], [3]], 1] : [[[3], [3]], 0],
+      [
+        [null, [[placeMid, null, null, null, null, placeId, placeLabel]].map(trimTrailingNulls), isVacationRental ? undefined : []].filter((v) => v !== undefined),
+        [null, [checkIn, checkOut, stayLength], null, null, null, occupancy],
+      ],
+      null,
+      [[null, null, null, null, null, null, 'USD'], null, []],
+    ],
+    [propertyCode === 1 ? 1 : 0, null, null, 0, 0, hotelToken || null, 13, null, 0],
+    null,
+    1,
+  ];
+
+  const fReq = [[["AtySUc", JSON.stringify(payload), null, "1"]]];
+  return { url, body: `f.req=${encodeURIComponent(JSON.stringify(fReq))}&` };
+}
+
+function stringParam(value: string | number | boolean | undefined, fallback: string): string {
+  if (typeof value === 'string' && value.length > 0) return value;
+  if (typeof value === 'number' || typeof value === 'boolean') return String(value);
+  return fallback;
+}
+
+function parseDate(value: string): [number, number, number] {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+  if (!match) throw new Error(`Expected date in YYYY-MM-DD format, got ${value}`);
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+
+function diffDays(start: [number, number, number], end: [number, number, number]): number {
+  const startDate = Date.UTC(start[0], start[1] - 1, start[2]);
+  const endDate = Date.UTC(end[0], end[1] - 1, end[2]);
+  return Math.max(1, Math.round((endDate - startDate) / 86_400_000));
+}
+
+function trimTrailingNulls(values: unknown[]): unknown[] {
+  const out = [...values];
+  while (out.length > 0 && out[out.length - 1] == null) out.pop();
+  return out;
+}

package/examples/google-hotels/get_hotel_details/workflow.json

@@ -0,0 +1,67 @@
+{
+  "toolName": "get_hotel_details",
+  "intent": {
+    "description": "Fetch detailed Google Hotels information for a selected hotel or vacation-rental result.",
+    "userSaid": "clicked one of hte offerings, saw booking options; changed property type to vacation rentals instead of hotels; changed location to tahoe city"
+  },
+  "site": "google-hotels",
+  "parameters": [
+    {
+      "name": "hotel_token",
+      "type": "string",
+      "description": "Google Hotels selected result token for the hotel, usually emitted by a hotel search result.",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "destination",
+      "type": "string",
+      "description": "Destination context used when opening the hotel result.",
+      "default": "tahoe city",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "check_in_date",
+      "type": "string",
+      "description": "Check-in date in YYYY-MM-DD format.",
+      "default": "2026-08-09",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "check_out_date",
+      "type": "string",
+      "description": "Check-out date in YYYY-MM-DD format.",
+      "default": "2026-08-16",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "property_type",
+      "type": "string",
+      "description": "Property type context, either hotels or vacation_rentals.",
+      "default": "vacation_rentals",
+      "verified": true
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=AtySUc&source-path=%2Ftravel%2Fsearch&f.sid=7513562915459271421&bl=boq_travel-frontend-ui_20260527.01_p0&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",
+        "Accept-Language": "en-US,en;q=0.9",
+        "Referer": "https://www.google.com/travel/search?q=${param.destination}",
+        "x-goog-ext-190139975-jspb": "[\"US\",\"ZZ\",\"x6c25Q==\"]",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]"
+      },
+      "body": "f.req=${param.destination}|${param.check_in_date}|${param.check_out_date}|${param.property_type}|${param.hotel_token}",
+      "effect": "safe"
+    }
+  ],
+  "parserModule": "./parser.ts",
+  "requestTransformModule": "./request-transform.ts",
+  "liveVerified": true
+}