webcake-storefront-mcp 1.6.0 → 1.8.0

package/dist/api.js

@@ -363,6 +363,13 @@ export class WebcakeCmsApi {
     getApp(type) {
         return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/applications/subcriptions/get_app`, { query: { type } });
     }
+    /** Install (register) an application on the site. type = Enum.Application value
+     *  (e.g. automation=2, send_email=7). Body: { site_id, type, is_active }. */
+    registerApp(type, is_active = true) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/subcriptions/register`, {
+            body: { site_id: this.siteId, type, is_active },
+        });
+    }
     // ── Promotions ──
     listPromotions(query) {
         return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/promotion_advance/all`, { query });
@@ -425,6 +432,24 @@ export class WebcakeCmsApi {
         return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/multilingual/update_global_source_contents`, { body: params });
     }
     // ── Automation ──
+    /** List the site's automations (id, name, rule/trigger, status). Use this to find the
+     *  automation_id to pass to send_mail. Returns { data: [...], total_entries, ... }. */
+    listAutomations(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/automations/all`, { query });
+    }
+    createAutomation(automationAttrs) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/automations/create`, {
+            body: { automation_attrs: { ...automationAttrs, site_id: this.siteId } },
+        });
+    }
+    updateAutomation(automationAttrs) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/automations/update`, {
+            body: { automation_attrs: automationAttrs },
+        });
+    }
+    deleteAutomations(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/automations/delete`, { body: { ids } });
+    }
     sendMail(params) {
         return this.request("POST", `/api/v1/cms_function/${this.siteId}/application/automation/send_mail`, { body: params });
     }

package/dist/changelog.json

@@ -1,4 +1,18 @@
 [
+  {
+    "v": "1.8.0",
+    "d": "23/06/2026",
+    "type": "Added",
+    "en": "New list_automations tool returns each automation's id, name, status, and trigger info so agents can find the automation_id required by send_mail or…",
+    "vi": "Tool mới list_automations trả về id, name, status và thông tin trigger của từng automation, giúp agent tìm được automation_id cần truyền vào…"
+  },
+  {
+    "v": "1.7.0",
+    "d": "23/06/2026",
+    "type": "Changed",
+    "en": "The web guide landing page (served via the serve command) is reframed to lead on full-storefront creation: the hero, meta description, \"What you…",
+    "vi": "Trang web guide (phục vụ qua lệnh serve) được viết lại để làm nổi bật việc xây dựng toàn bộ cửa hàng: hero, meta description, thư viện \"Bạn dựng…"
+  },
   {
     "v": "1.6.0",
     "d": "23/06/2026",
@@ -26,19 +40,5 @@
     "type": "Changed",
     "en": "The install command's interactive wizard now presents numbered choices with ANSI colour output and a completion summary.",
     "vi": "Trình hướng dẫn tương tác của lệnh install nay hiển thị các lựa chọn được đánh số kèm màu ANSI và thông báo tóm tắt sau khi hoàn tất."
-  },
-  {
-    "v": "1.3.0",
-    "d": "23/06/2026",
-    "type": "Added",
-    "en": "New create_site tool creates a brand-new storefront site for the current account (seeded with sample products, categories, and a blog), optionally…",
-    "vi": "Tool mới create_site tạo một site storefront hoàn toàn mới cho tài khoản hiện tại (kèm sản phẩm, danh mục và blog mẫu), tự động chuyển sang site vừa…"
-  },
-  {
-    "v": "1.2.0",
-    "d": "23/06/2026",
-    "type": "Added",
-    "en": "upload_images replaces upload_image with batch support (1–20 sources per call), parallel uploads, and a dry_run mode that previews what would be…",
-    "vi": "upload_images thay thế upload_image với khả năng xử lý hàng loạt (1–20 nguồn mỗi lần gọi), tải song song, và chế độ dry_run cho phép xem trước những…"
   }
 ]

package/dist/enums.js

@@ -0,0 +1,46 @@
+// WebCake enum reference, mirrored from builderx_api so the AI knows what the numeric
+// codes / string values mean. Sources:
+//   - Enum.Application (lib/builderx_api/enum.ex) — application/app types
+//   - Automation schema (lib/builderx_api/automations/automation.ex) — type/status
+//   - Enum.PageType (page kinds) — kept here for one-stop reference
+/** Application types (the `type` used by get_app / install_app / register). */
+export const APP_TYPES = {
+    product_review: 0,
+    articles_review: 1,
+    automation: 2,
+    telegram: 3,
+    affiliates: 4,
+    multilingual: 5,
+    appointment: 6,
+    send_email: 7,
+    botcake: 8,
+    sale_channel: 9,
+    product_design: 10,
+    auth_otp: 11,
+    personal_product_design: 12,
+    course: 14,
+    zalo_mini_app: 15,
+    cms: 16,
+    recaptcha: 17,
+    pwa: 18,
+};
+export const APP_NAMES = Object.keys(APP_TYPES);
+/** name -> code and code -> name helpers. */
+export const APP_TYPE_BY_NAME = { ...APP_TYPES };
+export const APP_NAME_BY_TYPE = Object.fromEntries(Object.entries(APP_TYPES).map(([k, v]) => [v, k]));
+/** Automation.status values. */
+export const AUTOMATION_STATUS = ["ACTIVE", "INACTIVE"];
+/** Automation.type — user-built automations default to CUSTOM. */
+export const AUTOMATION_TYPE_DEFAULT = "CUSTOM";
+/** Page kinds (Enum.PageType) — numeric value stored on a page. */
+export const PAGE_TYPES = {
+    main: 1,
+    store: 2,
+    member: 3,
+    blog: 4,
+    custom: 5,
+    error: 6,
+    maintain: 7,
+};
+/** A compact human-readable summary, handy to surface in tool output. */
+export const APP_TYPE_REFERENCE = APP_NAMES.map((n) => `${APP_TYPES[n]}=${n}`).join(", ");

