continente-mcp 3.1.0 → 4.1.0

package/skills/groceries/SKILL.md

@@ -22,11 +22,11 @@ The goal is to pick the product the user actually buys, not just any product wit
 
 **1. Search with favourites context**
 
-Call `search_products` with the item name. Results are automatically ranked by the favourites list — the top result is usually correct. Note the top 3.
+Call `search_products` with the item name. Favourites are ranked first and marked ⭐ — the top result is usually correct. Note the top 3.
 
-**2. Cross-check favourites**
+**2. Prefer favourites**
 
-Call `get_favorites` once (reuse for all items in this request). If any favourite matches the item name, prefer it — even if not the top search result. A favourite is a stronger signal than search rank.
+If any result is marked ⭐, prefer it — even if it is not the top result. A favourite is a stronger signal than search rank. If nothing is marked and the user seems to have favourites, call `refresh_favorites` once and search again.
 
 **3. Fallback: order history**
 
@@ -40,6 +40,11 @@ If confidence is high (clear favourite or obvious top result), add silently and
 
 Call `add_to_cart` with `product_id`. Default quantity is 1 unless specified (e.g. "2 pacotes de leite").
 
+`add_to_cart` and `update_cart_item` both check the basket afterwards and only report success when it holds the requested quantity. Products sold by weight (e.g. bananas) are counted in units, like on the website.
+
+- `below_minimum_quantity` — the product has a minimum, shown as ⚖️ in search results and in the error. Nothing was added; ask whether to add the minimum instead.
+- `cart_add_not_confirmed` or `cart_quantity_not_confirmed` — the change may still have happened. Call `get_cart`, never repeat `add_to_cart`, and correct with `update_cart_item` if needed.
+
 ## Output format
 
 After all items are processed, print a compact summary:
@@ -47,15 +52,16 @@ After all items are processed, print a compact summary:
 ```
 ✓ Queijo Flamengo Mil Vacas 400g — added (from favourites)
 ✓ Leite Mimosa Meio-Gordo 1L — added
+✓ Banana Continente — quantity set to 12
 ✗ Pão de Forma — unclear match, please check manually
 ```
 
 ## Error handling
 
 - No search results → report as not found, skip, continue with others
-- `add_to_cart` fails → report the error, move on
+- `add_to_cart` fails → handle the errors above, otherwise report the error and move on
 - Never stop the whole run because one item failed
 
 ## Performance
 
-`get_favorites` is slow. Call it once and reuse across all items. Only call `get_order_history` when favourites give no clear signal.
+`get_order_history` opens each order and is slow. Only call it when search and favourites give no clear signal.

package/src/auth-session.js

@@ -0,0 +1,37 @@
+import { existsSync } from 'fs';
+
+import { autoLogin, getCredentialStatus, loadCredentialEnv, resolveStatePaths } from '../continente-auto-login.js';
+
+export { resolveStatePaths };
+
+export function canAutoLogin(env = process.env) {
+  return getCredentialStatus(env).ready;
+}
+
+export async function refreshAuthCookies({
+  stateDir,
+  closeBrowser,
+  log = console.error,
+  env = process.env,
+} = {}) {
+  if (!canAutoLogin(env)) {
+    log('Automatic login skipped: CONTINENTE_EMAIL and CONTINENTE_PASSWORD are not both set.');
+    return false;
+  }
+
+  const loginEnv = loadCredentialEnv(env);
+  if (stateDir) loginEnv.CONTINENTE_STATE_DIR = stateDir;
+  const { cookieFile } = resolveStatePaths(loginEnv);
+  loginEnv.CONTINENTE_COOKIES_PATH = cookieFile;
+
+  if (closeBrowser) {
+    await closeBrowser();
+  }
+
+  const result = await autoLogin({
+    env: loginEnv,
+    log: (message) => log(`[auth] ${message}`),
+  });
+
+  return Boolean(result.success && existsSync(cookieFile));
+}

package/src/cart-utils.js

