sbuilder-mcp 0.59.1 → 0.59.3

package/CHANGELOG.md

@@ -6,6 +6,17 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.59.3] - 2026-09-15
+
+### Changed
+- The call sheet for `POST /api/sites/{siteId}/ai/messages` now documents its `context` body field — the page outline plus the selected element's trait list, value types and current values — so a call through `sb_api_call` can pass the editor's own capability list instead of guessing at the shape.
+
+## [0.59.2] - 2026-09-15
+
+### Fixed
+- The call sheet for creating or replacing a product now states, at the moment a price is written, that `priceCents`, `compareAtCents`, `costCents`, and a shipping method's `feeCents` are minor units divided by 100 on the storefront, instead of only as the fix for a readiness gap that clears the moment a product exists.
+- The call sheet now states that the variant picker renders from `product.attributes`, not from `variants[].options` alone, so a product with variants but no declared attributes no longer silently ships the element's seed options ("Color: Red / Green / Blue") on the published page.
+
 ## [0.59.1] - 2026-09-15
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,17 @@ Mọi thay đổi đáng chú ý của dự án được ghi lại trong file n
 Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 và dự án tuân theo [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.59.3] - 2026-09-15
+
+### Changed
+- Call sheet cho `POST /api/sites/{siteId}/ai/messages` giờ mô tả trường `context` trong body — gồm outline của trang cùng danh sách trait, kiểu giá trị và giá trị hiện tại của phần tử đang chọn — nhờ đó một lệnh gọi qua `sb_api_call` có thể gửi đúng danh sách năng lực của editor thay vì phải đoán hình dạng của nó.
+
+## [0.59.2] - 2026-09-15
+
+### Fixed
+- Call sheet để tạo hoặc thay thế sản phẩm giờ nêu rõ, ngay tại thời điểm giá được ghi, rằng `priceCents`, `compareAtCents`, `costCents` và `feeCents` của một shipping method đều là đơn vị nhỏ nhất, được chia cho 100 trên storefront, thay vì chỉ xuất hiện như hướng khắc phục cho một lỗi sẵn sàng vốn biến mất ngay khi có sản phẩm.
+- Call sheet giờ nêu rõ bộ chọn variant hiển thị từ `product.attributes`, không phải chỉ từ `variants[].options`, nhờ đó một sản phẩm có variant nhưng chưa khai báo attributes sẽ không còn âm thầm hiển thị các tuỳ chọn gieo sẵn của phần tử ("Color: Red / Green / Blue") trên trang đã publish.
+
 ## [0.59.1] - 2026-09-15
 
 ### Added

package/dist/catalog/api.generated.js

@@ -3349,7 +3349,7 @@ export const API_OPERATIONS = [
                 "in": "body",
                 "required": true,
                 "type": "object",
-                "description": "question (required) and history (prior turns: role user|assistant, text)"
+                "description": "question (required), history (prior turns: role user|assistant, text) and context (the selected element the agent may propose edits to)"
             }
         ],
         "bodyDescribed": false,

package/dist/catalog/deadkeys.generated.js

@@ -1,6 +1,6 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 4007,
-    "identifiers": 76941,
+    "files": 4023,
+    "identifiers": 77197,
     "seededKeys": 384,
     "dead": 0
 };

package/dist/catalog/search.js

@@ -352,7 +352,7 @@ export function describeOperation(op) {
                 '/apps/blocks again for what it contributed.',
         };
     }
-    // FILLING A CATALOGUE WAS REACHABLE AND THREE FACTS ABOUT IT WERE NOT, each
+    // FILLING A CATALOGUE WAS REACHABLE AND FIVE FACTS ABOUT IT WERE NOT, each
     // failing silently. Attached to the call sheet for the same reason the
     // translation table is: this is where the agent is when it decides what to
     // send, on both credential surfaces a product can be created or replaced on.
@@ -360,6 +360,37 @@ export function describeOperation(op) {
         out.product_traps = {
             price: 'Price lives on the VARIANT, not the product — variants[].priceCents. A product ' +
                 'posted with no variant renders a catalogue entry nobody can buy.',
+            // MINOR UNITS, SAID WHERE THE NUMBER IS BEING WRITTEN.
+            //
+            // The fact was already in the codebase — `readiness.ts` carries it twice —
+            // but only as the FIX on a store gap that fires when the catalogue is
+            // EMPTY or has no priced product. The moment an agent creates products the
+            // gap clears, so the sentence is on screen exactly while it cannot be
+            // acted on and gone the moment it could be.
+            //
+            // MEASURED: a whole storefront built with every price 100× low. Cherry at
+            // "8.500 ₫", a 3.2M gift basket at "32.000 ₫" — read back through the
+            // renderer, published, and only caught because the numbers looked absurd
+            // to a human. Nothing refused them: `priceCents` takes any integer, and a
+            // store whose every price is wrong by the same factor looks internally
+            // consistent.
+            units: 'priceCents is MINOR UNITS — the storefront divides by 100, so VND 280.000 is ' +
+                "28000000. Same for compareAtCents, costCents and a shipping method's feeCents. " +
+                'Nothing refuses a wrong one, and every price wrong by the same factor looks ' +
+                'deliberate. Write one, read the rendered price, then write the rest.',
+            // THE PICKER A PRODUCT GETS WHEN NOBODY DECLARED ITS OPTIONS.
+            //
+            // `variants[].options` alone is not enough: the buy box reads
+            // `attributes` for the control, and a product with variants but no
+            // attributes renders the ELEMENT'S SEED — "Color: Red / Green / Blue",
+            // "Size: S / M / L" — on a real product page, published.
+            //
+            // MEASURED on a fruit-gift store: every one of 19 products offered Color
+            // and Size until attributes were added.
+            attributes: 'The variant picker comes from product.attributes — [{ name, values[] }] — not ' +
+                "from variants[].options alone. Variants without attributes render the element's " +
+                'seed ("Color: Red / Green / Blue") on the published page. Declare attributes, and ' +
+                "match each variant's options keys to them.",
             slug: 'A colliding slug is RENAMED, not refused, and the write still answers 200/201. ' +
                 'Re-running an import does not error — it DOUBLES the catalogue in silence.',
             images: 'POST /api/media/{siteId}/from-url ingests a photo straight from its URL, one hop ' +

package/dist/catalog/shapes.generated.js

@@ -4,7 +4,7 @@ export const SHAPE_SOURCE = {
     "fromHandlers": 176,
     "fromSwaggerOnly": 0,
     "withReadOnly": 26,
-    "structsRead": 1678
+    "structsRead": 1697
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{siteId}/api-keys": {
@@ -3008,6 +3008,11 @@ export const REQUEST_SHAPES = {
                 "name": "history",
                 "type": "llm.Turn[]",
                 "note": "History is sent by the CLIENT, unlike the storefront chatbot's, which removed it as a security fix."
+            },
+            {
+                "name": "context",
+                "type": "editoragent.EditContext | null",
+                "note": "Context is the PAGE as the EDITOR described it — the outline of ROOT's children, and the selected element with its trait list, value types and current values, read off the live registries at send time. IT IS THE CAPABILITY LIST, not a hint."
             }
         ],
         "source": "go",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.59.1",
+  "version": "0.59.3",
   "description": "MCP server that designs and operates a Store Builder site — pages, data, theme and publish — through the platform's own API and live-edit protocol.",
   "mcpName": "io.github.vuluu2k/sbuilder-mcp",
   "type": "module",