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

package/README.md

@@ -163,6 +163,14 @@ const tools = session
   AND on the confirmed call — a booking the canister refuses still spends the customer's daily quota.
 - The public reads go out anonymously even with an identity; only booking, the visits and
   cancelling are signed.
+- **Numbers are written for the customer's region, by the tools, not by the prompt.** Pass
+  `locale` (a BCP 47 tag the app runs in — `"pl-PL"`, `"en-GB"`; default `pl-PL`, an unknown tag
+  falls back to it). Distances, prices and durations reach the model as ready text —
+  `distance: "8,3 km"`, `price: "60 zł"`, `duration: "45 min"` — in the data and in every
+  summary; there is no `distanceKm` / `pricePln` / `durationMinutes` for it to spell its own way
+  ("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 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

@@ -15,6 +15,12 @@ export interface CreateCustomerToolsFromPortOptions {
      * touches a time answers with an error instead of booking hours off. `null` skips the guard.
      */
     timeZone?: string | null;
+    /**
+     * 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.
+     */
+    locale?: string;
 }
 export interface CreateCustomerToolsOptions extends Omit<IcCustomerCorePortOptions, "language">, CreateCustomerToolsFromPortOptions {
     /** Language of service-type labels. Defaults to Polish. */

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;AAChE,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;CAC5B;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;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"}

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

@@ -1,4 +1,5 @@
 import { findServiceTypeTool } from "../tools/services.js";
+import { customerFormats } from "./format.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. */
@@ -9,9 +10,9 @@ export const DEFAULT_SALON_TIME_ZONE = "Europe/Warsaw";
  * model holding these tools can act for nobody else and search around nowhere else.
  */
 export function createCustomerTools(options) {
-    const { confirmations, now, timeZone, language, ...portOptions } = options;
+    const { confirmations, now, timeZone, locale, language, ...portOptions } = options;
     const port = new IcCustomerCorePort({ ...portOptions, language: language ?? "pl" });
-    return createCustomerToolsFromPort(port, { confirmations, now, timeZone });
+    return createCustomerToolsFromPort(port, { confirmations, now, timeZone, locale });
 }
 /** The same set over any port — the seam tests use. */
 export function createCustomerToolsFromPort(port, options = {}) {
@@ -28,9 +29,9 @@ export function createCustomerToolsFromPort(port, options = {}) {
  * identity — finding a service type, searching slots, a salon, its free times. Nothing books.
  */
 export function createCustomerReadTools(options) {
-    const { now, timeZone, language, ...portOptions } = options;
+    const { now, timeZone, locale, language, ...portOptions } = options;
     const port = new IcCustomerCorePort({ ...portOptions, language: language ?? "pl" });
-    return createCustomerReadToolsFromPort(port, { now, timeZone });
+    return createCustomerReadToolsFromPort(port, { now, timeZone, locale });
 }
 export function createCustomerReadToolsFromPort(port, options = {}) {
     return readTools(contextOf(port, options));
@@ -40,6 +41,7 @@ function contextOf(port, options) {
         port,
         now: options.now ?? (() => new Date()),
         timeZone: options.timeZone === null ? undefined : options.timeZone ?? DEFAULT_SALON_TIME_ZONE,
+        formats: customerFormats(options.locale),
     };
 }
 function readTools(context) {

package/dist/customer/format.d.ts

@@ -0,0 +1,19 @@
+/** The region the tools write numbers for when the app sent none: Sultana's home market. */
+export declare const DEFAULT_CUSTOMER_LOCALE = "pl-PL";
+/**
+ * Numbers as the customer's region writes them — "8,3 km" and "60 zł" in pl-PL, "8.3 km" and
+ * "PLN 60" in en-GB. A model copies a number the way it got it, and a prompt rule about decimal
+ * commas is followed only most of the time; so the tools hand the model TEXT that is already
+ * right, and no bare number it could spell its own way.
+ */
+export interface CustomerFormats {
+    readonly locale: string;
+    /** One decimal: "8,3 km". */
+    distance(km: number): string;
+    /** Whole złoty without decimals, anything else with two: "60 zł", "59,50 zł". */
+    price(pln: number): string;
+    /** "45 min". */
+    duration(minutes: number): string;
+}
+export declare function customerFormats(locale?: string): CustomerFormats;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/customer/format.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,iFAAiF;IACjF,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAkBD,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAgBhE"}

package/dist/customer/format.js

@@ -0,0 +1,32 @@
+/** The region the tools write numbers for when the app sent none: Sultana's home market. */
+export const DEFAULT_CUSTOMER_LOCALE = "pl-PL";
+/** A tag `Intl` does not know falls back to the default instead of failing every tool. */
+function supported(locale) {
+    if (!locale)
+        return DEFAULT_CUSTOMER_LOCALE;
+    try {
+        return Intl.NumberFormat.supportedLocalesOf([locale])[0] ?? DEFAULT_CUSTOMER_LOCALE;
+    }
+    catch {
+        return DEFAULT_CUSTOMER_LOCALE;
+    }
+}
+/** Intl joins a number and its unit with a no-break space; a plain one is what a chat line and a test expect. */
+function plainSpaces(text) {
+    return text.replace(/[\u00a0\u202f]/g, " ");
+}
+export function customerFormats(locale) {
+    const tag = supported(locale);
+    const distance = new Intl.NumberFormat(tag, { style: "unit", unit: "kilometer", maximumFractionDigits: 1 });
+    const wholePrice = new Intl.NumberFormat(tag, { style: "currency", currency: "PLN", maximumFractionDigits: 0 });
+    const exactPrice = new Intl.NumberFormat(tag, { style: "currency", currency: "PLN" });
+    // "min" is read the same in every language the app speaks; Intl's own short form is
+    // "mins" in English and its narrow one "45m".
+    const count = new Intl.NumberFormat(tag, { maximumFractionDigits: 0 });
+    return {
+        locale: tag,
+        distance: (km) => plainSpaces(distance.format(km)),
+        price: (pln) => plainSpaces((Number.isInteger(pln) ? wholePrice : exactPrice).format(pln)),
+        duration: (minutes) => `${plainSpaces(count.format(minutes))} min`,
+    };
+}

package/dist/customer/persona.d.ts

@@ -2,5 +2,5 @@
  * 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 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- 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 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.";
 //# 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,isEAsBqB,CAAC"}
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/customer/persona.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,yBAAyB,i2EAuBqB,CAAC"}

package/dist/customer/persona.js

@@ -12,6 +12,7 @@ Zasady pracy:
 - Terminy znajdź przez search_slots: bez daty = jak najszybciej, z date i time = okolice tej godziny.
   Dzisiejszą datę weź z get_current_date — „jutro o 10” przelicz na RRRR-MM-DD i GG:MM.
 - Pokaż klientowi najwyżej kilka propozycji: salon, usługa, cena, odległość, godzina. Nie pokazuj id.
+  Cenę, odległość i czas trwania przepisuj dokładnie tak, jak je dostałeś (np. „8,3 km”, „60 zł”).
 - Inne godziny w wybranym salonie sprawdź przez get_free_times.
 - Rezerwacja i odwołanie to dwa kroki w dwóch różnych wiadomościach klienta:
   1. Wywołaj book_appointment albo cancel_appointment z confirmed=false. Pokaż klientowi zdanie

package/dist/customer/tools.d.ts

@@ -1,5 +1,6 @@
 import type { TurnConfirmations } from "../confirmations.js";
 import { type AgentTool } from "../types.js";
+import { type CustomerFormats } from "./format.js";
 import type { CustomerCorePort } from "./customer-core-port.js";
 export interface CustomerToolsContext {
     port: CustomerCorePort;
@@ -7,6 +8,8 @@ export interface CustomerToolsContext {
     now: () => Date;
     /** The salons' time zone the host process must run in; `undefined` skips the guard. */
     timeZone?: string;
+    /** How the customer's region writes distances, prices and durations. Defaults to pl-PL. */
+    formats?: CustomerFormats;
 }
 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,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;CACrB;AAwCD,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAgFxE;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,CA6E1H;AA6CD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAkC/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,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"}

package/dist/customer/tools.js

@@ -2,7 +2,15 @@ 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 { customerFormats } from "./format.js";
 import { foldStartRanges, freeStartMinutes, hostTimeZoneProblem, isDay, localDayOf, localStampOf, localTimeOf, minutesOf, momentOf, onSlotGrid, timeOfMinutes, } from "./time.js";
+/**
+ * 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.
+ */
+function formatsOf(context) {
+    return context.formats ?? customerFormats();
+}
 const DEFAULT_RADIUS_KM = 10;
 const MAX_RADIUS_KM = 50;
 const MAX_SALONS_SHOWN = 6;
@@ -33,15 +41,15 @@ function readTimeMinutes(args, key) {
         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 };
+function serviceLine(formats) {
+    return (service) => ({ serviceId: service.id, name: service.name, price: formats.price(service.pricePln), duration: formats.duration(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.",
+        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",
             properties: {
@@ -60,6 +68,7 @@ export function searchSlotsTool(context) {
                     return refusal;
                 if (!port.location)
                     return err("invalid_arguments", NO_LOCATION);
+                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);
                 const dayText = readOptionalString(args, "date");
@@ -88,7 +97,7 @@ export function searchSlotsTool(context) {
                 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ń.`, []);
+                    return ok(`Nic wolnego w promieniu ${formats.distance(radiusKm)}. 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]));
@@ -96,8 +105,8 @@ export function searchSlotsTool(context) {
                     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),
+                    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.` : "";
@@ -140,7 +149,7 @@ export function getSalonTool(context) {
                     salonId,
                     name: salon.name,
                     address: salon.address,
-                    services: services.map(serviceLine),
+                    services: services.map(serviceLine(formatsOf(context))),
                     promos,
                 });
             }
@@ -214,7 +223,7 @@ export function getFreeTimesTool(context) {
                 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));
+                return ok(`„${service.name}” — ${day}: wolne godziny rozpoczęcia (${formatsOf(context).duration(service.durationMinutes)}, ${formatsOf(context).price(service.pricePln)}).`, foldStartRanges(starts));
             }
             catch (error) {
                 if (error instanceof ArgumentError)
@@ -279,17 +288,18 @@ export function bookAppointmentTool(context, confirmations) {
                 if (workerId === undefined) {
                     return err("not_found", `Termin ${day} ${timeOfMinutes(startMinutes)} nie jest już wolny. Sprawdź inne godziny przez get_free_times.`);
                 }
+                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)}, ${service.durationMinutes} min, cena ${service.pricePln} zł${code}`;
+                const what = `„${service.name}” w ${where}, ${day} o ${timeOfMinutes(startMinutes)}, ${formats.duration(service.durationMinutes)}, cena ${formats.price(service.pricePln)}${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 });
+                return ok(`Zarezerwowano: ${what}.${await pricePaidNote(port, appointmentId, service.pricePln, formats)} Wizyta jest w zakładce „Wizyty”.`, { appointmentId });
             }
             catch (error) {
                 if (error instanceof ArgumentError)
@@ -301,12 +311,12 @@ export function bookAppointmentTool(context, confirmations) {
 }
 /** 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) {
+async function pricePaidNote(port, appointmentId, listPricePln, formats) {
     try {
         const booked = (await port.listMyAppointments()).find((appointment) => appointment.id === appointmentId);
         if (!booked || booked.pricePln === listPricePln)
             return "";
-        return ` Cena po rabacie: ${booked.pricePln} zł.`;
+        return ` Cena po rabacie: ${formats.price(booked.pricePln)}.`;
     }
     catch {
         return "";
@@ -351,6 +361,7 @@ export function listMyAppointmentsTool(context) {
                 const upcoming = await upcomingAppointments(port, context.now());
                 if (upcoming.length === 0)
                     return ok("Klient nie ma nadchodzących wizyt.", []);
+                const formats = formatsOf(context);
                 return ok(`Nadchodzące wizyty: ${upcoming.length}.`, upcoming.map((appointment) => ({
                     appointmentId: appointment.id,
                     salonId: appointment.salonId,
@@ -358,8 +369,8 @@ export function listMyAppointmentsTool(context) {
                     address: appointment.salon?.address ?? "",
                     serviceName: appointment.serviceName ?? "",
                     start: localStampOf(appointment.startAt),
-                    durationMinutes: appointment.durationMinutes,
-                    pricePln: appointment.pricePln,
+                    duration: formats.duration(appointment.durationMinutes),
+                    price: formats.price(appointment.pricePln),
                 })));
             }
             catch (error) {

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export type { CreateCustomerReadToolsOptions, CreateCustomerToolsFromPortOptions
 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 { 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 { hostTimeZoneProblem } from "./customer/time.js";
 export { IcSalonCorePort } 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,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,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

@@ -2,6 +2,7 @@ export { ConfirmationLedger, DEFAULT_CONFIRMATION_TTL_MS } from "./confirmations
 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 { customerFormats, DEFAULT_CUSTOMER_LOCALE } from "./customer/format.js";
 export { CUSTOMER_AGENT_PERSONA_PL } from "./customer/persona.js";
 export { hostTimeZoneProblem } from "./customer/time.js";
 export { IcSalonCorePort } from "./ic-salon-core-port.js";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/sultana-agent-tools-package",
-    "version": "0.4.0",
+    "version": "0.5.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": {