imprint-mcp 0.2.1 → 0.3.1

package/examples/google-hotels/_shared/freq.ts

@@ -0,0 +1,158 @@
+// _shared/freq.ts
+// Shared request-builder for the google-hotels batchexecute RPC. Every tool's
+// per-tool transform constructs its own inner payload, then calls these helpers
+// to wrap it in the f.req envelope and assemble the request URL.
+//
+// NOTE: the published export-signature comment claims encodeDate maps month-1
+// (e.g. encodeDate('2026-07-03') => [2026,6,3]). The recording disproves this:
+// every wire date is 1-based (seq 300 sends [2026,7,3] for a Jul 3 stay; seq
+// 2547 sends [2026,6,8] for Jun 8). We follow the recording and emit the ISO
+// month unchanged.
+
+const BASE_URL = 'https://www.google.com/_/TravelFrontendUi/data/batchexecute';
+
+// Default rpcid -> mode (seq 222 mejVKc='generic', seq 229 AtySUc='1',
+// seq 286 M0CRd='generic', seq 497 ocp93e='1').
+const MODE_BY_RPCID: Record<string, '1' | 'generic'> = {
+  mejVKc: 'generic',
+  M0CRd: 'generic',
+  AtySUc: '1',
+  ocp93e: '1',
+};
+
+/**
+ * Wrap a tool-specific inner payload in the batchexecute f.req envelope:
+ * [[[ rpcid, JSON.stringify(innerPayload), null, mode ]]], URL-encoded with a
+ * trailing '&'. Spaces become %20 (encodeURIComponent, not '+') and the inner
+ * JSON's quotes become %5C%22, matching the recorded wire bytes exactly.
+ */
+export function buildFreqBody(
+  rpcid: string,
+  innerPayload: unknown,
+  mode: '1' | 'generic',
+): string {
+  const inner = JSON.stringify(innerPayload);
+  const envelope = [[[rpcid, inner, null, mode]]];
+  return 'f.req=' + encodeURIComponent(JSON.stringify(envelope)) + '&';
+}
+
+/**
+ * Assemble the batchexecute URL. f.sid and bl are session-bound (differ per
+ * capture); _reqid is browser-minted and need not be reproduced exactly, so we
+ * emit a fresh positive integer. Query order matches the recording.
+ */
+export function buildBatchExecuteUrl(
+  rpcid: string,
+  session: { f_sid: string; bl: string },
+): string {
+  const reqid = Math.floor(Math.random() * 9_000_000) + 1_000_000;
+  const params = new URLSearchParams();
+  params.set('rpcids', rpcid);
+  params.set('source-path', '/travel/search');
+  params.set('f.sid', session.f_sid);
+  params.set('bl', session.bl);
+  params.set('hl', 'en-US');
+  params.set('soc-app', '162');
+  params.set('soc-platform', '1');
+  params.set('soc-device', '1');
+  params.set('_reqid', String(reqid));
+  params.set('rt', 'c');
+  return BASE_URL + '?' + params.toString();
+}
+
+/**
+ * Parse a 'YYYY-MM-DD' ISO date into the wire tuple [year, month, day].
+ * Month is 1-based (emitted verbatim), as proven by the recorded payloads.
+ */
+export function encodeDate(isoDate: string): [number, number, number] {
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(isoDate);
+  if (!m) throw new Error(`encodeDate: bad ISO date: ${isoDate}`);
+  // Under noUncheckedIndexedAccess captures are string | undefined; the regex
+  // match guarantees all three groups, so assert them.
+  return [Number(m[1]!), Number(m[2]!), Number(m[3]!)];
+}
+
+type DecodedFreq = { innerPayload: unknown; mode: '1' | 'generic' };
+
+// Inverse of buildFreqBody: recover the inner payload + mode from a recorded
+// f.req body so transform() can re-sign a recorded request faithfully.
+function decodeFreqBody(raw: string): DecodedFreq | null {
+  const at = raw.indexOf('f.req=');
+  if (at === -1) return null;
+  let val = raw.slice(at + 'f.req='.length);
+  const amp = val.indexOf('&');
+  if (amp !== -1) val = val.slice(0, amp);
+  let envelope: unknown;
+  try {
+    envelope = JSON.parse(decodeURIComponent(val));
+  } catch {
+    return null;
+  }
+  if (!Array.isArray(envelope)) return null;
+  const lvl1 = envelope[0];
+  if (!Array.isArray(lvl1)) return null;
+  const row = lvl1[0];
+  if (!Array.isArray(row)) return null;
+  const innerStr = row[1];
+  const rawMode = row[3];
+  if (typeof innerStr !== 'string') return null;
+  let innerPayload: unknown;
+  try {
+    innerPayload = JSON.parse(innerStr);
+  } catch {
+    return null;
+  }
+  const mode: '1' | 'generic' = rawMode === 'generic' ? 'generic' : '1';
+  return { innerPayload, mode };
+}
+
+/**
+ * Thin entry the runtime calls. Parses rpcid/f.sid/bl from the recorded URL,
+ * resolves the inner payload + mode (from params, or by decoding a supplied
+ * recorded body), and returns the re-signed { url, body }. Never throws for a
+ * recorded batchexecute URL.
+ */
+export function transform(
+  method: string,
+  url: string,
+  responses: Record<string, any>,
+  params?: Record<string, any>,
+): { url: string; body: string } {
+  void method;
+  void responses;
+  const u = new URL(url);
+  const rpcid = u.searchParams.get('rpcids') ?? '';
+  const fSid = u.searchParams.get('f.sid') ?? '';
+  const bl = u.searchParams.get('bl') ?? '';
+
+  const builtUrl = buildBatchExecuteUrl(rpcid, { f_sid: fSid, bl });
+
+  let innerPayload: unknown = params ? params.innerPayload : undefined;
+  let mode: '1' | 'generic' | undefined =
+    params && (params.mode === '1' || params.mode === 'generic')
+      ? params.mode
+      : undefined;
+
+  // Recover inner payload / mode from a recorded body when not supplied so a
+  // re-sign of the recorded request reproduces its f.req byte-for-byte.
+  if (innerPayload === undefined && params) {
+    const rawBody =
+      typeof params.requestBody === 'string'
+        ? params.requestBody
+        : typeof params.body === 'string'
+          ? params.body
+          : undefined;
+    if (typeof rawBody === 'string') {
+      const decoded = decodeFreqBody(rawBody);
+      if (decoded) {
+        innerPayload = decoded.innerPayload;
+        if (mode === undefined) mode = decoded.mode;
+      }
+    }
+  }
+
+  if (mode === undefined) mode = MODE_BY_RPCID[rpcid] ?? '1';
+  if (innerPayload === undefined) innerPayload = [];
+
+  return { url: builtUrl, body: buildFreqBody(rpcid, innerPayload, mode) };
+}

