albert-heijn-mcp 1.3.0

package/dist/tools/products.js.map

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

package/dist/tools/receipts.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { getReceipt, getReceipts } from "../ahapi/index.js";
+import { addAuthedTool, formatDate, orDefault, structured } from "./common.js";
+export function registerReceiptTools(server, ctx) {
+    addAuthedTool(server, ctx, {
+        name: "ah_get_receipts",
+        title: "Albert Heijn: Receipts",
+        kind: "readOnly",
+        output: { receipts: z.array(z.object({ id: z.string(), date: z.string(), total_amount: z.number() })) },
+        description: "List recent Albert Heijn in-store receipts (kassabonnen). " +
+            "Returns receipt id, date, and total amount. " +
+            "Use ah_get_receipt_details with the id to see individual items.",
+        input: { limit: z.number().int().optional().describe("Maximum number of results to return (default 10)") },
+    }, async (c, { limit }) => {
+        const receipts = await getReceipts(c, Math.min(orDefault(limit, 10), 50));
+        return structured({
+            receipts: receipts.map((r) => ({ id: r.id, date: formatDate(r.dateTime, true), total_amount: r.total })),
+        });
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_get_receipt_details",
+        title: "Albert Heijn: Receipt Details",
+        kind: "readOnly",
+        output: {
+            id: z.string(),
+            items: z.array(z.object({ name: z.string(), quantity: z.number().optional(), unit_price: z.number().optional(), total: z.number() })),
+            discounts: z.array(z.object({ name: z.string(), amount: z.number() })).optional(),
+            payments: z.array(z.object({ method: z.string(), amount: z.number() })).optional(),
+        },
+        description: "Get full details of a single Albert Heijn in-store receipt (kassabon) by its id. " +
+            "Returns all purchased items with name, quantity, unit price and line total, " +
+            "plus any discounts and payment method. " +
+            "Get the id from ah_get_receipts first.",
+        input: { id: z.string().describe("Receipt transaction ID from ah_get_receipts") },
+    }, async (c, { id }) => {
+        if (!id)
+            throw new Error("id is required");
+        const r = await getReceipt(c, id);
+        return structured({
+            id: r.id,
+            items: r.items.map((it) => ({
+                name: it.name,
+                quantity: it.quantity || undefined,
+                unit_price: it.unitPrice || undefined,
+                total: it.total,
+            })),
+            discounts: r.discounts.length ? r.discounts : undefined,
+            payments: r.payments.length ? r.payments : undefined,
+        });
+    });
+}
+//# sourceMappingURL=receipts.js.map

package/dist/tools/receipts.js.map

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

package/dist/tools/recipes.js

