imprint-mcp 0.5.1 → 0.6.0

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

@@ -0,0 +1,16 @@
+{
+  "probedAt": "2026-07-09T03:02:19.472Z",
+  "imprintVersion": "0.5.1",
+  "schemaVersion": 2,
+  "workflowHash": "945631843ae5dd9c796ec5408b2d3ca44d3e4a54d353e234a1c37227413d3075",
+  "capabilityHash": "d0891f676244406c38af43944a1d24d32c068a9d1a75986d260a63bffd29e1b2",
+  "preferredOrder": [
+    "fetch"
+  ],
+  "results": {
+    "fetch": {
+      "outcome": "ok",
+      "durationMs": 199
+    }
+  }
+}

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

@@ -0,0 +1,90 @@
+/**
+ * GENERATED by `imprint emit` — DO NOT EDIT BY HAND.
+ *
+ * Tool: get_hotel_photos
+ * Site: google-hotels
+ * Intent: Fetch photo thumbnail URLs for a selected Google Hotels result.
+ *
+ * To regenerate: imprint emit ~/.imprint/google-hotels/get_hotel_photos/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_photos",
+  "intent": {
+    "description": "Fetch photo thumbnail URLs for a selected Google Hotels result.",
+    "userSaid": "clicked one of hte offerings, saw booking options"
+  },
+  "parameters": [
+    {
+      "name": "hotel_token",
+      "type": "string",
+      "description": "Google Hotels selected hotel token.",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "image_size",
+      "type": "number",
+      "description": "Requested square thumbnail size in pixels.",
+      "default": 152,
+      "verified": false,
+      "verifyNote": "annotated"
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=zM1L7d&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=3452256&rt=c",
+      "headers": {
+        "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+        "X-Same-Domain": "1",
+        "x-goog-ext-190139975-jspb": "[\"US\",\"ZZ\",\"x6c25Q==\"]",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
+        "Referer": "https://www.google.com/travel/search?q=chicago%20loop&qs=CAEgACgAMiRDaGNJNzgtbHVvWGRob2FJQVJvS0wyMHZNREoyY0dkbk1SQUI4DUgA&ved=0CAAQ5JsGahcKEwjg5tj6uN-UAxUAAAAAHQAAAAAQWg&ts=CAESCgoCCAMKAggDEAAaOwodEhkKCS9tLzBnejQ2OToMQ2hpY2FnbyBMb29wGgASGhIUCgcI6g8QBxgDEgcI6g8QBxgGGAMyAggBKgkKBToDVVNEGgA&ap=MAA",
+        "Accept-Language": "en-US,en;q=0.9"
+      },
+      "body": "f.req=[[ [\"zM1L7d\",\"[null,null,null,[${param.image_size},${param.image_size}],\\\"${param.hotel_token}\\\"]\",null,\"1\"] ]]",
+      "effect": "safe"
+    }
+  ],
+  "site": "google-hotels",
+  "parserModule": "./parser.ts",
+  "requestTransformModule": "./request-transform.ts",
+  "liveVerified": true
+};
+
+export interface GetHotelPhotosInput {
+  /** Google Hotels selected hotel token. */
+  hotel_token: string;
+  /** Requested square thumbnail size in pixels. */
+  image_size?: number;
+}
+
+export async function getHotelPhotos(
+  input: GetHotelPhotosInput,
+  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> = {
+    image_size: input.image_size ?? 152,
+    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_photos/parser.ts

@@ -0,0 +1,75 @@
+type BatchedFrame = unknown[];
+
+type Photo = {
+  category: number | null;
+  order: number | null;
+  photoId: number | null;
+  urls: string[];
+  requestedWidth: number | null;
+  requestedHeight: number | null;
+};
+
+function parseJsonMaybe(value: unknown): unknown {
+  if (typeof value !== 'string') return value;
+  return JSON.parse(value);
+}
+
+function unwrapBatchedResponse(rawResponse: unknown): unknown {
+  if (Array.isArray(rawResponse)) return rawResponse;
+  if (typeof rawResponse !== 'string') return rawResponse;
+
+  const lines = rawResponse.split('\n').filter((line) => line.trim() && line.trim() !== ")]}'");
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (/^\d+$/.test(trimmed)) continue;
+    try {
+      const parsed = JSON.parse(trimmed) as BatchedFrame[];
+      if (Array.isArray(parsed)) {
+        const frame = parsed.find((entry) => entry?.[0] === 'wrb.fr' && entry?.[1] === 'zM1L7d');
+        if (frame && typeof frame[2] === 'string') return JSON.parse(frame[2]);
+      }
+    } catch {
+      // Batchexecute responses can contain trailing non-target frames; keep scanning.
+    }
+  }
+  return [];
+}
+
+function parseSizeFromUrl(url: string): { width: number | null; height: number | null } {
+  const match = url.match(/[=\-]w(\d+)-h(\d+)/);
+  return {
+    width: match ? Number(match[1]) : null,
+    height: match ? Number(match[2]) : null,
+  };
+}
+
+function isPhotoEntry(value: unknown): value is unknown[] {
+  return Array.isArray(value) && Array.isArray(value[4]) && value[4].some((item) => typeof item === 'string');
+}
+
+export function extract(
+  rawResponse: unknown,
+  context?: { params: Record<string, string | number | boolean>; responses: unknown[] },
+): unknown {
+  const payload = parseJsonMaybe(unwrapBatchedResponse(rawResponse));
+  const entries = Array.isArray(payload) && Array.isArray(payload[0]) ? payload[0] : [];
+  const requestedFallback = Number(context?.params?.image_size ?? 0) || null;
+
+  const photos: Photo[] = entries.filter(isPhotoEntry).map((entry) => {
+    const urls = (entry[4] as unknown[]).filter((url): url is string => typeof url === 'string' && url.length > 0);
+    const size = parseSizeFromUrl(urls[0] ?? '');
+    return {
+      category: typeof entry[0] === 'number' ? entry[0] : null,
+      order: typeof entry[1] === 'number' ? entry[1] : null,
+      photoId: typeof entry[3] === 'number' ? entry[3] : null,
+      urls,
+      requestedWidth: size.width ?? requestedFallback,
+      requestedHeight: size.height ?? requestedFallback,
+    };
+  }).filter((photo) => photo.photoId !== null || photo.urls.length > 0);
+
+  return {
+    photos,
+    count: photos.length,
+  };
+}

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

@@ -0,0 +1,23 @@
+toolName: get_hotel_photos
+summary: Fetch photo thumbnail URLs for a selected Google Hotels property.
+parameters:
+  - name: hotel_token
+    type: string
+    description: Google Hotels selected hotel token.
+  - name: image_size
+    type: number
+    description: Requested thumbnail/image size in pixels when configurable.
+    default: 152
+steps:
+  - action: navigate
+    url: "https://www.google.com/travel/search?qs=${hotel_token}"
+    wait_for: networkidle
+  - action: wait
+    wait_for:
+      xhr: "rpcids=zM1L7d"
+result:
+  source: xhr
+  url_pattern: "rpcids=zM1L7d"
+  extract: "0[].2"
+  return_as: photo_payloads
+notes: "The zM1L7d batchexecute response wraps the actual photo entries as a stringified JSON payload; each entry contains category/order fields, an internal photo id/count, and thumbnail URLs sized by Google's session-bound request state."

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

@@ -0,0 +1,27 @@
+type Params = Record<string, string | number | boolean>;
+
+function asNumber(value: string | number | boolean | undefined, fallback: number): number {
+  const parsed = Number(value ?? fallback);
+  if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
+  return Math.round(parsed);
+}
+
+function asString(value: string | number | boolean | undefined, name: string): string {
+  const text = String(value ?? '').trim();
+  if (!text) throw new Error(`${name} is required`);
+  return text;
+}
+
+export function transform(
+  _method: string,
+  url: string,
+  _responses: unknown[],
+  params?: Params,
+): { url: string; body?: string } {
+  const imageSize = asNumber(params?.image_size, 152);
+  const hotelToken = asString(params?.hotel_token, 'hotel_token');
+  const innerPayload = JSON.stringify([null, null, null, [imageSize, imageSize], hotelToken]);
+  const outerPayload = [[['zM1L7d', innerPayload, null, '1']]];
+  const body = new URLSearchParams({ 'f.req': JSON.stringify(outerPayload) }).toString() + '&';
+  return { url, body };
+}

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

@@ -0,0 +1,44 @@
+{
+  "toolName": "get_hotel_photos",
+  "site": "google-hotels",
+  "intent": {
+    "description": "Fetch photo thumbnail URLs for a selected Google Hotels result.",
+    "userSaid": "clicked one of hte offerings, saw booking options"
+  },
+  "parameters": [
+    {
+      "name": "hotel_token",
+      "type": "string",
+      "description": "Google Hotels selected hotel token.",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "image_size",
+      "type": "number",
+      "description": "Requested square thumbnail size in pixels.",
+      "default": 152,
+      "verified": false,
+      "verifyNote": "annotated"
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=zM1L7d&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=3452256&rt=c",
+      "headers": {
+        "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+        "X-Same-Domain": "1",
+        "x-goog-ext-190139975-jspb": "[\"US\",\"ZZ\",\"x6c25Q==\"]",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
+        "Referer": "https://www.google.com/travel/search?q=chicago%20loop&qs=CAEgACgAMiRDaGNJNzgtbHVvWGRob2FJQVJvS0wyMHZNREoyY0dkbk1SQUI4DUgA&ved=0CAAQ5JsGahcKEwjg5tj6uN-UAxUAAAAAHQAAAAAQWg&ts=CAESCgoCCAMKAggDEAAaOwodEhkKCS9tLzBnejQ2OToMQ2hpY2FnbyBMb29wGgASGhIUCgcI6g8QBxgDEgcI6g8QBxgGGAMyAggBKgkKBToDVVNEGgA&ap=MAA",
+        "Accept-Language": "en-US,en;q=0.9"
+      },
+      "body": "f.req=[[ [\"zM1L7d\",\"[null,null,null,[${param.image_size},${param.image_size}],\\\"${param.hotel_token}\\\"]\",null,\"1\"] ]]",
+      "effect": "safe"
+    }
+  ],
+  "parserModule": "./parser.ts",
+  "requestTransformModule": "./request-transform.ts",
+  "liveVerified": true
+}

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

@@ -0,0 +1,16 @@
+{
+  "probedAt": "2026-07-09T03:01:50.799Z",
+  "imprintVersion": "0.5.1",
+  "schemaVersion": 2,
+  "workflowHash": "316c91bd5b43d53580234a1211581141ab3c7d9942280b04f12bc0ea31d51ce1",
+  "capabilityHash": "d0891f676244406c38af43944a1d24d32c068a9d1a75986d260a63bffd29e1b2",
+  "preferredOrder": [
+    "fetch"
+  ],
+  "results": {
+    "fetch": {
+      "outcome": "ok",
+      "durationMs": 393
+    }
+  }
+}

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

@@ -3,7 +3,7 @@
  *
  * Tool: get_hotel_reviews
  * Site: google-hotels
- * Intent: Fetch aggregated reviews and reviewer snippets for a selected Google Hotels hotel.
+ * Intent: Fetch review data for a selected Google Hotels hotel token.
  *
  * To regenerate: imprint emit ~/.imprint/google-hotels/get_hotel_reviews/workflow.json --force
  */
@@ -19,44 +19,41 @@ import type { ToolResult, Workflow } from 'imprint/types';
 const WORKFLOW: Workflow = {
   "toolName": "get_hotel_reviews",
   "intent": {
-    "description": "Fetch aggregated reviews and reviewer snippets for a selected Google Hotels hotel.",
-    "userSaid": "clicked one of the offerings, saw booking options"
+    "description": "Fetch review data for a selected Google Hotels hotel token.",
+    "userSaid": "clicked one of hte offerings, saw booking options"
   },
   "parameters": [
     {
-      "name": "hotel_id",
+      "name": "hotel_token",
       "type": "string",
-      "description": "Opaque hotel token (e.g. \"ChcI78-luoXdhoaIARoKL20vMDJ2cGdnMRAB\") obtained from the search_hotels tool's hotel_id output.",
-      "verified": true,
-      "sourcedFrom": {
-        "tool": "search_hotels",
-        "field": "hotel_id"
-      }
+      "description": "Google Hotels selected hotel token returned by a hotel search result.",
+      "verified": true
     }
   ],
   "requests": [
     {
       "method": "POST",
-      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=ocp93e&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=3252256&rt=c",
+      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=ocp93e&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",
+        "Accept-Language": "en-US,en;q=0.9",
         "X-Same-Domain": "1",
-        "Origin": "https://www.google.com",
+        "x-goog-ext-190139975-jspb": "[\"US\",\"ZZ\",\"x6c25Q==\"]",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
         "Referer": "https://www.google.com/travel/search"
       },
-      "body": "f.req=%5B%5B%5B%22ocp93e%22%2C%22%5Bnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2C%5C%22${param.hotel_id}%5C%22%2Cnull%2Cnull%2C%5B%5B%5D%5D%5D%22%2Cnull%2C%221%22%5D%5D%5D&",
+      "body": "f.req=%5B%5B%5B%22ocp93e%22%2C%22%5Bnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2Cnull%2C%5C%22${param.hotel_token}%5C%22%2Cnull%2Cnull%2C%5B%5B%5D%5D%5D%22%2Cnull%2C%221%22%5D%5D%5D&",
       "effect": "safe"
     }
   ],
   "site": "google-hotels",
   "parserModule": "./parser.ts",
-  "requestTransformModule": "./request-transform.ts",
   "liveVerified": true
 };
 
 export interface GetHotelReviewsInput {
-  /** Opaque hotel token (e.g. "ChcI78-luoXdhoaIARoKL20vMDJ2cGdnMRAB") obtained from the search_hotels tool's hotel_id output. */
-  hotel_id: string;
+  /** Google Hotels selected hotel token returned by a hotel search result. */
+  hotel_token: string;
 }
 
 export async function getHotelReviews(
@@ -65,7 +62,7 @@ export async function getHotelReviews(
 ): Promise<ToolResult> {
   const __dirname = dirname(fileURLToPath(import.meta.url));
   const params: Record<string, string | number | boolean> = {
-    hotel_id: input.hotel_id,
+    hotel_token: input.hotel_token,
 
   };
   return executeWorkflow({