@curless/hotel-storefront 0.21.1 → 0.22.0

package/dist/tools.js

@@ -61,6 +61,8 @@ const cancels = (title, openWorld) => ({
     openWorldHint: openWorld,
 });
 const DATE = (what) => ({ type: 'string', description: `${what}, as YYYY-MM-DD` });
+/** How many ${nounPlural} one look-up reads - a city's worth, and what a comparison can hold and then some. */
+export const LOOK_UP_MAX = 6;
 export const buildTools = (n, v) => {
     const open = !v.demo;
     const stayProps = {
@@ -132,7 +134,7 @@ export const buildTools = (n, v) => {
         },
         {
             name: n.getHotel,
-            description: `One ${v.noun} 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. \`rooms\` leaves out the types that have fewer than that many. Without dates it returns the ${v.noun} only, because a room has no price until the nights are known.${v.hints.hotel ? ` ${v.hints.hotel}` : ''}`,
+            description: `One ${v.noun} 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. \`rooms\` leaves out the types that have fewer than that many. Without dates it returns the ${v.noun} only, because a room has no price until the nights are known. The ${v.noun} is drawn as a card for the guest to look at.${v.hints.hotel ? ` ${v.hints.hotel}` : ''}`,
             annotations: reads(`View one ${v.brand} ${v.noun}`, open),
             inputSchema: {
                 type: 'object',
@@ -150,9 +152,39 @@ export const buildTools = (n, v) => {
                 required: ['hotel'],
             },
         },
+        {
+            name: n.lookUp,
+            // ⚠️ THE ONE READING TOOL THAT DRAWS NOTHING. Every other one renders a
+            // card on every call, so a model reading up before it answered - list
+            // the city, open four hotels, then compare - put six cards in front of
+            // the guest for one question (robin, 2026-09-29, Opus in Claude.ai). The
+            // reference apps do the same split: search without a card, present with
+            // one.
+            description: `Reads up to ${LOOK_UP_MAX} ${v.nounPlural} - a \`city\`'s (or a country's), or the ones named in \`${v.nounPlural}\` - and returns them as text, with nothing drawn and nothing shown to the guest: each one's id, area, rating, description and amenities, its add-ons with their ids and prices, and, given \`checkIn\` and \`checkOut\`, its rooms priced for those nights with taxes in. The ids are the ones a comparison and a plan take.`,
+            annotations: reads(`Look up ${v.brand} ${v.nounPlural}`, open),
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    city: {
+                        type: 'string',
+                        description: `A city or a country: its ${v.nounPlural}, up to ${LOOK_UP_MAX}`,
+                    },
+                    [v.nounPlural]: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: `Up to ${LOOK_UP_MAX} ${v.nounPlural} by name or id; these are read when both are given`,
+                    },
+                    ...stayProps,
+                    rooms: {
+                        type: 'number',
+                        description: `How many rooms of one type, 1 to ${MAX_ROOMS_PER_LINE}. Default 1`,
+                    },
+                },
+            },
+        },
         {
             name: n.listExtras,
-            description: `What one ${v.noun} 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.`,
+            description: `What one ${v.noun} 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, drawn as a card for the guest to look at.`,
             annotations: reads(`${v.brand} add-ons`, open),
             inputSchema: {
                 type: 'object',
@@ -771,6 +803,22 @@ export const buildOutputSchemas = (n) => ({
         },
         required: ['view'],
     },
+    // What was read, by id - the substance is the text, which is what the model
+    // plans from, and a second copy of it here would be read twice.
+    [n.lookUp]: {
+        type: 'object',
+        properties: {
+            view: { enum: ['look-up', 'nothing-found'] },
+            brand: STR,
+            toolNames: OBJ,
+            demo: BOOL,
+            hotels: ARR,
+            stay: OBJ,
+            total: { type: 'number' },
+            dropped: ARR,
+        },
+        required: ['view'],
+    },
     [n.policies]: {
         type: 'object',
         properties: {
@@ -1976,6 +2024,112 @@ const answerTool = async (deps, name, rawArgs, ctx) => {
                 .join('\n'),
         };
     }
+    if (name === t.lookUp) {
+        const stay = asStay(args);
+        const who = identity(deps, ctx, key);
+        const roomsWanted = Math.max(1, Math.min(MAX_ROOMS_PER_LINE, Math.floor(Number(args.rooms) || 1)));
+        const asked = args[deps.vocab.nounPlural];
+        const named = (Array.isArray(asked) ? asked : [])
+            .map((x) => str(x))
+            .filter(Boolean)
+            .slice(0, LOOK_UP_MAX);
+        const city = str(args.city);
+        const ids = [];
+        const dropped = [];
+        let total = 0;
+        if (named.length) {
+            for (const ref of named) {
+                const found = await deps.backend.getHotel(ref);
+                if (found)
+                    ids.push(found.hotel.id);
+                else
+                    dropped.push(ref);
+            }
+            total = ids.length;
+        }
+        else if (city) {
+            const found = await deps.backend.searchHotels({ city, limit: LOOK_UP_MAX }, who);
+            ids.push(...found.hotels.map((h) => h.id));
+            total = found.total;
+        }
+        const unique = [...new Set(ids)];
+        if (unique.length === 0) {
+            return {
+                structured: {
+                    view: 'nothing-found',
+                    ...common(deps, key),
+                    ...(dropped.length ? { dropped } : {}),
+                },
+                text: city
+                    ? `No ${deps.vocab.brand} ${deps.vocab.nounPlural} in "${city}". ${t.listHotels} with no place shows the places there are.`
+                    : named.length
+                        ? `No ${deps.vocab.brand} ${deps.vocab.noun} answers to ${dropped.map((d) => `"${d}"`).join(', ')}.`
+                        : `Name a \`city\`, or up to ${LOOK_UP_MAX} ${deps.vocab.nounPlural} in \`${deps.vocab.nounPlural}\`.`,
+            };
+        }
+        const blocks = [];
+        const read = [];
+        for (const id of unique) {
+            const detail = await deps.backend.getHotel(id, stay, who);
+            if (!detail)
+                continue;
+            const h = detail.hotel;
+            read.push({ id: h.id, name: h.name });
+            const about = hotelText('description', h.name, [h.summary, h.amenities.length ? `Has: ${h.amenities.join(', ')}.` : '']
+                .filter(Boolean)
+                .join('\n'), DESCRIPTION_MAX, deps.vocab.demo);
+            const extras = await deps.backend.extrasFor(h.id, stay);
+            const rooms = (detail.rooms ?? []).filter((r) => r.roomsLeft >= roomsWanted);
+            blocks.push([
+                `### ${h.name} · id \`${h.id}\``,
+                [
+                    [h.area, h.city, h.country].filter(Boolean).join(', '),
+                    h.brand,
+                    h.rating ? `${h.rating.value}/${h.rating.scaleMax} from ${h.rating.count} reviews` : '',
+                ]
+                    .filter(Boolean)
+                    .join(' · '),
+                about.fenced,
+                !stay
+                    ? h.fromNightly
+                        ? `From ${formatMoney(h.fromNightly)} a night; rooms are priced once there are dates.`
+                        : ''
+                    : rooms.length
+                        ? [
+                            `Rooms for ${stay.checkIn} to ${stay.checkOut}, ${stay.guests} guests${roomsWanted > 1 ? `, ${roomsWanted} rooms` : ''}:`,
+                            ...rooms.map((r) => `- ${r.name} · sleeps ${r.sleeps}${r.breakfast ? ' · breakfast' : ''} · ${formatMoney(r.stayTotal)} for the stay incl. taxes and fees${r.freeCancellationUntil ? `, free to cancel until ${r.freeCancellationUntil.slice(0, 10)}` : r.refundable ? '' : ', non-refundable'}`),
+                        ].join('\n')
+                        : (detail.noRooms ?? `No room type here has ${roomsWanted} left for those nights.`),
+                extras.length
+                    ? `Add-ons: ${extras.map((e) => `${e.name} (id \`${e.id}\`, ${formatMoney(e.price)} per ${e.per}${e.when && e.when !== 'any' ? `, on ${e.when}` : ''})`).join('; ')}`
+                    : '',
+            ]
+                .filter(Boolean)
+                .join('\n'));
+        }
+        return {
+            structured: {
+                view: 'look-up',
+                ...common(deps, key),
+                hotels: read,
+                ...(stay ? { stay } : {}),
+                total,
+                ...(dropped.length ? { dropped } : {}),
+            },
+            text: [
+                `Read ${read.length}${total > read.length ? ` of ${total}` : ''} ${read.length === 1 ? deps.vocab.noun : deps.vocab.nounPlural}. Nothing was shown to the guest.`,
+                ...blocks,
+                dropped.length ? `Not found: ${dropped.map((d) => `"${d}"`).join(', ')}.` : '',
+                total > read.length
+                    ? `${total - read.length} more ${total - read.length === 1 ? 'is' : 'are'} there; name ${total - read.length === 1 ? 'it' : 'them'} in \`${deps.vocab.nounPlural}\` to read ${total - read.length === 1 ? 'it' : 'them'}.`
+                    : '',
+                `If the answer is a comparison, a recommendation or a plan, draw it now as ONE ${t.compare} or ${t.itinerary} call with these ids - not with ${t.listHotels}, ${t.getHotel} or ${t.listExtras}, which each draw another card.`,
+                deps.vocab.demo ? DEMO_NOTE : '',
+            ]
+                .filter(Boolean)
+                .join('\n\n'),
+        };
+    }
     if (name === t.listExtras) {
         // ⚠️ AN ADD-ON FOR A BOOKING ALREADY MADE (robin, 2026-09-28). Add-ons
         // could only go in the trip before the request; once booked, an airport