sbuilder-mcp 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -6,6 +6,26 @@ 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.7.0] - 2026-09-08
+
+### Added
+- sb_import reads any public URL and adds its structure and content to the open page as real elements — section, heading, text, image, button, list — dressed in that page's own tokens (ink and weight off the first heading, colour and size off the first body line, fill and radius off the first non-transparent button) instead of embedding the source's raw markup. An image is bounded in both axes rather than only capped in width, since an SVG has no intrinsic pixel size and would otherwise stretch a section into thousands of pixels of empty space; each image is uploaded into the site's own media library, falling back to the original URL on a failed upload, and a failure is reported grouped and counted by reason rather than as a bare count. dry_run (the default) returns what was found before anything is added.
+- npm run codegen:check runs the catalog generator against a committed platform ref and writes nothing, exiting 1 and naming every file that would change, so a stale catalog is caught before a tool starts describing an element or operation the platform no longer has.
+
+### Changed
+- The element and API catalog is regenerated: adds the bundle-items element and the kind, bundlePricing, bundleValue and bundleItems fields on a product, plus a set of relation-slot operations and a storefront-string levelling command; sb_api_find's token budget ceiling is raised to 3,500 to hold the larger product call sheet.
+
+### Fixed
+- sb_look can now photograph a node whose box sits below roughly the first 900px of the page; a clip request previously ran against the viewport alone and failed with Playwright's "Clipped area is either empty or outside the resulting image" for anything further down, and it now captures the full page first so the clip lines up regardless of where the node sits.
+
+## [0.6.0] - 2026-09-08
+
+### Added
+- sb_store now takes action:"form" alongside action:"checkout", seeding any of the platform's 17 form templates (contact, subscribe, order, address, consult, booking, stay, feedback, event, quote, apply, and the five auth forms login, register, forgot, verify, reset) with their own field document, instead of the checkout order form being the only one this server could build; it creates the form, PUTs it back whole (a bare create is otherwise silently renamed and turned custom), then saves the template's field document, deleting the form again if either write fails. It makes no page, since where a login form belongs is a design decision — place it with sb_add and point specials.formId at the id returned.
+
+### Fixed
+- sb_review no longer reports empty_container on a global section's or app block's reference node, since a page stores its shared header or footer as an empty node stamped globalRef or appBlockRef that the platform composes the master into on read; the fix the finding used to name, adding something inside it, was decomposed away by the very next save.
+
 ## [0.5.0] - 2026-09-08
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,26 @@ 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.7.0] - 2026-09-08
+
+### Added
+- sb_import đọc bất kỳ URL công khai nào và thêm cấu trúc, nội dung của nó vào trang đang mở dưới dạng các element thật — section, heading, text, image, button, list — được khoác token của chính trang đó (màu và độ đậm lấy từ heading đầu tiên, màu và cỡ chữ lấy từ dòng văn bản đầu tiên, màu nền và bo góc lấy từ nút không trong suốt đầu tiên) thay vì nhúng nguyên markup của nguồn. Một ảnh được giới hạn kích thước ở cả hai chiều thay vì chỉ giới hạn chiều rộng, vì một SVG không có kích thước pixel nội tại nên nếu không sẽ kéo dài cả một section thành hàng nghìn pixel khoảng trắng; mỗi ảnh được tải lên thư viện media của chính site, giữ nguyên URL gốc nếu upload thất bại, và một lỗi upload được báo cáo theo nhóm và đếm theo lý do thay vì chỉ là một con số trần trụi. dry_run (mặc định) trả về những gì tìm thấy trước khi thêm bất cứ thứ gì.
+- npm run codegen:check chạy trình sinh catalog dựa trên một ref đã commit của nền tảng và không ghi gì cả, thoát với mã 1 và nêu tên mọi file sẽ thay đổi, để một catalog cũ được phát hiện trước khi một tool bắt đầu mô tả một element hay operation mà nền tảng không còn nữa.
+
+### Changed
+- Catalog element và API được tạo lại: thêm element bundle-items cùng các trường kind, bundlePricing, bundleValue và bundleItems trên một sản phẩm, cùng một loạt operation cho relation-slot và lệnh làm phẳng chuỗi storefront; trần token budget của sb_api_find được nâng lên 3.500 để chứa call sheet sản phẩm lớn hơn.
+
+### Fixed
+- sb_look giờ có thể chụp được một node có box nằm dưới khoảng 900px đầu tiên của trang; trước đây một yêu cầu clip chỉ chạy trên viewport và thất bại với lỗi "Clipped area is either empty or outside the resulting image" của Playwright với bất kỳ node nào nằm xa hơn, và giờ nó chụp toàn trang trước để tọa độ clip khớp bất kể node nằm ở đâu.
+
+## [0.6.0] - 2026-09-08
+
+### Added
+- sb_store giờ nhận action:"form" bên cạnh action:"checkout", gieo bất kỳ template nào trong 17 template form của nền tảng (contact, subscribe, order, address, consult, booking, stay, feedback, event, quote, apply, và năm form xác thực login, register, forgot, verify, reset) cùng field document riêng của nó, thay vì trước đây server này chỉ dựng được đúng order form của checkout; nó tạo form, PUT lại nguyên vẹn (nếu không thì một lần tạo đơn thuần sẽ bị âm thầm đổi tên và chuyển thành custom), rồi lưu field document của template, và xoá lại form nếu một trong hai lệnh ghi đó thất bại. Nó không tạo trang, vì đặt form login ở đâu là quyết định thiết kế — hãy đặt form bằng sb_add rồi trỏ specials.formId vào id được trả về.
+
+### Fixed
+- sb_review không còn báo cáo empty_container trên node tham chiếu của một global section hay app block, vì một trang lưu header hoặc footer dùng chung dưới dạng node rỗng gắn cờ globalRef hoặc appBlockRef mà nền tảng sẽ ghép bản gốc vào khi đọc; cách sửa mà finding này từng nêu ra — thêm gì đó vào bên trong — sẽ bị lần lưu kế tiếp phân rã mất ngay.
+
 ## [0.5.0] - 2026-09-08
 
 ### Added

