feat(assistant): booking and stay cards, and a read of the bookings with their details

shared/src/reservation/reservation-read.schema.spec.ts

@@ -0,0 +1,25 @@
+import { listAccommodationsRequestSchema, listReservationsRequestSchema } from './reservation-read.schema';
+
+import { describe, expect, it } from 'vitest';
+
+describe('listReservationsRequestSchema', () => {
+  it('RESREAD-001: takes a trip alone, a kind filter and a day', () => {
+    expect(listReservationsRequestSchema.safeParse({ tripId: 3 }).success).toBe(true);
+    expect(listReservationsRequestSchema.safeParse({ tripId: 3, kinds: ['transport'], dayId: 9 }).success).toBe(true);
+    expect(listReservationsRequestSchema.safeParse({ tripId: 3, kinds: ['booking', 'transport'] }).success).toBe(true);
+  });
+
+  it('RESREAD-002: refuses an unknown kind, an empty kind list, a bad id and a missing trip', () => {
+    expect(listReservationsRequestSchema.safeParse({ tripId: 3, kinds: ['hotel'] }).success).toBe(false);
+    expect(listReservationsRequestSchema.safeParse({ tripId: 3, kinds: [] }).success).toBe(false);
+    expect(listReservationsRequestSchema.safeParse({ tripId: 3, dayId: 0 }).success).toBe(false);
+    expect(listReservationsRequestSchema.safeParse({ kinds: ['booking'] }).success).toBe(false);
+  });
+});
+
+describe('listAccommodationsRequestSchema', () => {
+  it('RESREAD-003: takes the trip and nothing else is required', () => {
+    expect(listAccommodationsRequestSchema.safeParse({ tripId: 3 }).success).toBe(true);
+    expect(listAccommodationsRequestSchema.safeParse({ tripId: -1 }).success).toBe(false);
+  });
+});

shared/src/reservation/reservation-read.schema.ts

@@ -0,0 +1,37 @@
+import { idSchema } from '../common/primitives.schema';
+
+import { z } from 'zod';
+
+/**
+ * The trip reads of the bookings an assistant makes over MCP. `get_trip_summary`
+ * carries every booking with its metadata, which the provider never sees (a
+ * flight number or a seat lives there); these two answer the bookings and the
+ * stays alone, with the readable details pulled out of the metadata.
+ */
+
+/** What a booking is, as a filter: getting there (a flight, a train, a hire car) or anything booked on the way. */
+export const RESERVATION_READ_KINDS = ['transport', 'booking'] as const;
+export type ReservationReadKind = (typeof RESERVATION_READ_KINDS)[number];
+
+/** `list_reservations`: the trip's bookings, of one kind or both, on one day or all of them. */
+export const listReservationsRequestSchema = z.object({
+  tripId: idSchema,
+  kinds: z
+    .array(z.enum(RESERVATION_READ_KINDS))
+    .min(1)
+    .max(RESERVATION_READ_KINDS.length)
+    .optional()
+    .describe(
+      'Only these kinds: "transport" (flights, trains, hire cars and other rides) or "booking" (hotels, tables, tickets). Both when left out.',
+    ),
+  dayId: idSchema
+    .optional()
+    .describe(
+      'Only the bookings on this day: those that start or end on it, a stopover leg on it, or a stay checking in on it.',
+    ),
+});
+export type ListReservationsRequest = z.infer<typeof listReservationsRequestSchema>;
+
+/** `list_accommodations`: where the trip sleeps, stay by stay. */
+export const listAccommodationsRequestSchema = z.object({ tripId: idSchema });
+export type ListAccommodationsRequest = z.infer<typeof listAccommodationsRequestSchema>;