@@ -0,0 +1,261 @@
+import { z } from "zod";
+import { addProductsToShoppingList, getRecipe, recipeUrl, searchRecipes } from "../ahapi/index.js";
+import { addAuthedTool, nonFatal, orDefault, parallel, structured, wrapError } from "./common.js";
+import { search } from "./products.js";
+import { listCall } from "./shoppingList.js";
+import { productSummary, summarizeProduct } from "./views.js";
+const num = z.number().optional();
+const str = z.string().optional();
+const strs = z.array(z.string()).optional();
+/** Words that mark an ingredient nobody buys: "kokend water", "500 ml water", not "waterkers" or "kokoswater". */
+const TAP_WATER = new Set(["water", "kraanwater", "ijswater"]);
+/** Search results scored per ingredient: AH ranks flavoured products (apple yoghurt) above plain ones (apples). */
+const CANDIDATES = 20;
+/** Words that say nothing about what the product is: labels, packaging and filler. */
+const NEUTRAL = new Set(["ah", "biologisch", "biologische", "bio", "excellent", "basic", "terra", "vers", "verse", "stuk", "stuks", "per"].concat(["uit", "in", "met", "van", "en", "of", "de", "het", "een"], ["blik", "pot", "potje", "pak", "zak", "fles", "schaal", "net", "doos", "doosje", "bak", "bakje", "tros"]));
+/** Product types that make a title a flavoured product ("knijpyoghurt appel", "crackers zout") unless the ingredient names them. */
+const PRODUCT_TYPES = ["yoghurt", "kwark", "vla", "toetje", "sap", "drank", "limonade", "smoothie", "thee"].concat(["crackers", "chips", "pretzels", "popcorn", "koek", "koekjes", "wafels", "reep", "snoep", "zoutjes", "ijs"]);
+/** Dutch adjective forms: "rode paprika" is AH's "Paprika rood". */
+const BASE = { rode: "rood", gele: "geel", groene: "groen", witte: "wit", zwarte: "zwart", zoete: "zoet" };
+/** Lowercase words without accents or neutral ones, e.g. for a search query. */
+const plainWords = (s) => s
+    .normalize("NFKD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .split(/[^a-z]+/)
+    .filter((w) => w.length > 1 && !NEUTRAL.has(w));
+/** plainWords with adjectives in their base form, for comparing. */
+const words = (s) => plainWords(s).map((w) => BASE[w] ?? w);
+/** Regular plural and diminutive endings: "uien", "appeltjes". Irregular ones like "eieren" are not covered. */
+const ENDINGS = ["s", "en", "n", "tje", "tjes"];
+const sameWord = (a, b) => a === b || ENDINGS.some((e) => b === a + e || a === b + e);
+/**
+ * How well a product title names an ingredient: matched ingredient words, minus 0.1 per other title
+ * word, which ready meals and mixes have many of, and 0.3 more per product type (yoghurt, crackers) the
+ * ingredient doesn't name. A word or its plural counts 1. Dutch compounds end in
+ * their noun, so a shared end counts 0.75 ("tarwebloem" is flour) and a shared start only 0.25
+ * ("bloemkool" is not); both need 4+ letters in common.
+ */
+function matchScore(ingredient, title) {
+    const want = words(ingredient);
+    const have = words(title);
+    if (want.length === 0)
+        return 0;
+    const used = new Set();
+    let matched = 0;
+    for (const w of want) {
+        let best = 0;
+        let bestWord = "";
+        for (const t of have) {
+            const long = Math.min(t.length, w.length) >= 4;
+            const score = sameWord(w, t)
+                ? 1
+                : long && (t.endsWith(w) || w.endsWith(t))
+                    ? 0.75
+                    : long && (t.startsWith(w) || w.startsWith(t))
+                        ? 0.25
+                        : 0;
+            if (score > best)
+                [best, bestWord] = [score, t];
+        }
+        matched += best;
+        if (bestWord)
+            used.add(bestWord);
+    }
+    if (matched === 0)
+        return 0;
+    const extra = have.filter((t) => !used.has(t)).length;
+    // Matched words count too: "zoutjes" (a snack) is not "zout".
+    const flavoured = have.filter((t) => !want.includes(t) && PRODUCT_TYPES.some((type) => t.endsWith(type))).length;
+    return matched / want.length - 0.1 * extra - 0.3 * flavoured;
+}
+/** The best-named product for an ingredient; among equally good ones, one on bonus if preferBonus. */
+function pickProduct(ingredient, products, preferBonus) {
+    const scored = products.map((p) => ({ p, score: matchScore(ingredient, p.title) })).filter((x) => x.score > 0);
+    if (scored.length === 0)
+        return undefined;
+    const best = Math.max(...scored.map((x) => x.score));
+    const top = scored.filter((x) => x.score === best).map((x) => x.p);
+    return (preferBonus && top.find((p) => p.isBonus)) || top[0];
+}
+export function registerRecipeTools(server, ctx) {
+    addAuthedTool(server, ctx, {
+        name: "ah_search_recipes",
+        title: "Albert Heijn: Search Recipes",
+        kind: "readOnly",
+        description: "Search Allerhande, Albert Heijn's recipe collection. Dutch search terms work best, " +
+            "e.g. 'pasta', 'vegetarisch', 'stamppot', 'kip curry'. " +
+            "Returns id, title, url, cook_minutes, servings, courses, nutri_score, rating. " +
+            "Use the id with ah_get_recipe for ingredients and steps.",
+        input: {
+            query: z.string().describe("Search text, e.g. 'pasta zalm'"),
+            limit: z.number().int().optional().describe("Maximum number of results (default 10, max 30)"),
+        },
+        output: {
+            total: z.number(),
+            recipes: z.array(z.object({
+                id: z.number(),
+                title: z.string(),
+                url: z.string(),
+                cook_minutes: num,
+                oven_minutes: num,
+                wait_minutes: num,
+                servings: str,
+                courses: strs,
+                nutri_score: str,
+                rating: str,
+            })),
+        },
+    }, async (c, args) => {
+        if (!args.query.trim())
+            throw new Error("query is required");
+        const { total, recipes } = await searchRecipes(c, args.query, Math.min(orDefault(args.limit, 10), 30));
+        const message = recipes.length ? undefined : `No recipes found for "${args.query}".`;
+        return structured({
+            total,
+            recipes: recipes.map((r) => ({
+                id: r.id,
+                title: r.title,
+                url: recipeUrl(r.id, r.slug),
+                cook_minutes: r.time?.cook || undefined,
+                oven_minutes: r.time?.oven || undefined,
+                wait_minutes: r.time?.wait || undefined,
+                servings: r.serving ? `${r.serving.number} ${r.serving.type}` : undefined,
+                courses: r.courses?.length ? r.courses : undefined,
+                nutri_score: r.nutriScore || undefined,
+                rating: rating(r.rating),
+            })),
+        }, message);
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_get_recipe",
+        title: "Albert Heijn: Recipe",
+        kind: "readOnly",
+        description: "Get an Allerhande recipe by id: ingredients, preparation steps, and nutrition per serving. " +
+            "Set servings to scale the ingredient quantities. " +
+            "To shop for it, search the ingredients with ah_search_products and add them with ah_add_to_shopping_list.",
+        input: {
+            recipe_id: z.number().int().describe("Recipe id from ah_search_recipes"),
+            servings: z.number().int().optional().describe("Number of servings to scale the ingredients to"),
+        },
+        output: {
+            id: z.number(),
+            title: z.string(),
+            url: z.string(),
+            description: str,
+            cook_minutes: num,
+            servings: z.string(),
+            courses: strs,
+            cuisines: strs,
+            nutri_score: str,
+            rating: str,
+            ingredients: z.array(z.string()),
+            steps: z.array(z.string()),
+            nutrition_per_serving: z.record(z.string(), z.string()).optional(),
+        },
+    }, async (c, args) => {
+        if (args.recipe_id <= 0)
+            throw new Error("recipe_id is required");
+        const servings = args.servings && args.servings > 0 ? args.servings : undefined;
+        const r = await getRecipe(c, args.recipe_id, servings).catch((err) => {
+            // AH redacts the reason, which is usually an unknown id. The cause keeps a 401 visible.
+            throw wrapError(`could not get recipe ${args.recipe_id}; check the id`, err);
+        });
+        const n = r.nutritions;
+        return structured({
+            id: r.id,
+            title: r.title,
+            url: `https://www.ah.nl${r.href}`,
+            description: r.description || undefined,
+            cook_minutes: r.cookTime || undefined,
+            servings: `${servings ?? r.servings.number} ${r.servings.type}`,
+            courses: r.courses?.length ? r.courses : undefined,
+            cuisines: r.cuisines?.length ? r.cuisines : undefined,
+            nutri_score: r.nutriScore || undefined,
+            rating: rating(r.rating),
+            ingredients: r.ingredients.map((i) => i.text),
+            steps: r.preparation?.steps ?? [],
+            nutrition_per_serving: n
+                ? Object.fromEntries(Object.values(n)
+                    .filter((x) => x != null)
+                    .map((x) => [x.name, `${x.value} ${x.unit}`]))
+                : undefined,
+        });
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_add_recipe_to_shopping_list",
+        title: "Albert Heijn: Add Recipe to Shopping List",
+        kind: "additive",
+        description: "Put the ingredients of an Allerhande recipe on the shopping list in one step. " +
+            "Each ingredient is matched to the AH product whose name fits it best (among equally good matches, " +
+            "one on bonus unless prefer_bonus=false); " +
+            "one unit of each product is added. Water is always skipped; pass skip for anything the user already has " +
+            "(e.g. olive oil, salt). Set dry_run=true to show the matches without adding them. " +
+            "Returns the added, skipped and unmatched ingredients, and any whose search failed (worth retrying).",
+        input: {
+            recipe_id: z.number().int().describe("Recipe id from ah_search_recipes"),
+            servings: z.number().int().optional().describe("Number of servings, as in ah_get_recipe"),
+            skip: z.array(z.string()).optional().describe('Ingredients to leave out, matched by name, e.g. ["olijfolie", "zout"]'),
+            prefer_bonus: z.boolean().optional().describe("Prefer a matching product on bonus (default true)"),
+            dry_run: z.boolean().optional().describe("Only show the matches; don't add anything"),
+        },
+        output: {
+            recipe: z.string(),
+            added: z.array(z.object({ ingredient: z.string(), product: productSummary })),
+            skipped: z.array(z.string()),
+            not_found: z.array(z.string()),
+            /** Searches that failed (e.g. AH unavailable); unlike not_found, these may exist. */
+            failed: z.array(z.string()),
+            dry_run: z.boolean(),
+        },
+    }, async (c, args) => {
+        if (args.recipe_id <= 0)
+            throw new Error("recipe_id is required");
+        const servings = args.servings && args.servings > 0 ? args.servings : undefined;
+        const recipe = await getRecipe(c, args.recipe_id, servings).catch((err) => {
+            throw wrapError(`could not get recipe ${args.recipe_id}; check the id`, err);
+        });
+        // A skip entry matches an ingredient containing all its words, so "zout" skips "zout en peper" but not "ongezouten boter".
+        const skips = (args.skip ?? []).map(words).filter((w) => w.length > 0);
+        const isSkipped = (name) => {
+            const have = words(name);
+            return have.some((w) => TAP_WATER.has(w)) || skips.some((s) => s.every((w) => have.some((t) => sameWord(w, t))));
+        };
+        const wanted = recipe.ingredients.filter((i) => !isSkipped(i.name));
+        const matches = new Array(wanted.length);
+        const errors = new Array(wanted.length);
+        await parallel(wanted.length, 3, async (i) => {
+            const name = wanted[i].name;
+            // Packaging and filler words ("uit blik") only confuse AH's search.
+            const query = plainWords(name).join(" ") || name;
+            const products = await nonFatal(() => search(ctx, c, query, CANDIDATES, { sort: "RELEVANCE" }), (err) => {
+                errors[i] = err;
+                return [];
+            });
+            matches[i] = pickProduct(name, products, args.prefer_bonus !== false);
+        });
+        if (wanted.length > 0 && errors.filter(Boolean).length === wanted.length) {
+            throw wrapError("could not search for the ingredients", errors[0]);
+        }
+        const added = wanted.flatMap((ing, i) => {
+            const p = matches[i];
+            return p ? [{ ingredient: ing.text, product: summarizeProduct(p) }] : [];
+        });
+        const quantities = new Map(added.map((a) => [a.product.id, 1]));
+        if (!args.dry_run && quantities.size > 0) {
+            await listCall("failed to add the ingredients", () => addProductsToShoppingList(c, quantities));
+        }
+        return structured({
+            recipe: recipe.title,
+            added,
+            skipped: recipe.ingredients.filter((i) => isSkipped(i.name)).map((i) => i.text),
+            not_found: wanted.filter((_, i) => !matches[i] && !errors[i]).map((i) => i.text),
+            failed: wanted.filter((_, i) => errors[i]).map((i) => i.text),
+            dry_run: Boolean(args.dry_run),
+        });
+    });
+}
+function rating(r) {
+    return r?.average && r.count ? `${r.average.toFixed(1)}/5 (${r.count})` : undefined;
+}
+//# sourceMappingURL=recipes.js.map

package/dist/tools/recipes.js.map

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

package/dist/tools/shoppingList.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import { addProductsToShoppingList, addTextToShoppingList, getShoppingList, isOrderMode, productsByIds, productUrl, removeFromShoppingList, } from "../ahapi/index.js";
+import { addAuthedTool, structured, text, wrapError } from "./common.js";
+/** Replaces AH's "Server in order mode" error. */
+const ORDER_MODE_MESSAGE = "the shopping list is not available while a delivery order is active: " +
+    "AH moved its products into the order when the delivery slot was chosen. " +
+    "Use ah_get_cart, ah_update_cart_item and ah_remove_from_cart to view or change the order";
+/** Runs a shopping-list call; errors are prefixed with action, or replaced with ORDER_MODE_MESSAGE. */
+export async function listCall(action, fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        throw isOrderMode(err) ? new Error(ORDER_MODE_MESSAGE) : wrapError(action, err);
+    }
+}
+export const confirmInput = { confirm: z.string().describe('Must be "yes" to confirm') };
+export function registerShoppingListTools(server, ctx) {
+    addAuthedTool(server, ctx, {
+        name: "ah_get_shopping_list",
+        title: "Albert Heijn: View Shopping List",
+        kind: "readOnly",
+        output: {
+            items: z.array(z.object({
+                position: z.number(),
+                name: z.string(),
+                product_id: z.number().optional(),
+                url: z.string().optional(),
+                quantity: z.number(),
+                checked: z.boolean().optional(),
+            })),
+        },
+        description: "Get the contents of the Albert Heijn shopping list (boodschappenlijst). " +
+            "In the AH app this is the basket the user fills while shopping; choosing a delivery slot moves its products " +
+            "into an order, after which the list is unavailable until the order is done (use ah_get_cart then). " +
+            "Returns item names, quantities, and product IDs.",
+    }, async (c) => {
+        const items = await listCall("failed to get shopping list", () => getShoppingList(c));
+        return structured({
+            items: items.map((it) => ({
+                position: it.position,
+                name: it.name,
+                product_id: it.productId || undefined,
+                url: it.productId ? productUrl(it.productId, it.name) : undefined,
+                quantity: it.quantity,
+                checked: it.checked || undefined,
+            })),
+        }, items.length ? undefined : "Your shopping list is empty.");
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_add_to_shopping_list",
+        title: "Albert Heijn: Add to Shopping List",
+        kind: "additive",
+        description: "Add one or more products to your Albert Heijn shopping list. " +
+            "Pass an array of items, each with product_id (int) and quantity (int). " +
+            "Returns confirmation listing the names of successfully added products.",
+        input: {
+            items: z
+                .array(z.object({
+                product_id: z.number().int().describe("numeric product ID"),
+                quantity: z.number().int().describe("number of units"),
+            }))
+                .describe('Items to add, e.g. [{"product_id": 123456, "quantity": 2}]'),
+        },
+    }, async (c, { items }) => {
+        const quantities = new Map();
+        for (const it of items) {
+            if (it.product_id > 0 && it.quantity > 0) {
+                quantities.set(it.product_id, (quantities.get(it.product_id) ?? 0) + it.quantity);
+            }
+        }
+        if (quantities.size === 0) {
+            throw new Error("no valid items provided (each item needs product_id > 0 and quantity > 0)");
+        }
+        await listCall("failed to add items", () => addProductsToShoppingList(c, quantities));
+        // Product names for the confirmation; IDs if the lookup fails.
+        const names = new Map();
+        try {
+            for (const p of await productsByIds(c, [...quantities.keys()]))
+                names.set(p.webshopId, p.title);
+        }
+        catch {
+            // Names are cosmetic.
+        }
+        const lines = [...quantities].map(([id, qty]) => `${names.get(id) ?? `Product ${id}`} (x${qty})`);
+        return text(`Added to shopping list:\n- ${lines.join("\n- ")}`);
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_add_free_text_to_shopping_list",
+        title: "Albert Heijn: Add Free-Text to Shopping List",
+        kind: "additive",
+        description: "Add a free-text item to the Albert Heijn shopping list (no product ID needed). " +
+            "Use for reminders like 'verse bloemen', 'any good wine', or items not found in search. " +
+            "Free-text items have no quantity: put amounts in the text, e.g. '2 bossen bloemen'.",
+        input: {
+            name: z.string().describe("Free-text item description, e.g. 'verse bloemen', 'goede rode wijn'"),
+        },
+    }, async (c, args) => {
+        if (!args.name)
+            throw new Error("name is required");
+        await listCall("failed to add free-text item", () => addTextToShoppingList(c, args.name));
+        return text(`Added '${args.name}' to shopping list.`);
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_remove_from_shopping_list",
+        title: "Albert Heijn: Remove from Shopping List",
+        kind: "destructive",
+        description: "Remove one or more items from the Albert Heijn Boodschappenlijst. " +
+            "For product items pass product_ids; for free-text items pass names. " +
+            "Get product_ids from ah_get_shopping_list.",
+        input: {
+            product_ids: z
+                .array(z.number().int())
+                .optional()
+                .describe("Product IDs to remove, e.g. [123456, 789012]. Use for product items."),
+            names: z
+                .array(z.string())
+                .optional()
+                .describe('Free-text item names to remove, e.g. ["verse bloemen"]. Use for items without a product ID.'),
+        },
+    }, async (c, args) => {
+        const ids = new Set((args.product_ids ?? []).filter((id) => id > 0));
+        const names = new Set((args.names ?? []).filter(Boolean).map((n) => n.toLowerCase()));
+        if (ids.size === 0 && names.size === 0)
+            throw new Error("provide at least one product_id or name to remove");
+        const items = await listCall("failed to read shopping list", () => getShoppingList(c));
+        const matches = items.filter((it) => ids.has(it.productId) || (it.productId === 0 && names.has(it.name.toLowerCase())));
+        if (matches.length === 0)
+            throw new Error("no matching items found on the shopping list");
+        await listCall("failed to update shopping list", () => removeFromShoppingList(c, matches));
+        return text(`Removed from shopping list: ${matches.map((it) => it.name).join(", ")}`);
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_clear_shopping_list",
+        title: "Albert Heijn: Clear Shopping List",
+        kind: "destructive",
+        description: 'Remove ALL items from the Albert Heijn shopping list. Irreversible — requires confirm="yes".',
+        input: confirmInput,
+    }, async (c, { confirm }) => {
+        if (confirm !== "yes")
+            throw new Error('confirm must be "yes" to clear the shopping list');
+        const items = await listCall("failed to read shopping list", () => getShoppingList(c));
+        if (items.length === 0)
+            return text("Shopping list is already empty.");
+        await listCall("failed to clear shopping list", () => removeFromShoppingList(c, items));
+        return text("Shopping list cleared.");
+    });
+}
+//# sourceMappingURL=shoppingList.js.map

