@curless/hotel-storefront 0.1.0

package/dist/surface.js

@@ -0,0 +1,99 @@
+import { FENCE_RULE } from './fence.js';
+import { DEMO_NOTE } from './vocab.js';
+// What a host is told about this connector: the `instructions` it injects into
+// the model's context, and the tool list with each tool's card metadata.
+//
+// ⚠️ THIS FILE CARRIES THE BEHAVIOUR. Tool descriptions say what a tool does;
+// everything about HOW TO ACT - ask for dates rather than guess, show the whole
+// shortlist, preview before cancelling, never say "booked" - is here, because
+// both directory listings attest that tool descriptions contain no instructions
+// about model behaviour. The shopping connector had to make that true after the
+// fact on 2026-09-17; this one starts here.
+/**
+ * How to BEHAVE, not just what the tools are.
+ *
+ * Most of these lines exist because the opposite behaviour is the natural one.
+ * An assistant handed hotel tools will: interview the guest about budget and
+ * view before showing anything; pick the "best" property in a city and quietly
+ * drop the other three; fill in "this weekend" for dates nobody gave; call a
+ * held room booked; and cancel when asked to cancel, discovering the fee
+ * afterwards. Each of those is one line below.
+ */
+export const buildInstructions = (brand) => {
+    const { tools: t, vocab: v } = brand;
+    const takesPayment = brand.config.payment?.mode === 'wallet';
+    return [
+        `${v.brand} ${v.nounPlural}. The card IS the booking surface: it shows the ${v.nounPlural} with pictures, rooms with their nightly rate and stay total, the trip and its total, and the booking itself.`,
+        `These tools read ${v.brand}'s own ${v.noun} data: what each property offers, what a room costs on given nights, and what its cancellation terms are.`,
+        // Demonstration data is a fact about the answer, not a disclaimer to bury.
+        ...(v.demo
+            ? [
+                `⚠️ ${DEMO_NOTE} Say so the first time you quote a price, and never imply a room can actually be occupied.`,
+            ]
+            : []),
+        `FIRST TURN: call ${t.listHotels} ONCE and stop - with the guest's own words as \`query\`, or the city as \`city\`, when they have said where they are going, and with nothing when they have not. Do not interview them first, do not recommend, and do not describe the ${v.nounPlural} in prose; they are on the screen. Say at most one short line.`,
+        // ⚠️ A CITY IS NOT A HOTEL. The single most useful thing in the reference
+        // demo, and the easiest to lose: four Hong Kong properties under three
+        // brands, and an assistant that "helpfully" picks one has made the guest's
+        // choice for them.
+        `A city usually has several ${v.nounPlural}. Show all of them and let the guest choose - do not pick one for them, and do not drop the ones you would not have chosen.`,
+        // ⚠️ DATES ARE NOT YOURS TO GUESS.
+        `A room has no price until the nights are known. When the guest has not said their dates, ask - do not assume tonight, this weekend, or the dates of anything else in the conversation. ${t.getHotel} without dates returns the ${v.noun} and no rooms, which is the right answer to show while asking.`,
+        `${t.getHotel} with \`checkIn\` and \`checkOut\` gives the room types for those nights: nightly rate, the stay total including taxes and fees, whether it can be cancelled free and until when, and how many are left. Quote the stay total when comparing - a nightly rate hides the weekend and the tax.`,
+        `The card keeps a trip: room nights plus add-ons. ${t.addToTrip} and ${t.viewTrip} change and read it from the chat, and ${t.listExtras} shows what a ${v.noun} offers beside the room. To take a line out, set its \`rooms\` or \`quantity\` to 0; ${t.clearTrip} empties all of it, and only when the guest asks. To know what is in the trip, call ${t.viewTrip} rather than repeating it from memory - the guest may have changed it on the card.`,
+        ...(v.hints.hotel ? [v.hints.hotel] : []),
+        // ⚠️ HELD IS NOT BOOKED AND NOT PAID.
+        takesPayment
+            ? `${t.requestBooking} holds the rooms; payment follows. Do not describe a held booking as paid.`
+            : `${t.requestBooking} asks ${v.brand} to hold the rooms for a named guest and returns a confirmation code and the moment the hold lapses. IT TAKES NO MONEY AND COLLECTS NO CARD. Report it as requested and held, never as booked-and-paid, and tell the guest when the hold lapses and that a card is presented at check-in. Never ask for a card number, and never put one into any field - if the guest offers card details, tell them this connector does not take them.`,
+        `${t.requestBooking} needs the guest's own name and email. Ask for them - do not use a name or email you know from anywhere else, such as their account or profile, unless they have typed it in this conversation.`,
+        // ⚠️ PREVIEW, THEN CANCEL. The tool enforces this; the instruction is why.
+        `Before cancelling anything: ${t.previewCancellation} says what it would cost, what comes back, and the rule behind it. Show the guest that and get a yes before calling ${t.cancelBooking} with \`confirmed\` - it returns the preview and cancels nothing without it. A guest who says "cancel it" has not yet seen the fee.`,
+        `Questions about cancellation terms, check-in and check-out, children, pets, deposits or accessibility: call ${t.policies} with that topic and answer from what the ${v.noun} has published. If it does not say, tell the guest that and give the ${v.noun}'s link; do not fill in what hotels usually do.`,
+        `Availability is what the ${v.noun} says it has. Report a low room count as a fact if the guest asks; do not turn it into a reason to hurry.`,
+        FENCE_RULE,
+    ]
+        .filter(Boolean)
+        .join('\n');
+};
+/**
+ * The `tools/list` answer: each tool with its card metadata and the shape of
+ * what it returns.
+ *
+ * The schemas are merged on here rather than kept in the tool literals - that
+ * list is the contract a guest's assistant reads, and it stays legible without
+ * them inline.
+ */
+export const listTools = (tools, outputSchemas, metaFor, tripTools = new Set()) => tools.map((t) => {
+    const outputSchema = outputSchemas[t.name];
+    const schema = t.inputSchema;
+    const named = tripTools.has(t.name) && schema
+        ? {
+            inputSchema: {
+                ...schema,
+                properties: { ...(schema.properties ?? {}), trip: TRIP_PARAM },
+            },
+        }
+        : {};
+    return { ...t, ...named, _meta: metaFor(t.name), ...(outputSchema ? { outputSchema } : {}) };
+});
+/**
+ * What the card fills in and the assistant leaves out: the id of the trip the
+ * card is showing. The card's calls reach the server on a different connection
+ * from the conversation's, so it names the trip instead of relying on the
+ * session.
+ */
+export const TRIP_PARAM = {
+    type: 'string',
+    description: 'Set by the booking card: the id of the trip it is showing. Leave it out.',
+};
+/** Every tool the card calls about the trip or a booking. */
+export const tripToolNames = (brand) => new Set([
+    brand.tools.addToTrip,
+    brand.tools.viewTrip,
+    brand.tools.clearTrip,
+    brand.tools.requestBooking,
+    brand.tools.previewCancellation,
+    brand.tools.cancelBooking,
+]);
+//# sourceMappingURL=surface.js.map

