@jsm-mit/sultana-agent-tools-package 0.2.0 → 0.4.0

package/dist/customer/tools.js

@@ -0,0 +1,415 @@
+import { toToolError } from "../errors.js";
+import { ArgumentError, readBoolean, readOptionalNumber, readOptionalString, readString } from "../tools/args.js";
+import { writeGate } from "../tools/write-gate.js";
+import { err, ok } from "../types.js";
+import { foldStartRanges, freeStartMinutes, hostTimeZoneProblem, isDay, localDayOf, localStampOf, localTimeOf, minutesOf, momentOf, onSlotGrid, timeOfMinutes, } from "./time.js";
+const DEFAULT_RADIUS_KM = 10;
+const MAX_RADIUS_KM = 50;
+const MAX_SALONS_SHOWN = 6;
+const MAX_TIMES_SHOWN = 6;
+/** "Pick a time": the asked moment, a little before it and the hour after it. */
+const AROUND_TIME_MINUTES = [-30, -15, 0, 15, 30, 45, 60];
+const CONFIRMED_FIELD = {
+    type: "boolean",
+    description: "false = pokaż podgląd bez zapisu; true = wykonaj, dopiero po zgodzie klienta w jego następnej wiadomości.",
+};
+const NO_LOCATION = "Aplikacja nie podała pozycji klienta, więc nie wiem, gdzie szukać. Poproś klienta, żeby włączył lokalizację w aplikacji i otworzył czat ponownie.";
+/** Refuses every time-dependent tool while the host clock runs in the wrong zone. */
+function zoneRefusal(context) {
+    if (!context.timeZone)
+        return null;
+    const problem = hostTimeZoneProblem(context.timeZone, context.now());
+    return problem ? err("unavailable", `Rezerwacje są chwilowo wyłączone: ${problem}.`) : null;
+}
+function readDay(args, key) {
+    const day = readString(args, key);
+    if (!isDay(day))
+        throw new ArgumentError(`Pole "${key}" musi być datą w formacie RRRR-MM-DD.`);
+    return day;
+}
+function readTimeMinutes(args, key) {
+    const minutes = minutesOf(readString(args, key));
+    if (minutes === null)
+        throw new ArgumentError(`Pole "${key}" musi być godziną w formacie GG:MM.`);
+    return minutes;
+}
+function serviceLine(service) {
+    return { serviceId: service.id, name: service.name, pricePln: service.pricePln, durationMinutes: service.durationMinutes };
+}
+export function searchSlotsTool(context) {
+    const { port } = context;
+    return {
+        name: "search_slots",
+        progress: "Szukam wolnych terminów w okolicy…",
+        description: "Szuka salonów w okolicy klienta, które mają wolny termin na usługę danego typu. Bez date i time szuka „jak najszybciej” (najbliższa godzina, a gdy nic nie ma — do 24 godzin naprzód). Z date i time sprawdza okolice tej godziny (pół godziny wcześniej do godziny później). Zwraca salony z usługami (serviceId, cena, czas) i wolnymi terminami. serviceTypeId weź z find_service_type.",
+        parameters: {
+            type: "object",
+            properties: {
+                serviceTypeId: { type: "string", description: "Id typu usługi z find_service_type." },
+                date: { type: "string", description: "Dzień RRRR-MM-DD. Pomiń razem z time, żeby szukać jak najszybciej." },
+                time: { type: "string", description: "Godzina GG:MM. Wymagana, gdy podajesz date." },
+                radiusKm: { type: "number", description: `Promień szukania w km, domyślnie ${DEFAULT_RADIUS_KM}, najwyżej ${MAX_RADIUS_KM}.` },
+            },
+            required: ["serviceTypeId"],
+            additionalProperties: false,
+        },
+        execute: async (args) => {
+            try {
+                const refusal = zoneRefusal(context);
+                if (refusal)
+                    return refusal;
+                if (!port.location)
+                    return err("invalid_arguments", NO_LOCATION);
+                const serviceTypeId = readString(args, "serviceTypeId");
+                const radiusKm = Math.min(Math.max(readOptionalNumber(args, "radiusKm") ?? DEFAULT_RADIUS_KM, 1), MAX_RADIUS_KM);
+                const dayText = readOptionalString(args, "date");
+                const timeText = readOptionalString(args, "time");
+                const now = context.now();
+                if ((dayText === undefined) !== (timeText === undefined)) {
+                    throw new ArgumentError("Podaj date i time razem albo pomiń oba (jak najszybciej).");
+                }
+                let found;
+                let lead;
+                if (dayText === undefined) {
+                    found = await port.searchAsap(serviceTypeId, radiusKm, now);
+                    lead = found.phase === "extended" ? "W najbliższej godzinie nic wolnego, na które klient zdąży. Najbliższe terminy:" : "Najbliższe wolne terminy:";
+                }
+                else {
+                    const day = readDay(args, "date");
+                    const at = readTimeMinutes(args, "time");
+                    const moments = AROUND_TIME_MINUTES.map((shift) => momentOf(day, at) + shift * 60_000)
+                        // Only moments of the asked day's grid that are still ahead.
+                        .filter((moment) => moment > now.getTime() && onSlotGrid(new Date(moment).getMinutes()));
+                    if (moments.length === 0)
+                        return err("invalid_arguments", "Ten termin już minął. Zapytaj klienta o późniejszy.");
+                    found = await port.searchAtMoments(serviceTypeId, radiusKm, moments);
+                    lead = `Wolne terminy w okolicach ${day} ${timeOfMinutes(at)}:`;
+                }
+                if (found.salons.length === 0) {
+                    if (found.failedProbes > 0)
+                        return err("unavailable", "Nie udało się sprawdzić terminów — kanister nie odpowiadał. Spróbuj ponownie za chwilę.");
+                    return ok(`Nic wolnego w promieniu ${radiusKm} km. Zaproponuj inną godzinę, inny dzień albo większy promień.`, []);
+                }
+                const ranked = [...found.salons].sort(bySoonestThenNearest).slice(0, MAX_SALONS_SHOWN);
+                const names = new Map((await port.getSalons(ranked.map((salon) => salon.salonId))).map((salon) => [salon.id, salon]));
+                const data = ranked.map((salon) => ({
+                    salonId: salon.salonId,
+                    name: names.get(salon.salonId)?.name ?? "Salon",
+                    address: names.get(salon.salonId)?.address ?? "",
+                    distanceKm: Math.round(salon.distanceKm * 10) / 10,
+                    services: salon.services.map(serviceLine),
+                    freeAt: salon.availableAt.slice(0, MAX_TIMES_SHOWN).map(localStampOf),
+                }));
+                const more = found.salons.length > ranked.length ? ` Pokazuję ${ranked.length} z ${found.salons.length} salonów.` : "";
+                return ok(`${lead} ${ranked.length} salon(y).${more} Terminy to początek wizyty; inne godziny w danym salonie sprawdź przez get_free_times.`, data);
+            }
+            catch (error) {
+                if (error instanceof ArgumentError)
+                    return err("invalid_arguments", error.message);
+                return toToolError(error, "Nie udało się wyszukać terminów.");
+            }
+        },
+    };
+}
+function firstMoment(salon) {
+    return salon.soonestAt ?? salon.availableAt[0] ?? Number.MAX_SAFE_INTEGER;
+}
+function bySoonestThenNearest(a, b) {
+    return firstMoment(a) - firstMoment(b) || a.distanceKm - b.distanceKm;
+}
+export function getSalonTool(context) {
+    const { port } = context;
+    return {
+        name: "get_salon",
+        progress: "Sprawdzam salon…",
+        description: "Zwraca salon: nazwę, adres, AKTYWNE usługi z cenami (serviceId) i aktywne promocje z kodami rabatowymi. salonId weź z search_slots albo list_my_appointments.",
+        parameters: {
+            type: "object",
+            properties: { salonId: { type: "string", description: "Id salonu." } },
+            required: ["salonId"],
+            additionalProperties: false,
+        },
+        execute: async (args) => {
+            try {
+                const salonId = readString(args, "salonId");
+                const [salon] = await port.getSalons([salonId]);
+                if (!salon)
+                    return err("not_found", "Nie ma takiego salonu. Id weź z search_slots.");
+                const [services, promos] = await Promise.all([port.listSalonServices(salonId), port.listSalonPromos(salonId)]);
+                return ok(`${salon.name}, ${salon.address}: ${services.length} usług(i), ${promos.length} promocji.`, {
+                    salonId,
+                    name: salon.name,
+                    address: salon.address,
+                    services: services.map(serviceLine),
+                    promos,
+                });
+            }
+            catch (error) {
+                if (error instanceof ArgumentError)
+                    return err("invalid_arguments", error.message);
+                return toToolError(error, "Nie udało się odczytać salonu.");
+            }
+        },
+    };
+}
+/** The salon's active service, or the tool error that says why not. */
+async function findService(port, salonId, serviceId) {
+    const services = await port.listSalonServices(salonId);
+    const service = services.find((candidate) => candidate.id === serviceId);
+    if (!service)
+        return err("not_found", "Ten salon nie ma takiej aktywnej usługi. Id salonu i usługi weź z search_slots albo get_salon.");
+    if (service.workerIds.length === 0)
+        return err("not_found", `Usługi „${service.name}” nikt teraz nie wykonuje — nie da się jej zarezerwować.`);
+    return service;
+}
+/** Free start minutes of a service on a day → the first worker free then (the app's rule). */
+async function freeStartsByWorker(port, service, day) {
+    const perWorker = await Promise.all(service.workerIds.map(async (workerId) => {
+        try {
+            return { workerId, starts: freeStartMinutes(await port.freeWindows(service.salonId, workerId, day), service.durationMinutes) };
+        }
+        catch {
+            // A worker with no hours that day is refused by the canister; the others still count.
+            return { workerId, starts: [] };
+        }
+    }));
+    const workerAt = new Map();
+    for (const { workerId, starts } of perWorker) {
+        for (const start of starts)
+            if (!workerAt.has(start))
+                workerAt.set(start, workerId);
+    }
+    return workerAt;
+}
+export function getFreeTimesTool(context) {
+    const { port } = context;
+    return {
+        name: "get_free_times",
+        progress: "Sprawdzam wolne godziny…",
+        description: "Zwraca wolne godziny rozpoczęcia jednej usługi w jednym salonie w danym dniu, jako przedziały (wizyta może zacząć się co 5 minut od from do to włącznie).",
+        parameters: {
+            type: "object",
+            properties: {
+                salonId: { type: "string", description: "Id salonu." },
+                serviceId: { type: "string", description: "Id usługi z search_slots albo get_salon." },
+                date: { type: "string", description: "Dzień RRRR-MM-DD." },
+            },
+            required: ["salonId", "serviceId", "date"],
+            additionalProperties: false,
+        },
+        execute: async (args) => {
+            try {
+                const refusal = zoneRefusal(context);
+                if (refusal)
+                    return refusal;
+                const salonId = readString(args, "salonId");
+                const day = readDay(args, "date");
+                const now = context.now();
+                if (day < localDayOf(now))
+                    return err("invalid_arguments", "Ten dzień już minął.");
+                const service = await findService(port, salonId, readString(args, "serviceId"));
+                if ("status" in service)
+                    return service;
+                const nowMinutes = day === localDayOf(now) ? now.getHours() * 60 + now.getMinutes() : -1;
+                const starts = [...(await freeStartsByWorker(port, service, day)).keys()].filter((start) => start > nowMinutes).sort((a, b) => a - b);
+                if (starts.length === 0)
+                    return ok(`„${service.name}” — ${day}: brak wolnych godzin.`, []);
+                return ok(`„${service.name}” — ${day}: wolne godziny rozpoczęcia (${service.durationMinutes} min, ${service.pricePln} zł).`, foldStartRanges(starts));
+            }
+            catch (error) {
+                if (error instanceof ArgumentError)
+                    return err("invalid_arguments", error.message);
+                return toToolError(error, "Nie udało się sprawdzić wolnych godzin.");
+            }
+        },
+    };
+}
+export function bookAppointmentTool(context, confirmations) {
+    const { port } = context;
+    const gate = writeGate("book_appointment", confirmations);
+    return {
+        name: "book_appointment",
+        progress: "Rezerwuję wizytę…",
+        description: "Rezerwuje wizytę w imieniu klienta. Najpierw confirmed=false: dostaniesz podsumowanie do pokazania klientowi. Rezerwacja następuje dopiero przy confirmed=true po jego zgodzie. Pracownika dobiera system.",
+        parameters: gate.parameters({
+            type: "object",
+            properties: {
+                salonId: { type: "string", description: "Id salonu." },
+                serviceId: { type: "string", description: "Id usługi z search_slots albo get_salon." },
+                date: { type: "string", description: "Dzień wizyty RRRR-MM-DD." },
+                time: { type: "string", description: "Godzina rozpoczęcia GG:MM, wielokrotność 5 minut." },
+                discountCode: { type: "string", description: "Kod rabatowy, tylko gdy klient go podał albo pochodzi z promocji salonu." },
+                notes: { type: "string", description: "Uwagi klienta dla salonu." },
+                confirmed: CONFIRMED_FIELD,
+            },
+            required: ["salonId", "serviceId", "date", "time", "confirmed"],
+            additionalProperties: false,
+        }),
+        execute: async (args) => {
+            try {
+                const zone = zoneRefusal(context);
+                if (zone)
+                    return zone;
+                const salonId = readString(args, "salonId");
+                const serviceId = readString(args, "serviceId");
+                const day = readDay(args, "date");
+                const startMinutes = readTimeMinutes(args, "time");
+                const discountCode = readOptionalString(args, "discountCode");
+                const notes = readOptionalString(args, "notes");
+                if (!onSlotGrid(startMinutes))
+                    throw new ArgumentError("Wizyta może zacząć się tylko o pełnych 5 minutach (np. 10:00, 10:05).");
+                // The echo is the change in its normal form, whichever spelling the model used.
+                const echo = { salonId, serviceId, date: day, time: timeOfMinutes(startMinutes) };
+                if (discountCode !== undefined)
+                    echo.discountCode = discountCode;
+                if (notes !== undefined)
+                    echo.notes = notes;
+                const refusal = gate.refusal(args, echo);
+                if (refusal)
+                    return refusal;
+                const startAt = momentOf(day, startMinutes);
+                if (startAt <= context.now().getTime())
+                    return err("invalid_arguments", "Ten termin już minął. Zapytaj klienta o późniejszy.");
+                const service = await findService(port, salonId, serviceId);
+                if ("status" in service)
+                    return service;
+                // Checked on BOTH calls: a refused booking still spends the customer's daily quota,
+                // and the slot may have gone between the preview and the "yes".
+                const workerId = (await freeStartsByWorker(port, service, day)).get(startMinutes);
+                if (workerId === undefined) {
+                    return err("not_found", `Termin ${day} ${timeOfMinutes(startMinutes)} nie jest już wolny. Sprawdź inne godziny przez get_free_times.`);
+                }
+                const [salon] = await port.getSalons([salonId]);
+                const where = salon ? `${salon.name} (${salon.address})` : "salon";
+                const code = discountCode === undefined ? "" : `, z kodem rabatowym ${discountCode}`;
+                const what = `„${service.name}” w ${where}, ${day} o ${timeOfMinutes(startMinutes)}, ${service.durationMinutes} min, cena ${service.pricePln} zł${code}`;
+                if (!readBoolean(args, "confirmed"))
+                    return gate.preview(`Zarezerwuję: ${what}.`, echo);
+                const refused = gate.redeem(args, echo);
+                if (refused)
+                    return refused;
+                const appointmentId = await port.book({ salonId, serviceId, workerId, startAt, notes: notes ?? "", discountCode });
+                return ok(`Zarezerwowano: ${what}.${await pricePaidNote(port, appointmentId, service.pricePln)} Wizyta jest w zakładce „Wizyty”.`, { appointmentId });
+            }
+            catch (error) {
+                if (error instanceof ArgumentError)
+                    return err("invalid_arguments", error.message);
+                return toToolError(error, "Nie udało się zarezerwować wizyty.");
+            }
+        },
+    };
+}
+/** What the customer really pays, when a discount code changed it. Never fails a booking that is
+ * already made — and a query right after an update may not see it yet. */
+async function pricePaidNote(port, appointmentId, listPricePln) {
+    try {
+        const booked = (await port.listMyAppointments()).find((appointment) => appointment.id === appointmentId);
+        if (!booked || booked.pricePln === listPricePln)
+            return "";
+        return ` Cena po rabacie: ${booked.pricePln} zł.`;
+    }
+    catch {
+        return "";
+    }
+}
+/** The customer's visits still ahead, soonest first, with the names a person knows them by. */
+async function upcomingAppointments(port, now) {
+    const upcoming = (await port.listMyAppointments())
+        .filter((appointment) => (appointment.status === "Confirmed" || appointment.status === "Pending") && appointment.startAt > now.getTime())
+        .sort((a, b) => a.startAt - b.startAt);
+    const salonIds = [...new Set(upcoming.map((appointment) => appointment.salonId))];
+    const salons = new Map((await port.getSalons(salonIds)).map((salon) => [salon.id, salon]));
+    const serviceNames = new Map();
+    await Promise.all(salonIds.map(async (salonId) => {
+        try {
+            for (const service of await port.listSalonServices(salonId))
+                serviceNames.set(service.id, service.name);
+        }
+        catch {
+            // A visit is still worth listing without its service's name.
+        }
+    }));
+    return upcoming.map((appointment) => ({ ...appointment, salon: salons.get(appointment.salonId), serviceName: serviceNames.get(appointment.serviceId) }));
+}
+function describeAppointment(appointment) {
+    const what = appointment.serviceName ? `„${appointment.serviceName}”` : "wizyta";
+    const where = appointment.salon ? ` w ${appointment.salon.name} (${appointment.salon.address})` : "";
+    return `${what}${where}, ${localDayOf(appointment.startAt)} o ${localTimeOf(appointment.startAt)}`;
+}
+export function listMyAppointmentsTool(context) {
+    const { port } = context;
+    return {
+        name: "list_my_appointments",
+        progress: "Sprawdzam Twoje wizyty…",
+        description: "Zwraca nadchodzące wizyty klienta (potwierdzone, jeszcze nie odbyte): id wizyty, salon, usługę, termin i cenę.",
+        parameters: { type: "object", properties: {}, additionalProperties: false },
+        execute: async () => {
+            try {
+                const zone = zoneRefusal(context);
+                if (zone)
+                    return zone;
+                const upcoming = await upcomingAppointments(port, context.now());
+                if (upcoming.length === 0)
+                    return ok("Klient nie ma nadchodzących wizyt.", []);
+                return ok(`Nadchodzące wizyty: ${upcoming.length}.`, upcoming.map((appointment) => ({
+                    appointmentId: appointment.id,
+                    salonId: appointment.salonId,
+                    salonName: appointment.salon?.name ?? "Salon",
+                    address: appointment.salon?.address ?? "",
+                    serviceName: appointment.serviceName ?? "",
+                    start: localStampOf(appointment.startAt),
+                    durationMinutes: appointment.durationMinutes,
+                    pricePln: appointment.pricePln,
+                })));
+            }
+            catch (error) {
+                return toToolError(error, "Nie udało się odczytać wizyt.");
+            }
+        },
+    };
+}
+export function cancelAppointmentTool(context, confirmations) {
+    const { port } = context;
+    const gate = writeGate("cancel_appointment", confirmations);
+    return {
+        name: "cancel_appointment",
+        progress: "Odwołuję wizytę…",
+        description: "Odwołuje nadchodzącą wizytę klienta. Najpierw confirmed=false (podsumowanie dla klienta), potem confirmed=true po jego zgodzie. appointmentId weź z list_my_appointments.",
+        parameters: gate.parameters({
+            type: "object",
+            properties: {
+                appointmentId: { type: "string", description: "Id wizyty z list_my_appointments." },
+                confirmed: CONFIRMED_FIELD,
+            },
+            required: ["appointmentId", "confirmed"],
+            additionalProperties: false,
+        }),
+        execute: async (args) => {
+            try {
+                const zone = zoneRefusal(context);
+                if (zone)
+                    return zone;
+                const appointmentId = readString(args, "appointmentId");
+                const echo = { appointmentId };
+                const refusal = gate.refusal(args, echo);
+                if (refusal)
+                    return refusal;
+                const appointment = (await upcomingAppointments(port, context.now())).find((candidate) => candidate.id === appointmentId);
+                if (!appointment)
+                    return err("not_found", "Klient nie ma takiej nadchodzącej wizyty. Id weź z list_my_appointments.");
+                if (!readBoolean(args, "confirmed"))
+                    return gate.preview(`Odwołam wizytę: ${describeAppointment(appointment)}.`, echo);
+                const refused = gate.redeem(args, echo);
+                if (refused)
+                    return refused;
+                await port.cancel(appointmentId);
+                return ok(`Odwołano wizytę: ${describeAppointment(appointment)}.`, { appointmentId });
+            }
+            catch (error) {
+                if (error instanceof ArgumentError)
+                    return err("invalid_arguments", error.message);
+                return toToolError(error, "Nie udało się odwołać wizyty.");
+            }
+        },
+    };
+}

