albert-heijn-mcp 1.3.0

package/dist/tools/common.js

@@ -0,0 +1,173 @@
+import { z } from "zod";
+import { getMember, hasStatus } from "../ahapi/index.js";
+import { NotLoggedInError } from "../auth/session.js";
+import { log } from "../log.js";
+import { TtlCache } from "./cache.js";
+export function newToolContext(session, remote) {
+    return {
+        session,
+        remote,
+        searches: new TtlCache(5 * 60_000),
+        products: new TtlCache(10 * 60_000),
+        nutrition: new TtlCache(60 * 60_000),
+        bonuses: new TtlCache(10 * 60_000),
+        bonusPeriods: new TtlCache(10 * 60_000),
+        members: new TtlCache(30 * 60_000),
+    };
+}
+function annotations(title, kind) {
+    switch (kind) {
+        case "readOnly":
+            return { title, readOnlyHint: true };
+        case "additive":
+            return { title, readOnlyHint: false, destructiveHint: false };
+        case "destructive":
+            return { title, readOnlyHint: false, destructiveHint: true };
+    }
+}
+export function text(value) {
+    return { content: [{ type: "text", text: value }] };
+}
+/** A result with structured data, also sent as JSON text for clients without structured output; message replaces the text. */
+export function structured(data, message) {
+    // AH sends null for some missing values; as "absent" they fit the optional fields of the output schemas.
+    const json = JSON.stringify(data, (_key, value) => (value === null ? undefined : value), 2);
+    return { content: [{ type: "text", text: message ?? json }], structuredContent: JSON.parse(json) };
+}
+function errorResult(err) {
+    return { content: [{ type: "text", text: err instanceof Error ? err.message : String(err) }], isError: true };
+}
+/** Registers a tool. Thrown errors become error results; every call is logged. */
+export function addTool(server, def, handler) {
+    const callback = async (args) => {
+        const start = Date.now();
+        try {
+            const result = await handler(args);
+            log.info("tool call", { tool: def.name, duration_ms: Date.now() - start });
+            return result;
+        }
+        catch (err) {
+            log.warn("tool call returned error", { tool: def.name, duration_ms: Date.now() - start, err });
+            return errorResult(err);
+        }
+    };
+    server.registerTool(def.name, {
+        title: def.title,
+        description: def.description + (hasUrl(def.output) ? LINK_HINT : ""),
+        inputSchema: def.input ?? {},
+        outputSchema: def.output,
+        annotations: annotations(def.title, def.kind),
+    }, 
+    // Typed via Args<Shape> above; the SDK's generic callback type doesn't infer here.
+    callback);
+}
+/** Appended to tools whose results have ah.nl links; tool descriptions reach the model in every client. */
+const LINK_HINT = " When you mention a product or recipe from the result, link its name to its url.";
+/** Reports whether results of this output shape include a url field anywhere. */
+function hasUrl(output) {
+    return output !== undefined && JSON.stringify(z.toJSONSchema(z.object(output))).includes('"url"');
+}
+const NOT_AUTHENTICATED = JSON.stringify({
+    error: "not_authenticated",
+    message: "Not logged in. Call ah_login first.",
+});
+/** Registers a tool that needs a login. On a 401, refreshes the token and retries once. */
+export function addAuthedTool(server, ctx, def, handler) {
+    addTool(server, def, async (args) => {
+        try {
+            const c = await ctx.session.client();
+            try {
+                return await handler(c, args);
+            }
+            catch (err) {
+                if (!isUnauthorized(err) || !c.token)
+                    throw err;
+                return await handler(await ctx.session.refreshAfterRejection(c.token), args);
+            }
+        }
+        catch (err) {
+            throw err instanceof NotLoggedInError ? new Error(NOT_AUTHENTICATED) : err;
+        }
+    });
+}
+/** Reports whether err, or any error in its cause chain, is an HTTP 401 from AH. */
+export function isUnauthorized(err) {
+    for (let e = err; e instanceof Error; e = e.cause) {
+        if (hasStatus(e, 401))
+            return true;
+    }
+    return false;
+}
+export { wrapError } from "../ahapi/index.js";
+/** Runs fn; a non-401 error goes to onError. 401s propagate so addAuthedTool can refresh the token. */
+export async function nonFatal(fn, onError) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (isUnauthorized(err))
+            throw err;
+        return onError(err);
+    }
+}
+/** The logged-in member's profile, cached. */
+export function cachedMember(ctx, c) {
+    return ctx.members.getOrLoad(c.token ?? "", () => getMember(c));
+}
+/** v if positive, else def. */
+export function orDefault(v, def) {
+    return v && v > 0 ? v : def;
+}
+/** Runs fn(0..n-1) with at most limit in flight. */
+export async function parallel(n, limit, fn) {
+    let next = 0;
+    const worker = async () => {
+        while (next < n)
+            await fn(next++);
+    };
+    await Promise.all(Array.from({ length: Math.min(limit, n) }, worker));
+}
+const amsterdam = new Intl.DateTimeFormat("sv-SE", {
+    timeZone: "Europe/Amsterdam",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+});
+/** ISO 8601 → "YYYY-MM-DD[ HH:MM]" in Dutch time; returns s unchanged if unparsable. */
+export function formatDate(s, withTime) {
+    if (!s)
+        return "";
+    const d = new Date(s);
+    if (Number.isNaN(d.getTime()))
+        return s;
+    const formatted = amsterdam.format(d); // "YYYY-MM-DD HH:MM"
+    return withTime ? formatted : formatted.slice(0, 10);
+}
+/** ISO 8601 → "HH:MM" in Dutch time. */
+export function formatTime(s) {
+    return formatDate(s, true).slice(11);
+}
+/** Up to 3 attempts on rate limiting (429), waiting 1 s then 2 s. */
+export async function withRetry(tool, fn) {
+    for (let attempt = 0;; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (attempt === 2 || !isRateLimited(err))
+                throw err;
+            const waitMs = 1000 * 2 ** attempt;
+            log.warn("rate limited by AH, retrying", { tool, wait_ms: waitMs, attempt: attempt + 1 });
+            await new Promise((resolve) => setTimeout(resolve, waitMs));
+        }
+    }
+}
+function isRateLimited(err) {
+    if (hasStatus(err, 429))
+        return true;
+    const msg = err instanceof Error ? err.message.toLowerCase() : "";
+    return msg.includes("rate limit") || msg.includes("too many requests");
+}
+//# sourceMappingURL=common.js.map

