@fortrip/agent-contract 0.0.0-stage → 1.0.0

package/dist/index.js

@@ -0,0 +1,1067 @@
+import {
+  GUEST_NAME_MESSAGE,
+  GUEST_NAME_PATTERN,
+  GUEST_NAME_TITLE,
+  guestNameRe,
+  normalizeGuestName
+} from "./chunk-HR6L3RDB.js";
+
+// src/card-number.ts
+var CARD_NUMBER_MESSAGE = "This looks like a payment card number. Payment happens only on the payment page; if it isn't a card number, rewrite it.";
+var PHONE_MAX_DIGITS = 15;
+function containsCardNumber(text2, minDigits = 13) {
+  const normalized = text2.normalize("NFKC");
+  for (const start of normalized.matchAll(/(?<!\d)\d+/g)) {
+    const run = start[0];
+    const shortest = normalized[start.index - 1] === "+" ? Math.max(minDigits, PHONE_MAX_DIGITS + 1) : minDigits;
+    if (run.length >= shortest && run.length <= 19) {
+      if (startsLikeCard(run) && passesLuhn(run)) return true;
+      continue;
+    }
+    if (run.length !== 4) continue;
+    let digits = run;
+    let at = start.index + 4;
+    for (; ; ) {
+      const next = /^[ -](\d{1,4})(?!\d)/.exec(normalized.slice(at, at + 6));
+      if (!next) break;
+      digits += next[1];
+      at += next[0].length;
+      if (digits.length > 19) break;
+      if (digits.length >= shortest && startsLikeCard(digits) && passesLuhn(digits)) {
+        return true;
+      }
+      if (next[1].length < 4) break;
+    }
+  }
+  return false;
+}
+function startsLikeCard(digits) {
+  if (digits[0] >= "3" && digits[0] <= "6") return true;
+  if (digits.startsWith("81") || digits.startsWith("82")) return true;
+  const prefix = Number(digits.slice(0, 4));
+  return prefix >= 2200 && prefix <= 2204 || prefix >= 2221 && prefix <= 2720;
+}
+function passesLuhn(digits) {
+  let sum = 0;
+  for (let i = 0; i < digits.length; i++) {
+    let digit = Number(digits[digits.length - 1 - i]);
+    if (i % 2 === 1) {
+      digit *= 2;
+      if (digit > 9) digit -= 9;
+    }
+    sum += digit;
+  }
+  return sum % 10 === 0;
+}
+
+// src/commands.ts
+import { z as z3 } from "zod";
+
+// src/inputs.ts
+import { z as z2 } from "zod";
+
+// src/dates.ts
+var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+var DAY_MS = 864e5;
+function isIsoDate(value) {
+  if (!ISO_DATE_RE.test(value)) return false;
+  const date = /* @__PURE__ */ new Date(`${value}T00:00:00Z`);
+  return !Number.isNaN(date.getTime()) && date.toISOString().slice(0, 10) === value;
+}
+function countIsoDateDays(start, end) {
+  return Math.round(
+    (Date.parse(`${end}T00:00:00Z`) - Date.parse(`${start}T00:00:00Z`)) / DAY_MS
+  );
+}
+function addIsoDateDays(date, days) {
+  const value = /* @__PURE__ */ new Date(`${date}T00:00:00Z`);
+  value.setUTCDate(value.getUTCDate() + days);
+  return value.toISOString().slice(0, 10);
+}
+
+// src/fields.ts
+import { z } from "zod";
+function strictInput(shape) {
+  return z.strictObject(shape, {
+    error: (issue) => issue.code === "unrecognized_keys" ? `Unknown argument(s): ${issue.keys.join(", ")}` : "Expected a JSON object"
+  });
+}
+function wholeNumber(name, min, max) {
+  const error = `${name} must be a whole number from ${min} to ${max}`;
+  return z.number({ error }).int({ error }).min(min, { error }).max(max, { error });
+}
+function positiveId(name) {
+  const error = `${name} must be a positive whole number`;
+  return z.number({ error }).int({ error }).positive({ error });
+}
+function isoDate(name) {
+  const error = `${name} must be a real yyyy-MM-dd calendar date`;
+  return z.string({ error }).refine(isIsoDate, { error });
+}
+function nonEmpty(name) {
+  const error = `${name} must be a non-empty string`;
+  return z.string({ error }).min(1, { error });
+}
+function text(name, min, max) {
+  const error = `${name} must be text of ${min} to ${max} characters`;
+  return z.string({ error }).min(min, { error }).max(max, { error });
+}
+function oneOf(name, values) {
+  return z.enum(values, {
+    error: `${name} must be one of: ${values.join(", ")}`
+  });
+}
+function flag(name) {
+  return z.boolean({ error: `${name} must be true or false` });
+}
+function childrenAges(max) {
+  const error = `childrenAges must list each child's age (0 to 17) in one room, at most ${max}`;
+  return z.array(wholeNumber("Each child's age", 0, 17), { error }).max(max, { error });
+}
+
+// src/limits.ts
+var LIMITS = {
+  rooms: 8,
+  adultsPerRoom: 8,
+  childrenPerRoom: 8,
+  childAgeMax: 17,
+  nights: 15,
+  ratesHotels: 15,
+  facilities: 10,
+  queryLength: 128,
+  nearRadiusKm: 200,
+  page: 100,
+  pageSize: 50,
+  guestName: 60,
+  contactName: 120,
+  contactPhoneMin: 3,
+  contactPhoneMax: 40,
+  specialRequests: 500,
+  maxRoomsPerHotel: 200
+};
+var BOARD_CODES = [
+  "RO",
+  "BB",
+  "HB",
+  "FB",
+  "BL",
+  "BD",
+  "HBBL",
+  "HBLD",
+  "AI"
+];
+var CURRENCIES = ["CNY", "USD"];
+var SEARCH_SORTS = [
+  "recommended",
+  "price-asc",
+  "price-desc",
+  "star-desc",
+  "distance"
+];
+var SUPPORT_EMAIL = "info@fortrip.ai";
+
+// src/inputs.ts
+var FACILITY_NAME_MAX = 64;
+var MAX_HOTEL_ID = 2147483647;
+var DEFAULT_MAX_ROOMS_PER_HOTEL = 10;
+var stayDescriptions = {
+  checkIn: "Check-in date, yyyy-MM-dd.",
+  checkOut: `Check-out date, yyyy-MM-dd. Stays are 1 to ${LIMITS.nights} nights.`
+};
+var displayCurrency = oneOf("currency", CURRENCIES).default("CNY").describe(
+  "Currency to show prices in. Prices are converted from the supplier's at Stripe's exchange rate; the response's `fx` says how."
+);
+function bounded(name, min, max) {
+  const error = `${name} must be a number from ${min} to ${max}`;
+  return z2.number({ error }).min(min, { error }).max(max, { error });
+}
+var queryError = `query must be text of 1 to ${LIMITS.queryLength} characters`;
+var facilitiesError = `facilities must list 1 to ${LIMITS.facilities} catalogue facility names (1 to ${FACILITY_NAME_MAX} characters each)`;
+var radiusError = `near.radiusKm must be more than 0, at most ${LIMITS.nearRadiusKm}`;
+var searchHotelsInput = strictInput({
+  query: z2.string({ error: queryError }).trim().min(1, { error: queryError }).max(LIMITS.queryLength, { error: queryError }).optional().describe(
+    "Hotel name, brand or city to search for. Provide at least one of `query`, `cityCode` or `near`."
+  ),
+  cityCode: positiveId("cityCode").optional().describe("Catalogue city code, as returned in `hotels[].cityCode`."),
+  near: strictInput({
+    lat: bounded("near.lat", -90, 90).describe("Latitude."),
+    lng: bounded("near.lng", -180, 180).describe("Longitude."),
+    radiusKm: z2.number({ error: radiusError }).positive({ error: radiusError }).max(LIMITS.nearRadiusKm, { error: radiusError }).describe("Radius in kilometres.")
+  }).optional().describe("Search around a point."),
+  starMin: bounded("starMin", 0, 5).optional().describe("Lowest star rating to include."),
+  starMax: bounded("starMax", 0, 5).optional().describe("Highest star rating to include."),
+  facilities: z2.array(
+    z2.string({ error: facilitiesError }).trim().min(1, { error: facilitiesError }).max(FACILITY_NAME_MAX, { error: facilitiesError }),
+    { error: facilitiesError }
+  ).min(1, { error: facilitiesError }).max(LIMITS.facilities, { error: facilitiesError }).transform((names) => [...new Set(names)]).optional().describe(
+    "Facilities every hotel must have. Names must match the catalogue exactly (case-insensitive), e.g. `Swimming pool`, `Parking`."
+  ),
+  checkIn: isoDate("checkIn").describe(stayDescriptions.checkIn),
+  checkOut: isoDate("checkOut").describe(stayDescriptions.checkOut),
+  currency: displayCurrency,
+  priceMin: z2.number({ error: "priceMin must be a number, 0 or more" }).nonnegative({ error: "priceMin must be a number, 0 or more" }).optional().describe(
+    "Lowest average nightly price, in `currency`. Applied to indicative prices."
+  ),
+  priceMax: z2.number({ error: "priceMax must be a number above 0" }).positive({ error: "priceMax must be a number above 0" }).optional().describe("Highest average nightly price, in `currency`."),
+  sortBy: oneOf("sortBy", SEARCH_SORTS).default("recommended").describe(
+    "Result order. `recommended` sorts by distance with `near`, by relevance with `query`, otherwise by catalogue weight. `distance` requires `near`."
+  ),
+  page: wholeNumber("page", 1, LIMITS.page).default(1).describe("Page number."),
+  pageSize: wholeNumber("pageSize", 1, LIMITS.pageSize).default(20).describe("Hotels per page.")
+}).superRefine((input, ctx) => {
+  if (!input.query && input.cityCode === void 0 && !input.near) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["query"],
+      message: "Provide query, cityCode or near"
+    });
+  }
+  if (input.sortBy === "distance" && !input.near) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["sortBy"],
+      message: "distance sort requires near"
+    });
+  }
+  if (input.starMin !== void 0 && input.starMax !== void 0 && input.starMin > input.starMax) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["starMax"],
+      message: "starMax must be >= starMin"
+    });
+  }
+  if (input.priceMin !== void 0 && input.priceMax !== void 0 && input.priceMin > input.priceMax) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["priceMax"],
+      message: "priceMax must be >= priceMin"
+    });
+  }
+  if (!isIsoDate(input.checkIn) || !isIsoDate(input.checkOut)) return;
+  const earliest = addIsoDateDays((/* @__PURE__ */ new Date()).toISOString().slice(0, 10), -1);
+  if (input.checkIn < earliest) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["checkIn"],
+      message: "checkIn must not be in the past"
+    });
+  }
+  const nights = countIsoDateDays(input.checkIn, input.checkOut);
+  if (nights < 1) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["checkOut"],
+      message: "checkOut must be after checkIn"
+    });
+  } else if (nights > LIMITS.nights) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["checkOut"],
+      message: `search supports at most ${LIMITS.nights} nights`
+    });
+  }
+});
+var hotelIdError = "hotelId must be a positive whole number";
+var getHotelInput = z2.object(
+  {
+    hotelId: z2.coerce.number({ error: hotelIdError }).int({ error: hotelIdError }).positive({ error: hotelIdError }).max(MAX_HOTEL_ID, { error: hotelIdError }).describe("hotelId from search_hotels"),
+    includeRooms: flag("includeRooms").optional().describe("Also return the catalogue room list (adds a few KB)")
+  },
+  { error: "Expected a JSON object" }
+);
+var hotelIdsError = `hotelIds must list 1 to ${LIMITS.ratesHotels} hotelIds`;
+var boardCodesError = `boardCodes must list meal codes from: ${BOARD_CODES.join(", ")}`;
+var getRatesInput = strictInput({
+  hotelIds: z2.array(positiveId("Each hotelId"), { error: hotelIdsError }).min(1, { error: hotelIdsError }).max(LIMITS.ratesHotels, { error: hotelIdsError }).describe("Hotels to price. Each call takes about 15 seconds."),
+  checkIn: isoDate("checkIn").describe(stayDescriptions.checkIn),
+  checkOut: isoDate("checkOut").describe(stayDescriptions.checkOut),
+  rooms: wholeNumber("rooms", 1, LIMITS.rooms).describe(
+    "Number of rooms; every room has the same occupancy"
+  ),
+  adults: wholeNumber("adults (per room)", 1, LIMITS.adultsPerRoom).describe(
+    "Adults per room, not in total (2 rooms for 4 adults = rooms 2, adults 2)"
+  ),
+  childrenAges: childrenAges(LIMITS.childrenPerRoom).optional().describe("Age of each child in one room (0-17), per room"),
+  nationality: z2.string({ error: "nationality must be a 2-letter ISO 3166-1 code" }).regex(/^[A-Z]{2}$/, {
+    error: "nationality must be a 2-letter ISO 3166-1 code, upper case"
+  }).optional().describe(
+    "Guest nationality, ISO 3166-1 alpha-2 in upper case, e.g. `CN`. Some rates are restricted by nationality; booking doesn't send it, so such a rate may change or be refused at booking"
+  ),
+  currency: displayCurrency,
+  // One hotel can return thousands of rate plans; these keep a response
+  // small enough for an agent's context.
+  bookableOnly: flag("bookableOnly").default(true).describe("Keep only rates that are bookable on every night."),
+  boardCodes: z2.array(oneOf("Each boardCode", BOARD_CODES), { error: boardCodesError }).min(1, { error: boardCodesError }).optional().describe(
+    "Keep only these meal plans: `RO` room only, `BB` breakfast, `HB` half board, `FB` full board, `AI` all inclusive, and so on."
+  ),
+  freeCancellation: flag("freeCancellation").optional().describe(
+    "Keep only rates that can still be cancelled free of charge right now."
+  ),
+  maxRoomsPerHotel: wholeNumber("maxRoomsPerHotel", 1, LIMITS.maxRoomsPerHotel).default(DEFAULT_MAX_ROOMS_PER_HOTEL).describe(
+    "Return the N cheapest rooms per hotel. The MCP tool defaults to 5, the CLI to 10."
+  )
+}).superRefine((input, ctx) => {
+  if (!isIsoDate(input.checkIn) || !isIsoDate(input.checkOut)) return;
+  const nights = countIsoDateDays(input.checkIn, input.checkOut);
+  if (nights < 1) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["checkOut"],
+      message: "checkOut must be after checkIn"
+    });
+  } else if (nights > LIMITS.nights) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["checkOut"],
+      message: `rates support at most ${LIMITS.nights} nights`
+    });
+  }
+});
+function cardFreeText(name, min, max, minDigits) {
+  return text(name, min, max).refine(
+    (value) => !containsCardNumber(value, minDigits),
+    { error: CARD_NUMBER_MESSAGE, abort: true }
+  );
+}
+function guestName(name) {
+  return cardFreeText(name, 1, LIMITS.guestName).refine((value) => normalizeGuestName(value) !== "", {
+    error: `${name} must not be blank`
+  }).refine(
+    (value) => {
+      const normalized = normalizeGuestName(value);
+      return normalized === "" || guestNameRe.test(normalized);
+    },
+    { error: GUEST_NAME_MESSAGE }
+  );
+}
+var guestsError = "guests must list at least one guest per room";
+var roomNoError = `roomNo must be a whole number from 1 to ${LIMITS.rooms}`;
+var contactEmailError = "contactEmail must be an email address";
+var createBookingInput = strictInput({
+  hotelId: positiveId("hotelId").describe("Hotel id."),
+  roomId: nonEmpty("roomId").describe("roomId from get_rates"),
+  ratePlanCode: nonEmpty("ratePlanCode").describe(
+    "ratePlanCode from get_rates"
+  ),
+  checkIn: isoDate("checkIn").describe(stayDescriptions.checkIn),
+  checkOut: isoDate("checkOut").describe(stayDescriptions.checkOut),
+  rooms: wholeNumber("rooms", 1, LIMITS.rooms).describe(
+    "Number of rooms, as in get_rates; every room has the same occupancy"
+  ),
+  adults: wholeNumber("adults (per room)", 1, LIMITS.adultsPerRoom).describe(
+    "Adults per room, not in total, as in get_rates (2 rooms for 4 adults = rooms 2, adults 2)"
+  ),
+  childrenAges: childrenAges(LIMITS.childrenPerRoom).default([]).describe(
+    "Age of each child in one room (0-17), per room, as in get_rates"
+  ),
+  guests: z2.array(
+    strictInput({
+      firstName: guestName("firstName").describe("First name."),
+      lastName: guestName("lastName").describe("Last name."),
+      // A numeric string ("1") booked before; the action takes either.
+      roomNo: z2.coerce.number({ error: roomNoError }).int({ error: roomNoError }).min(1, { error: roomNoError }).max(LIMITS.rooms, { error: roomNoError }).describe("Room the guest stays in, starting at 1.")
+    }),
+    { error: guestsError }
+  ).min(1, { error: guestsError }).describe(
+    "At least one guest per room, no more than the room sleeps. Names in Latin letters as on the passport; transliterate accents (M\xFCller \u2192 Mueller)."
+  ),
+  contactName: cardFreeText("contactName", 1, LIMITS.contactName).describe(
+    "Contact person for the booking."
+  ),
+  // Only cards of 16+ digits: a phone number has at most 15 (E.164), so
+  // its digits aren't mistaken for a card.
+  contactPhone: cardFreeText(
+    "contactPhone",
+    LIMITS.contactPhoneMin,
+    LIMITS.contactPhoneMax,
+    16
+  ).describe("Contact phone number."),
+  // Blank means none, as it did before: the booking sends no email then.
+  contactEmail: z2.string({ error: contactEmailError }).trim().refine((value) => value === "" || z2.email().safeParse(value).success, {
+    error: contactEmailError
+  }).optional().describe("Contact email."),
+  specialRequests: cardFreeText("specialRequests", 0, LIMITS.specialRequests).optional().describe("Requests for the hotel, in English. Not guaranteed.")
+}).superRefine((input, ctx) => {
+  if (!isIsoDate(input.checkIn) || !isIsoDate(input.checkOut)) return;
+  const nights = countIsoDateDays(input.checkIn, input.checkOut);
+  if (nights < 1) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["checkOut"],
+      message: "checkOut must be after checkIn"
+    });
+  } else if (nights > LIMITS.nights) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["checkOut"],
+      message: `A booking covers at most ${LIMITS.nights} nights; book a longer stay as separate bookings`
+    });
+  }
+});
+
+// src/commands.ts
+function fieldDescription(json, field) {
+  let node = json;
+  for (const part of field.split(".")) {
+    node = (node?.properties ?? node?.items?.properties)?.[part];
+  }
+  if (!node?.description) throw new Error(`No description for field ${field}`);
+  return node.description;
+}
+function flagsOf(input, defs) {
+  const json = z3.toJSONSchema(input, { io: "input" });
+  return defs.map((def) => ({
+    ...def,
+    description: def.description ?? fieldDescription(json, def.field)
+  }));
+}
+var ID = "<id>";
+var COUNT = "<n>";
+var DATE = "YYYY-MM-DD";
+var searchFlags = flagsOf(searchHotelsInput, [
+  {
+    flag: "query",
+    short: "q",
+    field: "query",
+    type: "string",
+    placeholder: "<text>",
+    description: "Hotel name, brand or city to search for. Provide at least one of `--query`, `--city-code` or `--near`."
+  },
+  { flag: "city-code", field: "cityCode", type: "id", placeholder: COUNT },
+  {
+    flag: "near",
+    field: "near",
+    type: "string",
+    placeholder: "<lat,lng,km>",
+    description: `Search around a point, as \`lat,lng,radiusKm\` (radius up to ${LIMITS.nearRadiusKm}), e.g. \`13.75,100.5,5\`.`
+  },
+  { flag: "check-in", field: "checkIn", type: "string", placeholder: DATE },
+  { flag: "check-out", field: "checkOut", type: "string", placeholder: DATE },
+  { flag: "star-min", field: "starMin", type: "number", placeholder: COUNT },
+  { flag: "star-max", field: "starMax", type: "number", placeholder: COUNT },
+  {
+    flag: "facility",
+    field: "facilities",
+    type: "string",
+    multiple: true,
+    placeholder: "<name>"
+  },
+  { flag: "price-min", field: "priceMin", type: "number", placeholder: COUNT },
+  { flag: "price-max", field: "priceMax", type: "number", placeholder: COUNT },
+  {
+    flag: "sort",
+    field: "sortBy",
+    type: "string",
+    placeholder: SEARCH_SORTS.join("|")
+  },
+  { flag: "page", field: "page", type: "number", placeholder: COUNT },
+  { flag: "page-size", field: "pageSize", type: "number", placeholder: COUNT },
+  {
+    flag: "currency",
+    field: "currency",
+    type: "string",
+    placeholder: CURRENCIES.join("|")
+  }
+]);
+var hotelFlags = flagsOf(getHotelInput, [
+  { flag: "with-rooms", field: "includeRooms", type: "boolean" }
+]);
+var ratesFlags = flagsOf(getRatesInput, [
+  {
+    flag: "hotel",
+    field: "hotelIds",
+    type: "id",
+    multiple: true,
+    placeholder: ID,
+    description: `Hotels to price, by id from \`search\`: repeat the flag or comma-separate, up to ${LIMITS.ratesHotels}. Each call takes about 15 seconds.`
+  },
+  { flag: "check-in", field: "checkIn", type: "string", placeholder: DATE },
+  { flag: "check-out", field: "checkOut", type: "string", placeholder: DATE },
+  { flag: "rooms", field: "rooms", type: "number", placeholder: COUNT },
+  {
+    flag: "adults",
+    field: "adults",
+    type: "number",
+    placeholder: COUNT,
+    description: "Adults per room, not in total (2 rooms for 4 adults = `--rooms 2 --adults 2`)"
+  },
+  {
+    flag: "child-age",
+    field: "childrenAges",
+    type: "number",
+    multiple: true,
+    placeholder: "<age>"
+  },
+  {
+    flag: "nationality",
+    field: "nationality",
+    type: "string",
+    placeholder: "<CC>"
+  },
+  {
+    flag: "board",
+    field: "boardCodes",
+    type: "string",
+    multiple: true,
+    placeholder: BOARD_CODES.join("|")
+  },
+  { flag: "free-cancellation", field: "freeCancellation", type: "boolean" },
+  {
+    flag: "include-unbookable",
+    field: "bookableOnly",
+    type: "boolean",
+    description: "Also keep rates that are not bookable on every night (by default only bookable rates are returned)."
+  },
+  {
+    flag: "max-rooms",
+    field: "maxRoomsPerHotel",
+    type: "number",
+    placeholder: COUNT,
+    description: "Return the N cheapest rooms per hotel. Default 10."
+  },
+  {
+    flag: "currency",
+    field: "currency",
+    type: "string",
+    placeholder: CURRENCIES.join("|")
+  }
+]);
+var bookFlags = flagsOf(createBookingInput, [
+  { flag: "hotel", field: "hotelId", type: "id", placeholder: ID },
+  {
+    flag: "room-id",
+    field: "roomId",
+    type: "string",
+    placeholder: ID,
+    description: "`roomId` from `rates`"
+  },
+  {
+    flag: "rate-plan",
+    field: "ratePlanCode",
+    type: "string",
+    placeholder: "<code>",
+    description: "`ratePlanCode` from `rates`"
+  },
+  { flag: "check-in", field: "checkIn", type: "string", placeholder: DATE },
+  { flag: "check-out", field: "checkOut", type: "string", placeholder: DATE },
+  {
+    flag: "rooms",
+    field: "rooms",
+    type: "number",
+    placeholder: COUNT,
+    description: "Number of rooms, as in `rates`; every room has the same occupancy"
+  },
+  {
+    flag: "adults",
+    field: "adults",
+    type: "number",
+    placeholder: COUNT,
+    description: "Adults per room, not in total, as in `rates` (2 rooms for 4 adults = `--rooms 2 --adults 2`)"
+  },
+  {
+    flag: "child-age",
+    field: "childrenAges",
+    type: "number",
+    multiple: true,
+    placeholder: "<age>",
+    description: "Age of each child in one room (0-17), per room, as in `rates`"
+  },
+  {
+    flag: "guest",
+    field: "guests",
+    type: "string",
+    multiple: true,
+    placeholder: '"First Last[:roomNo]"',
+    description: 'A guest, as "First Last" (room 1) or "First Last:roomNo", e.g. "Mary Ann Lee:2": the last word is the last name, the rest the first name. Repeat for each guest. At least one guest per room, no more than the room sleeps. Names in Latin letters as on the passport; transliterate accents (M\xFCller \u2192 Mueller).'
+  },
+  {
+    flag: "contact-name",
+    field: "contactName",
+    type: "string",
+    placeholder: "<name>"
+  },
+  {
+    flag: "contact-phone",
+    field: "contactPhone",
+    type: "string",
+    placeholder: "<phone>"
+  },
+  {
+    flag: "contact-email",
+    field: "contactEmail",
+    type: "string",
+    placeholder: "<email>"
+  },
+  {
+    flag: "special-requests",
+    field: "specialRequests",
+    type: "string",
+    placeholder: "<english text>"
+  }
+]);
+var BODY_OPTION = {
+  flag: "body",
+  type: "string",
+  placeholder: "<json|@file.json>",
+  description: "The raw request body as a JSON object, or `@file.json` to read it from a file. Flags override its fields."
+};
+var COMMANDS = [
+  {
+    name: "search",
+    summary: "Find hotels with indicative prices",
+    tool: "search_hotels",
+    flags: searchFlags,
+    options: [BODY_OPTION]
+  },
+  {
+    name: "hotel",
+    summary: "Static hotel detail: description, policies, facilities and photos",
+    tool: "get_hotel",
+    flags: hotelFlags,
+    positionals: ["hotelId"]
+  },
+  {
+    name: "rates",
+    summary: `Live rooms and rates for up to ${LIMITS.ratesHotels} hotels`,
+    tool: "get_rates",
+    flags: ratesFlags,
+    options: [BODY_OPTION]
+  },
+  {
+    name: "book",
+    summary: "Create an order and get a payment link",
+    tool: "create_booking",
+    flags: bookFlags,
+    options: [BODY_OPTION]
+  },
+  {
+    name: "login",
+    summary: "Sign in through the browser (device code)",
+    tool: null,
+    flags: [],
+    options: [
+      {
+        flag: "no-browser",
+        type: "boolean",
+        description: "Don't open a browser: only print the sign-in code and link."
+      }
+    ]
+  },
+  {
+    name: "logout",
+    summary: "Revoke and forget the saved token",
+    tool: null,
+    flags: []
+  },
+  {
+    name: "whoami",
+    summary: "Show the signed-in account",
+    tool: null,
+    flags: []
+  },
+  {
+    name: "guide",
+    summary: "Print the guide for AI agents (Markdown)",
+    tool: "get_planning_guide",
+    flags: [],
+    positionals: ["topic"]
+  },
+  {
+    name: "mcp",
+    summary: "Run an MCP server over stdio for local clients, bridged to Fortrip's hosted server",
+    tool: null,
+    flags: []
+  }
+];
+var GLOBAL_FLAGS = [
+  {
+    flag: "help",
+    short: "h",
+    type: "boolean",
+    description: "Show help for the command, or for the CLI when no command is given."
+  },
+  {
+    flag: "version",
+    short: "v",
+    type: "boolean",
+    description: "Print the CLI version."
+  }
+];
+
+// src/guide-data.generated.ts
+var FRAGMENTS = {
+  "booking": '{{#if claude-skill cli}}\n## Booking\n\n{{/if}}\n- Call `{{tool:book}}` only for the rate the user picked{{#if claude-skill cli}}, with exactly the hotel, `{{arg:roomId}}`, `{{arg:ratePlanCode}}`, dates, `{{arg:rooms}}`, `{{arg:adults}}` and `{{arg:childrenAges}}` used in `{{tool:rates}}`{{/if}}.\n- Guest names: Latin letters as on the passport (M\xFCller \u2192 Mueller), first and last name 1\u2013{{limit:guestName}} characters each{{#if cli}}, as `--guest "First Last"` (the last word is the last name; `"First Last:2"` puts the guest in room 2){{/if}}.{{#if claude-skill cli}} At least one guest per room, no more than the room sleeps.{{/if}}\n{{#if claude-skill cli}}\n- A contact name (up to {{limit:contactName}} characters) and phone ({{limit:contactPhoneMin}}\u2013{{limit:contactPhoneMax}} characters) are required; an email is optional. Special requests must be in English and aren\'t guaranteed.\n- One booking covers at most {{limit:nights}} nights; book a longer stay as separate bookings.\n{{/if}}\n- The `{{arg:nationality}}` given to `{{tool:rates}}` isn\'t sent with the booking: a rate restricted by nationality may change or be refused.\n- `{{tool:book}}` can take up to about two minutes{{#if cli}}: allow the command at least 3 minutes{{/if}}. If it times out, {{#if cli}}run it again with identical flags{{/if}}{{#if mcp claude-skill}}call it again with the same details{{/if}}: it resumes the same order{{#if claude-skill cli}}, with the same or a refreshed payment link{{/if}}.\n{{#if cli}}\n- `{{tool:book}}` takes only these fields: a `--body` with any other field (such as `nationality`) is rejected with exit 2.\n{{/if}}\n',
+  "errors": "{{#if claude-skill cli}}\n## Errors\n\n{{#if claude-skill}}A tool error{{/if}}{{#if cli}}An error on stderr{{/if}} carries `error` (what went wrong) and `status`, and most carry a `reason`:\n\n| `reason` | Do this |\n|---|---|\n| `already_booked` (409) | This stay is already paid or completed: show `orderUrl` and don't book again |\n| `price_or_terms_changed` (409) | The rate changed; `changes` says how. Show the user what changed and re-run `{{tool:rates}}`; if they still want it, call `{{tool:book}}` again and confirm the new price and terms before giving the link |\n| `rate_unavailable` (422) | The rate can no longer be booked: re-run `{{tool:rates}}` and let the user choose again |\n| `supplier_unavailable` (503 or 504) | Wait `retryAfterSeconds` and retry once with the same details; if it fails again, tell the user |\n| `refused` (422) | The booking was refused (a guest name, too many attempts, bookings paused): read `error` and explain it to the user |\n{{#if claude-skill}}\n\nWithout a `reason`:\n\n- **429**: wait `retryAfterSeconds`, then retry once.\n- **503** with `retryable: true` is a brief failure on Fortrip's side (for example, the same booking started twice at once): wait `retryAfterSeconds`, then retry once with the same details.\n- **500** and **502** are generic failures: read `error` and tell the user instead of guessing.\n{{/if}}\n{{/if}}\n",
+  "meals": "{{#if claude-skill cli}}\n## Presenting a rate\n\nGive the user, for each option:\n\n- the meal plan: `boardCode` (RO room only, BB breakfast, HB breakfast + dinner, FB breakfast + lunch + dinner, BL lunch, BD dinner, HBBL breakfast + lunch, HBLD lunch + dinner, AI all inclusive) with `boardCount`, how many guests per room the meal plan covers. Fewer than the adults per room means not everyone gets the meals (BB with `boardCount` 1 for 2 adults is breakfast for 1 of 2): say who is covered;\n- cancellation: `refundable` and `freeCancelUntil`;\n- confirmation: `isInstantConfirm`;\n- any `fees`: taxes paid at the hotel, in their own currency.\n{{/if}}\n",
+  "occupancy": "{{#if claude-skill cli}}\n## Occupancy\n\n{{/if}}\n- `{{tool:rates}}` and `{{tool:book}}` both require `{{arg:rooms}}` and `{{arg:adults}}`. `{{arg:adults}}` and `{{arg:childrenAges}}` are **per room**, the same in every room: 2 rooms for 4 adults is {{#if cli}}`--rooms 2 --adults 2`{{/if}}{{#if mcp claude-skill}}`rooms: 2, adults: 2`{{/if}}.\n{{#if claude-skill cli}}\n- If the party doesn't divide evenly across the rooms (3 adults in 2 rooms), ask the user whether to price every room for the larger number or to price and book each occupancy as its own stay.\n- Ask each child's age; `{{tool:rates}}` and `{{tool:book}}` need it.\n- Limits: 1\u2013{{limit:rooms}} rooms, 1\u2013{{limit:adultsPerRoom}} adults and 0\u2013{{limit:childrenPerRoom}} children (aged 0\u2013{{limit:childAgeMax}}) per room, 1\u2013{{limit:nights}} nights, up to {{limit:ratesHotels}} hotels per `{{tool:rates}}` call.\n{{/if}}\n",
+  "order": '{{#if claude-skill cli}}\n## Workflow\n\n1. **Search** with `{{tool:search}}` for candidate hotels and indicative prices. It needs `{{arg:checkIn}}` and `{{arg:checkOut}}`.\n{{#if cli}}\n\n   ```bash\n   {{tool:search}} --query "Bangkok" --check-in 2026-11-10 --check-out 2026-11-12 \\\n     --star-min 4 --sort price-asc --page-size 10\n   ```\n\n{{/if}}\n2. **Details** (optional) with `{{tool:hotel}}`, when the user asks about a hotel or a stated preference needs evidence (a pool, a policy, room size). For a details-only question, call it directly when you know the hotel\'s id; otherwise find the hotel with `{{tool:search}}` using the user\'s dates (ask for them if they gave none).\n{{#if cli}}\n\n   ```bash\n   {{tool:hotel}} 266000 [--with-rooms]\n   ```\n\n{{/if}}\n3. **Rates** with `{{tool:rates}}` for a few shortlisted hotels, using the dates and occupancy the user will book. It takes about 15 seconds. A hotel is available only once this returns a live option for it.\n{{#if cli}}\n\n   ```bash\n   {{tool:rates}} --hotel 266000 --hotel 266001 --check-in 2026-11-10 \\\n     --check-out 2026-11-12 --rooms 1 --adults 2 [--child-age 6] \\\n     [--nationality CN] [--board BB] [--free-cancellation] [--currency USD]\n   ```\n\n{{/if}}\n4. **Book** with `{{tool:book}}`, once the user has picked one rate and given the guest details (see Booking).\n{{#if cli}}\n\n   ```bash\n   {{tool:book}} --hotel 266000 --room-id 9191658 --rate-plan "<ratePlanCode>" \\\n     --check-in 2026-11-10 --check-out 2026-11-12 --rooms 1 --adults 2 \\\n     --guest "John Smith" --contact-name "John Smith" \\\n     --contact-phone "+8613800000000" [--contact-email john@example.com]\n   ```\n\n{{/if}}\n5. **Confirm, then give the payment link**, as in "Before giving the payment link" below.\n\n## Search\n\n{{/if}}\n- Search prices come from a minimum-price feed, not live rates: quote `{{tool:rates}}` prices, and never call a search result available or bookable.{{#if claude-skill cli}} When you show search prices, say they are indicative minimums, not quotes.{{/if}}\n- A search that matches too many hotels fails with `matched` and `maxMatches`: narrow it{{#if claude-skill cli}} (a city, an area, stars or a price range){{/if}}.\n{{#if claude-skill cli}}\n- Use `{{arg:near}}` for "near X"{{#if cli}} (`lat,lng,radiusKm`){{/if}}, and `{{arg:cityCode}}` when you know the city\'s code.\n- Facility names in `{{arg:facilities}}` must match the catalogue exactly (`Swimming pool`, `Parking`); near-synonyms match nothing.\n{{/if}}\n',
+  "payment-link": "{{#if claude-skill cli}}\n## Before giving the payment link\n\n`{{tool:book}}` returns `paymentUrl`, `statusUrl`, `orderUrl`, `amount`, `currency`, `terms` and `stay`. Nothing is charged until the user pays.\n\n1. Show the `stay` (hotel, room, dates, nights, rooms, adults and children's ages per room), the `amount` and `currency` to be charged, and every item in `terms`: meal plan (`boardCode` with `boardCount`), cancellation (`refundable`, `freeCancelUntil`, the `cancellation` ladder), confirmation (`isInstantConfirm`, `confirmByMins`) and `payAtHotelFees`.\n2. End that reply by asking the user to confirm, and wait for a clear yes. Urgency is not consent.\n3. Then give `paymentUrl` exactly as returned: don't shorten, rebuild or re-encode it. It opens a Fortrip page that recaps the booking and continues to payment on Stripe.\n\n{{/if}}\n{{#if mcp}}\n- Before you give `paymentUrl`, show the user the `stay`, `amount`, `currency` and every item in `terms` that `{{tool:book}}` returned, end that reply by asking the user to confirm, and wait for a clear yes. Then give `paymentUrl` exactly as returned, to this user only: anyone holding it can pay.\n{{/if}}\n- If `amount` or `terms` is null, don't give the link: call `{{tool:book}}` again with the same details, and if either is still null, tell the user to contact {{support}}.\n{{#if claude-skill cli}}\n- `paymentUrl` works like a payment credential: anyone holding it can pay. Give it to this user only, never in shared channels, documents, logs or tickets. It expires about 3 hours 45 minutes after it was created; for a fresh one, call `{{tool:book}}` again with the same details.\n- `statusUrl` is the same page: after payment it shows the booking's confirmation progress, without signing in. `orderUrl` is the user's signed-in order page.\n{{/if}}\n- Never ask for, accept or pass on payment card details; payment happens only on the payment page.{{#if claude-skill cli}} A card number in a guest name, the contact name or the special requests is rejected{{#if cli}} with exit 2{{/if}}.{{/if}}\n",
+  "planning": "# Planning a hotel stay\n\nRead this when the request is more than one hotel for fixed dates: flexible dates, a budget, split stays, several destinations, or \"find me the best\". The rules in {{#if mcp}}the server instructions{{/if}}{{#if claude-skill}}SKILL.md{{/if}}{{#if cli}}`{{tool:guide}}`{{/if}} still apply (call order, occupancy per room, confirming the terms `{{tool:book}}` returns before giving the payment link); this covers what to ask, how to compare and how to present.{{#if cli}} As there, `fortrip` is short for `npx -y fortrip@latest`.{{/if}}\n\n## What to collect\n\nKeep track of: dates (or the flexible window), nights, destination(s), rooms and the guests in each room, room constraints (beds, connecting rooms, accessibility), budget, and what the user said matters most (cheapest, most flexible, closest to X).\n\nOccupancy is per room and the same in every room, so if the party doesn't split evenly across the rooms, ask how it splits.\n\nAsk only for what changes which hotels qualify or how they rank. If children come along, ask each child's age; `{{tool:rates}}` and `{{tool:book}}` need it. Don't ask for trip type or style: infer it from the conversation or leave it general.\n\n## Evidence\n\n- A `{{tool:search}}` price is an indicative minimum, not a quote. Never call a search result available or bookable.\n- Use `{{tool:hotel}}` only when a stated preference needs evidence (a pool, a policy, room size).\n- A hotel is available only once `{{tool:rates}}` returned a live option for it.\n- Anything {{#if mcp claude-skill}}the tools{{/if}}{{#if cli}}the CLI{{/if}} didn't return, such as reviews, style, price trends or exchange rates other than `fx`, is unknown. Say so instead of filling it in.\n\n## Ranking\n\n1. Drop options that break a hard constraint (dates, guests, budget cap, required facility). Compare a budget in the unit the user gave it: per night, per room or for the whole stay.\n2. Keep only options with a live rate.\n3. Order by the user's stated main goal. Goals they didn't state don't count.\n4. Use other preferences only to break ties.\n\nUse the cheapest comparable live room as the baseline unless the user fixed the room type. Show at most three plans, each with its price difference from the baseline and what it trades off (meal plan, cancellation, location, instant confirmation). Keep hotel names as returned and dates in the user's notation.\n\nFor a split stay or several destinations, price each leg with its own `{{tool:rates}}` call and add up the legs. Each leg is a separate `{{tool:book}}` call, with its own confirmation and its own payment link.\n\n## Stop and say so\n\n- `{{tool:rates}}` covers up to {{limit:ratesHotels}} hotels per call and takes about 15 seconds. If the request needs more hotels or date combinations than a few calls can cover, narrow it with the user, or present the result as a comparison of the hotels you priced, not the best overall.\n- Urgency is not consent. Call `{{tool:book}}` only for the rate the user picked, and give its payment link only after the user confirms the amount, currency, stay and terms that `{{tool:book}}` returned.\n",
+  "prices": "{{#if claude-skill cli}}\n## Prices and currency\n\n{{/if}}\n- In `{{tool:rates}}`, `totalPrice` is the whole stay for all rooms, and `dailyPrices` are per room per night.{{#if claude-skill cli}} To compare with a per-night or per-room budget, divide the total by the nights and rooms, or use `dailyPrices`.{{/if}}\n- Pass `{{arg:currency}}`{{#if claude-skill cli}} to `{{tool:search}}` and `{{tool:rates}}`{{/if}}: `CNY` (the default) or `USD`, to suit the user's language or location.{{#if cli}} Without `--currency`, the CLI uses the currency in `--body`, then `FORTRIP_CURRENCY`, then `CNY`.{{/if}}{{#if claude-skill cli}} Prices are converted at Stripe's exchange rate, or a fixed fallback rate when Stripe is unavailable; `fx` says which, and is `null` when nothing needed converting.{{/if}}\n{{#if claude-skill cli}}\n- `{{arg:priceMin}}` and `{{arg:priceMax}}` on `{{tool:search}}` bound the indicative nightly price, in that currency.\n{{/if}}\n- The charge is the `amount` in the `currency` that `{{tool:book}}` returns (currently USD). A converted price is a reference: never present it as the charge.{{#if claude-skill cli}} Stripe's page may also show the charge in the user's local currency, at Stripe's rate. Fees paid at the hotel are separate, in their own currency.{{/if}}\n",
+  "scope": "{{#if claude-skill cli}}\n# Fortrip hotel stays\n\n{{/if}}\nFortrip: hotel search, live rates and booking payment links.{{#if claude-skill cli}} Not for flights, activities, or changing or cancelling an existing booking.{{/if}}\n\n{{#if mcp}}\nCall order: `{{tool:search}}` \u2192 (optional) `{{tool:hotel}}` \u2192 `{{tool:rates}}` \u2192 `{{tool:book}}`. `{{tool:guide}}` returns Fortrip's guidance for flexible dates, budgets, split stays, several destinations or \"find the best\" requests.\n{{/if}}\n{{#if claude-skill}}\nThe tools are on Fortrip's MCP server, named `fortrip` in this plugin (a Fortrip connector added on claude.ai can show under its own name). They're written `fortrip:<tool>` below:\n{{/if}}\n{{#if cli}}\nThe `fortrip` CLI (npm package `fortrip`) calls Fortrip as the signed-in user and prints JSON:\n{{/if}}\n{{#if claude-skill cli}}\n\n| {{#if claude-skill}}Tool{{/if}}{{#if cli}}Command{{/if}} | Returns |\n|---|---|\n| `{{tool:search}}` | Hotels by name, brand or city (`{{arg:query}}`), `{{arg:cityCode}}`, or a point and radius (`{{arg:near}}`), with indicative prices |\n| `{{tool:hotel}}` | One hotel's address, check-in and check-out times, policies, facilities and photos; no prices |\n| `{{tool:rates}}` | Live rooms, meal plans, cancellation terms and prices for up to {{limit:ratesHotels}} hotels |\n| `{{tool:book}}` | An unpaid booking for one rate, with its terms and a payment link |\n\nFor flexible dates, a budget, split stays, several destinations or \"find me the best\", {{#if claude-skill}}read [references/planning.md](references/planning.md){{/if}}{{#if cli}}also run `{{tool:guide}} planning`{{/if}} before searching.\n{{/if}}\n",
+  "setup": "{{#if cli}}\n## Setup\n\nRun every command as `npx -y fortrip@latest <command>` (Node.js 22 or newer). The examples below shorten that to `fortrip`; `fortrip <command> --help` lists a command's flags. `{{tool:search}}`, `{{tool:rates}}` and `{{tool:book}}` also take `--body '<json>'` (or `--body @file.json`), the raw request body; flags override its fields.\n\nWhen the user first asks about hotels, run `{{tool:whoami}}` before asking follow-up questions, so the sign-in can happen while they answer.\n\n{{/if}}\n{{#if claude-skill cli}}\n## Sign-in\n\n{{/if}}\nSign-in happens only in the browser. Never ask the user to paste a token.\n{{#if claude-skill}}\n\nIf none of these tools are available, Fortrip isn't connected: tell the user to add the Fortrip connector or plugin and sign in.\n{{/if}}\n{{#if mcp claude-skill}}\nIf a tool says the user isn't signed in, ask them to reconnect Fortrip and sign in again.\n{{/if}}\n{{#if cli}}\n\nIf a command exits with code **3** and stderr has `loginUrl`, show it to the user as a link together with `userCode`, e.g. \"Sign in to Fortrip: <loginUrl> (code <userCode>), then tell me when you're done.\" When they confirm, rerun the same command; it finishes the sign-in itself. Don't run `{{tool:login}}`: it waits for up to 10 minutes. Commands that exit 3 together share one `loginUrl`; show it once. If the rerun gives a different `loginUrl`, show that one.\n\nWhen Fortrip no longer accepts the saved sign-in (it was revoked, or it expired and couldn't be renewed), the command also exits 3 with a `loginUrl`; handle it the same way. The saved sign-in is kept until the user approves the new link.\n\nIn CI or a sandbox without a browser, the user can set `FORTRIP_TOKEN` instead. Exit 3 with `tokenSource: \"FORTRIP_TOKEN\"` means Fortrip didn't accept that token: tell the user to replace or unset it.\n\n## Exit codes\n\n| Code | Meaning | What to do |\n|---|---|---|\n| 0 | Success; JSON on stdout | Continue |\n| 1 | Any other error: an error from Fortrip (see Errors), a network error or a timeout | Read `error` on stderr. If `retryable` is true, wait `retryAfterSeconds` (or a few seconds) and retry once |\n| 2 | Invalid arguments | Fix the flags; stderr `issues` lists each bad field with a message |\n| 3 | Not signed in | Show `loginUrl` to the user, then rerun (above) |\n| 4 | Rate limited | Wait `retryAfterSeconds`, then retry once |\n\nOutput on stdout or stderr can carry `warning` (with `recoveryFile` when a sign-in couldn't be saved): pass it on to the user.\n{{/if}}\n",
+  "support": "{{#if claude-skill cli}}\n## Changes and support\n\n{{/if}}\n{{#if mcp claude-skill}}These tools{{/if}}{{#if cli}}The CLI{{/if}} can't change or cancel a booking: for changes, cancellations, refunds or other problems with a booking, the user emails {{support}} with the booking's `orderUrl` (never `paymentUrl` or `statusUrl`).\n"
+};
+
+// src/guide.ts
+var SURFACES = ["mcp", "claude-skill", "cli"];
+var TOPICS = {
+  main: [
+    "scope",
+    "setup",
+    "order",
+    "occupancy",
+    "prices",
+    "meals",
+    "booking",
+    "payment-link",
+    "errors",
+    "support"
+  ],
+  planning: ["planning"]
+};
+function renderGuide(surface, topic) {
+  if (!Object.hasOwn(TOPICS, topic)) {
+    throw new Error(`Unknown guide topic "${topic}"`);
+  }
+  const parts = TOPICS[topic].map((name) => {
+    const fragment = FRAGMENTS[name];
+    if (fragment === void 0) {
+      throw new Error(`Missing guide fragment "${name}"`);
+    }
+    return renderText(fragment, surface).trim();
+  });
+  const text2 = parts.filter(Boolean).join("\n\n");
+  return `${text2.replace(/\n{3,}/g, "\n\n")}
+`;
+}
+var TOKEN = /{{([^{}]*)}}/g;
+var CONDITION = /{{#if ([^{}]*)}}|{{\/if}}/g;
+var LONE_CONDITION = /^[ \t]*({{#if [^{}\n]*}}|{{\/if}})[ \t]*\n/gm;
+function renderText(text2, surface) {
+  if (!SURFACES.includes(surface)) {
+    throw new Error(`Unknown guide surface "${surface}"`);
+  }
+  for (const [token, body] of text2.matchAll(TOKEN)) {
+    if (!/^(#if |\/if$)/.test(body ?? "")) resolve(token, surface, false);
+  }
+  const shown = select(text2, surface).replace(
+    TOKEN,
+    (token) => resolve(token, surface, true)
+  );
+  if (/{{|}}/.test(shown)) {
+    throw new Error(`Unclosed guide token in: ${shown.slice(0, 200)}`);
+  }
+  return shown;
+}
+function select(text2, surface) {
+  const tagged = text2.replace(LONE_CONDITION, "$1");
+  const open = [];
+  let out = "";
+  let from = 0;
+  for (const tag of tagged.matchAll(CONDITION)) {
+    if (open.every(Boolean)) out += tagged.slice(from, tag.index);
+    from = tag.index + tag[0].length;
+    if (tag[1] === void 0) {
+      if (open.pop() === void 0) {
+        throw new Error("Guide has {{/if}} without {{#if}}");
+      }
+      continue;
+    }
+    const names = tag[1].trim().split(/\s+/);
+    for (const name of names) {
+      if (!SURFACES.includes(name)) {
+        throw new Error(`Unknown guide surface "${name}" in ${tag[0]}`);
+      }
+    }
+    open.push(names.includes(surface));
+  }
+  if (open.length > 0) throw new Error("Guide has {{#if}} without {{/if}}");
+  return out + tagged.slice(from);
+}
+function resolve(token, surface, shown) {
+  const body = token.slice(2, -2);
+  if (body === "support") return SUPPORT_EMAIL;
+  const [kind, name, ...rest] = body.split(":");
+  if (name !== void 0 && rest.length === 0) {
+    if (kind === "limit" && Object.hasOwn(LIMITS, name)) {
+      return String(LIMITS[name]);
+    }
+    if (kind === "tool") {
+      const spec = COMMANDS.find((command) => command.name === name);
+      if (spec) return shown ? toolName(spec, surface, token) : token;
+    }
+    if (kind === "arg") {
+      const flags = new Set(
+        COMMANDS.flatMap((command) => command.flags).filter((flag3) => flag3.field === name).map((flag3) => flag3.flag)
+      );
+      const [flag2, ...others] = flags;
+      if (flag2 !== void 0 && others.length === 0) {
+        return surface === "cli" ? `--${flag2}` : name;
+      }
+    }
+  }
+  throw new Error(`Unknown guide token ${token}`);
+}
+function toolName(spec, surface, token) {
+  if (surface === "cli") return `fortrip ${spec.name}`;
+  if (spec.tool === null || surface === "claude-skill" && spec.tool === "get_planning_guide") {
+    throw new Error(`Guide token ${token} has no tool on ${surface}`);
+  }
+  return surface === "mcp" ? spec.tool : `fortrip:${spec.tool}`;
+}
+
+// src/outputs.ts
+import { z as z4 } from "zod";
+var bookingResult = z4.object({
+  agentOrderId: z4.string(),
+  paymentUrl: z4.string().describe(
+    "Fortrip page that recaps the booking and continues to payment. Anyone holding it can pay"
+  ),
+  amount: z4.number().nullable().describe("What the user will be charged, in currency"),
+  currency: z4.string(),
+  orderUrl: z4.string().describe("The signed-in order page"),
+  statusUrl: z4.string().optional().describe("The booking status page; the same page as paymentUrl"),
+  stay: z4.object({
+    hotelId: z4.number(),
+    hotelName: z4.string().nullable(),
+    roomName: z4.string().nullable(),
+    checkIn: z4.string(),
+    checkOut: z4.string(),
+    nights: z4.number(),
+    rooms: z4.number(),
+    adultsPerRoom: z4.number(),
+    childrenAgesPerRoom: z4.array(z4.number())
+  }).describe("The stay as booked; every room has the same occupancy"),
+  terms: z4.object({
+    boardCode: z4.string(),
+    boardCount: z4.number(),
+    refundable: z4.boolean(),
+    freeCancelUntil: z4.string().nullable(),
+    cancellation: z4.array(z4.object({ amount: z4.number(), from: z4.string() })),
+    isInstantConfirm: z4.boolean(),
+    confirmByMins: z4.number().nullable(),
+    payAtHotelFees: z4.array(
+      z4.object({
+        type: z4.string(),
+        isMandatory: z4.boolean(),
+        amount: z4.number(),
+        currency: z4.string()
+      })
+    )
+  }).nullable()
+});
+var meResult = z4.object({
+  userId: z4.string(),
+  email: z4.string().nullable(),
+  name: z4.string().nullable()
+});
+var authConfig = z4.object({
+  issuer: z4.string(),
+  clientId: z4.string(),
+  scopes: z4.string(),
+  deviceAuthorizationEndpoint: z4.string(),
+  tokenEndpoint: z4.string(),
+  revocationEndpoint: z4.string()
+});
+
+// src/paths.ts
+var API = {
+  me: "/api/agent/v1/me",
+  authConfig: "/api/agent/v1/auth/config",
+  search: "/api/agent/v1/hotels/search",
+  rates: "/api/agent/v1/hotels/rates",
+  bookings: "/api/agent/v1/hotels/bookings",
+  mcp: "/api/mcp",
+  hotel(id, includeRooms) {
+    return `/api/agent/v1/hotels/${id}${includeRooms ? "?include=rooms" : ""}`;
+  }
+};
+
+// src/reasons.ts
+var reasonStatuses = {
+  already_booked: [409],
+  price_or_terms_changed: [409],
+  rate_unavailable: [422],
+  refused: [422],
+  supplier_unavailable: [503, 504]
+};
+var ERROR_REASONS = reasonStatuses;
+
+// src/tools.ts
+import { z as z5 } from "zod";
+var MCP_MAX_ROOMS_PER_HOTEL = 5;
+var MCP_RATES_INPUT = getRatesInput.safeExtend({
+  maxRoomsPerHotel: wholeNumber("maxRoomsPerHotel", 1, LIMITS.maxRoomsPerHotel).default(MCP_MAX_ROOMS_PER_HOTEL).describe(
+    `Return the N cheapest rooms per hotel. Defaults to ${MCP_MAX_ROOMS_PER_HOTEL}.`
+  )
+});
+var BOOKING_NEXT_STEP = "Show the user amount, currency, the stay (hotel, room, dates, rooms, guests per room) and every item in terms (meals, cancellation, confirmation, pay-at-hotel fees), then end your reply by asking them to confirm. Only after they say yes, give them paymentUrl exactly as returned.";
+var MCP_BOOKING_RESULT = bookingResult.extend({
+  nextStep: z5.string()
+});
+var MEAL_CODES = "RO room only; BB breakfast; HB breakfast + dinner; FB breakfast + lunch + dinner; BL lunch; BD dinner; HBBL breakfast + lunch; HBLD lunch + dinner; AI all inclusive";
+var TOOLS = [
+  {
+    name: "get_planning_guide",
+    title: "Get hotel planning guide",
+    description: `Returns Fortrip's planning guide for a request that is more than one hotel for fixed dates (flexible dates, a budget, split stays, several destinations, "find me the best"): what to ask the user, which results count as evidence, how to rank and how to present options.`,
+    annotations: {
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false,
+      destructiveHint: false
+    },
+    input: null,
+    output: null
+  },
+  {
+    name: "search_hotels",
+    title: "Search hotels",
+    description: "Find hotels by name/brand/city text (query), catalogue cityCode or coordinates (near), with per-night prices for the dates in currency (CNY by default, or USD). Those prices come from the supplier's minimum-price feed, not live rates; get_rates returns the bookable price. facilities must match catalogue names exactly. Refused (422) when more than 30,000 hotels match: narrow the search.",
+    annotations: {
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true,
+      destructiveHint: false
+    },
+    input: searchHotelsInput,
+    output: null
+  },
+  {
+    name: "get_hotel",
+    title: "Get hotel details",
+    description: "Static catalogue facts for one hotel: address, contact, intro, check-in/out times, policies, facilities and photos. No prices or availability.",
+    annotations: {
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true,
+      destructiveHint: false
+    },
+    input: getHotelInput,
+    output: null
+  },
+  {
+    name: "get_rates",
+    title: "Get live rates",
+    description: `Live rooms and rate plans for up to ${LIMITS.ratesHotels} hotels, prices in currency (CNY by default, or USD) at Stripe's exchange rate. rooms, adults and childrenAges are per room: every room has the same occupancy. Each room carries its catalogue facts (static) and the cheapest rate per meal plan \xD7 free-cancellation variant, with roomId and ratePlanCode for create_booking. boardCode is the meal plan (${MEAL_CODES}); boardCount is how many guests per room it covers: fewer than adults per room means the meals don't cover everyone (BB with boardCount 1 for 2 adults is breakfast for 1 of 2). Takes about 15 seconds; query a few hotels at a time. Returns the ${MCP_MAX_ROOMS_PER_HOTEL} cheapest rooms per hotel unless maxRoomsPerHotel says otherwise.`,
+    annotations: {
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true,
+      destructiveHint: false
+    },
+    input: MCP_RATES_INPUT,
+    output: null
+  },
+  {
+    name: "create_booking",
+    title: "Create booking payment link",
+    description: `Create (or resume) a booking for one rate from get_rates, with the same rooms, adults and childrenAges (per room). Returns the amount and currency the user will be charged, the accepted terms (meal plan, cancellation, confirmation, pay-at-hotel fees), the stay as booked, and paymentUrl: a Fortrip page that recaps the booking and continues to payment. Nothing is charged until the user pays there; anyone holding paymentUrl can pay. The same user and stay always returns the same order; a stay that is already paid returns 409. This tool can't change or cancel a booking: for changes, cancellations or refunds the user emails ${SUPPORT_EMAIL} with the booking's orderUrl. Can take up to about two minutes; if the call times out, call it again with the same details \u2014 it resumes the same order.`,
+    annotations: {
+      readOnlyHint: false,
+      idempotentHint: true,
+      openWorldHint: true,
+      destructiveHint: false
+    },
+    input: createBookingInput,
+    output: MCP_BOOKING_RESULT
+  }
+];
+
+// package.json
+var package_default = {
+  name: "@fortrip/agent-contract",
+  version: "1.0.0",
+  license: "MIT",
+  description: "The contract of Fortrip's agent API (/api/agent/v1): limits, paths, input schemas and field rules.",
+  type: "module",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/FortripEngineering/fortrip.git",
+    directory: "packages/contract"
+  },
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js"
+    },
+    "./guest-name": {
+      types: "./dist/guest-name.d.ts",
+      import: "./dist/guest-name.js"
+    }
+  },
+  files: [
+    "dist"
+  ],
+  sideEffects: false,
+  engines: {
+    node: ">=22"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  scripts: {
+    "embed-guide": "node --import tsx scripts/embed-guide.ts",
+    build: "pnpm embed-guide && tsup",
+    typecheck: "tsc --noEmit",
+    test: "pnpm build && node --import tsx --test test/*.test.ts",
+    prepublishOnly: "pnpm typecheck && pnpm test && pnpm build"
+  },
+  peerDependencies: {
+    zod: "^4.4.0"
+  },
+  devDependencies: {
+    "@types/node": "^22.15.0",
+    tsup: "^8.5.1",
+    tsx: "^4.20.0",
+    typescript: "^5.9.0",
+    zod: "4.4.3"
+  }
+};
+
+// src/version.ts
+var CONTRACT_VERSION = package_default.version;
+export {
+  API,
+  BOARD_CODES,
+  BOOKING_NEXT_STEP,
+  CARD_NUMBER_MESSAGE,
+  COMMANDS,
+  CONTRACT_VERSION,
+  CURRENCIES,
+  ERROR_REASONS,
+  GLOBAL_FLAGS,
+  GUEST_NAME_MESSAGE,
+  GUEST_NAME_PATTERN,
+  GUEST_NAME_TITLE,
+  LIMITS,
+  MCP_BOOKING_RESULT,
+  MCP_RATES_INPUT,
+  SEARCH_SORTS,
+  SUPPORT_EMAIL,
+  TOOLS,
+  addIsoDateDays,
+  authConfig,
+  bookingResult,
+  childrenAges,
+  containsCardNumber,
+  countIsoDateDays,
+  createBookingInput,
+  flag,
+  getHotelInput,
+  getRatesInput,
+  guestNameRe,
+  isIsoDate,
+  isoDate,
+  meResult,
+  nonEmpty,
+  normalizeGuestName,
+  oneOf,
+  positiveId,
+  renderGuide,
+  searchHotelsInput,
+  strictInput,
+  text,
+  wholeNumber
+};