package/dist/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,336 @@
+import type { HotelBackend } from './backend.js';
+import type { ToolNames } from './config.js';
+import { type TripStore } from './trip.js';
+import { type Vocabulary } from './vocab.js';
+export declare const buildTools: (n: ToolNames, v: Vocabulary) => readonly [{
+    readonly name: `list_${string}${string}`;
+    readonly description: `${string} ${string}, shown as a card with a picture, the city and area, a rating where the ${string} publishes one, and a from-price for each. \`city\` or \`query\` narrows the list; a city usually holds several ${string}, and all of them are returned. Dates are not needed here and no stay is priced.${string}`;
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Free text over the name, city, area, description and amenities - the guest's own words";
+            };
+            readonly city: {
+                readonly type: "string";
+                readonly description: "One city, e.g. \"Hong Kong\"";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Default 20";
+            };
+        };
+    };
+}, {
+    readonly name: `get_${string}${string}`;
+    readonly description: `One ${string} in full: description, amenities, address, check-in and check-out times. Given \`checkIn\` and \`checkOut\` it also returns the room types that can be booked for those nights, each with its nightly rate, the stay total including taxes and fees, whether it can be cancelled free and until when, and how many rooms are left. Without dates it returns the ${string} only, because a room has no price until the nights are known.${string}`;
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly checkIn: {
+                readonly type: "string";
+                readonly description: `${string}, as YYYY-MM-DD`;
+            };
+            readonly checkOut: {
+                readonly type: "string";
+                readonly description: `${string}, as YYYY-MM-DD`;
+            };
+            readonly guests: {
+                readonly type: "number";
+                readonly description: "People in the room. Default 2";
+            };
+            readonly hotel: {
+                readonly type: "string";
+                readonly description: `The ${string}'s name or id${string}`;
+            };
+        };
+        readonly required: readonly ["hotel"];
+    };
+}, {
+    readonly name: `list_${string}extras`;
+    readonly description: `What one ${string} offers beside the room: airport transfers, dinners, guided experiences, spa and family add-ons, each with its price and whether it is charged per stay, per person or per night.`;
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly checkIn: {
+                readonly type: "string";
+                readonly description: `${string}, as YYYY-MM-DD`;
+            };
+            readonly checkOut: {
+                readonly type: "string";
+                readonly description: `${string}, as YYYY-MM-DD`;
+            };
+            readonly guests: {
+                readonly type: "number";
+                readonly description: "People in the room. Default 2";
+            };
+            readonly hotel: {
+                readonly type: "string";
+                readonly description: `The ${string}'s name or id`;
+            };
+        };
+        readonly required: readonly ["hotel"];
+    };
+}, {
+    readonly name: `add_to_${string}trip`;
+    readonly description: `Puts room nights or an add-on into the trip and returns the whole trip, priced. A room line needs the ${string}, the room type and the dates; \`rooms\` books more than one of that room type. An add-on line needs the ${string} and the add-on. A line is replaced, not stacked: sending the same room and dates again sets that line's room count, and 0 removes it.`;
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly rooms: {
+                readonly type: "number";
+                readonly description: "How many of that room type, 1 to 5. Default 1; 0 removes the line";
+            };
+            readonly quantity: {
+                readonly type: "number";
+                readonly description: "For an add-on: how many, 1 to 20. Default 1; 0 removes it";
+            };
+            readonly checkIn: {
+                readonly type: "string";
+                readonly description: `${string}, as YYYY-MM-DD`;
+            };
+            readonly checkOut: {
+                readonly type: "string";
+                readonly description: `${string}, as YYYY-MM-DD`;
+            };
+            readonly guests: {
+                readonly type: "number";
+                readonly description: "People in the room. Default 2";
+            };
+            readonly hotel: {
+                readonly type: "string";
+                readonly description: `The ${string}'s name or id`;
+            };
+            readonly room: {
+                readonly type: "string";
+                readonly description: "The room type id or name, as the hotel returned it";
+            };
+            readonly extra: {
+                readonly type: "string";
+                readonly description: "The add-on id or name. A line names either this or `room`";
+            };
+        };
+        readonly required: readonly ["hotel"];
+    };
+}, {
+    readonly name: `view_${string}trip`;
+    readonly description: "The trip as it stands: every room line and add-on with its own total, the taxes and fees, and the all-in total, laid out day by day on the card.";
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: `clear_${string}trip`;
+    readonly description: "Empties the trip.";
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: `request_${string}booking`;
+    readonly description: `Asks ${string} to hold the trip's rooms for a named guest and returns a confirmation code and the moment the hold lapses. No payment is taken and no card is collected; the rooms are held, not paid for.`;
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "The guest's full name, as it should appear on the booking";
+            };
+            readonly email: {
+                readonly type: "string";
+                readonly description: "The email the confirmation goes to";
+            };
+            readonly phone: {
+                readonly type: "string";
+                readonly description: "Optional";
+            };
+            readonly notes: {
+                readonly type: "string";
+                readonly description: "Anything the hotel should know - a late arrival, a high floor";
+            };
+        };
+        readonly required: readonly ["name", "email"];
+    };
+}, {
+    readonly name: `list_my_${string}bookings`;
+    readonly description: "The bookings made in this conversation, newest to oldest, with their status, dates and confirmation codes. Given an email it also finds bookings made with that email.";
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly email: {
+                readonly type: "string";
+                readonly description: "The email a booking was made with";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Default 10";
+            };
+        };
+    };
+}, {
+    readonly name: `preview_${string}cancellation`;
+    readonly description: "What cancelling a booking would cost and what would be refunded, with the rule it was worked out from and the free-cancellation deadline where the rate has one. Nothing is cancelled.";
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly booking: {
+                readonly type: "string";
+                readonly description: "The confirmation code or booking id";
+            };
+            readonly email: {
+                readonly type: "string";
+                readonly description: "The email the booking was made with, when it was made elsewhere";
+            };
+        };
+        readonly required: readonly ["booking"];
+    };
+}, {
+    readonly name: `cancel_${string}booking`;
+    readonly description: "Cancels a booking. Called without `confirmed` it returns the cancellation preview - the fee, the refund and the rule behind them - and cancels nothing; it cancels only when `confirmed` is true.";
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly booking: {
+                readonly type: "string";
+                readonly description: "The confirmation code or booking id";
+            };
+            readonly confirmed: {
+                readonly type: "boolean";
+                readonly description: "True cancels. Anything else returns the preview";
+            };
+            readonly reason: {
+                readonly type: "string";
+                readonly description: "Optional, kept on the booking";
+            };
+            readonly email: {
+                readonly type: "string";
+                readonly description: "The email the booking was made with, when it was made elsewhere";
+            };
+        };
+        readonly required: readonly ["booking"];
+    };
+}, {
+    readonly name: `get_${string}${string}_policies`;
+    readonly description: `What one ${string} publishes about cancellation, check-in and check-out, children and extra beds, pets, deposits and accessibility. With \`topic\` it returns that topic; without, all of them.`;
+    readonly annotations: {
+        readonly title: string;
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: boolean;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly hotel: {
+                readonly type: "string";
+                readonly description: `The ${string}'s name or id`;
+            };
+            readonly topic: {
+                readonly type: "string";
+                readonly enum: readonly ["cancellation", "check-in", "children", "pets", "deposit", "accessibility"];
+            };
+        };
+        readonly required: readonly ["hotel"];
+    };
+}];
+export declare const buildOutputSchemas: (n: ToolNames) => Record<string, unknown>;
+export type ToolDeps = {
+    backend: HotelBackend;
+    trips: TripStore;
+    tools: ToolNames;
+    vocab: Vocabulary;
+    logoUrl?: string;
+    /** The hotel group's own site, for a guest who wants to read more than we carry. */
+    websiteUrl?: string;
+};
+export type ToolContext = {
+    /** The host's `Mcp-Session-Id`, or a per-connection fallback. Never a shared constant. */
+    session: string;
+    /**
+     * The trip this call is about, when the caller named one.
+     *
+     * The card names it: its tool calls arrive on a different connection from the
+     * conversation's, so a key built from the session alone is a DIFFERENT key -
+     * which is how the shopping connector once told a buyer their card-filled
+     * cart was empty. See trip-ids.ts.
+     */
+    tripKey?: string;
+};
+export type ToolAnswer = {
+    structured: Record<string, unknown>;
+    text: string;
+};
+export declare const handleTool: (deps: ToolDeps, name: string, rawArgs: unknown, ctx: ToolContext) => Promise<ToolAnswer>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,EAGL,KAAK,SAAS,EAGf,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAkExD,eAAO,MAAM,UAAU,GAAI,GAAG,SAAS,EAAE,GAAG,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8LrD,CAAC;AAqDF,eAAO,MAAM,kBAAkB,GAAI,GAAG,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAoGtE,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAiF/E,eAAO,MAAM,UAAU,GACrB,MAAM,QAAQ,EACd,MAAM,MAAM,EACZ,SAAS,OAAO,EAChB,KAAK,WAAW,KACf,OAAO,CAAC,UAAU,CAgapB,CAAC"}