package/dist/index.d.ts

@@ -1,5 +1,14 @@
+export { ConfirmationLedger, DEFAULT_CONFIRMATION_TTL_MS } from "./confirmations.js";
+export type { ConfirmationLedgerOptions, ConfirmationRefusal, RedeemResult, TurnConfirmations, } from "./confirmations.js";
 export { createSalonReadTools, createSalonReadToolsFromPort, createSalonTools, createSalonToolsFromPort, } from "./create-salon-tools.js";
-export type { CreateSalonReadToolsOptions, CreateSalonToolsOptions } from "./create-salon-tools.js";
+export type { CreateSalonReadToolsOptions, CreateSalonToolsFromPortOptions, CreateSalonToolsOptions, } from "./create-salon-tools.js";
+export { createCustomerReadTools, createCustomerReadToolsFromPort, createCustomerTools, createCustomerToolsFromPort, DEFAULT_SALON_TIME_ZONE, } from "./customer/create-customer-tools.js";
+export type { CreateCustomerReadToolsOptions, CreateCustomerToolsFromPortOptions, CreateCustomerToolsOptions, } from "./customer/create-customer-tools.js";
+export type { AppointmentStatusView, AppointmentView, BookingInput, Coordinates, CustomerCorePort, CustomerPromoView, CustomerServiceView, SalonSlotsView, SalonView, SlotSearchView, } from "./customer/customer-core-port.js";
+export { IcCustomerCorePort } from "./customer/ic-customer-core-port.js";
+export type { IcCustomerCorePortOptions } from "./customer/ic-customer-core-port.js";
+export { CUSTOMER_AGENT_PERSONA_PL } from "./customer/persona.js";
+export { hostTimeZoneProblem } from "./customer/time.js";
 export { IcSalonCorePort } from "./ic-salon-core-port.js";
 export type { IcSalonCorePortOptions } from "./ic-salon-core-port.js";
 export { SALON_AGENT_PERSONA_PL, SALON_READ_PERSONA_PL } from "./persona.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,wBAAwB,GAC3B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC7E,YAAY,EACR,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,eAAe,EACf,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,UAAU,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACrF,YAAY,EACR,yBAAyB,EACzB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,wBAAwB,GAC3B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACR,2BAA2B,EAC3B,+BAA+B,EAC/B,uBAAuB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,uBAAuB,EACvB,+BAA+B,EAC/B,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GAC1B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACR,8BAA8B,EAC9B,kCAAkC,EAClC,0BAA0B,GAC7B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACR,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,cAAc,GACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC7E,YAAY,EACR,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,eAAe,EACf,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,UAAU,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,4 +1,9 @@