package/examples/google-hotels/_shared/package.json

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

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

@@ -0,0 +1,80 @@
+/**
+ * GENERATED by `imprint emit` — DO NOT EDIT BY HAND.
+ *
+ * Tool: autocomplete_hotel_location
+ * Site: google-hotels
+ * Intent: Resolve a free-text place query into Google Hotels location autocomplete suggestions (display names and place identifiers).
+ *
+ * To regenerate: imprint emit ~/.imprint/google-hotels/autocomplete_hotel_location/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": "autocomplete_hotel_location",
+  "intent": {
+    "description": "Resolve a free-text place query into Google Hotels location autocomplete suggestions (display names and place identifiers).",
+    "userSaid": "searched for hotels at chicago loop; changed location to tahoe city; searched for hotels in tahoe; searched for hotels in denver downtown"
+  },
+  "parameters": [
+    {
+      "name": "query",
+      "type": "string",
+      "description": "Partial place/hotel text to autocomplete, e.g. 'chicago loop' or 'tahoe city hotels'.",
+      "verified": true
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=mejVKc&source-path=%2Ftravel%2Fsearch&f.sid=-7129101702754032847&bl=boq_travel-frontend-ui_20260603.00_p0&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=1943921&rt=c",
+      "headers": {
+        "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+        "X-Same-Domain": "1",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
+        "Origin": "https://www.google.com",
+        "Referer": "https://www.google.com/travel/search",
+        "Accept-Language": "en-US,en;q=0.9",
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36"
+      },
+      "body": "f.req=%5B%5B%5B%22mejVKc%22%2C%22%5B%5C%22${param.query}%5C%22%2C%5C%22${param.query}%5C%22%2C1%2C1%2Cnull%2C30%5D%22%2Cnull%2C%22generic%22%5D%5D%5D&",
+      "effect": "safe"
+    }
+  ],
+  "site": "google-hotels",
+  "parserModule": "./parser.ts",
+  "requestTransformModule": "./request-transform.ts",
+  "liveVerified": true
+};
+
+export interface AutocompleteHotelLocationInput {
+  /** Partial place/hotel text to autocomplete, e.g. 'chicago loop' or 'tahoe city hotels'. */
+  query: string;
+}
+
+export async function autocompleteHotelLocation(
+  input: AutocompleteHotelLocationInput,
+  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,
+
+  };
+  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/autocomplete_hotel_location/package.json

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

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

