sbuilder-mcp 0.60.0 → 0.60.2

package/CHANGELOG.md

@@ -6,6 +6,19 @@ 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.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
+- `sb_page_list`'s `page_types` table now carries a `page_types_note` stating that the twelve types are the storefront's fixed routed addresses, not a checklist of the pages a site needs, since login, register, contact, about, policy pages and anything else a shop must say are ordinary `page` rows with no limit on how many.
+
 ## [0.60.0] - 2026-09-16
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,19 @@ 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.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
+- Bảng `page_types` của `sb_page_list` giờ kèm `page_types_note` nói rõ mười hai loại trang là các địa chỉ cố định mà storefront định tuyến tới, không phải danh sách các trang một site cần có, vì login, register, contact, about, các trang chính sách và bất cứ điều gì shop cần nói đều là các dòng `page` thông thường, không giới hạn số lượng.
+
 ## [0.60.0] - 2026-09-16
 
 ### Added

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,6 +1,6 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 4026,
-    "identifiers": 77258,
+    "files": 4057,
+    "identifiers": 77822,
     "seededKeys": 384,
     "dead": 0
 };

package/dist/catalog/elements.generated.js

@@ -37466,6 +37466,7 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterValueMode",
             "values": [
                 "all",
+                "auto",
                 "manual"
             ],
             "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
@@ -37494,7 +37495,8 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterBehavior",
             "values": [
                 "event",
-                "filter"
+                "filter",
+                "navigate"
             ],
             "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
         }
@@ -37525,6 +37527,7 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterValueMode",
             "values": [
                 "all",
+                "auto",
                 "manual"
             ],
             "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
@@ -37553,7 +37556,8 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterBehavior",
             "values": [
                 "event",
-                "filter"
+                "filter",
+                "navigate"
             ],
             "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
         }
@@ -37584,6 +37588,7 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterValueMode",
             "values": [
                 "all",
+                "auto",
                 "manual"
             ],
             "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
@@ -37612,7 +37617,8 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterBehavior",
             "values": [
                 "event",
-                "filter"
+                "filter",
+                "navigate"
             ],
             "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
         }
@@ -37643,6 +37649,7 @@ export const ELEMENT_VALUES = {
             "writeKey": "filterValueMode",
             "values": [
                 "all",
+                "auto",
                 "manual"
             ],
             "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
@@ -37671,7 +37678,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/tools/page.js

@@ -1193,6 +1193,17 @@ export function registerPageTools(server, ctx) {
                 t.routePattern ??
                     (t.servedRole ? `served as the site's ${t.servedRole}` : 'an address you choose'),
             ])),
+            // NOT A LIST OF THE PAGES A SITE NEEDS, and this line is here because
+            // the table above reads like one. A type is a fixed ADDRESS the
+            // storefront routes by; most of a real website has no type at all —
+            // login, register, contact, about, the policies, and whatever else this
+            // particular shop sells or must say — and every one of those is an
+            // ordinary `page`. Twelve is the number of routed types, never the
+            // number of pages.
+            page_types_note: 'Types are the storefront\'s fixed addresses, not an inventory of a site. Everything ' +
+                'else — login, register, contact, about, policies, and anything this shop needs — is ' +
+                'type "page" with an address you choose, and there is no limit to how many. ' +
+                'usually_also below lists the ones most sites have; it is a floor, not a ceiling.',
             ...(missing.length
                 ? {
                     usually_also: Object.fromEntries(missing.map((m) => [m.key, m.why])),

package/package.json

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