sbuilder-mcp 0.6.0 → 0.7.1

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.1] - 2026-09-08
+
+### Added
+- sb_import takes max_images (default 24), bounding how many images it uploads from the imported page, since every image is a real upload and a page shape like a sponsors wall can carry dozens of them in a single tool call.
+
+### Fixed
+- sb_import no longer duplicates content that sits inside a nested section; it previously matched every `<section>` on the page, so an outer band and the bands nested inside it were both captured and the inner content came back twice. Only the innermost matching section is now kept, since the outermost is a candidate too and keeping it would reduce the whole page to one band.
+
+## [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

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.1] - 2026-09-08
+
+### Added
+- sb_import nhận max_images (mặc định 24), giới hạn số ảnh nó tải lên từ trang được import, vì mỗi ảnh là một lần upload thật và một dạng trang như tường tài trợ có thể chứa hàng chục ảnh trong một lần gọi tool.
+
+### Fixed
+- sb_import không còn nhân đôi nội dung nằm trong một section lồng nhau; trước đây nó khớp với mọi `<section>` trên trang, nên một band bên ngoài và các band lồng bên trong nó đều bị lấy, khiến nội dung bên trong xuất hiện hai lần. Giờ chỉ section trong cùng khớp được giữ lại, vì section ngoài cùng cũng là một ứng viên và giữ nó sẽ làm cả trang chỉ còn một band.
+
+## [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

package/README.md

@@ -98,6 +98,7 @@ 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_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 |
 

package/README.vi.md

@@ -95,6 +95,7 @@ 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_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 |
 

package/dist/catalog/api.generated.js

@@ -1,8 +1,8 @@
 export const SWAGGER_SOURCE = {
-    "operations": 485,
+    "operations": 486,
     "definitions": 102,
-    "bodyCarrying": 171,
-    "bodyUndescribed": 62,
+    "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,

package/dist/catalog/checkout.generated.js

@@ -5047,7 +5047,8 @@ export const FORM_TEMPLATES = {
                             "freg_3",
                             "freg_4",
                             "freg_5",
-                            "freg_6"
+                            "freg_6",
+                            "freg_7"
                         ],
                         "isCanvas": false,
                         "hidden": false,
@@ -5226,6 +5227,46 @@ export const FORM_TEMPLATES = {
                 },
                 "freg_6": {
                     "id": "freg_6",
+                    "data": {
+                        "type": "form-text",
+                        "parent": "freg_1",
+                        "nodes": [],
+                        "isCanvas": false,
+                        "hidden": false,
+                        "custom": {}
+                    },
+                    "style": {
+                        "width": "100%"
+                    },
+                    "config": {
+                        "iconPosition": "left"
+                    },
+                    "specials": {
+                        "showIcon": false,
+                        "iconName": "",
+                        "name": "confirmPassword",
+                        "label": "Nhập lại mật khẩu",
+                        "placeholder": "",
+                        "description": "",
+                        "required": true,
+                        "showLabel": true,
+                        "mapTo": "",
+                        "prefillValue": "",
+                        "multiline": false,
+                        "inputType": "password",
+                        "limitChars": false,
+                        "minChars": 0,
+                        "maxChars": 500,
+                        "patternPreset": "",
+                        "pattern": "",
+                        "patternCountries": []
+                    },
+                    "responsive": {},
+                    "events": [],
+                    "bindings": []
+                },
+                "freg_7": {
+                    "id": "freg_7",
                     "data": {
                         "type": "form-submit",
                         "parent": "freg_1",
@@ -5593,7 +5634,8 @@ export const FORM_TEMPLATES = {
                             "fres_3",
                             "fres_4",
                             "fres_5",
-                            "fres_6"
+                            "fres_6",
+                            "fres_7"
                         ],
                         "isCanvas": false,
                         "hidden": false,
@@ -5772,6 +5814,46 @@ export const FORM_TEMPLATES = {
                 },
                 "fres_6": {
                     "id": "fres_6",
+                    "data": {
+                        "type": "form-text",
+                        "parent": "fres_1",
+                        "nodes": [],
+                        "isCanvas": false,
+                        "hidden": false,
+                        "custom": {}
+                    },
+                    "style": {
+                        "width": "100%"
+                    },
+                    "config": {
+                        "iconPosition": "left"
+                    },
+                    "specials": {
+                        "showIcon": false,
+                        "iconName": "",
+                        "name": "confirmPassword",
+                        "label": "Nhập lại mật khẩu mới",
+                        "placeholder": "",
+                        "description": "",
+                        "required": true,
+                        "showLabel": true,
+                        "mapTo": "",
+                        "prefillValue": "",
+                        "multiline": false,
+                        "inputType": "password",
+                        "limitChars": false,
+                        "minChars": 0,
+                        "maxChars": 500,
+                        "patternPreset": "",
+                        "pattern": "",
+                        "patternCountries": []
+                    },
+                    "responsive": {},
+                    "events": [],
+                    "bindings": []
+                },
+                "fres_7": {
+                    "id": "fres_7",
                     "data": {
                         "type": "form-submit",
                         "parent": "fres_1",