+export { ConfirmationLedger, DEFAULT_CONFIRMATION_TTL_MS } from "./confirmations.js";
 export { createSalonReadTools, createSalonReadToolsFromPort, createSalonTools, createSalonToolsFromPort, } from "./create-salon-tools.js";
+export { createCustomerReadTools, createCustomerReadToolsFromPort, createCustomerTools, createCustomerToolsFromPort, DEFAULT_SALON_TIME_ZONE, } from "./customer/create-customer-tools.js";
+export { IcCustomerCorePort } from "./customer/ic-customer-core-port.js";
+export { CUSTOMER_AGENT_PERSONA_PL } from "./customer/persona.js";
+export { hostTimeZoneProblem } from "./customer/time.js";
 export { IcSalonCorePort } from "./ic-salon-core-port.js";
 export { SALON_AGENT_PERSONA_PL, SALON_READ_PERSONA_PL } from "./persona.js";
 export { err, needsConfirmation, ok } from "./types.js";

package/dist/persona.d.ts

@@ -5,8 +5,11 @@
  * confirmation protocol, which reads come before which writes), so keeping them next to the tools
  * is the only way they cannot drift apart. An agent host may append its own persona — who the
  * agent is, how it speaks — on top of this.
+ *
+ * The two-step rule is written for a host that passes a `ConfirmationLedger` turn to the tools:
+ * the tools then refuse a confirmation from the same turn, so the persona and the code agree.
  */
