@jsm-mit/sultana-agent-tools-package 0.5.0 → 0.6.0

package/README.md

@@ -171,6 +171,16 @@ const tools = session
   ("8.3 km" in a Polish sentence). `customerFormats(locale)` is exported for a host that writes
   such text itself. Dates and times stay `YYYY-MM-DD` / `HH:mm`: the model sends them back as
   arguments.
+- **The whole assistant follows the app's language.** The language of `locale` ("en-GB" → English,
+  anything else → Polish) decides three things besides the numbers: what the tools SAY
+  (`customerTexts(locale)`, `src/customer/texts.ts` — the `progress` lines, the summaries and the
+  tools' own errors, i.e. everything a host keeps in the chat as "✔ …" / "✖ …"), the language of
+  service-type labels (unless `language` is given), and — through `customerAgentPersona(locale)` —
+  the language the model answers in. The English rule is an override ("answer in English even if
+  the chat's history and tool results are Polish"), because a host replays both to the model.
+  `CUSTOMER_AGENT_PERSONA_PL` is `customerAgentPersona("pl-PL")`. Still Polish only: tool and
+  parameter descriptions (the model alone reads them) and the errors shared with the salon tools
+  (argument checks, the confirmation gate, canister failures).
 - **The host process must run in the salons' time zone** (`TZ=Europe/Warsaw`): the canister wrapper
   takes every offset from the process clock. While it does not, every time-dependent tool answers
   `unavailable` instead of booking hours off (`timeZone: null` skips the guard; `hostTimeZoneProblem`

package/dist/customer/create-customer-tools.d.ts

@@ -18,12 +18,14 @@ export interface CreateCustomerToolsFromPortOptions {
     /**
      * The customer's language and region as a BCP 47 tag ("pl-PL", "en-GB") — what the app runs
      * in. Distances, prices and durations reach the model already written that way ("8,3 km").
-     * Defaults to pl-PL; a tag the runtime does not know falls back to it.
+     * Defaults to pl-PL; a tag the runtime does not know falls back to it. Its language also
+     * decides what the tools say (`texts.ts`: progress lines, summaries, errors — Polish or
+     * English) and, unless `language` is given, the language of service-type labels.
      */
     locale?: string;
 }
 export interface CreateCustomerToolsOptions extends Omit<IcCustomerCorePortOptions, "language">, CreateCustomerToolsFromPortOptions {
-    /** Language of service-type labels. Defaults to Polish. */
+    /** Language of service-type labels. Defaults to the language of `locale`, else Polish. */
     language?: string;
 }
 /**

package/dist/customer/create-customer-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-customer-tools.d.ts","sourceRoot":"","sources":["../../src/customer/create-customer-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAWhG,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,MAAM,WAAW,kCAAkC;IAC/C,8EAA8E;IAC9E,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAC,EAAE,kCAAkC;IAC/H,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,SAAS,EAAE,CAKpF;AAED,uDAAuD;AACvD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAE,kCAAuC,GAAG,SAAS,EAAE,CASjI;AAED,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAAC,0BAA0B,EAAE,UAAU,GAAG,eAAe,CAAC,CAAC;AAE5G;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,SAAS,EAAE,CAK5F;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAE,IAAI,CAAC,kCAAkC,EAAE,eAAe,CAAM,GAAG,SAAS,EAAE,CAE5J"}
+{"version":3,"file":"create-customer-tools.d.ts","sourceRoot":"","sources":["../../src/customer/create-customer-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAWhG,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,MAAM,WAAW,kCAAkC;IAC/C,8EAA8E;IAC9E,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAC,EAAE,kCAAkC;IAC/H,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,SAAS,EAAE,CAKpF;AAED,uDAAuD;AACvD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAE,kCAAuC,GAAG,SAAS,EAAE,CASjI;AAED,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAAC,0BAA0B,EAAE,UAAU,GAAG,eAAe,CAAC,CAAC;AAE5G;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,SAAS,EAAE,CAK5F;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAE,IAAI,CAAC,kCAAkC,EAAE,eAAe,CAAM,GAAG,SAAS,EAAE,CAE5J"}

package/dist/customer/create-customer-tools.js

@@ -1,5 +1,6 @@
 import { findServiceTypeTool } from "../tools/services.js";
 import { customerFormats } from "./format.js";
+import { customerLanguageOf, customerTexts } from "./texts.js";
 import { IcCustomerCorePort } from "./ic-customer-core-port.js";
 import { bookAppointmentTool, cancelAppointmentTool, getFreeTimesTool, getSalonTool, listMyAppointmentsTool, searchSlotsTool, } from "./tools.js";
 /** The zone Sultana's salons live in. The canister keeps no zone per salon. */
@@ -11,7 +12,7 @@ export const DEFAULT_SALON_TIME_ZONE = "Europe/Warsaw";
  */
 export function createCustomerTools(options) {
     const { confirmations, now, timeZone, locale, language, ...portOptions } = options;
-    const port = new IcCustomerCorePort({ ...portOptions, language: language ?? "pl" });
+    const port = new IcCustomerCorePort({ ...portOptions, language: language ?? customerLanguageOf(locale) });
     return createCustomerToolsFromPort(port, { confirmations, now, timeZone, locale });
 }
 /** The same set over any port — the seam tests use. */
@@ -30,7 +31,7 @@ export function createCustomerToolsFromPort(port, options = {}) {
  */
 export function createCustomerReadTools(options) {
     const { now, timeZone, locale, language, ...portOptions } = options;
-    const port = new IcCustomerCorePort({ ...portOptions, language: language ?? "pl" });
+    const port = new IcCustomerCorePort({ ...portOptions, language: language ?? customerLanguageOf(locale) });
     return createCustomerReadToolsFromPort(port, { now, timeZone, locale });
 }
 export function createCustomerReadToolsFromPort(port, options = {}) {
@@ -42,8 +43,11 @@ function contextOf(port, options) {
         now: options.now ?? (() => new Date()),
         timeZone: options.timeZone === null ? undefined : options.timeZone ?? DEFAULT_SALON_TIME_ZONE,
         formats: customerFormats(options.locale),
+        texts: customerTexts(options.locale),
     };
 }
 function readTools(context) {
-    return [findServiceTypeTool(context.port), searchSlotsTool(context), getSalonTool(context), getFreeTimesTool(context)];
+    // Shared with the salon tools, where it speaks Polish only: its progress line is set here.
+    const findServiceType = { ...findServiceTypeTool(context.port), progress: (context.texts ?? customerTexts()).progress.findServiceType };
+    return [findServiceType, searchSlotsTool(context), getSalonTool(context), getFreeTimesTool(context)];
 }

package/dist/customer/persona.d.ts

@@ -1,6 +1,8 @@
 /**
- * The operating rules of the customer tools, as a system prompt — next to the tools for the same
- * reason as the salon persona: they describe the tool contract. A host appends who the agent is.
+ * How the model has to use the customer tools, in the language the customer's app runs in
+ * (`locale`: a BCP 47 tag, "pl-PL" / "en-GB"). An unknown language gets Polish.
  */
-export declare const CUSTOMER_AGENT_PERSONA_PL = "Jeste\u015B asystentem klienta w aplikacji Sultana: pomagasz znale\u017A\u0107 salon i wolny termin,\nrezerwujesz i odwo\u0142ujesz wizyty w imieniu klienta. Rozmawiasz po polsku, kr\u00F3tko i konkretnie.\n\nZasady pracy:\n- Szukasz zawsze wok\u00F3\u0142 pozycji klienta, kt\u00F3r\u0105 poda\u0142a aplikacja. Nie pytaj o adres.\n- Typ us\u0142ugi ustal przez find_service_type (np. \u201Estrzy\u017Cenie m\u0119skie\u201D). Nigdy nie wymy\u015Blaj id.\n  Gdy pasuje kilka typ\u00F3w, dopytaj klienta, o kt\u00F3ry chodzi.\n- Terminy znajd\u017A przez search_slots: bez daty = jak najszybciej, z date i time = okolice tej godziny.\n  Dzisiejsz\u0105 dat\u0119 we\u017A z get_current_date \u2014 \u201Ejutro o 10\u201D przelicz na RRRR-MM-DD i GG:MM.\n- Poka\u017C klientowi najwy\u017Cej kilka propozycji: salon, us\u0142uga, cena, odleg\u0142o\u015B\u0107, godzina. Nie pokazuj id.\n  Cen\u0119, odleg\u0142o\u015B\u0107 i czas trwania przepisuj dok\u0142adnie tak, jak je dosta\u0142e\u015B (np. \u201E8,3 km\u201D, \u201E60 z\u0142\u201D).\n- Inne godziny w wybranym salonie sprawd\u017A przez get_free_times.\n- Rezerwacja i odwo\u0142anie to dwa kroki w dw\u00F3ch r\u00F3\u017Cnych wiadomo\u015Bciach klienta:\n  1. Wywo\u0142aj book_appointment albo cancel_appointment z confirmed=false. Poka\u017C klientowi zdanie\n     z pola summary, 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- Kod rabatowy podawaj tylko wtedy, gdy klient go wpisa\u0142 albo wybra\u0142 promocj\u0119 z get_salon.\n- Je\u015Bli masz tylko narz\u0119dzia do szukania (bez book_appointment), nie mo\u017Cesz rezerwowa\u0107 \u2014\n  powiedz, \u017Ce klient musi si\u0119 zalogowa\u0107 ponownie w aplikacji i otworzy\u0107 czat jeszcze raz.\n- Je\u015Bli narz\u0119dzie zwr\u00F3ci status \"error\", przeczytaj summary i powiedz klientowi, co posz\u0142o nie tak.\n  Nie powtarzaj tego samego wywo\u0142ania w k\u00F3\u0142ko: nieudana pr\u00F3ba rezerwacji zu\u017Cywa dzienny limit klienta.\n- Nie obiecuj rezerwacji, kt\u00F3rej nie wykona\u0142e\u015B narz\u0119dziem.";
+export declare function customerAgentPersona(locale?: string): string;
+/** The Polish persona — what a host without a customer's locale uses. */
+export declare const CUSTOMER_AGENT_PERSONA_PL: string;
 //# sourceMappingURL=persona.d.ts.map

package/dist/customer/persona.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/customer/persona.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,yBAAyB,i2EAuBqB,CAAC"}
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/customer/persona.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AA2BD,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,QAAgC,CAAC"}

package/dist/customer/persona.js

@@ -1,8 +1,26 @@
+import { customerLanguageOf } from "./texts.js";
 /**
  * The operating rules of the customer tools, as a system prompt — next to the tools for the same
  * reason as the salon persona: they describe the tool contract. A host appends who the agent is.
  */
-export const CUSTOMER_AGENT_PERSONA_PL = `Jesteś asystentem klienta w aplikacji Sultana: pomagasz znaleźć salon i wolny termin,
+/**
+ * The language rule, one per language the tools speak. The rules below it are Polish in every
+ * case — only the model reads them. The English rule is an OVERRIDE, not a hint: the chat's
+ * history and the last tool results are replayed to the model, and they may still be Polish
+ * from before the customer switched the app's language.
+ */
+const LANGUAGE_RULE = {
+    pl: "Rozmawiasz po polsku, krótko i konkretnie.",
+    en: "Klient używa aplikacji po angielsku: KAŻDĄ odpowiedź piszesz WYŁĄCZNIE po angielsku (English), krótko i konkretnie — także wtedy, gdy wcześniejsze wiadomości w tej rozmowie, te zasady albo wyniki narzędzi są po polsku. Nazwy salonów i adresy zostaw bez zmian.",
+};
+/**
+ * How the model has to use the customer tools, in the language the customer's app runs in
+ * (`locale`: a BCP 47 tag, "pl-PL" / "en-GB"). An unknown language gets Polish.
+ */
+export function customerAgentPersona(locale) {
+    return PERSONA.replace(LANGUAGE_RULE.pl, LANGUAGE_RULE[customerLanguageOf(locale)]);
+}
+const PERSONA = `Jesteś asystentem klienta w aplikacji Sultana: pomagasz znaleźć salon i wolny termin,
 rezerwujesz i odwołujesz wizyty w imieniu klienta. Rozmawiasz po polsku, krótko i konkretnie.
 
 Zasady pracy:
@@ -26,3 +44,5 @@ Zasady pracy:
 - Jeśli narzędzie zwróci status "error", przeczytaj summary i powiedz klientowi, co poszło nie tak.
   Nie powtarzaj tego samego wywołania w kółko: nieudana próba rezerwacji zużywa dzienny limit klienta.
 - Nie obiecuj rezerwacji, której nie wykonałeś narzędziem.`;
+/** The Polish persona — what a host without a customer's locale uses. */
+export const CUSTOMER_AGENT_PERSONA_PL = customerAgentPersona("pl-PL");

package/dist/customer/texts.d.ts

@@ -0,0 +1,79 @@
+/**
+ * What the customer tools SAY, in the language the customer's app runs in. Two readers:
+ * - the customer, directly: a tool's `progress` line while it runs, and the summary of a write
+ *   or of an error, which the host keeps in the chat as a "✔ …" / "✖ …" line;
+ * - the model, which answers in that language and should not have to translate its own tools.
+ *
+ * Tool and parameter DESCRIPTIONS are not here: only the model reads them, and they stay Polish.
+ * Numbers inside these sentences arrive already written for the region (`format.ts`).
+ */
+export interface CustomerTexts {
+    progress: {
+        findServiceType: string;
+        searchSlots: string;
+        getSalon: string;
+        getFreeTimes: string;
+        book: string;
+        listAppointments: string;
+        cancel: string;
+    };
+    salonFallbackName: string;
+    visitFallbackName: string;
+    noLocation: string;
+    bookingOff(problem: string): string;
+    badDay(field: string): string;
+    badTime(field: string): string;
+    dateAndTimeTogether: string;
+    leadSoon: string;
+    leadExtended: string;
+    leadAround(day: string, time: string): string;
+    momentPassed: string;
+    probesFailed: string;
+    nothingFree(radius: string): string;
+    found(lead: string, shown: number, total: number): string;
+    searchFailed: string;
+    noSuchSalon: string;
+    salonSummary(name: string, address: string, services: number, promos: number): string;
+    salonFailed: string;
+    noSuchService: string;
+    nobodyDoesService(name: string): string;
+    dayPassed: string;
+    noFreeTimes(service: string, day: string): string;
+    freeTimes(service: string, day: string, duration: string, price: string): string;
+    freeTimesFailed: string;
+    offGrid: string;
+    slotGone(day: string, time: string): string;
+    withDiscountCode(code: string): string;
+    visit(parts: {
+        service: string;
+        where: string;
+        day: string;
+        time: string;
+        duration: string;
+        price: string;
+        code: string;
+    }): string;
+    somewhere: string;
+    willBook(what: string): string;
+    booked(what: string, priceNote: string): string;
+    pricePaid(price: string): string;
+    bookFailed: string;
+    noUpcoming: string;
+    upcoming(count: number): string;
+    listFailed: string;
+    noSuchAppointment: string;
+    appointment(parts: {
+        what: string;
+        where: string;
+        day: string;
+        time: string;
+    }): string;
+    at(place: string): string;
+    willCancel(what: string): string;
+    cancelled(what: string): string;
+    cancelFailed: string;
+}
+/** The language of a BCP 47 tag ("en-GB" → "en"), when the tools speak it; Polish otherwise. */
+export declare function customerLanguageOf(locale?: string): "pl" | "en";
+export declare function customerTexts(locale?: string): CustomerTexts;
+//# sourceMappingURL=texts.d.ts.map

package/dist/customer/texts.d.ts.map

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

package/dist/customer/texts.js

@@ -0,0 +1,115 @@
+const PL = {
+    progress: {
+        findServiceType: "Szukam typu usługi…",
+        searchSlots: "Szukam wolnych terminów w okolicy…",
+        getSalon: "Sprawdzam salon…",
+        getFreeTimes: "Sprawdzam wolne godziny…",
+        book: "Rezerwuję wizytę…",
+        listAppointments: "Sprawdzam Twoje wizyty…",
+        cancel: "Odwołuję wizytę…",
+    },
+    salonFallbackName: "Salon",
+    visitFallbackName: "wizyta",
+    noLocation: "Aplikacja nie podała pozycji klienta, więc nie wiem, gdzie szukać. Poproś klienta, żeby włączył lokalizację w aplikacji i otworzył czat ponownie.",
+    bookingOff: (problem) => `Rezerwacje są chwilowo wyłączone: ${problem}.`,
+    badDay: (field) => `Pole "${field}" musi być datą w formacie RRRR-MM-DD.`,
+    badTime: (field) => `Pole "${field}" musi być godziną w formacie GG:MM.`,
+    dateAndTimeTogether: "Podaj date i time razem albo pomiń oba (jak najszybciej).",
+    leadSoon: "Najbliższe wolne terminy:",
+    leadExtended: "W najbliższej godzinie nic wolnego, na które klient zdąży. Najbliższe terminy:",
+    leadAround: (day, time) => `Wolne terminy w okolicach ${day} ${time}:`,
+    momentPassed: "Ten termin już minął. Zapytaj klienta o późniejszy.",
+    probesFailed: "Nie udało się sprawdzić terminów — kanister nie odpowiadał. Spróbuj ponownie za chwilę.",
+    nothingFree: (radius) => `Nic wolnego w promieniu ${radius}. Zaproponuj inną godzinę, inny dzień albo większy promień.`,
+    found: (lead, shown, total) => `${lead} ${shown} salon(y).${total > shown ? ` Pokazuję ${shown} z ${total} salonów.` : ""} Terminy to początek wizyty; inne godziny w danym salonie sprawdź przez get_free_times.`,
+    searchFailed: "Nie udało się wyszukać terminów.",
+    noSuchSalon: "Nie ma takiego salonu. Id weź z search_slots.",
+    salonSummary: (name, address, services, promos) => `${name}, ${address}: ${services} usług(i), ${promos} promocji.`,
+    salonFailed: "Nie udało się odczytać salonu.",
+    noSuchService: "Ten salon nie ma takiej aktywnej usługi. Id salonu i usługi weź z search_slots albo get_salon.",
+    nobodyDoesService: (name) => `Usługi „${name}” nikt teraz nie wykonuje — nie da się jej zarezerwować.`,
+    dayPassed: "Ten dzień już minął.",
+    noFreeTimes: (service, day) => `„${service}” — ${day}: brak wolnych godzin.`,
+    freeTimes: (service, day, duration, price) => `„${service}” — ${day}: wolne godziny rozpoczęcia (${duration}, ${price}).`,
+    freeTimesFailed: "Nie udało się sprawdzić wolnych godzin.",
+    offGrid: "Wizyta może zacząć się tylko o pełnych 5 minutach (np. 10:00, 10:05).",
+    slotGone: (day, time) => `Termin ${day} ${time} nie jest już wolny. Sprawdź inne godziny przez get_free_times.`,
+    withDiscountCode: (code) => `, z kodem rabatowym ${code}`,
+    visit: ({ service, where, day, time, duration, price, code }) => `„${service}” w ${where}, ${day} o ${time}, ${duration}, cena ${price}${code}`,
+    somewhere: "salon",
+    willBook: (what) => `Zarezerwuję: ${what}.`,
+    booked: (what, priceNote) => `Zarezerwowano: ${what}.${priceNote} Wizyta jest w zakładce „Wizyty”.`,
+    pricePaid: (price) => ` Cena po rabacie: ${price}.`,
+    bookFailed: "Nie udało się zarezerwować wizyty.",
+    noUpcoming: "Klient nie ma nadchodzących wizyt.",
+    upcoming: (count) => `Nadchodzące wizyty: ${count}.`,
+    listFailed: "Nie udało się odczytać wizyt.",
+    noSuchAppointment: "Klient nie ma takiej nadchodzącej wizyty. Id weź z list_my_appointments.",
+    appointment: ({ what, where, day, time }) => `${what}${where}, ${day} o ${time}`,
+    at: (place) => ` w ${place}`,
+    willCancel: (what) => `Odwołam wizytę: ${what}.`,
+    cancelled: (what) => `Odwołano wizytę: ${what}.`,
+    cancelFailed: "Nie udało się odwołać wizyty.",
+};
+const EN = {
+    progress: {
+        findServiceType: "Looking up the service type…",
+        searchSlots: "Searching for free slots nearby…",
+        getSalon: "Checking the salon…",
+        getFreeTimes: "Checking free times…",
+        book: "Booking the visit…",
+        listAppointments: "Checking your visits…",
+        cancel: "Cancelling the visit…",
+    },
+    salonFallbackName: "Salon",
+    visitFallbackName: "visit",
+    noLocation: "The app sent no position of the customer, so I do not know where to search. Ask the customer to turn location on in the app and open the chat again.",
+    bookingOff: (problem) => `Booking is switched off for the moment: ${problem}.`,
+    badDay: (field) => `Field "${field}" must be a date in the YYYY-MM-DD format.`,
+    badTime: (field) => `Field "${field}" must be a time in the HH:MM format.`,
+    dateAndTimeTogether: "Give date and time together, or leave both out (as soon as possible).",
+    leadSoon: "The nearest free slots:",
+    leadExtended: "Nothing free within the next hour that the customer can reach in time. The nearest slots:",
+    leadAround: (day, time) => `Free slots around ${day} ${time}:`,
+    momentPassed: "That time has already passed. Ask the customer for a later one.",
+    probesFailed: "The slots could not be checked — the canister did not answer. Try again in a moment.",
+    nothingFree: (radius) => `Nothing free within ${radius}. Suggest another time, another day or a larger radius.`,
+    found: (lead, shown, total) => `${lead} ${shown} salon(s).${total > shown ? ` Showing ${shown} of ${total} salons.` : ""} A slot is the start of the visit; check other times in a salon with get_free_times.`,
+    searchFailed: "The slots could not be searched.",
+    noSuchSalon: "There is no such salon. Take the id from search_slots.",
+    salonSummary: (name, address, services, promos) => `${name}, ${address}: ${services} service(s), ${promos} promotion(s).`,
+    salonFailed: "The salon could not be read.",
+    noSuchService: "This salon has no such active service. Take the salon and service ids from search_slots or get_salon.",
+    nobodyDoesService: (name) => `Nobody performs "${name}" at the moment — it cannot be booked.`,
+    dayPassed: "That day has already passed.",
+    noFreeTimes: (service, day) => `"${service}" — ${day}: no free times.`,
+    freeTimes: (service, day, duration, price) => `"${service}" — ${day}: free start times (${duration}, ${price}).`,
+    freeTimesFailed: "The free times could not be checked.",
+    offGrid: "A visit can start only on a full 5 minutes (10:00, 10:05, …).",
+    slotGone: (day, time) => `The slot ${day} ${time} is no longer free. Check other times with get_free_times.`,
+    withDiscountCode: (code) => `, with discount code ${code}`,
+    visit: ({ service, where, day, time, duration, price, code }) => `"${service}" at ${where}, ${day} at ${time}, ${duration}, price ${price}${code}`,
+    somewhere: "the salon",
+    willBook: (what) => `I will book: ${what}.`,
+    booked: (what, priceNote) => `Booked: ${what}.${priceNote} The visit is in the "Visits" tab.`,
+    pricePaid: (price) => ` Price after the discount: ${price}.`,
+    bookFailed: "The visit could not be booked.",
+    noUpcoming: "The customer has no upcoming visits.",
+    upcoming: (count) => `Upcoming visits: ${count}.`,
+    listFailed: "The visits could not be read.",
+    noSuchAppointment: "The customer has no such upcoming visit. Take the id from list_my_appointments.",
+    appointment: ({ what, where, day, time }) => `${what}${where}, ${day} at ${time}`,
+    at: (place) => ` at ${place}`,
+    willCancel: (what) => `I will cancel the visit: ${what}.`,
+    cancelled: (what) => `Visit cancelled: ${what}.`,
+    cancelFailed: "The visit could not be cancelled.",
+};
+const BY_LANGUAGE = { pl: PL, en: EN };
+/** The language of a BCP 47 tag ("en-GB" → "en"), when the tools speak it; Polish otherwise. */
+export function customerLanguageOf(locale) {
+    const language = locale?.split("-")[0]?.toLowerCase();
+    return language === "en" ? "en" : "pl";
+}
+export function customerTexts(locale) {
+    return BY_LANGUAGE[customerLanguageOf(locale)];
+}

package/dist/customer/tools.d.ts

@@ -1,6 +1,7 @@
 import type { TurnConfirmations } from "../confirmations.js";
 import { type AgentTool } from "../types.js";
 import { type CustomerFormats } from "./format.js";
+import { type CustomerTexts } from "./texts.js";
 import type { CustomerCorePort } from "./customer-core-port.js";
 export interface CustomerToolsContext {
     port: CustomerCorePort;
@@ -10,6 +11,8 @@ export interface CustomerToolsContext {
     timeZone?: string;
     /** How the customer's region writes distances, prices and durations. Defaults to pl-PL. */
     formats?: CustomerFormats;
+    /** The sentences of the customer's language — see `texts.ts`. Defaults to Polish. */
+    texts?: CustomerTexts;
 }
 export declare function searchSlotsTool(context: CustomerToolsContext): AgentTool;
 export declare function getSalonTool(context: CustomerToolsContext): AgentTool;

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

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/customer/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D,OAAO,EAAW,KAAK,SAAS,EAAmB,MAAM,aAAa,CAAC;AACvE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAAmB,gBAAgB,EAAkD,MAAM,yBAAyB,CAAC;AAejI,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,kCAAkC;IAClC,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,eAAe,CAAC;CAC7B;AAgDD,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAkFxE;AAUD,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAkCrE;AAkCD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CA2CzE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,GAAG,SAAS,GAAG,SAAS,CA8E1H;AA6CD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAoC/E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,GAAG,SAAS,GAAG,SAAS,CA4C5H"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/customer/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D,OAAO,EAAW,KAAK,SAAS,EAAmB,MAAM,aAAa,CAAC;AACvE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAmB,gBAAgB,EAAkD,MAAM,yBAAyB,CAAC;AAejI,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,kCAAkC;IAClC,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,qFAAqF;IACrF,KAAK,CAAC,EAAE,aAAa,CAAC;CACzB;AAkDD,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAkFxE;AAUD,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAmCrE;AAkCD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CA4CzE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,GAAG,SAAS,GAAG,SAAS,CAqF1H;AA+CD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAqC/E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,GAAG,SAAS,GAAG,SAAS,CA6C5H"}

package/dist/customer/tools.js

@@ -3,7 +3,11 @@ import { ArgumentError, readBoolean, readOptionalNumber, readOptionalString, rea
 import { writeGate } from "../tools/write-gate.js";
 import { err, ok } from "../types.js";
 import { customerFormats } from "./format.js";
+import { customerTexts } from "./texts.js";
 import { foldStartRanges, freeStartMinutes, hostTimeZoneProblem, isDay, localDayOf, localStampOf, localTimeOf, minutesOf, momentOf, onSlotGrid, timeOfMinutes, } from "./time.js";
+function textsOf(context) {
+    return context.texts ?? customerTexts();
+}
 /**
  * The tools never hand the model a bare distance, price or duration: it would copy "8.3" with
  * a dot into a Polish sentence. They hand it the text the customer's region writes.
@@ -21,24 +25,23 @@ 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;
+    return problem ? err("unavailable", textsOf(context).bookingOff(problem)) : null;
 }
-function readDay(args, key) {
+function readDay(texts, args, key) {
     const day = readString(args, key);
     if (!isDay(day))
-        throw new ArgumentError(`Pole "${key}" musi być datą w formacie RRRR-MM-DD.`);
+        throw new ArgumentError(texts.badDay(key));
     return day;
 }
-function readTimeMinutes(args, key) {
+function readTimeMinutes(texts, args, key) {
     const minutes = minutesOf(readString(args, key));
     if (minutes === null)
-        throw new ArgumentError(`Pole "${key}" musi być godziną w formacie GG:MM.`);
+        throw new ArgumentError(texts.badTime(key));
     return minutes;
 }
 function serviceLine(formats) {
@@ -46,9 +49,10 @@ function serviceLine(formats) {
 }
 export function searchSlotsTool(context) {
     const { port } = context;
+    const texts = textsOf(context);
     return {
         name: "search_slots",
-        progress: "Szukam wolnych terminów w okolicy…",
+        progress: texts.progress.searchSlots,
         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. Odległość, cenę i czas trwania dostajesz jako gotowy tekst — przepisz go bez zmian. serviceTypeId weź z find_service_type.",
         parameters: {
             type: "object",
@@ -67,7 +71,7 @@ export function searchSlotsTool(context) {
                 if (refusal)
                     return refusal;
                 if (!port.location)
-                    return err("invalid_arguments", NO_LOCATION);
+                    return err("invalid_arguments", texts.noLocation);
                 const formats = formatsOf(context);
                 const serviceTypeId = readString(args, "serviceTypeId");
                 const radiusKm = Math.min(Math.max(readOptionalNumber(args, "radiusKm") ?? DEFAULT_RADIUS_KM, 1), MAX_RADIUS_KM);
@@ -75,47 +79,46 @@ export function searchSlotsTool(context) {
                 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).");
+                    throw new ArgumentError(texts.dateAndTimeTogether);
                 }
                 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:";
+                    lead = found.phase === "extended" ? texts.leadExtended : texts.leadSoon;
                 }
                 else {
-                    const day = readDay(args, "date");
-                    const at = readTimeMinutes(args, "time");
+                    const day = readDay(texts, args, "date");
+                    const at = readTimeMinutes(texts, 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.");
+                        return err("invalid_arguments", texts.momentPassed);
                     found = await port.searchAtMoments(serviceTypeId, radiusKm, moments);
-                    lead = `Wolne terminy w okolicach ${day} ${timeOfMinutes(at)}:`;
+                    lead = texts.leadAround(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 ${formats.distance(radiusKm)}. Zaproponuj inną godzinę, inny dzień albo większy promień.`, []);
+                        return err("unavailable", texts.probesFailed);
+                    return ok(texts.nothingFree(formats.distance(radiusKm)), []);
                 }
                 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",
+                    name: names.get(salon.salonId)?.name ?? texts.salonFallbackName,
                     address: names.get(salon.salonId)?.address ?? "",
                     distance: formats.distance(salon.distanceKm),
                     services: salon.services.map(serviceLine(formats)),
                     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);
+                return ok(texts.found(lead, ranked.length, found.salons.length), data);
             }
             catch (error) {
                 if (error instanceof ArgumentError)
                     return err("invalid_arguments", error.message);
-                return toToolError(error, "Nie udało się wyszukać terminów.");
+                return toToolError(error, texts.searchFailed);
             }
         },
     };
