sbuilder-mcp 0.84.0 → 0.85.0

package/CHANGELOG.md

@@ -6,6 +6,16 @@ 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.85.0] - 2026-10-11
+
+### Added
+- `sb_api_find` and `sb_api_call` reach 843 platform operations, including reading, editing and deleting a site (name, slug, subdomain redirect, `maintenanceMode`), site members and site export.
+- `sb_review` suggests switching a shop in maintenance mode back on with `sb_api_call` on `patch:/api/sites/{siteId}`.
+
+### Fixed
+- `sb_api_call` names "the handler's body" instead of "(inline)" in its `unknown_keys` note when the handler has no named body struct.
+- Issuing tickets through `tickets/issued` no longer requires an `eventId`.
+
 ## [0.84.0] - 2026-10-11
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,16 @@ 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.85.0] - 2026-10-11
+
+### Added
+- `sb_api_find` và `sb_api_call` truy cập được 843 operation của platform, gồm đọc, sửa và xoá site (tên, slug, chuyển hướng subdomain, `maintenanceMode`), thành viên site và xuất site.
+- `sb_review` gợi ý bật lại shop đang bảo trì bằng `sb_api_call` trên `patch:/api/sites/{siteId}`.
+
+### Fixed
+- `sb_api_call` ghi "the handler's body" thay vì "(inline)" trong ghi chú `unknown_keys` khi handler không có struct body được đặt tên.
+- Phát vé qua `tickets/issued` không còn yêu cầu `eventId`.
+
 ## [0.84.0] - 2026-10-11
 
 ### Added

package/README.md

