continentept-mcp 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -6,6 +6,15 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.6.1] - 2026-10-15
+
+### Fixed
+
+- The first request after the browser started could fail with "The order history page was not recognised", or a search error, while the website was still setting up its session. A page that does not show what it should is now loaded once more.
+- Order dates with abbreviated months, as the website now shows them ("01 Set 26"), are read. They were all `null`.
+- `get_product` reports a product the website no longer sells as `not_found`, instead of `invalid_data`.
+- After an upgrade, the update check no longer reports an older version as the latest one.
+
 ## [0.6.0] - 2026-10-15
 
 ### Changed
@@ -88,7 +97,8 @@ All notable changes to this project are documented here. The format follows
 - Automatic sign-in from environment variables or a private credentials file, and a `login` command.
 - The `basket-planner` skill for planning a shopping list and updating the basket.
 
-[Unreleased]: https://github.com/andredelgado/continente-mcp/compare/v0.6.0...HEAD
+[Unreleased]: https://github.com/andredelgado/continente-mcp/compare/v0.6.1...HEAD
+[0.6.1]: https://github.com/andredelgado/continente-mcp/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/andredelgado/continente-mcp/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/andredelgado/continente-mcp/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/andredelgado/continente-mcp/compare/v0.3.1...v0.4.0

package/dist/clients/storefront.d.ts

@@ -7,6 +7,16 @@ export declare class StorefrontClient {
     constructor(session: StorefrontSession);
     io<T>(lease: BrowserLease, operation: () => Promise<T>): Promise<T>;
     navigateToStorefrontPage(path: string): Promise<Result<BrowserLease, ToolError>>;
+    /**
+     * Load a page and wait for a marker only the expected page has. A fresh browser's first visit can
+     * land on an interim page while the website sets up its session, so a page without the marker is
+     * loaded once more; `ready` says whether the marker appeared. `landed` rejects a final URL early.
+     */
+    readPage(path: string, marker: string, landed?: (url: URL) => ToolError | null): Promise<Result<{
+        html: string;
+        url: string;
+        ready: boolean;
+    }, ToolError>>;
     html(path: string, marker?: string): Promise<Result<string, ToolError>>;
 }
 export declare class CatalogClient implements CatalogGateway {

package/dist/clients/storefront.js

@@ -40,20 +40,36 @@ export class StorefrontClient {
             return browserFailure(error);
         }
     }