package/dist/tools/common.js.map

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

package/dist/tools/favorites.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { addToFavoriteList, createFavoriteList, deleteFavoriteList, getFavoriteLists, GraphQLError, removeFromFavoriteList, } from "../ahapi/index.js";
+import { addAuthedTool, orDefault, structured, text, withRetry } from "./common.js";
+import { confirmInput } from "./shoppingList.js";
+import { favoriteListView, viewFavoriteList } from "./views.js";
+const listId = z.string().describe("Favorite list ID from ah_get_favorite_lists");
+export function registerFavoriteListTools(server, ctx) {
+    addAuthedTool(server, ctx, {
+        name: "ah_get_favorite_lists",
+        title: "Albert Heijn: View Favourite Lists",
+        kind: "readOnly",
+        output: { lists: z.array(favoriteListView) },
+        description: "List all Albert Heijn favorite/saved shopping lists with their names and item counts. " +
+            "Use the returned list ID with ah_add_to_favorite_list, ah_remove_from_favorite_list or ah_delete_favorite_list.",
+    }, async (c) => {
+        const lists = await getFavoriteLists(c);
+        return structured({ lists: lists.map(viewFavoriteList) }, lists.length ? undefined : "You have no favorite lists.");
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_add_to_favorite_list",
+        title: "Albert Heijn: Add to Favourite List",
+        kind: "additive",
+        description: "Add products to a named Albert Heijn favorite list. Get list_id from ah_get_favorite_lists.",
+        input: {
+            list_id: listId,
+            items: z
+                .array(z.object({ product_id: z.number().int(), quantity: z.number().int() }))
+                .describe('Items to add, e.g. [{"product_id": 123456, "quantity": 1}]. Quantity 0 is treated as 1.'),
+        },
+    }, async (c, args) => {
+        if (!args.list_id)
+            throw new Error("list_id is required");
+        const quantities = new Map();
+        for (const it of args.items)
+            if (it.product_id > 0)
+                quantities.set(it.product_id, orDefault(it.quantity, 1));
+        if (quantities.size === 0)
+            throw new Error("no valid items provided");
+        await addToFavoriteList(c, args.list_id, quantities);
+        return text(`Added ${quantities.size} item(s) to favorite list ${args.list_id}.`);
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_remove_from_favorite_list",
+        title: "Albert Heijn: Remove from Favourite List",
+        kind: "destructive",
+        description: "Remove products from a named Albert Heijn favorite list. Get list_id from ah_get_favorite_lists.",
+        input: {
+            list_id: listId,
+            product_ids: z.array(z.number().int()).describe("Product IDs to remove, e.g. [123456, 789012]"),
+        },
+    }, async (c, args) => {
+        if (!args.list_id)
+            throw new Error("list_id is required");
+        const ids = args.product_ids.filter((id) => id > 0);
+        if (ids.length === 0)
+            throw new Error("no valid product_ids provided");
+        const removed = await removeFromFavoriteList(c, args.list_id, ids);
+        return text(`Removed ${removed} product(s) from favorite list ${args.list_id}.`);
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_create_favorite_list",
+        title: "Albert Heijn: Create Favourite List",
+        kind: "additive",
+        output: favoriteListView.shape,
+        description: "Create a new, empty Albert Heijn favorite list with the given name; AH drops some punctuation, such as '-'. " +
+            "Returns its id; add products with ah_add_to_favorite_list.",
+        input: { name: z.string().describe("Name of the list, e.g. 'Weekend' or 'Pasta night'") },
+    }, async (c, args) => {
+        const name = args.name.trim();
+        if (!name)
+            throw new Error("name is required");
+        return structured(viewFavoriteList(await createFavoriteList(c, name)));
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_delete_favorite_list",
+        title: "Albert Heijn: Delete Favourite List",
+        kind: "destructive",
+        description: 'Delete an Albert Heijn favorite list and everything on it. Irreversible — requires confirm="yes". ' +
+            "Get list_id from ah_get_favorite_lists.",
+        input: { list_id: listId, ...confirmInput },
+    }, async (c, args) => {
+        if (args.confirm !== "yes")
+            throw new Error('confirm must be "yes" to delete the list');
+        if (!args.list_id)
+            throw new Error("list_id is required");
+        // AH answers an unknown id with the same redacted error as an outage; all lists tells them apart.
+        const list = await withRetry("ah_delete_favorite_list", async () => {
+            try {
+                return (await getFavoriteLists(c, [args.list_id]))[0];
+            }
+            catch (err) {
+                if (!(err instanceof GraphQLError))
+                    throw err;
+                return (await getFavoriteLists(c)).find((l) => l.id === args.list_id);
+            }
+        });
+        if (!list)
+            throw new Error(`favorite list ${args.list_id} not found`);
+        await deleteFavoriteList(c, list.id);
+        return text(`Deleted favorite list "${list.name}" (${list.itemCount} items).`);
+    });
+}
+//# sourceMappingURL=favorites.js.map