@@ -0,0 +1,71 @@
+// Parser for autocomplete_hotel_location (Google Hotels mejVKc autocomplete).
+// Decodes the batchexecute anti-XSSI envelope via the shared helper, then maps
+// the inner suggestion list into clean named-field objects.
+//
+// Inner JSON shape (seq 222 / seq 2550):
+//   [ [ <entry>, <entry>, ... ], <trailing-meta> ]
+// Each <entry> is positional:
+//   [0]  number  1 = place/hotel suggestion, 0 = map/other suggestion
+//   [1]  string  suggested query text (e.g. "chicago loop hotels")
+//   [5]  array   bolded match segments: [ [text, isBold], ... ]
+//   [7]  array   id container; [7][0] is the place id triple [a,b,c]
+//   [11] string  repeats the suggested query text
+
+import { parseBatchExecute } from '../_shared/batchexecute.ts';
+
+interface Segment {
+  text: string;
+  bold: boolean;
+}
+
+interface Suggestion {
+  query: string;
+  segments: Segment[];
+  id: number[] | null;
+  isPlaceSuggestion: boolean;
+}
+
+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 inner = parseBatchExecute(raw, 'mejVKc');
+  const list: any[] =
+    Array.isArray(inner) && Array.isArray(inner[0]) ? inner[0] : [];
+
+  const suggestions: Suggestion[] = list
+    .filter(
+      (e: any) =>
+        Array.isArray(e) && typeof e[1] === 'string' && e[1].length > 0,
+    )
+    .map((e: any) => {
+      const segments: Segment[] = Array.isArray(e[5])
+        ? e[5]
+            .filter((s: any) => Array.isArray(s))
+            .map((s: any) => ({ text: String(s[0] ?? ''), bold: Boolean(s[1]) }))
+        : [];
+      const id =
+        Array.isArray(e[7]) && Array.isArray(e[7][0])
+          ? (e[7][0] as number[])
+          : null;
+      return {
+        query: e[1] as string,
+        segments,
+        id,
+        isPlaceSuggestion: e[0] === 1,
+      };
+    });
+
+  const queryParam =
+    context?.params && typeof context.params.query !== 'undefined'
+      ? String(context.params.query)
+      : null;
+
+  return { query: queryParam, suggestions };
+}

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

@@ -0,0 +1,36 @@
+toolName: autocomplete_hotel_location
+summary: Resolve a free-text place query into Google Hotels location autocomplete suggestions via the mejVKc endpoint.
+parameters:
+  - name: query
+    type: string
+    description: Partial place/hotel text to autocomplete, e.g. "chicago loop" or "tahoe city"
+steps:
+  - action: navigate
+    url: https://www.google.com/travel/search
+    wait_for: networkidle
+  - action: click
+    locators:
+      - by: aria_label
+        value: Search for places, hotels and more
+      - by: role
+        value: textbox
+        name: Search for places, hotels and more
+      - by: css
+        value: input.II2One.j0Ppje
+    wait_for:
+      sleep_ms: 300
+  - action: type
+    locators:
+      - by: aria_label
+        value: Search for places, hotels and more
+      - by: css
+        value: input.II2One.j0Ppje
+    value: ${query}
+    wait_for:
+      xhr: rpcids=mejVKc
+result:
+  source: xhr
+  url_pattern: rpcids=mejVKc
+  extract: "[0][].1"
+  return_as: suggestions
+notes: "The mejVKc response uses Google's batchexecute anti-XSSI envelope: strip the )]}' prefix and chunk-length lines, locate the [\"wrb.fr\",\"mejVKc\",\"<inner>\"] tuple, then JSON.parse the doubly-encoded inner string. The parsed inner JSON is [ [suggestion, ...], [meta] ]; each suggestion is a positional array whose index 1 is the suggested query string (e.g. \"granlibakken tahoe\"), index 5 holds the bolded match segments, and index 7 holds the internal id triple used to disambiguate the place. The extract path [0][].1 yields the list of suggestion strings; downstream callers needing the id triple should read index 7 of each entry. Autocomplete fires per keystroke during recording (debounced); only the final mejVKc response for the fully-typed query is relevant. No auth required — unauthenticated POST to /_/TravelFrontendUi/data/batchexecute. The DOM dropdown options (li.Q1RWxd span.S5TdWc) are an alternative DOM-source fallback if the XHR shape changes."

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

