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

package/dist/booksy/tools.js

@@ -0,0 +1,227 @@
+import { ArgumentError, readOptionalString, readOptionalStringArray, readString } from "../tools/args.js";
+import { err, ok } from "../types.js";
+import { BooksyReadError, fetchBooksyPage, fetchPhoto, normalizeBooksyUrl } from "./fetch-page.js";
+import { parseBooksySalon } from "./parse-salon.js";
+import { toSultanaDraft } from "./to-sultana.js";
+export const URL_FIELD = {
+    type: "string",
+    description: "Adres profilu salonu na Booksy, np. https://booksy.com/pl-pl/12345_nazwa-salonu_fryzjer_3_warszawa.",
+};
+const PHOTO_KINDS = ["logo", "cover", "salon", "inspiration", "service", "staff"];
+const DEFAULT_PHOTO_KINDS = ["logo", "cover", "salon"];
+// A busy profile has about a hundred photos — a service portfolio alone runs to 70 or more.
+const MAX_PHOTOS_PER_CALL = 150;
+/**
+ * Read-only tools over a PUBLIC Booksy profile: they fetch one page and hand back its content in
+ * the shape Sultana's write tools take. Nothing here writes to a salon, so nothing here asks for
+ * a confirmation. Reviews and customer names are never read.
+ */
+export function createBooksyReaderTools(options = {}) {
+    const reader = options.reader ?? new BooksyProfileReader(options.fetchFn);
+    const tools = [readSalonTool(reader), readServicesTool(reader)];
+    if (options.photoSink)
+        tools.push(downloadPhotosTool(reader, options.photoSink, options.fetchFn));
+    return tools;
+}
+/** Reads and recasts a whole profile — for a host or a script that wants the draft without a model. */
+export async function readBooksySalonDraft(url, fetchFn) {
+    return new BooksyProfileReader(fetchFn).read(url);
+}
+/** Long enough for a preview, the owner's "tak" and the import to read one fetch; short enough
+ * that an owner who has just edited her Booksy profile is not shown yesterday's. */
+const PROFILE_TTL_MS = 10 * 60_000;
+/** A reader may live as long as its host — it must not grow with every salon ever named. */
+const MAX_REMEMBERED_PROFILES = 50;
+/**
+ * Every Booksy tool reads the same page — fetch it once. Profiles are public, so one reader can
+ * serve a whole host; a profile is remembered for ten minutes, the last fifty of them.
+ */
+export class BooksyProfileReader {
+    fetchFn;
+    now;
+    drafts = new Map();
+    constructor(fetchFn, now = Date.now) {
+        this.fetchFn = fetchFn;
+        this.now = now;
+    }
+    read(rawUrl) {
+        const url = normalizeBooksyUrl(rawUrl);
+        const remembered = this.drafts.get(url);
+        if (remembered && this.now() - remembered.readAt <= PROFILE_TTL_MS)
+            return remembered.draft;
+        const draft = fetchBooksyPage(url, this.fetchFn).then((html) => toSultanaDraft(parseBooksySalon(html), url));
+        const entry = { readAt: this.now(), draft };
+        // A failed read must not be remembered — the next call tries again.
+        draft.catch(() => {
+            if (this.drafts.get(url) === entry)
+                this.drafts.delete(url);
+        });
+        // Re-inserting moves the profile to the end, so the first key is always the oldest.
+        this.drafts.delete(url);
+        this.drafts.set(url, entry);
+        while (this.drafts.size > MAX_REMEMBERED_PROFILES)
+            this.drafts.delete(this.drafts.keys().next().value);
+        return draft;
+    }
+}
+function readSalonTool(reader) {
+    return {
+        name: "read_booksy_salon",
+        progress: "Czytam profil salonu na Booksy…",
+        description: "Czyta publiczny profil salonu na Booksy i zwraca: nazwę, opis, adres, współrzędne, godziny otwarcia (dzień 0 = poniedziałek), zespół oraz liczbę usług i zdjęć. Niczego nie zapisuje. Usługi zwraca read_booksy_services.",
+        parameters: { type: "object", properties: { url: URL_FIELD }, required: ["url"], additionalProperties: false },
+        execute: (args) => guarded("Nie udało się odczytać profilu Booksy.", async () => {
+            const draft = await reader.read(readString(args, "url"));
+            const categories = new Set(draft.services.map((service) => service.booksyCategory));
+            return ok(`Salon „${draft.salon.name}” (${draft.salon.city || "miasto nieznane"}): ${draft.services.length} usług w ${categories.size} kategoriach, zespół ${draft.workers.length} os., ${draft.photos.length} zdjęć.${degradedSuffix(draft)}`, {
+                source: draft.source,
+                salon: draft.salon,
+                weeklyHours: draft.weeklyHours,
+                workers: draft.workers.map((worker) => worker.name),
+                serviceCount: draft.services.length,
+                serviceCategories: [...categories],
+                photoCounts: countPhotos(draft.photos),
+            });
+        }),
+    };
+}
+function readServicesTool(reader) {
+    return {
+        name: "read_booksy_services",
+        progress: "Czytam usługi salonu na Booksy…",
+        description: "Czyta usługi z publicznego profilu Booksy w postaci gotowej dla add_service: name, pricePln (pełne złote), durationMinutes (wielokrotność 5). Każdy wariant usługi Booksy to osobna usługa. serviceTypeIds są puste — dobierz je przez find_service_type, podpowiedzią jest booksyCategory. Pole notes opisuje, co zmieniono albo czego brakuje — powiedz o tym właścicielce. Niczego nie zapisuje.",
+        parameters: {
+            type: "object",
+            properties: {
+                url: URL_FIELD,
+                category: { type: "string", description: "Opcjonalnie: tylko usługi z tej kategorii Booksy (fragment nazwy)." },
+            },
+            required: ["url"],
+            additionalProperties: false,
+        },
+        execute: (args) => guarded("Nie udało się odczytać usług z Booksy.", async () => {
+            const draft = await reader.read(readString(args, "url"));
+            const category = readOptionalString(args, "category")?.toLowerCase();
+            const services = category
+                ? draft.services.filter((service) => service.booksyCategory.toLowerCase().includes(category))
+                : draft.services;
+            if (services.length === 0) {
+                return ok(category ? `Brak usług w kategorii „${category}”.` : "Profil Booksy nie ma żadnej usługi.", []);
+            }
+            const withNotes = services.filter((service) => service.notes.length > 0).length;
+            const notesPart = withNotes > 0 ? ` ${withNotes} z nich ma uwagi (pole notes).` : "";
+            return ok(`Usługi z Booksy: ${services.length}.${notesPart}${degradedSuffix(draft)}`, services);
+        }),
+    };
+}
+function downloadPhotosTool(reader, sink, fetchFn) {
+    return {
+        name: "download_booksy_photos",
+        progress: "Pobieram zdjęcia z Booksy…",
+        description: `Pobiera zdjęcia z publicznego profilu Booksy i odkłada je po stronie Sultana. Rodzaje: ${PHOTO_KINDS.join(", ")} („service” to portfolio usług — zdjęcia prac przypisane do usługi, „inspiration” to galeria prac). Domyślnie: ${DEFAULT_PHOTO_KINDS.join(", ")}. Najwyżej ${MAX_PHOTOS_PER_CALL} zdjęć na wywołanie. Zwraca listę zapisanych plików. Niczego nie zapisuje w salonie.`,
+        parameters: {
+            type: "object",
+            properties: {
+                url: URL_FIELD,
+                kinds: { type: "array", items: { type: "string", enum: PHOTO_KINDS }, description: "Które rodzaje zdjęć pobrać." },
+            },
+            required: ["url"],
+            additionalProperties: false,
+        },
+        execute: (args) => guarded("Nie udało się pobrać zdjęć z Booksy.", async () => {
+            const draft = await reader.read(readString(args, "url"));
+            const kinds = readKinds(args);
+            const wanted = draft.photos.filter((photo) => kinds.includes(photo.kind));
+            if (wanted.length === 0)
+                return ok("Profil Booksy nie ma zdjęć tych rodzajów.", []);
+            const saved = [];
+            const failed = [];
+            const counters = new Map();
+            for (const photo of wanted.slice(0, MAX_PHOTOS_PER_CALL)) {
+                const index = (counters.get(photo.kind) ?? 0) + 1;
+                counters.set(photo.kind, index);
+                // One broken photo must not cost the owner the rest of the gallery.
+                try {
+                    const file = await fetchPhoto(photo.url, fetchFn);
+                    const location = await sink.save({
+                        salonKey: draft.source.booksyId ?? "unknown",
+                        kind: photo.kind,
+                        fileName: `${photo.kind}-${String(index).padStart(2, "0")}${captionSlug(photo)}.${extensionOf(file.contentType)}`,
+                        contentType: file.contentType,
+                        bytes: file.bytes,
+                        sourceUrl: photo.url,
+                        caption: photo.caption,
+                    });
+                    saved.push({ kind: photo.kind, location, caption: photo.caption });
+                }
+                catch {
+                    failed.push(photo.url);
+                }
+            }
+            const skipped = wanted.length - Math.min(wanted.length, MAX_PHOTOS_PER_CALL);
+            const parts = [`Pobrano ${saved.length} z ${wanted.length} zdjęć.`];
+            if (failed.length > 0)
+                parts.push(`Nie udało się pobrać: ${failed.length}.`);
+            if (skipped > 0)
+                parts.push(`Pominięto ${skipped} ponad limit ${MAX_PHOTOS_PER_CALL}.`);
+            if (saved.length === 0)
+                return err("unavailable", parts.join(" "));
+            return ok(parts.join(" "), { saved, failed });
+        }),
+    };
+}
+function readKinds(args) {
+    const raw = readOptionalStringArray(args, "kinds");
+    if (!raw || raw.length === 0)
+        return DEFAULT_PHOTO_KINDS;
+    const unknown = raw.filter((kind) => !PHOTO_KINDS.includes(kind));
+    if (unknown.length > 0)
+        throw new ArgumentError(`Nieznany rodzaj zdjęć: ${unknown.join(", ")}. Dozwolone: ${PHOTO_KINDS.join(", ")}.`);
+    return raw;
+}
+function countPhotos(photos) {
+    const counts = {};
+    for (const photo of photos)
+        counts[photo.kind] = (counts[photo.kind] ?? 0) + 1;
+    return counts;
+}
+export function degradedSuffix(draft) {
+    return draft.source.degraded
+        ? " UWAGA: odczyt zastępczy — bez czasów trwania, kategorii i galerii; Booksy mogło zmienić stronę."
+        : "";
+}
+/** "-makijaz-okolicznosciowy" for a service or staff photo; empty for the rest. */
+function captionSlug(photo) {
+    if ((photo.kind !== "service" && photo.kind !== "staff") || !photo.caption)
+        return "";
+    const slug = photo.caption
+        .toLowerCase()
+        .replace(/ł/g, "l")
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40);
+    return slug === "" ? "" : `-${slug}`;
+}
+function extensionOf(contentType) {
+    const subtype = contentType.split(";")[0].trim().split("/")[1] ?? "";
+    if (subtype === "jpeg" || subtype === "jpg")
+        return "jpeg";
+    if (subtype === "png" || subtype === "webp" || subtype === "gif")
+        return subtype;
+    return "bin";
+}
+/** `execute` never throws: every failure becomes a result the agent can read. */
+export async function guarded(fallbackSummary, run) {
+    try {
+        return await run();
+    }
+    catch (error) {
+        if (error instanceof ArgumentError)
+            return err("invalid_arguments", error.message);
+        if (error instanceof BooksyReadError)
+            return err(error.code, error.summary);
+        return err("unavailable", fallbackSummary);
+    }
+}