package/dist/guides.js

@@ -2,65 +2,127 @@ export const HTTP_FUNCTION_GUIDE = `
 # HTTP Function Guide
 
 ## Syntax
-export const [method]_[FunctionName] = (request) => { return result; }
-- Method: lowercase (get, post, put, patch, delete)
-- FunctionName: PascalCase
+export const [method]_[FunctionName] = async (request) => { return result; }
+- Method: lowercase (get, post, put, patch, delete) — picked from the export-name prefix.
+- FunctionName: keep it stable; it becomes the endpoint name.
+- Make it async; the return value is JSON-serialized and sent back to the caller.
 - Examples: get_Products, post_CreateOrder, delete_RemoveItem
 
-## Request object
-- request.params    — query params or body params
-- request.customer  — logged-in customer { id, name, email, first_name, last_name, phone_number, avatar }
-- request.account   — admin account { id, name, email, first_name, last_name, phone_number, avatar }
-- request.data      — full request params (including query string)
-
-## API endpoint after deploy
-GET/POST/PUT/PATCH /api/v1/{site_id}/_functions/{FunctionName}
-
-## webcake-data (Database SDK, built-in, no config needed)
+## The request argument
+Your function is called with ONE object: { params, customer, site_id, account, data }.
+- request.params    — the arguments the caller passed (query string for GET, body for POST/…).
+- request.customer  — the logged-in storefront customer (when authenticated), else {}. Fields: id, name, email, first_name, last_name, phone_number, avatar.
+- request.account   — the logged-in admin account (when called by an admin), else {}.
+- request.site_id   — the current site id (string).
+- request.data      — extra request data (usually {}).
+IMPORTANT: pass request through to the @webcake/* module functions (their first arg).
+
+## Endpoint after deploy
+ANY method → /api/v1/{site_id}/_functions/{FunctionName}
+The caller receives your return value as data.result. From the storefront, the
+webcake-fn client (api.method_FunctionName(params)) returns that result directly.
+
+## webcake-data — Database SDK (built-in)
 import { DBConnection } from 'webcake-data';
-const db = new DBConnection();
-const Model = db.model('table_name');
+const db = new DBConnection();              // auto-uses the sandbox global site/token
+const Model = db.model('collection_name');
 
-### CRUD
-- Model.create({ field: value })
-- Model.insertMany([...])
-- Model.find(filter).sort().limit().skip().select().exec()
+### Model CRUD (all async unless noted)
+- Model.create(doc)                         → created doc
+- Model.insertMany([doc, ...])              → array
+- Model.find(filter)                        → QueryBuilder (NOT a promise — chain then .exec()/await)
 - Model.findOne(filter, { select, sort, populate })
-- Model.findById(id)
-- Model.updateOne(filter, update)
-- Model.findByIdAndUpdate(id, update)
+- Model.findById(id, { select, populate })
+- Model.updateOne(filter, update)           → { acknowledged, matchedCount, modifiedCount }
+- Model.findByIdAndUpdate(id, update, { new: true })
+- Model.findOneAndUpdate(filter, update)
 - Model.updateMany(filter, update)
-- Model.deleteOne(filter)
-- Model.findByIdAndDelete(id)
+- Model.deleteOne(filter)                   → { acknowledged, deletedCount }
+- Model.findByIdAndDelete(id) / Model.findOneAndDelete(filter)
 - Model.deleteMany(filter)
-- Model.countDocuments(filter)
-- Model.exists(filter)
-
-### QueryBuilder
-Model.find().where('age').gte(25).lte(40).in('role', ['admin']).like('email', '%@ex.com').sort({ age: -1 }).limit(20).skip(10).select('name email').exec()
-
-### Populate (joins)
-Model.find().populate({ field: 'posts', table: 'posts', referenceField: 'user_id', select: 'title', where: {}, sort: {}, limit: 5 }).exec()
-
-### Operators
-where, eq, ne, gt, gte, lt, lte, in, nin, between, like, sort, limit, skip, select, populate
-
-## Built-in Modules
-- import { findArticleById, findArticle, createArticle, updateArticleById, deleteArticleById } from '@webcake/article'
-- import { findCustomerById, findCustomerByPhone, findCustomerByEmail } from '@webcake/customer'
-- import { addBonus } from '@webcake/promotion'
-- import { getAccessToken } from '@webcake/token'
-- import { sendMail } from '@webcake/app/automation'
-All module functions take (request, ...args) and auto-use global token/site_id.
-
-## Sandbox Globals (no import needed)
-- fetch(url, options) — HTTP requests
-- URLSearchParams — URL query building
-- console.log/warn/error — logging (captured in debug mode)
+- Model.countDocuments(filter)              → number
+- Model.exists(filter)                      → boolean
+
+### QueryBuilder (from Model.find())
+Chain then terminate with .exec() (or just await the chain):
+Model.find().where('age').gte(25).lte(40).in('role',['admin']).like('email','%@ex.com')
+  .sort({ age:-1 }).limit(20).skip(10).select('name email').exec()
+Operators: where, eq, ne, gt, gte, lt, lte, in, nin, between, like, sort, limit, skip, select, populate.
+
+### Populate (join another collection)
+Model.find().populate({
+  field:'posts', table:'posts', referenceField:'user_id',
+  select:'title', where:{}, sort:{ created_at:-1 }, limit:5, skip:0, justOne:false
+}).exec()
+
+## Built-in @webcake/* modules (first arg is always request; they auth via global.token)
+Thin wrappers over the backend's /cms_function/{site_id}/... endpoints. Pass request so
+they pick up site_id. Below is EXACTLY what each call sends to the backend + what it returns.
+
+- '@webcake/article'  (backend: /cms_function/{site}/blog/article…)
+    findArticleById(request, id, opts?)
+        GET .../blog/article/{id}?opts=<json>   → the article object ({} if not found)
+    findArticle(request, payload, opts?)
+        GET .../blog/article/all?<payload>&filters=<json>&opts=<json>
+        payload: { filters?:{...}, page?, limit? }   → { data:[...], ... }
+    createArticle(request, data)            POST .../blog/article   → full response
+        data the backend accepts: { name (required), summary, content (HTML),
+        images: string[] (hosted URLs), tags: string[], status_approval,
+        render_inserted_at, render_expired_at }.  slug is auto-generated; the article is
+        auto-filed under the default blog category (this endpoint takes NO category_id —
+        use the create_article MCP tool if you need explicit category linkage).
+        creator_id/customer_id come from the authenticated request.
+    updateArticleById(request, id, data)    PATCH .../blog/article/{id}   (same fields) → response
+    deleteArticleById(request, id)          DELETE .../blog/article/{id}  → response
+
+- '@webcake/customer'  (backend: /cms_function/{site}/customer/…)  → customer object ({} if none)
+    findCustomerById(request, id)     GET .../customer/identity/{id}
+    findCustomerByPhone(request, phone) GET .../customer/phone/{phone}
+    findCustomerByEmail(request, email) GET .../customer/email/{email}
+
+- '@webcake/promotion'  (backend: /cms_function/{site}/promotion/add_bonus)
+    addBonus(request, data)   POST add_bonus → response.
+        It ADDS REWARD POINTS to a customer. data: { customer_id (required),
+        point (number, required), message? (defaults "Bạn được cộng điểm") }.
+
+- '@webcake/token'  (backend: /external/oauth/token)
+    getAccessToken(request)   → access_token string (throws if none).
+        Needs request.x_storecake_refresh_token present (sent as x-storecake-refresh-token).
+
+- '@webcake/app/automation'  (backend: /cms_function/{site}/application/automation/send_mail)
+    sendMail(request, automationId, data)   → response (throws if send fails).
+        Sends body { automation_id, data }. automation_id MUST be a valid UUID of an
+        automation set up on the site — find it with the MCP tool list_automations.
+        data is the payload passed into that automation/email template.
+
+## Sandbox globals (no import)
+- fetch(url, options)            — HTTP requests; response.ok/status/text()/json().
+- URLSearchParams                — build/parse query strings.
+- console.log / warn / error     — captured in debug mode (returned in data.logs).
+- encodeURIComponent / decodeURIComponent / encodeURI / decodeURI
 - global.domain, global.siteId, global.token, global.headers
+- Standard JS: JSON, Math, Date, Object, Array, String, Number, Map, Set, Promise, Error.
+NOT available: require()/import at runtime, Buffer, crypto, fs, process, setTimeout/setInterval, eval/Function.
+
+## Limits
+Runs sandboxed: ~4 MB memory, ~30 s timeout. The return value MUST be JSON-serializable.
 
-## Cron Jobs (jobs_config JSON)
+## Cron jobs (jobs_config JSON)
 { "jobs": [{ "functionLocation": "backend/http_function", "functionName": "myFunc", "executionConfig": { "cronExpression": "0 2 * * *" } }] }
+
+## Example
+import { DBConnection } from 'webcake-data';
+import { findCustomerById } from '@webcake/customer';
+export const post_RecentOrders = async (request) => {
+  const { params, customer } = request;
+  const db = new DBConnection();
+  const orders = await db.model('orders')
+    .find().where('customer_id').eq(customer.id || params.customer_id)
+    .sort({ created_at:-1 }).limit(10)
+    .populate({ field:'items', table:'order_items', referenceField:'order_id', limit:50 })
+    .exec();
+  return { count: orders.length, orders };
+};
 `;
 export const CUSTOM_CODE_GUIDE = `
 # Custom Code Guide

package/dist/tools/apps.js

@@ -1,7 +1,40 @@
 import { z } from "zod";
+import { APP_TYPES, APP_NAMES, APP_TYPE_REFERENCE, APP_NAME_BY_TYPE } from "../enums.js";
 export function registerAppTools(server, api, handle) {
-    server.tool("list_apps", "List all installed applications/subscriptions of the site. Returns app type, status, and settings", {}, () => handle(() => api.listApps()));
-    server.tool("get_app", "Get a specific installed app by type ID. Common types: 1=CMS, 2=Product Design, 10=Multilingual, etc.", {
-        type: z.string().describe("App type ID"),
-    }, ({ type }) => handle(() => api.getApp(type)));
+    server.tool("list_apps", `List the site's installed applications (type, status, settings).
+App type codes: ${APP_TYPE_REFERENCE}.`, {}, () => handle(async () => {
+        const res = await api.listApps();
+        const raw = res?.data ?? res ?? [];
+        const list = Array.isArray(raw) ? raw : raw?.data || [];
+        return {
+            apps: list.map((a) => ({
+                type: a.type,
+                type_name: APP_NAME_BY_TYPE[a.type] ?? undefined,
+                status: a.status,
+                id: a.id,
+            })),
+            app_types: APP_TYPES,
+        };
+    }));
+    server.tool("get_app", `Get one installed app by its type code (returns null if not installed).
+App type codes: ${APP_TYPE_REFERENCE}. You may pass the number or the name.`, {
+        type: z.union([z.number(), z.string()]).describe(`App type — a code (e.g. 2) or a name (e.g. "automation"). Codes: ${APP_TYPE_REFERENCE}`),
+    }, ({ type }) => handle(() => {
+        const code = typeof type === "string" && type in APP_TYPES ? APP_TYPES[type] : type;
+        return api.getApp(code);
+    }));
+    server.tool("install_app", `Install (register) an application on the current site so its features become usable.
+For example, automations need the "automation" app installed first.
+App types: ${APP_TYPE_REFERENCE}.`, {
+        app: z.enum(APP_NAMES).describe("App to install (by name)"),
+        is_active: z.boolean().default(true).describe("Activate the app on install"),
+    }, ({ app, is_active }) => handle(async () => {
+        const type = APP_TYPES[app];
+        const existing = await api.getApp(type).catch(() => null);
+        if (existing?.app ?? existing?.data) {
+            return { app, type, already_installed: true };
+        }
+        await api.registerApp(type, is_active);
+        return { app, type, installed: true };
+    }));
 }

package/dist/tools/automation.js

@@ -1,8 +1,78 @@
 import { z } from "zod";
+import { APP_TYPES } from "../enums.js";
 export function registerAutomationTools(server, api, handle) {
-    server.tool("send_mail", "Send email via CMS automation", {
-        to: z.string().describe("Recipient email"),
-        subject: z.string().describe("Email subject"),
-        body: z.string().describe("Email body (supports HTML)"),
-    }, (params) => handle(() => api.sendMail(params)));
+    server.tool("list_automations", `List the site's automations so you can find an automation_id (e.g. to call send_mail, or to trigger from an HTTP function via @webcake/app/automation sendMail).
+Returns each automation's id, name, status and trigger info. Filter with 'term'. The id is what send_mail / the cms automation flow needs.`, {
+        term: z.string().optional().describe("Search by automation name"),
+        page: z.number().default(1).describe("Page number"),
+        limit: z.number().default(50).describe("Items per page"),
+    }, ({ term, page, limit }) => handle(async () => {
+        const res = await api.listAutomations({ ...(term ? { term } : {}), page, limit });
+        // Response shape: { automations: { data:[...], total_entries, page, limit }, ... }
+        const body = res?.automations || res?.data || res;
+        const raw = body?.data || body || [];
+        const list = Array.isArray(raw) ? raw : [];
+        const automations = list.map((a) => ({
+            id: a.id,
+            name: a.name,
+            status: a.status ?? (a.is_completed ? "completed" : undefined),
+            is_completed: a.is_completed,
+            // surface the trigger so the agent can tell which automation does what
+            trigger: a.rule?.trigger?.triggerType || a.rule?.trigger?.triggerKey || a.trigger_type || undefined,
+            updated_at: a.updated_at,
+        }));
+        return {
+            automations,
+            total: body?.total_entries ?? automations.length,
+            page,
+            hint: "Pass an automation's id as send_mail.automation_id (or to sendMail(request, automationId, data) inside an HTTP function).",
+        };
+    }));
+    // Automation lives behind the "Automation" application (Enum.Application automation = 2).
+    // Creating an automation requires that app installed, so we ensure it first.
+    const AUTOMATION_APP = APP_TYPES.automation;
+    async function ensureAutomationApp() {
+        const res = await api.getApp(AUTOMATION_APP).catch(() => null);
+        const app = res?.app ?? res?.data ?? null;
+        if (app)
+            return { installed: true, just_installed: false };
+        await api.registerApp(AUTOMATION_APP, true);
+        return { installed: true, just_installed: true };
+    }
+    server.tool("create_automation", `Create an automation. Checks the Automation app is installed first and installs it if needed.
+An automation = { name, type, status, rule }. 'rule' holds the trigger + actions (a map; shape depends on the trigger). Returns the new automation id (use it with send_mail for cms-triggered email).`, {
+        name: z.string().describe("Automation name"),
+        description: z.string().optional().describe("Description"),
+        type: z.string().default("CUSTOM").describe("Automation type (default CUSTOM)"),
+        status: z.enum(["ACTIVE", "INACTIVE"]).default("ACTIVE").describe("ACTIVE to run it, INACTIVE to keep it off"),
+        rule: z.record(z.any()).default({}).describe("Trigger + actions map. Leave {} for a blank automation you wire up later."),
+    }, ({ name, description, type, status, rule }) => handle(async () => {
+        const app = await ensureAutomationApp();
+        const res = await api.createAutomation({ name, ...(description ? { description } : {}), type, status, rule });
+        const a = res?.automation ?? res?.data ?? res;
+        return { success: true, automation_id: a?.id ?? null, name, status, app, hint: "Pass automation_id to send_mail to trigger it." };
+    }));
+    server.tool("update_automation", "Update an automation by id. Pass only the fields to change (name, description, type, status, rule).", {
+        id: z.string().describe("Automation id"),
+        name: z.string().optional(),
+        description: z.string().optional(),
+        type: z.string().optional(),
+        status: z.enum(["ACTIVE", "INACTIVE"]).optional(),
+        rule: z.record(z.any()).optional().describe("Replace the trigger + actions map"),
+    }, ({ id, ...fields }) => handle(async () => {
+        const res = await api.updateAutomation({ id, ...fields });
+        const a = res?.automation ?? res?.data ?? res;
+        return { success: true, automation_id: a?.id ?? id, updated: Object.keys(fields) };
+    }));
+    server.tool("delete_automation", "Delete one or more automations by id.", {
+        ids: z.array(z.string()).describe("Automation ids to delete"),
+    }, ({ ids }) => handle(async () => {
+        await api.deleteAutomations(ids);
+        return { success: true, deleted: ids };
+    }));
+    server.tool("send_mail", `Trigger a CMS automation to send an email (same endpoint @webcake/app/automation sendMail uses).
+Requires the automation_id — get it from list_automations. 'data' is the payload passed to that automation/email template.`, {
+        automation_id: z.string().describe("Automation id (a UUID) — from list_automations"),
+        data: z.record(z.any()).default({}).describe("Data object passed into the automation (e.g. recipient, variables for the email template)"),
+    }, ({ automation_id, data }) => handle(() => api.sendMail({ automation_id, data })));
 }