@@ -0,0 +1,37 @@
+// Per-tool request-transform for autocomplete_hotel_location (rpcid=mejVKc).
+// Imports the shared google-hotels batchexecute helpers (../_shared/freq.ts)
+// and constructs the mejVKc-specific inner payload from the tool's `query`
+// param, then wraps it with the shared envelope/URL builders.
+//
+// Inner payload shape per the recording (seq 2550, newer build 20260603):
+//   ["tahoe city hotels","tahoe city hotels",1,1,null,30]
+// i.e. [query, query(context), 1, 1, null, 30] with mode 'generic'.
+// (Older seq 222 carried a user-geo context string + trailing fields; that geo
+// context is session-specific and not a caller-controlled parameter, so we
+// follow the newer same-session pair and mirror the query into element [1].)
+
+import { buildBatchExecuteUrl, buildFreqBody } from '../_shared/freq.ts';
+
+export function transform(
+  method: string,
+  url: string,
+  responses: Record<string, any>,
+  params?: Record<string, any>,
+): { url: string; body: string } {
+  void method;
+  void responses;
+
+  const query = String(params?.query ?? '');
+
+  // Session params (f.sid / bl) ride along in the workflow URL; buildBatchExecuteUrl
+  // reassembles the URL with a fresh _reqid and the rpcids/source-path/etc params.
+  const u = new URL(url);
+  const fSid = u.searchParams.get('f.sid') ?? '';
+  const bl = u.searchParams.get('bl') ?? '';
+  const builtUrl = buildBatchExecuteUrl('mejVKc', { f_sid: fSid, bl });
+
+  const innerPayload = [query, query, 1, 1, null, 30];
+  const body = buildFreqBody('mejVKc', innerPayload, 'generic');
+
+  return { url: builtUrl, body };
+}

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

@@ -0,0 +1,36 @@
+{
+  "toolName": "autocomplete_hotel_location",
+  "intent": {
+    "description": "Resolve a free-text place query into Google Hotels location autocomplete suggestions (display names and place identifiers).",
+    "userSaid": "searched for hotels at chicago loop; changed location to tahoe city; searched for hotels in tahoe; searched for hotels in denver downtown"
+  },
+  "parameters": [
+    {
+      "name": "query",
+      "type": "string",
+      "description": "Partial place/hotel text to autocomplete, e.g. 'chicago loop' or 'tahoe city hotels'.",
+      "verified": true
+    }
+  ],
+  "site": "google-hotels",
+  "requestTransformModule": "./request-transform.ts",
+  "parserModule": "./parser.ts",
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=mejVKc&source-path=%2Ftravel%2Fsearch&f.sid=-7129101702754032847&bl=boq_travel-frontend-ui_20260603.00_p0&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=1943921&rt=c",
+      "headers": {
+        "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+        "X-Same-Domain": "1",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
+        "Origin": "https://www.google.com",
+        "Referer": "https://www.google.com/travel/search",
+        "Accept-Language": "en-US,en;q=0.9",
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36"
+      },
+      "body": "f.req=%5B%5B%5B%22mejVKc%22%2C%22%5B%5C%22${param.query}%5C%22%2C%5C%22${param.query}%5C%22%2C1%2C1%2Cnull%2C30%5D%22%2Cnull%2C%22generic%22%5D%5D%5D&",
+      "effect": "safe"
+    }
+  ],
+  "liveVerified": true
+}

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

