sbuilder-mcp 0.60.1 → 0.60.3

package/CHANGELOG.md

@@ -6,6 +6,21 @@ 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.60.3] - 2026-09-16
+
+### Added
+- `sb_traits_for` and `sb_set` now recognize `filterShowAll` and `filterAllLabel` on the four option-list filter elements (`filter-checkbox`, `filter-radio`, `filter-color`, `filter-tag`), the leading "everything in this category" row a navigate filter can carry and the label it shows.
+- `sb_traits_for` and `sb_set` now recognize `filterMaxDepth` and `filterMaxValues` on the same four filter elements, the two limits a category filter's browse tree can carry, seeded at 0 to match what both renderers already infer from an absent key.
+- `filterAllLabel` is now a translatable special on the four filter elements, since it is copy a shopper reads.
+
+## [0.60.2] - 2026-09-16
+
+### Added
+- `sb_traits_for` and `sb_set` now list `navigate` as a legal `filterBehavior` value on the four option-list filter elements (`filter-checkbox`, `filter-radio`, `filter-color`, `filter-tag`), turning a filter into a link instead of a query update, scoped to those four because `select`'s own renderer only reads `event` and a `navigate` write to it would be accepted and silently do nothing.
+- `sb_traits_for` and `sb_set` now list `auto` as a legal `filterValueMode` value on every filter element, a category filter that follows the page it is on.
+- `sb_api_find` and `sb_api_call` now reach the editor assistant's conversation history: listing a site's stored conversations, reading one by id, and listing the models a provider will run for the site's key.
+- The call sheet for the assistant's message endpoint now documents four more body fields: `conversationId` to continue an existing thread, `images` for picture URLs the model should look at, `clientTools` for browser-side functions the model may call, and `verifies` for whether the client answers the verify round trip.
+
 ## [0.60.1] - 2026-09-16
 
 ### Fixed

package/CHANGELOG.vi.md

@@ -6,6 +6,21 @@ 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.60.3] - 2026-09-16
+
+### Added
+- `sb_traits_for` và `sb_set` giờ nhận diện `filterShowAll` và `filterAllLabel` trên bốn element bộ lọc dạng danh sách tùy chọn (`filter-checkbox`, `filter-radio`, `filter-color`, `filter-tag`) — dòng dẫn đầu "tất cả trong danh mục này" mà một bộ lọc kiểu navigate có thể mang, cùng nhãn nó hiển thị.
+- `sb_traits_for` và `sb_set` giờ nhận diện `filterMaxDepth` và `filterMaxValues` trên cùng bốn element bộ lọc đó — hai giới hạn mà cây duyệt của một bộ lọc danh mục có thể mang, được gieo sẵn giá trị 0 để khớp với những gì cả hai renderer vốn đã suy ra khi thiếu key này.
+- `filterAllLabel` giờ là một special có thể dịch trên bốn element bộ lọc, vì đây là nội dung mà khách mua hàng đọc được.
+
+## [0.60.2] - 2026-09-16
+
+### Added
+- `sb_traits_for` và `sb_set` giờ liệt kê `navigate` là giá trị hợp lệ của `filterBehavior` trên bốn element bộ lọc dạng danh sách tùy chọn (`filter-checkbox`, `filter-radio`, `filter-color`, `filter-tag`) — biến một bộ lọc thành một liên kết thay vì cập nhật query — chỉ giới hạn ở bốn element đó vì renderer của `select` chỉ đọc `event`, nếu ghi `navigate` vào đó thì lệnh vẫn được chấp nhận nhưng không làm gì cả.
+- `sb_traits_for` và `sb_set` giờ liệt kê `auto` là giá trị hợp lệ của `filterValueMode` trên mọi element bộ lọc, một bộ lọc danh mục đi theo đúng trang đang hiển thị.
+- `sb_api_find` và `sb_api_call` giờ với tới được lịch sử hội thoại của trợ lý biên tập: liệt kê các hội thoại đã lưu của một site, đọc một hội thoại theo id, và liệt kê các model mà một nhà cung cấp sẽ chạy cho key của site đó.
+- Bảng mô tả endpoint gửi tin nhắn của trợ lý giờ ghi thêm bốn trường body: `conversationId` để tiếp tục một luồng hội thoại đã có, `images` là các URL ảnh mà model cần xem, `clientTools` là các hàm phía trình duyệt mà model có thể gọi, và `verifies` cho biết client này có trả lời vòng xác minh (verify) hay không.
+
 ## [0.60.1] - 2026-09-16
 
 ### Fixed

package/README.md