package/dist/tools/favorites.js.map

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

package/dist/tools/index.js

@@ -0,0 +1,24 @@
+import { registerAccountTools } from "./account.js";
+import { registerBonusTools } from "./bonus.js";
+import { registerCartTools } from "./cart.js";
+import { registerFavoriteListTools } from "./favorites.js";
+import { registerOrderTools } from "./orders.js";
+import { registerProductTools } from "./products.js";
+import { registerReceiptTools } from "./receipts.js";
+import { registerRecipeTools } from "./recipes.js";
+import { registerShoppingListTools } from "./shoppingList.js";
+import { registerStoreTools } from "./stores.js";
+export { newToolContext } from "./common.js";
+export function registerTools(server, ctx) {
+    registerAccountTools(server, ctx);
+    registerProductTools(server, ctx);
+    registerBonusTools(server, ctx);
+    registerRecipeTools(server, ctx);
+    registerStoreTools(server, ctx);
+    registerShoppingListTools(server, ctx);
+    registerFavoriteListTools(server, ctx);
+    registerCartTools(server, ctx);
+    registerOrderTools(server, ctx);
+    registerReceiptTools(server, ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAoB,MAAM,aAAa,CAAC;AAE/D,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,GAAgB;IAC/D,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,yBAAyB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,yBAAyB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/tools/orders.js

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import { getFulfillments, getOrderDetails, productUrl } from "../ahapi/index.js";
+import { log } from "../log.js";
+import { addAuthedTool, nonFatal, orDefault, parallel, structured, withRetry } from "./common.js";
+import { orderView, viewOrder } from "./views.js";
+/** Status of a cancelled order; AH reports statuses in Dutch ("Geannuleerd"). */
+const CANCELLED = /geannuleerd|cancel/i;
+export function registerOrderTools(server, ctx) {
+    addAuthedTool(server, ctx, {
+        name: "ah_get_orders",
+        title: "Albert Heijn: Orders",
+        kind: "readOnly",
+        output: {
+            orders: z.array(z.object({
+                id: z.number(),
+                date: z.string().optional(),
+                time_window: z.string().optional(),
+                total_price: z.number().optional(),
+                status: z.string().optional(),
+                shopping_type: z.string().optional(),
+                modifiable: z.boolean().optional(),
+            })),
+        },
+        description: "List Albert Heijn online delivery orders. " +
+            "By default returns upcoming orders (with a modifiable flag); set past=true for delivered orders. " +
+            "Returns id, date, time_window, total_price, status. " +
+            "Use the returned id with ah_get_order_details to see the items.",
+        input: {
+            past: z.boolean().optional().describe("Return delivered orders instead of upcoming ones"),
+            limit: z.number().int().optional().describe("Maximum number of orders to return (default 10)"),
+        },
+    }, async (c, { past, limit }) => {
+        const fulfillments = await getFulfillments(c, Boolean(past));
+        const empty = past ? "No past orders found." : "No upcoming orders.";
+        return structured({
+            orders: fulfillments.slice(0, orDefault(limit, 10)).map((f) => ({
+                id: f.orderId,
+                date: f.dateDisplay || f.date || undefined,
+                time_window: f.timeDisplay || undefined,
+                total_price: f.totalPrice ?? undefined,
+                status: f.status,
+                shopping_type: f.shoppingType || undefined,
+                modifiable: past ? undefined : f.modifiable,
+            })),
+        }, fulfillments.length ? undefined : empty);
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_get_order_details",
+        title: "Albert Heijn: Order Details",
+        kind: "readOnly",
+        output: orderView.shape,
+        description: "Get the full item list for a specific Albert Heijn delivery order by its ID. " +
+            "Returns all products with names, quantities, and prices. " +
+            "Get order_id from ah_get_orders.",
+        input: { order_id: z.number().int().describe("Numeric order ID from ah_get_orders") },
+    }, async (c, { order_id }) => {
+        if (order_id <= 0)
+            throw new Error("order_id is required");
+        return structured(viewOrder(await getOrderDetails(c, order_id)));
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_get_frequent_items",
+        title: "Albert Heijn: Frequently Ordered Items",
+        kind: "readOnly",
+        output: {
+            products: z.array(z.object({
+                product_name: z.string(),
+                product_id: z.number(),
+                order_count: z.number(),
+                last_ordered_date: z.string().optional(),
+                url: z.string(),
+            })),
+        },
+        description: "Get frequently ordered products by analysing order history. " +
+            "Fetches all fulfillments, expands each order's items, counts per product, " +
+            "and returns products ordered at least min_order_count times. " +
+            "Returns product_name, product_id, order_count, last_ordered_date.",
+        input: {
+            min_order_count: z
+                .number()
+                .int()
+                .optional()
+                .describe("Minimum number of orders a product must appear in (default 3)"),
+        },
+    }, async (c, args) => {
+        const minCount = orDefault(args.min_order_count, 3);
+        const [open, closed] = await Promise.all([
+            getFulfillments(c, false),
+            nonFatal(() => getFulfillments(c, true), (err) => {
+                // Continue with open orders only.
+                log.warn("could not fetch past orders", { tool: "ah_get_frequent_items", err });
+                return [];
+            }),
+        ]);
+        // Cancelled orders were never delivered, so they don't count as purchases.
+        const refs = [...open, ...closed.filter((f) => !CANCELLED.test(f.status))];
+        const orders = new Array(refs.length);
+        await parallel(refs.length, 5, async (i) => {
+            const id = refs[i].orderId;
+            orders[i] = await nonFatal(() => withRetry("ah_get_frequent_items", () => getOrderDetails(c, id)), (err) => {
+                log.warn("could not fetch order", { tool: "ah_get_frequent_items", order_id: id, err });
+                return undefined;
+            });
+        });
+        const stats = new Map();
+        orders.forEach((order, i) => {
+            if (!order)
+                return;
+            const date = refs[i].date ?? "";
+            // First title per product; an order lists a product at most once in the count.
+            const titles = new Map();
+            for (const it of order.items)
+                if (!titles.has(it.productId))
+                    titles.set(it.productId, it.title);
+            for (const [productId, title] of titles) {
+                const name = title || String(productId);
+                let s = stats.get(productId);
+                if (!s) {
+                    s = { product_name: name, product_id: productId, order_count: 0, last_ordered_date: "" };
+                    stats.set(productId, s);
+                }
+                s.order_count++;
+                if (date > s.last_ordered_date) {
+                    s.last_ordered_date = date;
+                    s.product_name = name;
+                }
+            }
+        });
+        return structured({
+            products: [...stats.values()]
+                .filter((s) => s.order_count >= minCount)
+                .sort((a, b) => b.order_count - a.order_count)
+                .map((s) => ({
+                ...s,
+                url: productUrl(s.product_id, s.product_name),
+                last_ordered_date: s.last_ordered_date || undefined,
+            })),
+        });
+    });
+}
+//# sourceMappingURL=orders.js.map

package/dist/tools/orders.js.map

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

package/dist/tools/products.js

@@ -0,0 +1,165 @@
+import { z } from "zod";
+import { getNutrition, getProduct, getProductAlternatives, searchProducts, } from "../ahapi/index.js";
+import { addAuthedTool, nonFatal, orDefault, parallel, structured, withRetry } from "./common.js";
+import { detailProduct, productDetail, productSummary, summarizeProduct } from "./views.js";
+const MAX_QUERIES = 10;
+const MAX_PRODUCT_IDS = 20;
+/** Search filters → AH property ids. */
+const FILTERS = {
+    organic: "np_biologisch",
+    prijsfavoriet: "np_verbluffen",
+    new: "np_nieuw",
+    frozen: "diepvries",
+    vegan: "sp_include_dieet_veganistisch",
+    vegetarian: "sp_include_dieet_vegetarisch",
+    low_sugar: "sp_include_dieet_laag_suiker",
+    low_fat: "sp_include_dieet_laag_vet",
+    low_salt: "sp_include_dieet_laag_zout",
+    gluten_free: "sp_include_intolerance_geen_gluten",
+    lactose_free: "sp_include_intolerance_geen_lactose",
+    milk_free: "sp_include_intolerance_geen_melk",
+    egg_free: "sp_include_intolerance_geen_eieren",
+    nut_free: "sp_include_intolerance_geen_noten",
+    peanut_free: "sp_include_intolerance_geen_pindas",
+    soy_free: "sp_include_intolerance_geen_soja",
+    fish_free: "sp_include_intolerance_geen_vis",
+    shellfish_free: "sp_include_intolerance_geen_schelpdieren",
+    sesame_free: "sp_include_intolerance_geen_sesam",
+    celery_free: "sp_include_intolerance_geen_selderij",
+    mustard_free: "sp_include_intolerance_geen_mosterd",
+    lupin_free: "sp_include_intolerance_geen_lupine",
+    sulphite_free: "sp_include_intolerance_geen_sulfiet",
+};
+const SORTS = {
+    relevance: "RELEVANCE",
+    price_low_high: "PRICELOWHIGH",
+    price_high_low: "PRICEHIGHLOW",
+    most_bought: "PURCHASE_FREQUENCY",
+    nutriscore: "NUTRISCORE",
+};
+export function registerProductTools(server, ctx) {
+    addAuthedTool(server, ctx, {
+        name: "ah_search_products",
+        title: "Albert Heijn: Search Products",
+        kind: "readOnly",
+        description: "Search Albert Heijn (Dutch supermarket) products by keyword. " +
+            "Pass one or more queries (max 10) to search for several products in one call. " +
+            "Prefer Dutch search terms for best results: " +
+            "e.g. 'melk' (milk), 'kaas' (cheese), 'brood' (bread), 'kip' (chicken), 'appel' (apple). " +
+            "Set bonus=true to return only products currently on promotion. " +
+            "filters narrows results to products matching all of them, e.g. ['organic', 'gluten_free']: " +
+            "organic, prijsfavoriet (AH's budget label), new, frozen, a diet (vegan, vegetarian, low_sugar, low_fat, low_salt), " +
+            "or free from an allergen (gluten_free, lactose_free, milk_free, egg_free, nut_free, peanut_free, soy_free, " +
+            "fish_free, shellfish_free, sesame_free, celery_free, mustard_free, lupin_free, sulphite_free). " +
+            "sort orders results: relevance (default), price_low_high, price_high_low, most_bought (by this user), nutriscore. " +
+            "Returns, per query: id, title, price, bonus_price, unit, is_bonus, bonus_mechanism, image_url.",
+        input: {
+            queries: z
+                .array(z.string())
+                .describe('Search queries in Dutch or English, e.g. ["melk"] or ["melk", "kaas", "brood"] (max 10)'),
+            limit: z
+                .number()
+                .int()
+                .optional()
+                .describe("Maximum results per query (default 10 for one query, 5 for several; max 30)"),
+            bonus: z.boolean().optional().describe("Return only products currently on bonus/promotion"),
+            filters: z
+                .array(z.enum(Object.keys(FILTERS)))
+                .optional()
+                .describe('Only products matching all of these, e.g. ["organic", "vegan"]'),
+            sort: z
+                .enum(Object.keys(SORTS))
+                .optional()
+                .describe("Result order (default relevance)"),
+        },
+        output: {
+            searches: z.array(z.object({ query: z.string(), results: z.array(productSummary), error: z.string().optional() })),
+        },
+    }, async (c, { queries, limit, bonus, filters, sort }) => {
+        const qs = queries.filter(Boolean).slice(0, MAX_QUERIES);
+        if (qs.length === 0)
+            throw new Error("provide at least one search query");
+        const perQuery = Math.min(orDefault(limit, qs.length > 1 ? 5 : 10), 30);
+        const results = qs.map((query) => ({
+            query,
+            results: [],
+            error: undefined,
+        }));
+        const opts = {
+            bonus: Boolean(bonus),
+            properties: [...new Set(filters ?? [])].map((f) => FILTERS[f]).sort(),
+            sort: SORTS[sort ?? "relevance"],
+        };
+        await parallel(qs.length, 3, async (i) => {
+            const r = results[i];
+            await nonFatal(async () => {
+                r.results = (await search(ctx, c, r.query, perQuery, opts)).map(summarizeProduct);
+            }, (err) => {
+                r.error = err.message;
+            });
+        });
+        return structured({ searches: results });
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_get_products",
+        title: "Albert Heijn: Product Details",
+        kind: "readOnly",
+        description: "Get detailed information about one or more Albert Heijn products by ID (max 20). " +
+            "Returns title, brand, category, description, price, unit size, bonus info, NutriScore, property icons. " +
+            "Set include_nutritional_info=true to also return calories, fat, protein, etc. " +
+            "Get product IDs from ah_search_products.",
+        input: {
+            product_ids: z
+                .array(z.number().int())
+                .describe("Product IDs from ah_search_products, e.g. [123456] or [123456, 789012] (max 20)"),
+            include_nutritional_info: z.boolean().optional().describe("Include nutritional values (default false)"),
+        },
+        output: {
+            products: z.array(z.union([productDetail, z.object({ id: z.number(), error: z.string() })])),
+        },
+    }, async (c, { product_ids, include_nutritional_info }) => {
+        const ids = product_ids.filter((id) => id > 0).slice(0, MAX_PRODUCT_IDS);
+        if (ids.length === 0)
+            throw new Error("provide at least one product ID");
+        const results = new Array(ids.length);
+        await parallel(ids.length, 5, async (i) => {
+            const id = ids[i];
+            const key = String(id);
+            results[i] = await nonFatal(async () => {
+                const p = await ctx.products.getOrLoad(key, () => withRetry("ah_get_products", () => getProduct(c, id)));
+                const nutrition = include_nutritional_info
+                    ? await ctx.nutrition.getOrLoad(key, () => withRetry("ah_get_products", () => getNutrition(c, id)))
+                    : undefined;
+                return detailProduct(p, nutrition);
+            }, (err) => ({ id, error: err.message }));
+        });
+        return structured({ products: results });
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_get_product_alternatives",
+        title: "Albert Heijn: Product Alternatives",
+        kind: "readOnly",
+        description: "Get products Albert Heijn suggests instead of a given product: similar products and substitutes, " +
+            "e.g. when it is sold out or to find a cheaper or organic option. " +
+            "Returns the same fields as ah_search_products.",
+        input: {
+            product_id: z.number().int().describe("Product ID, e.g. from ah_search_products or ah_get_shopping_list"),
+            limit: z.number().int().optional().describe("Maximum number of alternatives (default 10, max 30)"),
+        },
+        output: { products: z.array(productSummary) },
+    }, async (c, args) => {
+        if (args.product_id <= 0)
+            throw new Error("product_id is required");
+        const size = Math.min(orDefault(args.limit, 10), 30);
+        const alternatives = await ctx.searches.getOrLoad(`alternatives:${args.product_id}:${size}`, () => withRetry("ah_get_product_alternatives", () => getProductAlternatives(c, args.product_id, size)));
+        const message = alternatives.length ? undefined : `AH suggests no alternatives for product ${args.product_id}.`;
+        return structured({ products: alternatives.map(summarizeProduct) }, message);
+    });
+}
+/** Cached, retried product search. */
+export function search(ctx, c, query, limit, opts) {
+    // most_bought orders by this account's purchases, so it is cached per login.
+    const account = opts.sort === "PURCHASE_FREQUENCY" ? c.token : undefined;
+    return ctx.searches.getOrLoad(JSON.stringify([query, limit, opts, account]), () => withRetry("ah_search_products", () => searchProducts(c, query, limit, opts)));
+}
+//# sourceMappingURL=products.js.map