On 30 October 2026 Mage-OS published Mage-OS Distribution 4.0.0. It is one of their largest feature releases: an admin AI assistant called Mago, storefront AI discoverability files, native shopping feeds, passkeys, and a deep Multi-Source Inventory (MSI) overhaul. The distribution stays on the Magento Open Source 2.4.9 base, so 3.6.x shops can treat it as a drop-in upgrade. Most new features stay off until you turn them on. Here is what Magento 2 and Hyvä merchants should take from it.
1. Mago: an AI assistant inside Magento admin
Mago lets admins ask about the store in plain language and get live answers as cards, charts and tables, with deep links into the right admin screen. It can also propose changes through chat. Every change asks for confirmation first, irreversible actions show their impact, and Mago only does what the admin role allows. Slash commands such as /cache flush and /index reindex run directly, without an AI round-trip.
Mago sits on mage-os/module-ai-base, so the LLM is a setting — OpenAI, Anthropic, Gemini, Azure, Ollama and other OpenAI-compatible gateways. API keys are encrypted at rest, token usage is reported per module, and prompts are not stored. That same AI Base layer also powers the open-source Mage-OS AI Shopping Assistant for Hyvä and Luma storefronts (latest package 2.0.18 as of 3 November 2026).
2. AI discoverability: llms.txt, FAQs and structured data
Mage-OS 4.0 ships three related modules that help AI crawlers and answer engines understand your catalog:
module-seo — JSON-LD product, Organization and Breadcrumb schema, Open Graph, robots and canonical control, multistore hreflang. It replaces the older meta-robots and hreflang modules.
module-aeo — /llms.txt, /llms-full.txt, /llms.jsonl and controls for 14 known AI crawlers.
module-faq — FAQ manager, a theme-agnostic widget, Page Builder content type, and FAQPage JSON-LD that matches the questions on the page.
If you upgrade, fill in Organisation details under Marketing → SEO before you expect clean structured data or a useful llms.txt. AEO documents and SEO rebuilds run through the mageosSeoFeedRegenerate queue consumer, so cron or a supervisor must keep consumers running.
3. Shopping feeds, passkeys and MSI
Other pieces that matter for day-to-day Magento ops:
module-shopping-feed — Google Shopping, Meta, Pinterest, TikTok, Microsoft Merchant Center and more, with FTP/SFTP delivery and MSI-aware local inventory feeds.
module-passkey-auth — WebAuthn/FIDO2 login for customers on Luma and Hyvä, plus an admin 2FA provider. Off by default; needs HTTPS.
MSI overhaul — source-level reservations, oversell detection, Stock Visualizer on the storefront, and faster reindex. Two inventory paths change even with the new flag off: place-order locking and shipment source resolution. Test custom order and shipment code before a production upgrade.
What this means if you already run Magento Open Source or Adobe Commerce
You do not have to switch distributions to act on the same themes. Magento merchants can still:
Publish clear product attributes and category structure so AI assistants and answer engines can match shopper intent — see our Magento 2 attributes checklist for AI product discovery.
Treat admin AI and storefront AI as separate products. An admin copilot that flushes cache is not the same as a catalog-aware sales assistant that helps a shopper pick a configurable SKU.
Keep queue consumers and cron healthy. Any feed, SEO rebuild or AI sync that runs asynchronously will silently stall if consumers are down.
Where Claspwell fits
Claspwell is a catalog-aware Magento 2 / Hyvä AI sales assistant for the storefront — not an admin copilot. It syncs categories, products and shopper-facing attributes into Postgres, finds products with SQL and keyword search, and uses a low-cost LLM only for intent routing and replies when a scripted path is not enough. There are no embeddings and no vector database. Install time is typically 3 days to 1 week once scope and access are ready. A curated knowledge base covers B2B and policy questions the catalog cannot answer.
If you want that layer on a Magento 2 or Hyvä store, start at claspwell.com.
Source: Mage-OS 4.0.0 – Feature Release, Mage-OS, 30 October 2026.