package/dist/web-guide.js

@@ -79,13 +79,13 @@ function tile(name) {
 const META = {
     vi: {
         title: "WebCake Storefront — Tạo website bán hàng chỉ bằng cách trò chuyện",
-        desc: "Bạn nói ý tưởng, trợ lý AI dựng trang, bạn xem trước rồi đăng lên — không cần kéo-thả hay biết lập trình. Kết nối Claude, Cursor, Windsurf với cửa hàng WebCake/StoreCake của bạn.",
+        desc: "Bạn nói ý tưởng, trợ lý AI dựng cả cửa hàng — tạo sản phẩm, danh mục, trang bán hàng và bài viết có ảnh — rồi xuất bản. Không cần kéo-thả hay biết lập trình. Kết nối Claude, Cursor, Windsurf với cửa hàng WebCake/StoreCake của bạn.",
         keywords: "WebCake, StoreCake, storefront, AI, Claude, Cursor, Windsurf, tạo trang bán hàng, website bán hàng, no-code, bán hàng online, tạo trang bằng AI",
         locale: "vi_VN",
     },
     en: {
         title: "WebCake Storefront — Build your online store just by chatting",
-        desc: "Tell your AI assistant what you want, it builds the page on your WebCake store, you review and publish — no dragging blocks, no coding required. Works with Claude, Cursor, Windsurf and more.",
+        desc: "Tell your AI assistant your idea and it builds an entire store — creating products, categories, shop pages and blog posts with images — then publishes. No dragging blocks, no coding. Works with Claude, Cursor, Windsurf and more.",
         keywords: "WebCake, StoreCake, storefront, AI, Claude, Cursor, Windsurf, AI page builder, no-code, e-commerce, online store builder",
         locale: "en_US",
     },
@@ -139,11 +139,11 @@ const FAQ = {
 };
 const T = {
     vi: {
-        sub: "Tạo website bán hàng chỉ bằng cách trò chuyện — không cần biết lập trình",
+        sub: "Dựng cả một cửa hàng online — sản phẩm, danh mục, trang, bài viết — chỉ bằng cách trò chuyện. Không cần biết lập trình.",
         running: "Đang hoạt động",
-        leadPre: "Bạn nói điều mình muốn, trợ lý AI dựng trang trên cửa hàng WebCake của bạn, bạn xem trước rồi ",
-        leadGrad: "đăng lên là xong",
-        leadPost: ". Không kéo-thả, không học gì thêm — chỉ cần nói chuyện như bình thường.",
+        leadPre: "Bạn nói ý tưởng, trợ lý AI dựng nguyên một cửa hàng trên WebCake — tạo sản phẩm, danh mục và trang bán hàng có ảnh — bạn xem trước rồi ",
+        leadGrad: "đăng lên là bán",
+        leadPost: ". Không kéo-thả, không học gì thêm — nhanh hơn thuê người làm web cả tuần.",
         ctaStart: "Bắt đầu ngay",
         ctaStar: "Tặng sao trên GitHub",
         flowH2: "Chỉ 4 bước đơn giản",
@@ -157,67 +157,67 @@ const T = {
         howH2: "Tại sao dùng được ngay, không lo hỏng",
         how: [
             {
-                icon: "layers",
-                t: "Trang đẹp, đúng ý",
-                d: "Trợ lý hiểu đúng bố cục cửa hàng WebCake — banner, lưới sản phẩm, form đặt hàng, đếm ngược — và dựng trang trông chuyên nghiệp ngay từ đầu.",
+                icon: "cart",
+                t: "Dữ liệu thật, không phải shop rỗng",
+                d: "Trợ lý tạo luôn sản phẩm, danh mục và bài viết kèm ảnh — nên lưới sản phẩm, danh mục, blog hiện nội dung thật ngay, trông như một shop đang chạy.",
             },
             {
                 icon: "check2",
-                t: "Không lo hỏng layout",
-                d: "Trước khi lưu, trang được kiểm tra tự động: bố cục có đúng không, các phần có khớp nhau không. Nếu có gì sai, trợ lý sẽ tự sửa.",
+                t: "Chuẩn trên mọi thiết bị",
+                d: "Trang dựng đúng mô hình lưới của WebCake và tự tối ưu cho desktop, laptop, tablet và điện thoại — không lo vỡ layout.",
             },
             {
                 icon: "shield",
                 t: "An toàn — luôn xem trước khi lưu",
-                d: "Mọi thay đổi đều được hiển thị để bạn xem trước. Chưa xác nhận thì cửa hàng chưa bị đụng tới — bạn hoàn toàn kiểm soát.",
+                d: "Mọi thay đổi đều hiển thị để bạn xem trước. Chưa xác nhận thì cửa hàng chưa bị đụng tới — bạn hoàn toàn kiểm soát.",
             },
             {
                 icon: "edit",
-                t: "Sửa nhẹ nhàng, đúng chỗ",
-                d: "Nói \"đổi nút sang màu tím\" hay \"thêm phần đánh giá\" — chỉ đúng chỗ đó được sửa, mọi thứ còn lại giữ nguyên.",
+                t: "Chỉnh đúng chỗ, xuất bản tức thì",
+                d: "Nói \"đổi nút sang tím\" hay \"thêm phần đánh giá\" — chỉ chỗ đó đổi. Ưng rồi bảo \"đăng lên\" là cửa hàng live ngay.",
             },
         ],
-        buildH2: "Bạn có thể tạo những trang nào",
+        buildH2: "Bạn dựng được cả một cửa hàng",
         uses: [
             {
-                icon: "cart",
-                t: "Trang bán 1 sản phẩm",
-                e: '"Tạo trang cho serum dưỡng da của tôi — có ảnh gallery, giá bán và nút đặt hàng."',
+                icon: "server",
+                t: "Cả cửa hàng từ con số 0",
+                e: '"Tạo cho tôi cửa hàng thời trang mới — vài danh mục, ít sản phẩm có ảnh và giá, rồi dựng trang chủ."',
             },
             {
-                icon: "window",
-                t: "Trang chủ cửa hàng",
-                e: '"Tạo trang chủ — banner giới thiệu, các sản phẩm nổi bật, ô đăng ký nhận tin."',
+                icon: "cart",
+                t: "Sản phẩm & danh mục có ảnh",
+                e: '"Thêm 6 sản phẩm áo thun vào danh mục \"Áo thun\" — kèm ảnh, giá và mô tả."',
             },
             {
-                icon: "flame",
-                t: "Trang flash sale",
-                e: '"Tạo trang flash sale — đồng hồ đếm ngược, danh sách sản phẩm giảm giá, nút mua dính cố định."',
+                icon: "window",
+                t: "Trang chủ bán hàng",
+                e: '"Tạo trang chủ — banner, lưới danh mục, sản phẩm nổi bật và bài viết mới."',
             },
             {
-                icon: "ticket",
-                t: "Trang sự kiện / webinar",
-                e: '"Tạo trang đăng ký sự kiện — thời gian, lịch trình, form đăng ký tham dự."',
+                icon: "layers",
+                t: "Bộ trang bán hàng đầy đủ",
+                e: '"Dựng đủ bộ: trang sản phẩm, danh mục, giỏ hàng, thanh toán và cảm ơn."',
             },
             {
-                icon: "mail",
-                t: "Thiệp mời",
-                e: '"Tạo thiệp cưới online — tên, ngày tháng, địa chỉ, form xác nhận tham dự."',
+                icon: "flame",
+                t: "Trang flash sale",
+                e: '"Tạo trang flash sale — đồng hồ đếm ngược, sản phẩm giảm giá, nút mua dính cố định."',
             },
             {
                 icon: "newspaper",
-                t: "Trang blog / nội dung",
-                e: '"Tạo trang blog với các bài viết nổi bật và ô đăng ký nhận bản tin."',
+                t: "Blog & bài viết",
+                e: '"Tạo chuyên mục blog và 3 bài viết có ảnh bìa, rồi gắn vào trang blog."',
             },
             {
-                icon: "link",
-                t: "Link-in-bio",
-                e: '"Tạo trang link-in-bio — ảnh đại diện, giới thiệu ngắn, 5 nút liên kết, mạng xã hội."',
+                icon: "shield",
+                t: "Trang thành viên",
+                e: '"Tạo trang đăng nhập, đăng ký và lịch sử đơn hàng cho khách."',
             },
             {
                 icon: "wand",
-                t: "Bất cứ trang nào bạn muốn",
-                e: '"…rồi \"đổi màu nút\" hay \"thêm phần hỏi đáp\" — trợ lý sửa đúng chỗ đó thôi."',
+                t: "Rồi chỉnh & đăng lên",
+                e: '"…\"đổi màu nút\", \"thêm phần hỏi đáp\" rồi \"đăng lên cửa hàng\" — xong."',
             },
         ],
         connectH2: "Kết nối trợ lý AI với cửa hàng của bạn",
@@ -254,8 +254,8 @@ const T = {
             },
             {
                 icon: "cart",
-                t: "Quản lý sản phẩm & đơn hàng",
-                d: "Xem sản phẩm, đơn hàng, bộ sưu tập, khuyến mãi, combo và thông tin khách hàng.",
+                t: "Tạo & quản lý sản phẩm",
+                d: "Tạo sản phẩm, danh mục, combo, khuyến mãi (kèm ảnh); xem đơn hàng, bộ sưu tập và thông tin khách hàng.",
             },
             {
                 icon: "newspaper",
@@ -279,8 +279,8 @@ const T = {
             },
         ],
         promptH2: "Ví dụ — nói với trợ lý như thế này",
-        promptSub: "Bạn có thể nói tự nhiên bằng tiếng Việt. Ví dụ:",
-        promptEx: "Tạo cho tôi một trang sản phẩm trên WebCake cho thương hiệu [tên thương hiệu].\nTrang cần có: ảnh sản phẩm lớn, tên và giá, mô tả ngắn, nút \"Mua ngay\".\nKiểm tra kỹ trước khi lưu, rồi xuất bản lên cửa hàng của tôi.",
+        promptSub: "Bạn có thể nói tự nhiên bằng tiếng Việt. Ví dụ, dựng cả cửa hàng:",
+        promptEx: "Tạo cho tôi một cửa hàng WebCake mới cho thương hiệu [tên thương hiệu].\nTạo 2-3 danh mục, mỗi danh mục vài sản phẩm có ảnh, giá và mô tả.\nDựng trang chủ: banner, lưới danh mục, sản phẩm nổi bật và mục bài viết mới.\nThêm 1 chuyên mục blog với 1 bài viết.\nKiểm tra kỹ rồi xuất bản lên cửa hàng giúp tôi.",
         faqH2: "Câu hỏi thường gặp",
         newH2: "Có gì mới",
         newBadge: "MỚI",
@@ -301,11 +301,11 @@ const T = {
         ],
     },
     en: {
-        sub: "Build your online store just by chatting — no coding or drag-and-drop needed",
+        sub: "Build a whole online store — products, categories, pages, blog posts — just by chatting. No coding required.",
         running: "Up and running",
-        leadPre: "You describe what you want, your AI assistant builds the page on your WebCake store, you review it and ",
+        leadPre: "You describe your idea, your AI assistant builds an entire store on WebCake — creating products, categories and shop pages with images — you preview it and ",
         leadGrad: "publish it — done",
-        leadPost: ". No dragging blocks, nothing to learn — just talk like you normally would.",
+        leadPost: ". No dragging blocks, nothing to learn — faster than waiting weeks for a web agency.",
         ctaStart: "Get started",
         ctaStar: "Star on GitHub",
         flowH2: "Just 4 simple steps",
@@ -319,14 +319,14 @@ const T = {
         howH2: "Why you can trust it straight away",
         how: [
             {
-                icon: "layers",
-                t: "Pages that look great",
-                d: "The assistant understands WebCake's store layout — banners, product grids, order forms, countdowns — and builds a professional-looking page right from your first message.",
+                icon: "cart",
+                t: "Real data, not an empty shell",
+                d: "The assistant also creates products, categories and blog posts with images — so product grids, category tiles and the blog show real content immediately, like a store that's already trading.",
             },
             {
                 icon: "check2",
-                t: "No broken layouts",
-                d: "Before saving, the page is automatically checked: is the layout correct, do the sections fit together? If anything is off, the assistant fixes it itself.",
+                t: "Looks right on every device",
+                d: "Pages are built on WebCake's real grid model and auto-tuned for desktop, laptop, tablet and phone — no broken layouts.",
             },
             {
                 icon: "shield",
@@ -335,51 +335,51 @@ const T = {
             },
             {
                 icon: "edit",
-                t: "Easy, precise edits",
-                d: "Say \"change the button to purple\" or \"add a reviews section\" — only that exact spot is updated, everything else stays as it was.",
+                t: "Precise edits, instant publish",
+                d: "Say \"make the button purple\" or \"add a reviews section\" — only that spot changes. Happy? Say \"publish\" and your store is live.",
             },
         ],
-        buildH2: "What you can create",
+        buildH2: "You build a whole store",
         uses: [
+            {
+                icon: "server",
+                t: "A whole store from scratch",
+                e: '"Build me a new fashion store — a few categories, some products with images and prices, then a homepage."',
+            },
             {
                 icon: "cart",
-                t: "Single product page",
-                e: '"Create a page for my skincare serum — photo gallery, price, and an order button."',
+                t: "Products & categories with images",
+                e: '"Add 6 t-shirt products to the \"T-shirts\" category — with images, prices and descriptions."',
             },
             {
                 icon: "window",
                 t: "Store homepage",
-                e: '"Create a homepage — intro banner, featured products, newsletter sign-up."',
-            },
-            {
-                icon: "flame",
-                t: "Flash sale page",
-                e: '"Create a flash sale page — big countdown timer, discounted products, sticky buy button."',
+                e: '"Create a homepage — banner, category grid, featured products and latest posts."',
             },
             {
-                icon: "ticket",
-                t: "Event / webinar page",
-                e: '"Create an event sign-up page — date, schedule, registration form."',
+                icon: "layers",
+                t: "A full set of shop pages",
+                e: '"Build the full set: product page, category, cart, checkout and thank-you."',
             },
             {
-                icon: "mail",
-                t: "Invitation",
-                e: '"Create a wedding invite — names, date, location, RSVP form."',
+                icon: "flame",
+                t: "Flash sale page",
+                e: '"Create a flash sale page — countdown timer, discounted products, sticky buy button."',
             },
             {
                 icon: "newspaper",
-                t: "Blog / content page",
-                e: '"Create a blog page with featured posts and a newsletter subscribe box."',
+                t: "Blog & articles",
+                e: '"Create a blog category and 3 articles with cover images, then wire up the blog page."',
             },
             {
-                icon: "link",
-                t: "Link-in-bio",
-                e: '"Create a link-in-bio — profile photo, short bio, 5 link buttons, socials."',
+                icon: "shield",
+                t: "Member pages",
+                e: '"Create login, register and order-history pages for customers."',
             },
             {
                 icon: "wand",
-                t: "Anything you can think of",
-                e: '"…then \"change the button colour\" or \"add an FAQ section\" — just that part gets updated."',
+                t: "Then tweak & publish",
+                e: '"…\"change the button colour\", \"add an FAQ\", then \"publish to my store\" — done."',
             },
         ],
         connectH2: "Connect your AI assistant to your store",
@@ -416,8 +416,8 @@ const T = {
             },
             {
                 icon: "cart",
-                t: "Products & orders",
-                d: "View products, orders, collections, promotions, bundles, and customer information.",
+                t: "Create & manage products",
+                d: "Create products, categories, bundles and promotions (with images); view orders, collections and customer info.",
             },
             {
                 icon: "newspaper",
@@ -441,8 +441,8 @@ const T = {
             },
         ],
         promptH2: "Example — here's what to say to your assistant",
-        promptSub: "You can speak naturally. For example:",
-        promptEx: "Create a product page on my WebCake store for [brand name].\nThe page should have: a large product image, name and price, a short description, and a \"Buy Now\" button.\nPlease check everything looks right before saving, then publish it to my store.",
+        promptSub: "You can speak naturally. For example, build a whole store:",
+        promptEx: "Create a new WebCake store for [brand name].\nCreate 2-3 categories, each with a few products that have images, prices and descriptions.\nBuild the homepage: banner, category grid, featured products and a latest-posts section.\nAdd a blog category with one article.\nCheck everything, then publish it to my store.",
         faqH2: "Frequently asked questions",
         newH2: "What's new",
         newBadge: "NEW",
@@ -584,22 +584,36 @@ export function guideHtml(origin, lang = "vi") {
 <meta name="twitter:image:alt" content="${m.title}">
 <script type="application/ld+json">${jsonLdScript}</script>
 <style>
-  :root{--g:#108B67;--g7:#0c6f52;--ink:#11121e;--mut:#5e5f7a;--bg:#f6f5ff;--card:#ffffff;
-    --line:rgba(16,14,40,.09);--shadow:0 1px 2px rgba(16,14,40,.05),0 6px 20px -12px rgba(16,14,40,.18);--code:#0e0d1a;
-    --ic-fg:#0c6f52;--btn-hover:#0c6f52;--navbg:rgba(246,245,255,.82)}
-  @media(prefers-color-scheme:dark){:root:not([data-theme="light"]){--ink:#eaf1ee;--mut:#9fb0a9;--bg:#0f1714;--card:#18211d;
-    --line:rgba(255,255,255,.09);--shadow:0 1px 2px rgba(0,0,0,.35),0 12px 34px -16px rgba(0,0,0,.6);--code:#0b120f;--g:#16a37c;--g7:#6fe6c0;--ic-fg:#8aecc9;--btn-hover:#1cba8d;--navbg:rgba(15,23,20,.82)}}
-  :root[data-theme="dark"]{--ink:#eaf1ee;--mut:#9fb0a9;--bg:#0f1714;--card:#18211d;
-    --line:rgba(255,255,255,.09);--shadow:0 1px 2px rgba(0,0,0,.35),0 12px 34px -16px rgba(0,0,0,.6);--code:#0b120f;--g:#16a37c;--g7:#6fe6c0;--ic-fg:#8aecc9;--btn-hover:#1cba8d;--navbg:rgba(15,23,20,.82)}
+  :root{--g:#108B67;--g7:#0c6f52;--ink:#13211c;--mut:#5a6b64;--bg:#f6faf8;--bg2:#e9f2ec;--card:#ffffff;
+    --line:rgba(16,48,38,.10);--shadow:0 1px 2px rgba(16,48,38,.05),0 6px 20px -12px rgba(16,48,38,.18);--code:#0c1a15;
+    --ic-fg:#0c6f52;--btn-hover:#0c6f52;--navbg:rgba(246,250,248,.82)}
+  @media(prefers-color-scheme:dark){:root:not([data-theme="light"]){--ink:#eaf1ee;--mut:#9fb0a9;--bg:#0d1714;--bg2:#091310;--card:#161f1b;
+    --line:rgba(255,255,255,.09);--shadow:0 1px 2px rgba(0,0,0,.35),0 12px 34px -16px rgba(0,0,0,.6);--code:#0b120f;--g:#16a37c;--g7:#6fe6c0;--ic-fg:#8aecc9;--btn-hover:#1cba8d;--navbg:rgba(13,23,20,.82)}}
+  :root[data-theme="dark"]{--ink:#eaf1ee;--mut:#9fb0a9;--bg:#0d1714;--bg2:#091310;--card:#161f1b;
+    --line:rgba(255,255,255,.09);--shadow:0 1px 2px rgba(0,0,0,.35),0 12px 34px -16px rgba(0,0,0,.6);--code:#0b120f;--g:#16a37c;--g7:#6fe6c0;--ic-fg:#8aecc9;--btn-hover:#1cba8d;--navbg:rgba(13,23,20,.82)}
   *{box-sizing:border-box}
   html{scroll-behavior:auto}
   html.smooth{scroll-behavior:smooth}
   body{margin:0;font-family:system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;color:var(--ink);
-    background:var(--bg);line-height:1.62;overflow-x:hidden}
+    background:linear-gradient(180deg,var(--bg) 0%,var(--bg2) 100%);background-attachment:fixed;
+    min-height:100vh;line-height:1.62;overflow-x:hidden}
+  /* layered "aurora" mesh of soft teal glows */
+  body::before{content:"";position:fixed;inset:0;z-index:-2;pointer-events:none;
+    background:
+      radial-gradient(58% 46% at 50% -8%,rgba(16,139,103,.12),transparent 70%),
+      radial-gradient(40% 38% at 100% 4%,rgba(20,168,124,.09),transparent 70%),
+      radial-gradient(46% 46% at 0% 100%,rgba(16,139,103,.08),transparent 70%)}
+  /* faint grid texture, masked so it only whispers near the top */
+  body::after{content:"";position:fixed;inset:0;z-index:-2;pointer-events:none;opacity:.55;
+    background-image:linear-gradient(var(--line) 1px,transparent 1px),linear-gradient(90deg,var(--line) 1px,transparent 1px);
+    background-size:46px 46px;
+    -webkit-mask:radial-gradient(120% 70% at 50% 0%,#000 0%,transparent 62%);
+    mask:radial-gradient(120% 70% at 50% 0%,#000 0%,transparent 62%)}
   .blobs{position:fixed;inset:0;z-index:-1;overflow:hidden;pointer-events:none}
-  .blobs b{position:absolute;border-radius:50%;filter:blur(90px);opacity:.16;will-change:transform}
+  .blobs b{position:absolute;border-radius:50%;filter:blur(100px);opacity:.13;will-change:transform}
   .blobs b:nth-child(1){width:560px;height:560px;right:-160px;top:-180px;background:radial-gradient(circle,#108B67,transparent 70%);animation:drift1 40s ease-in-out infinite}
   .blobs b:nth-child(2){width:440px;height:440px;left:-160px;bottom:-160px;background:radial-gradient(circle,#14a87c,transparent 70%);animation:drift2 48s ease-in-out infinite}
+  .blobs b:nth-child(3){width:380px;height:380px;left:46%;top:34%;background:radial-gradient(circle,#3fcf9e,transparent 70%);opacity:.08;animation:drift1 56s ease-in-out infinite}
   @keyframes drift1{50%{transform:translate(-50px,60px)}}
   @keyframes drift2{50%{transform:translate(40px,-50px)}}
   .wrap{max-width:900px;margin:0 auto;padding:48px 20px 72px}
@@ -793,7 +807,7 @@ export function guideHtml(origin, lang = "vi") {
   }
 </style></head>
 <body>
-<div class="blobs"><b></b><b></b></div>
+<div class="blobs"><b></b><b></b><b></b></div>
 <div class="wrap">
 
   <header class="hero-in">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-storefront-mcp",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "MCP server for the WebCake/StoreCake storefront builder — page CRUD, page authoring, products, orders, and more",
   "mcpName": "io.github.vuluu2k/webcake-storefront-mcp",
   "license": "MIT",