package/dist/tools/shoppingList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shoppingList.js","sourceRoot":"","sources":["../../src/tools/shoppingList.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,aAAa,EACb,UAAU,EACV,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAoB,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3F,kDAAkD;AAClD,MAAM,kBAAkB,GACtB,uEAAuE;IACvE,0EAA0E;IAC1E,0FAA0F,CAAC;AAE7F,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,MAAc,EAAE,EAAoB;IACpE,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;AAEzF,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,GAAgB;IAC3E,aAAa,CACX,MAAM,EACN,GAAG,EACH;QACE,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,kCAAkC;QACzC,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE;YACN,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;gBACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;gBACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;gBAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACjC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;gBACpB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;aAChC,CAAC,CACH;SACF;QACD,WAAW,EACT,0EAA0E;YAC1E,8GAA8G;YAC9G,qGAAqG;YACrG,kDAAkD;KACrD,EACD,KAAK,EAAE,CAAC,EAAE,EAAE;QACV,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,OAAO,UAAU,CACf;YACE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACxB,QAAQ,EAAE,EAAE,CAAC,QAAQ;gBACrB,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,UAAU,EAAE,EAAE,CAAC,SAAS,IAAI,SAAS;gBACrC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBACjE,QAAQ,EAAE,EAAE,CAAC,QAAQ;gBACrB,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,SAAS;aACjC,CAAC,CAAC;SACJ,EACD,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,8BAA8B,CAC1D,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,aAAa,CACX,MAAM,EACN,GAAG,EACH;QACE,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,oCAAoC;QAC3C,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,+DAA+D;YAC/D,yEAAyE;YACzE,wEAAwE;QAC1E,KAAK,EAAE;YACL,KAAK,EAAE,CAAC;iBACL,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBAC3D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;aACvD,CAAC,CACH;iBACA,QAAQ,CAAC,4DAA4D,CAAC;SAC1E;KACF,EACD,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACrB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,EAAE,CAAC,UAAU,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACzC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,yBAAyB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAEtF,+DAA+D;QAC/D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;QACxC,IAAI,CAAC;YACH,KAAK,MAAM,CAAC,IAAI,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAClG,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,WAAW,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC;QAClG,OAAO,IAAI,CAAC,8BAA8B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC,CACF,CAAC;IAEF,aAAa,CACX,MAAM,EACN,GAAG,EACH;QACE,IAAI,EAAE,mCAAmC;QACzC,KAAK,EAAE,8CAA8C;QACrD,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,iFAAiF;YACjF,yFAAyF;YACzF,qFAAqF;QACvF,KAAK,EAAE;YACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;SACjG;KACF,EACD,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACpD,MAAM,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,qBAAqB,CAAC,CAAC;IACxD,CAAC,CACF,CAAC;IAEF,aAAa,CACX,MAAM,EACN,GAAG,EACH;QACE,IAAI,EAAE,8BAA8B;QACpC,KAAK,EAAE,yCAAyC;QAChD,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,oEAAoE;YACpE,sEAAsE;YACtE,4CAA4C;QAC9C,KAAK,EAAE;YACL,WAAW,EAAE,CAAC;iBACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;iBACvB,QAAQ,EAAE;iBACV,QAAQ,CAAC,sEAAsE,CAAC;YACnF,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,6FAA6F,CAAC;SAC3G;KACF,EACD,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QAChB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACtF,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAE7G,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAC1B,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAC1F,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC1F,MAAM,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC,+BAA+B,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC,CACF,CAAC;IAEF,aAAa,CACX,MAAM,EACN,GAAG,EACH;QACE,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,mCAAmC;QAC1C,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,8FAA8F;QAC3G,KAAK,EAAE,YAAY;KACpB,EACD,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC3F,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACvE,MAAM,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/stores.js