@@ -112,7 +112,7 @@ in this client: one would put the very key the platform exists to hold back into
 | `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 SECOND answer for a page, not the only one: the platform has versions, history and restore (`sb_api_find` "page versions"), which outlive this process — reach for those first and use this for every other shaped PUT |
 
-Twenty-eight tools, **527 API operations** (177 of the 236 writes carrying a body shape read
+Twenty-eight tools, **530 API operations** (178 of the 237 writes carrying a body shape read
 off the handler), 113 elements, 79 binding sources. `sb_api_find`
 is an index rather than a tool per endpoint, so the tool list stays short while everything
 the platform can do stays reachable — and operations added to the platform arrive with the

package/README.vi.md

@@ -109,7 +109,7 @@ nhét ngược lại vào mọi bản cài.
 | `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 đè. Với TRANG thì đây là đường về thứ hai chứ không phải duy nhất: nền tảng có version, history và restore (`sb_api_find` "page versions"), và chúng sống lâu hơn tiến trình này — hãy dùng chúng trước, còn tool này cho mọi PUT có hình dạng khác |
 
-Hai mươi tám tool, **527 operation API** (177 trong 236 lệnh ghi có hình dạng body đọc thẳng
+Hai mươi tám tool, **530 operation API** (178 trong 237 lệnh ghi có hình dạng body đọc thẳng
 từ handler), 113 element, 79 nguồn binding. `sb_api_find` là
 một chỉ mục chứ không phải mỗi endpoint một tool, nên danh sách tool vẫn ngắn trong khi mọi
 thứ nền tảng làm được vẫn với tới — và operation mới thêm bên nền tảng sẽ tự có sau lần

package/dist/catalog/api.generated.js

@@ -1,8 +1,8 @@
 export const SWAGGER_SOURCE = {
-    "operations": 527,
+    "operations": 530,
     "definitions": 107,
-    "bodyCarrying": 195,
-    "bodyUndescribed": 76,
+    "bodyCarrying": 196,
+    "bodyUndescribed": 77,
     "generatedFrom": "server/docs/swagger.json"
 };
 export const API_OPERATIONS = [
@@ -3321,6 +3321,55 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/ai/conversations",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/ai/conversations",
+        "tags": [
+            "sites"
+        ],
+        "summary": "List the editor assistant's stored conversations",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "get:/api/sites/{siteId}/ai/conversations/{id}",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/ai/conversations/{id}",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Read one stored conversation",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Conversation ID"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "post:/api/sites/{siteId}/ai/messages",
         "method": "POST",
@@ -3356,6 +3405,34 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "post:/api/sites/{siteId}/ai/models",
+        "method": "POST",
+        "path": "/api/sites/{siteId}/ai/models",
+        "tags": [
+            "sites"
+        ],
+        "summary": "List the models a provider will run for this site's key",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "query",
+                "in": "body",
+                "required": true,
+                "type": "object",
+                "description": "provider (required), apiKey and baseUrl (optional — the stored key is used when apiKey is omitted)"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/ai/settings",
         "method": "GET",

package/dist/catalog/deadkeys.generated.js

@@ -1,7 +1,7 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 4026,
-    "identifiers": 77258,
-    "seededKeys": 384,
+    "files": 4060,
+    "identifiers": 77882,
+    "seededKeys": 388,
     "dead": 0
 };
 /**

package/dist/catalog/elements.generated.js

@@ -2544,7 +2544,11 @@ export const ELEMENTS = {
                 "filterArity": "",
                 "filterBehavior": "filter",
                 "filterTargets": [],
-                "filterRanges": []
+                "filterRanges": [],
+                "filterMaxDepth": 0,
+                "filterMaxValues": 0,
+                "filterShowAll": false,
+                "filterAllLabel": ""
             }
         },
         "inspector": [
@@ -2752,7 +2756,11 @@ export const ELEMENTS = {
                 "filterArity": "",
                 "filterBehavior": "filter",
                 "filterTargets": [],
-                "filterRanges": []
+                "filterRanges": [],
+                "filterMaxDepth": 0,
+                "filterMaxValues": 0,
+                "filterShowAll": false,
+                "filterAllLabel": ""
             }
         },
         "inspector": [
@@ -2961,7 +2969,11 @@ export const ELEMENTS = {
                 "filterArity": "",
                 "filterBehavior": "filter",
                 "filterTargets": [],
-                "filterRanges": []
+                "filterRanges": [],
+                "filterMaxDepth": 0,
+                "filterMaxValues": 0,
+                "filterShowAll": false,
+                "filterAllLabel": ""
             }
         },
         "inspector": [
@@ -3169,7 +3181,11 @@ export const ELEMENTS = {
                 "filterArity": "",
                 "filterBehavior": "filter",
                 "filterTargets": [],
-                "filterRanges": []
+                "filterRanges": [],
+                "filterMaxDepth": 0,
+                "filterMaxValues": 0,
+                "filterShowAll": false,
+                "filterAllLabel": ""
             }
         },
         "inspector": [
@@ -37466,6 +37482,7 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterValueMode",
             "values": [
                 "all",
+                "auto",
                 "manual"
             ],
             "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
@@ -37494,7 +37511,8 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterBehavior",
             "values": [
                 "event",
-                "filter"
+                "filter",
+                "navigate"
             ],
             "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
         }
@@ -37525,6 +37543,7 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterValueMode",
             "values": [
                 "all",
+                "auto",
                 "manual"
             ],
             "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
@@ -37553,7 +37572,8 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterBehavior",
             "values": [
                 "event",
-                "filter"
+                "filter",
+                "navigate"
             ],
             "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
         }
@@ -37584,6 +37604,7 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterValueMode",
             "values": [
                 "all",
+                "auto",
                 "manual"
             ],
             "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
@@ -37612,7 +37633,8 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterBehavior",
             "values": [
                 "event",
-                "filter"
+                "filter",
+                "navigate"
             ],
             "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
         }
@@ -37643,6 +37665,7 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterValueMode",
             "values": [
                 "all",
+                "auto",
                 "manual"
             ],
             "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
@@ -37671,7 +37694,8 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterBehavior",
             "values": [
                 "event",
-                "filter"
+                "filter",
+                "navigate"
             ],
             "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
         }

package/dist/catalog/shapes.generated.js

@@ -1,10 +1,10 @@
 export const SHAPE_SOURCE = {
-    "writeOperations": 236,
-    "shaped": 177,
-    "fromHandlers": 177,
+    "writeOperations": 237,
+    "shaped": 178,
+    "fromHandlers": 178,
     "fromSwaggerOnly": 0,
     "withReadOnly": 26,
-    "structsRead": 1701
+    "structsRead": 1725
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{siteId}/api-keys": {
@@ -3009,10 +3009,30 @@ export const REQUEST_SHAPES = {
                 "type": "llm.Turn[]",
                 "note": "History is sent by the CLIENT, unlike the storefront chatbot's, which removed it as a security fix."
             },
+            {
+                "name": "conversationId",
+                "type": "string",
+                "note": "ConversationID continues an existing thread."
+            },
             {
                 "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."
+            },
+            {
+                "name": "images",
+                "type": "string[]",
+                "note": "Images are urls of pictures the author attached for the model to LOOK AT."
+            },
+            {
+                "name": "clientTools",
+                "type": "editoragent.ClientTool[]",
+                "note": "ClientTools are functions the browser offers the model, answered from the live document — see editoragent/clienttools."
+            },
+            {
+                "name": "verifies",
+                "type": "boolean",
+                "note": "Verifies says this client answers the `verify` round trip."
             }
         ],
         "source": "go",
@@ -3040,6 +3060,24 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "editoragent.SettingsInput"
     },
+    "post:/api/sites/{siteId}/ai/models": {
+        "fields": [
+            {
+                "name": "provider",
+                "type": "string"
+            },
+            {
+                "name": "apiKey",
+                "type": "string"
+            },
+            {
+                "name": "baseUrl",
+                "type": "string"
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
     "post:/api/sites/{siteId}/fonts": {
         "fields": [
             {

package/dist/catalog/translations.generated.js

@@ -2,8 +2,8 @@
 // Source: <WB_REPO>/schema/src/elements/translatableFields.ts
 export const TRANSLATION_SOURCE = {
     "elements": 58,
-    "pairs": 142,
-    "neverKeys": 164,
+    "pairs": 146,
+    "neverKeys": 167,
     "entityTypes": 12
 };
 /** Every entity type a translation record can name, including "node". */
@@ -37,16 +37,20 @@ export const TRANSLATABLE_SPECIALS = {
         "filterValues"
     ],
     "filter-checkbox": [
-        "filterValues"
+        "filterValues",
+        "filterAllLabel"
     ],
     "filter-radio": [
-        "filterValues"
+        "filterValues",
+        "filterAllLabel"
     ],
     "filter-color": [
-        "filterValues"
+        "filterValues",
+        "filterAllLabel"
     ],
     "filter-tag": [
-        "filterValues"
+        "filterValues",
+        "filterAllLabel"
     ],
     "account-info": [
         "promptText",
@@ -351,7 +355,10 @@ export const NEVER_TRANSLATED = [
     "filterColors",
     "filterExcluded",
     "filterMatch",
+    "filterMaxDepth",
+    "filterMaxValues",
     "filterRanges",
+    "filterShowAll",
     "filterSource",
     "filterTarget",
     "filterTargets",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.60.1",
+  "version": "0.60.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",