@@ -118,7 +118,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 — `checkout` (the four writes that make a working one), `checkout_sync` (the store's current payment and delivery methods into every existing order form, checkout page republished), `form` (any of the platform's 17 templates with its own field document), `chrome` (one shared header or footer on a real site menu — desktop menu, mobile drawer, cart and account icons), `menu` (a menu node bound to the site's menu, its links resolved), `overlay_attach` (a pop-up or quick view on the open page), `cart` (the site's cart drawer, when it has none; `relocalize` puts an existing one in the site's language) and `app` (a built-in app plus the pages it needs), `global_attach` / `global_detach` (put an EXISTING shared section on the open page, or take it off), `global_promote` (make a section on the page a NEW shared section) and `template_save` (save a section as a reusable template) |
 | `sb_undo` | Undo / redo this session's writes — page and form edits and `sb_api_call` PUTs; a page is refused if someone else saved it since. The platform's versions and history (`sb_page_version`) outlive this process |
 
-Twenty-eight tools, **833 API operations** (304 of the 384 writes carrying a body shape read
+Twenty-eight tools, **843 API operations** (309 of the 389 writes carrying a body shape read
 off the handler), 123 elements, 94 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

@@ -115,7 +115,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ự — `checkout` (bốn lệnh ghi tạo nên trang thanh toán), `checkout_sync` (đưa phương thức thanh toán và giao hàng hiện tại vào mọi form đặt hàng đã có, publish lại trang thanh toán), `form` (một trong 17 template của nền tảng kèm field document của nó), `chrome` (một header hoặc footer dùng chung trên menu thật của site — menu desktop, drawer mobile, icon giỏ hàng và tài khoản), `menu` (một node menu bind vào menu của site, link đã phân giải), `overlay_attach` (một pop-up hay quick view trên trang đang mở), `cart` (ngăn giỏ hàng của site, khi chưa có; `relocalize` đưa ngăn giỏ đã có về ngôn ngữ của site), `app` (một app dựng sẵn kèm những trang nó cần), và `global_attach` / `global_detach` (đặt một section dùng chung ĐÃ CÓ lên trang đang mở, hoặc gỡ ra), `global_promote` (biến một section trên trang thành section dùng chung MỚI) và `template_save` (lưu một section làm mẫu dùng lại) |
 | `sb_undo` | Hoàn tác / làm lại các thao tác ghi trong phiên — chỉnh sửa trang, form và PUT qua `sb_api_call`; trang bị từ chối nếu người khác đã lưu sau đó. Version và history của nền tảng (`sb_page_version`) sống lâu hơn process này |
 
-Hai mươi tám tool, **833 operation API** (304 trong 384 lệnh ghi có hình dạng body đọc thẳng
+Hai mươi tám tool, **843 operation API** (309 trong 389 lệnh ghi có hình dạng body đọc thẳng
 từ handler), 123 element, 94 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": 833,
+    "operations": 843,
     "definitions": 278,
-    "bodyCarrying": 364,
-    "bodyUndescribed": 93,
+    "bodyCarrying": 373,
+    "bodyUndescribed": 102,
     "generatedFrom": "server/docs/swagger.json"
 };
 export const API_OPERATIONS = [
@@ -4206,6 +4206,118 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}",
+        "method": "GET",
+        "path": "/api/sites/{siteId}",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Read, edit or trash one site",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "site",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "PATCH/PUT: {name?, slug?, subdomainRedirect?, subdomainRedirectCode?, maintenanceMode?}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "put:/api/sites/{siteId}",
+        "method": "PUT",
+        "path": "/api/sites/{siteId}",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Read, edit or trash one site",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "site",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "PATCH/PUT: {name?, slug?, subdomainRedirect?, subdomainRedirectCode?, maintenanceMode?}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "patch:/api/sites/{siteId}",
+        "method": "PATCH",
+        "path": "/api/sites/{siteId}",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Read, edit or trash one site",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "site",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "PATCH/PUT: {name?, slug?, subdomainRedirect?, subdomainRedirectCode?, maintenanceMode?}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "delete:/api/sites/{siteId}",
+        "method": "DELETE",
+        "path": "/api/sites/{siteId}",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Read, edit or trash one site",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "site",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "PATCH/PUT: {name?, slug?, subdomainRedirect?, subdomainRedirectCode?, maintenanceMode?}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/activity",
         "method": "GET",
@@ -9175,6 +9287,27 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/export",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/export",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Download the whole site as one archive",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/filter-facets",
         "method": "GET",
@@ -12052,6 +12185,167 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/members",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/members",
+        "tags": [
+            "sites"
+        ],
+        "summary": "List or invite site members; change a member's role, or remove them",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "member",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "POST: {email, role}; PATCH/PUT: {role}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "post:/api/sites/{siteId}/members",
+        "method": "POST",
+        "path": "/api/sites/{siteId}/members",
+        "tags": [
+            "sites"
+        ],
+        "summary": "List or invite site members; change a member's role, or remove them",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "member",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "POST: {email, role}; PATCH/PUT: {role}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "put:/api/sites/{siteId}/members/{userId}",
+        "method": "PUT",
+        "path": "/api/sites/{siteId}/members/{userId}",
+        "tags": [
+            "sites"
+        ],
+        "summary": "List or invite site members; change a member's role, or remove them",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "userId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Member's user ID (/{userId} routes)"
+            },
+            {
+                "name": "member",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "POST: {email, role}; PATCH/PUT: {role}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "patch:/api/sites/{siteId}/members/{userId}",
+        "method": "PATCH",
+        "path": "/api/sites/{siteId}/members/{userId}",
+        "tags": [
+            "sites"
+        ],
+        "summary": "List or invite site members; change a member's role, or remove them",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "userId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Member's user ID (/{userId} routes)"
+            },
+            {
+                "name": "member",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "POST: {email, role}; PATCH/PUT: {role}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "delete:/api/sites/{siteId}/members/{userId}",
+        "method": "DELETE",
+        "path": "/api/sites/{siteId}/members/{userId}",
+        "tags": [
+            "sites"
+        ],
+        "summary": "List or invite site members; change a member's role, or remove them",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "userId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Member's user ID (/{userId} routes)"
+            },
+            {
+                "name": "member",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "POST: {email, role}; PATCH/PUT: {role}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/orders",
         "method": "GET",

package/dist/catalog/deadkeys.generated.js

@@ -1,6 +1,6 @@
 export const DEAD_KEY_SOURCE = {
     "files": 5665,
-    "identifiers": 103619,
+    "identifiers": 103621,
     "seededKeys": 445,
     "dead": 0
 };

package/dist/catalog/shapes.generated.js

@@ -1,7 +1,7 @@
 export const SHAPE_SOURCE = {
-    "writeOperations": 384,
-    "shaped": 304,
-    "fromHandlers": 294,
+    "writeOperations": 389,
+    "shaped": 309,
+    "fromHandlers": 299,
     "fromSwaggerOnly": 10,
     "withReadOnly": 30,
     "structsRead": 3194
@@ -10373,6 +10373,98 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "(inline)"
     },
+    "patch:/api/sites/{siteId}": {
+        "fields": [
+            {
+                "name": "name",
+                "type": "string"
+            },
+            {
+                "name": "slug",
+                "type": "string"
+            },
+            {
+                "name": "subdomainRedirect",
+                "type": "boolean | null",
+                "note": "Pointer, not bool: `false` is a MEANINGFUL value here (\"serve the built-in address directly\"), and a plain bool cannot be told apart from \"field omitted\" — a rename would silently switch redirecting off on every site."
+            },
+            {
+                "name": "subdomainRedirectCode",
+                "type": "number",
+                "note": "301 or 302; 0/absent keeps the site's current choice."
+            },
+            {
+                "name": "maintenanceMode",
+                "type": "boolean | null",
+                "note": "Takes the whole storefront offline."
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
+    "put:/api/sites/{siteId}": {
+        "fields": [
+            {
+                "name": "name",
+                "type": "string"
+            },
+            {
+                "name": "slug",
+                "type": "string"
+            },
+            {
+                "name": "subdomainRedirect",
+                "type": "boolean | null",
+                "note": "Pointer, not bool: `false` is a MEANINGFUL value here (\"serve the built-in address directly\"), and a plain bool cannot be told apart from \"field omitted\" — a rename would silently switch redirecting off on every site."
+            },
+            {
+                "name": "subdomainRedirectCode",
+                "type": "number",
+                "note": "301 or 302; 0/absent keeps the site's current choice."
+            },
+            {
+                "name": "maintenanceMode",
+                "type": "boolean | null",
+                "note": "Takes the whole storefront offline."
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
+    "post:/api/sites/{siteId}/members": {
+        "fields": [
+            {
+                "name": "email",
+                "type": "string"
+            },
+            {
+                "name": "role",
+                "type": "site.Role"
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
+    "patch:/api/sites/{siteId}/members/{userId}": {
+        "fields": [
+            {
+                "name": "role",
+                "type": "site.Role"
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
+    "put:/api/sites/{siteId}/members/{userId}": {
+        "fields": [
+            {
+                "name": "role",
+                "type": "site.Role"
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
     "post:/api/sites/{siteId}/roles": {
         "fields": [
             {

package/dist/catalog/source.generated.js

@@ -1,7 +1,7 @@
 // GENERATED by scripts/gen-catalog.ts — do not edit by hand.
 // The platform commit every other generated file here describes.
 export const PLATFORM_SOURCE = {
-    "commit": "9db1b2a9eede5be5f1081975bd7f687f0becfd4a",
-    "committedAt": "2026-10-11T21:21:05+07:00",
+    "commit": "8384af1dd6df12bb80a75a8b53e88c377d3f722c",
+    "committedAt": "2026-10-12T01:13:06+07:00",
     "dirty": false
 };

package/dist/domains/site/readiness.js

@@ -263,11 +263,12 @@ export function readinessGaps(input) {
             problem: 'This storefront is switched OFF right now and has no published page of the "maintain" ' +
                 'type, so every address is answering a bare 503 sentence — no header, no logo, no word ' +
                 'about when it is back, and nothing that looks like this shop.',
-            fix: draft
+            fix: (draft
                 ? 'Publish the maintenance page that already exists.'
                 : 'Create a page of type "maintain" and publish it. It has no address of its own — the ' +
                     'storefront serves it as the BODY of the 503 — so give it the shop\'s name and a line ' +
-                    'saying when you are back.',
+                    'saying when you are back.') +
+                ' Or switch the shop back on: sb_api_call id "patch:/api/sites/{siteId}" body { "maintenanceMode": false }.',
         });
     }
     // A MISTYPED URL ANSWERS IN GO, NOT IN THE SHOP'S VOICE.

package/dist/tools/api.js

@@ -72,7 +72,7 @@ export function unknownBodyKeys(opId, body) {
         return undefined;
     return {
         keys,
-        note: `Not fields of ${shape.goType}: the platform ignores them silently. ` +
+        note: `Not fields of ${shape.goType === '(inline)' ? "the handler's body" : shape.goType}: the platform ignores them silently. ` +
             `Its fields: ${shape.fields.map((f) => f.name).join(', ')}.`,
     };
 }

package/package.json

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