package/README.md

@@ -98,7 +98,8 @@ make, because those mean "this person's account".
 | `sb_look` | Save, render, and return screenshots plus measured node boxes and layout defects measured on the render |
 | `sb_event` | Give a node a click action — open the cart, go to a page, open a pop-up |
 | `sb_bind` | Bind a node's content to real store data, or make a button add to the cart |
-| `sb_store` | Run a store flow that must happen in a fixed order — today, the four writes that make a working checkout |
+| `sb_import` | Read a page from any public URL and add its structure and content to the open page as real elements, styled with THIS page's own tokens — a translation, not a clone |
+| `sb_store` | Run a store flow that must happen in a fixed order — the four writes that make a working checkout, or any of the platform's 17 form templates (login, register, forgot, contact, subscribe …) with its own field document |
 | `sb_undo` | Put back what a PUT replaced — the platform has no page history or restore, so this is the only way back |
 
 Twenty-eight tools, **484 API operations** (158 of the 212 writes carrying a body shape read

package/README.vi.md

@@ -95,7 +95,8 @@ là "tài khoản của người này".
 | `sb_look` | Lưu, render, trả về ảnh chụp kèm box đo được của node và lỗi bố cục đo trên bản render |
 | `sb_event` | Gắn click action cho một node — mở giỏ, sang trang, mở pop-up |
 | `sb_bind` | Gắn nội dung một node vào dữ liệu cửa hàng thật, hoặc biến một nút thành nút thêm vào giỏ |
-| `sb_store` | Chạy một luồng cửa hàng bắt buộc đúng thứ tự — hiện là bốn lệnh ghi tạo nên một trang thanh toán hoạt động |
+| `sb_import` | Đọc một trang từ URL công khai bất kỳ và thêm cấu trúc + nội dung của nó vào trang đang mở dưới dạng element thật, mang token của CHÍNH trang này — là dịch lại, không phải sao chép |
+| `sb_store` | Chạy một luồng cửa hàng bắt buộc đúng thứ tự — bốn lệnh ghi tạo nên trang thanh toán, hoặc gieo bất kỳ template nào trong 17 form của nền tảng (login, register, forgot, contact, subscribe …) kèm field document của nó |
 | `sb_undo` | Trả lại thứ mà một lệnh PUT đã ghi đè — nền tảng không có lịch sử trang hay restore, nên đây là đường về duy nhất |
 
 Hai mươi tám tool, **484 operation API** (158 trong 212 lệnh ghi có hình dạng body đọc thẳng

package/dist/catalog/api.generated.js

@@ -1,8 +1,8 @@
 export const SWAGGER_SOURCE = {
-    "operations": 484,
-    "definitions": 99,
-    "bodyCarrying": 171,
-    "bodyUndescribed": 62,
+    "operations": 486,
+    "definitions": 102,
+    "bodyCarrying": 172,
+    "bodyUndescribed": 63,
     "generatedFrom": "server/docs/swagger.json"
 };
 export const API_OPERATIONS = [
@@ -10226,14 +10226,58 @@ export const API_OPERATIONS = [
         "bodyRef": "github_com_webbuilder_server_internal_products.Product",
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/products/{id}/bundles",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/products/{id}/bundles",
+        "tags": [
+            "products",
+            "products"
+        ],
+        "summary": "Bundles containing a product",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "body",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "Category IDs to set (PUT only): {\\"
+            },
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Product ID"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/products/{productId}/categories",
         "method": "GET",
         "path": "/api/sites/{siteId}/products/{productId}/categories",
         "tags": [
+            "products",
             "products"
         ],
-        "summary": "Get or set a product's category links",
+        "summary": "Bundles containing a product",
         "params": [
             {
                 "name": "siteId",
@@ -10255,6 +10299,13 @@ export const API_OPERATIONS = [
                 "required": false,
                 "type": "object",
                 "description": "Category IDs to set (PUT only): {\\"
+            },
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
             }
         ],
         "bodyDescribed": false,
@@ -10266,9 +10317,10 @@ export const API_OPERATIONS = [
         "method": "PUT",
         "path": "/api/sites/{siteId}/products/{productId}/categories",
         "tags": [
+            "products",
             "products"
         ],
-        "summary": "Get or set a product's category links",
+        "summary": "Bundles containing a product",
         "params": [
             {
                 "name": "siteId",
@@ -10290,6 +10342,13 @@ export const API_OPERATIONS = [
                 "required": false,
                 "type": "object",
                 "description": "Category IDs to set (PUT only): {\\"
+            },
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
             }
         ],
         "bodyDescribed": false,
@@ -10646,6 +10705,34 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/relation-slots/usage",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/relation-slots/usage",
+        "tags": [
+            "relations"
+        ],
+        "summary": "How many curated shelves reference an item",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "itemId",
+                "in": "query",
+                "required": true,
+                "type": "string",
+                "description": "Product or article id"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "post:/api/sites/{siteId}/restore",
         "method": "POST",
@@ -15482,6 +15569,36 @@ export const API_DEFINITIONS = {
             }
         }
     },
+    "github_com_webbuilder_server_internal_products.BundleItem": {
+        "type": "object",
+        "properties": {
+            "position": {
+                "description": "Position is the merchant's arrangement — the order the components are\nlisted on the product page.",
+                "type": "integer"
+            },
+            "productId": {
+                "type": "string"
+            },
+            "quantity": {
+                "description": "Quantity is how many units of the component one combo contains (≥ 1).",
+                "type": "integer"
+            },
+            "variantId": {
+                "type": "string"
+            }
+        }
+    },
+    "github_com_webbuilder_server_internal_products.BundlePricing": {
+        "type": "string",
+        "enum": [
+            "fixed",
+            "percent"
+        ],
+        "x-enum-varnames": [
+            "BundlePricingFixed",
+            "BundlePricingPercent"
+        ]
+    },
     "github_com_webbuilder_server_internal_products.MetaTag": {
         "type": "object",
         "properties": {
@@ -15533,6 +15650,24 @@ export const API_DEFINITIONS = {
             "brand": {
                 "type": "string"
             },
+            "bundleItems": {
+                "description": "BundleItems is what one combo contains. Empty on every simple product, and\non a combo a merchant has not finished building — which is authorable but\nnot sellable (ApplyBundleTotals).",
+                "type": "array",
+                "items": {
+                    "$ref": "#/definitions/github_com_webbuilder_server_internal_products.BundleItem"
+                }
+            },
+            "bundlePricing": {
+                "description": "BundlePricing and BundleValue are how a combo is priced: a flat price in\ncents (\"fixed\") or a percentage off the components' total (\"percent\",\n0–100). The two share one Value field for the reason discounts.Discount\ndoes — the unit is a function of the mode, and two fields would let a\nmerchant leave the unused one holding a number that means nothing.\n\nBoth are ignored (and cleared) on a simple product.",
+                "allOf": [
+                    {
+                        "$ref": "#/definitions/github_com_webbuilder_server_internal_products.BundlePricing"
+                    }
+                ]
+            },
+            "bundleValue": {
+                "type": "integer"
+            },
             "compareAtCents": {
                 "description": "CompareAt of the min-price visible variant; 0 = none",
                 "type": "integer"
@@ -15558,6 +15693,14 @@ export const API_DEFINITIONS = {
                     "type": "string"
                 }
             },
+            "kind": {
+                "description": "Kind says whether this is an ordinary product or a COMBO whose price and\navailability are derived from the components in BundleItems. Absent on the\nwire means simple — see bundle.go, which owns every rule below.",
+                "allOf": [
+                    {
+                        "$ref": "#/definitions/github_com_webbuilder_server_internal_products.ProductKind"
+                    }
+                ]
+            },
             "moneyOverride": {
                 "description": "MoneyOverride is an opaque per-product money-display override (compact-convert\nrules + exchange-rate overrides), stored as a JSONB blob. The domain keeps it\nopaque — it is decoded at the render boundary (bindings.ProductSource →\nrender.ProductData) — so products stays decoupled from render/money, the same\nway the site settings document is an opaque blob. Empty ({}/null) → no override.",
                 "type": "array",
@@ -15694,6 +15837,17 @@ export const API_DEFINITIONS = {
             }
         }
     },
+    "github_com_webbuilder_server_internal_products.ProductKind": {
+        "type": "string",
+        "enum": [
+            "simple",
+            "bundle"
+        ],
+        "x-enum-varnames": [
+            "ProductKindSimple",
+            "ProductKindBundle"
+        ]
+    },
     "github_com_webbuilder_server_internal_products.ProductStatus": {
         "type": "string",
         "enum": [