@@ -0,0 +1,113 @@
+export function normalizeCartProductId(productId) {
+  const value = String(productId || '').trim();
+  if (!value) return value;
+
+  const withoutHtml = value.replace(/\.html$/, '');
+  const masterMatch = withoutHtml.match(/^(\d+)-master$/);
+  if (masterMatch) return masterMatch[1];
+
+  const numericTail = withoutHtml.match(/(\d+)$/);
+  return numericTail ? numericTail[1] : withoutHtml;
+}
+
+export function quantityForCartUpdate(displayQuantity, measureOptions = {}) {
+  const quantity = Number(displayQuantity);
+  if (!Number.isFinite(quantity) || quantity < 0) {
+    throw new Error('Quantity must be a non-negative number');
+  }
+
+  const conversion = Number(measureOptions.primaryToSecondary ?? measureOptions.unitConversionRate);
+  const hasAlternativeUnit = measureOptions.hasAlternativeSaleUnit || measureOptions.hasConversionRate;
+  if ((hasAlternativeUnit && (!Number.isFinite(conversion) || conversion <= 0)) ||
+    // Without an alternative sale unit, quantities are counted in the primary unit;
+    // secondaryunit is only the price reference (e.g. €/kg for a unit product).
+    (!hasAlternativeUnit && ((measureOptions.primaryunit && measureOptions.primaryunit !== 'un') ||
+      (measureOptions.selectedunit && measureOptions.selectedunit !== 'primary')))) {
+    throw new Error('quantity_semantics_unknown');
+  }
+  const cartQuantity = hasAlternativeUnit ? quantity * conversion : quantity;
+  if (!Number.isFinite(cartQuantity)) throw new Error('quantity_semantics_unknown');
+  const minimum = Number(measureOptions.minOrderQuantity);
+  if (quantity > 0 && minimum > 0 && cartQuantity < minimum - 0.0005) {
+    const displayMinimum = hasAlternativeUnit ? minimum / conversion : minimum;
+    throw new Error(`below_minimum_quantity: the minimum is ${Number(displayMinimum.toFixed(3))}`);
+  }
+
+  return Number(cartQuantity.toFixed(3)).toString();
+}
+
+export function summarizeCartState(payload = {}) {
+  const customerAuthenticated = payload?.resources?.customerAuthenticated === true;
+  // The storefront uses {} when this session has not created a basket yet.
+  // Require the known response envelope; arbitrary/malformed objects still fail.
+  if (payload?.action === 'Cart-MiniCartShow' && payload.basket &&
+    typeof payload.basket === 'object' && !Array.isArray(payload.basket) &&
+    Object.keys(payload.basket).length === 0) {
+    return { customerAuthenticated, items: [], total: 0 };
+  }
+  const addItems = Array.isArray(payload?.cart?.items) ? payload.cart.items : null;
+  const miniCartGroups = Array.isArray(payload?.basket?.itemsSortedByBrand)
+    ? payload.basket.itemsSortedByBrand
+    : null;
+
+  const unknown = { customerAuthenticated, error: 'cart_shape_unknown' };
+  if (!addItems && !miniCartGroups) return unknown;
+  if (!addItems && miniCartGroups.some(group => !Array.isArray(group?.items))) return unknown;
+
+  const sourceItems = addItems || (miniCartGroups
+    ? miniCartGroups.flatMap(group => Array.isArray(group?.items) ? group.items : [])
+    : []);
+
+  if (sourceItems.some(item => !item?.id || !item.productName ||
+    !Number.isFinite(Number(item.secondaryQuantity ?? item.quantity)) ||
+    Number(item.secondaryQuantity ?? item.quantity) < 0)) return unknown;
+
+  const items = sourceItems.map(item => ({
+    id: normalizeCartProductId(item.id),
+    name: item.productName,
+    qty: Number(item.secondaryQuantity ?? item.quantity ?? 1),
+    price: moneyOrNull(item?.price?.sales?.value ?? item?.priceTotal?.basePriceValue)
+  }));
+
+  const total = moneyOrNull(
+    payload?.cart?.totalProductsValueNumber ??
+    payload?.basket?.totals?.productsTotalPriceOnly ??
+    payload?.basket?.totals?.productsTotalPriceOnlyWithSDR
+  );
+
+  return {
+    customerAuthenticated,
+    items,
+    total
+  };
+}
+
+function moneyOrNull(value) {
+  if (value == null || value === '') return null;
+  const amount = Number(value);
+  return Number.isFinite(amount) && amount >= 0 ? amount : null;
+}
+
+// Order lines show "12 un", or "1.2 kg" for products bought by weight.
+export function parseOrderQuantity(text) {
+  const match = String(text ?? '').trim().match(/^(\d+(?:[.,]\d+)?)\s*([a-zA-Z]*)/);
+  if (!match) return { qty: 1, unit: 'un' };
+  return { qty: Number(match[1].replace(',', '.')), unit: match[2].toLowerCase() || 'un' };
+}
+
+// Units and weights cannot be added together, so totals are kept per unit.
+// Sorted by how many orders include the product, then by units bought.
+export function tallyMostBought(orders) {
+  const tally = new Map();
+  for (const products of orders) {
+    const seenInOrder = new Set();
+    for (const { name, qty, unit } of products) {
+      const entry = tally.get(name) ?? { name, quantities: {}, orders: 0 };
+      entry.quantities[unit] = Number(((entry.quantities[unit] ?? 0) + qty).toFixed(3));
+      if (!seenInOrder.has(name)) { entry.orders += 1; seenInOrder.add(name); }
+      tally.set(name, entry);
+    }
+  }
+  return Array.from(tally.values())
+    .sort((a, b) => b.orders - a.orders || (b.quantities.un ?? 0) - (a.quantities.un ?? 0));
+}