-export declare const SALON_AGENT_PERSONA_PL = "Jeste\u015B asystentem w\u0142a\u015Bciciela salonu w aplikacji Sultana.\nRozmawiasz po polsku, kr\u00F3tko i konkretnie. Wykonujesz zmiany w salonie za pomoc\u0105 narz\u0119dzi.\n\nZasady pracy:\n- Zanim zmienisz albo usuniesz us\u0142ug\u0119, wywo\u0142aj list_services i ustal jej id. Nie zgaduj id.\n- Zanim podasz serviceTypeIds, wywo\u0142aj find_service_type. Nigdy nie wymy\u015Blaj id typu us\u0142ugi.\n- Zanim przypiszesz pracownik\u00F3w, wywo\u0142aj list_workers.\n- Cena to pe\u0142ne z\u0142ote (liczba ca\u0142kowita). Czas trwania to minuty, wielokrotno\u015B\u0107 5.\n  \"p\u00F3\u0142torej godziny\" to 90 minut, \"kwadrans\" to 15 minut.\n- Ka\u017Cde narz\u0119dzie zapisuj\u0105ce ma pole confirmed. Najpierw wywo\u0142aj je z confirmed=false,\n  poka\u017C w\u0142a\u015Bcicielowi zdanie, kt\u00F3re wr\u00F3ci w polu summary, i poczekaj na zgod\u0119.\n  Dopiero po wyra\u017Anym \"tak\" wywo\u0142aj to samo narz\u0119dzie z confirmed=true.\n- Przy usuwaniu popro\u015B w\u0142a\u015Bciciela o przepisanie dok\u0142adnej nazwy usuwanej rzeczy\n  i wstaw j\u0105 w confirmationPhrase.\n- Je\u015Bli narz\u0119dzie zwr\u00F3ci status \"error\", przeczytaj summary i powiedz w\u0142a\u015Bcicielowi,\n  co posz\u0142o nie tak. Nie powtarzaj tego samego wywo\u0142ania w k\u00F3\u0142ko.\n- Je\u015Bli brakuje Ci danych do wykonania polecenia, dopytaj o jedn\u0105 rzecz naraz.\n- Nie obiecuj zmian, kt\u00F3rych nie wykona\u0142e\u015B narz\u0119dziem.";
+export declare const SALON_AGENT_PERSONA_PL = "Jeste\u015B asystentem w\u0142a\u015Bcicielki salonu w aplikacji Sultana.\nRozmawiasz po polsku, kr\u00F3tko i konkretnie. Wykonujesz zmiany w salonie za pomoc\u0105 narz\u0119dzi.\n\nZasady pracy:\n- Zanim zmienisz albo usuniesz us\u0142ug\u0119, wywo\u0142aj list_services i ustal jej id. Nie zgaduj id.\n- Zanim podasz serviceTypeIds, wywo\u0142aj find_service_type. Nigdy nie wymy\u015Blaj id typu us\u0142ugi.\n- Zanim przypiszesz pracownik\u00F3w, wywo\u0142aj list_workers.\n- Cena to pe\u0142ne z\u0142ote (liczba ca\u0142kowita). Czas trwania to minuty, wielokrotno\u015B\u0107 5.\n  \"p\u00F3\u0142torej godziny\" to 90 minut, \"kwadrans\" to 15 minut.\n- Gdy masz narz\u0119dzia zapisuj\u0105ce, list_services i list_promos pokazuj\u0105 te\u017C us\u0142ugi\n  i promocje wy\u0142\u0105czone \u2014 nie tylko to, co widz\u0105 klientki.\n- Ka\u017Cda zmiana to dwa kroki w dw\u00F3ch r\u00F3\u017Cnych wiadomo\u015Bciach w\u0142a\u015Bcicielki:\n  1. Wywo\u0142aj narz\u0119dzie zapisuj\u0105ce z confirmed=false. Poka\u017C w\u0142a\u015Bcicielce zdanie z pola summary,\n     zapytaj o zgod\u0119 i na tym zako\u0144cz odpowied\u017A.\n  2. Dopiero gdy w swojej NAST\u0118PNEJ wiadomo\u015Bci wyra\u017Anie si\u0119 zgodzi, wywo\u0142aj to samo narz\u0119dzie\n     z confirmed=true, z confirmationId z tego podgl\u0105du i z tymi samymi argumentami (pole echo).\n  Nigdy nie potwierdzaj w tej samej odpowiedzi, w kt\u00F3rej pokaza\u0142e\u015B podgl\u0105d.\n  Gdy w\u0142a\u015Bcicielka chce co\u015B inaczej, zr\u00F3b nowy podgl\u0105d i zn\u00F3w poczekaj na zgod\u0119.\n- Przy usuwaniu popro\u015B w\u0142a\u015Bcicielk\u0119, \u017Ceby sama napisa\u0142a dok\u0142adn\u0105 nazw\u0119 usuwanej rzeczy,\n  i wstaw w confirmationPhrase to, co napisa\u0142a. Nigdy nie wpisuj nazwy za ni\u0105.\n- Je\u015Bli masz tylko narz\u0119dzia do odczytu (list_\u2026, find_\u2026), nie mo\u017Cesz niczego zmieni\u0107 \u2014\n  powiedz, \u017Ce zmiany wymagaj\u0105 otwartej strony \u201ESalon Assistant\u201D w panelu.\n- Je\u015Bli narz\u0119dzie zwr\u00F3ci status \"error\", przeczytaj summary i powiedz w\u0142a\u015Bcicielce,\n  co posz\u0142o nie tak. Nie powtarzaj tego samego wywo\u0142ania w k\u00F3\u0142ko.\n- Je\u015Bli brakuje Ci danych do wykonania polecenia, dopytaj o jedn\u0105 rzecz naraz.\n- Nie obiecuj zmian, kt\u00F3rych nie wykona\u0142e\u015B narz\u0119dziem.";
 /**
  * The operating rules for the read-only set (`createSalonReadTools`), as a system prompt.
  *

package/dist/persona.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../src/persona.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,28CAiBoB,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,6wCAee,CAAC"}
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../src/persona.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,i2EAyBoB,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,6wCAee,CAAC"}

package/dist/persona.js

@@ -5,8 +5,11 @@
  * confirmation protocol, which reads come before which writes), so keeping them next to the tools
  * is the only way they cannot drift apart. An agent host may append its own persona — who the
  * agent is, how it speaks — on top of this.
+ *
+ * The two-step rule is written for a host that passes a `ConfirmationLedger` turn to the tools:
+ * the tools then refuse a confirmation from the same turn, so the persona and the code agree.
  */
