sbuilder-mcp 0.59.3 → 0.60.1

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.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
+- `sb_page_list` now returns a `page_types` table naming every one of the platform's twelve page types and the address or role each is served at, generated from the platform's own page-type metadata, since `sb_page_create` previously only described six of them (page, checkout, product, category, post, course) in its argument text, leaving search, account, blog, complete, error, and maintain pages undiscoverable to an agent that only read the tool.
+
+### Changed
+- `sb_page_create`'s `type` argument now points to `sb_page_list` for the full set of page types instead of naming a partial list inline.
+
 ## [0.59.3] - 2026-09-15
 
 ### Changed

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.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
+- `sb_page_list` giờ trả về bảng `page_types` nêu tên cả mười hai loại trang của nền tảng cùng địa chỉ hoặc vai trò mà mỗi loại được phục vụ, sinh ra từ chính metadata loại trang của nền tảng, vì trước đó `sb_page_create` chỉ mô tả sáu trong số đó (page, checkout, product, category, post, course) trong phần mô tả tham số, khiến các trang search, account, blog, complete, error và maintain không thể được khám phá bởi một agent chỉ đọc mô tả của tool.
+
+### Changed
+- Tham số `type` của `sb_page_create` giờ trỏ tới `sb_page_list` để xem đầy đủ các loại trang thay vì liệt kê một danh sách không đầy đủ ngay trong mô tả.
+
 ## [0.59.3] - 2026-09-15
 
 ### Changed

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, **525 API operations** (176 of the 235 writes carrying a body shape read
+Twenty-eight tools, **527 API operations** (177 of the 236 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, **525 operation API** (176 trong 235 lệnh ghi có hình dạng body đọc thẳng
+Hai mươi tám tool, **527 operation API** (177 trong 236 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": 525,
+    "operations": 527,
     "definitions": 107,
-    "bodyCarrying": 193,
-    "bodyUndescribed": 74,
+    "bodyCarrying": 195,
+    "bodyUndescribed": 76,
     "generatedFrom": "server/docs/swagger.json"
 };
 export const API_OPERATIONS = [
@@ -3356,6 +3356,62 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/ai/settings",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/ai/settings",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Read or replace this site's own AI credentials",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "settings",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "provider, model, baseUrl and apiKey (PUT only; omit apiKey to keep the stored one, send \\"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "put:/api/sites/{siteId}/ai/settings",
+        "method": "PUT",
+        "path": "/api/sites/{siteId}/ai/settings",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Read or replace this site's own AI credentials",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "settings",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "provider, model, baseUrl and apiKey (PUT only; omit apiKey to keep the stored one, send \\"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/api-keys",
         "method": "GET",

package/dist/catalog/deadkeys.generated.js

@@ -1,6 +1,6 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 4023,
-    "identifiers": 77197,
+    "files": 4026,
+    "identifiers": 77258,
     "seededKeys": 384,
     "dead": 0
 };

package/dist/catalog/shapes.generated.js

@@ -1,10 +1,10 @@
 export const SHAPE_SOURCE = {
-    "writeOperations": 235,
-    "shaped": 176,
-    "fromHandlers": 176,
+    "writeOperations": 236,
+    "shaped": 177,
+    "fromHandlers": 177,
     "fromSwaggerOnly": 0,
     "withReadOnly": 26,
-    "structsRead": 1697
+    "structsRead": 1701
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{siteId}/api-keys": {
@@ -3018,6 +3018,28 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "(inline)"
     },
+    "put:/api/sites/{siteId}/ai/settings": {
+        "fields": [
+            {
+                "name": "provider",
+                "type": "string"
+            },
+            {
+                "name": "model",
+                "type": "string"
+            },
+            {
+                "name": "apiKey",
+                "type": "string | null"
+            },
+            {
+                "name": "baseUrl",
+                "type": "string"
+            }
+        ],
+        "source": "go",
+        "goType": "editoragent.SettingsInput"
+    },
     "post:/api/sites/{siteId}/fonts": {
         "fields": [
             {

package/dist/catalog/storepages.generated.js

@@ -1133,6 +1133,89 @@ export const PAGE_LAYOUT_SEEDS = {
         }
     }
 };
+/**
+ * EVERY page type the platform has, and what each one is FOR.
+ *
+ * A storefront is not one page: most of these are TEMPLATES, and a missing one
+ * means a whole family of addresses serves nothing. `routePattern` is where the
+ * type is served (absent = the author names the address), `ownSlug` says whether
+ * the author names it, `servedRole` marks the two that are served by ROLE rather
+ * than by address, and `app` names the builtin app a type needs installed.
+ */
+export const PAGE_TYPES = [
+    {
+        "type": "page",
+        "group": "main",
+        "ownSlug": true
+    },
+    {
+        "type": "product",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/products/{slug}"
+    },
+    {
+        "type": "category",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/collections/{slug}"
+    },
+    {
+        "type": "course",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/courses/{slug}",
+        "app": "courses"
+    },
+    {
+        "type": "search",
+        "group": "main",
+        "ownSlug": false,
+        "routePattern": "/search"
+    },
+    {
+        "type": "checkout",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/checkout"
+    },
+    {
+        "type": "complete",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/checkout/complete"
+    },
+    {
+        "type": "account",
+        "group": "main",
+        "ownSlug": false,
+        "routePattern": "/account"
+    },
+    {
+        "type": "blog",
+        "group": "blog",
+        "ownSlug": false,
+        "routePattern": "/blog-categories/{slug}"
+    },
+    {
+        "type": "post",
+        "group": "blog",
+        "ownSlug": false,
+        "routePattern": "/blog/{slug}"
+    },
+    {
+        "type": "error",
+        "group": "error",
+        "ownSlug": false,
+        "servedRole": "notFound"
+    },
+    {
+        "type": "maintain",
+        "group": "maintain",
+        "ownSlug": false,
+        "servedRole": "maintenance"
+    }
+];
 /**
  * The document an ordinary page opens with for a chosen LAYOUT.
  *

package/dist/domains/site/storepage.js

@@ -1,4 +1,4 @@
-import { COMPLETION_HEADLINE, COMPLETION_HEADLINE_SENTINEL, PAGE_LAYOUT_SEEDS, STORE_PAGE_SEEDS, } from '../../catalog/storepages.generated.js';
+import { COMPLETION_HEADLINE, COMPLETION_HEADLINE_SENTINEL, PAGE_LAYOUT_SEEDS, STORE_PAGE_SEEDS } from '../../catalog/storepages.generated.js';
 /**
  * WHAT A NEW STORE PAGE OPENS WITH — for an agent, as for a merchant.
  *

package/dist/tools/page.js

@@ -7,7 +7,8 @@ import { addSubtree, setMany, baseOnlyKeys, moveNode, removeNode, duplicateNode,
 import { baseOnlyNote } from '../domains/site/baseonly.js';
 import { detachNote, presetIdOf, presetLayer } from '../domains/site/theme.js';
 import { inertHintsFor } from '../domains/site/inert.js';
-import { hasSeed, layoutDocument, seedDocument, seedSummary, seededTypes } from '../domains/site/storepage.js';
+import { hasSeed, layoutDocument, seedDocument, seedSummary, seededTypes, } from '../domains/site/storepage.js';
+import { PAGE_TYPES } from '../catalog/storepages.generated.js';
 import { animationNote, deadKeyNote, unknownValueNote, unknownWriteNote, } from '../domains/site/vocabulary.js';
 import { skinLevelNote } from '../domains/site/fieldskin.js';
 import { siteTheme } from '../domains/site/theme-fetch.js';
@@ -1177,6 +1178,32 @@ export function registerPageTools(server, ctx) {
         const missing = missingUsualPages(raw.pages ?? null);
         return text({
             ...projectList(raw, 'pages', PAGE_FIELDS),
+            // EVERY TYPE THE PLATFORM HAS, and the address each one answers at.
+            //
+            // Here rather than in `sb_page_create`'s argument description, because
+            // that string rides in `tools/list` and the token budget caps it — the
+            // table put the payload over twice while being trimmed. It is also the
+            // better home: an agent reads this while ORIENTING, before it has
+            // decided what to build, and a type it has never heard of is exactly
+            // what it cannot ask for. `sb_page_create` used to name six of twelve
+            // from a hand-typed string, so search, account, blog, complete, error
+            // and maintain were unreachable to anyone who only read the tool.
+            page_types: Object.fromEntries(PAGE_TYPES.map((t) => [
+                t.type,
+                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])),
@@ -1195,7 +1222,10 @@ export function registerPageTools(server, ctx) {
         inputSchema: {
             site_id: z.string().optional(),
             name: z.string(),
-            type: z.string().optional().describe('page (default), checkout, product, category, post, course'),
+            type: z
+                .string()
+                .optional()
+                .describe('page (default); sb_page_list lists every type and where each is served'),
             slug: z.string().optional(),
             is_homepage: z.boolean().optional(),
             settings: z.record(z.unknown()).optional(),

package/package.json

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