@@ -0,0 +1,143 @@
+/**
+ * GENERATED by `imprint emit` — DO NOT EDIT BY HAND.
+ *
+ * Tool: get_hotel_booking_options
+ * Site: google-hotels
+ * Intent: Get booking options (per-provider nightly and stay-total prices with click-through URLs) for the top hotel in a location/date window.
+ *
+ * To regenerate: imprint emit ~/.imprint/google-hotels/get_hotel_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_hotel_booking_options",
+  "intent": {
+    "description": "Get booking options (per-provider nightly and stay-total prices with click-through URLs) for the top hotel in a location/date window.",
+    "userSaid": "clicked one of the offerings, saw booking options; changed to stay total pricing; looked at more booking options; changed number of adults"
+  },
+  "parameters": [
+    {
+      "name": "location_context",
+      "type": "string",
+      "description": "Opaque area token from search_hotels (shape '<mid>|<displayName>', e.g. '/m/0gz469|Chicago Loop').",
+      "default": "/m/0gz469|Chicago Loop",
+      "verified": true
+    },
+    {
+      "name": "check_in_date",
+      "type": "string",
+      "description": "Check-in date (YYYY-MM-DD)",
+      "default": "2026-07-03",
+      "verified": true
+    },
+    {
+      "name": "check_out_date",
+      "type": "string",
+      "description": "Check-out date (YYYY-MM-DD)",
+      "default": "2026-07-06",
+      "verified": true
+    },
+    {
+      "name": "adults",
+      "type": "number",
+      "description": "Number of adults for pricing",
+      "default": 2,
+      "verified": true
+    },
+    {
+      "name": "children",
+      "type": "number",
+      "description": "Number of children for pricing (0 = none)",
+      "default": 0,
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "price_mode",
+      "type": "string",
+      "description": "nightly | stay_total. Each offer carries both; the flag selects the UI default.",
+      "default": "nightly",
+      "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=2252256&rt=c",
+      "headers": {
+        "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+        "X-Same-Domain": "1",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
+        "x-goog-ext-190139975-jspb": "[\"US\",\"ZZ\",\"x6c25Q==\"]",
+        "Referer": "https://www.google.com/travel/search"
+      },
+      "body": "f.req={\"location_context\":\"${param.location_context}\",\"check_in_date\":\"${param.check_in_date}\",\"check_out_date\":\"${param.check_out_date}\",\"adults\":\"${param.adults}\",\"children\":\"${param.children}\"}",
+      "effect": "safe"
+    },
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=M0CRd&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=2552256&rt=c",
+      "headers": {
+        "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+        "X-Same-Domain": "1",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
+        "x-goog-ext-190139975-jspb": "[\"US\",\"ZZ\",\"x6c25Q==\"]",
+        "Referer": "https://www.google.com/travel/search"
+      },
+      "body": "f.req={\"location_context\":\"${param.location_context}\",\"check_in_date\":\"${param.check_in_date}\",\"check_out_date\":\"${param.check_out_date}\",\"adults\":\"${param.adults}\",\"children\":\"${param.children}\",\"price_mode\":\"${param.price_mode}\"}",
+      "effect": "safe"
+    }
+  ],
+  "site": "google-hotels",
+  "parserModule": "./parser.ts",
+  "requestTransformModule": "./request-transform.ts",
+  "liveVerified": true
+};
+
+export interface GetHotelBookingOptionsInput {
+  /** Opaque area token from search_hotels (shape '<mid>|<displayName>', e.g. '/m/0gz469|Chicago Loop'). */
+  location_context?: string;
+  /** Check-in date (YYYY-MM-DD) */
+  check_in_date?: string;
+  /** Check-out date (YYYY-MM-DD) */
+  check_out_date?: string;
+  /** Number of adults for pricing */
+  adults?: number;
+  /** Number of children for pricing (0 = none) */
+  children?: number;
+  /** nightly | stay_total. Each offer carries both; the flag selects the UI default. */
+  price_mode?: string;
+}
+
+export async function getHotelBookingOptions(
+  input: GetHotelBookingOptionsInput,
+  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> = {
+    location_context: input.location_context ?? "/m/0gz469|Chicago Loop",
+    check_in_date: input.check_in_date ?? "2026-07-03",
+    check_out_date: input.check_out_date ?? "2026-07-06",
+    adults: input.adults ?? 2,
+    children: input.children ?? 0,
+    price_mode: input.price_mode ?? "nightly",
+
+  };
+  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_booking_options/package.json

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