-export const SALON_AGENT_PERSONA_PL = `Jesteś asystentem właściciela salonu w aplikacji Sultana.
+export const SALON_AGENT_PERSONA_PL = `Jesteś asystentem właścicielki salonu w aplikacji Sultana.
 Rozmawiasz po polsku, krótko i konkretnie. Wykonujesz zmiany w salonie za pomocą narzędzi.
 
 Zasady pracy:
@@ -15,12 +18,20 @@ Zasady pracy:
 - Zanim przypiszesz pracowników, wywołaj list_workers.
 - Cena to pełne złote (liczba całkowita). Czas trwania to minuty, wielokrotność 5.
   "półtorej godziny" to 90 minut, "kwadrans" to 15 minut.
-- Każde narzędzie zapisujące ma pole confirmed. Najpierw wywołaj je z confirmed=false,
-  pokaż właścicielowi zdanie, które wróci w polu summary, i poczekaj na zgodę.
-  Dopiero po wyraźnym "tak" wywołaj to samo narzędzie z confirmed=true.
-- Przy usuwaniu poproś właściciela o przepisanie dokładnej nazwy usuwanej rzeczy
-  i wstaw ją w confirmationPhrase.
-- Jeśli narzędzie zwróci status "error", przeczytaj summary i powiedz właścicielowi,
+- Gdy masz narzędzia zapisujące, list_services i list_promos pokazują też usługi
+  i promocje wyłączone — nie tylko to, co widzą klientki.
+- Każda zmiana to dwa kroki w dwóch różnych wiadomościach właścicielki:
+  1. Wywołaj narzędzie zapisujące z confirmed=false. Pokaż właścicielce zdanie z pola summary,
+     zapytaj o zgodę i na tym zakończ odpowiedź.
+  2. Dopiero gdy w swojej NASTĘPNEJ wiadomości wyraźnie się zgodzi, wywołaj to samo narzędzie
+     z confirmed=true, z confirmationId z tego podglądu i z tymi samymi argumentami (pole echo).
+  Nigdy nie potwierdzaj w tej samej odpowiedzi, w której pokazałeś podgląd.
+  Gdy właścicielka chce coś inaczej, zrób nowy podgląd i znów poczekaj na zgodę.
+- Przy usuwaniu poproś właścicielkę, żeby sama napisała dokładną nazwę usuwanej rzeczy,
+  i wstaw w confirmationPhrase to, co napisała. Nigdy nie wpisuj nazwy za nią.
+- Jeśli masz tylko narzędzia do odczytu (list_…, find_…), nie możesz niczego zmienić —
+  powiedz, że zmiany wymagają otwartej strony „Salon Assistant” w panelu.
+- Jeśli narzędzie zwróci status "error", przeczytaj summary i powiedz właścicielce,
   co poszło nie tak. Nie powtarzaj tego samego wywołania w kółko.
 - Jeśli brakuje Ci danych do wykonania polecenia, dopytaj o jedną rzecz naraz.
 - Nie obiecuj zmian, których nie wykonałeś narzędziem.`;

package/dist/tools/promos.d.ts

@@ -1,6 +1,7 @@
+import type { TurnConfirmations } from "../confirmations.js";
 import type { SalonAccess, SalonCorePort } from "../salon-core-port.js";
 import { type AgentTool } from "../types.js";
-export declare function createPromoTools(port: SalonCorePort): AgentTool[];
+export declare function createPromoTools(port: SalonCorePort, confirmations?: TurnConfirmations): AgentTool[];
 /** `access` must match the port: `"public"` only for a port read anonymously, because the canister
  * gives the salon's owner the whole library whatever the port calls. */
 export declare function listPromosTool(port: SalonCorePort, access?: SalonAccess): AgentTool;

package/dist/tools/promos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promos.d.ts","sourceRoot":"","sources":["../../src/tools/promos.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA8B,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAqBzE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,EAAE,CAYjE;AA2CD;wEACwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,GAAE,WAAqB,GAAG,SAAS,CAmB5F"}
+{"version":3,"file":"promos.d.ts","sourceRoot":"","sources":["../../src/tools/promos.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAA8B,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAsBtD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,CAAC,EAAE,iBAAiB,GAAG,SAAS,EAAE,CAYpG;AA2CD;wEACwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,GAAE,WAAqB,GAAG,SAAS,CAmB5F"}