@@ -0,0 +1,108 @@
+import { z } from "zod";
+import { getBargains, productUrl, searchStores } from "../ahapi/index.js";
+import { addAuthedTool, cachedMember, formatDate, orDefault, structured, wrapError } from "./common.js";
+const str = z.string().optional();
+export function registerStoreTools(server, ctx) {
+    addAuthedTool(server, ctx, {
+        name: "ah_search_stores",
+        title: "Albert Heijn: Search Stores",
+        kind: "readOnly",
+        output: {
+            stores: z.array(z.object({ id: z.number(), name: z.string(), type: str, street: str, city: str, postal_code: str })),
+        },
+        description: "Find Albert Heijn stores near a Dutch postal code. " +
+            "If no postal_code is given, automatically uses the address from the member profile. " +
+            "Returns store id (use this for ah_get_last_chance_items), name, type, and address.",
+        input: {
+            postal_code: z
+                .string()
+                .optional()
+                .describe("Dutch postal code, e.g. '1234AB'. Optional — falls back to member address."),
+        },
+    }, async (c, { postal_code }) => {
+        const postalCode = postal_code || (await memberPostalCode(ctx, c));
+        if (!postalCode)
+            throw new Error("no postal_code provided and member profile has no address on file");
+        const stores = await searchStores(c, postalCode);
+        return structured({
+            stores: stores.map((s) => ({
+                id: s.id,
+                name: s.name,
+                type: s.storeType || undefined,
+                street: [s.address?.street, s.address?.houseNumber].filter(Boolean).join(" ") || undefined,
+                city: s.address?.city || undefined,
+                postal_code: s.address?.postalCode || undefined,
+            })),
+        }, stores.length ? undefined : `No AH stores found near ${postalCode}.`);
+    });
+    addAuthedTool(server, ctx, {
+        name: "ah_get_last_chance_items",
+        title: "Albert Heijn: Last-Chance Items",
+        kind: "readOnly",
+        output: {
+            items: z.array(z.object({
+                id: z.number(),
+                title: z.string(),
+                url: z.string(),
+                brand: str,
+                category: str,
+                markdown_type: str,
+                discount_percentage: z.number().optional(),
+                expiration_date: str,
+                stock: z.number().optional(),
+                price_was: str,
+                price_now: str,
+            })),
+        },
+        description: "Get last-chance / vandaag-af / clearance items from an Albert Heijn store. " +
+            "Requires a store_id (use ah_search_stores to find stores, or provide postal_code to find the nearest store). " +
+            "Uses the dedicated bargainItems GraphQL endpoint which returns today-only markdown deals.",
+        input: {
+            limit: z.number().int().optional().describe("Maximum number of results to return (default 20)"),
+            store_id: z.number().int().optional().describe("AH store ID. Required to retrieve bargain items."),
+            postal_code: z
+                .string()
+                .optional()
+                .describe("Dutch postal code (e.g. '1234AB') to find the nearest store when store_id is not known."),
+        },
+    }, async (c, args) => {
+        const storeId = args.store_id || (await nearestStoreId(ctx, c, args.postal_code));
+        if (!storeId) {
+            throw new Error("cannot retrieve last-chance items without a store. Please provide store_id or postal_code. " +
+                'Example: {"store_id": 1234} or {"postal_code": "1011AB"}');
+        }
+        const bargains = (await getBargains(c, storeId)).slice(0, orDefault(args.limit, 20));
+        return structured({
+            items: bargains.map((b) => ({
+                id: b.productId,
+                title: b.title,
+                url: productUrl(b.productId, b.title),
+                brand: b.brand || undefined,
+                category: b.category || undefined,
+                markdown_type: b.markdownType || undefined,
+                discount_percentage: b.discount || undefined,
+                expiration_date: formatDate(b.expirationDate, false) || undefined,
+                stock: b.stock || undefined,
+                price_was: b.priceWas || undefined,
+                price_now: b.priceNow ?? undefined,
+            })),
+        });
+    });
+}
+/** The member's postal code, or "" if none is on file. */
+async function memberPostalCode(ctx, c) {
+    try {
+        return (await cachedMember(ctx, c)).postalCode;
+    }
+    catch (err) {
+        throw wrapError("no postal_code provided and could not fetch member address", err);
+    }
+}
+/** Nearest store to postalCode (default: member address), or 0 if there is no address or store. */
+async function nearestStoreId(ctx, c, postalCode) {
+    const code = postalCode || (await memberPostalCode(ctx, c));
+    if (!code)
+        return 0;
+    return (await searchStores(c, code))[0]?.id ?? 0;
+}
+//# sourceMappingURL=stores.js.map