@@ -128,9 +131,10 @@ function bySoonestThenNearest(a, b) {
 }
 export function getSalonTool(context) {
     const { port } = context;
+    const texts = textsOf(context);
     return {
         name: "get_salon",
-        progress: "Sprawdzam salon…",
+        progress: texts.progress.getSalon,
         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",
@@ -143,9 +147,9 @@ export function getSalonTool(context) {
                 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.");
+                    return err("not_found", texts.noSuchSalon);
                 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.`, {
+                return ok(texts.salonSummary(salon.name, salon.address, services.length, promos.length), {
                     salonId,
                     name: salon.name,
                     address: salon.address,
@@ -156,19 +160,19 @@ export function getSalonTool(context) {
             catch (error) {
                 if (error instanceof ArgumentError)
                     return err("invalid_arguments", error.message);
-                return toToolError(error, "Nie udało się odczytać salonu.");
+                return toToolError(error, texts.salonFailed);
             }
         },
     };
 }
 /** The salon's active service, or the tool error that says why not. */
-async function findService(port, salonId, serviceId) {
+async function findService(port, texts, 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.");
+        return err("not_found", texts.noSuchService);
     if (service.workerIds.length === 0)
-        return err("not_found", `Usługi „${service.name}” nikt teraz nie wykonuje — nie da się jej zarezerwować.`);
+        return err("not_found", texts.nobodyDoesService(service.name));
     return service;
 }
 /** Free start minutes of a service on a day → the first worker free then (the app's rule). */
@@ -192,9 +196,10 @@ async function freeStartsByWorker(port, service, day) {
 }
 export function getFreeTimesTool(context) {
     const { port } = context;
+    const texts = textsOf(context);
     return {
         name: "get_free_times",
-        progress: "Sprawdzam wolne godziny…",
+        progress: texts.progress.getFreeTimes,
         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",
@@ -212,33 +217,34 @@ export function getFreeTimesTool(context) {
                 if (refusal)
                     return refusal;
                 const salonId = readString(args, "salonId");
-                const day = readDay(args, "date");
+                const day = readDay(texts, 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"));
+                    return err("invalid_arguments", texts.dayPassed);
+                const service = await findService(port, texts, 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 (${formatsOf(context).duration(service.durationMinutes)}, ${formatsOf(context).price(service.pricePln)}).`, foldStartRanges(starts));
+                    return ok(texts.noFreeTimes(service.name, day), []);
+                return ok(texts.freeTimes(service.name, day, formatsOf(context).duration(service.durationMinutes), formatsOf(context).price(service.pricePln)), foldStartRanges(starts));
             }
             catch (error) {
                 if (error instanceof ArgumentError)
                     return err("invalid_arguments", error.message);
-                return toToolError(error, "Nie udało się sprawdzić wolnych godzin.");
+                return toToolError(error, texts.freeTimesFailed);
             }
         },
     };
 }
 export function bookAppointmentTool(context, confirmations) {
     const { port } = context;
+    const texts = textsOf(context);
     const gate = writeGate("book_appointment", confirmations);
     return {
         name: "book_appointment",
-        progress: "Rezerwuję wizytę…",
+        progress: texts.progress.book,
         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",
@@ -261,12 +267,12 @@ export function bookAppointmentTool(context, confirmations) {
                     return zone;
                 const salonId = readString(args, "salonId");
                 const serviceId = readString(args, "serviceId");
-                const day = readDay(args, "date");
-                const startMinutes = readTimeMinutes(args, "time");
+                const day = readDay(texts, args, "date");
+                const startMinutes = readTimeMinutes(texts, 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).");
+                    throw new ArgumentError(texts.offGrid);
                 // 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)
@@ -278,45 +284,51 @@ export function bookAppointmentTool(context, confirmations) {
                     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);
+                    return err("invalid_arguments", texts.momentPassed);
+                const service = await findService(port, texts, 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.`);
+                    return err("not_found", texts.slotGone(day, timeOfMinutes(startMinutes)));
                 }
                 const formats = formatsOf(context);
                 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)}, ${formats.duration(service.durationMinutes)}, cena ${formats.price(service.pricePln)}${code}`;
+                const what = texts.visit({
+                    service: service.name,
+                    where: salon ? `${salon.name} (${salon.address})` : texts.somewhere,
+                    day,
+                    time: timeOfMinutes(startMinutes),
+                    duration: formats.duration(service.durationMinutes),
+                    price: formats.price(service.pricePln),
+                    code: discountCode === undefined ? "" : texts.withDiscountCode(discountCode),
+                });
                 if (!readBoolean(args, "confirmed"))
-                    return gate.preview(`Zarezerwuję: ${what}.`, echo);
+                    return gate.preview(texts.willBook(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, formats)} Wizyta jest w zakładce „Wizyty”.`, { appointmentId });
+                return ok(texts.booked(what, await pricePaidNote(port, appointmentId, service.pricePln, formats, texts)), { appointmentId });
             }
             catch (error) {
                 if (error instanceof ArgumentError)
                     return err("invalid_arguments", error.message);
-                return toToolError(error, "Nie udało się zarezerwować wizyty.");
+                return toToolError(error, texts.bookFailed);
             }
         },
     };
 }
 /** 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, formats) {
+async function pricePaidNote(port, appointmentId, listPricePln, formats, texts) {
     try {
         const booked = (await port.listMyAppointments()).find((appointment) => appointment.id === appointmentId);
         if (!booked || booked.pricePln === listPricePln)
             return "";
-        return ` Cena po rabacie: ${formats.price(booked.pricePln)}.`;
+        return texts.pricePaid(formats.price(booked.pricePln));
     }
     catch {
         return "";
@@ -341,16 +353,20 @@ async function upcomingAppointments(port, now) {
     }));
     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)}`;
+function describeAppointment(texts, appointment) {
+    return texts.appointment({
+        what: appointment.serviceName ? `„${appointment.serviceName}”` : texts.visitFallbackName,
+        where: appointment.salon ? texts.at(`${appointment.salon.name} (${appointment.salon.address})`) : "",
+        day: localDayOf(appointment.startAt),
+        time: localTimeOf(appointment.startAt),
+    });
 }
 export function listMyAppointmentsTool(context) {
     const { port } = context;
+    const texts = textsOf(context);
     return {
         name: "list_my_appointments",
-        progress: "Sprawdzam Twoje wizyty…",
+        progress: texts.progress.listAppointments,
         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 () => {
@@ -360,12 +376,12 @@ export function listMyAppointmentsTool(context) {
                     return zone;
                 const upcoming = await upcomingAppointments(port, context.now());
                 if (upcoming.length === 0)
-                    return ok("Klient nie ma nadchodzących wizyt.", []);
+                    return ok(texts.noUpcoming, []);
                 const formats = formatsOf(context);
-                return ok(`Nadchodzące wizyty: ${upcoming.length}.`, upcoming.map((appointment) => ({
+                return ok(texts.upcoming(upcoming.length), upcoming.map((appointment) => ({
                     appointmentId: appointment.id,
                     salonId: appointment.salonId,
-                    salonName: appointment.salon?.name ?? "Salon",
+                    salonName: appointment.salon?.name ?? texts.salonFallbackName,
                     address: appointment.salon?.address ?? "",
                     serviceName: appointment.serviceName ?? "",
                     start: localStampOf(appointment.startAt),
@@ -374,17 +390,18 @@ export function listMyAppointmentsTool(context) {
                 })));
             }
             catch (error) {
-                return toToolError(error, "Nie udało się odczytać wizyt.");
+                return toToolError(error, texts.listFailed);
             }
         },
     };
 }
 export function cancelAppointmentTool(context, confirmations) {
     const { port } = context;
+    const texts = textsOf(context);
     const gate = writeGate("cancel_appointment", confirmations);
     return {
         name: "cancel_appointment",
-        progress: "Odwołuję wizytę…",
+        progress: texts.progress.cancel,
         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",
@@ -407,19 +424,19 @@ export function cancelAppointmentTool(context, confirmations) {
                     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.");
+                    return err("not_found", texts.noSuchAppointment);
                 if (!readBoolean(args, "confirmed"))
-                    return gate.preview(`Odwołam wizytę: ${describeAppointment(appointment)}.`, echo);
+                    return gate.preview(texts.willCancel(describeAppointment(texts, appointment)), echo);
                 const refused = gate.redeem(args, echo);
                 if (refused)
                     return refused;
                 await port.cancel(appointmentId);
-                return ok(`Odwołano wizytę: ${describeAppointment(appointment)}.`, { appointmentId });
+                return ok(texts.cancelled(describeAppointment(texts, appointment)), { appointmentId });
             }
             catch (error) {
                 if (error instanceof ArgumentError)
                     return err("invalid_arguments", error.message);
-                return toToolError(error, "Nie udało się odwołać wizyty.");
+                return toToolError(error, texts.cancelFailed);
             }
         },
     };

package/dist/index.d.ts

@@ -9,7 +9,9 @@ export { IcCustomerCorePort } from "./customer/ic-customer-core-port.js";
 export type { IcCustomerCorePortOptions } from "./customer/ic-customer-core-port.js";
 export { customerFormats, DEFAULT_CUSTOMER_LOCALE } from "./customer/format.js";
 export type { CustomerFormats } from "./customer/format.js";
-export { CUSTOMER_AGENT_PERSONA_PL } from "./customer/persona.js";
+export { CUSTOMER_AGENT_PERSONA_PL, customerAgentPersona } from "./customer/persona.js";
+export { customerLanguageOf, customerTexts } from "./customer/texts.js";
+export type { CustomerTexts } from "./customer/texts.js";
 export { hostTimeZoneProblem } from "./customer/time.js";
 export { IcSalonCorePort } from "./ic-salon-core-port.js";
 export type { IcSalonCorePortOptions } from "./ic-salon-core-port.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"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,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,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"}
+{"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,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,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

@@ -3,7 +3,8 @@ export { createSalonReadTools, createSalonReadToolsFromPort, createSalonTools, c
 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 { customerFormats, DEFAULT_CUSTOMER_LOCALE } from "./customer/format.js";
-export { CUSTOMER_AGENT_PERSONA_PL } from "./customer/persona.js";
+export { CUSTOMER_AGENT_PERSONA_PL, customerAgentPersona } from "./customer/persona.js";
+export { customerLanguageOf, customerTexts } from "./customer/texts.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";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/sultana-agent-tools-package",
-    "version": "0.5.0",
+    "version": "0.6.0",
     "description": "Agent tool layer for Sultana: framework-agnostic tools over the Sultana core canister wrapper — a salon owner's set (services, promos, schedule) and a customer's set (search, free times, booking), each with a read-only set that needs no identity.",
     "homepage": "https://github.com/JSM-Sultana/sultana-agent-tools-package#readme",
     "bugs": {