-    async html(path, marker = 'main, [role="main"], .product-line, a[href*="/produto/"]') {
-        const response = await this.navigateToStorefrontPage(path);
-        if (!response.ok)
-            return response;
-        try {
-            await this.io(response.value, () => response.value.page.waitForSelector(marker, { state: 'attached', timeout: requestTimeout(10000) }));
-            return success(await this.io(response.value, () => response.value.page.content()));
-        }
-        catch (error) {
-            if (error instanceof RequestStopped)
-                throw error;
-            return failure('upstream_unavailable', 'Page readiness marker was not found');
+    /**
+     * Load a page and wait for a marker only the expected page has. A fresh browser's first visit can
+     * land on an interim page while the website sets up its session, so a page without the marker is
+     * loaded once more; `ready` says whether the marker appeared. `landed` rejects a final URL early.
+     */
+    async readPage(path, marker, landed) {
+        for (let attempt = 1;; attempt++) {
+            const response = await this.navigateToStorefrontPage(path);
+            if (!response.ok)
+                return response;
+            const lease = response.value;
+            const rejected = landed?.(new URL(lease.page.url()));
+            if (rejected)
+                return { ok: false, error: rejected };
+            try {
+                const ready = await this.io(lease, () => lease.page.waitForSelector(marker, { state: 'attached', timeout: requestTimeout(10000) }).then(() => true, () => false));
+                if (ready || attempt === 2)
+                    return success({ html: await this.io(lease, () => lease.page.content()), url: lease.page.url(), ready });
+            }
+            catch (error) {
+                return browserFailure(error);
+            }
         }
     }
+    async html(path, marker = 'main, [role="main"], .product-line, a[href*="/produto/"]') {
+        const page = await this.readPage(path, marker);
+        if (!page.ok)
+            return page;
+        return page.value.ready ? success(page.value.html) : failure('upstream_unavailable', 'Page readiness marker was not found');
+    }
 }
 export class CatalogClient {
     site;
@@ -61,18 +77,11 @@ export class CatalogClient {
         this.site = site;
     }
     async fetchProductDetails(reference) {
-        const result = await this.site.navigateToStorefrontPage(productPath(reference));
-        if (!result.ok)
-            return result;
-        try {
-            await this.site.io(result.value, () => result.value.page.waitForSelector('h1.product-name, main', { state: 'attached', timeout: requestTimeout(10000) }));
-            return success({ html: await this.site.io(result.value, () => result.value.page.content()), url: result.value.page.url() });
-        }
-        catch (error) {
-            if (error instanceof RequestStopped)
-                throw error;
-            return failure('invalid_data', 'Product detail content is unavailable');
-        }
+        // The website redirects a product it no longer sells to its home page.
+        const page = await this.site.readPage(productPath(reference), 'h1.product-name, .ct-pdp--prices', url => url.pathname.startsWith('/produto/') ? null : failure('not_found', 'This product is no longer sold on the website').error);
+        if (!page.ok)
+            return page;
+        return page.value.ready ? success({ html: page.value.html, url: page.value.url }) : failure('invalid_data', 'Product detail content is unavailable');
     }
     async searchProducts(query, limit) {
         const first = await this.site.html(`/pesquisa/?q=${encodeURIComponent(query)}`, '.ct-inner-tile-wrap, .search-noresults-wrapper, .search-no-results, [data-search-empty]');
@@ -280,17 +289,9 @@ export class OrdersClient {
         const path = cursor === undefined ? '/conta/encomendas/' : orderHistoryUrl(cursor);
         if (!path)
             return failure('invalid_input', 'Invalid order history cursor');
-        const response = await this.site.navigateToStorefrontPage(path);
-        if (!response.ok)
-            return response;
-        const { page } = response.value;
-        try {
-            await this.site.io(response.value, () => page.waitForSelector('main, [role="main"], a[href*="detalhe-encomenda"]', { state: 'attached', timeout: requestTimeout(10000) }));
-            return success(await this.site.io(response.value, () => page.content()));
-        }
-        catch (error) {
-            return browserFailure(error);
-        }
+        // Without the marker the page is still handed to the parser, which says what it does not recognise.
+        const page = await this.site.readPage(path, '.ct-order-history--landing-container, .ct-order-history--order-preview-item');
+        return page.ok ? success(page.value.html) : page;
     }
     async fetchOrderLines(url) {
         const href = storefrontUrl(url);

package/dist/parsers/orders.d.ts

@@ -13,6 +13,8 @@ export interface OrderHistory {
     totalCount: number | null;
 }
 export declare function orderHistoryUrl(value: string): string | null;
+/** "2 outubro 2026", "2 de outubro de 2026" or the abbreviated "01 Set 26"; anything else stays unparsed. */
+export declare function normalizedDate(raw: string): string | null;
 export declare function parseOrderHistory(html: string): Result<OrderHistory, ToolError>;
 export declare function parseOrderDetail(html: string, expected: Order): Result<OrderLine[], ToolError>;
 export declare function parseSingleOrder(html: string, orderId: Order['orderId']): Result<Order, ToolError>;

package/dist/parsers/orders.js

@@ -51,13 +51,16 @@ export function orderHistoryUrl(value) {
     const href = storefrontUrl(value);
     return href && new URL(href).pathname === '/conta/encomendas/' ? href : null;
 }
-function normalizedDate(raw) {
-    const match = raw.trim().toLowerCase().match(/^(\d{1,2})\s+(?:de\s+)?([a-zç]+)\s+(?:de\s+)?(\d{4})$/);
+const MONTHS = ['janeiro', 'fevereiro', 'março', 'abril', 'maio', 'junho', 'julho', 'agosto', 'setembro', 'outubro', 'novembro', 'dezembro'];
+/** "2 outubro 2026", "2 de outubro de 2026" or the abbreviated "01 Set 26"; anything else stays unparsed. */
+export function normalizedDate(raw) {
+    const match = raw.trim().toLowerCase().match(/^(\d{1,2})\s+(?:de\s+)?([a-zç]+)\.?\s+(?:de\s+)?(\d{4}|\d{2})$/);
     if (!match)
         return null;
-    const month = ['janeiro', 'fevereiro', 'março', 'abril', 'maio', 'junho', 'julho', 'agosto', 'setembro', 'outubro', 'novembro', 'dezembro'].indexOf(match[2]);
+    const name = match[2];
+    const month = MONTHS.findIndex(full => full === name || (name.length === 3 && full.startsWith(name)));
     const day = Number(match[1]);
-    const year = Number(match[3]);
+    const year = match[3].length === 2 ? 2000 + Number(match[3]) : Number(match[3]);
     const date = new Date(Date.UTC(year, month, day));
     return month >= 0 && date.getUTCFullYear() === year && date.getUTCMonth() === month && date.getUTCDate() === day ? date.toISOString().slice(0, 10) : null;
 }

package/dist/services/updates.js

@@ -50,15 +50,19 @@ export async function checkForUpdate(options) {
         cached = CacheSchema.parse(JSON.parse(await readFile(file, 'utf8')));
     }
     catch { /* no usable cache */ }
-    let latest = cached?.latestVersion ?? null;
+    // An answer older than the running version predates an upgrade, so it is checked again.
+    const outdated = cached !== null && isNewerRelease(options.currentVersion, cached.latestVersion);
+    let latest = cached && !outdated ? cached.latestVersion : null;
     const age = cached ? now.getTime() - Date.parse(cached.checkedAt) : Infinity;
-    if (!(age >= 0 && age < UPDATE_CHECK_INTERVAL_MS)) {
+    if (outdated || !(age >= 0 && age < UPDATE_CHECK_INTERVAL_MS)) {
         try {
             latest = await withTimeout(signal => (options.fetchLatest ?? registryLatest)(options.packageName, signal), options.timeoutMs ?? 1500);
             await writePrivateJson(file, { checkedAt: now.toISOString(), latestVersion: latest }).catch(() => { });
         }
         catch { /* offline or slow: keep the last known answer */ }
     }
+    if (latest !== null && isNewerRelease(options.currentVersion, latest))
+        latest = null;
     return { currentVersion: options.currentVersion, latestVersion: latest, available: latest !== null && isNewerRelease(latest, options.currentVersion) };
 }
 /** A line for the assistant's instructions, or null when there is nothing to say. */

package/docs/tools.md

@@ -104,9 +104,11 @@ Returns `productId`, `productSlug`, `name`, `url`, `price`, `secondaryPrice`, `r
 
 Cart quantities are always in `saleUnit`. Products priced per kilogram but sold by the piece
 (fruit, meat, fish) have `saleUnit: "un"` and `storefrontUnit: "kg"`: their minimum, maximum and
-step are whole pieces, and `storefrontUnitsPerSaleUnit` is the approximate weight of one piece. If the website's rules cannot be interpreted
-safely, `saleRules` is `{ "status": "unavailable", "error": ... }` and the result is
-`partial`. Availability reflects the product page, not delivery-slot stock.
+step are whole pieces, and `storefrontUnitsPerSaleUnit` is the approximate weight of one piece.
+If the website's rules cannot be interpreted safely, `saleRules` is
+`{ "status": "unavailable", "error": ... }` and the result is `partial`. Availability reflects
+the product page, not delivery-slot stock. A product the website no longer sells returns
+`not_found`.
 
 ## Favorites
 
@@ -119,6 +121,9 @@ automatically when missing, is marked `stale` after 24 hours, and is replaced wh
 `data`: `favorites`, `fetchedAt`, `expiresAt`, `source` (`cache` or `website`), `freshness`
 (`fresh` or `stale`), `cacheState` (`empty` or `populated`), `completeness`.
 
+Favorites can include products the website no longer sells, still with their last price. Check
+with `get_product` before adding one to the cart; it returns `not_found` for those.
+
 ## Cart
 
 ### `get_cart`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "continentept-mcp",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "mcpName": "io.github.andredelgado/continente-mcp",
   "description": "MCP server for Continente.pt: search products, check sale rules, read favorites and orders, and make verified cart changes.",
   "keywords": [