package/dist/ic-salon-core-port.d.ts

@@ -30,6 +30,7 @@ export declare class IcSalonCorePort implements SalonCorePort {
     private readonly availability;
     private readonly assets;
     private readonly promo;
+    private catalog;
     private readonly discountCodes;
     constructor(options: IcSalonCorePortOptions);
     listServices(): Promise<ServiceView[]>;
@@ -38,6 +39,9 @@ export declare class IcSalonCorePort implements SalonCorePort {
     removeService(serviceId: string): Promise<void>;
     listWorkers(): Promise<WorkerView[]>;
     findServiceTypes(query: string): Promise<ServiceTypeView[]>;
+    /** The catalogue changes when a superadmin edits it — rarely — while one Booksy import searches
+     * it dozens of times. One canister query a minute serves them all. */
+    private serviceTypesCatalog;
     getWeeklyHours(workerId: string, day: number): Promise<TimeRange[]>;
     setWeeklyHours(workerId: string, day: number, ranges: TimeRange[]): Promise<void>;
     getDailyBusy(workerId: string, date: string): Promise<TimeRange[]>;

package/dist/ic-salon-core-port.d.ts.map

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

package/dist/ic-salon-core-port.js

@@ -1,5 +1,6 @@
 import { Principal } from "@icp-sdk/core/principal";
 import { AssetsActor, AvailabilityActor, DiscountCodesActor, filterServiceTypes, HrActor, PromoActor, promoMusicOf, SalonServicesActor, ServiceTypesActor, } from "@jsm-mit/sultana-core-motoko-package";
+const SERVICE_TYPES_CATALOG_TTL_MS = 60_000;
 /**
  * The port over the published canister wrapper. Conversions live here and nowhere else: the
  * canister speaks `bigint` and `Principal`, the tools speak numbers and strings.
@@ -14,6 +15,7 @@ export class IcSalonCorePort {
     availability;
     assets;
     promo;
+    catalog = null;
     discountCodes;
     constructor(options) {
         this.salonId = options.salonId;
@@ -62,13 +64,29 @@ export class IcSalonCorePort {
         }));
     }
     async findServiceTypes(query) {
-        const catalog = await this.serviceTypes.getServiceTypesCatalogAsyncUnsafe(this.language);
+        const catalog = await this.serviceTypesCatalog();
         return filterServiceTypes(catalog, query).map((entry) => ({
             id: entry.id,
             label: entry.text,
             category: entry.category,
         }));
     }
+    /** The catalogue changes when a superadmin edits it — rarely — while one Booksy import searches
+     * it dozens of times. One canister query a minute serves them all. */
+    serviceTypesCatalog() {
+        const now = Date.now();
+        if (!this.catalog || now - this.catalog.readAt > SERVICE_TYPES_CATALOG_TTL_MS) {
+            const reply = this.serviceTypes.getServiceTypesCatalogAsyncUnsafe(this.language);
+            const entry = { readAt: now, reply };
+            // A failed read is not kept: the next search asks the canister again.
+            reply.catch(() => {
+                if (this.catalog === entry)
+                    this.catalog = null;
+            });
+            this.catalog = entry;
+        }
+        return this.catalog.reply;
+    }
     async getWeeklyHours(workerId, day) {
         return this.availability.getDayFromWeeklyTemplateAsyncUnsafe(BigInt(day), this.salonId, Principal.fromText(workerId));
     }

package/dist/index.d.ts

@@ -1,5 +1,15 @@
 export { ConfirmationLedger, DEFAULT_CONFIRMATION_TTL_MS } from "./confirmations.js";
 export type { ConfirmationLedgerOptions, ConfirmationRefusal, RedeemResult, TurnConfirmations, } from "./confirmations.js";
+export { BooksyReadError } from "./booksy/fetch-page.js";
+export type { FetchFn } from "./booksy/fetch-page.js";
+export type { BooksyImage, BooksyImageKind, BooksyOpenHours, BooksyPriceType, BooksySalon, BooksyService, BooksyServiceCategory, BooksyStaffer, BooksyVariant, } from "./booksy/parse-salon.js";
+export { parseBooksySalon } from "./booksy/parse-salon.js";
+export { toSultanaDraft } from "./booksy/to-sultana.js";
+export type { SultanaDraftDay, SultanaPhotoDraft, SultanaSalonDraft, SultanaSalonDraftProfile, SultanaServiceDraft, SultanaWorkerDraft, } from "./booksy/to-sultana.js";
+export { createBooksyImportTools, createBooksyTools } from "./booksy/import-tools.js";
+export type { CreateBooksyImportToolsOptions, CreateBooksyToolsOptions } from "./booksy/import-tools.js";
+export { BooksyProfileReader, createBooksyReaderTools, readBooksySalonDraft } from "./booksy/tools.js";
+export type { BooksyPhotoFile, BooksyPhotoSink, CreateBooksyReaderToolsOptions } from "./booksy/tools.js";
 export { createSalonReadTools, createSalonReadToolsFromPort, createSalonTools, createSalonToolsFromPort, } 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";
@@ -15,7 +25,7 @@ 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";
-export { SALON_AGENT_PERSONA_PL, SALON_READ_PERSONA_PL } from "./persona.js";
+export { SALON_AGENT_PERSONA_PL, SALON_BOOKSY_PERSONA_PL, SALON_READ_PERSONA_PL } from "./persona.js";
 export type { DiscountCodeInput, DiscountCodeView, MediaView, PromoView, PromoWriteInput, SalonAccess, SalonCorePort, SalonPromoPort, ServiceTypeView, ServiceView, ServiceWriteInput, SalonSchedulePort, TimeRange, WorkerView, } from "./salon-core-port.js";
 export { err, needsConfirmation, ok } from "./types.js";
 export type { AgentTool, ToolErrorCode, ToolParametersSchema, ToolResult } from "./types.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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,4 +1,9 @@
 export { ConfirmationLedger, DEFAULT_CONFIRMATION_TTL_MS } from "./confirmations.js";
+export { BooksyReadError } from "./booksy/fetch-page.js";
+export { parseBooksySalon } from "./booksy/parse-salon.js";
+export { toSultanaDraft } from "./booksy/to-sultana.js";
+export { createBooksyImportTools, createBooksyTools } from "./booksy/import-tools.js";
+export { BooksyProfileReader, createBooksyReaderTools, readBooksySalonDraft } from "./booksy/tools.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";
@@ -7,5 +12,5 @@ export { CUSTOMER_AGENT_PERSONA_PL, customerAgentPersona } from "./customer/pers
 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";
+export { SALON_AGENT_PERSONA_PL, SALON_BOOKSY_PERSONA_PL, SALON_READ_PERSONA_PL } from "./persona.js";
 export { err, needsConfirmation, ok } from "./types.js";

package/dist/persona.d.ts

@@ -18,4 +18,9 @@ export declare const SALON_AGENT_PERSONA_PL = "Jeste\u015B asystentem w\u0142a\u
  * promising a change or reporting a hidden service as missing.
  */
 export declare const SALON_READ_PERSONA_PL = "Jeste\u015B asystentem w\u0142a\u015Bciciela salonu w aplikacji Sultana.\nRozmawiasz po polsku, kr\u00F3tko i konkretnie. Odpowiadasz na pytania o salon za pomoc\u0105 narz\u0119dzi.\n\nZasady pracy:\n- Zanim odpowiesz o us\u0142ugach, promocjach albo typach us\u0142ug, ZAWSZE wywo\u0142aj narz\u0119dzie\n  (list_services, list_promos, find_service_type). Nigdy nie zgaduj.\n- Widzisz tylko AKTYWNE us\u0142ugi i AKTYWNE promocje \u2014 to, co widz\u0105 klientki.\n  Powiedz o tym, gdy ma to znaczenie, np. gdy w\u0142a\u015Bciciel pyta o us\u0142ug\u0119, kt\u00F3rej nie ma na li\u015Bcie:\n  mo\u017Ce by\u0107 wy\u0142\u0105czona.\n- Nie mo\u017Cesz jeszcze niczego zmienia\u0107. Gdy w\u0142a\u015Bciciel prosi o dodanie, zmian\u0119 albo usuni\u0119cie,\n  powiedz, \u017Ce edycja przez czat b\u0119dzie dost\u0119pna wkr\u00F3tce, i wska\u017C stron\u0119 w panelu:\n  \u201EUs\u0142ugi\u201D dla us\u0142ug, \u201EPromocje\u201D dla promocji.\n- Ceny podawaj w pe\u0142nych z\u0142otych, czas trwania w minutach.\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- Nie obiecuj zmian, kt\u00F3rych nie mo\u017Cesz wykona\u0107.";
+/**
+ * The rules for the Booksy set (`createBooksyTools`) — appended to `SALON_AGENT_PERSONA_PL` by a
+ * host that hands those tools to the agent. Separate, because a host may run without them.
+ */
+export declare const SALON_BOOKSY_PERSONA_PL = "Kopiowanie salonu z Booksy:\n- Gdy w\u0142a\u015Bcicielka chce przenie\u015B\u0107 co\u015B z Booksy, popro\u015B o adres jej profilu\n  (https://booksy.com/pl-pl/<numer>_<nazwa>\u2026), je\u015Bli go nie poda\u0142a.\n- read_booksy_salon i read_booksy_services tylko czytaj\u0105 profil \u2014 niczego nie zapisuj\u0105.\n- Us\u0142ugi kopiuj WY\u0141\u0104CZNIE przez import_booksy_services (wszystkie naraz, jedno potwierdzenie).\n  Nie przepisuj ich pojedynczo przez add_service.\n- Podgl\u0105d importu poka\u017C w\u0142a\u015Bcicielce w ca\u0142o\u015Bci, razem z uwagami pod list\u0105. Poprawki\n  (\u201Epomi\u0144 X\u201D, \u201EX to inny typ\u201D) podaj w overrides i poka\u017C nowy podgl\u0105d.\n- Gdy import wypisze us\u0142ugi, kt\u00F3rym nie dobra\u0142 typu, dobierz typy przez find_service_type,\n  podaj je w overrides i poka\u017C nowy podgl\u0105d.\n- Kopiowania pracownik\u00F3w jeszcze nie ma: wywo\u0142aj import_booksy_workers i przeka\u017C, co odpowie.\n- Nazwy, adresu, opisu i godzin otwarcia salonu nie da si\u0119 jeszcze zmieni\u0107 przez czat \u2014 powiedz to\n  wprost. Nie wymy\u015Blaj innego powodu.";
 //# sourceMappingURL=persona.d.ts.map

package/dist/persona.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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;AAElD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,2nCAYE,CAAC"}

package/dist/persona.js

@@ -58,3 +58,20 @@ Zasady pracy:
 - Jeśli narzędzie zwróci status "error", przeczytaj summary i powiedz właścicielowi,
   co poszło nie tak. Nie powtarzaj tego samego wywołania w kółko.
 - Nie obiecuj zmian, których nie możesz wykonać.`;
+/**
+ * The rules for the Booksy set (`createBooksyTools`) — appended to `SALON_AGENT_PERSONA_PL` by a
+ * host that hands those tools to the agent. Separate, because a host may run without them.
+ */
+export const SALON_BOOKSY_PERSONA_PL = `Kopiowanie salonu z Booksy:
+- Gdy właścicielka chce przenieść coś z Booksy, poproś o adres jej profilu
+  (https://booksy.com/pl-pl/<numer>_<nazwa>…), jeśli go nie podała.
+- read_booksy_salon i read_booksy_services tylko czytają profil — niczego nie zapisują.
+- Usługi kopiuj WYŁĄCZNIE przez import_booksy_services (wszystkie naraz, jedno potwierdzenie).
+  Nie przepisuj ich pojedynczo przez add_service.
+- Podgląd importu pokaż właścicielce w całości, razem z uwagami pod listą. Poprawki
+  („pomiń X”, „X to inny typ”) podaj w overrides i pokaż nowy podgląd.
+- Gdy import wypisze usługi, którym nie dobrał typu, dobierz typy przez find_service_type,
+  podaj je w overrides i pokaż nowy podgląd.
+- Kopiowania pracowników jeszcze nie ma: wywołaj import_booksy_workers i przekaż, co odpowie.
+- Nazwy, adresu, opisu i godzin otwarcia salonu nie da się jeszcze zmienić przez czat — powiedz to
+  wprost. Nie wymyślaj innego powodu.`;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/sultana-agent-tools-package",
-    "version": "0.6.0",
+    "version": "0.7.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": {
@@ -32,6 +32,7 @@
         "prepare": "npm run build",
         "test-tools": "npx tsx --env-file-if-exists=.env --test tests/integration/test-salon-tools.ts",
         "test-customer-tools": "npx tsx --env-file-if-exists=.env --test tests/integration/test-customer-tools.ts",
+        "booksy": "npx tsx sandbox/booksy.ts",
         "whoami": "npx tsx --env-file-if-exists=.env sandbox/whoami.ts",
         "publish-public": "bash scripts/publish-public.sh"
     },